Adobe Analytics instellen met Adobe Experience Platform Web SDK
Gemaakt voor:
- Beginner
- tussenpersoon
- Ontwikkelaar
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 Assurance
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 datastream geeft vervolgens aan Platform Edge Network door aan welke Adobe Analytics-rapportages uw gegevens moeten worden verzonden.
-
Ga naar 🔗 interface van de Inzameling van 0} Gegevens
-
Selecteer Datastreams bij de linkernavigatie
-
Selecteer de eerder gemaakte
Luma Web SDK: Development Environmentdatastream
-
Selecteren Add Service
-
Selecteer Adobe Analytics als de Service
-
Voer de Report Suite ID van uw ontwikkelrapport-suite in
-
Selecteren Save
TIPHet toevoegen van meer rapportsuites door Add Report Suite te selecteren is gelijkwaardig aan multi-suite het etiketteren.
WARNINGAnalysevariabelen 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
datain (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 Adobe.
Dit komt voor als zelfs als u geen douaneschema hebt bepaald. Experience Platform Web SDK verzamelt automatisch bepaalde gegevens en verzendt deze naar Platform Edge Network als XDM-velden. 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 for Adobe Analytics met een XDM-schema implementeert, zoals in deze zelfstudie, hebben sommige XDM-velden die u hebt geïmplementeerd, automatisch toegewezen aan variabelen van Analytics, zoals in deze tabel wordt beschreven:
identitymap.ecid.[0].idweb.webPageDetails.nameweb.webPageDetails.serverweb.webPageDetails.siteSectioncommerce.productViews.valuecommerce.productListViews.valuecommerce.checkouts.valuecommerce.purchases.valuecommerce.order.currencyCodecommerce.order.purchaseIDproductListItems[].SKUproductListItems[].nameproductListItems[].quantityproductListItems[].priceTotalDe afzonderlijke secties van de producttekenreeks Analytics worden ingesteld via verschillende XDM-variabelen onder het productListItems -object.
NOTEproductListItems[].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 naar Platform Edge Network verzonden, maar alleen het xdm -object wordt naar de Experience Platform-gegevensset verzonden. Eigenschappen in het data -object kunnen op de Edge aan xdm -velden worden toegewezen met de functie Data Prep for Data Collection, maar anders niet naar Experience Platform. Dit maakt het een ideale manier om gegevens naar toepassingen als Analytics te verzenden, die niet op Experience Platform zelf zijn gebouwd.
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.variableals de Data element - Het object analytics selecteren
eVar1instellen als het gegevenselementpage.pageInfo.pageName- Stel
prop1in om de waarde vaneVar1te 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.variableals 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
-
Selecteren Advanced Options om te openen Report Suite Overrides
-
Selecteer de rapportsuites die u wilt met voeten treden. In dit geval,
Web SDK Course DevenWeb 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 - 50die 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.contentgegevenselement u in creeerde gegevenselementenles -
Als Data, selecteer het
data.variablegegevenselement u in creeerde gegevenselementenles
-
Omlaag schuiven naar de sectie Datastream Configurations Overrides
-
Laat de tab Development geselecteerd.
TIPDit 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 de Experience Platform Debugger.
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 hebt ook geleerd hoe u aanvragen van Platform Edge Network voor de server kunt valideren die naar Adobe-toepassingen zijn verzonden, en hoe u een volledig verwerkte lading kunt weergeven met Assurance.
Als u Analytics wilt valideren, worden gegevens correct vastgelegd via Experience Platform Web SDK, moet u twee stappen verder gaan:
- Valideren hoe gegevens worden verwerkt door het XDM-object op Platform Edge Network, met de functie Edge Trace van Experience Platform Debugger
- 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@test.com p: test voor verificatie
-
Open Debugger van Experience Platform en schakelaar het markeringsbezit op de plaats aan uw eigen ontwikkelingsbezit
-
Als u Edge Trace wilt inschakelen, gaat u naar Experience Platform Debugger, 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 Experience Platform Debugger opnieuw. De gegevens worden dan weergegeven. De rij die begint met Analytics Automatic Mapping is het baken van Adobe Analytics
-
Selecteer deze optie om het vervolgkeuzemenu
mappedQueryParamsen het tweede vervolgkeuzemenu te openen om de variabelen Analytics weer te geven
TIPDe 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].idte zoeken. Het is een Context Data Variable die ECID vangt -
Blijf omlaag schuiven totdat u de variabele Analytics
midziet. Beide id's komen overeen met de Experience Cloud-id van uw apparaat. -
Op de Luma-site:
NOTEAangezien u bent aangemeld, duurt het even om te valideren dat de geverifieerde idb642b4217b34b1e8d3bd915fc65c4452voor de gebruikertest@test.comook 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
reportSuiteIdsde 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
gnweer 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, behandelt het Platform Edge Network de gegevens aan de juiste analytische variabelen in kaart brengen.
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.skuhebt 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
plweer 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].skualsproductvan 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
commerceiets anders behandeld danproductList-afmetingen. Een Context Data-variabele wordt niet op dezelfde manier weergegeven als de productnaam die aanc.a.x.productlistitem.[0].namehierboven is toegewezen. In plaats daarvan geeft het Edge-spoor de uiteindelijke gebeurtenis automatisch toe in de variabele Analyticsevent. Platform Edge Network brengt het dienovereenkomstig in kaart zolang u aan de juiste XDMcommercevariabele terwijl vormend het schema voor Adobe Analyticsin kaart; in dit gevalcommerce.productViews.value=1. -
Ga terug naar het venster Experience Platform Debugger en schuif omlaag naar de variabele
events, dan wordt deze ingesteld opprodView -
Opmerking
c.a.x.eventTypewordt ook ingesteld opcommerce.productViewsomdat u op een productpagina bent.TIPDeecommerce - pdp library loaded - AA (order 20)-regel overschrijft de waarde vaneventTypeingesteld 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
eventTypeingesteld opcommerce.productListViewsevents: "scView"en- de producttekenreeks is ingesteld
-
Ga door met het afrekenen, controleer Edge Trace voor
eventTypeingesteld opcommerce.checkoutsevents: "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
eventTypeingesteld opcommerce.purchases- Inkoopgebeurtenis wordt ingesteld
events: "purchase" - Valuta Code-variabele die wordt ingesteld
cc: "USD" - Aankoop-id die wordt ingesteld in
pi - Producttekenreeks
plvoor het instellen van de productnaam, hoeveelheid en prijs
Adobe Analytics valideren met Assurance
Met Adobe Experience Platform Assurance kunt u controleren, testen, simuleren en valideren hoe u gegevens verzamelt of ervaringen opdoet met uw website en mobiele toepassing.
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 de Debugger van 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 Assurance in werking te stellen. Aangezien u Adobe Experience Platform Debugger hebt geopend met een Edge Trace-sessie die is gestart vanaf de laatste oefening, raden we u aan om Assurance te openen via Foutopsporing:
Voer in de “Web SDK Tutorial 3” Assurance-sessie “hitdebugger” de zoekbalk voor gebeurtenissen in om de resultaten naar de door Adobe Analytics Post verwerkte gegevens te filteren.
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 validatiegebruikscase die bij het valideren met de bovenstaande Experience Platform-foutopsporing wordt gebruikt, en ga verder met het gebruik van hetzelfde baken om de instructies Ecommerce Events en Product String te valideren.
- Zoeken naar lading waar de events
prodViewbevat
{de bevestiging van het Koord van het 0} Product met Assurance
- Schuif omlaag naar product-string om de
Product Stringte valideren.- Noteer
Product SKUenMerchandizing eVar1.
- Noteer
- Schuif verder omlaag en valideer dat
prop1, dat u hebt geconfigureerd met de verwerkingsregels in de vorige sectie, de eigenschapProduct SKUbevat
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
scViewen bevestigt het productkoord.
{de bevestiging van het Koord van het 0} Product met Assurance
- Zoek naar lading waar events bevat
scCheckouten bevestigt het productkoord.
{de bevestiging van het Koord van het 0} Product met Assurance
- Zoeken naar lading waar de events
purchasebevat
{de bevestiging van het Koord van het 0} Product met Assurance
- Wanneer u de
purchase-gebeurtenis valideert, moet deProduct StringdeProduct SKU,Product QuantityenProduct Total Pricebevatten. - Voor de
purchasevalidate bovendien ofpurchase-idand/orpurchaseIdis 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 te implementeren voor uw eigen website.
NOTE