將您的分析工具與 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 執行階段

建立一個「有意實作」議題，說明您將把分析服務的設定新增至 AMP HTML 的執行階段。請務必在您的說明中加入 cc @ampproject/wg-components。
開發一個修補程式，以實作下列項目
1. 供應商資料夾中的新設定 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，並參考「有意實作」議題。
更新您服務的使用說明文件，並通知您的客戶。
強烈建議您在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 執行階段

標籤管理器

更多資源