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