实时出站数据传输

出站实时数据传输过程将用户数据作为一系列JSON格式化消息传送到目标平台。

频度

这种数据传输方法可以在用户符合细分条件时近乎实时地发送数据。实时消息仅在用户处于联机状态且对Audience Manager边缘网络可见时发送。或者，此方法还可以每24小时发送一批脱机或已载入的数据。

批转移

实时传输和批处理传输都发送到同一端点，并使用相同的消息格式。启用批传输后，目标平台在传送批传输消息时，将看到消息量中的尖峰。通过实时消息发送的许多细分资格将在批处理消息中重复。批转移将仅包括自上一批交付后已更改的段资格（或取消资格）。

费率限制

没有对已传送消息的吞吐量设置速率限制。设置费率限制可能导致数据丢失。

所需的答复

默认情况下，收件人服务器必须返回200 OK代码以指示成功接收。其他代码将被解释为失败。此响应应在3000毫秒内完成。为响应失败，Audience Manager将仅进行一次重试尝试。

参数

下表定义了发送到目标的JSON数据文件中的元素。

参数	数据类型	描述
`ProcessTime`	DateTime	执行请求的时间。
`User_DPID`	整数	一个ID，它指示消息中包含的设备ID的类型，位于User.DataPartner_UUID属性中。 Android ID(GAID): `20914` iOS ID(IDFA): `20915` Web/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请求进行签名，或通过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"
        }]
    }]
}