广告追踪系统接口

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

统计标准

通用方法

注册用户

function onRegister(userId)

接口说明:

范例

local adtracking_plugin = AgentManager:getInstance():getAdTrackingPlugin()
if adtracking_plugin ~= nil then
    adtracking_plugin:onRegister("userid")
end

登录用户

function onLogin(userInfo)

接口说明:

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

参数信息:

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

范例

local adtracking_plugin = AgentManager:getInstance():getAdTrackingPlugin()
if adtracking_plugin ~= nil then
    local paramMap = {
        User_Id = "123456",
        Role_Id = "test",
        Role_Name = "test"
    }
    adtracking_plugin:onLogin(paramMap)
end

统计玩家的充值数据

function onPay( userInfo)

接口说明:

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

参数信息:

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

范例

local adtracking_plugin = AgentManager:getInstance():getAdTrackingPlugin()
if adtracking_plugin ~= nil then
    local date = os.date("%Y-%m-%d %H:%M:%S")
    local paramMap = {
        User_Id = "123456",
        Order_Id = tostring(date),
        Currency_Amount = "5",
        Currency_Type ="CNY",
        Payment_Type = "test",
        Payment_Time =  tostring(date)
    }
    adtracking_plugin:onPay(paramMap)
end

自定义事件

function trackEvent( eventId, paramMap)

接口说明:

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

参数信息:

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

范例

local adtracking_plugin = AgentManager:getInstance():getAdTrackingPlugin()
if adtracking_plugin ~= nil and adtracking_plugin:isFunctionSupported("onCreateRole") then
    local paramMap = {
        User_Id = "123456",
        Role_Id = "test",
        Role_Name = "test"
    }
    adtracking_plugin:trackEvent("onCreateRole", paramMap)
    adtracking_plugin:trackEvent("event_1")
end

扩展方法

创建角色

function onCreateRole(userInfo)

接口说明:

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

参数信息:

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

范例

local adtracking_plugin = AgentManager:getInstance():getAdTrackingPlugin()
if adtracking_plugin ~= nil and adtracking_plugin:isFunctionSupported("onCreateRole") then
    local paramMap = {
        User_Id = "123456",
        Role_Id = "test",
        Role_Name = "test"
    }
    adtracking_plugin:trackEvent("onCreateRole", paramMap)
end

角色升级

function onLevelUp(info)

接口说明:

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

参数信息:

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

范例

local adtracking_plugin = AgentManager:getInstance():getAdTrackingPlugin()
if adtracking_plugin ~= nil and adtracking_plugin:isFunctionSupported("onLevelUp") then
    local paramMap = {
        User_Id = "123456",
        Role_Id = "test",
        Role_Name = "test",
        Level = "10"
    }
    adtracking_plugin:trackEvent("onLevelUp", paramMap)
end

统计玩家开始充值数据

function onStartToPay( info)

接口说明:

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

参数信息:

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

范例

local adtracking_plugin = AgentManager:getInstance():getAdTrackingPlugin()
if adtracking_plugin ~= nil and adtracking_plugin:isFunctionSupported("onStartToPay") then
    local date=os.date("%Y-%m-%d %H:%M:%S")
    local paramMap = {
        User_Id = "123456",
        Order_Id = tostring(date),
        Currency_Amount = "5",
        Currency_Type ="CNY",
        Payment_Type = "test",
        Payment_Time =  tostring(date)
    }
    adtracking_plugin:trackEvent("onStartToPay", paramMap)
end