通知

请务必访问您的 AdSense 页面,获取根据您的帐号为您量身定制的信息,进而利用 AdSense 取得出色的创收效果。

技术快速入门指南 (AFG)

善用本指南,了解如何与 Google IMA HTML5 SDK 集成,从而通过 AdSense 在 HTML5 网页游戏中投放广告。

技术设置概览

AdSense 游戏广告在运作时使用 Google 互动式媒体广告软件开发套件 (IMA HTML5 SDK)。借助此 SDK,您可以通过 JavaScript 来请求 AdSense 广告,从而将内容与广告更紧密地结合在一起。

注意:这些产品受以下规定约束:AdSense 条款及条件AdSense 合作规范针对具体产品的使用指南。请注意,因过于积极的实施或错误实施而导致意外点击次数增加会受到惩罚,最严重时可导致帐号被停用。

要通过 IMA HTML5 SDK 请求和呈现广告,请设置广告请求、加载获得的广告,然后在适当的时间播放。您可以使用默认发行商 ID“ca-games-pub-4968145218643279”测试集成。

请注意,您必须先将您的集成示例提供给客户经理,然后才可以在您的网站上部署广告。

集成选项有两个:简单集成高级集成

简单集成

要想将 AdSense 游戏广告与 HTML5 游戏进行集成,最简便的方法就是使用简单集成选项。此选项提供了一种快速实施解决方案,具备 AdSense 游戏广告中适用的所有功能和广告格式。

对于希望使用这个简单集成选项的发行商,则可以登记意向

高级集成

对于寻求更高级和自定义集成的发行商,应对 HTML5 游戏实施完整的 IMA HTML5 SDK。此选项提供了额外的灵活性(例如通过 Google Ad Manager 提供的部分功能),但同时请注意,此选项也会带来额外的复杂性。

开始使用高级集成

首先,将 IMA HTML5 SDK 集成到您的游戏中。

  1. 设置 IMA HTML5 SDK 集成

    按照 Google Developers 网站上的指南,将 IMA HTML5 SDK 集成到您的游戏中。如需获取相关帮助,请参阅入门步骤可下载的示例代码以及完整的 API 参考文档

  2. 设置广告容器 (AdDisplayContainer)

    IMA HTML5 SDK 对视频和游戏发行商均适用,因此 AdDisplayContainer 对象可以通过多种方式进行配置。

    配置 AdDisplayContainer 对象以用于 AdSense 游戏广告时,只需将参考传入包含该广告的 div 即可。

    示例:

    var adDisplayContainer = new google.ima.AdDisplayContainer(document.getElementById('adContainer'));

  3. 配置广告请求 (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};

  4. 监听相关事件并创建回调

    请务必监听 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 参考文档

该内容对您有帮助吗?

您有什么改进建议?
true
您的 AdSense 页面

全新推出 AdSense 页面:在这项新资源里,您可找到为您量身提供的信息和发掘帐号中的新机会,从而帮助您利用 AdSense 取得出色的创收效果。

搜索
清除搜索内容
关闭搜索框
主菜单
9818498064995411017
true
搜索支持中心
true
true
true
true
true
157
false
false