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

応用ガイド

最終更新 2026/10/03

1. 初期化パラメータ​

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

プロパティ名タイプ説明
appIdStringAE管理画面で作成したプロジェクトのapp id
serverUrlStringAE管理画面で作成したプロジェクトのserver url
enableLogBooleanログ出力を有効にするかどうか
debugModeStringdebugを渡すとテストモードが有効になります。Android／iOS／HarmonyOSのネイティブチャンネルでのみ有効です
triggerListenerfunctionトリガー結果を通知します

データ収集関連の設定（autoTrack、enableNativeなど）は、TDAnalytics.initで設定してください。必ず先にTDAnalyticsを初期化してから、TDStrategyを初期化してください。

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

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

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

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

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

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

// 指定したクライアントパラメータを削除
TDStrategy.removeClientParam('key');

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

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

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

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

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

4. テスト送信​

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

TDStrategy.init({
  appId: 'AppId',
  serverUrl: 'ServerUrl',
  enableLog: true,
  debugMode: 'debug', // テストモードを設定
  triggerListener: function (result) {

  }
});

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

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

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

5. Fetchパラメータのカスタマイズ​

Fetchパラメータは、クライアントSDKがAEサーバーに値を要求する際に使用できるパラメータです。Fetchパラメータをカスタマイズし、構成チャンネルの環境パラメータとして追加できます。

5.1 追加​

TDStrategy.setCustomFetchParams({
  demo_param: 'from_client'
});

// 最新のタスク設定を能動的に取得（任意）
TDStrategy.fetch();

5.2 削除​

指定したkeyに基づいて削除します

TDStrategy.removeCustomFetchParam('demo_param');
このページは役に立ちましたか？
このページの内容