首页 开发者中心 文档中心 第三方广告平台通用接入说明

掌趣国内SDK第三方广告平台通用接入说明

文档说明

本文档只对掌趣sdk适用；
接入须知：
（1）在MIS平台配置：配置SDK参数，添加对应监控事件
（2）基本流程：
Android： 进行接口接入，在MIS开启配置的平台及参数，导出配置参数（用于打包），进行二次打包验证；
iOS：下载最新的SDK，在MIS开启配置的平台及参数，将Base包内的第三方广告涉及的资源放在游戏项目指定位置，进行接口接入，导出配置参数（放在游戏工程中），出包验证（游戏选择需要接入的广告平台的资源并导入游戏工程。*如只接热云，就不用导入dataeye了，用哪个导入哪个）
参数导出位置：

（3）事件验证：可以在GSSC/第三方广告平台验证；

注意： 请联系技术支持人员，索要打点接入文档

1 安卓接口使用说明

注意事项
（1）文档中的参数是用于举例，具体的要看MIS上配置的KEY及属性 ，进行传递；
（2）充值相关事件”支付货币”、”支付类型” 要在MIS上配置默认值 ，如果不填写默认值，游戏传递也行
例如：
支付货币：CNY
支付类型：第三方支付

1.2 安卓接口说明

本接口内日志事件key和事件logvalue 的key值需要开发人员根据掌趣运营人员提供的统计日志说明文档使用，并且根据运营人员提供的统计日志说明文档每条统计的描述在相应的逻辑处调用本接口并且传了相应的事件key和logvalue。

  1. /**    
  2.      * 游戏端发送第三方的日志
  3.      * 
  4.      * @param logKey
  5.      *            日志事件KEY
  6.      * @param logValue
  7.      *            日志事件内容 HashMap key-val格式
  8.      */
  9.     public void Ourpalm_SendAnalyticsInfoLog(String logKey,
  10. HashMap<String, Object> logValue);

1.2 安卓接口使用举例

注意：以下Key -Value值仅做举例说明，请以提供的技术打点接入文档为准；
1 注册日志（账号注册） 

  1. HashMap<String, Object> logValue = new HashMap<String, Object>();
  2. logValue.put("userId", "用户id");
  3. Ourpalm_Entry.getInstance(MainActivity).Ourpalm_SendAnalyticsInfoLog("registration", logValue);

2 登录日志（账号登录）

  1. HashMap<String, Object> logValue = new HashMap<String, Object>();
  2. logValue.put("userId", "用户id");
  3. Ourpalm_Entry.getInstance(MainActivity).Ourpalm_SendAnalyticsInfoLog("login", logValue);

3 充值日志
日志事件key为purchase （举例：充值100元，价格单位为分） 

  1. HashMap<String, Object> logValue = new HashMap<String, Object>();
  2.             logValue.put("price", "10000");
  3.     logValue.put("userId", "用户id");
  4.     logValue.put("orderId", "订单号");              Ourpalm_Entry.getInstance(NewMainActivity.mMainActivity).Ourpalm_SendAnalyticsInfoLog("purchase", logValue);

4 自定义日志（运营人员需要在mis平台配置需要的参数）

  1. HashMap<String, Object> logValue = new HashMap<String, Object>();
  2. logValue.put("pointId", "zidingyi");
  3. logValue.put("test1", "1");
  4. logValue.put("test2", "2");
  5. Ourpalm_Entry.getInstance(MainActivity).Ourpalm_SendAnalyticsInfoLog("effectPoint", logValue);

2 iOS接口使用说明

2.1 iOS接口说明

  1. 接口定义
  2. void LogEvent(const char* ourpalm_event_key, const char* event_paras);

添加库及配置文件ourpalm_statlog.json（由掌趣运营提供）
一定要将BaseSDK中对应广告SDK的资源，添加至游戏项目中；

2.2 iOS接口使用举例

注意事项
（1）文档中的参数是用于举例，具体的要看MIS上配置的KEY及属性 ，进行传递；
（2）充值相关事件”支付货币”、”支付类型” 要在MIS上配置默认值 ，如果不填写默认值，游戏传递也行
注意：以下Key -Value值仅做举例说明，请以提供的技术打点接入文档为准；
例如：
支付货币：CNY
支付类型：第三方支付
1、注册日志（账号注册，唯一不可重复） 

  1. OPGameSDK::GetInstance().LogEvent("registration");

2、登录日志（账号登录）

  1. OPGameSDK::GetInstance().LogEvent("login");

3、充值成功日志（举例：充值100.00人民币）

  1. Json::Value event_paras;
  2. event_paras["userId"] = Json::Value("掌趣用户ID");
  3. event_paras["orderId"] = Json::Value("123123123123");
  4. event_paras["price"] = Json::Value("10000");
  5. event_paras["currency"] = Json::Value("CNY");
  6. event_paras["payType"] = Json::Value("appstore");
  8. Json::FastWriter fast_writer;
  9. string logData = fast_writer.write(event_paras);
  10. OPGameSDK::GetInstance().LogEvent("purchase", logData.c_str());

4、自定义日志（定制4个参数的自定义日志）

  1. Json::Value errJson;
  2. errJson["contentId"] = Json::Value("1000");
  3. errJson["contentType"] = Json::Value("0");
  4. errJson["currency"] = Json::Value("RMB");
  5. errJson["price"] = Json::Value("1099");
  7. Json::FastWriter fast_writer;
  8. string resultStr = fast_writer.write(errJson);
  9. OPGameSDK::GetInstance().LogEvent("CustEvent1", resultStr.c_str();