加入分析工作階段

在 playground 中開啟

簡介

Linker 是 amp-analytics 的一項功能，可將使用者工作階段從 AMP 快取網域加入發布者原始網域。如需完整文件，請參閱元件的參考資料。

如果您想深入瞭解 AMP 中的用戶端 ID，可以在這裡找到簡要摘要，以及關於 Google Analytics 的特定資訊，請參閱這裡。

若要查看整個流程的實際運作情況，請點擊此連結。

設定

在標頭中匯入 amp-analytics 元件。

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

將 AMP Linker 與您現有的分析供應商搭配使用

如果您的分析供應商已支援 Linker 功能，則只需進行簡單的設定變更即可開啟它。將以下內容新增至您現有的 amp-analytics 設定。

<amp-analytics type="googleanalytics">
  <script type="application/json">
    {
      "linkers": {
        "enabled": true
      }
    }
  </script>
</amp-analytics>

將 AMP Linker 與自訂分析搭配使用

如果您希望設定自己的組態，AMP linker 也支援。在以下範例中，名稱為 `linker1` 的 linker 參數將附加到外寄連結。此參數的值將包含 `ids` 組態物件中的任何鍵值組。具體來說，在此範例中，將傳遞兩個項目。一個鍵值組，其鍵為 `_a`，值為 `CLIENT_ID` 巨集傳回的值，另一個鍵為 `v`，值為 `123`。您可以根據需要，在 `ids` 物件中包含任意數量的項目。

<amp-analytics>
    <script type="application/json">
      {
        ... // existing amp-analytics configuration
        "linkers" : {
          "linker1": {
            "ids": {
              "_a": "CLIENT_ID(_a)",
              "v": 123
            },
            "enabled": true
          }
        }
      }
    </script>
</amp-analytics>

將 AMP Linker 與多個 linkers 搭配使用

您也可能想要在一個頁面上設定多個 linkers。若要執行此操作，您需要為每個 linker 在 `linkers` 物件中新增一個項目。您也可以將 `enabled: true` 項目移至 `linkers` 物件下方一層，一次啟用所有 linkers。

<amp-analytics>
    <script type="application/json">
      {
        "linkers" : {
          "enabled": true,
          "linker1": {
            "ids": {
              "_a": "CLIENT_ID(_a)",
            }
          },
          "linker2": {
            "ids": {
              "b": "CLIENT_ID(b)",
            }
          }
        }
      }
    </script>
</amp-analytics>

目標網域

每個 linker 也會接受選用的 `destinationDomains` 項目。您可以使用此項目僅將 linker 參數新增至特定目標。如果省略此項目，則預設為來源網域以及標準網域。在以下範例中，僅會修飾指向 `example.com` 和 `ampproject.org` 網域的連結。這些必須以網域陣列的形式包含在內。

<amp-analytics>
    <script type="application/json">
      {
        "linkers" : {
          "enabled": true,
          "destinationDomains": ['example.com'],
          "linker1": {
            "ids": {
              "_foo": "CLIENT_ID(_foo)"
            }
          }
      }
    </script>
</amp-analytics>

需要進一步說明嗎？

如果此頁面上的說明未涵蓋您的所有問題，請隨時與其他 AMP 使用者聯繫，討論您的確切使用案例。

前往 Stack Overflow

未說明的特色功能？

AMP 專案強烈鼓勵您的參與和貢獻！我們希望您能成為我們開放原始碼社群的長期參與者，但我們也歡迎您針對您特別熱衷的問題做出一次性貢獻。

在 GitHub 上編輯範例

作者： @lannka