DocumentatieAnalyticsImplementatiehandleiding

Gegevens naar Adobe Analytics verzenden met de Web SDK JavaScript-bibliotheek

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Gebruiker
  • Beheerder

Dit implementatiepad omvat een nieuwe Web SDK-installatie met de Web SDK JavaScript-bibliotheek. Andere implementatiepaden worden op afzonderlijke pagina's behandeld:

  • de markeringsuitbreiding van SDK van het Web: Een verse installatie van SDK van het Web die de de markeringsuitbreiding van SDK van het Web gebruikt. Vergelijkbaar met de JavaScript-bibliotheekaanpak van de Web SDK (deze pagina), behalve dat u de implementatie beheert met tags in Adobe Experience Platform Data Collection. Hiervoor is de Adobe Analytics ExperienceEvent-veldgroep vereist, die typische analytische variabelen bevat die in uw XDM-schema moeten worden opgenomen.
  • uitbreiding Analytics aan de uitbreiding van SDK van het Web: Neem een vlotte en methodische benadering om zich van de de markeringsuitbreiding van Adobe Analytics naar de de markeringsuitbreiding van SDK van het Web te bewegen. Deze benadering onderdrukt de behoefte om XDM te gebruiken tot uw organisatie klaar is om de diensten van Adobe Experience Platform, zoals Customer Journey Analytics te gebruiken. Gebruik het object data in plaats van het object xdm om gegevens naar de Adobe te verzenden.
  • AppMeasurement aan de bibliotheek van JavaScript van SDK van het Web: Een vlotte en methodische benadering om aan SDK van het Web te migreren, behalve het gebruikt geen markeringen. In plaats daarvan, kunt u de bibliotheek van de de gegevensinzameling van Adobe Analytics (AppMeasurement.js) manueel verwijderen en het vervangen met de bibliotheek van JavaScript van SDK van het Web (alloy.js).

Voordelen en nadelen van dit implementatiepad

Het gebruik van de Web SDK JavaScript-bibliotheek voor het verzenden van gegevens naar Adobe Analytics heeft zowel voor- als nadelen. Let zorgvuldig op elke optie om te bepalen welke benadering het beste is voor uw organisatie.

Voordelen
Nadelen
  • Directe benadering: Deze implementatieweg is helderder dan benaderingen die bestaande implementaties van Adobe Analytics bewegen. Als u geen huidige implementatie van Adobe Analytics om zich over ongerust te maken hebt, bevolk de toepasselijke gebieden van SDK van het Web XDM.
  • vooraf bepaald schema: Als uw organisatie geen behoefte aan uw eigen schema heeft, kunt u eenvoudig het schema gebruiken dat op Adobe Analytics wordt gericht. Dit concept is zelfs van toepassing als u naar Customer Journey Analytics gaat. Het concept 'props' en 'eVars' zijn niet van toepassing op Customer Journey Analytics, maar u kunt 'props' en 'eVars' blijven gebruiken als eenvoudige aangepaste afmetingen.
  • de veranderingen van de Implementatie vereisen ontwikkelaarinterventie: Als u veranderingen in uw implementatie van SDK van het Web wilt aanbrengen, moet u met uw ontwikkelingsteam werken om de code op uw plaats uit te geven. De benadering die de de markeringsuitbreiding van SDK van het Webgebruikt vermijdt dit nadeel.
  • Vergrendeld in het gebruiken van een specifiek schema: Wanneer uw organisatie zich aan Customer Journey Analytics beweegt, moet u verkiezen om verder te gebruiken het schema van Adobe Analytics, of aan het schema van uw eigen organisatie (dat een afzonderlijke gegevensreeks zou zijn) te migreren. Als uw organisatie zowel het Adobe Analytics-schema als de migratie naar een aparte gegevensset bij de overgang naar de Customer Journey Analytics wil vermijden, raadt Adobe een van de volgende twee methoden aan:
    • Gebruik het object data : met het object data kunt u gegevens naar Adobe Analytics verzenden zonder dat u zich aan een XDM-schema houdt. Nadat u het schema van uw organisatie hebt gemaakt, kunt u gegevensstroomtoewijzing gebruiken om data -objectvelden toe te wijzen aan XDM. Zowel gebruiken de uitbreiding van Analytics aan de uitbreiding van SDK van het Weben AppMeasurement aan de bibliotheek van JavaScript van SDK van het Webdit data voorwerp.
    • Adobe Analytics volledig overslaan: als u de SDK van het Web implementeert, kunt u die gegevens naar een dataset in Adobe Experience Platform verzenden voor gebruik in Customer Journey Analytics. U kunt elk schema gebruiken dat u bevalt. Adobe Analytics is helemaal niet betrokken bij deze workflow en vereist daarom niet de Adobe Analytics ExperienceEvent-veldgroep. Deze methode leidt tot het minste bedrag aan technische schulden, maar laat Adobe Analytics ook volledig buiten beeld.
