实时出站数据传输

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

推荐

要使用此方法,目标平台必须满足以下要求:

  • 它必须提供能够缩放以接收大量Audience Manager消息的端点URL;
  • 它必须接受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。

  • 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"
        }]
    }]
}

在此页面上