一键认证API

接口目录

• initialize | preSetParams | startSdk
• trackEventBegin | trackEventEnd
• trackCountEvent | setProfile
• userId | registerEventProperties | gtcid

集成配置

1. 在个推开放平台注册帐号，并创建应用，获取 APPID 参数。

2. 在 APICloud Studio 中替换您APP应用参数:

<meta-data name="GETUI_APPID" value="替换您在个推https://www.getui.com/注册的APPID"/>
<meta-data android:name="GT_INSTALL_CHANNEL" android:value=""/>

API介绍

initialize

初始化个推SDK。

参数:
无

功能:
初始化个推SDK，设置通用回调上下文。

JS Example:

     ido = api.require('GetuiIdo');
     ido.initialize(callback);
     var startparam = {
            appId: 'xXmjbbab3b5F1m7wAYZoG2',//ios需要
            channel:'channel1'//ios需要
     };
     ido.startSdk(startparam);
        
    function callback(ret, err) {
        alert("ret = " + JSON.stringify(ret) + "err = " + JSON.stringify(err));
        var log;
        switch (ret.type) {
            case 'GTCountSDKDidReceiveGtcid':
                log = 'gtcid:' + ret.cid;
                break;
        }
        if (log) {
            printfLog(log);
        }
    }

---

preSetParams

预设置参数。

参数:

• debugEnable: String, 是否开启调试模式（"1" 表示开启，默认 "0"）
• sessionTime: String, 会话超时时间（单位：毫秒）
• minAppActiveDuration: String, 最小应用活跃时间（单位：毫秒）
• maxAppActiveDuration: String, 最大应用活跃时间（单位：毫秒）
• eventUploadInterval: String, 事件上传间隔（单位：毫秒）
• eventForceUploadSize: String, 事件强制上传大小
• profileUploadInterval: String, 用户属性上传间隔（单位：毫秒）
• profileForceUploadSize: String, 用户属性强制上传大小
• userId: String, 用户ID
• applicationGroupIdentifier: String, 应用组标识
• eventProperties: JSONObject, 事件属性

功能:
设置SDK的调试模式、会话时间、应用活跃时间、事件及用户属性上传参数、用户ID等，并执行预初始化。

JS Example:

ido.preSetParams({
  debugEnable: "1",
  sessionTime: "300000",
  minAppActiveDuration: "10000",
  maxAppActiveDuration: "3600000",
  eventUploadInterval: "60000",
  eventForceUploadSize: "50",
  profileUploadInterval: "60000",
  profileForceUploadSize: "100",
  userId: "user123",
  applicationGroupIdentifier: "group1",
  eventProperties: {
    key1: "value1",
    key2: "value2"
  }
});

---

startSdk

启动个推SDK。

参数:
无

功能:
初始化并启动个推SDK，设置回调以处理成功或失败的结果。成功时返回 gtcid（个推用户ID）。

JS Example:

   var startparam = {
            appId: 'xXmjbbab3b5F1m7wAYZoG2',//ios需要
            channel:'channel1'//ios需要
     };
     ido.startSdk(startparam);

---

trackEventBegin

开始事件追踪。

参数:

• eventId: String, 事件ID
• args: JSONObject, 事件参数

功能:
开始追踪指定事件，需先初始化SDK。

JS Example:

    var param = {
        eventId: 'event1',
    };
    ido.trackEventBegin(param, function (ret, err) {
        alert("ret = " + JSON.stringify(ret) + "err = " + JSON.stringify(err));
        var log = 'trackEventBegin:' + ret.result;
        printfLog(log);
    });

---

trackEventEnd

结束事件追踪。

参数:

• eventId: String, 事件ID
• args: JSONObject, 事件参数

功能:
结束追踪指定事件，需先初始化SDK。

JS Example:

ido.trackEventEnd({
  eventId: "page_view",
  args: {
    page: "home",
    duration: 5000
  }
});

---

trackCountEvent

追踪计数事件。

参数:

• eventId: String, 事件ID
• args: JSONObject, 事件参数

功能:
记录计数事件，需先初始化SDK。

JS Example:

