文件Audience ManagerAudience Manager 使用手冊

即時傳出資料傳輸 real-time-outbound-data-transfers

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

輸出即時資料傳輸程式會將使用者資料以一系列JSON格式訊息的形式傳送到目的地平台。

建議

若要使用此方法，目的地平台必須符合下列要求：

  • 它必須提供端點URL，此端點可以調整為接收來自Audience Manager的大量訊息；
  • 它必須接受JSON格式(Content-type: application/json)的資料；
  • 它必須接受安全的HTTPS資料傳輸。 Audience Manager不會透過不安全的HTTP通訊協定傳送訊息。

頻率

使用者符合區段資格時，此資料傳輸方法可近乎即時傳送資料。 即時訊息只會在使用者上線且主動可顯示於Audience ManagerEdge網路時傳送。 此方法可選擇性地以每24小時的頻率傳送批次離線或已上線的資料。

批次傳輸

即時和批次傳輸都會傳送至相同的端點，並使用相同的訊息格式。 當啟用批次傳輸時，在傳遞批次訊息時，目的地平台的訊息量將會激增。 透過即時訊息傳送的許多區段資格將在批次訊息中重複。 批次移轉將僅包含自上次傳遞批次以來變更的區段資格（或取消資格）。

速率限制

傳送訊息的輸送量沒有速率限制。 設定速率限制可能會導致資料遺失。

必要的回應

依預設，收件者伺服器必須傳回200 OK代碼以表示成功回條。 其他程式碼將解譯為失敗。 此回應預計在3000毫秒內完成。 回應失敗，Audience Manager將只進行一次重試嘗試。

參數

下表定義您傳送至目的地的JSON資料檔案中的元素。

參數
資料類型
說明
ProcessTime
日期時間
執行要求的時間。
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「destination」物件的識別碼。 此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地區識別碼。 例如，如果裝置在巴黎有某些活動（歐洲），則區域識別碼將是 6。 請參閱 DCS地區ID、位置與主機名稱。
Segments
陣列
區段物件的陣列。 若是即時訊息，陣列會包含使用者屬於的所有區段。 對於批次訊息，陣列僅包含自上次批次以來的區段變更。
Segment.Segment_ID
整數
區段的識別碼。 在大多數情況下，這是Audience Manager產生的區段ID （整數）。 在某些情況下，如果目標平台允許，客戶可以在Audience Manager使用者介面（開放文字欄位）中定義區段識別碼，這隨後會反映在此屬性中。
Segment.Status
整數

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

  • 1：作用中（預設）
  • 0：非使用中、選擇退出或未分段。

當使用者符合以下條件時，系統不會將其分段：

  • 根據區段規則從區段中移除。
  • 已根據區段的存留時間間隔從區段中移除。
  • 如果過去120天未出現，則移至非作用中狀態。
  • 因隱私權變更要求而移除（即 GDPR）

所有同步至合作夥伴Audience Manager識別碼的合作夥伴ID都會在使用者未分段時收到 "Status":"0"標幟。

Segment.DateTime
日期時間
最近驗證使用者區段資格的時間。

安全性

您可以使用私密金鑰簽署HTTP要求，或透過OAuth 2.0通訊協定進行Audience Manager驗證，來保護您的即時傳出資料傳輸程式。

請求

即時請求看起來可能類似以下內容：

{
"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"
        }]
    }]
}
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695