管理異動訊息

建立並發佈交易式事件後，您必須將此事件的觸發整合至您的網站。

例如，您希望當客戶在購物車中購買產品之前離開您的網站時，觸發「購物車放棄」事件。 若要這麼做，身為網頁開發人員，您必須使用REST交易式訊息API。

1. 根據POST方法傳送要求，這會觸發 交易式事件的傳送.
2. POST要求的回應包含主要金鑰，可讓您透過GET要求傳送一或多個要求。 然後，您就能取得 事件狀態.

傳送交易式事件

交易式事件會透過具有下列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會在建立事件設定時產生(請參閱 本節)。

POST請求標題

請求必須包含「內容類型：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":""
}

交易式事件狀態

在回應中，「狀態」欄位可讓您知道事件是否已處理：

• 擱置:事件擱置中 — 事件剛觸發時就會進入此狀態。
• 處理:事件處於待定傳送狀態 — 該事件正在轉換為訊息並傳送訊息。
• 暫停:事件進程正在暫停。 不再處理，而是會保留在Adobe Campaign資料庫的佇列中。 如需詳細資訊，請參閱本章節。
• 已處理:已處理事件且已成功傳送訊息。
• 忽略:傳送會忽略事件，通常是在地址處於隔離狀態時。
• deliveryFailed:處理事件時發生傳送錯誤。
• routingFailed:路由階段失敗 — 例如，當找不到指定的事件類型時，可能會發生此情況。
• tooOld:事件在能夠處理前已過期 — 這可能會因多種原因而發生，例如，當傳送失敗多次（這會導致事件不再為最新狀態），或當伺服器變得超載後無法再處理事件。
• targetingFailed:Campaign Standard無法擴充用於訊息定位的連結。