管理異動訊息

關於交易式訊息傳送

建立並發佈交易事件後,您必須將觸發此事件整合到您的網站中。

注意

設定事件會顯示在本節中。

例如,您希望當客戶在購物車中購買產品之前離開您的網站時,觸發「購物車放棄」事件。 若要這麼做,您的網頁開發人員必須使用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預覽按鈕提供請求範例。 請參閱本區段

可以將下列可選參數添加到事件內容中,以管理連結到事件的事務性消息的發送:

  • expiration (可選):在此日期之後,事務性事件的傳送將被取消。
  • scheduled (可選):從此日期開始,將處理事務性事件併發送事務性消息。
注意

"expiration"和"scheduled"參數的值遵循ISO 8601格式。 ISO 8601指定使用大寫字母"T"來分隔日期和時間。 不過,您可將它從輸入或輸出中移除,以提高可讀性。

回應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無法擴充用於訊息定位的連結。

本頁內容