即時傳出資料傳輸

傳出的即時資料傳輸程式會以一系列方式提供使用者資料 JSON 格式化訊息至目的地平台。

建議

若要使用此方法，目的地平台必須符合下列需求：

  • 它必須提供端點 URL 可以擴展以接收來自Audience Manager的大量報文；
  • 它必須接受 JSON 格式(Content-type: application/json);
  • 它必須接受安全 HTTPS 資料傳輸。 Audience Manager 不會透過不安全傳送訊息 HTTP 協定。

頻率

當使用者符合區段的資格時，此資料傳輸方法可近乎即時傳送資料。 即時訊息只會在使用者上線且Audience Manager邊緣網路可主動看見時傳送。 或者，此方法也可以每24小時傳送批次離線或已上線的資料。

批轉移

即時和批次傳輸都會傳送至相同的端點，並使用相同的訊息格式。 啟用批次傳輸後，目的地平台在傳送批次訊息時，訊息量會出現尖峰。 透過即時訊息傳送的許多區段資格會在批次訊息中重複。 批轉移將僅包括自上次交付批後更改的段資格（或取消資格）。

比率限制

傳送訊息的吞吐量沒有設定速率限制。 設定速率限制可能會導致資料遺失。

必要的回應

依預設，收件者伺服器必須傳回 200 OK 表示成功接收的代碼。 其他程式碼則會解譯為失敗。 此回應應在3000毫秒內完成。 因為失敗， Audience Manager 將僅嘗試一次重試。

參數

下表定義 JSON 傳送至目的地的資料檔案。

參數 資料類型 說明
ProcessTime

DateTime

執行要求的時間。

User_DPID

整數

此ID表示訊息User.DataPartner_UUID屬性中包含的裝置ID類型。

  • Android ID(GAID): 20914
  • iOS ID(IDFA): 20915
  • 網頁/Cookie ID:依目的地平台而異
Client_ID

字串

代表目標平台中的目標帳戶。 此ID源自於目的地平台。
AAM_Destination_ID

整數

Audience Manager「目的地」物件的ID。 此ID源自Audience Manager。
User_count

整數

中的使用者總數 POST 請求。

Users

陣列

用戶對象的陣列。 依預設，每則訊息將包含1到10位使用者，以保持訊息大小最佳。

User.AAM_UUID

字串

此 Audience Manager UUID.

User.DataPartner_UUID

字串

目的地平台UUID或全域裝置ID。

User.AAM_Regions 陣列 此 Audience Manager 我們看過這個裝置的地區ID。 例如，如果裝置在巴黎（歐洲）有某些活動，則地區ID會是 6. 請參閱 DCS 地區 ID、位置與主機名稱。
Segments

陣列

區段物件的陣列。 對於即時訊息，陣列包含使用者所屬的所有區段。 對於批次訊息，陣列僅包含自上次批次以來的區段變更。
Segment.Segment_ID

整數

區段的識別碼。 在大多數情況下，這是Audience Manager產生的區段ID（整數）。 在某些情況下，如果目標平台允許，客戶可以在Audience Manager使用者介面（開啟文字欄位）中定義區段識別碼，這會反映在此屬性中。

Segment.Status

整數

定義區段中使用者的狀態。 接受下列值：

  • 1:活動（預設）
  • 0:非使用中、選擇退出或取消細分。

使用者會取消分段：

  • 根據區段規則從區段中移除。
  • 根據區段的 存留時間間隔.
  • 如果過去120天未顯示，則移至非使用中狀態。
  • 因隱私權變更請求而移除(即 GDPR)

同步至 Audience Manager ID會收到 "Status":"0" 取消分段使用者時的旗標。

Segment.DateTime

DateTime

最近驗證使用者區段資格的時間。

安全性

您可以借由 簽署HTTP要求 使用私密金鑰或 Audience Manager 通過驗證 OAuth 2.0 協定。

請求

即時請求看起來可能類似下列：

{
"ProcessTime": "Wed Jul 27 16:17:42 UTC 2016",
"User_DPID": "12345",
"Client_ID": "74323",
"AAM_Destination_Id": "423",
"User_count": "2",
"Users": [{
   "AAM_UUID": "19393572368547369350319949416899715727",
   "DataPartner_UUID": "4250948725049857",
   "AAM_Regions": ["9"],
   "Segments": [{
            "Segment_ID": "14356",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:22 UTC 2016"
         },
         {
            "Segment_ID": "12176",
            "Status": "0",
            "DateTime": "Wed Jul 27 16:17:22 UTC 2016"
         }
      ]
   },
   {
   "AAM_UUID": "0578240750487542456854736923319946899715232",
   "DataPartner_UUID": "848457757347734",
   "AAM_Regions": ["9"],
   "Segments": [{
            "Segment_ID": "10329",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:21 UTC 2016"
         },
         {
            "Segment_ID": "23954",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:21 UTC 2016"
        }]
    }]
}

本頁內容