Migreren van de Adobe Analytics-tagextensie naar de Web SDK-tagextensie

Dit implementatiepad omvat een methodische migratiebenadering om van de Adobe Analytics-tagextensie naar de Web SDK-tagextensie te gaan. Andere implementatiepaden worden op afzonderlijke pagina's behandeld:

  • AppMeasurement naar Web SDK JavaScript-bibliotheek: Een vloeiende en methodische aanpak voor het migreren naar de SDK van het Web, behalve dat er geen tags worden gebruikt. In plaats daarvan verwijdert u handmatig de Adobe Analytics-bibliotheek voor gegevensverzameling (AppMeasurement.js) en deze vervangen door de Web SDK JavaScript-bibliotheek (alloy.js).
  • Web SDK-tagextensie: Een nieuwe Web SDK-installatie waarin 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.
  • Web SDK JavaScript-bibliotheek: Een nieuwe Web SDK-installatie met de Web SDK JavaScript-bibliotheek (alloy.js). Beheer de implementatie zelf in plaats van de gebruikersinterface voor tags te gebruiken. Hiervoor is de Adobe Analytics ExperienceEvent-veldgroep vereist, die typische analytische variabelen bevat die in uw XDM-schema moeten worden opgenomen.

Voordelen en nadelen van dit implementatiepad

Het gebruik van deze migratiebenadering heeft zowel voor- als nadelen. Let zorgvuldig op elke optie om te bepalen welke benadering het beste is voor uw organisatie.

Voordelen
Nadelen
  • Geen code gewijzigd op uw site: Aangezien voor uw implementatie al tags zijn geïnstalleerd, kunnen alle migratie-updates worden uitgevoerd in de taginterface.
  • Gebruikt uw bestaande implementatie: Voor deze aanpak is geen netto nieuwe implementatie nodig. Terwijl het nieuwe regelacties vereist, kunt u uw bestaande gegevenselementen en regelvoorwaarden met minimale veranderingen opnieuw gebruiken.
  • Geen schema vereist: Voor dit stadium van het migreren aan het Web SDK, hebt u geen schema XDM nodig. In plaats daarvan kunt u de data -object, dat gegevens rechtstreeks naar Adobe Analytics verzendt. Zodra de migratie naar SDK van het Web volledig is, dan kunt u een schema voor uw organisatie tot stand brengen en gegevensstroomafbeelding gebruiken om toepasselijke gebieden te bevolken XDM. Als een schema in dit stadium van het migratieproces werd vereist, zou uw organisatie worden gedwongen om een Adobe Analytics XDM schema te gebruiken. Het gebruik van dit schema maakt het voor uw organisatie moeilijker om uw eigen schema in de toekomst te gebruiken.
  • Technische schuld implementeren: Aangezien deze benadering een gewijzigde vorm van uw bestaande implementatie gebruikt, kan het moeilijker zijn om implementatielogica te volgen en veranderingen uit te voeren wanneer nodig. De code van de douane kan bijzonder moeilijk zijn om te zuiveren.
  • Vereist toewijzing om gegevens naar Platform te verzenden: Wanneer uw organisatie klaar is om Customer Journey Analytics te gebruiken, moet u gegevens naar een gegevensset in Adobe Experience Platform verzenden. Deze handeling vereist dat elk veld in het dialoogvenster data -object is een item in het hulpprogramma voor gegevenstoewijzing dat het toewijst aan een XDM-schemaveld. Voor deze workflow hoeft u slechts één keer toewijzingen uit te voeren, en dit betekent niet dat u implementatiewijzigingen aanbrengt. Het is echter een extra stap die niet vereist is bij het verzenden van gegevens in een XDM-object.

De Adobe beveelt aan dit implementatiepad in de volgende scenario's te volgen:

  • U hebt een bestaande implementatie met de Adobe Analytics-tagextensie. Als u een implementatie met AppMeasurement hebt, volgt u Migreren van AppMeasurement naar de Web SDK in plaats daarvan.
  • U bent van plan om Customer Journey Analytics in de toekomst te gebruiken, maar wilt uw implementatie Analytics niet met een implementatie van SDK van het Web van kras vervangen. Het vervangen van uw implementatie van kras op het Web SDK vereist de meeste inspanning, maar ook biedt de meest levensvatbare implementatiearchitectuur op lange termijn aan. Als uw organisatie bereid is door de inspanning van een schone implementatie van SDK van het Web te gaan, zie Gegevens invoeren via de Adobe Experience Platform Web SDK in de gebruikershandleiding van de Customer Journey Analytics.

Stappen vereist om naar SDK van het Web te migreren

