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

応用ガイド

最終更新 2026/09/03

1. 初期化パラメータ​

初期化時に渡すパラメータ設定の詳細は次のとおりです

プロパティ名タイプ説明
appIdStringAE管理画面で作成したプロジェクトのapp id
serverUrlStringAE管理画面で作成したプロジェクトのserver url
modeStringSDKの実行モード（none、debug、debugOnly）
enableLogBooleanログ出力を有効にするかどうか
zoneOffsetNumberSDKのデフォルトタイムゾーン
autoTrackobject自動収集関連の設定
triggerListenerfunctionトリガー結果を通知します

2. クライアントパラメータの設定​

クライアントトリガー型タスクを作成する際に、「クライアント条件」を入力できます。設定方法はクライアントトリガー型タスクの作成を参照してください。

「クライアント条件」で使用できるパラメータは、クライアントが自動収集する環境パラメータと、TDStrategy SDKで設定したクライアントパラメータです。TDStrategy SDKが提供するインターフェースでカスタムのクライアントパラメータをSETした後、そのカスタムクライアントパラメータをAE管理画面に追加すると、エンゲージタスクで使用できます。

注意：クライアントでSETするパラメータの名前とタイプは、AEのエンゲージ管理画面で設定したクライアントパラメータと一致させる必要があります。

クライアントパラメータの設定方法は次のとおりです：

// クライアントパラメータを設定。複数回設定した場合は和集合になります
TDStrategy.addClientParams({
    "key":"value"
});

3. 取得タイミングのカスタマイズ​

3.1 自動取得​

次のシナリオでは、SDKがリモート設定データを自動的に取得します

  • コールドスタート
  • ThinkingSDKのアカウント体系に変更があった場合（login、logoutなど）

3.2 手動取得​

SDKのメソッドを手動で呼び出して、いつでもリモート設定を取得できます

TDStrategy.fetch();

このAPIには内部で頻度制御があるため、頻繁に取得しないでください。

4. リーチファネルイベント​

クライアントトリガー型チャンネルを作成する際に、リーチファネル設定をオンにできます。設定方法はチャンネル設定を参照してください。

リーチファネルをオンにすると、ファネルステップに関連付けるイベント名を設定できます。これにより、このチャンネルを使用するエンゲージタスクのデータ詳細ページで、設定したステップのコンバージョンデータを確認できます。

「実際到達」「プッシュクリック」に選択するイベントには、次の要件があります：

  • イベントには、エンゲージ固有のパラメータを含める必要があります。このパラメータは、プッシュ内容のTDStrategyResultオブジェクトのopsPropertiesプロパティから取得できます。具体的な送信方法は次のとおりです：
TDApp.init({
   appId: "AppId",
   serverUrl:"ServerUrl",
   enableLog:true,
   triggerListener:function(result){
       TDAnalytics.track("ops_click", result.opsProperties);
   }
 });

5. テスト送信​

チャンネルの利用可否とタスクの有効性をすばやく検証できるよう、SDKはテストモードの有効化に対応しています。

TDApp.init({
   appId: "AppId",
   serverUrl:"ServerUrl",
   enableLog:true,
   mode: "debug",//テストモードを設定
   triggerListener:function(result){
       
   }
 });

クライアントでdebugモードを有効にすると、5秒ごとにテストタスクを取得します。AEのエンゲージモジュールでは、チャンネルテストまたはタスクテストを作成できます。タスクがトリガーを待っている間は、フロントエンドのページで進捗ノードを確認できます。

参考ドキュメント：タスクのテスト送信、チャンネルのテスト送信

クライアントトリガー型のテスト送信にはテストデバイスが必要です。テストデバイスリストでテストデバイスを選択または追加できます

このページは役に立ちましたか？
このページの内容