向用户投放受限广告
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
自 2021 年 1 月 14 日起,当用户不同意使用 Cookie、用户拒绝使用 Cookie,或者在 IAB TCFv2 集成的宽限期过后,IMA 在 GDPR 和 ePrivacy 区域未收到有效的 TC 字符串时,IMA HTML5 SDK 会投放受限广告。
对于 DAI SDK,您必须将
ltd
参数,使用
StreamRequest.adTagParameters
,了解所有最新动态。
请查看
受限广告指南(适用于
。
使用 Google 发布商代码 (GPT) 的发布商也需要设置
PrivacySettingsConfig.limitedAds
来停用与 GPT 相关的 Cookie以下代码段展示了如何执行此操作
共
IMA 的随播广告指南:
...
<!-- Register your companion slots -->
<script type='text/javascript'>
googletag.cmd.push(function() {
googletag.pubads().setPrivacySettings({
limitedAds: true,
});
// Supply YOUR_NETWORK and YOUR_UNIT_PATH.
googletag.defineSlot('/YOUR_NETWORK/YOUR_UNIT_PATH', [728, 90], 'companionDiv')
.addService(googletag.companionAds())
.addService(googletag.pubads());
googletag.companionAds().setRefreshUnfilledSlots(true);
googletag.pubads().enableVideoAds();
googletag.enableServices();
});
</script>
...
发布商仍负责播放串流清单。清单网址仍指向 dai.google.com,该网域使用 Cookie,并且可能包含 Cookie。因此,需要对播放器进行配置,以便正确请求清单
withCredentials=false
。
请参阅以下链接,为您的特定播放器进行设置:
您还可以通过集成
意见征求管理平台 (CMP)。以下系统支持此功能:
最新版本的 HTML5 SDK(截至 2021 年 1 月 14 日)。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[[["\u003cp\u003eAs of January 14, 2021, the IMA HTML5 SDK can serve limited ads even when users don't consent to cookies or in GDPR/ePrivacy regions without a valid TC string.\u003c/p\u003e\n"],["\u003cp\u003ePublishers using Google Publisher Tag (GPT) need to configure PrivacySettingsConfig.limitedAds to disable GPT-related cookies for limited ads functionality.\u003c/p\u003e\n"],["\u003cp\u003eWhen using limited ads, ensure the player is configured to request the stream manifest with \u003ccode\u003ewithCredentials=false\u003c/code\u003e due to potential cookies from dai.google.com.\u003c/p\u003e\n"],["\u003cp\u003eLimited ads can be automatically enabled through integration with a Consent Management Platform (CMP) using the latest HTML5 SDK version.\u003c/p\u003e\n"]]],[],null,["# Serve users with Limited Ads\n\nAs of January 14th 2021, the IMA HTML5 SDK\nallows [limited ads](//support.google.com/admanager/answer/9882911) to be served\nwhen the user does not give consent to cookies, the user denies consent to\ncookies, or when IMA does not receive a valid TC string in GDPR and ePrivacy\nregions following the grace period of IAB TCFv2 integration.\nFor DAI SDKs you must set the [`ltd`](//support.google.com/admanager/answer/7320899#ltd) parameter using [`StreamRequest.adTagParameters`](/interactive-media-ads/docs/sdks/html5/dai/reference/js/StreamRequest#adTagParameters) . Please see this [Limited ads guide](//support.google.com/admanager/answer/9882911) for more information.\n\n\u003cbr /\u003e\n\nPublishers using Google Publisher Tag (GPT) will need to also set [PrivacySettingsConfig.limitedAds](/publisher-tag/reference#boolean-limitedads) to disable GPT-related cookies. The following code snippet shows how to do this based on [IMA's companion ads guide](/interactive-media-ads/docs/sdks/html5/client-side/companions):\n\n\u003cbr /\u003e\n\n```carbon\n...\n\n\u003c!-- Register your companion slots --\u003e\n\u003cscript type='text/javascript'\u003e\n googletag.cmd.push(function() {\n googletag.pubads().setPrivacySettings({\n limitedAds: true,\n });\n // Supply YOUR_NETWORK and YOUR_UNIT_PATH.\n googletag.defineSlot('/YOUR_NETWORK/YOUR_UNIT_PATH', [728, 90], 'companionDiv')\n .addService(googletag.companionAds())\n .addService(googletag.pubads());\n googletag.companionAds().setRefreshUnfilledSlots(true);\n googletag.pubads().enableVideoAds();\n googletag.enableServices();\n });\n\u003c/script\u003e\n\n...\n```\nPublishers are still responsible for playback of the stream manifest. The manifest URL continues to point to dai.google.com which is a cookied domain and may carry cookies. Because of this, the player needs to be configured to correctly request the manifest `withCredentials=false`.\n\n\u003cbr /\u003e\n\nPlease see the following links to set this for your specific player:\n\n- [hls.js](//github.com/video-dev/hls.js/blob/master/docs/API.md#xhrsetup)\n- [JW Player](//developer.jwplayer.com/jwplayer/docs/jw8-player-configuration-reference#section-advertising) (scroll for `withCredentials` property)\n- [Shaka Player](//github.com/google/shaka-player/blob/master/docs/tutorials/ad_monetization.md#disabling-cookies-for-serving-limited-ads)\n\nIt is also possible to enable limited ads automatically through integrating with\na Consent Management Platform (CMP). This is supported on\n\nthe latest version of the HTML5 SDK as of January 14th 2021."]]