即時傳出資料傳輸

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

建議

若要使用此方法,目的地平台必須符合下列需求:

  • 它必須提供一個端點URL ,該端點可以擴展以接收來自Audience Manager的大量消息;
  • 它必須接受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類型。

  • 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使用者介面(開啟文字欄位)中定義區段識別碼,這會反映在此屬性中。

Segment.Status

整數

定義區段中使用者的狀態。 接受下列值:

  • 1:活動(預設)
  • 0:非使用中、選擇退出或取消細分。

使用者會取消分段:

  • 根據區段規則從區段中移除。
  • 根據區段的存留時間間隔從區段中移除。
  • 如果過去120天未顯示,則移至非使用中狀態。
  • 因隱私權變更請求而移除(即 GDPR)

當使用者取消分段時,同步至Audience Manager ID的所有合作夥伴ID都會收到 "Status":"0"標幟。

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"
        }]
    }]
}

本頁內容