MMA广告测量 通用 SDK (Android)

MMA广告测量 通用 SDK (Android)

MMA广告测量 通用 SDK (Android)

 

MMA 通用 SDK 说明文档

MMA Android SDK 部署指南

步骤1:添加 MMA Android SDK 到工程中

  1. 点此下载MMA Android SDK (如需浏览此开源项目和 demo 工程请到http://git.oschina.net/注册账号后邮件联系 fuliuwei@admaster.com.cn)
  2. 将 MMA SDK 的 mma_android_sdk_v1.3.3.jar 拷贝到 libs 目录下并添加为 JAR 包;
  3. 将libMMANDKSignature.so 拷贝到 libs\armeabi 目录下;
  4. 把sdkconfig.xml配置文件拷贝到工程里的assets目录下,同时将 sdkconfig.xml 上传到 web 服务器,使其可以通过 web 方式访问,假设其地址为 CONFIG_URL(其后会用到)。

对于Eclipse工程,请参照下面的步骤添加 JAR 包:

  1. 在 “Package Explorer” 窗口中右击你的工程并选择 “Properties”
  2. 在左侧面板中选择 “Java Build Path”
  3. 在主窗口中选择 “Libraries”页签
  4. 点击“Add JARs…”按钮
  5. 选择您拷贝到libs目录下的 mma_sdk.jar
  6. 点击 “OK” 完成添加。

步骤2:修改 AndroidManifest.xml 文件

修改 AndroidManifest.xml 文件,新增网络连接请求和读取手机状态的权限:

<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

步骤3:为广告添加测量代码

在有广告测量需求的 Activity 中的 onStart() 方法中调用 Countly.sharedInstance().init(this, CONFIG_URL); 进行初始化,其中 CONFIG_URL 为远程配置文件的地址,当广告产生曝光时,控制触发以下代码

String TEST_TRACKING_URL = "http://admaster.mobi/android/log/a222,c123,b132,";//TEST_TRACKING_URL 为对应的曝光代码  
Countly.sharedInstance().onExpose(TEST_TRACKING_URL);

当广告被点击时,控制触发以下代码

String TEST_TRACKING_URL = "http://admaster.mobi/android/log/a222,c123,b132,";//TEST_TRACKING_URL 为对应的曝光代码
Countly.sharedInstance().onClick(TEST_TRACKING_URL); 

代码示例(具体请见 demo 项目源码)

package com.mmandroid_demo;
import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import cn.com.mma.mobile.tracking.api.Countly;
import cn.com.mma.mobile.tracking.util.Logger;
/**
 * 此工程是为使用SDK的用户提供的demo
 * 
 * @author lincoln
 * 
 */
public class MainActivity extends Activity {
 int count = 0;
/**
 * sdkconfig.xml配置文件服务器存放地址
 */
 public static final String CONFIG_URL = "http://admaster.mobi/sdkconfig.xml";
 /**
 * 点击测量地址
 */
 public static final String TEST_TRACKING_URL = "http://admaster.mobi/android/log/a222,c123,b132,";
@Override
 protected void onCreate(Bundle savedInstanceState) {
 super.onCreate(savedInstanceState);
 setContentView(R.layout.activity_main);
/**
 * 初始化SDK
 */
 Countly.sharedInstance().init(this, CONFIG_URL);
}
/**
 * 点击广告,发送消息
 */
 public void sendClickMsg(View view) {
 Countly.sharedInstance().onClick(TEST_TRACKING_URL);
 }
 /**
 * 曝光广告,发送消息
 */
 public void sendExposeMsg(View view) {
 Countly.sharedInstance().onExpose(TEST_TRACKING_URL);
 }
}

步骤4:验证和调试

SDK 的测试有两个方面:

  1. 参数是否齐全,URL 拼接方式是否正确
  2. 请求次数和第三方测量平台是否能对应上

针对第一点,使用 Admaster SDK 测试平台进行测试和验证,登入 http://developer.admaster.com.cn/, 根据页面上的提示进行调用, 页面会实时显示出服务器接收到的信息,如果和本地的设备相关信息一致,则表示测试通过。

针对第二点,建议使用第三方测量系统的正式环境进行测试,主要对比媒体自身广告系统测量数据和第三方测量数据数量上的差异。