建立並發佈交易式事件後,您必須將此事件的觸發整合至您的網站。
事件設定在 本節.
例如,您希望當客戶在購物車中購買產品之前離開您的網站時,觸發「購物車放棄」事件。 若要這麼做,身為網頁開發人員,您必須使用REST交易式訊息API。
交易式事件會透過具有下列URL結構的POST請求傳送:
POST https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>
<organization>:您的個人組織ID。 請參閱本節。
<transactionalapi>:交易式訊息API endPoints。
交易式訊息API端點的名稱取決於您的執行個體設定。 它對應至「mc」值,後面接著您的個人組織ID。 以Geometrixx公司為例,其組織ID為"geometrixx"。 在這種情況下,POST請求如下:
POST https://mc.adobe.io/geometrixx/campaign/mcgeometrixx/<eventID>
請注意,交易式訊息API端點也會在API預覽期間顯示。
<eventid>:您要傳送的事件類型。 此ID會在建立事件設定時產生(請參閱 本節)。
請求必須包含「內容類型: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' \
事件資料包含在JSONPOST內文中。 事件結構取決於其定義。 資源定義畫面中的API預覽按鈕提供請求範例。 請參閱本節。
可將下列選用參數新增至事件內容,以管理連結至事件的交易式訊息的傳送:
「過期」和「已排程」參數的值遵循ISO 8601格式。 ISO 8601指定使用大寫字母"T"來分隔日期和時間。 但可從輸入或輸出中移除,以提高可讀性。
POST回應會在建立交易式事件時傳回其狀態。 若要擷取其目前狀態(事件資料、事件狀態……),請在GET請求中使用POST回應傳回的主索引鍵:
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":""
}
在回應中,「狀態」欄位可讓您知道事件是否已處理: