即時傳出資料傳輸

出站即時資料傳輸過程將用戶資料作為一系列JSON格式化消息發送到目標平台。

建議

要使用此方法,目標平台必須滿足以下要求:

  • 它必須提供端點URL,可縮放以接收來自Audience Manager的大量訊息;
  • 它必須接受JSON格式(Content-type: application/json)的資料;
  • 它必須接受安全的HTTPS資料傳輸。 Audience Manager 將不會通過不安全的協定發送 HTTP 消息。

頻率

當使用者符合區段的資格時,這種資料傳輸方法可近乎即時傳送資料。 即時訊息只會在使用者線上上且主動可見Audience Manager Edge網路時傳送。 (可選)此方法也可以每24小時傳送一批離線或已登入的資料。

批轉移

即時傳輸和批次傳輸都會發送到相同的端點,並使用相同的消息格式。 啟用批次傳送後,目標平台會在傳送批次訊息時看到訊息量的尖峰。 許多透過即時訊息傳送的區段資格會在批次訊息中重複。 批轉移將僅包括自上次批交付後更改的段資格(或未資格)。

比率限制

對發送的消息的吞吐量沒有設定速率限制。 設定速率限制可能導致資料遺失。

必要回應

依預設,收件者伺服器必須傳回200 OK程式碼,以指出收件成功。 其他代碼將被解釋為失敗。 此回應預期在3000毫秒內完成。 響應失敗,Audience Manager將僅進行一次重試。

參數

下表定義了傳送到目標的JSON資料檔案中的元素。

參數 資料類型 說明
ProcessTime

DateTime

執行請求的時間。

User_DPID

整數

User.DataPartner_UUID屬性中指示消息中包含的設備ID類型的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

陣列

區段物件的陣列。 對於即時訊息,陣列包含使用者所屬的所有區段。 對於批次消息,陣列只包含自上次批次以來的段更改。

Segmnent.Segment_ID

整數

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

Segment.Status

整數

定義群體中使用者的狀態。 接受下列值:

  • 1:作用中(預設)
  • 0:非活動中、選擇退出或未分段。

當使用者符合下列條件時,會取消劃分使用者:

  • 根據區段規則從區段移除。
  • 根據區段的上線時間間隔,從區段移除。
  • 如果最近120天未看到非活動狀態,則移至此狀態。
  • 因隱私權變更要求而移除(即 GDPR)

Audience Manager ID同步的所有合作夥伴ID,在取消區隔使用者時,都會收到 "Status":"0"標幟。

Segment.DateTime

DateTime

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

安全性

您可以使用私密金鑰來簽署HTTP要求,或透過Audience ManagerOAuth 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"
        }]
    }]
}

本頁內容