跳到主要内容

Google广告方法

ins配置​

Google AdSense <ins class="adsbygoogle"> 常用配置属性

属性名说明可选值/示例作用/备注
data-ad-client广告客户ID(必填)ca-pub-xxxxxxxxxxxxxxxx你的 AdSense 账号的唯一标识
data-ad-slot广告位ID(必填)1234567890你在 AdSense 后台创建的广告单元ID
data-ad-format广告格式auto, link, rectangle, vertical, horizontal, fluidauto(自适应),fluid(流式),rectangle(矩形),vertical(竖向),horizontal(横向)等
data-ad-layout广告布局(仅对 in-article、in-feed 有效)in-article, in-feed, image-top, text-only, etc.控制广告内容和样式布局
data-ad-layout-key广告布局密钥(高级自定义布局)-fg+5n+6t-e7用于指定自定义布局,通常由 AdSense 平台生成
data-ad-test测试广告on设置为 on 时只展示测试广告,不会产生收益
data-ad-region区域标识page-xxxxxxx用于页面上多个广告单元的分区标识,便于实验和优化
data-ad-full-width-responsive是否全宽自适应(流式广告专用)true, falsetrue:广告宽度自适应父容器宽度
data-ad-responsive是否响应式广告(已废弃,推荐用 data-ad-format="auto")true, false旧属性,建议用 data-ad-format="auto" 替代
data-page-url指定广告请求的页面URLhttps://example.com/article/1用于单页应用或动态页面,指定广告请求的页面地址
data-analytics-uacctGoogle Analytics 账号IDUA-XXXXXX-X用于广告与 Google Analytics 集成
data-analytics-domain-nameGoogle Analytics 域名example.com用于广告与 Google Analytics 集成
style行内样式{ display: 'block', width: '100%' }控制广告容器的显示方式和尺寸

广告相关问题​

  • 广告加载失败问题
    • 广告不在可视区域内,加载广告可能会失败
  • 广告刷新问题
  • 广告失败重试问题
  • 广告重试次数
  • 广告进入可视区域,刷新广告
  • 广告尺寸问题:自适应广告、固定广告
    • 如果自适应广告加载不出来,可以尝试固定广告
  • 控制广告跳转链接
    • 无法控制广告跳转行为(新标签 or 当前标签页)
    • 广告点击后的行为由 Google 自动控制,开发者无法干预跳转链接是否在新标签页打开。
    • 否则可能会导致广告违规、广告不展示,甚至账户封禁。

统一广告组件​

  • 插屏广告支持:全屏显示广告

    • 最小显示时间:确保广告显示足够时间
    • 自动关闭按钮:达到最小时间后才能关闭
  • 事件监听:监听广告加载、关闭、点击、错误等事件

  • 错误处理:广告加载失败时,进行广告重试

  • 状态管理:完整的广告生命周期管理

  • 监听广告状态,data-ad-status判断广告状态是否填充

    • data-ad-status="filled" => 广告已返回到广告单元,现在正在展示

    • data-ad-status="unfilled" => 未返回任何广告,并且广告单元为空

    • 当广告单元为unfilled,表示广告未填充,可进行隐藏,避免出现空白