Show Menu
主题×

实时出站数据传输

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

推荐

要使用此方法,目标平台必须满足以下要求:
  • 它必须提供一个 URL 端点,该端点可以缩放以接收来自Audience Manager的大量消息;
  • 它必须接受格 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属性中。
  • 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 ManagerID同步的所有合作伙 伴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"
        }]
    }]
}