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

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

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

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

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

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

API トリガーキャンペーンを作成するプロセスは、API ペイロードで実行されるオーディエンスの選択を除き、スケジュール済みキャンペーンと同じです。キャンペーンの作成方法について詳しくは、この節を参照してください。

API トリガーキャンペーンを作成するには、次の手順に従います。

  1. API トリガー​タイプの新しいキャンペーンを作成します。

  2. メッセージの送信に使用するチャネルとチャネルサーフェスを選択し、「作成」をクリックします。

  3. キャンペーンのタイトルと説明を指定し、送信するメッセージを設定します。

    メモ

    追加のデータを API ペイロードに渡して、メッセージのパーソナライズに利用できます。詳細情報

    コンテンツで多数または大量のコンテキストデータを使用すると、パフォーマンスに影響を与える可能性があります。

  4. オーディエンス」セクションで、セグメントから個人を識別するために使用する名前空間を指定します。

    新規プロファイルを作成」オプションを使用すると、データベースに存在しないプロファイルを自動的に作成できます。キャンペーン実行時のプロファイル作成について詳しくはこちらから

  5. キャンペーンの開始日と終了日を設定します。

    キャンペーンの特定の開始日や終了日を設定した場合、そのキャンペーンはこれらの日付以外では実行されず、キャンペーンが API によってトリガーされると API 呼び出しは失敗します。

  6. cURL リクエスト」セクションで、API ペイロードで使用する​キャンペーン ID を取得します。

  7. アクティブ化するレビュー」をクリックして、キャンペーンが正しく設定されていることを確認してからアクティブ化します。

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

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

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

メモ

プロファイル対応のイベントとは異なり、REST API で渡されるコンテキストデータは、1 回限りの通信に使用され、プロファイルに対しては保存されません。プロファイルが見つからなかった場合、名前空間の詳細を最大限に使用してプロファイルが作成されます。

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

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

重要

context.system 構文はアドビ内部での使用のみに制限されているので、コンテキスト属性を渡すために使用しないでください。

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

キャンペーンの実行

API トリガーキャンペーンを実行するには、まずその ID を取得して、API ペイロードに渡す必要があります。それには、キャンペーンを開き、「cURL リクエスト」セクションから ID をコピー&ペーストします。

その後、この ID を API ペイロードに使用して、キャンペーンをトリガーできます。詳しくは、インタラクティブメッセージ実行 API ドキュメントを参照してください。

なお、キャンペーンを作成する際に特定の開始日や終了日を設定している場合、そのキャンペーンはこれらの日付以外では実行されず、API 呼び出しは失敗します。

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

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

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

重要

この機能は、大量のトランザクションを送信するユースケースにおいて、既にプラットフォーム上に存在する大量のプロファイルを使用して、非常に小さいボリュームプロファイルを作成​する目的で提供されます。

キャンペーンの実行時にプロファイルの作成を有効にするには、「オーディエンス」セクションで、「新しいプロファイルの作成」オプションを切り替えます。

メモ

不明なプロファイルが、AJO インタラクティブメッセージングプロファイルデータセット​の、3 つのアウトバウンドチャネル(メール、SMS、プッシュ)に対応するそれぞれのデフォルト名前空間(メール、電話、ECID)に作成されます。

このページ