Analytics (分析):基本概念
重要事項:本文件不適用於您目前選取的格式 電子郵件!
從這裡開始瞭解 AMP Analytics (分析) 的基本概念。
要使用 amp-pixel 還是 amp-analytics?
AMP 提供兩個元件來滿足您的 Analytics (分析) 和評估需求:amp-pixel
和 amp-analytics
。這兩個選項都會將 Analytics (分析) 資料傳送到定義的端點。
如果您正在尋找像簡單的 追蹤像素 這樣的行為,則 amp-pixel
元件提供基本網頁瀏覽追蹤功能;網頁瀏覽資料會傳送到定義的 URL。與供應商的一些整合可能會要求使用此元件,在這種情況下,他們會指定確切的 URL 端點。
對於大多數 Analytics (分析) 解決方案,請使用 amp-analytics
。amp-analytics
也適用於網頁瀏覽追蹤。但您也可以追蹤使用者與任何網頁內容 (包括連結和按鈕上的點擊) 的互動。
作為與 AMP 平台整合的一部分,供應商已提供預先定義的 amp-analytics
設定,以便輕鬆擷取資料並推送到其追蹤工具。從「Analytics (分析) 供應商」清單存取供應商文件。
您可以在網頁中使用 amp-pixel
和 amp-analytics
:amp-pixel
用於簡單的網頁瀏覽追蹤,而 amp-analytics
用於其他所有項目。您也可以新增多個每個標記。如果您與多個 Analytics (分析) 供應商合作,則每個解決方案都需要一個標記。請記住,更簡單的 AMP 網頁對使用者更好,因此如果您不需要額外的標記,請勿使用它們。
建立簡單的 Analytics (分析) 設定
瞭解如何建立簡單的 amp-pixel
和 amp-analytics
設定。
簡易 amp-pixel
設定
若要建立簡易的 amp-pixel
設定,請將類似以下的內容插入 AMP 網頁的內文
<amp-pixel src="https://foo.com/pixel?RANDOM"></amp-pixel>
在此範例中,網頁瀏覽資料會連同隨機數字一起傳送到定義的 URL。RANDOM
變數是 AMP 平台中的許多替換變數之一。在此處瞭解更多關於 變數替換 的資訊。
amp-pixel
元件是內建的,因此您不需要像對 AMP 的擴充元件 (包括 amp-analytics
) 那樣的包含宣告。但您應將 amp-pixel
標記盡可能靠近 <body>
的開頭放置。追蹤像素只會在標記本身進入檢視畫面時觸發。如果 amp-pixel
位於網頁底部附近,則可能不會觸發。
簡易 amp-analytics
設定
若要建立簡易的 amp-analytics
設定,您必須先在 AMP 文件的 <head>
中包含此 custom-element
宣告 (另請參閱元件包含宣告)
<script async custom-element="amp-analytics" src="https://cdn.ampproject.org/v0/amp-analytics-0.1.js"></script>
以下範例與 amp-pixel
範例 類似。每當網頁可見時,觸發事件就會觸發,並將網頁瀏覽資料連同隨機 ID 一起傳送到定義的 URL
<amp-analytics>
<script type="application/json">
{
"requests": {
"pageview": "https://foo.com/pixel?RANDOM"
},
"triggers": {
"trackPageview": {
"on": "visible",
"request": "pageview"
}
}
}
</script>
</amp-analytics>
在上述範例中,我們已將名為 pageview 的請求定義為 https://foo.com/pixel?RANDOM
。如先前討論,RANDOM 會由隨機數字替換,因此請求實際上會看起來像 https://foo.com/pixel?0.23479283687235653498734
。
當網頁變得可見時 (由觸發關鍵字 visible
指定),事件會觸發並傳送 pageview
請求。triggers 屬性決定何時觸發 pageview 請求。瞭解更多關於請求和觸發器的資訊。
變數替換
amp-pixel
和 amp-analytics
元件都允許所有標準 URL 變數替換 (請參閱 AMP HTML 變數替換)。在以下範例中,網頁瀏覽請求會連同目前 AMP 文件的標準網址、標題和 用戶端 ID 一起傳送到 URL
<amp-pixel src="https://example.com/analytics?url=${canonicalUrl}&title=${title}&clientId=${clientId(site-user-id)}"></amp-pixel>
由於其簡單性,amp-pixel
標記只能包含平台定義的變數,或 AMP 執行階段可以從 AMP 網頁剖析的變數。在上述範例中,平台會填入 canonicalURL
和 clientId(site-user-id)
的值。amp-analytics
標記可以包含與 amp-pixel
相同的變數,以及標記設定內唯一定義的變數。
在頁面或平台定義的變數的請求字串中使用 ${varName}
格式。amp-analytics
標記會在建構 Analytics (分析) 請求時,將範本替換為其實際值 (另請參閱 amp-analytics
中支援的變數。
在以下 amp-analytics
範例中,網頁瀏覽請求會連同從變數替換中擷取的其他資料一起傳送到 URL,其中一些由平台提供,一些在 amp-analytics
設定中內嵌定義
<amp-analytics>
<script type="application/json">
{
"requests": {
"pageview":"https://example.com/analytics?url=${canonicalUrl}&title=${title}&acct=${account}&clientId=${clientId(site-user-id)}"
},
"vars": {
"account":"ABC123"
},
"triggers": {
"someEvent": {
"on": "visible",
"request": "pageview",
"vars": {
"title": "My homepage"
}
}
}
}
</script>
</amp-analytics>
在上述範例中,變數 account
和 title
在 amp-analytics
設定中定義。canonicalUrl
和 clientId
變數未在設定中定義,因此它們的值由平台替換。
使用者識別
網站使用 Cookie 在瀏覽器中儲存特定於使用者的資訊。Cookie 可用於判斷使用者先前是否造訪過網站。在 AMP 中,網頁可以從發布商的網站或快取 (例如 Google AMP 快取) 提供。發布商的網站和快取可能具有不同的網域。基於安全性考量,瀏覽器可以 (而且通常會) 限制存取另一個網域的 Cookie (另請參閱 跨來源追蹤使用者)。
預設情況下,無論網頁是從發布商的原始網站存取,還是透過快取存取,AMP 都會管理用戶端 ID 的佈建。AMP 產生的用戶端 ID 的值為 "amp-"
,後跟隨機 base64
編碼字串,並且對於再次造訪的同一使用者保持不變。
AMP 會管理所有情況下用戶端 ID 的讀取和寫入。當網頁透過快取提供,或以其他方式在發布商原始網站的檢視內容之外顯示時,這一點尤其值得注意。在這種情況下,無法存取發布商網站的 Cookie。
當 AMP 網頁從發布商的網站提供時,AMP 使用的用戶端 ID 架構可以被告知要尋找和使用的回溯 Cookie。在這種情況下,clientId
變數的 cid-scope-cookie-fallback-name
引數會被解釋為 Cookie 名稱。格式可以顯示為 CLIENT_ID(cid-scope-cookie-fallback-name)
或 ${clientId(cid-scope-cookie-fallback-name)}
。
例如
<amp-pixel src="https://foo.com/pixel?cid=CLIENT_ID(site-user-id-cookie-fallback-name)"></amp-pixel>
如果 AMP 發現已設定此 Cookie,則用戶端 ID 替換將傳回 Cookie 的值。如果 AMP 發現未設定此 Cookie,則 AMP 將產生格式為 amp-
的值,後跟隨機 base64 編碼字串。
在 AMP Analytics (分析) 中支援的變數 中瞭解更多關於用戶端 ID 替換的資訊,包括如何新增選用的使用者通知 ID。