《腾讯社交广告转化追踪AndroidSDK接入说明文档V1.4》由会员分享，可在线阅读，更多相关《腾讯社交广告转化追踪AndroidSDK接入说明文档V1.4（8页珍藏版）》请在金锄头文库上搜索。
1、腾讯社交广告转化追踪 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 问题咨询必读由于部
2、分广告主包名存在规范问题，例如大小写、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) 如果您使
3、用的是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 Appl
4、ication 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“、“UNIONAN
5、DROID“这 两个字符串。传入其他字符串将无法被统计。若您的应用在应用宝中上架，则传入“ANDROID“字段“， 否则传入“UNIONANDROID“字段。 15. */ 16. 17. GDTTracker.init(this, “ANDROID“); 18. 19. /* 20. * SDK激活上报接口：Application创建的时候是激活接口调用的最佳时机，调用此接口会向 广点通上报激活事件。 21. * 注意：30天内App被打开只会被记录为一次激活。 22. * 23. * param context applicationContext 24. */ 25. GDTTracke
6、r.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参数是程序的上下文，一般是 App
7、licationContextactivateApp(Context context, int value)激活上报接口，context参数含义同上，value参数是激活事件的价值， 由开发者根据自己需要来定义，应该是大于0的整数；如果是金额，则以 分为单位，例如1元对应的参数应该是1002.2 更多转化类型统计接口2.2.1 接入代码示例1. (完整的代码示例请参考demo工程中的GDTTrackerActivity.java) 2. / 当用户在App产生需要某一个事件，我们希望统计这个事件的发生次数时，可以调用logEven t接口进行上报。 3. buttonRegister.setO
8、nClickListener(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. conversionT
9、ype = 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. c
10、onversionType = 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
11、事件类型，注意：目前只能统计 到“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是事件类
12、型。注意：目前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中都
13、成对地调 用“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)
