トランザクションイベントを作成して公開したら、このイベントのトリガーを Web サイトに統合する必要があります。
イベントの設定について詳しくは、 この節.
例えば、顧客が買い物かごで商品を購入する前に Web サイトを離れたときに「買い物かごの放棄」イベントをトリガーするとします。 これをおこなうには、Web 開発者が REST トランザクションメッセージ API を使用する必要があります。
トランザクションイベントは、次の URL 構造を持つPOSTリクエストを通じて送信されます。
POST https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>
<organization>:個人の組織 ID。 この節を参照してください。
<transactionalapi>:トランザクションメッセージ API endPoints を参照してください。
トランザクションメッセージ API エンドポイントの名前は、インスタンスの設定に応じて異なります。 値「mc」に続く個人の組織 ID が該当します。 組織 ID が「geometrixx」のGeometrixx会社の例を見てみましょう。 この場合、POSTリクエストは次のようになります。
POST https://mc.adobe.io/geometrixx/campaign/mcgeometrixx/<eventID>
トランザクションメッセージ API エンドポイントは、API プレビュー時にも表示されます。
<eventid>:送信するイベントのタイプ。 この ID は、イベント設定の作成時に生成されます ( この節) をクリックします。
リクエストには「Content-Type:application/json」ヘッダー。
例えば、文字セットを追加する必要があります utf-8. この値は、使用している REST アプリケーションによって異なります。
-X POST \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json;charset=utf-8' \
-H 'Content-Length:79' \
イベントデータは、JSON イベント本文に含まれているPOSTです。 イベント構造は定義によって異なります。 リソース定義画面の API プレビューボタンには、リクエストのサンプルが表示されます。 この節を参照してください。
イベントコンテンツに追加して、イベントにリンクされたトランザクションメッセージの送信を管理できます。次のオプションのパラメーターを使用できます。
「expiration」および「scheduled」パラメーターの値は、ISO 8601 形式に従います。 ISO 8601 では、日付と時刻を区切るための大文字「T」の使用を指定しています。 ただし、読みやすくするために、入力または出力から削除できます。
POST応答は、作成時にトランザクションイベントのステータスを返します。 現在のステータス ( イベントプライマリ、イベントステータスなど ) を取得するには、POST応答で返されるイベントキーをGETリクエストで使用します。
GET https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>/
リクエストのサンプル
POSTを送信するイベントリクエスト。
-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/mcAdobe/EVTcartAbandonment \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json;charset=utf-8' \
-H 'Content-Length:79'
{
"email":"test@example.com",
"scheduled":"2017-12-01 08:00:00.768Z",
"expiration":"2017-12-31 08:00:00.768Z",
"ctx":
{
"cartAmount": "$ 125",
"lastProduct": "Leather motorbike jacket",
"firstName": "Jack"
}
}
応答リクエストに対するPOST。
{
"PKey":"<PKEY>",
"ctx":
{
"cartAmount": "",
"lastProduct": "",
"firstName": ""
}
"email":"",
"scheduled":"2017-12-01 08:00:00.768Z",
"expiration":"2017-12-31 08:00:00.768Z",
"href": "mcAdobe/EVTcartAbandonment/<PKEY>",
"serverUrl":" https://myserver.com ",
"status":"pending",
"type":""
}
応答の「status」フィールドでは、イベントが処理されたかどうかを知ることができます。