重要提示：此文档不适用于您当前选择的格式网站！

amp-story-auto-ads

描述

动态地将广告插入到 Story 中。

必需的脚本

<script async custom-element="amp-story-auto-ads" src="https://cdn.ampproject.org/v0/amp-story-auto-ads-0.1.js"></script>

动态地将广告插入到 Story 中。

入门

有关如何在 AMP Stories 中包含广告的信息，请参阅我们的指南。

创建 AMP Story 广告的最佳实践

如果您有兴趣为 AMP Story 平台创建广告，请参阅我们的最佳实践指南。

行为

amp-story-auto-ads 扩展程序会在用户使用内容时动态地将广告（实现为 amp-ad）插入到故事中。当前的算法期望至少有一个包含 7 页的故事。

每个 amp-ad 都作为全屏故事页插入。为了防止显示空白/未加载的广告，广告会在后台完全预渲染，然后才对用户可见。该扩展程序会根据用户互动决定何时何地插入广告。

可以通过点击屏幕的右侧，像跳过普通故事页一样跳过故事中的广告。

配置

有两种配置广告的方式：内联和远程

内联广告配置

在 <amp-story-auto-ads> 元素中，您可以指定一个 JSON 配置对象，其中包含有关如何获取和显示广告的详细信息，如下所示

<amp-story>
  <amp-story-auto-ads>
    <script type="application/json">
      {
        "ad-attributes": {
          "type": "doubleclick",
          "data-slot": "/30497360/a4a/amp_story_dfp_example"
        }
      }
    </script>
  </amp-story-auto-ads>
  ...
</amp-story>

ad-attributes 是键值对的映射，它是要插入的 amp-ad 元素的属性。

上面的示例将插入以下 amp-ad 元素，它表示由 doubleclick 提供的广告

<amp-ad type="doubleclick" data-slot="/30497360/a4a/amp_story_dfp_example">
</amp-ad>

与普通的 amp-ad 不同，这里不需要指定 <fallback> 或 <placeholder>，因为故事中的广告只会在完全渲染后才会显示。

远程广告配置

除了在脚本标记中添加 JSON 配置文件（如“内联广告配置”部分所示）之外，还可以使用以下方式托管远程 URL：

远程 JSON 广告配置文件

{
  "ad-attributes": {
    "type": "doubleclick",
    "data-slot": "/30497360/a4a/amp_story_dfp_example"
  }
}

设置好 JSON 配置文件后，只需使用

html 广告配置代码来检索远程 URL

在 <amp-story-auto-ads> 元素中，如下所示

<amp-story standalone supports-landscape>
    <!--
      This is an example of JSON retrieved from a source file.
    -->
    <amp-story-auto-ads src="/examples/amp-story/ads/remote.json" ></amp-story-auto-ads>
    <amp-story-page id="page-1">
    .
    .
    .
</amp-story>

传递其他属性（RTC、定向等）

如果您希望将任何其他数据（例如定向信息）作为属性传递给创建的 <amp-ad> 标记，只需将其他键值对添加到 ad-attributes JSON 对象即可。

一个常见的用例是将定向数据或 RTC 配置传递到底层的 amp-ad 元素。更复杂的配置可能如下所示

<amp-story-auto-ads>
  <script type="application/json">
    {
      "ad-attributes": {
        "type": "doubleclick",
        "data-slot": "/30497360/a4a/amp_story_dfp_example",
        "rtc-config": {
          "urls": ["https://rtcEndpoint.biz/"]
        },
        "json": {
          "targeting": {
            "loc": "usa",
            "animal": "cat"
          },
          "categoryExclusions": ["sports", "food", "fun"]
        }
      }
    }
  </script>
</amp-story-auto-ads>

这将导致创建以下 amp-ad 元素。

<amp-ad
  type="doubleclick"
  data-slot="/30497360/a4a/amp_story_dfp_example"
  rtc-config='{"urls": ["https://rtcEndpoint.biz/"}'
  json='{"targeting":{"loc": "usa", "animal": "cat"}, "categoryExclusions":["sports", "food", "fun"]}'
>
</amp-ad>

验证

amp-story-auto-ads 必须是 amp-story 元素的直接子元素。

插入控制

如果您希望故事中的某个特定位置永远不显示广告，您可以在 <amp-story-page> 中添加 next-page-no-ad 属性。然后，插入算法在尝试插入广告时将跳过此页面之后的广告位。

<amp-story-page next-page-no-ad id="page-7">
  ...
</amp-story-page>

<!-- No ad will ever be inserted here. -->

<amp-story-page next-page-no-ad id="page-8">
  ...
</amp-story-page>

分析

使用 amp-story-auto-ads 时，将有几个新的分析触发器和[变量]可用于您的分析配置。

触发器

名称	事件
`story-ad-request`	已请求广告。
`story-ad-load`	已加载广告。
`story-ad-insert`	已插入广告。
`story-ad-view`	已查看广告。
`story-ad-click`	已点击广告的 CTA 按钮。
`story-ad-exit`	用户停止观看广告。
`story-ad-discard`	由于配置无效而丢弃了广告。

变量

以下变量将大致按顺序提供。然后，这些变量可以用于任何后续的 ping 操作。例如，使用 story-ad-load 触发器的请求将无法访问 viewTime 变量，因为它尚未发生（这将解析为空字符串）。而使用 story-ad-exit 触发器发送的请求将能够获取所有先前事件（requestTime、loadTime、insertTime 等）的值

名称	定义
`adIndex`	生成触发器的广告索引（适用于所有触发器）
`adUniqueId`	每个广告都应该唯一的 ID（适用于所有触发器）
`requestTime`	请求广告时的时间戳
`loadTime`	广告发出 `INI_LOAD` 信号时的时间戳
`insertTime`	广告插入到故事中的时间戳
`viewTime`	广告页面变为活动页面时的时间戳
`clickTime`	点击广告时的时间戳
`exitTime`	广告页面从活动状态变为非活动状态时的时间戳
`discardTime`	由于元数据错误等原因丢弃广告时的时间戳
`position`	在父故事中的位置。广告之前的页面数 + 1。不计算先前插入的广告页面。（在插入时可用）
`ctaType`	给定插入广告的 cta 类型（在插入时可用）

需要更多帮助？

您已经阅读本文档十几次了，但它并没有真正涵盖您的所有问题？也许其他人也有同样的感觉：在 Stack Overflow 上联系他们。

转到 Stack Overflow

发现错误或缺少功能？

AMP 项目强烈鼓励您的参与和贡献！我们希望您能成为我们开源社区的持续参与者，但也欢迎您为自己特别热衷的问题做出一次性的贡献。

转到 GitHub