Adobe Analytics instellen met Adobe Experience Platform Web SDK
Leer hoe te opstelling Adobe Analytics gebruikend SDK van het Web van Adobe Experience Platform, markeringsregels tot stand brengen om gegevens naar Adobe Analytics te verzenden, en te bevestigen dat Analytics gegevens zoals verwacht vangt.
Adobe Analyticsis een industrie-leidende toepassing die u machtigt om uw klanten als mensen te begrijpen en uw zaken met klantenintelligentie te sturen.
Leerdoelstellingen
Aan het eind van deze les, zult u kunnen:
- Een gegevensstroom configureren om Adobe Analytics in te schakelen
- Weet welke standaard-XDM velden automatisch worden toegewezen aan analytische variabelen
- Analysevariabelen instellen in het gegevensobject
- Gegevens naar een andere rapportsuite verzenden door de gegevensstroom te overschrijven
- Adobe Analytics-variabelen valideren met Foutopsporing en Betrouwbaarheid
Vereisten
Om deze les te voltooien, moet u eerst:
-
Ben vertrouwd met en heb toegang tot Adobe Analytics.
-
minstens één test/dev rapportsuite-id hebben. Als u geen test/dev- rapportreeks hebt die u voor dit leerprogramma kunt gebruiken, gelieve te creëren.
-
Voltooi de vroegere lessen in de Aanvankelijke secties van de Configuratie van de Configuratie en van de Markeringen van dit leerprogramma.
De gegevensstroom configureren
Platform Web SDK verzendt gegevens van uw website naar Platform Edge Network. Uw gegevensstroom vertelt dan de Edge Network van het Platform aan welke Adobe Analytics rapportreeksen uw gegevens zouden moeten worden verzonden.
-
Ga naar de Inzameling van Gegevens{target=“blank”} interface
-
Selecteer Datastreams bij de linkernavigatie
-
Selecteer de eerder gemaakte
Luma Web SDK: Development Environment
datastream -
Selecteren Add Service
toe -
Selecteer Adobe Analytics als de Service
-
Voer de Report Suite ID van uw ontwikkelrapport-suite in
-
Selecteren Save
note tip TIP Het toevoegen van meer rapportsuites door Add Report Suite te selecteren is gelijkwaardig aan multi-suite het etiketteren.
Analysevariabelen instellen
Er zijn verscheidene manieren om de variabelen van de Analyse in een implementatie van SDK van het Web te plaatsen:
- Automatische toewijzing van XDM-velden aan analytische variabelen (automatisch).
- Stel velden in het object
data
in (aanbevolen). - XDM-velden toewijzen aan analytische variabelen in de verwerkingsregels voor Analytics (niet langer aanbevolen).
- Wijs variabelen rechtstreeks toe aan Analytics in het XDM-schema (niet meer aanbevolen).
Vanaf mei 2024 hoeft u niet langer een XDM-schema te maken om Adobe Analytics met Platform Web SDK te implementeren. Het data
voorwerp (en het data.variable
gegevenselement u in creeerde creëren gegevenselementenles) kan worden gebruikt om alle variabelen van de douaneanalyse te plaatsen. Het instellen van deze variabelen in het gegevensobject is vertrouwd voor bestaande klanten van Analytics, is efficiënter dan het gebruik van de interface met verwerkingsregels en voorkomt dat overbodige gegevens ruimte in realtime-klantprofielen opnemen (belangrijk als u Real-time Customer Data Platform of Journey Optimizer hebt).
Automatisch toegewezen velden
Veel XDM-velden worden automatisch toegewezen aan analytische variabelen. Voor de meest bijgewerkte lijst van afbeeldingen, gelieve te zien veranderlijke afbeelding van Analytics in de Ervaring Edge van de Adobe.
Dit komt voor als zelfs als u geen douaneschema hebt bepaald. SDK van het Web van het Experience Platform verzamelt automatisch sommige gegevens en verzendt het naar de Edge Network van het Platform als gebieden XDM. Web SDK leest bijvoorbeeld de URL van de huidige pagina en verzendt deze als het XDM-veld web.webPageDetails.URL
. Dit veld wordt doorgestuurd naar Adobe Analytics en de pagina-URL-rapporten worden automatisch ingevuld in Adobe Analytics.
Als u Web SDK voor Adobe Analytics met een schema XDM, aangezien u in dit leerprogramma hebt, sommige gebieden XDM u douane-uitgevoerde auto-kaart aan de variabelen van Analytics, zoals die in deze lijst worden beschreven uitvoert:
identitymap.ecid.[0].id
web.webPageDetails.name
web.webPageDetails.server
web.webPageDetails.siteSection
commerce.productViews.value
commerce.productListViews.value
commerce.checkouts.value
commerce.purchases.value
commerce.order.currencyCode
commerce.order.purchaseID
productListItems[].SKU
productListItems[].name
productListItems[].quantity
productListItems[].priceTotal
De afzonderlijke secties van de producttekenreeks Analytics worden ingesteld via verschillende XDM-variabelen onder het productListItems
-object.
productListItems[].SKU
prioriteit voor het toewijzen aan de productnaam in de variabele s.products.De waarde die is ingesteld op
productListItems[].name
, wordt alleen aan de productnaam toegewezen als productListItems[].SKU
niet bestaat. Anders wordt de koppeling verwijderd en beschikbaar in contextgegevens.Stel geen lege tekenreeks of null in op
productListItems[].SKU
. Dit heeft het ongewenste effect van afbeelding aan de productnaam in de s.products variabele.Variabelen instellen in het gegevensobject
Maar hoe zit het met gebeurtenissen, props en gebeurtenissen? Het instellen van variabelen in het data
-object is de aanbevolen manier om deze variabelen voor Analytics in te stellen met Web SDK. Als u variabelen in het gegevensobject instelt, kunnen ook alle automatisch toegewezen variabelen worden overschreven.
Ten eerste, wat is het data
-object? In elke Web SDK-gebeurtenis kunt u twee objecten met aangepaste gegevens verzenden, het xdm
-object en het data
-object. Beide worden verzonden naar de Edge Network van het Platform, maar slechts wordt het xdm
voorwerp verzonden naar de dataset van het Experience Platform. Eigenschappen in het data
-object kunnen op de Edge aan xdm
-velden worden toegewezen met de functie Data Prep for Data Collection, maar anders worden ze niet naar het Experience Platform verzonden. Dit maakt het een ideale manier om gegevens naar toepassingen als Analytics te verzenden, die niet op Experience Platform zelf zijn gebaseerd.
Hier zijn de twee voorwerpen in een generische vraag van SDK van het Web:
Adobe Analytics is geconfigureerd om te zoeken naar eigenschappen in het data.__adobe.analytics
-object en deze te gebruiken voor analytische variabelen.
Laten we eens kijken hoe dit werkt. Laten we eVar1
en prop1
instellen met onze paginanaam en zien hoe de door XDM toegewezen waarde kan worden overschreven
- De labelregel openen
all pages - library loaded - set global variables - 1
- Een nieuwe Action toevoegen
- Extensie Adobe Experience Platform Web SDK selecteren
- Action Type selecteren als Update variable
- Selecteer
data.variable
als de Data element - Het object analytics selecteren
eVar1
instellen als het gegevenselementpage.pageInfo.pageName
- Stel
prop1
in om de waarde vaneVar1
te kopiëren - Als u het overschrijven van XDM-toegewezen waarden wilt testen, stelt u in de sectie Additional property de paginanaam in als een statische waarde
test
- De regel opslaan
Nu, moeten wij het gegevensvoorwerp in onze send gebeurtenisregel omvatten.
- De labelregel openen
all pages - library loaded - send event - 50
- De handeling Send Event openen
- Selecteer
data.variable
als de Data - Selecteren Keep Changes
- Selecteren Save
Gegevens verzenden naar een andere rapportsuite
U kunt wijzigen naar welke Adobe Analytics-rapportsuite gegevens worden verzonden wanneer bezoekers zich op bepaalde pagina's bevinden. Dit vereist een configuratie in zowel de datastream als een regel.
Vorm de gegevensstroom voor een de opheffing van de rapportreeks
U configureert als volgt de overschrijvingsinstelling van de Adobe Analytics-rapportsuite in de gegevensstroom:
-
De gegevensstroom openen
-
Bewerk de Adobe Analytics configuratie door menu te openen en dan Edit te selecteren
-
Selecteren Advanced Options om te openen Report Suite Overrides
-
Selecteer de rapportsuites die u wilt met voeten treden. In dit geval,
Web SDK Course Dev
enWeb SDK Course Stg
-
Selecteren Save
Vorm een regel voor een de opheffing van de rapportreeks
Laten wij een regel tot stand brengen om een extra vraag van de paginamening naar een verschillende rapportreeks te verzenden. Met de functie voor gegevensstroomoverschrijving kunt u de rapportsuite voor een pagina wijzigen met de handeling Send Event .
-
Een nieuwe regel maken, een naam geven
homepage - library loaded - AA report suite override - 51
-
Selecteer het plusteken onder Event om een nieuwe trigger toe te voegen
-
Onder Extension selecteert u Core
-
Onder Event Type selecteert u Library Loaded (Page Top)
-
Selecteer deze optie om Advanced Options te openen en typ in
51
. Dit zorgt ervoor dat de regel wordt uitgevoerd na deall pages - library loaded - send event - 50
die de basislijn-XDM instelt met het actietype Update variable . -
Selecteren Keep Changes
-
Onder Conditions selecteert u Add
-
Logic Type behouden als Regular
-
Extensions behouden als Core
-
Condition Type selecteren als Path Without Query String
-
Laat de schakeloptie Regex aan de rechterkant uitgeschakeld
-
Onder path equals set
/content/luma/us/en.html
. Voor de Luma-demo-site zorgt deze ervoor dat de regel alleen op de homepage wordt geactiveerd -
Selecteren Keep Changes
-
Onder Actions select Add
-
Als Extension selecteert u Adobe Experience Platform Web SDK
-
Als Action Type selecteert u Send Event
-
Als XDM data, selecteer het
xdm.variable.content
gegevenselement u in creeerde gegevenselementenles -
Als Data, selecteer het
data.variable
gegevenselement u in creeerde gegevenselementenles -
Omlaag schuiven naar de sectie Datastream Configurations Overrides
-
Laat de tab Development geselecteerd.
note tip TIP Dit tabblad bepaalt in welke tagomgeving de overschrijving plaatsvindt. Voor dit oefening, specificeert u slechts het milieu van de Ontwikkeling maar wanneer u dit aan productie opstelt herinner zich om het ook in het Production milieu te doen. -
Selecteer de Sandbox die u gebruikt voor de zelfstudie
-
Selecteer in dit geval de Datastream optie
Luma Web SDK: Development Environment
. -
Selecteer onder Report suites de rapportsite die u wilt gebruiken om te overschrijven. In dit geval,
tmd-websdk-course-stg
. -
Selecteren Keep Changes
-
En Save uw regel
Bouw uw milieu van de Ontwikkeling
Voeg de bijgewerkte regels toe aan de tagbibliotheek van Luma Web SDK Tutorial
en herstel de ontwikkelomgeving.
Gefeliciteerd! De volgende stap bestaat uit het valideren van uw Adobe Analytics-implementatie via Experience Platform Web SDK.
Adobe Analytics valideren met foutopsporing
Leer hoe u kunt valideren dat Adobe Analytics de ECID, paginaweergaven, de productreeks en e-commercegebeurtenissen vastlegt met de functie Edge Trace van Foutopsporing voor Experience Platforms.
In de Debuggerles, leerde u hoe te om het cliënt-kant XDM verzoek met de Debugger van het Platform en browser ontwikkelaarsconsole te inspecteren, die aan gelijkaardig is hoe u een AppMeasurement.js
implementatie van Analytics zuivert. U leerde ook over het bevestigen van de server-zijverzoeken van de Edge Network van het Platform die naar de toepassingen van de Adobe worden verzonden, en hoe te om een volledig verwerkte lading te bekijken gebruikend Verzekering.
Om Analytics te bevestigen vangt correct gegevens door het Web SDK van het Experience Platform, moet u twee stappen verder gaan:
- Valideer hoe de gegevens door het voorwerp XDM op de Edge Network van het Platform worden verwerkt, gebruikend de eigenschap van het Spoor van Edge van Foutopsporing van het Experience Platform
- Valideren hoe gegevens volledig worden verwerkt door Analytics met Adobe Experience Platform Assurance
Validatie van Experience Cloud-id
-
Ga naar de plaats van de Luminagedemo
-
Selecteer de aanmeldknop rechtsboven en gebruik gebruikersgegevens u: test@adobe.com p: test voor verificatie
-
Open Foutopsporing van het Experience Platform en schakelaar het markeringsbezit op de plaats aan uw eigen ontwikkelingsbezit
-
Als u Edge Trace wilt inschakelen, gaat u naar Foutopsporing Experience Platform, selecteert u in de linkernavigatie Logs en selecteert u vervolgens de tab Edge en selecteert u Connect .
-
Het zal nu leeg zijn
-
Vernieuw de pagina Luminantie en controleer Foutopsporing Experience Platform opnieuw. Er worden gegevens weergegeven. De rij die begint met Analytics Automatic Mapping is het baken van Adobe Analytics
-
Selecteer deze optie om het vervolgkeuzemenu
mappedQueryParams
en het tweede vervolgkeuzemenu te openen om de variabelen Analytics weer te gevennote tip TIP De tweede vervolgkeuzelijst komt overeen met de ID van de Analytics-rapportsuite waarnaar u gegevens verzendt. Het zou uw eigen rapportreeks moeten aanpassen, niet in het schermafbeelding. -
Schuif omlaag om
c.a.x.identitymap.ecid.[0].id
te zoeken. Het is een Context Data Variable die ECID vangt -
Blijf omlaag schuiven totdat u de variabele Analytics
mid
ziet. Beide id's komen overeen met de Experience Cloud-id van uw apparaat. -
Op de Luma-site:
note note NOTE Aangezien u bent aangemeld, duurt het even om te valideren dat de geverifieerde id 112ca06ed53d3db37e4cea49cc45b71e
voor de gebruikertest@adobe.com
ook wordt vastgelegd in dec.a.x.identitymap.lumacrmid.[0].id
Validatie van overschrijvingen van rapportsuite
Boven u vormde een gegevensstroomopheffing voor de homepage van de Luma. Om deze configuratie te bevestigen
-
Zoek een rij met Datastream config after override was applied . Hier vindt u de primaire rapportsuite en de extra rapportsuite(s) die voor de rapportsuite-overschrijvingen zijn geconfigureerd.
-
Blader omlaag naar de rij die begint met Analytics Automatic Mapping en controleer of in
reportSuiteIds
de rapportsuite wordt weergegeven die u hebt opgegeven in de overschrijvingsconfiguraties
Validatie van weergaven van inhoudspagina
Ga naar een productpagina zoals de Didi het productpagina van het Horloge van de Sport. Controleer of de weergaven van de inhoudspagina worden vastgelegd door Analytics.
-
Ga naar
c.a.x.web.webpagedetails.pageviews.value=1
. -
Schuif omlaag om de variabele
gn
weer te geven. Dit is de dynamische syntaxis van Analytics voor de variabeles.pageName
. De paginanaam wordt vastgelegd vanuit de gegevenslaag.
Validatie van productreeks- en e-commercegebeurtenissen
Aangezien u al op een productpagina staat, blijft deze oefening het zelfde Edge Trace gebruiken om productgegevens te bevestigen wordt gevangen door Analytics. Zowel worden het productkoord als e-commercegebeurtenissen automatisch in kaart gebracht XDM variabelen aan Analytics. Zolang u aan de juiste productListItem
variabele XDM terwijl vormend een schema XDM voor Adobe Analyticsin kaart hebt gebracht, zorgt de Edge Network van het Platform voor het in kaart brengen van de gegevens aan de juiste analytische variabelen.
Bevestig eerst dat Product String
wordt geplaatst
-
Ga naar
c.a.x.productlistitems.[0].sku
. De variabele legt de waarde van het gegevenselement vast die u eerder in deze les aanproductListItems.item1.sku
hebt toegewezen -
Zoek ook naar
c.a.x.productlistitems.[0]._experience.analytics.customdimensions.evars.evar1
. De variabele legt de waarde van het gegevenselement vast die u hebt toegewezen aanproductListItems.item1._experience.analytics.customdimensions.evars.evar1
-
Schuif omlaag om de variabele
pl
weer te geven. Dit is de dynamische syntaxis van de variabele van de producttekenreeks Analytics -
Merk op dat de productnaam uit de gegevenslaag zowel aan de parameter
c.a.x.productlistitems.[0].sku
alsproduct
van het productkoord in kaart wordt gebracht. Bovendien wordt de producttitel van de gegevenslaag in kaart gebracht aan merchandising evar1 in het productkoord.In het Edge Trace worden gebeurtenissen
commerce
iets anders behandeld danproductList
-afmetingen. Een Context Data-variabele wordt niet op dezelfde manier weergegeven als de productnaam die aanc.a.x.productlistitem.[0].name
hierboven is toegewezen. In plaats daarvan geeft het Edge-spoor de uiteindelijke gebeurtenis automatisch toe in de variabele Analyticsevent
. De Edge Network van het platform brengt het dienovereenkomstig in kaart zolang u aan de juiste XDMcommerce
variabele terwijl vormend het schema voor Adobe Analyticsin kaart; in dit gevalcommerce.productViews.value=1
. -
Ga terug naar het venster Foutopsporing Experience Platform en schuif omlaag naar de variabele
events
en stel deze in opprodView
-
Opmerking
c.a.x.eventType
wordt ook ingesteld opcommerce.productViews
omdat u op een productpagina bent.note tip TIP De ecommerce - pdp library loaded - AA (order 20)
-regel overschrijft de waarde vaneventType
ingesteld door deall pages global content variables - library loaded - AA (order 1)
-regel wanneer deze is ingesteld om later in de reeks te worden geactiveerd{de Mening van het Product van 0} Analytics
bevestigt de rest e-commercegebeurtenissen en productkoorden worden geplaatst voor Analytics
-
Voeg Didi Sporthorlogeaan kar toe
-
Ga naar de Pagina van het Kart, controleer het Spoor van Edge voor
eventType
ingesteld opcommerce.productListViews
events: "scView"
en- de producttekenreeks is ingesteld
-
Ga door met het afrekenen, controleer Edge Trace voor
eventType
ingesteld opcommerce.checkouts
events: "scCheckout"
en- de producttekenreeks is ingesteld
-
Vul enkel de Voornaam en Familie gebieden op de verzendende vorm in en selecteer ga verder. Voor de volgende pagina, uitgezochte Orde van de Plaats
-
Controleer op de bevestigingspagina Edge Trace for
eventType
ingesteld opcommerce.purchases
- Inkoopgebeurtenis wordt ingesteld
events: "purchase"
- Valuta Code-variabele die wordt ingesteld
cc: "USD"
- Aankoop-id die wordt ingesteld in
pi
- Producttekenreeks
pl
voor het instellen van de productnaam, hoeveelheid en prijs
Adobe Analytics valideren met Betrouwbaarheid
Met Adobe Experience Platform Assurance kunt u controleren, testen, simuleren en valideren hoe u gegevens verzamelt of ervaringen met uw website en mobiele toepassing benut.
In de vorige oefening bevestigde u dat Adobe Analytics ECID, paginameningen, het productkoord, en e-commercegebeurtenissen met de eigenschap van het Spoor van Edge van Foutopsporing van het Experience Platform vangt. Vervolgens valideert u dezelfde gebeurtenissen met Adobe Experience Platform Assurance, een alternatieve interface voor toegang tot dezelfde gegevens in Edge Trace.
Zoals u in de Assuranceles leerde, zijn er verscheidene manieren om een zitting van de Verzekering in werking te stellen. Aangezien u reeds Adobe Experience Platform Debugger open hebt met een zitting van het Spoor van Edge die van de laatste oefening in werking wordt gesteld, adviseren wij toegang tot Verzekering door Debugger:
Voer in de “Web SDK Tutorial 3” Betrouwbaarheidssessie “hitdebugger” de zoekbalk voor gebeurtenissen in om de resultaten te filteren op de door Adobe Analytics Post verwerkte gegevens.
Validatie van Experience Cloud-id
Als u wilt valideren dat Adobe Analytics de ECID vastlegt, selecteert u een baken en opent u de Payload. De leverancier voor dit baken moet com.adobe.analytics.hitdebugger zijn
Blader vervolgens omlaag naar mcvisId om te controleren of de ECID correct is vastgelegd
Validatie van weergaven van inhoudspagina
Met hetzelfde baken valideert u of de weergaven van de inhoudspagina zijn toegewezen aan de juiste Adobe Analytics-variabele.
Omlaag schuiven naar pageName om te controleren of de Page Name
correct is vastgelegd
Validatie van productreeks- en e-commercegebeurtenissen
Volg dezelfde validatiegebruikstoepassingen die worden gebruikt voor validatie met bovenstaande foutopsporing voor Experience Platforms, ga verder met het gebruik van hetzelfde baken om de Ecommerce Events
en de Product String
te valideren.
- Zoeken naar lading waar de events
prodView
bevat
{de bevestiging van het Koord van het 0} Product met Verzekering - Schuif omlaag naar product-string om de
Product String
te valideren.- Noteer
Product SKU
enMerchandizing eVar1
.
- Noteer
- Schuif verder omlaag en valideer dat
prop1
, dat u hebt geconfigureerd met de verwerkingsregels in de vorige sectie, de eigenschapProduct SKU
bevat
Ga door met het valideren van uw implementatie door de gebeurtenissen voor winkelwagentjes, kassa's en aankopen te controleren.
- Zoek naar lading waar events bevat
scView
en bevestigt het productkoord.
{de bevestiging van het Koord van het 0} Product met Verzekering - Zoek naar lading waar events bevat
scCheckout
en bevestigt het productkoord.
{de bevestiging van het Koord van het 0} Product met Verzekering - Zoeken naar lading waar de events
purchase
bevat
{de bevestiging van het Koord van het 0} Product met Verzekering - Wanneer u de
purchase
-gebeurtenis valideert, moet deProduct String
deProduct SKU
,Product Quantity
enProduct Total Price
bevatten. - Voor de
purchase
validate bovendien ofpurchase-id
and/orpurchaseId
is ingesteld
Gefeliciteerd! Je hebt het gedaan! Dit is het einde van de les en nu bent u klaar om Adobe Analytics met Platform Web SDK voor uw eigen website te implementeren.