Show Menu
主題×

即時出站資料傳輸

出站即時資料傳輸過程將用戶資料作為一系列格式化消 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 UI(開啟文字欄位)中定義區段識別碼,然後會反映在此屬性中。
Segment.Status
整數
定義群體中使用者的狀態。 接受下列值:
  • 1 :作用中(預設)
  • 0 :非活動中、選擇退出或未分段。
當使用者符合下列條件時,會取消劃分使用者:
  • 根據區段規則從區段移除。
  • 根據區段的上線時間間隔, 從區段中移除
  • 如果最近120天未看到非活動狀態,則移至非活動狀態。
  • 因隱私權變更要求而移除(例如 GDPR )
同步至 Audience Manager ID的所有合作夥伴ID,在取消區隔使 "Status":"0" 用者時都會收到旗標。
Segment.DateTime
DateTime
使用者區段資格最近驗證的時間。

安全性

您可以使用私密金鑰簽署 HTTP請求 ,或透過 Audience Manager(../../../integration/receiving-audience-data/real-time-outbound-transfers/oauth-in-outbound-transfers.md) 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"
        }]
    }]
}