將您的分析工具與 AMP 整合

總覽

如果您經營軟體即服務工具，協助發佈商更瞭解其流量和訪客，您可能會想將您的服務整合到 amp-analytics 中。這將讓您的客戶能夠查看其 AMP HTML 網頁的流量模式。

開始之前

在將您的分析服務新增至 AMP HTML 執行階段之前，您可能需要：

找出您的分析服務在 AMP HTML 文件中需要的變數種類，以及要求。
找出會導致從網頁傳送分析要求 (與您的服務相關) 的觸發條件。
考量您是否以及如何跨第一方和第三方 AMP 環境追蹤使用者。
判斷您的分析資訊主頁如何處理 AMP 流量。
找出 amp-analytics 中任何缺少的功能，並提交要求以新增所需功能。
AMP Analytics 會將其變數傳送至預先設定的端點。如果您還沒有現有的端點，請查看此範例，以概略瞭解如何建構端點。
- 除了 iframe 以外的所有傳輸類型，變數都會以查詢字串參數的形式在 HTTPS 要求中傳送。
- 對於 iframe 傳輸類型，系統會建立 iframe，並透過 window.postMessage 將變數傳送至 iframe。在此情況下，訊息不一定是網址。此選項僅適用於 MRC 認證的供應商。
考量與 amp-analytics 整合可能會如何影響您可能有的任何政策 (尤其是您的隱私權政策) 或協議。

將您的設定新增至 AMP HTML 執行階段

建立Intent-To-Implement 議題，說明您將把您的分析服務設定新增至 AMP HTML 的執行階段。請務必在您的說明中加入 cc @ampproject/wg-components。
開發實作下列項目的修補程式：
1. vendors 資料夾中的新設定 json 檔案 ${vendorName}.json，其中包含超出預設值的任何選項，例如：
  1. 額外預設變數的 "vars": {}。
  2. 您的服務將使用的要求的 "requests": {}。
  3. 如果需要，則為 "optout":。我們目前沒有完善的退出機制，因此請與我們聯絡以協助我們設計一個適合您的機制。
  4. 如果需要，則為 "warningMessage":。在主控台中顯示來自供應商的警告資訊 (例如淘汰或遷移)。
2. 如果您使用 iframe 傳輸，也請在 iframe-transport-vendors.js 中的 ANALYTICS_IFRAME_TRANSPORT_CONFIG 中新增一行，其中包含 "*vendor-name*": "*url*"。
3. examples/analytics-vendors.amp.html 參考中的範例。
4. extensions/amp-analytics/0.1/test/vendor-requests.json 檔案中的測試。
5. 將您的分析服務新增至 extensions/amp-analytics/0.1/analytics-vendors-list.md 檔案中支援的供應商清單。加入類型、說明，以及您使用說明文件的連結。
測試您放入 examples/analytics-vendors.amp.html 的新範例，以確保範例中的命中次數如預期般運作。例如，所需資料已收集並顯示在您的分析資訊主頁中。
提交包含此修補程式的提取要求，並參考 Intent-To-Implement 議題。
更新您服務的使用說明文件，並通知您的客戶。
強烈建議您維護AMP 存放區以外的整合測試。

標籤管理工具

標籤管理服務有兩種與 AMP Analytics 整合的選項：

端點方法：作為 amp-analytics 的額外端點，並在後端進行行銷管理。
設定方法：透過動態產生的 JSON 設定檔 (每個發佈商專屬) 進行標籤管理。

端點方法與前一節詳述的標準方法相同。設定方法包含為 amp-analytics 建立每個發佈商專屬的獨特設定，並包含他們所有相容的分析套件。發佈商會使用類似於以下的語法來加入設定：

<amp-analytics
  config="https://my-awesome-tag-manager.example.com/user-id.json"
></amp-analytics>

若要採用此方法，請查看發佈商與 AMP Analytics 整合的說明文件。

將您的分析工具與 AMP 整合

總覽

開始之前

將您的設定新增至 AMP HTML 執行階段

標籤管理工具

更多資源