De volgende stappen bevatten concrete doelstellingen die moeten worden nagestreefd. Klik op elke stap voor gedetailleerde instructies over hoe u deze kunt uitvoeren.

1. Een gegevensstroom maken en configureren

Maak een gegevensstroom in de gegevensverzameling van Adobe Experience Platform. Wanneer u gegevens naar deze gegevensstroom verzendt, stuurt het gegevens door naar Adobe Analytics. In de toekomst stuurt dezelfde gegevensstroom gegevens door naar de Customer Journey Analytics.

  1. Navigeren naar experience.adobe.com en meld u aan met uw referenties.
  2. Gebruik de homepage of productkiezer in de rechterbovenhoek om naar Data Collection.
  3. Selecteer in de linkernavigatie de optie Datastreams.
  4. Selecteren New Datastream.
  5. Voer de gewenste naam in en selecteer Save.
  6. Wanneer de gegevensstroom is gemaakt, selecteert u Add Service.
  7. Selecteer in het vervolgkeuzemenu Service de optie Adobe Analytics.
  8. Voer dezelfde rapportsuite-id in als de site waarnaar u momenteel analysegegevens verzendt. Klik op Save.

Adobe Analytics-service toevoegen

Uw gegevensstroom is nu klaar om gegevens te ontvangen en door te geven aan Adobe Analytics.

2. Voeg de uitbreiding van SDK van het Web aan uw markeringsbezit toe

Deze sectie bereidt uw markering voor het grootste deel van de migratieinspanning die in de volgende stap plaatsvindt.

  1. Klik op het hamburgerpictogram linksboven in de Adobe Experience Platform-interface en selecteer vervolgens Tags.

  2. Selecteer de gewenste eigenschap tag.

  3. Selecteer in de linkernavigatie van de eigenschap tag de optie Extensions.

  4. Selecteren Catalog boven aan het scherm ziet u een lijst met alle beschikbare extensies.

  5. Zoeken naar en selecteren de Adobe Experience Platform Web SDK extensie, en klik vervolgens op Install rechts.

    Catalogus

  6. De instellingen voor de extensieconfiguratie worden weergegeven. Zoek de sectie Gegevensstromen en selecteer de gegevensstroom die u in de vorige stap hebt gemaakt.

    Gegevensstroom selecteren

  7. Selecteren Save.

Uw markeringsbezit heeft nu het Web SDK geïnstalleerd.

3. Een gegevenselement voor een gegevensobject maken

Het gegevenselement van gegevensobjecten verstrekt een intuïtief kader om een nuttige lading te vormen die SDK van het Web gebruikt om naar een gegevensstroom te verzenden. De meeste regels die u in de volgende stap bijwerkt, beïnvloeden dit gegevenselement.

  1. Selecteer in de linkernavigatie van de taginterface de optie Data Elements.

  2. Selecteren Add Data Element

  3. Geef het gegevenselement de volgende instellingen:

    • Name: Alles wat u wilt, zoals "Gegevenslaag" of "Gegevensobject"
    • Extension: Adobe Experience Platform Web SDK
    • Data Element Type: Variable
    • Selectievakjes kunnen ongewijzigd blijven
  4. Selecteer rechts de volgende instellingen:

    • Keuzerondje eigenschap: Data
    • Oplossing: Adobe Analytics
  5. Selecteren Save.

Gegevenselement maken

Uw markeringsbezit heeft nu alles nodig om elke regel bij te werken.

4. De regels van de update om de uitbreiding van SDK van het Web in plaats van de uitbreiding van Analytics te gebruiken

