AdSense 游戏广告 (AFG)

技术快速入门指南(AdSense 游戏广告)

为使用 Google IMA HTML5 SDK 投放 HTML5 网页游戏广告的工程师编写的 AdSense 游戏广告使用入门指南。

简介

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,请继续阅读下面的内容。

开始使用 IMA HTML5 SDK 高级集成

要开始使用高级集成方式,您需要将 IMA HTML5 SDK 集成到游戏中。

  1. 设置 IMA HTML5 SDK 集成

    按照 Google 开发者网站上的指南,将 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 参考中提供了可能的错误列表。

该内容对您有帮助吗?
您有什么改进建议?

需要更多帮助?

登录可获取更多支持选项,以便快速解决您的问题