资源预览内容
第1页 / 共8页
第2页 / 共8页
第3页 / 共8页
第4页 / 共8页
第5页 / 共8页
第6页 / 共8页
第7页 / 共8页
第8页 / 共8页
亲,该文档总共8页全部预览完了,如果喜欢就下载吧!
资源描述
腾讯社交广告转化追踪 Android SDK 接入说明文档 V1.4腾讯社交广告转化追踪 Android SDK 接入说明文档 V1.4必读1. SDK嵌入1.1 步骤1:添加SDK到工程中1.2 步骤2: 修改AndroidManifest.xml文件2. 接入代码2.1 激活事件统计接口2.1.1 接入代码示例2.1.2 激活事件主要API2.2 更多转化类型统计接口2.2.1 接入代码示例2.2.2 注册事件主要API2.3 会话(启动次数)统计接口2.3.1 接入代码示例2.3.2 会话(启动次数)统计主要API2.3.3 会话(启动次数)统计接口说明3.注意事项4 问题咨询必读由于部分广告主包名存在规范问题,例如大小写、Android和iOS共用包名等原因,在接入前,请联系广点通运营或技术支持团队确认包名和APP ID关联是否存在异常。 联系方式见文末。1. SDK嵌入1.1 步骤1:添加SDK到工程中请在工程根目录下创建一个名为libs的子目录,并将SDK的jar包 GDTTrackSDK.min.1.1.0.jar拷贝到该目录下。(1) 如果您使用的是Eclipse + ADT,而且ADT版本比较低的话,则需要在Eclipse中选中刚才的jar包,然后右键选择Build Path-Add to Build Path(ADT17以上已经不需要手动导入)。(2) 如果您使用的是Android Studio,需要在gradle中添加:dependencies compile files(libs/GDTTrackSDK.min.1.0.0.jar) 1.2 步骤2: 修改AndroidManifest.xml文件添加权限声明:目前支持的SDK版本,最低到API 9(即Android系统版本2.3):2. 接入代码2.1 激活事件统计接口2.1.1 接入代码示例1. (完整的代码示例请参考demo工程中的GDTTrackerApplication.java) 2. 3. public class GDTTrackerApplication extends Application 4. 5. Override 6. public void onCreate() 7. super.onCreate(); 8. 9. /* 10. * SDK初始化接口:必须在Application的onCreate中成功调用一次,否则其他接口都将无法 使用。 11. * 注意:只需要调用一次即可,第一次调用之后的任何调用都将无效。Logcat中会有初始化信 息输出,请开发者注意。 12. * 13. * param context applicationContext 14. * param channel 渠道标识,注意:目前仅支持传入“ANDROID“、“UNIONANDROID“这 两个字符串。传入其他字符串将无法被统计。若您的应用在应用宝中上架,则传入“ANDROID“字段“, 否则传入“UNIONANDROID“字段。 15. */ 16. 17. GDTTracker.init(this, “ANDROID“); 18. 19. /* 20. * SDK激活上报接口:Application创建的时候是激活接口调用的最佳时机,调用此接口会向 广点通上报激活事件。 21. * 注意:30天内App被打开只会被记录为一次激活。 22. * 23. * param context applicationContext 24. */ 25. GDTTracker.activateApp(this); 26. 27. 2.1.2 激活事件主要APIcom.qq.e.track.Tracker方法名功能init(Context context, String channel)初始化方法,必须在程序的入口调用一次,该方法不会阻塞程序也不会影 响程序性能。注意:如果调用该方法时,channel参数必须是 TrackConstants.APP_CHANNEL类中定义好的渠道。否则SDK将无法 成功初始化,开发者也无法使用SDK提供的其他功能。activateApp(Context context)激活上报接口,context参数是程序的上下文,一般是 ApplicationContextactivateApp(Context context, int value)激活上报接口,context参数含义同上,value参数是激活事件的价值, 由开发者根据自己需要来定义,应该是大于0的整数;如果是金额,则以 分为单位,例如1元对应的参数应该是1002.2 更多转化类型统计接口2.2.1 接入代码示例1. (完整的代码示例请参考demo工程中的GDTTrackerActivity.java) 2. / 当用户在App产生需要某一个事件,我们希望统计这个事件的发生次数时,可以调用logEven t接口进行上报。 3. buttonRegister.setOnClickListener(new View.OnClickListener() 4. Override 5. public void onClick(View v) 6. / 对应的事件类型 7. String conversionType = null; 8. switch (v.getId() 9. case R.id.button_reg: 10. conversionType = TrackConstants.CONVERSION_TYPE.REGIS TER; 11. break; 12. case R.id.button_add_to_cart: 13. conversionType = TrackConstants.CONVERSION_TYPE.ADD_T O_CART; 14. break; 15. case R.id.button_purchase: 16. conversionType = TrackConstants.CONVERSION_TYPE.PURCH ASE; 17. break; 18. case R.id.button_score: 19. conversionType = TrackConstants.CONVERSION_TYPE.SCORE ; 20. break; 21. case R.id.button_search: 22. conversionType = TrackConstants.CONVERSION_TYPE.SEARC H; 23. break; 24. default: 25. break; 26. 27. 28. if (TextUtils.isEmpty(conversionType) 29. return; 30. 31. /* 32. * SDK事件统计接口:当用户发生“注册“、“添加到购物车“、“付费“、“评分“、 “搜索“行为时,可以向广点通上报对应的事件。 33. * 34. * param context applicationContext 35. * param eventName 事件类型,注意:目前只能统计 到“TrackConstants.CONVERSION_TYPE“类中预定义过的事件类型,如果开发者传入其他字符串, 将无法在统计到这个事件。 36. */ 37. GDTTracker.logEvent(context, conversionType);38. 39. );2.2.2 注册事件主要APIcom.qq.e.track.Tracker方法名功能logEvent(Context context, String eventName)注册事件上报接口,context参数是程序的上下文,一般是 ApplicationContext,eventName是事件类型。注意:目前SDK只支持注 册事件的上报,即开发者只能给eventName传入值 为“MOBILEAPP_REGISTER“的字符串logEvent(Context context, String eventName, int value)注册事件上报接口,context参数和eventName含义同上,value参数是激 活事件的价值,由开发者根据自己需要定义,一般是大于0的整数。2.3 会话(启动次数)统计接口2.3.1 接入代码示例1. /* 2. * 会话统计接口onSessionStart和onSessionEnd注意事项: 3. * 4. * 1.确保在所有的Activity中都成对地调 用“GDTTracker.onSessionStart(this)“和“GDTTracker.onSessionEnd(this)“方法。 5. * 2.如果Activity之间有继承或者控制关系请不要同时在父和子Activity中重复添加这两个 方法,否则会造成重复统计。 6. * 3.SDK默认当应用在后台运行超过30秒再回到前台时,是两个独立的session(启动次增加1) 。例如按下home键,经过一段时间(大于30s)后再返回应用,启动次数会增加1次。 7. */ 8. Override 9. protected void onResume() 10. super.onResume(); 11. Log.i(TAG, “onResume“); 12. 13. /* 14. * 会话开始接口 15. * 16. * param context 应用上下文,本身是Activity的话就传入Activity 17. */ 18. GDTTracker.onSessionStart(this)
网站客服QQ:2055934822
金锄头文库版权所有
经营许可证:蜀ICP备13022795号 | 川公网安备 51140202000112号