出站即時資料傳輸過程將用戶資料作為一系列 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。
|
Client_ID |
字串 |
表示目標平台中的目標帳戶。 此ID源自目標平台。 |
AAM_Destination_ID |
整數 |
Audience Manager「目標」對象的ID。 此ID源於Audience Manager。 |
User_count |
整數 |
中的用戶總數 |
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 |
整數 |
定義段中用戶的狀態。 接受以下值:
當用戶是:
同步到的所有合作夥伴ID Audience Manager ID將接收 |
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"
}]
}]
}