Werk uw bibliotheek van de gegevensinzameling voor Audience Manager van de bibliotheek van AppMeasurement JavaScript aan de bibliotheek van SDK JavaScript van het Web bij
Beoogd publiek intended-audience
Deze pagina is bedoeld voor klanten van de Audience Manager die AppMeasurement gebruiken om de gegevens van de Webinzameling in Audience Manager te brengen. Voor klanten die Audience Manager, tagextensie, lees de handleiding over het bijwerken van de bibliotheek voor gegevensverzameling voor Audience Manager van de de markeringsuitbreiding van de Audience Manager aan de de markeringsuitbreiding van SDK van het Web.
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.
- Gebruikt uw bestaande implementatie: Hoewel deze aanpak enige wijzigingen in de implementatie vereist, is er geen volledig nieuwe implementatie nodig. U kunt uw bestaande gegevenslaag en code met minimale veranderingen in implementatielogica 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 de 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 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 in de toekomst uit te voeren wanneer nodig.
- 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.
De Adobe beveelt aan dit implementatiepad in de volgende scenario's te volgen:
- U hebt een bestaande implementatie met de Adobe Analytics AppMeasurement JavaScript-bibliotheek. Als u een implementatie hebt met de tagextensie Audience Manager, volgt u Migreren van de tagextensie Audience Manager naar de webSDK-tagextensie in plaats daarvan.
- U bent van plan om Real-Time CDP in de toekomst te gebruiken, maar wilt niet uw implementatie van de Audience Manager 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 Web SDK-documentatie voor meer informatie .
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.
Maak een gegevensstroom 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.
-
Navigeren naar experience.adobe.com en meld u aan met uw referenties.
-
Gebruik de homepage of productkiezer in de rechterbovenhoek om naar Data Collection.
-
Selecteer in de linkernavigatie de optie Datastreams.
-
Selecteren New Datastream.
-
Voer de gewenste naam in en selecteer Save.
-
Wanneer de gegevensstroom is gemaakt, selecteert u Add Service.
-
Selecteer in het vervolgkeuzemenu Service de optie Audience Manager.
Uw gegevensstroom is nu klaar om gegevens te ontvangen en door te geven aan Audience Manager. Noteer de gegevensstroom-id, aangezien deze id vereist is voor het configureren van de Web SDK in code.
alloy.js
zo kan zijn methodevraag worden gebruikt.Opstelling uw implementatie om aan de datastream te richten die in stap 1 wordt gecreeerd door het Web SDK te gebruiken configure
gebruiken. De configure
moet op elke pagina worden ingesteld, zodat u deze naast de installatiecode van de bibliotheek kunt plaatsen.
Gebruik de edgeConfigId
en orgId
eigenschappen binnen de Web SDK configure
opdracht:
- Stel de
edgeConfigId
naar de gegevensstroom-id die u hebt opgehaald uit de vorige stap. - Stel de
orgId
naar de IMS org-id van uw organisatie.
code language-js |
---|
|
U kunt desgewenst andere eigenschappen instellen in het dialoogvenster configure
afhankelijk van de implementatievereisten van uw organisatie.
Verander uw implementatie van de Audience Manager zodat het niet op baseert AppMeasurement.js
of de s
object. In plaats daarvan kunt u variabelen instellen in een JavaScript-object met de juiste indeling. Dit object wordt omgezet in een JSON-object wanneer het naar de Adobe wordt verzonden. Met een gegevenslaag op uw site helpt u enorm bij het instellen van waarden, aangezien u kunt blijven verwijzen naar dezelfde waarden.
Om gegevens naar Audience Manager te verzenden, moet de nuttige lading van SDK van het Web gebruiken data.__adobe.audiencemanager
met alle analytische variabelen die binnen dit object zijn ingesteld. Variabelen in dit object hebben dezelfde namen en indelingen als de variabele tegenhangers van het AppMeasurement. Als u bijvoorbeeld de opdracht products
variabele, niet in individuele voorwerpen verdelen zoals u met XDM zou doen. In plaats daarvan neemt u de eigenschap als tekenreeks op als u de instelling s.products
variabele:
code language-json |
---|
|
Uiteindelijk bevat deze lading alle gewenste waarden, en alle verwijzingen naar s
-object in uw implementatie wordt verwijderd. U kunt alle bronnen die JavaScript biedt, gebruiken om dit payload-object in te stellen, inclusief puntnotatie voor het instellen van individuele waarden.
code language-js |
---|
|
Werk alle instanties bij waar u roept s.t()
en s.tl()
, die worden vervangen door de sendEvent
gebruiken. Er zijn drie scenario's om te overwegen:
-
Paginaweergave bijhouden: Vervang de volgende vraag van de paginamening met het Web SDK
sendEvent
opdracht:code language-js // If your current implementation has this line of code: s.t(); // Replace it with this line of code. The dataObj object contains the variables to send. alloy("sendEvent", dataObj);
-
Automatisch koppelingen bijhouden: De
clickCollectionEnabled
configuratie-eigenschap is standaard ingeschakeld. De juiste variabelen voor het bijhouden van koppelingen worden automatisch ingesteld om gegevens naar de Audience Manager te verzenden. Als u automatische koppeling bijhouden wilt uitschakelen, stelt u deze eigenschap in opfalse
binnen deconfigure
gebruiken. -
Handmatige koppeling bijhouden: De SDK van het Web heeft geen afzonderlijke bevelen tussen de vraag van de paginalevening en niet van de paginaleving. Geef dat onderscheid op in het object payload.
code language-js // If your current implementation has this line of code: s.tl(true,"o","Example custom link"); // Replace it with these lines of code. Add the required fields to the dataObj object. dataObj.data.__adobe.audiencemanager.linkName = "Example custom link"; dataObj.data.__adobe.audiencemanager.linkType = "o"; dataObj.data.__adobe.audiencemanager.linkURL = "https://example.com"; alloy("sendEvent", dataObj);
Als u alle verwijzingen naar het AppMeasurement en de s
-objecten, publiceert u uw wijzigingen in uw ontwikkelomgeving om te controleren of de nieuwe implementatie werkt. Nadat u hebt gecontroleerd dat alles correct werkt, kunt u uw updates publiceren voor productie.
Als de migratie correct is, AppMeasurement.js
is niet meer vereist op uw site en alle verwijzingen naar dit script kunnen worden verwijderd.
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.