出站实时数据传输过程将用户数据作为一系列JSON格式化消息传送到目标平台。
要使用此方法,目标平台必须满足以下要求:
Content-type: application/json
)的数据;HTTPS
数据传输。 Audience Manager 不会通过不安全协议发送 HTTP
消息。这种数据传输方法可以在用户符合细分条件时近乎实时地发送数据。 实时消息仅在用户处于联机状态且对Audience Manager边缘网络可见时发送。 或者,此方法还可以每24小时发送一批脱机或已载入的数据。
实时传输和批处理传输都发送到同一端点,并使用相同的消息格式。 启用批传输后,目标平台在传送批传输消息时,将看到消息量中的尖峰。 通过实时消息发送的许多细分资格将在批处理消息中重复。 批转移将仅包括自上一批交付后已更改的段资格(或取消资格)。
没有对已传送消息的吞吐量设置速率限制。 设置费率限制可能导致数据丢失。
默认情况下,收件人服务器必须返回200 OK
代码以指示成功接收。 其他代码将被解释为失败。 此响应应在3000毫秒内完成。 为响应失败,Audience Manager将仅进行一次重试尝试。
下表定义了发送到目标的JSON数据文件中的元素。
参数 | 数据类型 | 描述 |
---|---|---|
ProcessTime |
DateTime |
执行请求的时间。 |
User_DPID |
整数 |
一个ID,它指示消息中包含的设备ID的类型,位于User.DataPartner_UUID属性中。
|
Client_ID |
字符串 |
表示目标平台中的目标帐户。 此ID来自目标平台。 |
AAM_Destination_ID |
整数 |
Audience Manager“目标”对象的ID。 此ID来自Audience Manager。 |
User_count |
整数 |
|
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 |
整数 |
定义区段中用户的状态。 接受以下值:
当用户处于以下状态时,用户将取消分组:
与Audience Manager ID同步的所有合作伙伴ID在用户未分段时都将收到 |
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"
}]
}]
}