管理異動訊息 managing-transactional-messages
建立並發佈交易式事件後，您需要將此事件的觸發專案整合至您的網站。
例如，您想要在客戶購買購物車中的產品之前，於其中一人離開您的網站時觸發「購物車放棄」事件。 若要這麼做，身為網頁開發人員，您必須使用REST異動訊息API。
傳送異動事件 sending-a-transactional-event
交易式事件會透過具有下列URL結構的POST請求傳送：
POST https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>
-
<organization>：您的個人組織ID。 請參閱本節。
-
<transactionalapi>：異動訊息API端點。
異動訊息API端點的名稱取決於您的執行個體設定。 它與值「mc」相對應，後接您的個人組織ID。 讓我們以「geometrixx」作為其組織ID的Geometrixx公司為例。 在此情況下，POST要求會如下所示：
POST https://mc.adobe.io/geometrixx/campaign/mcgeometrixx/<eventID>請注意，交易式訊息API端點也會在API預覽期間顯示。
-
<eventid>：您要傳送的事件型別。 此ID是在建立事件設定時產生的(請參閱 本節)。
POST請求標頭
請求必須包含「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' \
POST要求內文
事件資料包含在JSONPOST內文中。 事件結構取決於其定義。 資源定義畫面中的API預覽按鈕提供請求範例。 請參閱本節。
您可以將下列選用引數新增至事件內容，以管理連結至事件的異動訊息的傳送：
- 有效期 （選用）：在此日期之後，交易事件的傳送將會取消。
- 已排程 （選用）：從此日期起，將會處理交易式事件並傳送交易式訊息。
回應POST要求
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":""
}
異動事件狀態 transactional-event-status
在回應中，「狀態」欄位可讓您知道事件是否已處理：
- 擱置中：事件擱置中 — 事件會在剛觸發時採取此狀態。
- 處理：事件正在等候傳遞 — 它正在轉換為訊息，且訊息正在傳送。
- 已暫停：事件程式已暫停。 系統將不再處理該檔案，但會將其保留在Adobe Campaign資料庫的佇列中。 如需詳細資訊，請參閱本章節。
- 已處理：事件已處理且訊息已成功傳送。
- 已忽略：傳送會忽略事件，通常是在地址處於隔離狀態時。
- deliveryFailed：處理事件時發生傳送錯誤。
- routingFailed：路由階段失敗 — 例如，當找不到指定的事件型別時，可能會發生此狀況。
- 太舊：事件在能夠處理之前過期 — 例如，傳送多次失敗（導致事件不再最新）或伺服器在超載後無法再處理事件時，可能會因為各種原因發生這種情況。
- 目標定位失敗：Campaign Standard無法擴充用於訊息定位的連結。