加入 Analytics 工作階段

在 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>

搭配現有的 Analytics 供應商使用 AMP Linker

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

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

搭配自訂 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>

搭配多個 Linker 使用 AMP Linker

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

<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