Android之数据统计TalkingData集成_android datatalking

1

2

3

4

5

6

TalkingdataAnalytics.jar：

  dependencies {

  …

      compile files('libs/TalkingdataAnalytics.jar')

  …

  }

权限

用途

INTERNET

允许程序联网和发送统计数据的权限。

ACCESS_NETWORK_STATE

允许应用检测网络连接状态，在网络异常状态下避免数据发送，节省流量和电量。

READ_PHONE_STATE

允许应用以只读的方式访问手机设备的信息，通过获取的信息来唯一标识用户。

ACCESS_WIFI_STATE

获取设备的MAC地址，同样用来标识唯一用户。

WRITE_EXTERNAL_STORAGE

用于保存设备信息，以及记录日志。

GET_TASKS (建议)

获取当前应用是否在显示应用，可以更精准的统计用户活跃

ACCESS_ FINE_LOCATION（可选）

可通过GPS获取设备的位置信息，用来修正用户的地域分布数据，使报表数据更准确。

ACCESS_ COARSE_LOCATION（可选）

用来获取该应用被使用的粗略位置信息。

meta-data

用途

TD_APP_ID

用来唯一标识您的应用，将您创建应用时获得的32个字符组成的App ID写入meta-data中，替换“Your_app_id”即可。

TD_CHANNEL_ID（建议添加）

用来标注应用推广渠道，区分用户的来源来查看统计。您可自定义渠道名来替换value中的“Your_channel_id”。 格式：32个字符内，支持中文、英文、数字、空格、英文点和下划线，请勿使用其他符号。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

<!--?xml version="1.0" encoding="utf-8"?-->

<manifest ......>

      <uses-permission android:name="android.permission.INTERNET" />

      <uses-permission 

             android:name="android.permission.ACCESS_NETWORK_STATE" />

      <uses-permission 

                android:name="android.permission.READ_PHONE_STATE"  />

      <uses-permission 

                android:name="android.permission.ACCESS_WIFI_STATE"  />

      <uses-permission android:name="android.permission.GET_TASKS"  />

      <application ......>

          <activity ......>

              ......

              </activity>

          ......

        <meta-data android:name="TD_APP_ID" 

                     android:value="Your_app_id" />

        <meta-data android:name="TD_CHANNEL_ID"                                                      

                     android:value="Your_channel_id" />

      </application>

</manifest>

1

2

init(final Context context, final String appId,  final String partnerId);

//这种方式不需要在Manifest里的meta-data申明了TD_APP_ID和TD_CHANNEL_ID

1

2

init(final Context context);

//这种方式可以使用多渠道打包工具，方便一次打包多个发布渠道

1

2

3

4

5

6

-keep public class com.tendcloud.tenddata.** { public protected *;}

-keep classmembers class ** {

     public void *(***);

}

-keep class com.talkingdata.sdk.TalkingDataSDK {public *;}

-keep class com.apptalkingdata.** {*;}

1

1

TCAgent.onPageEnd(Context ctx, String pageName);

1

2

<meta-data android:name="TD_CHANNEL_ID android:value="Your_channel_id">

</meta-data>

1

  TCAgent.onEvent(Context ctx, String EVENT_ID);

1

  TCAgent.onEvent(Context ctx, String EVENT_ID, String EVENT_LABEL);

1

2

  TCAgent.onEvent(Context ctx, String EVENT_ID, String EVENT_LABEL, Map<string, object=""> kv);

1

  TCAgent.setGlobalKV(String key, Object value);

1

  TCAgent.removeGlobalKV(String key);

1

2

3

4

5

6

7

8

9

  // 可定义eventId=点击首页推荐位；event_LABEL=具体的位置编号

  @Override

  public void onClick(View v) {

      Map<string, object=""> kv = new HashMap<string, object="">();

      kv.put("商品类型", "休闲食品");

      kv.put("价格","5～10元" );

      TCAgent.onEvent(DemoActivity.this, "点击首页推荐位", "第3推广位", kv);

  }

1

TCAgent.setReportUncaughtExceptions(Boolean enabled)

1

2

3

4

5

6

@Override

