自定义受众:Web
信息
合作伙伴将代表广告商发送 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)
传输的数据包含以下文件:
- 合作伙伴定位用户文件
- 定位转化文件
所有文件均采用 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 中可供人员阅读的自定义受众名称。 |
注意:
除非另有约定,否则每次我们收到新的合作伙伴定位文件时,我们即认为这是合作伙伴建议我们定位的完整用户列表,而不是增量用户列表。我们会与每位合作伙伴就该合作伙伴定位文件的交付频率达成协议。如果我们没有如期收到合作伙伴定位文件,我们将使用具有预定到期时间的上一个版本。