ido.trackCountEvent({
  eventId: "button_click",
  args: {
    button: "submit",
    context: "form_submission"
  }
});

---

setProfile

设置用户属性。

参数:

• profiles: JSONObject, 用户属性

功能:
设置用户属性，需先初始化SDK。

JS Example:

ido.setProfile({
  profiles: {
    age: 25,
    gender: "male",
    location: "Shanghai"
  }
});

---

userId

设置用户ID。

参数:

• userId: String, 用户ID

功能:
设置用户ID，需先初始化SDK。

JS Example:

ido.userId({
  userId: "user123"
});

---

registerEventProperties

注册事件属性。

参数:

• eventProperties: JSONObject, 事件属性

功能:
注册事件属性，需先初始化SDK。

JS Example:

ido.registerEventProperties({
  eventProperties: {
    category: "navigation",
    action: "click"
  }
});

---

gtcid

获取个推用户ID。

参数:
无

功能:
获取当前用户的 gtcid。若SDK未初始化，返回错误提示“SDK not initialized”。

JS Example:

ido.gtcid();

---

getVersion

获取原生SDK版本号

参数:
无

功能:
获取原生SDK版本号

JS Example:

 ido.getVersion(function (ret, err) {
                alert("ret = " + JSON.stringify(ret) + "err = " + JSON.stringify(err));
                var log = 'version' + ret.version;
                printfLog(log);
  });

---

产品简介

用户运营解决方案全面整合了用户运营全链条中的关键环节，包括但不限于数据采集、深度数据洞察与分析、精细化用户分层与标签体系构建、以及高效的群体扩展策略，同时囊括了运营计划制定与执行的所有必要功能。此方案的核心目的在于，借助详尽的数据支持与高度灵活的运营工具，为业务运营提供精准的导航，进而驱动价值增长与业务优化。

解决什么问题

用户运营可通过丰富的数据、灵活的分析功能、高效的模型帮助你解决不限于以下内容的运营问题：

1. 高效拉新提供数据验证
   哪些人会成为我的潜在新用户？哪些用户潜在价值较高？潜在新用户喜欢什么内容？

2. 新用户内容推荐提供数据支持
   新安装的用户有什么特征？新用户喜欢什么样的内容，有怎样的偏好？

3. 精细化分群及画像能力助力精细化运营
   如何进行用户分层、分群运营？已经圈选的用户群有什么特性、是否符合我的运营预期？有哪些用户需要进行定向召回？哪些用户可以进行推送拉活，推送什么类型内容效果好？

4. 产品功能迭代效果分析提升转化率
   哪些产品功能比较受用户欢迎？新上的VIP引导活动转化率如何？

5. 场景化分析功能协助运营提效
   app的日活、月活如何？资深运营经验如何快速传授给新手运营？相关的数据指标波动是否能快速对比、发现问题？

6. 行为数据标签化积累标签资产
   简单的行为数据是否能转化为有业务含义的标签？行业相关的标签如何搭建？

7. 高价值行为及特征挖掘助力商业化效果提升
   哪些用户符合广告主的投放诉求？哪些用户是潜在付费用户？

接入流程

用户运营服务的使用需要接入 SDK，整体接入流程如下：

1. 到个推开发者中心注册开发者帐号（若已注册账号可跳过此步骤）

2. 在开发者中心首页创建应用并开通用户运营服务

   • 点击新增应用/服务，进入服务选择页面，选择“用户运营”解决方案
     
     

3. 选择要开通服务的应用，若应用还未创建，可直接“新增应用”
   

4. 开通服务成功后，可下载 SDK 进行集成，也可直接点击“使用服务”进入平台先行体验 demo 功能。
   

5. 查看本 APP 的运营数据或使用 demo 应用体验功能，demo 应用可在应用列表中找到，点击 demo 应用名称即可体验 demo 数据。
   
   若在应用列表中未找到 demo，可点击“用户运营”图标进入服务介绍页，并点击介绍页中的“体验 demo”
   

6. 当出现问题时，建议：

   • 仔细阅读集成文档，查看是否有遗漏
   • 扫码联系个推技术支持