public void onCreate(Bundle savedInstanceState) {

    super.onCreate(savedInstanceState);

    setContentView(R.layout.main);

    TCAgent.setReportUncaughtExceptions(true);

}

1

TCAgent.init(this);

1

TCAgent.onError(Activity activity, Throwable throwable)

1

2

3

4

5

6

7

8

try {

  File file = new File("filePath");

  if(!file.exists()){

      file.createNewFile();

  }

} catch (IOException e) {

  TCAgent.onError(this, e);

}

1

2

3

4

5

6

7

8

9

10

11

12

13

除之前所需要的权限外，还需要添加以下功能权限

  <!-- 允许App开机启动，来接收推送 -->

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"></uses-permission>

  <!-- 发送持久广播 -->

<uses-permission android:name="android.permission.BROADCAST_STICKY"></uses-permission>

  <!-- 修改全局系统设置-->

<uses-permission android:name="android.permission.WRITE_SETTINGS"></uses-permission>

  <!-- 允许振动，在接收推送时提示客户 -->

<uses-permission android:name="android.permission.VIBRATE"></uses-permission>

  <!-- 侦测Wifi 变化，以针对不同 Wifi 控制最佳心跳频率，确保push的通道稳定 -->

<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>

  <!-- 此权限用于在接到推送时，可唤醒屏幕，可选择性添加权限 -->

<uses-permission android:name="android.permission.WAKE_LOCK"></uses-permission>

1

<service android:name="com.apptalkingdata.push.service.PushService" android:process=":push" android:exported="true"></service>

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

<receiver android:name="com.apptalkingdata.push.service.PushServiceReceiver" android:exported="true">

    <intent-filter>

        <action android:name="android.intent.action.CMD"></action>

  <action android:name="android.talkingdata.action.notification.SHOW"></action>

        <action android:name="android.talkingdata.action.media.MESSAGE"></action>

        <action android:name="android.intent.action.BOOT_COMPLETED"></action>

        <action android:name="android.net.conn.CONNECTIVITY_CHANGE"></action>

        <action android:name="android.intent.action.USER_PRESENT"></action>

    </intent-filter>

</receiver>

<receiver android:name="com.tendcloud.tenddata.TalkingDataAppMessageReceiver" android:enabled="true">

    <intent-filter>

        <action android:name="android.talkingdata.action.media.SILENT"></action>

        <action android:name="android.talkingdata.action.media.TD.TOKEN"></action>

    </intent-filter>

    <intent-filter>

        <action android:name="com.talkingdata.notification.click"></action>

        <action android:name="com.talkingdata.message.click"></action>

    </intent-filter>

</receiver>

1

2

3

4

5

6

7

8

9

10

11

<receiver android:name="com.tendcloud.tenddata.TalkingDataAppMessageReceiver" android:enabled="true">

    <intent-filter>

        <!-- 必须添加 -->

        <action android:name="com.talkingdata.notification.click"></action>

        <action android:name="com.talkingdata.message.click"></action>

    </intent-filter>

    <intent-filter>

        <!--注：H0DPYSxUkR9NFoWnvff656要换成开发者自己的appid-->

<action android:name="com.igexin.sdk.action.H0DPYSxUkR9NFoWnvff656"></action>

    </intent-filter>

</receiver>

1

2

3

4

5

6

7

8

9

10

11

12

13

<receiver android:name="com.tendcloud.tenddata.TalkingDataAppMessageReceiver" android:enabled="true">

    <intent-filter>

        <!-- 必须添加 -->

        <action android:name="com.talkingdata.notification.click"></action>

        <action android:name="com.talkingdata.message.click"></action>

    </intent-filter>

    <intent-filter>

        <!-- 如果使用极光推送，必须添加 -->

        <action android:name="cn.jpush.android.intent.REGISTRATION"></action>

   <action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED"></action>

        <category android:name="您的应用包名"></category>

    </intent-filter>

</receiver>

1

2

3

4

5

6

7

8

public class MainApplication extends Application {

    @Override

    public void onCreate() {

        TalkingDataSMS.init(this,

        "App ID",

        "Secret ID");

    }

}

1

2

3

4

5

6

// 申请认证码