IMPORTANT
Deze implementatiemethode vereist dat u een schema gebruikt dat voor Adobe Analytics is geconfigureerd. Als uw organisatie van plan is om uw eigen schema met Customer Journey Analytics in de toekomst te gebruiken, kan het gebruik van het schema van Adobe Analytics tot verwarring voor gegevensbeheerders of architecten leiden. Er zijn verschillende opties om dit probleem op te lossen:
  • U kunt het Adobe Analytics-schema in CJA gebruiken. Merk op dat CJA geen concept van steunen of eVars heeft; zij worden behandeld zoals een ander schemagebied. Houd er ook rekening mee dat het gebruik van het Adobe Analytics-schema in CJA het gebruik van andere platformservices, zoals Adobe Journey Optimizer of Real-time Customer Data Platform, kan bemoeilijken.
  • U kunt het gegevensobject gebruiken, net als een migratieworkflow. Merk op dat het gebruik van het gegevensvoorwerp vereist dat u elk gegevensobjecten gebied aan een XDM schemagebied in kaart brengt.
  • U kunt de Adobe Analytics-implementatie volledig overslaan en gegevens naar Adobe Experience Platform verzenden met uw eigen schema. Deze benadering is ideaal op lange termijn, en staat uw organisatie toe om Customer Journey Analytics te beginnen gebruiken.

Stappen die nodig zijn voor het implementeren van de Web SDK JavaScript-bibliotheek

Een overzicht op hoog niveau van de uitvoeringstaken:

hoe te om Adobe Analytics uit te voeren gebruikend het werkschema van SDK van het Web, zoals die in deze sectie wordt beschreven.

Taak
Meer informatie
1
Verzeker u een rapportreeks hebt bepaald.
Report Suite Manager
2
schema's van de Opstelling . Om gegevensinzameling voor gebruik over toepassingen te standaardiseren die hefboomwerking Adobe Experience Platform, heeft de Adobe de open en openbaar gedocumenteerde norm, het Model van de Gegevens van de Ervaring (XDM) gecreeerd.
Overzicht van de interface Schemas
3
creeer een gegevenslaag om het volgen van de gegevens op uw website te beheren.
Een gegevenslaag maken
4
installeer de prebuilt standalone versie . U kunt de bibliotheek (alloy.js) op CDN direct op uw pagina van verwijzingen voorzien of het downloaden en ontvangen op uw eigen infrastructuur. U kunt ook het NPM-pakket gebruiken.
Installerend de prebuilt standalone versieen Gebruikend het pakket NPM
5
vorm een datastream . Een gegevensstroom vertegenwoordigt de server-zijconfiguratie wanneer het uitvoeren van het Web SDK van Adobe Experience Platform.
Een gegevensstroom configureren
6
voeg de dienst van Adobe Analytics aan uw datastream toe. Deze service bepaalt of en hoe gegevens naar Adobe Analytics worden verzonden en naar welke rapportsuite(s) specifiek.
Adobe Analytics-service toevoegen aan een gegevensstroom
7
vorm SDK van het Web . Zorg ervoor dat de bibliotheek die u in stap 4 hebt geïnstalleerd, correct is geconfigureerd met de gegevensstroom-id (voorheen bekend als edge configuration id (datastreamId), organisatie-id (orgId ) en andere beschikbare opties. Zorgen voor juiste toewijzing van variabelen.
vorm SDK van het Web
XDM objecten veranderlijke afbeelding
8
voert bevelen en/of spoorgebeurtenissen uit. Nadat de basiscode op uw webpagina is geïmplementeerd, kunt u beginnen met het uitvoeren van opdrachten en het volgen van gebeurtenissen met de SDK.
Gebeurtenissen verzenden
9
breidt en bevestigt uw implementatie uit alvorens het uit aan productie te duwen.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690