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

建立「意圖實作」issue，說明您將把分析服務的設定新增至 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，並參考「意圖實作」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 執行階段

標籤管理工具

更多資源