Cookie Mapping
一 PC 资源
1. 什么是 Cookie Mapping
Cookie Mapping 是指将腾讯侧用户ID与客户方的用户ID进行映射的过程。对于同一用户,访问不同网站时会各自产生用来标识其身份的ID,存储在各自网站域下的 cookie 中。将同一用户在不同网站域下的ID进行映射后,客户方才可以从腾讯海量用户中识别其标识人群,并参与后续的实时请求。
2. 映射关系存储
为了方便以后可能的多种合作方式,腾讯和客户方双方都存有该映射。目前 Cookie Mapping 的发起方为客户方。
3. tuid 的生命周期
tuid 是根据腾讯用户ID、客户方用户ID等诸多因素重新哈希生成的 ADX 用户ID,用来和客户方用户ID进行 mapping。目前有效期为半年,客户方需要周期性发起 Cookie Mapping。
4. Cookie Mapping 流程
-
用户到达客户方网络时,通过内嵌网站上的 pixel,访问客户方的 Cookie Mapping 服务器。
-
客户方判断该用户是否与腾讯 ADX 在一定时间内做过 Cookie Mapping。
-
如果没有,客户方的 Cookie Mapping 服务器则将该请求重定向到 TCMS(Tencent Cookie Mapping Server),并在重定向的请求参数中加上 dspid(客户ID)、dspuid(客户方用户ID)和 gettuid;客户方也可以加上自定义的扩展参数 ext,即请求被重定向为
http://cm.l.qq.com/?dspid=23&dspuid=xxx&gettuid=1&ext=xxx。 -
TCMS 收到该请求后,保存该用户的 dspuid,并将该请求再次重定向到 DSP 的 Cookie Mapping 服务器;同时在请求参数中加入该用户的 tuid,如果 DSP 在请求中带上了 ext 扩展参数也会一并加入,另外还会添加上版本号 ver,即请求被重定向为
http://cmapping.dspxx.com/?tuid=yyyy&ver=1&ext=xxx。 -
如果请求参数错误,返回如下错误码:
错误码 错误描述 -2 dspid 不存在或者错误 -3 dspuid 不存在或者错误 -
如果获取不到 tuid,则返回的重定向为
cmapping.dspxx.com/cm.gif?tuid=0。 -
客户方收到此请求后,保存该用户的 tuid,并给浏览器返回响应包。至此 Cookie Mapping 完成,ADX 和客户双方都获得该用户的 dspuid 和 tuid。
二 移动端资源
移动端资源无需进行 Cookie Mapping,腾讯可提供基于以下数据的用户识别能力:
| 字段 | 含义 | 是否提供 |
|---|---|---|
| ip | 用户的 IP | 是 |
| ua | user-agent(os 版本 + 设备信息) | 是 |
| os | 设备操作系统,如「ios」 | 是 |
设备ID按照中广协团体标准执行
以上针对 DSP 向腾讯发起的 Cookie Mapping;若需腾讯发起,请参考 Tencent 主动 CookieMapping 沙箱测试手册。