重要事項：本文件不適用於您目前選取的格式網站！

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 Story 中加入廣告，請參閱我們的指南。

建立 AMP Story 廣告的最佳做法

如果您有興趣為 AMP Story 平台建立廣告，請參閱我們的最佳做法指南。

行為

amp-story-auto-ads 擴充功能會在使用者瀏覽內容時，將廣告 (以 amp-ad 形式實作) 動態插入 Story 中。目前的演算法預期 Story 至少包含 7 頁。

每個 amp-ad 都會以全螢幕 Story 頁面形式插入。為了避免顯示空白/未載入的廣告，廣告會在背景中完整預先轉譯，然後才對使用者顯示。擴充功能會根據使用者互動，判斷何時及何處插入廣告。

在 Story 中，廣告可以像一般 Story 頁面一樣略過，方法是輕觸螢幕右側。

設定

設定廣告的方式有兩種：內嵌和遠端

內嵌廣告設定

在 <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>，因為 Story 中的廣告只會在完整轉譯後才會顯示。

遠端廣告設定

除了在指令碼標記內新增 JSON 設定檔 (如內嵌廣告設定章節所示) 外，您也可以使用下列方式託管遠端網址

遠端 JSON 廣告設定檔

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

設定好 JSON 設定檔後，只需使用

html 廣告設定程式碼即可擷取遠端網址

在 <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 元素的直接子項。

插入控制項

如果 Story 中有您不希望顯示廣告的特定位置，您可以將 next-page-no-ad 屬性新增至 <amp-story-page>。插入演算法接著會在嘗試插入廣告時略過此頁面之後的版位。

<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`	廣告因設定無效而遭捨棄。

變數

下列變數將大約依序提供。變數接著可用於任何後續的連線。例如，使用 story-ad-load 觸發條件的要求將無法存取 viewTime 變數，因為該變數尚未發生 (這會解析為空字串)。而使用 story-ad-exit 觸發條件傳送的要求則能夠取得所有先前事件的值 (requestTime、loadTime、insertTime 等)。

名稱	定義
`adIndex`	產生觸發條件的廣告索引 (適用於所有觸發條件)
`adUniqueId`	每個廣告都應為唯一的 ID (適用於所有觸發條件)
`requestTime`	廣告要求時間戳記
`loadTime`	廣告發出 `INI_LOAD` 信號的時間戳記
`insertTime`	廣告插入 Story 的時間戳記
`viewTime`	廣告頁面變成有效頁面的時間戳記
`clickTime`	廣告點擊時間戳記
`exitTime`	廣告頁面從有效 => 無效的移動時間戳記
`discardTime`	廣告因中繼資料錯誤等原因而捨棄的時間戳記
`position`	在父項 Story 中的位置。廣告之前的頁面數 + 1。不計入先前插入的廣告頁面。(在插入時提供)
`ctaType`	已插入廣告的指定 cta 類型 (在插入時提供)

需要更多協助嗎？

您已閱讀本文件十幾次，但內容仍然無法涵蓋您的所有問題？或許其他人也有相同感受：在 Stack Overflow 上與他們交流。

前往 Stack Overflow

發現錯誤或缺少功能？

AMP 專案大力鼓勵您的參與和貢獻！我們希望您能成為我們開放原始碼社群的長期參與者，但我們也歡迎您針對特別感興趣的問題提供一次性的貢獻。

前往 GitHub