如何在Google AdManager设置'returned_user'键值跟踪回访用户?
实现方案与合规说明
一、技术实现步骤
1. Cookie 存储访问状态
先写前端JS代码判断并存储用户的首次访问状态:
- 检查是否存在
returned_userCookie - 不存在则说明是30天内首次访问,设置Cookie值为
false,有效期设为30天 - 存在则更新Cookie有效期(避免过期),并将值设为
true
示例代码:
// 获取Cookie function getCookie(name) { const value = `; ${document.cookie}`; const parts = value.split(`; ${name}=`); if (parts.length === 2) return parts.pop().split(';').shift(); } // 设置Cookie function setCookie(name, value, days) { let expires = ""; if (days) { const date = new Date(); date.setTime(date.getTime() + (days*24*60*60*1000)); expires = "; expires=" + date.toUTCString(); } document.cookie = `${name}=${value || ""}${expires}; path=/; SameSite=Lax`; } // 初始化用户状态 let returnedUser = getCookie('returned_user'); if (!returnedUser) { // 首次访问 setCookie('returned_user', 'false', 30); returnedUser = 'false'; } else { // 回访用户,更新状态和有效期 setCookie('returned_user', 'true', 30); returnedUser = 'true'; }
2. 传递状态到Google Ad Manager
把returned_user作为自定义键值对传给Ad Manager,有两种常用方式:
- 全局变量+GPT标签传递
在加载GPT代码前定义全局变量,然后在广告请求中添加自定义目标:
// 全局存储用户状态 window.returnedUserStatus = returnedUser === 'true'; // 初始化GPT时添加定向参数 googletag.cmd.push(function() { const adUnit = googletag.defineSlot('/123456789/your_ad_unit', [728, 90], 'div-gpt-ad-123456789-0') .addService(googletag.pubads()); // 添加自定义键值对 googletag.pubads().setTargeting('returned_user', window.returnedUserStatus.toString()); googletag.pubads().enableSingleRequest(); googletag.enableServices(); });
- 直接在广告槽设置
如果是动态加载广告,创建槽时直接传入定向参数:
googletag.cmd.push(function() { const adSlot = googletag.defineSlot('/123456789/your_ad_unit', [300, 250], 'div-gpt-ad-123456789-1') .setTargeting('returned_user', returnedUser) .addService(googletag.pubads()); googletag.display('div-gpt-ad-123456789-1'); });
二、合规性说明
- Ad Manager 政策合规:这种基于首次访问的Cookie标记完全符合Ad Manager条款,只要满足:
- 遵守GDPR、CCPA等隐私法规,必须在网站上明确告知用户Cookie用途,并提供同意选项
returned_user仅标记访问状态,不属于敏感个人信息,符合要求
- Cookie 合规要求:
- 设置Cookie时必须指定
SameSite属性(示例用SameSite=Lax),避免跨域风险 - 有效期控制在必要范围内(30天符合你的需求)
- 设置Cookie时必须指定
三、官方操作指引
- Ad Manager后台配置:在「库存」>「自定义目标」中创建
returned_user键,允许值设为true和false,之后就能在广告投放中用这个定向条件 - GPT API参考:官方文档中
setTargeting方法的说明,用于向广告请求添加自定义键值对 - Google 隐私规范:确保Cookie使用符合Google广告隐私要求
内容的提问来源于stack exchange,提问作者Roman Oleksiii
相关产品推荐
相关产品推荐

