Werk uw bibliotheek van de gegevensinzameling voor Audience Manager van de de markeringsuitbreiding van de Audience Manager aan de de markeringsuitbreiding van SDK van het Web bij

Beoogd publiek

Deze pagina is bedoeld voor klanten van de Audience Manager die het Audience Manager, tagextensie om gegevens van webverzamelingen in Audience Manager te brengen. Voor klanten die de AppMeasurement JavaScript bibliotheek gebruiken, gelieve de gids over hoe te om uw bibliotheek van de gegevensinzameling voor Audience Manager bij te werken vanuit de JavaScript-bibliotheek van het AppMeasurement naar de JavaScript-bibliotheek van de Web SDK.

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 Audience Manager 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 Audience Manager 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: Als uw organisatie klaar is om Real-Time CDP 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.

Adobe raadt u aan dit implementatiepad te volgen als u een bestaande implementatie hebt met de Adobe Audience Manager-tagextensie.

Stappen vereist om naar SDK van het Web te migreren

De volgende stappen bevatten concrete doelstellingen die moeten worden nagestreefd. Selecteer elke stap voor gedetailleerde instructies over hoe te om het te verwezenlijken.

1. Een gegevensstroom maken en configureren

Volg de onderstaande instructies om een gegevensstroom te maken in de gegevensverzameling van Adobe Experience Platform. Wanneer u gegevens naar deze gegevensstroom verzendt, stuurt het gegevens door naar de Audience Manager. In de toekomst stuurt dezelfde gegevensstroom gegevens door naar Real-Time CDP.

  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 Audience Manager.

  8. Zorg ervoor dat de Enable XDM Flattened Fields is uitgeschakeld.

    Audience Manager-service toevoegen

Uw gegevensstroom is nu klaar om gegevens te ontvangen en door te geven aan Audience Manager.

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. Selecteer 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 selecteert u vervolgens Install aan de rechterkant.

    Catalogus

  6. De instellingen voor de extensieconfiguratie worden weergegeven. Zoek de Datastreams en selecteert u de sandbox die u gebruikt en 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 de volgende instellingen aan de rechterkant:

    • Keuzerondje eigenschap: Data
    • Solution: Adobe Audience Manager
  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 de Audience Manager 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 de Audience Manager 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 Audience Manager - Set Variables

  4. Noteer alle variabelen van de Audience Manager die in deze regel zijn 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 dat u in stap 3 hebt gemaakt, is geselecteerd in het keuzemenu rechts in het dialoogvenster Data element veld.

  7. Plaats de sleutel-waardeparen van de Audience Manager aan hun zelfde respectieve waarden zoals zij in de uitbreiding van de Audience Manager werden gevormd.

  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 de markeringsuitbreiding van de Audience Manager gebruikt om waarden te plaatsen.

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

  1. Selecteer een regel die een Web SDK-gebeurtenis verzendt.

  2. Het handelingstype selecteren Send Event.

  3. Wijzig de Action Configuration naar de volgende instellingen:

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

    • Type: Gebruik Web Webpagedetails Page Views.
    • Data: Selecteer het gegevensobject dat u in stap 3 hebt gemaakt.
  5. Selecteren Keep Changes.

  6. Herhaal deze stappen voor elke actieconfiguratie die Audience Manager gebruikt om een gebeurtenis 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. Audience Manager-extensie uitschakelen

Zodra uw markeringsimplementatie volledig aan het Web SDK wordt gemigreerd, kunt u de uitbreiding van de Audience Manager onbruikbaar maken.

  1. Selecteer in de linkernavigatie van de taginterface de optie Extensions.
  2. Zoek en selecteer de Audience Manager extensie. Selecteer rechts Disable.
  3. Volg dezelfde publicatieworkflow hierboven om het verwijderen van de Audience Manager 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, wordt uw implementatie van de Audience Manager volledig gemigreerd aan het Web SDK en is bereid om zich aan Real-Time CDP in de toekomst te bewegen.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695