广告追踪系统接口

来自AnySDK 文档
跳转至: 导航搜索
   Ad Tracking为移动应用统计在渠道推广的效果数据,监测渠道推广效果,追踪用户后续行文,评估渠道获取用户能力。

统计标准

通用方法

注册用户

void onRegister(const char* userId);

接口说明:

统计玩家游戏注册

范例

ProtocolAdTracking * adtracking = AgentManager::getInstance()->getAdTrackingPlugin();
if(!adtracking) return;
adtracking->onRegister("userid");

登录用户

void onLogin(std::map<std::string,std::string> userInfo);

接口说明:

统计玩家登陆数据(每次进入游戏)

参数信息:

参数 参数说明
User_Id 用户唯一标示符
Role_Id 游戏角色唯一标示符
Role_Name 游戏角色名称

范例

ProtocolAdTracking * adtracking = AgentManager::getInstance()->getAdTrackingPlugin();
if(!adtracking) return;
map<string, string> userInfo;
userInfo["User_Id"] = "userid";
userInfo["Role_Id"] = "roleid";
userInfo["Role_Name"] = "rolename";
adtracking->onLogin(userInfo);

统计玩家的充值数据

void onPay(std::map<std::string,std::string> userInfo);

接口说明:

在玩家在游戏中充值成功后,进行统计充值数据,所有付费相关分析的数

参数信息:

参数 参数说明
User_Id 用户唯一标示符
Order_Id 订单唯一标示符
Currency_Amount 支付的真实货币的金额
Currency_Type 货币类型,按照国际标准组织 ISO 4217 中规范的 3 位字母,例如 CNY 人民币、USD 美金等
Payment_Type 支付类型
Payment_Time 支付时间

范例

ProtocolAdTracking * adtracking = AgentManager::getInstance()->getAdTrackingPlugin();
if(!adtracking) return;
map<string, string> productInfo;
productInfo["User_Id"] = "userid";
productInfo["Order_Id"] = "orderid1";
productInfo["Currency_Amount"] = "5";
productInfo["Currency_Type"] = "CNY";
productInfo["Payment_Type"] = "paytype";
productInfo["Payment_Time"] = "paytime";
adtracking->onPay(productInfo);

自定义事件

void trackEvent(const char* eventId, std::map<std::string, std::string>* paramMap = NULL) ;

接口说明:

开发者可以自由的统计玩家在游戏内的任意用户行为。

参数信息:

参数 参数说明
eventId 事件唯一标示符
paramMap 事件属性

范例

ProtocolAdTracking * adtracking = AgentManager::getInstance()->getAdTrackingPlugin();
if(!adtracking) return;
map<string, string> userInfo;
userInfo["User_Id"] = "userid";
userInfo["Role_Id"] = "roleid";
userInfo["Role_Name"] = "rolename";
adtracking->trackEvent("onCreateRole",userInfo);
adtracking->trackEvent("event_1");

扩展方法

创建角色

void onCreateRole(std::map<std::string,std::string> userInfo);

接口说明:

该接口追踪玩家创建角色行为数据

参数信息:

参数 参数说明
User_Id 用户唯一标示符
Role_Id 游戏角色唯一标示符
Role_Name 游戏角色名称

范例

ProtocolAdTracking * adtracking = AgentManager::getInstance()->getAdTrackingPlugin();
if(!adtracking) return;
map<string, string> userInfo;
userInfo["User_Id"] = "userid";
userInfo["Role_Id"] = "roleid";
userInfo["Role_Name"] = "rolename";
adtracking->trackEvent("onCreateRole",&userInfo);
// PluginParam data(userInfo);
// _pAdTracking->callFuncWithParam("onCreateRole", &data, NULL);

角色升级

void onLevelUp(std::map<std::string,std::string> userInfo);

接口说明:

该接口追踪玩家角色升级行为数据

参数信息:

参数 参数说明
User_Id 用户唯一标示符
Role_Id 游戏角色唯一标示符
Role_Name 游戏角色名称
Level 角色等级

范例

ProtocolAdTracking * adtracking = AgentManager::getInstance()->getAdTrackingPlugin();
if(!adtracking) return;
map<string, string> userInfo;
userInfo["User_Id"] = "userid";
userInfo["Role_Id"] = "roleid";
userInfo["Role_Name"] = "rolename";
userInfo["Level"] = "10";
adtracking->trackEvent("onLevelUp", &userInfo);
// PluginParam data(userInfo);
// _pAdTracking->callFuncWithParam("onLevelUp", &data, NULL);

统计玩家开始充值数据

void onStartToPay(std::map<std::string,std::string> userInfo);

接口说明:

玩家在游戏中开始发起充值时调用,进行统计开始充值数据

参数信息:

参数 参数说明
User_Id 用户唯一标示符
Order_Id 订单唯一标示符
Currency_Amount 支付的真实货币的金额
Currency_Type 货币类型,按照国际标准组织 ISO 4217 中规范的 3 位字母,例如 CNY 人民币、USD 美金等
Payment_Type 支付类型
Payment_Time 支付时间

范例

ProtocolAdTracking * adtracking = AgentManager::getInstance()->getAdTrackingPlugin();
if(!adtracking) return;
map<string, string> productInfo;
productInfo["User_Id"] = "userid";
productInfo["Order_Id"] = "orderid1";
productInfo["Currency_Amount"] = "5";
productInfo["Currency_Type"] = "CNY";
productInfo["Payment_Type"] = "paytype";
productInfo["Payment_Time"] = "paytime";
adtracking->trackEvent("onStartToPay", &productInfo);
// PluginParam data(productInfo);
// _pAdTracking->callFuncWithParam("onStartToPay", &data, NULL);