傳出的即時資料傳輸程式會以一系列方式提供使用者資料 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 |
陣列 |
區段物件的陣列。 對於即時訊息,陣列包含使用者所屬的所有區段。 對於批次訊息,陣列僅包含自上次批次以來的區段變更。 |
Segment.Segment_ID |
整數 |
區段的識別碼。 在大多數情況下,這是Audience Manager產生的區段ID(整數)。 在某些情況下,如果目標平台允許,客戶可以在Audience Manager使用者介面(開啟文字欄位)中定義區段識別碼,這會反映在此屬性中。 |
Segment.Status |
整數 |
定義區段中使用者的狀態。 接受下列值:
使用者會取消分段:
同步至 Audience Manager ID會收到 |
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"
}]
}]
}