Deze stap bevat het grootste deel van de inspanning die wordt vereist om aan het Web SDK te migreren, en vereist kennis van hoe uw implementatiewerk. Hieronder ziet u een voorbeeld van het bewerken van een standaardlabelregel. Werk alle markeringsregels in uw implementatie bij om alle verwijzingen naar de uitbreiding van Adobe Analytics met de uitbreiding van SDK van het Web te vervangen.

  1. Selecteer in de linkernavigatie van de taginterface de optie Rules.

  2. Selecteer een regel die u wilt bewerken.

  3. Selecteer de handeling Adobe Analytics - Set Variables

  4. Noteer alle variabelen van Analytics die binnen deze regel worden ingesteld. Neem zowel variabelen op die zijn ingesteld in de vervolgkeuzemenu's als variabelen die zijn ingesteld in de aangepaste code.

  5. Wijzig de Action Configuration naar de volgende instellingen:

    • Extension: Adobe Experience Platform Web SDK
    • Action type: variabele bijwerken
  6. Zorg ervoor dat het gegevensobject is geselecteerd in de vervolgkeuzelijst aan de rechterkant.

  7. Stel de variabelen voor Analytics in op dezelfde waarden als deze zijn geconfigureerd in de extensie Analytics.

    • Variabelen die zijn ingesteld binnen de taginterface, kunnen rechtstreeks naar dezelfde waarden worden vertaald.
    • Tekenreeksvariabelen die zijn ingesteld in aangepaste code vereisen minimale aanpassingen. In plaats van de s object, gebruiken data.__adobe.analytics in plaats daarvan. Bijvoorbeeld: s.eVar1 zou vertalen naar data.__adobe.analytics.eVar1.
    • De de configuratievariabelen van Analytics en methodevraag in douanecode kunnen gewijzigde implementatielogica vereisen. Zie elk variabel om te bepalen hoe te om zijn equivalent te bereiken gebruikend het Web SDK.
  8. Zodra alle regellogica gebruikend de uitbreiding van SDK van het Web wordt herhaald, uitgezocht Keep Changes.

  9. Herhaal deze stappen voor elke actieconfiguratie die de extensie Adobe Analytics gebruikt om waarden in te stellen. Deze stap bevat zowel variabelen die zijn ingesteld met de taginterface als variabelen die zijn ingesteld met aangepaste code. Aangepaste codeblokken kunnen niet verwijzen naar s object op een willekeurige locatie.

De bovenstaande stappen zijn alleen van toepassing op regels die waarden instellen. De volgende stappen vervangen alle acties die Action Configuration Send Beacon.

  1. Selecteer een regel die een baken verzendt.

  2. Selecteer de handeling Adobe Analytics - Send Beacon.

  3. Noteer de huidige waarde van het dialoogvenster Tracking keuzerondje rechts (s.t() of s.tl()).

  4. Wijzig de Action Configuration naar de volgende instellingen:

    • Extension: Adobe Experience Platform Web SDK
    • Action type: Send event
  5. Wijzig rechts de handelingsinstellingen in het volgende:

    • Type: For s.t(), gebruik Web Webpagedetails Page Views. Voor s.tl(), gebruik Web Webinteraction Link Clicks. Als u s.tl(), moet u ook de volgende velden in het gegevensobject opnemen. Deze velden worden weergegeven onder Additional properties bij het uitvoeren van de Update variable actieconfiguratie:

  6. Selecteren Keep Changes.

  7. Herhaal deze stappen voor elke actieconfiguratie die Adobe Analytics gebruikt om een baken te verzenden.

5. Bijgewerkte regels publiceren

Het publiceren van bijgewerkte regels volgt de zelfde werkschema zoals om het even welke andere verandering in uw markeringsconfiguratie.

  1. Selecteer in de linkernavigatie van de taginterface de optie Publishing Flow.
  2. Selecteren Add Library.
  3. Geef deze tag een naam, zoals "Upgrade to Web SDK".
  4. Selecteren Add All Changed Resources.
  5. Selecteren Save.
  6. In de publicatieworkflow wordt een oranje stip weergegeven die aangeeft dat deze aan het bouwen is. Als de punt groen wordt, zijn de wijzigingen beschikbaar in uw ontwikkelomgeving.
  7. Test uw veranderingen in uw ontwikkelomgeving om ervoor te zorgen dat alle regels behoorlijk vuren, en dat het gegevensvoorwerp met verwachte waarden bevolkt is.
  8. Als u klaar bent, dient u de bibliotheek ter goedkeuring in, bouwt u de bibliotheek naar de testfase, keurt u de bibliotheek goed en publiceert u de bibliotheek naar de productie.

Publicatiestroom

6. De extensie Analytics uitschakelen

Zodra uw markeringsimplementatie volledig op het Web SDK is, kunt u de uitbreiding van Adobe Analytics onbruikbaar maken.

  1. Selecteer in de linkernavigatie van de taginterface de optie Extensions.
  2. Zoek en selecteer de Adobe Analytics extensie. Selecteer rechts Disable.
  3. Volg dezelfde publicatieworkflow hierboven om het verwijderen van de Adobe Analytics extensie.
  4. Als de extensie eenmaal is uitgeschakeld in de productie, kunt u deze volledig verwijderen. Selecteer de extensie, selecteer het menu met drie punten rechts en selecteer vervolgens Uninstall.
  5. Volg dezelfde publicatieworkflow hierboven om deze wijzigingen in de productie te publiceren.

Op dit punt, is uw implementatie van Analytics volledig op het Web SDK en is voldoende bereid om aan Customer Journey Analytics in de toekomst te bewegen.

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690