出站即時資料傳輸過程將用戶資料作為一系列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類型。
|
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 |
陣列 |
區段物件的陣列。 對於即時訊息,陣列包含使用者所屬的所有區段。 對於批次訊息,陣列僅包含自上次批次以來的區段變更。 |
Segmnent.Segment_ID |
整數 |
區段的識別碼。 在大多數情況下,這是Audience Manager產生的區段ID(整數)。 在某些情況下,如果目標平台允許,客戶可以在Audience Manager使用者介面(開啟文字欄位)中定義區段識別碼,這會反映在此屬性中。 |
Segment.Status |
整數 |
定義區段中使用者的狀態。 接受下列值:
使用者會取消分段:
當使用者取消分段時,同步至Audience Manager ID的所有合作夥伴ID都會收到 |
Segment.DateTime |
DateTime |
最近驗證使用者區段資格的時間。 |
您可以透過使用私密金鑰或透過OAuth 2.0通訊協定讓Audience Manager驗證簽署HTTP要求來保護即時傳出資料傳輸程式的安全。
即時請求看起來可能類似下列:
{
"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"
}]
}]
}