Implementera med AMP
AMP är ett ramverk med öppen källkod och HTML som ger ett enkelt sätt att skapa snabba och mjuka webbsidor.
Eftersom Adobe Analytics använder ett JavaScript-bibliotek för att kompilera och skicka en bildbegäran krävs justeringar i implementeringen för att skicka data till Adobe på sidor med AMP.
Bestäm vilken metod som ska användas för att implementera Adobe Analytics på sidor med AMP
Adobe har skapat två metoder för att implementera Adobe Analytics på sidor med AMP. Båda använder taggen <amp-analytics> HTML. Mer information finns i amp-analytics i dokumentationen för AMP.
- Använd mallen
"adobeanalytics": Konstruera Analytics-begäran direkt på sidan - Använd mallen
"analytics_nativeConfig": Använd en iframe som innehåller samma AppMeasurement som du distribuerar på din normala plats
I följande tabell jämförs dessa två metoder:
"adobeanalytics"mall"adobeanalytics_nativeConfig"mallVäg in proffsen och ikonerna så att du kan välja den bästa implementeringsmetoden för din organisation.
"adobeanalytics" och "adobeanalytics_nativeConfig" på samma sida med AMP. Om du försöker göra det kan du generera fel i webbläsarkonsolen och dubbelräkna besökare.Metod 1: Använd taggen <amp-analytics> med mallen "adobeanalytics"
Spårningsmallen "adobeanalytics" använder taggen <amp-analytics> HTML för att skapa en spårningsbegäran direkt. Du kan ange träffförfrågningar som startar vid specifika sidhändelser, som att sidan blir synlig eller vid ett klick. Klickhändelser kan anpassas för att tillämpas på vissa element-ID:n eller klasser genom att du anger en väljare. Du kan läsa in mallen genom att lägga till type="adobeanalytics" i taggen amp-analytics.
I följande kodexempel har två utlösare definierats: pageLoad och click. Utlösaren pageLoad aktiveras när dokumentet blir synligt och innehåller variabeln pageName som definieras i avsnittet vars. Den andra utlösaren click utlöses när någon klickar på en knapp. Variabeln eVar1 har angetts för den här händelsen med värdet button clicked.
<amp-analytics type="adobeanalytics">
<script type="application/json">
{
"requests": {
"myClick": "${click}&v1=${eVar1}",
},
"vars": {
"host": "example.data.adobedc.net",
"reportSuites": "reportSuiteID1,reportSuiteID2",
"pageName": "Adobe Analytics Using amp-analytics tag"
},
"triggers": {
"pageLoad": {
"on": "visible",
"request": "pageview"
},
"click": {
"on": "click",
"selector": "button",
"request": "myClick",
"vars": {
"eVar1": "button clicked"
}
}
}
}
</script>
</amp-analytics>
Taggen <amp-analytics> har stöd för variabelersättningar så att AMP kan tillhandahålla datavärden som den känner till. Mer information finns i variabler som stöds i amp-analytics på GitHub.
Adobe identifierar besökare med en inbyggd AMP-funktion och ställer in cookien adobe_amp_id. Detta besökar-ID är unikt för alla andra ID:n som angetts av Adobe Analytics. En unik besökare räknas för varje CDN som en besökare hämtar innehåll från, vilket kan generera ett unikt besökarantal. Vi rekommenderar att du använder en separat rapportserie för AMP-sidor eftersom AMP identifierar unika besökare. Adobe Experience Cloud ID-tjänsten stöds inte.
Den här lösningen kräver att den spårningsserver som du anger i egenskapen host matchar spårningsservern på huvudplatsen, så att de befintliga sekretesspolicykontrollerna respekteras. I annat fall skapar du en separat integritetspolicy för sidor med AMP.
Metod 2: Använd taggen <amp-analytics> med mallen "adobeanalytics_nativeConfig"
Taggen "adobeanalytics_nativeConfig" är enklare att implementera eftersom den använder samma taggningsmetod som du använder på dina vanliga webbsidor. Lägg till följande i taggen amp-analytics:
<amp-analytics type="adobeanalytics_nativeConfig">
<script type="application/json">
{
"requests": {
"base": "https://${host}",
"iframeMessage": "${base}/stats.html?campaign=${queryParam(campaign)}&pageURL=${ampdocUrl}&ref=${documentReferrer}"
},
"vars": {
"host": "example.data.adobedc.net"
},
"extraUrlParams": {
"pageName": "Example AMP page",
"v1": "eVar1 example value"
}
}
</script>
</amp-analytics>
En HTML-sida på webbservrarna krävs också:
<html>
<head>
<title>Stats Example</title>
<script language="JavaScript" type="text/javascript" src="VisitorAPI.js"></script>
<script language="JavaScript" type="text/javascript" src="AppMeasurement.js"></script>
</head>
<body>
<script>
var v_orgId = "INSERT-ORG-ID-HERE";
var s_account = "examplersid1,examplersid2";
var s_trackingServer = "example.data.adobedc.net";
var visitor = Visitor.getInstance(v_orgId);
visitor.trackingServer = s_trackingServer;
var s = s_gi(s_account);
s.account = s_account;
s.trackingServer = s_trackingServer;
s.visitorNamespace = s_visitorNamespace;
s.visitor = visitor;
s.pageName = s.Util.getQueryParam("pageName");
s.eVar1 = s.Util.getQueryParam("v1");
s.campaign = s.Util.getQueryParam("campaign");
s.pageURL = s.Util.getQueryParam("pageURL");
s.referrer = s.Util.getQueryParam("ref");
s.t();
</script>
</body>
</html>
Den här metoden skickar data till en verktygswebbsida via frågesträngsparametrar som har lagts till i parametern iframeMessage request. Dessa frågesträngsparametrar kan namnges precis som du vill, förutsatt att din stats.html-sida har konfigurerats för att samla in data från dem.
Mallen "adobeanalytics_nativeConfig" lägger också till frågesträngsparametrar baserade på variablerna som listas i avsnittet extraUrlParams i taggen <amp-analytics>. I ovanstående exempel inkluderas parametrarna pageName och v1.
stats.html-sida måste finnas på en separat underdomän från den domän som AMP-filen finns på. AMP-ramverket tillåter inte iframes från samma underdomän som själva AMP-sidan finns på. Om din AMP till exempel finns på amp.example.com kan du vara värd för din stats.html-sida på en separat underdomän som ampmetrics.example.com.Om en användare väljer den här metoden och inte vill följa spårningen på din primära plats, avanmäls de också från spårning på alla AMP:er. Att använda den här verktygssidan innebär också att AMP kan stödja Adobe Experience Cloud ID-tjänsten. Det krävs ingen separat rapportserie.
Länkspårning och videospårning kan inte användas med den här metoden. Taggen iframeMessage i AMP kan bara läsas in en gång per sida, så du kan inte skicka några andra bildbegäranden när bildrutan har lästs in. Den här metoden kräver också fler bearbetningsresurser som kan påverka rullningsprestanda. Den här metoden påverkar inte sidinläsningstiden eftersom alla resurser läses in asynkront.
Vanliga frågor och svar
Hur kan jag skilja AMP-besökare från andra i mina data?
För alla AMP-sidor samlar dimensionen JavaScript Version in ett värde som liknar AMP vX.X. Du kan också ställa in en anpassad dimension på AMP så att du kan segmentera dessa besökare.
Hur skiljer sig den här implementeringsmetoden från Facebook Instant Articles?
Facebook Instant Articles har stöd för en liknande lösning som metoden "adobeanalytics_nativeConfig". Sidan stats.html för den här metoden kan uppfylla dina analysbehov för både AMP och FIA samtidigt. Mer information om hur du implementerar spårning på FIA finns i Facebook Instant Articles.