public static final void applyAuthCode(String countryCode,

              String mobile, TalkingDataSMSApplyCallback callback) ;

// 重新申请认证码

public static final void reapplyAuthCode(String countryCode,

              String mobile, String requestId, TalkingDataSMSApplyCallback callback);

参数

类型

描述

countyrCode（国家码）

String

手机号的国家码，使用全球通用的国家码，不带+号，目前只支持中国大陆。
通常国家码都会在您的客户端中要求用户手动选择。
示例：86

mobile（手机号码）

String

用户的手机号码，中国为11位的手机号码。
通常此项在您的客户端中要求用户手动填写。

requestId

String

仅reapplyAuthCode接口需要填写。
requestId是每次调用发送短信接口后，SDK返回给您的当次请求的识别号。
requestId用于处理用户没有收到认证码短信时，要求进行重发问题。
在携带了requestId参数时，系统会找到之前的相同认证码再发送一次短信；不带此参数系统会发送全新的认证码

callback

TalkingDataSMSApplyCallback

申请认证码回调接口，成功时调用：
public void onApplySucc(String requestId);
失败时调用：
public void onApplyFailed(int errorCode, String errorMessage);

1

2

3

// 在用户填写好认证码后向SDK请求

public static final void verifyAuthCode(String countryCode,

    String mobile, String authCode, TalkingDataSMSVerifyCallback callback)

参数

类型

描述

国家码

String

用户选择的国家码

手机号码

String

用户填写的手机号

认证码

String

用户填写的短信认证码

callback

TalkingDataSMSVerifyCallback

验证认证码回调接口，成功时调用：
public void onVerifySucc(String requestId);
失败时调用：
public void onVerifyFailed(int errorCode, String errorMessage);

返回码

描述

451

SECERT_CHECK_FAIL

452

EXCEED_PHONE_APP_DAY_QUOTA

453

APP_KEY_CHECK_FAIL

455

ALREADY_LOCKED

456

LACK_REQUST_PARAM

457

APPLY_TOO_FREQUENTLY

458

EXCEED_DEVICE_APP_DAY_QUOTA

459

EXCEED_PHONE_DAY_QUOTA

460

VERIFY_FAIL_NOT_AMTCH

461

VERIFY_FAIL_EXPIRED

462

VERIFY_FAIL_USED

463

BEEN_LOCKED

471

REGTISTER_JSON_INVALID

472

DUPLICATE_REGISTER_OR_ADD

473

SERVER_ERROR_IN_REGISTER

474

INVALID_DOMAIN

475

INVALID_APPKEY

480

EXCEED_DEVICE_DAY_QUOTA

481

EXCEED_APP_DAY_QUOTA

482

EXCEED_PHONE_SP_VISIT_FREQUENCY_LIMIT

483

EXCEED_DEVELOPER_DAY_QUOTA

484

INVALID_QUERY_PARAM

485

NO_QUERY_RESULT

486

INVALID_PHONE_NUM

487

EXCEED_QUOTA

551

SP_SERVER_FAIL

552

DECOMPRESS_HTTP_BODY_FAIL

553

NO_SUCH_RECORD

554

CHECK_CRC_FAIL

557

SERVER_STORAGE_ERROR

558

JSON_PARSE_ERROR

559

SERVER_IO_FAIL

560

SERVER_GEN_DECRET_FAIL

561

CHECK_QUOTA_BUILD_KEY_FAIL

570

NO_MONTH_DB

601

申请认证码需要间隔60s

602

验证请求过于频繁，请稍后再试

604

SDK内部错误

605

接口传入参数错误

其他

请参照NSURLError

1

2

03-15 16:17:56.236 I/TDLog ( 1784): TD_APP_ID in AndroidManifest.xml is:400ea56751ad479e81dxxxxxx.

03-15 16:17:56.236 I/ TDLog ( 1784): TD_CHANNEL_ID in AndroidManifest.xml is:gfan.

1

2

3

03-15 16:19:06.721 D/ TDLog ( 1784): Post data to server...

03-15 16:19:09.643 D/ TDLog ( 1784): server return success:true

03-15 16:19:09.643 D/ TDLog ( 1784): Send Success, Clear Data

1

TCAgent.LOG_ON = false;