Lägg till Adobe Analytics
I den här lektionen implementerar du Adobe Analytics-tillägget och skapar regler för att skicka data till Adobe Analytics.
Adobe Analytics är en branschledande lösning som gör att du kan förstå dina kunder som människor och styra din verksamhet med kundanalys.
- Platforma launchen (klientsidan) är nu tags
- Platforma launchens serversida är nu event forwarding
- Edge-konfigurationer är nu datastreams
Utbildningsmål
När lektionen är klar kan du:
- Lägg till Adobe Analytics-tillägget
- Ange globala variabler med tillägget
- Lägg till sidvyfyren
- Lägga till ytterligare variabler med regler
- Lägg till klickningsspårning och andra händelsebaserade fyrar
- Lägg till Analytics-plugin-program
Det finns mycket som kan implementeras för Analytics i taggar. Den här lektionen är inte heltäckande, men bör ge en god översikt över de viktigaste tekniker du behöver för att implementera på din egen webbplats.
Förhandskrav
Du bör redan ha slutfört lektionerna i Konfigurera taggar och Lägg till identitetstjänsten.
Dessutom behöver du minst ett ID för rapportsviten och en spårningsserver. Om du inte har någon test-/dev-rapportsserie som du kan använda för den här självstudiekursen skapar du en. Om du är osäker på hur du gör det läser du dokumentationen. Du kan hämta spårningsservern från din nuvarande implementering, Adobe Consultant eller Customer Care-representant.
Lägg till analystillägget
Tillägget Analytics består av två huvuddelar:
-
Tilläggskonfigurationen, som hanterar huvudbiblioteksinställningarna för AppMeasurement.js och kan ange globala variabler
-
Regelåtgärder för att göra följande:
- Ange variabler
- Rensa variabler
- Skicka Analytics Beacon
Lägga till Analytics-tillägget
-
Gå till Extensions > Catalog
-
Hitta Adobe Analytics-tillägget
-
Klicka på Install
-
Under Library Management > Report Suites anger du de ID:n för rapportsviten som du vill använda för varje taggmiljö. Om dina användare har tillgång till Adobe Analytics bör du tänka på att när du börjar skriva i rutan visas en ifylld lista med alla dina rapportsviter. (Det går bra att använda en rapportserie för alla miljöer i den här självstudiekursen, men i verkligheten vill du använda separata rapportsviter, vilket visas i bilden nedan)
note tip TIP Vi rekommenderar att du använder inställningen Manage the library for me option som Library Management eftersom det gör det mycket enklare att hålla AppMeasurement.js
-biblioteket uppdaterat. -
Under General > Tracking Server anger du spårningsservern, t.ex.
tmd.sc.omtrdc.net
. Ange din SSL-spårningsserver om din webbplats stöderhttps://
-
I Global Variables section, under Additional Settings, anger du variabeln Page Name med ditt
Page Name
-dataelement. Klicka på ikonen för att öppna det modala och välj dataelementet för sidanPage Name
.) -
Klicka på Save to Library
Skicka sidvyfyren
Nu ska du skapa en regel för att utlösa Analytics-beacon, som skickar variabeluppsättningen Page Name i tilläggskonfigurationen.
Du har redan skapat regeln"Alla sidor - Biblioteksinläsning" i Lägg till ett dataelement, en regel och en bibliotekslektion i den här självstudiekursen, som aktiveras på varje sida när taggbiblioteket läses in. Du kan använda den här regeln även för Analytics, men den här inställningen kräver att alla datalagerattribut som används i Analytics-fyren definieras före taggens inbäddningskoder. Om du vill ha större flexibilitet i datainsamlingen skapar du en ny regel som utlöses av DOM Ready to fire the Analytics Beacon.
Så här skickar du sidvyknappen
-
Gå till avsnittet Rules i den vänstra navigeringen och klicka sedan på Add Rule
-
Namnge regeln
All Pages - DOM Ready
-
Klicka på Events > Add för att öppna skärmen
Event Configuration
-
Välj Event Type > DOM Ready (Observera att ordningen för regeln är "50")
-
Klicka på Keep Changes
-
Klicka på plustecknet
-
Välj Extension > Adobe Analytics
-
Välj Action Type > Send Beacon
-
Lämna Spårningsuppsättningen på
s.t()
. Observera att om du vill ringa etts.tl()
-samtal i en klickhändelseregel kan du göra det med åtgärden Skicka Beacon. -
Klicka på knappen Keep Changes
-
Klicka på Save to Library and Build
Validera sidvisningsfunktionen
Nu när du har skapat en regel för att skicka en Analytics-fyr bör du kunna se begäran i Experience Cloud Debugger.
-
Öppna Luma-webbplatsen i din Chrome-webbläsare
-
Klicka på felsökningsikonen för att öppna Adobe Experience Cloud Debugger
-
Kontrollera att felsökaren mappar taggegenskapen till din-utvecklingsmiljö, vilket beskrivs i tidigare lektion
-
Klicka för att öppna fliken Analytics
-
Expandera namnet på din Report Suite om du vill visa alla förfrågningar som gjorts till den
-
Bekräfta att begäran har utlösts med variabeln och värdet för sidnamn
Lägg till variabler med regler
När du konfigurerade analystillägget fyllde du i variabeln pageName
i tilläggskonfigurationen. Det här är en fin plats att fylla i andra globala variabler som eVars och props, förutsatt att värdet är tillgängligt på sidan innan taggens inbäddningskod läses in.
En flexiblare plats att ange variabler, samt händelser, finns i regler med åtgärden Set Variables
. Med regler kan du ange olika Analytics-variabler och -händelser under olika förhållanden. Du kan till exempel bara ange prodView
på produktinformationssidor och händelsen purchase
på orderbekräftelsesidor. I det här avsnittet får du lära dig hur du ställer in variabler med hjälp av regler.
Användningsfall
Produktinformationssidor (PDP) är viktiga punkter för datainsamling på butikssajter. Vanligtvis vill du att Analytics ska registrera att en produktvy har inträffat och vilken produkt som har visats. Detta är praktiskt när du vill veta vilka produkter som är populära hos dina kunder. På en mediewebbplats kan artikel- eller videosidor använda tekniker som liknar de du använder i det här avsnittet. När du läser in en produktinformationssida kanske du vill placera det värdet i sidtypen eVar
, samt ange vissa händelser och produkt-id:t. På så sätt kan vi se följande i vår analys:
- Hur många gånger produktinformationssidor läses in
- Vilka specifika produkter som visas och hur många gånger
- Hur andra faktorer (kampanjer, sökningar osv.) påverkar hur många PDP-personer som laddas
Skapa dataelement för sidtyp
Först måste du identifiera vilka sidor som är produktinformationssidorna. Det gör du med ett dataelement.
Skapa dataelementet för sidtypen
-
Klicka på Data Elements i den vänstra navigeringen
-
Klicka på Add Data Element
-
Namnge dataelementet
Page Type
-
Välj Data Element Type > JavaScript Variable
-
Använd
digitalData.page.category.type
som JavaScript variable name -
Kontrollera alternativen Clean text och Force Lower Case
-
Klicka på Save to Library
Skapa dataelement för produkt-ID
Därefter samlar du in produkt-id:t för den aktuella produktinformationssidan med ett dataelement
Skapa dataelementet för produkt-ID
-
Klicka på Data Elements i den vänstra navigeringen
-
Klicka på Add Data Element
-
Namnge dataelementet
Product Id
-
Välj Data Element Type > JavaScript Variable
-
Använd
digitalData.product.0.productInfo.sku
som JavaScript variable name -
Kontrollera alternativen Clean text och Force Lower Case
-
Klicka på Save to Library
Lägg till Adobe Analytics produktsträngstillägg
Om du redan är bekant med Adobe Analytics-implementeringar är du antagligen bekant med variabeln products. Variabeln products har en mycket specifik syntax och används på något olika sätt beroende på sammanhanget. För att göra populationen av produkterna lättare i taggar har ytterligare tre tillägg redan skapats på tagg-tilläggets marknadsplats! I det här avsnittet ska du lägga till ett tillägg som har skapats av Adobe Consulting och som ska användas på produktinformationssidan.
Lägg till tillägget Adobe Analytics Product String
-
Gå till sidan Extensions > Catalog
-
Hitta tillägget
Adobe Analytics Product String
av Adobe Consulting Services och klicka på Install
-
Ta en stund att läsa instruktionerna
-
Klicka på Save to Library
Skapa regeln för produktinformationssidor
Nu ska du använda dina nya dataelement och tillägg för att skapa regeln för produktinformation. För den här funktionen skapar du en annan sidinläsningsregel som aktiveras av DOM Ready. Du kommer dock att använda ett villkor så att det bara aktiveras på sidorna Produktinformation och i ordningsinställningen så att det aktiveras före regeln som skickar beacon.
Så här skapar du regeln för produktinformationssidan
-
Gå till avsnittet Rules i den vänstra navigeringen och klicka sedan på Add Rule
-
Namnge regeln
Product Details - DOM Ready - 40
-
Klicka på Events > Add för att öppna skärmen
Event Configuration
-
Välj Event Type > DOM Ready
-
Ange Order till 40 så att regeln körs före regeln som innehåller åtgärden Analytics > Send Beacon
-
Klicka på Keep Changes
-
Under Conditions klickar du på plustecknet för att öppna skärmen
Condition Configuration
-
Välj Condition Type > Value Comparison
-
Använd dataelementväljaren och välj
Page Type
i det första fältet -
Välj Contains i listrutan för jämförelseoperatorer
-
I nästa fälttyp
product-page
(det här är den unika delen av sidtypsvärdet som hämtats från datalagret på PDP-filer) -
Klicka på Keep Changes
-
-
Klicka på plustecknet
-
Välj Extension > Adobe Analytics Product String
-
Välj Action Type > Set s.products
-
I avsnittet Analytics E-commerce Event väljer du prodView
-
I avsnittet Data layer variables for product data använder du dataelementväljaren för att välja dataelementet
Product Id
-
Klicka på Keep Changes
-
Klicka på plustecknet
-
Välj Extension > Adobe Analytics
-
Välj Action Type > Set Variables
-
Markera eVar1 > Set as och ange
product detail page
-
Ange event1 och lämna de valfria värdena tomma
-
Klicka på knappen Add Another under Händelser
-
Ange händelsen prodView och lämna de valfria värdena tomma
-
Klicka på Keep Changes
-
Klicka på Save to Library and Build
Validera produktinformationssidans data
Du har just skapat en regel som ställer in variabler innan beacon skickas. Nu bör du kunna se nya data i träffen i Experience Cloud Debugger.
Så här validerar du produktinformationssidans data
-
Öppna Luma-webbplatsen i din Chrome-webbläsare
-
Navigera till valfri produktinformationssida
-
Klicka på felsökningsikonen för att öppna Adobe Experience Cloud Debugger
-
Klicka på fliken Analytics
-
Expandera din Report Suite
-
Observera produktinformationsvariablerna som nu finns i felsökaren, nämligen att
eVar1
har ställts in på"produktinformationssida", att variabelnEvents
har ställts in på"event1" och"prodView", att variabeln products ställs in med produkt-id:t för den produkt som du visar och att sidnamnet fortfarande anges av analystillägget
Skicka en spårlänkssignal
När en sida läses in utlöser du vanligtvis en sidinläsningssignal som utlöses av funktionen s.t()
. Detta ökar automatiskt måttet page view
för sidan som visas i variabeln pageName
.
Ibland vill du dock inte öka antalet sidvisningar på webbplatsen eftersom åtgärden som utförs är"mindre" (eller kanske bara annorlunda) än en sidvy. I det här fallet använder du funktionen s.tl()
, som vanligtvis kallas för en begäran om spårlänk. Även om den kallas för en begäran om spårlänk behöver den inte aktiveras med ett länkklick. Den kan utlösas av alla händelser som är tillgängliga i taggregelbyggaren, inklusive din egen anpassade JavaScript.
I den här självstudiekursen kommer du att utlösa ett s.tl()
-samtal med en av de coolaste JavaScript-händelserna, en Enters Viewport
-händelse.
Användningsfallet
I det här fallet vill du veta om folk rullar ned på Lumas hemsida tillräckligt mycket för att se avsnittet Aktuella produkter på vår sida. Det finns en del interna skillnader hos vårt företag om folk ens ser det avsnittet eller inte, så ni vill använda Analytics för att fastställa sanningen.
Skapa regeln i taggar
-
Gå till avsnittet Rules i den vänstra navigeringen och klicka sedan på Add Rule
-
Namnge regeln
Homepage - Featured Products enters Viewport
-
Klicka på Events > Add för att öppna skärmen
Event Configuration
-
Välj Event Type > Enters Viewport. Då visas ett fält där du måste ange CSS-väljaren som identifierar det objekt på sidan som ska utlösa regeln när den visas i webbläsaren.
-
Gå tillbaka till startsidan för Luma och bläddra till avsnittet Aktuella produkter.
-
Högerklicka på mellanrummet mellan titeln "FEATURED PRODUCTS" och alternativen i det här avsnittet och välj
Inspect
på högerklicksmenyn. Då kommer du nära det du vill ha. -
Precis där, möjligen direkt under det markerade avsnittet, söker du efter en div med
class="we-productgrid aem-GridColumn aem-GridColumn--default--12"
. Leta reda på elementet. -
Högerklicka på elementet och välj Copy > Copy Selector
-
Gå tillbaka till taggar och klistra in värdet från Urklipp i fältet
Elements matching the CSS selector
.- Det är å andra sidan upp till dig att bestämma hur du ska identifiera CSS-väljare. Den här metoden är lite känslig eftersom vissa ändringar på sidan kan bryta väljaren. Tänk på detta när du använder CSS-väljare i taggar.
-
Klicka på Keep Changes
-
Klicka på plustecknet för att lägga till ett nytt villkor
-
Välj Condition Type > Value Comparison
-
Använd dataelementväljaren och välj
Page Name
i det första fältet -
Välj Equals i listrutan för jämförelseoperatorer
-
I nästa fälttyp
content:luma:us:en
(det här är hemsidans sidnamn som hämtats från datalagret - vi vill bara att den här regeln ska köras på startsidan) -
Klicka på Keep Changes
-
Klicka på plustecknet
-
Välj Extension > Adobe Analytics
-
Välj Action Type > Set Variables
-
Ange
eVar3
tillHome Page - Featured Products
-
Ange
prop3
tillHome Page - Featured Products
-
Ange variabeln
Events
tillevent3
-
Klicka på Keep Changes
-
Klicka på plustecknet
-
Välj Extension > Adobe Analytics
-
Välj Action Type > Send Beacon
-
Välj spårningsalternativet
s.tl()
-
Ange
Scrolled down to Featured Products
i fältet Link Name. Det här värdet placeras i rapporten Anpassade länkar i Analytics. -
Klicka på Keep Changes
-
Klicka på Save to Library and Build
Validera funktionen Spåra länk
Nu ska du se till att den här träffen visas när du bläddrar till avsnittet Aktuella produkter på hemsidan för vår webbplats. När du först läser in hemsidan bör begäran inte göras, men när du rullar nedåt och avsnittet visas bör träffen utlösas av våra nya värden.
-
Öppna Luma-webbplatsen i webbläsaren i Chrome och kontrollera att du är högst upp på startsidan.
-
Klicka på debugger icon för att öppna Adobe Experience Cloud Debugger
-
Klicka på fliken Analytics
-
Expandera träffen i din Report Suite
-
Lägg märke till den normala sidvyträffen för startsidan med sidnamnet osv. (men inget i eVar3 eller prop3).
-
Låt Felsökning vara öppet och rulla nedåt på webbplatsen tills du ser avsnittet Aktuella produkter
-
Visa felsökaren igen, och en annan Analytics-träff borde ha träffats. Den här träffen ska ha de parametrar som är associerade med s.tl()-träffen som du ställer in, nämligen:
-
LinkType = "link_o"
(det innebär att träffen är en anpassad länkträff, inte en sidvisningsträff) -
LinkName = "Scrolled down to Featured Products"
-
prop3 = "Home Page - Featured Products"
-
eVar3 = "Home Page - Featured Products"
-
Events = "event3"
-
Lägga till ett plugin-program
Ett plugin-program är en del av JavaScript-koden som du kan lägga till i implementeringen för att utföra en specifik funktion som inte är inbyggd i produkten. Plugin-program kan skapas av dig, av andra Adobe-kunder/partners eller av Adobe Consulting.
För att implementera plugin-program finns det i stort sett tre steg:
- Inkludera funktionen doPlugins, där plugin-programmet refereras
- Lägg till huvudfunktionskoden för plugin-programmet
- Inkludera koden som anropar funktionen och ställer in variabler osv.
Gör objektet Analytics tillgängligt globalt
Om du ska lägga till funktionen doPlugins (nedan) och använda plugin-program måste du markera en kryssruta för att göra objektet"s" i Analytics tillgängligt globalt i Analytics-implementeringen.
-
Gå till Extensions > Installed
-
Klicka på Configure i Adobe Analytics-tillägget
-
Under Library Management markerar du rutan
Make tracker globally accessible
. Som du ser i hjälpbubblan blir spåraren global under fönstren, vilket är viktigt när du talar om det i din JavaScript-kund.
Inkludera funktionen doPlugins
Om du vill lägga till plugin-program måste du lägga till funktionen doPlugins. Den här funktionen läggs inte till som standard, men när den har lagts till hanteras den av AppMeasurementet och anropas sist när en träff skickas till Adobe Analytics. Du kan därför använda den här funktionen för att köra vissa JavaScript-program för att ange variabler som är enklare att ställa in på det här sättet.
-
Bläddra nedåt och expandera avsnittet
Configure Tracker Using Custom Code.
medan du fortfarande är i Analytics-tillägget. -
Klicka på Open Editor
-
Klistra in följande kod i kodredigeraren:
code language-javascript /* Plugin Config */ s.usePlugins=true s.doPlugins=function(s) { /* Add calls to plugins here */ }
-
Håll fönstret öppet för nästa steg
Lägg till funktionskod för plugin-programmet
Du kommer egentligen att anropa två plugin-program i den här koden, men en av dem är inbyggd i AppMeasurementets bibliotek, så för det behöver du inte lägga till funktionen som ska anropas. Men för den andra måste du också lägga till funktionskoden. Den här funktionen kallas getValOnce().
Plugin-programmet getValOnce()
Syftet med det här plugin-programmet är att förhindra att värden dupliceras felaktigt i koden när en besökare uppdaterar en sida eller använder webbläsarens bakåtknapp för att gå tillbaka till en sida där ett värde angavs. I den här lektionen använder du den för att förhindra att händelsen clickthrough
dupliceras.
Koden för det här plugin-programmet finns i Analytics Documentation, men finns här för att underlätta kopiering/inklistring.
-
Kopiera följande kod
code language-javascript /* Adobe Consulting Plugin: getValOnce v2.01 */ s.getValOnce=function(vtc,cn,et,ep){if(vtc&&(cn=cn||"s_gvo",et=et||0,ep="m"===ep?6E4:864E5,vtc!==this.c_r(cn))){var e=new Date;e.setTime(e.getTime()+et*ep);this.c_w(cn,vtc,0===et?0:e);return vtc}return""};
-
Klistra in den i kodfönstret i Analytics-tillägget (om du inte fortfarande har den öppen, öppnar du den igen enligt föregående steg), helt under funktionen doPlugins (inte i den).
Du kan nu anropa det här plugin-programmet inifrån doPlugins.
Anropa plugin-program från inom doPlugins
Nu när koden finns där och kan refereras kan du anropa plugin-program i funktionen doPlugins.
Först anropar vi ett plugin-program som är inbyggt i AppMeasurementets bibliotek, så det kallas ett"verktyg". Det kallas s.Util.getQueryParam
eftersom det är en del av objektet, är ett inbyggt verktyg och hämtar värden (baserat på en parameter) från frågesträngen i URL:en.
-
Kopiera följande kod:
code language-javascript s.campaign = s.Util.getQueryParam("cid");
-
Klistra in den i funktionen doPlugins. Detta söker efter en parameter med namnet
cid
i den aktuella sidans URL och placerar den i variabeln s.campaign. -
Anropa nu funktionen getValOnce genom att kopiera följande kod och klistra in den direkt under anropet till getQueryParam:
code language-javascript s.campaign=s.getValOnce(s.campaign,'s_cmp',30);
Den här koden ser till att samma värde inte skickas in mer än en gång i rad under 30 dagar (se dokumentationen för hur du anpassar koden efter dina behov).
-
Spara kodfönstret
-
Klicka på Save to Library and Build
Validera plugin-programmen
Nu kan du se till att plugin-programmen fungerar.
Verifiera plugin-programmen
-
Öppna Luma-webbplatsen i din Chrome-webbläsare
-
Klicka på felsökningsikonen för att öppna Adobe Experience Cloud Debugger
-
Klicka på fliken Analytics
-
Expandera din Report Suite
-
Observera att träffen Analytics inte har någon Campaign-variabel
-
Lämna Felsökning öppen, gå tillbaka till Luma-webbplatsen och lägg till
?cid=1234
i URL:en och tryck på Retur för att uppdatera sidan med den frågesträngen inkluderad -
Kontrollera felsökaren och bekräfta att det finns en andra Analytics-begäran med en Campaign-variabel inställd på
1234
-
Gå tillbaka och uppdatera Luma-sidan igen, med frågesträngen kvar i URL:en
-
Kontrollera nästa träff i Felsökning och Campaign-variabeln inte ska vara närvarande, eftersom plugin-programmet getValOnce har sett till att det inte dupliceras och ser ut som om en annan person kom in från kampanjspårningskoden.
-
BONUS: Du kan testa detta om och om igen genom att ändra värdet för parametern
cid
i frågesträngen. Campaign-variabeln ska bara finnas där om det är den första gången du kör sidan med värdet. Om du inte ser Campaign-värdet i felsökaren ändrar du bara värdet förcid
i frågesträngen för URL:en, trycker på Retur och sedan ser du det igen i felsökaren.note note NOTE Det finns faktiskt några olika sätt att hämta en parameter från frågesträngen i URL:en, bland annat i tilläggskonfigurationen för Analytics. I dessa andra icke-plug-in-alternativ ger de dock inte möjlighet att stoppa onödig duplicering, vilket du har gjort här med plugin-programmet getValOnce. Detta är författarens favoritmetod, men du bör avgöra vilken metod som fungerar bäst för dig och dina behov.
Snyggt jobbat! Du är klar med Analytics-lektionen. Naturligtvis finns det många andra saker du kan göra för att förbättra vår Analytics-implementering, men förhoppningsvis har detta gett dig en del av kärnkompetensen för att hantera resten av dina behov.
Nästa"Lägg till Adobe Audience Manager" >