即時傳出資料傳輸 real-time-outbound-data-transfers

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

建議

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

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

頻率

這種資料傳輸方法能夠在用戶滿足資料段要求時,即時地發送資料。 只有在用戶線上且對Audience Manager邊緣網路可主動看到時,才會傳送即時消息。 此外,此方法還可以每24小時發送一批離線或掛接資料。

批轉移

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

速率限制

未對已傳送消息的吞吐量設定速率限制。 設定速率限制可能會導致資料丟失。

所需響應

預設情況下,收件人伺服器必須返回 200 OK 用於指示成功接收的代碼。 其他代碼將被解釋為失敗。 此響應應在3000毫秒內。 為了應對失敗, Audience Manager 將僅進行一次重試。

參數

下表定義了 JSON 發送到目標的資料檔案。

參數
資料類型
說明
ProcessTime
日期時間
執行請求的時間。
User_DPID
整數

User.DataPartner_UUID屬性中指示消息中包含的設備ID類型的ID。

  • Android ID(GAID): 20914
  • iOSID(IDFA): 20915
  • Web/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天中未看到它們,則將其移至非活動狀態。
  • 由於隱私更改請求(即 格德普)

同步到的所有合作夥伴ID Audience Manager ID將接收 "Status":"0" 標籤。

Segment.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"
        }]
    }]
}
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695