文档 Audience Manager Audience Manager 用户指南

实时出站数据传输 real-time-outbound-data-transfers

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

出站实时数据传输进程将用户数据作为一系列JSON格式消息传送到目标平台。

频度

这种数据传输方法可以在用户符合区段资格时近乎实时地发送数据。实时消息仅在Audience Manager在线并对Edge网络主动可见时投放。或者，此方法也可以每24小时发送一批离线或已载入的数据。

批量传输

实时传输和批量传输都发送到同一端点，并使用相同的消息格式。启用批量传输后，在交付批量消息时，目标平台的消息量将会激增。通过实时报文发送的许多区段资格将在批量报文中重复。批转移将仅包括自上次交付批以来更改的区段资格（或取消资格）。

速率限制

未对投放消息的吞吐量设置速率限制。设置速率限制可能会导致数据丢失。

必需的响应

默认情况下，收件人服务器必须返回200 OK代码以指示接收成功。其他代码将解释为失败。此响应应在3000毫秒内完成。为响应失败，Audience Manager将仅进行一次重试尝试。

参数

下表定义了您发送到目标的JSON数据文件中的元素。

参数

数据类型

描述

ProcessTime

日期时间

执行请求的时间。

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

数组

区段对象的数组。对于实时消息，数组包含用户属于的所有区段。对于批处理消息，数组仅包含自上一批处理以来的区段更改。

Segment.Segment_ID

整数

区段的标识符。在大多数情况下，这是由Audience Manager生成的区段ID（整数）。在某些情况下，如果目标平台允许，客户可以在Audience Manager用户界面中定义区段标识符（打开文本字段），该标识符随后将反映在此属性中。

Segment.Status

整数

定义用户在区段中的状态。接受以下值：

1：活动（默认）
0：不活动、已选择退出或未分段。

用户在以下情况下不会进行分段：

根据区段规则从区段中删除。
根据区段的生存时间间隔从区段中删除。
如果最近120天未看到这些幻灯片，则将其移至不活动状态。
由于隐私更改请求（即 GDPR）已删除

未对Audience Manager进行分段时，同步到 ID ID的所有合作伙伴ID都将收到 "Status":"0"标记。

Segment.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"
        }]
    }]
}

recommendation-more-help

de293fbf-b489-49b0-8daa-51ed303af695

实时出站数据传输 real-time-outbound-data-transfers

推荐

频度

批量传输

速率限制

必需的响应

参数

安全性

请求