善用本指南,了解如何与 Google IMA HTML5 SDK 集成,从而通过 AdSense 在 HTML5 网页游戏中投放广告。
技术设置概览
AdSense 游戏广告在运作时使用 Google 互动式媒体广告软件开发套件 (IMA HTML5 SDK)。借助此 SDK,您可以通过 JavaScript 来请求 AdSense 广告,从而将内容与广告更紧密地结合在一起。
要通过 IMA HTML5 SDK 请求和呈现广告,请设置广告请求、加载获得的广告,然后在适当的时间播放。您可以使用默认发行商 ID“ca-games-pub-4968145218643279
”测试集成。
请注意,您必须先将您的集成示例提供给客户经理,然后才可以在您的网站上部署广告。
简单集成
要想将 AdSense 游戏广告与 HTML5 游戏进行集成,最简便的方法就是使用简单集成选项。此选项提供了一种快速实施解决方案,具备 AdSense 游戏广告中适用的所有功能和广告格式。
对于希望使用这个简单集成选项的发行商,则可以登记意向。
高级集成
对于寻求更高级和自定义集成的发行商,应对 HTML5 游戏实施完整的 IMA HTML5 SDK。此选项提供了额外的灵活性(例如通过 Google Ad Manager 提供的部分功能),但同时请注意,此选项也会带来额外的复杂性。
开始使用高级集成
首先,将 IMA HTML5 SDK 集成到您的游戏中。
- 设置 IMA HTML5 SDK 集成
按照 Google Developers 网站上的指南,将 IMA HTML5 SDK 集成到您的游戏中。如需获取相关帮助,请参阅入门步骤、可下载的示例代码以及完整的 API 参考文档。
- 设置广告容器 (
AdDisplayContainer)
IMA HTML5 SDK 对视频和游戏发行商均适用,因此
AdDisplayContainer
对象可以通过多种方式进行配置。配置
AdDisplayContainer
对象以用于 AdSense 游戏广告时,只需将参考传入包含该广告的 div 即可。示例:
var adDisplayContainer = new google.ima.AdDisplayContainer(document.getElementById('adContainer'));
- 配置广告请求 (
AdsRequest
)创建
AdsRequest
对象时,您必须确保正确配置相关参数和属性,以便正确返回和呈现广告。示例:
// 请求 AdSense 游戏广告。
var adsRequest = new google.ima.AdsRequest();
// 设置 AdSense 游戏广告代码
adsRequest.adTagUrl = 'https://googleads.g.doubleclick.net/pagead/ads?ad_type=video_image_text&client=ca-games-pub-4968145218643279&videoad_start_delay=0&description_url=http%3A%2F%2Fwww.google.com&max_ad_duration=20000&adtest=on';
// 强制使图片/文字广告以全幅界面呈现
adsRequest.forceNonLinearFullSlot = true;
// 指定线性和非线性广告位尺寸。
adsRequest.linearAdSlotWidth = {your_game_width};
adsRequest.linearAdSlotHeight = {your_game_height};
adsRequest.nonLinearAdSlotWidth = {your_game_width};
adsRequest.nonLinearAdSlotHeight = {your_game_height}; - 监听相关事件并创建回调
请务必监听 IMA SDK 中触发的事件,这样您就可以知道应何时停止展示广告,并让用户能够继续玩游戏。
下面列出了一些通常用于确定广告展示位置与游戏内容的广告事件。例如,您可以监听
COMPLETE
事件,以了解广告何时播放完毕,然后可以向用户展示您的游戏内容。如需查看广告事件的完整列表,请参阅 API 参考文档。事件名称 说明 AdEvent.Type.CLICK
在用户点击广告时触发。 AdEvent.Type.COMPLETE
在广告播放完毕时触发。 AdEvent.Type.LOADED
在有广告数据时触发。 AdEvent.Type.SKIPPED
在用户跳过广告时触发。 AdEvent.Type.START
在广告开始播放时触发。 AdEvent.Type.USER_CLOSE
在用户关闭广告时触发。 AdErrorEvent.Type.AD_ERROR
在发生广告错误事件时触发。
可能会出现许多不同类型的广告错误。示例包括无法加载广告媒体资源或广告请求返回空广告响应。如需查看可能的错误的列表,请参阅 API 参考文档。