Adobe Experience League

即時傳出資料傳輸

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

安全性

您可以使用私密金鑰來簽署HTTP要求，或透過Audience ManagerOAuth 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"
        }]
    }]
}