实时出站数据传输

出站实时数据传输过程将用户数据作为一系列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 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"
        }]
    }]
}

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free