API を使用したキャンペーンのトリガー trigger-campaigns

API トリガー型キャンペーンについて about

Journey Optimizer を使用すると、キャンペーンを作成したあと、 インタラクティブメッセージ実行 REST API を使用して、ユーザートリガーに基づいて外部システムからそれらのキャンペーンを実行できます。 これにより、パスワードのリセットや OTP トークンなど、マーケティングメッセージおよびトランザクションメッセージの様々なニーズに対応できます。

それには、まず Journey Optimizer で API トリガー型キャンペーンを作成し、次に API 呼び出しを通じてその実行を開始する必要があります。

API トリガー型キャンペーンで使用できるチャネルは、メール、SMS およびプッシュメッセージです。

➡️ この機能をビデオで確認

API トリガーキャンペーンの作成 create

キャンペーンの設定とアクティブ化 create-activate

API トリガーキャンペーンを作成するには、次の手順に従います。キャンペーンの作成方法について詳しくは、この節を参照してください。

これで、API からキャンペーンを実行する準備が整いました。 詳細情報

キャンペーンの実行 execute

キャンペーンがアクティブ化されたら、生成されたサンプル cURL リクエストを取得、それを API で使用してペイロードを作成し、キャンペーンをトリガーする必要があります。

API トリガー型キャンペーンでのコンテキスト属性の使用 contextual

API トリガー型キャンペーンを使用すると、追加のデータを API ペイロードに渡し、キャンペーン内で使用してメッセージをパーソナライズできます。

この例では、パスワードのリセットを希望する顧客に、サードパーティツールで生成されるパスワードリセット URL を送信するとします。API トリガー型キャンペーンを使用すると、生成されたこの URL を API ペイロードに渡し、キャンペーンに活用してメッセージに追加できます。

これらのデータをキャンペーンで使用するには、データを API ペイロードに渡し、パーソナライゼーションエディターを使用してメッセージに追加する必要があります。それには、{{context.<contextualAttribute>}} 構文を使用します。ここで、<contextualAttribute> は、渡すデータを含んだ API ペイロード内の変数の名前と一致する必要があります。

この {{context.<contextualAttribute>}} 構文は String データタイプにのみマッピングされます。

なお、現時点では、左側のパネルメニューで使用できるコンテキスト属性はありません。 属性はパーソナライゼーション式に直接入力する必要がありますが、Journey Optimizer によるチェックは行われません。

キャンペーン実行時のプロファイル作成 profile-creation

場合によっては、システムに存在しないプロファイルにトランザクションメッセージを送信する必要があります。例えば、不明なユーザーが web サイトにログインしようとした場合などです。

データベースにプロファイルが存在しない場合、Journey Optimizer では、キャンペーンの実行時にプロファイルを自動的に作成して、このプロファイルにメッセージを送信できるようにします。

キャンペーンの実行時にプロファイルの作成を有効にするには、「オーディエンス」セクションで、「新規プロファイルを作成」オプションを有効にします。このオプションを無効にした場合、不明なプロファイルの送信は拒否され、API 呼び出しは失敗します。

チュートリアルビデオ video

インタラクティブメッセージ実行 REST API を使用して、キャンペーンを作成し、ユーザーインタラクションに基づいて外部システムからキャンペーンをトリガーする方法について説明します。