文档 Audience Manager Audience Manager 用户指南

实时出站数据传输 real-time-outbound-data-transfers

Last update: Sat May 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
Outbound Data Transfers

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

频度

使用者符合區段資格時，此資料傳輸方法可近乎即時傳送資料。即時訊息只會在使用者上線並主動對Audience Manager邊緣網路可見時傳送。或者，此方法也可以傳送批次的離線或已上線資料，頻率為每24小時一次。

批次傳輸

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

速率限制

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

必要的回應

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

参数

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

参数

数据类型

描述

ProcessTime

日期時間

執行要求的時間。

User_DPID

整数

User.DataPartner_UUID屬性中的一個ID，可指出訊息中所包含的裝置ID型別。

Android ID (GAID)： 20914
iOS ID (IDFA)： 20915
Web/Cookie ID：因目的地平台而異

Client_ID

字符串

代表目的地平台中的目標帳戶。此ID源自於目的地平台。

AAM_Destination_ID

整数

Audience Manager「destination」物件的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

数组

區段物件的陣列。對於即時訊息，陣列包含使用者屬於的所有區段。對於批次訊息，陣列僅包含自上次批次以來的區段變更。

Segment.Segment_ID

整数

區段的識別碼。在大多數情況下，這是Audience Manager產生的區段ID （整數）。在某些情況下，如果目的地平台允許，客戶可以在Audience Manager使用者介面（開放文字欄位）中定義區段識別碼，這會反映在此屬性中。

Segment.Status

整数

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

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

使用者符合以下條件時，系統不會進行分段：

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

同步至的所有合作夥伴ID Audience Manager ID將接收 "Status":"0" 標幟未分段的使用者。

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

recommendation-more-help

de293fbf-b489-49b0-8daa-51ed303af695

实时出站数据传输 real-time-outbound-data-transfers

推荐

频度

批次傳輸

速率限制

必要的回應

参数

安全性

请求