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

応用ガイド

最終更新 2026/10/03

1. 初期化パラメータ​

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

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

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

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

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

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

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

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

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

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

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

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

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

4. テスト送信​

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

var TDApp = require("./tdcore.mg.wx.min.js");
TDApp.init({
   appId: "AppId",
   serverUrl:"ServerUrl",
   enableLog:true,
   debugMode: "debug",//テストモードを設定
   triggerListener:function(result){
       
   }
 });

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

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

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

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

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

5.1 追加​

//初期化時にcustomFetchParamsパラメータを指定
TDApp.init({
   appId: "AppId",
   serverUrl:"ServerUrl",
   enableLog:true,
   customFetchParams:{
   }
 });
//またはsetCustomFetchParamsを呼び出す
TDStrategy.setCustomFetchParams({});

5.2 削除​

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

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