Audiences
概述 contents

自定义受众:Web

info.png

信息

合作伙伴将代表广告商发送 ID (p_user_ids) 列表用于定位。此操作通过 ID 同步过程实现,该过程会在 p_user_ids 和 Twitter 用户 ID 之间建立映射。然后,该映射将用于生成用于定位的 Twitter 用户 ID 列表。通过 ads.twitter.com 自定义受众 Web 广告活动设置上的标签上指定的广告商特定 @用户名将可使用这些自定义受众。

Twitter 会提供可放置于合作伙伴标签和站点上的安全像素,以便将 ID (p_user_ids) 与 Twitter 用户 ID 匹配。ID 同步过程完成后,定位文件将由合作伙伴创建,并且 Twitter 可通过 HTTPS 端点使用此类文件。Twitter 会定期获取此类定位文件,并且可在 Twitter UI 中使用。

Twitter 安全像素

Twitter 安全像素如下所示:

https://analytics.twitter.com/i/adsct?p_user_id=xyz&p_id=123

p_user_id - xyz 代表由合作伙伴提供的合作伙伴用户 ID

p_id - 123 代表合作伙伴的唯一 ID(由 Twitter 提供)

合作伙伴 HTTPS 端点和定位用户文件

合作伙伴需要向 Twitter 提供可用于定期获取定位文件的 HTTPS 端点和凭据(用户名/密码)。示例 HTTPS 端点如下所示:

https://<partnerdomain>/twitter/partner_targeting_%Y-%M-%D.tsv.gz

%Y - 年份格式代码 (YYYY)

%M - 月份格式代码 (MM)

%D - 日格式代码 (DD)

传输的数据包含以下文件:

  1. 合作伙伴定位用户文件
  2. 定位转化文件

所有文件均采用 TSV 格式,其中每一行的各个字段之间由制表符分隔。有效字段值本身绝不包含制表符。

允许的 Twitter IP 范围:

以下是允许用于访问合作伙伴端点的 IP 范围。

  • 199.16.156.0/22
  • 199.59.148.0/22

合作伙伴定位用户文件:

列数 列名称 列类型 说明
1 partner id string “合作伙伴 ID”是 Twitter 提供给合作伙伴的 ID,用于唯一地标识每位合作伙伴。
2 advertiser id string “advertiser id”是广告商的 @用户名。
3 p_user_id string “p_user_id”是合作伙伴用于标识用户的唯一 ID。
3 confidence score 整数 “confidence score”为可选项。我们建议置信度分数使用 0-100 表示。如果用例用于重新定位,那么置信度分数为“100”即表示已直接重新定位的用户。0-99 之间的任何分数都对应相似用户的置信度等级。
4 segment label string “分段标签”为可选项。例如,合作伙伴可以使用“分段标签”来指定产品类别。我们建议使用该“分段标签”,因为它是 ads.twitter.com UI 中可供人员阅读的自定义受众名称。

注意:

除非另有约定,否则每次我们收到新的合作伙伴定位文件时,我们即认为这是合作伙伴建议我们定位的完整用户列表,而不是增量用户列表。我们会与每位合作伙伴就该合作伙伴定位文件的交付频率达成协议。如果我们没有如期收到合作伙伴定位文件,我们将使用具有预定到期时间的上一个版本。