管理異動訊息

關於交易式訊息傳送

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

注意

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

例如，您希望當客戶在購物車中購買產品之前離開您的網站時，觸發「購物車放棄」事件。 若要這麼做，您的網頁開發人員必須使用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無法擴充用於訊息定位的連結。

本頁內容