メインコンテンツまでスキップ

Android

最終更新 2026/10/03
ヒント

Android SDKの最小システムバージョンはAndroid 4.0（API 14）です

最新バージョン：v1.4.1

更新日：2026-05-12

リソースのダウンロード：ダウンロード

1. 概要​

AE 4.4から、エンゲージモジュールに「クライアントトリガー型タスク」機能がリリースされました。アプリ内での新規ユーザー登録やキャラクター作成などのシナリオにおけるミリ秒単位のトリガーの要件に対応し、リアルタイムのA/B分流にも対応しています。クライアント側ではThinkingData SDKがAEのバックエンドと通信し、タスクの取得と計算を行います。

App側にThinkingData SDKを統合する必要があります。App側はThinkingData SDKとのやり取りだけを考慮すればよく、AE管理画面のタスクの詳細を気にする必要はありません。

2. 統合​

2.1 SDKの自動統合​

  • Projectレベルのbuild.gradleファイルに、次の依存関係の設定を追加します
buildscript {
    repositories {
        jcenter()
        mavenCentral()
    }
}
  • moduleプロジェクトディレクトリのbuild.gradleファイルに依存関係を追加します：
dependencies {
    implementation 'cn.thinkingdata.android:TDStrategy:1.4.1'
}

2.2 ThinkingData SDKの手動統合​

クライアントトリガー型タスクには、次のThinkingData SDKが必要です：

SDK名機能の紹介バージョン要件
TDAnalyticsデータの収集と処理を行います>= 3.1.0
TDRemoteConfigAE管理画面の設定情報を取得します>= 1.0.0
TDCore基本コンポーネントの機能を提供します>= 1.1.0
TDStrategyクライアントトリガー型の機能を提供します>=1.0.0
  1. ページ上部のリソースのダウンロードリンクをクリックし、SDKをダウンロードして解凍します
  2. libsフォルダーにTDAnalytics.aar、TDCore.aar、TDRemoteConfig.aar、TDStrategy.aarを追加します
  3. build.gradleに次の設定を追加します
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar','*.aar'])
}

3. 初期化​

SDKを初期化します

import cn.thinkingdata.core.TDApp;
import cn.thinkingdata.core.TDSettings;
// TDSettingsの設定の詳しい使い方は【応用ガイド】を参照してください
TDSettings settings = new TDSettings();
settings.appId = "AppId";
settings.serverUrl = "ServerUrl";
TDApp.init(this,settings);

4. コールバックリスナーの設定​

SDKの初期化に成功したら、TDStrategy SDKにコールバックリスナーを設定します。

import cn.thinkingdata.strategy.TDStrategy;
import cn.thinkingdata.strategy.core.result.TDStrategyResult;
import cn.thinkingdata.strategy.core.result.TDStrategyResultListener;

TDStrategy.setTriggerListener(new TDStrategyResultListener() {
    @Override
    public void onTriggerResult(TDStrategyResult tdStrategyResult) {
        
    }
});

4.1 コールバックのデータモデル​

public class TDStrategyResult {
    public String appId;
    public String taskId;
    public String channelMsgType;
    public String pushId;
    public JSONObject content;
    public JSONObject userParams;
    public JSONObject opsProperties;
}

プロパティの説明

プロパティ名タイプ説明
channelMsgTypeStringチャンネルのメッセージタイプ
appIdStringAEプロジェクトのapp id
pushIdStringエンゲージタスクのチャンネル送信ID
taskIdStringエンゲージタスクのID
contentJSONObjectエンゲージタスクのプッシュ内容
userParamsJSONObjectクライアントチャンネルのカスタムパラメータ
opsPropertiesJSONObjectクライアントトリガー型タスクに付与されるチャンネル情報。リーチファネルイベントで返送するパラメータとして使用します。
このページは役に立ちましたか？
このページの内容