將您的分析工具與 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 issue，說明您將把您的分析服務設定新增至 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 中的新範例，以確保範例中的點擊次數如預期般運作。例如，所需的資料正在收集並顯示在您的分析儀表板中。
提交包含此修補程式的 Pull Request，並參考 Intent-To-Implement issue。
更新您服務的使用方式文件，並通知您的客戶。
強烈建議維護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 執行階段

標籤管理器

更多資源