Show Menu
主题×

实时出站数据传输

该出站实时数据传输过程将用户数据作为一系列格式化消息 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
整数
一个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 UI(打开文本字段)中定义区段标识符,然后该标识符会反映在此属性中。
Segment.Status
整数
定义区段中用户的状态。 接受以下值:
  • 1 :活动(默认)
  • 0 :非活动、已选择退出或未分段。
用户在以下情况下将取消分段:
  • 根据区段规则从区段中删除。
  • 根据区段的生存时间间隔从 区段中删除
  • 如果最近120天未看到活动状态,则将其移至非活动状态。
  • 由于隐私权更改请求(即 GDPR )而删除
同步到 Audience Manager ID的所有合作伙伴ID将在用户取消分 "Status":"0" 段时收到该标志。
Segment.DateTime
DateTime
最近验证用户区段资格的时间。

安全性

通过使用私钥对 HTTP请求进行签名 ,或通过 Audience Manager OAuth 2.0协议进行身份验证,可以保护实时出站数据传输过程 OAuth 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"
        }]
    }]
}