API を使用したキャンペーンのトリガー trigger-campaigns
API トリガー型キャンペーンについて about
Journey Optimizer を使用すると、キャンペーンを作成したあと、 インタラクティブメッセージ実行 REST API を使用して、ユーザートリガーに基づいて外部システムからそれらのキャンペーンを実行できます。 これにより、パスワードのリセットや OTP トークンなど、マーケティングメッセージおよびトランザクションメッセージの様々なニーズに対応できます。
それには、まず Journey Optimizer で API トリガー型キャンペーンを作成し、次に API 呼び出しを通じてその実行を開始する必要があります。
API トリガー型キャンペーンで使用できるチャネルは、メール、SMS およびプッシュメッセージです。
➡️ この機能をビデオで確認
API トリガーキャンペーンの作成 create
キャンペーンの設定とアクティブ化 create-activate
API トリガーキャンペーンを作成するには、次の手順に従います。キャンペーンの作成方法について詳しくは、この節を参照してください。
-
API トリガー タイプの新しいキャンペーンを作成します。
-
送信する通信のタイプに応じて、マーケティング カテゴリまたは トランザクション カテゴリを選択します。
-
メッセージの送信に使用するサポート対象チャネルの 1 つとそれに関連するチャネル設定を選択し、「作成」をクリックします。
-
キャンペーンのタイトルと説明を指定し、「コンテンツを編集」をクリックして送信するメッセージを設定します。
note note NOTE 追加のデータを API ペイロードに渡して、メッセージのパーソナライズに利用できます。詳細情報 コンテンツで多数または大量のコンテキストデータを使用すると、パフォーマンスに影響を与える可能性があります。 -
「オーディエンス」セクションで、個人の識別に使用する名前空間を指定します。
-
トランザクション タイプのキャンペーンを作成している場合は、API 呼び出しでターゲットプロファイルを定義する必要があります。「新規プロファイルを作成」オプションを使用すると、データベースに存在しないプロファイルを自動的に作成できます。キャンペーン実行時のプロファイル作成について詳しくはこちらから
note note NOTE 1 回の API 呼び出しで最大 20 人のユニーク受信者をサポートできます。各受信者は一意のユーザー ID を持つ必要があり、重複するユーザー ID は許可されていません。詳しくは、Interactive Message Execution API ドキュメントを参照してください -
マーケティング タイプのキャンペーンの場合は、「オーディエンス」ボタンをクリックして、ターゲットにするオーディエンスを選択します。
-
-
キャンペーンの開始日と終了日を設定します。
キャンペーンの開始日や終了日を特定の日付に設定した場合、そのキャンペーンはこれらの日付以外では実行されず、キャンペーンが API によってトリガーされると API 呼び出しは失敗します。
-
「レビューしてアクティベート」をクリックして、キャンペーンが正しく設定されていることを確認してからアクティブ化します。
これで、API からキャンペーンを実行する準備が整いました。 詳細情報
キャンペーンの実行 execute
キャンペーンがアクティブ化されたら、生成されたサンプル cURL リクエストを取得、それを API で使用してペイロードを作成し、キャンペーンをトリガーする必要があります。
-
キャンペーンを開き、「cURL リクエスト」セクションからペイロードリクエストをコピー&ペーストします。このペイロードには、メッセージで使用されるすべてのパーソナライゼーション(プロファイルとコンテキスト)変数が含まれます。キャンペーンがライブになったら使用できます。
-
この API への cURL リクエストを使用して、ペイロードを作成し、キャンペーンをトリガーします。詳しくは、 Interactive Message Execution API ドキュメントを参照してください。
API 呼び出しの例については、こちらのページも参照してください。
note note NOTE キャンペーンを作成する際に特定の開始日や終了日を設定している場合、そのキャンペーンはこれらの日付以外では実行されず、API 呼び出しは失敗します。
API トリガー型キャンペーンでのコンテキスト属性の使用 contextual
API トリガー型キャンペーンを使用すると、追加のデータを API ペイロードに渡し、キャンペーン内で使用してメッセージをパーソナライズできます。
この例では、パスワードのリセットを希望する顧客に、サードパーティツールで生成されるパスワードリセット URL を送信するとします。API トリガー型キャンペーンを使用すると、生成されたこの URL を API ペイロードに渡し、キャンペーンに活用してメッセージに追加できます。
これらのデータをキャンペーンで使用するには、データを API ペイロードに渡し、パーソナライゼーションエディターを使用してメッセージに追加する必要があります。それには、{{context.<contextualAttribute>}}
構文を使用します。ここで、<contextualAttribute>
は、渡すデータを含んだ API ペイロード内の変数の名前と一致する必要があります。
この {{context.<contextualAttribute>}}
構文は String データタイプにのみマッピングされます。
context.system
構文はアドビ内部での使用のみに制限されているので、コンテキスト属性を渡すために使用しないでください。なお、現時点では、左側のパネルメニューで使用できるコンテキスト属性はありません。 属性はパーソナライゼーション式に直接入力する必要がありますが、Journey Optimizer によるチェックは行われません。
キャンペーン実行時のプロファイル作成 profile-creation
場合によっては、システムに存在しないプロファイルにトランザクションメッセージを送信する必要があります。例えば、不明なユーザーが web サイトにログインしようとした場合などです。
データベースにプロファイルが存在しない場合、Journey Optimizer では、キャンペーンの実行時にプロファイルを自動的に作成して、このプロファイルにメッセージを送信できるようにします。
キャンペーンの実行時にプロファイルの作成を有効にするには、「オーディエンス」セクションで、「新規プロファイルを作成」オプションを有効にします。このオプションを無効にした場合、不明なプロファイルの送信は拒否され、API 呼び出しは失敗します。
チュートリアルビデオ video
インタラクティブメッセージ実行 REST API を使用して、キャンペーンを作成し、ユーザーインタラクションに基づいて外部システムからキャンペーンをトリガーする方法について説明します。