JS

最終更新 2026/10/07

最新バージョン：v1.0.0

更新日：2026-07-24

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

1. 概要

バージョン6.1から、AEに実験スイート機能が追加されました。AE管理画面で実験を作成し、コントロールグループとテストグループの変数値を設定して、クライアントSDKでAppに取得することで、グループごとに異なるコンテンツをユーザーに表示できます。

このドキュメントでは、クライアントSDKの統合手順を説明します。App側はThinkingData SDKとのやり取りだけを考慮すればよく、AE管理画面のタスクの詳細を気にする必要はありません。

なお、実験SDKは構成センターSDKと組み合わせて使用する必要があります。

2. 統合

2.1 SDKの手動統合

構成センターには、次のThinkingData SDKが必要です：

SDK名	説明	バージョン要件
TDAnalytics	データの収集と処理を行います	>= 2.6.0
TDRemoteconfig	AE管理画面の設定情報を取得します	>= 1.3.0

1. ページ上部のリソースのダウンロードリンクをクリックし、SDKをダウンロードして解凍します
2. thinkingdata.umd.min.js、tdremoteconfig.umd.min.js、tdexperiment.umd.min.jsをプロジェクトの同じディレクトリにドラッグします

3. 初期化

この統合方法に切り替えた後は、SDKの初期化にはTDAppインスタンスを使用し、その他のデータ収集と送信にはwindow.thinkingdataインスタンスを使用します。

<script src="./thinkingdata.umd.min.js"></script>
<script src="./tdremoteconfig.umd.min.js"></script>
<script src="./tdexperiment.umd.min.js"></script>
//データ収集SDKを初期化
window.ta = thinkingdata;
ta.init({
    appId: 'APP_ID',
    serverUrl: 'https://YOUR_SERVER_URL',
});
//実験SDKを初期化
TDExperiment.init({
    appId: 'APP_ID',
    serverUrl: 'https://YOUR_SERVER_URL',
    automaticExposureTracking: true,
    customBucketId:{},
    customFetchParams: {},
    enableLog: true,
    onFetchSuccess: function () {
    },
    onFetchFailure: function (code, msg) {

    }
});

初期化パラメータの説明：

• appId：APP ID
• serverUrl：データの送信先URL
• automaticExposureTracking：デフォルトはtrueです。getで実験パラメータを取得するときに、インプレッションイベントを自動的に送信します
• customBucketId：カスタム振り分け主体
• customFetchParams：クライアントの構成チャンネルに設定したカスタムパラメータ
• enableLog：デバッグログを有効にするかどうか
• onFetchSuccess：実験設定情報の取得に成功
• onFetchFailure：実験設定情報の取得に失敗

4. 使用方法

4.1 実験情報の取得

TDExperiment.getValueAsString(key)

TDExperiment.getValueAsNumber(key)

TDExperiment.getValueAsBoolean(key)

TDExperiment.getValueAsJson(key)

automaticExposureTrackingがtrueの場合、getの際にインプレッションイベントが自動的に送信されます

4.2 インプレッションイベントの送信

exposureメソッドを呼び出して、インプレッションイベントを手動で送信できます

TDExperiment.exposure(key);

4.3 すべての実験情報を能動的に取得

TDExperiment.fetch();

TDExperiment.fetch().addOnSuccessListener(function () {
    //成功
}).addOnFailureListener(function (code, msg) {
    //失敗
});

4.4 カスタム振り分け主体

TDExperiment.setCustomBucketId({
    'bucket_id':'account_id'
});

4.5 カスタムリクエストパラメータ

TDExperiment.setCustomFetchParams({
    'key':'value'
});