DocumentatieExperience PlatformDoel migreren van at.js 2.x naar Web SDK

Zuiver Doel met het Web SDK van het Platform

Last update: Thu Oct 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • tussenpersoon
  • Ervaren
  • Ontwikkelaar

Het verifiëren van de activiteiten van het Doel en het zuiveren Web SDK om implementatie, inhoudslevering, of kwesties van de publiekskwalificatie problemen op te lossen. Deze pagina van de migratiegids verklaart de verschillen tussen het zuiveren met at.js en het Web SDK van het Platform.

De onderstaande tabel geeft een overzicht van functies en ondersteuning voor het testen en opsporen van fouten.

Functie of gereedschap
at.js-ondersteuning
Platform Web SDK-ondersteuning
Activiteit QA URLs
Ja
Ja
mboxDisable URL, parameter
Ja
Verwijs naar informatie hieronder aan onbruikbaar maken Functionaliteit van het Doel
mboxDebug URL, parameter
Ja
De parameter alloy_debug gebruiken voor vergelijkbare foutopsporingsgegevens
mboxTrace URL, parameter
Ja
De browserextensie van Foutopsporing voor Experience Platforms gebruiken
Adobe Experience Platform Debugger-extensie
Ja
Ja
alloy_debug URL, parameter
Niet van toepassing
Ja
Adobe Experience Platform Assurance
Niet van toepassing
Ja

Browserextensie Adobe Experience Platform Debugger

De extensie Adobe Experience Platform Debugger voor Chrome en Firefox controleert uw webpagina's en helpt u bij het valideren van uw Adobe Experience Cloud-implementaties.

U kunt Foutopsporing van het Platform op om het even welke Web-pagina in werking stellen en de uitbreiding heeft toegang tot openbare gegevens. Als u toegang wilt krijgen tot niet-openbare gegevens met de extensie, zoals gegevens over het doelspoor, moet u het Experience Cloud verifiëren via de koppeling Sign in .

Het Adobe Experience Platform Debugger ophalen en installeren

Het Adobe Experience Platform Debugger kan worden geïnstalleerd in Google Chrome- of Mozilla Firefox-browsers. Volg de onderstaande koppeling om de extensie te installeren in uw voorkeursbrowser:

Nadat u de Chrome-extensie of de Firefox-invoegtoepassing hebt geïnstalleerd, wordt een pictogram ( ) toegevoegd aan de uitbreidingsbalk. Selecteer dit pictogram om de extensie te openen.

Verwijs naar de specifieke gids voor meer informatie over de uitbreiding van het Adobe Experience Platform Debuggeren hoe te om alle toepassingen van het Web van de Adobe te zuiveren.

Voorvertoning van doelactiviteiten weergeven met URL's met kwaliteitscontrole

Zowel at.js als het Web SDK van het Platform staan u toe om de activiteiten van het Doel te voorproef gebruikend doel QA URLs, en beide implementatiemethodes steunen de zelfde eigenschappen QA.

Doel QA URLs die door at.js of het Web SDK van het Platform werken op te dragen om een specifiek koekje aan uw browser te schrijven genoemd at_qa_mode. Dit cookie wordt gebruikt om kwalificatie voor een bepaalde activiteit en ervaring af te dwingen.

CAUTION
De functionaliteit van de doel-QA-modus wordt ondersteund door Platform Web SDK versie 2.13.0 of hoger. De doel-QA-modus wordt ingeschakeld op basis van de xdm.web.webPageDetails.URL -waarde die wordt doorgegeven in de sendEvent -aanroep. Eventuele wijzigingen in deze waarde, zoals het verlagen van alle tekens, kunnen ertoe leiden dat de modus Doel-QA niet goed werkt.

Verwijs naar de specifieke gids voor meer informatie over activiteit QA van het Doel.

Implementatie van foutopsporing

De onderstaande tabel geeft een overzicht van de verschillen tussen de foutopsporingstactiek van at.js en Platform Web SDK:

at.js, functie
Platform Web SDK, equivalent
Mbox onbruikbaar maakt - maak Doel van het halen en het teruggeven onbruikbaar om te controleren als de pagina zonder de interactie van het Doel

pagina van de Lading met parameter URL wordt gebroken: mboxDisable=true
Geen direct equivalent. U kunt alle verzoeken van SDK van het Web van het Platform van het Platform met de ontwikkelaarshulpmiddelen van uw browser blokkeren.
Mbox zuivert - registreert elke actie at.js in de console van browser helpen het teruggeven problemen oplossen

pagina van de Lading met parameter URL: mboxDebug=true
Uitrusting zuivert - registreert gedetailleerde acties van SDK, met inbegrip van maar niet beperkt tot de verpersoonlijkingsacties van het Doel.

Laad pagina met URL parameter: alloy_debug=true

of voer alloy("setDebug", { "enabled": true }); in uw ontwikkelaarsconsole uit
Spoor van het Doel - met een symbolisch van het mboxspoor dat in het Doel UI wordt geproduceerd, is een spoorvoorwerp met details die aan het besluitvormingsproces deelnamen beschikbaar onder window.___target_trace voorwerp.

Laad pagina met parameter URL: mboxTrace=window&authorization={TOKEN}
Gebruik de Adobe Experience Platform Debugger uitbreiding of de Verzekering van het Platform.
NOTE
Alle hierboven vermelde foutopsporingsfuncties van at.js zijn beschikbaar met verbeterde mogelijkheden in Adobe Experience Platform Debugger.

Doelfunctionaliteit uitschakelen

De Platform Web SDK heeft momenteel geen eigenschap om de reacties van het Doel selectief te onderdrukken. Nochtans, is het mogelijk om de verzoeken van SDK van het Web van het Platform met de de ontwikkelaarshulpmiddelen van uw browser, diverse browser uitbreidingen, of derdetoepassingen te onderdrukken. Bijvoorbeeld, om het Web SDK van het Platform met Google Chrome te blokkeren:

  1. Klik overal op de pagina met de rechtermuisknop aan en selecteer Inspect
  2. Selecteer het lusje van het Netwerk
  3. Filteren op de tekenreeks //ee// om alleen de aanroepen van Platform Web SDK weer te geven
  4. De pagina opnieuw laden
  5. Klik met de rechtermuisknop op een van de gefilterde netwerkverzoeken en selecteer het aanvraagdomein van het Blok
  6. Laad de pagina opnieuw en merk op dat het netwerkverzoek wordt geblokkeerd
  7. Wanneer u gebeëindigd het zuiveren bent, klik het geblokkeerde netwerkverzoek met de rechtermuisknop aan en selecteer Unblock, of sluit het paneel van Hulpmiddelen van de Ontwikkelaar

Foutopsporingslogbestand weergeven

Foutopsporingsregistratie voor at.js met behulp van de URL-parameter mboxDebug=true geeft gedetailleerde informatie over elk verzoek, elke reactie en elke poging om de inhoud naar de pagina te renderen. De SDK van het Web van het platform heeft gelijkaardig zuivert registreren gebruikend de alloy_debug=true parameter URL.

Informatie geregistreerd
at.js (mboxDebug=true)
Platform Web SDK (alloy_debug=true)
Logboekvoorvoegsel voor filteren
AT:
[alloy]
Gegevens verzoek laden pagina
Ja
Ja
Gegevens over een box- of bereikverzoek
Ja
Ja
Status aanvragen
Ja
Ja
Antwoorddetails
Ja
Ja
Status van weergave
Succes en fouten
Alleen fouten
Details renderen
Ja
Ja
NOTE
Zuiver logboeken voor at.js en het Web SDK van het Platform verstrekken gelijkaardig niveau van detail met de opmerkelijke uitzondering dat het Web SDK slechts van het teruggeven van fouten wegens ongeldige selecteurs op de hoogte brengt. De logfunctie voor foutopsporing bevestigt momenteel niet dat rendering is gelukt.

Doelsporen weergeven

De doelsporen verstrekken gedetailleerde informatie over activiteitenkwalificaties en het profiel van het Doel van de bezoeker. Aangezien de sporen van het Doel informatie bevatten die niet openbaar beschikbaar is, vereist het bekijken van hen een toestemmingstoken of het voor authentiek verklaren binnen het browser van het Adobe Experience Platform Debugger uitbreidingsvenster.

Doeltraceermethode
at.js
Platform Web SDK
mboxTrace URL, parameter
Ja
Nee
Browserextensie Adobe Experience Platform Debugger
Ja
Ja
Adobe Experience Platform Assurance
Nee
Ja

Ga als volgt te werk om de sporen van het Doel van het Web SDK van het Platform met het Adobe Experience Platform Debugger weer te geven:

  1. Navigeer aan een pagina op uw plaats die Doel heeft uitgevoerd met het Web SDK van het Platform
  2. Open de uitbreiding van het Adobe Experience Platform Debugger door het pictogram ( ) in uw browser navigatiebar te selecteren
  3. De koppeling Sign In selecteren
  4. Verifiëren met uw Adobe Experience Cloud-aanmelding
  5. Selecteer links het tabblad Logs
  6. Selecteer de tab Edge bovenaan
  7. Geef uw foutopsporingssessie desgewenst een naam en klik op de knop Connect .
  8. Laad de pagina opnieuw en het logboek zou met gedetailleerde informatie over de interacties van het randnetwerk moeten bevolken
  9. Focus op de logitems die beginnen met "Doelsporen" in de beschrijving en selecteer View om de gegevens van het doelspoor weer te geven

hoe te om de sporen van het Doel met Adobe Experience Platform Debugger {modal="regular"} te bekijken

Nadat u View hebt geselecteerd, wordt een bedekking weergegeven waarmee u de volgende informatie over de aanvraag kunt zien:

  • Gelijktijdige activiteiten
  • Niet-afgedekte activiteiten
  • Gegevens aanvragen
  • Momentopname profiel

Verwijs naar de specifieke gids over het zuiveren de inhoudslevering van het Doelvoor meer informatie over de sporen van het Doel.

Problemen oplossen met Betrouwbaarheid

De informatie van het spoor van het doel is viewable in zowel de browser van het Adobe Experience Platform Debugger uitbreiding als binnen de toepassing van de Verzekering (vroeger gekend als Project Griffon). Ga als volgt te werk om de doelsporen in Verzekering weer te geven:

  1. Open de browserextensie van het Adobe Experience Platform Debugger en verbind een externe foutopsporingssessie zoals hierboven beschreven
  2. Selecteer de koppeling met uw sessienaam boven het foutopsporingslogbestand
  3. De Verzekering van het platform laadt en toont gedetailleerd registreren voor alle toepassingen van de Adobe die in de gegevensstroom voor uw implementatie worden gevormd
  4. Het logbestand filteren op adobe.target
  5. Selecteer een logbestandvermelding met het type com.adobe.target.trace
  6. Vouw de details van de lading uit en bekijk de informatie onder context > targetTrace

hoe te om de sporen van het Doel met Verzekering te bekijken {modal="regular"}

Onderzoek netwerkverzoek en reactie

De vraag van de verzoeklading en de reactie van het Web SDK van het Platform sendEvent verschillen van at.js. Het overzicht hieronder zou u moeten helpen de structuur van het verzoek en de reactie begrijpen terwijl het onderzoeken van de netwerkvraag met de ontwikkelaarshulpmiddelen van uw browser.

Payload voor inhoudsverzoek

Doel specifieke elementen van de nuttige lading van SDK van het Web van het Platform {modal="regular"}

  • Profiel, entiteit en andere niet-maboxparameters worden doorgegeven in de gebeurtenisarray onder data.__adobe.target
  • Beslissingsbereiken bevinden zich in de gebeurtenisarray onder query.personalization.decisionScopes
  • XDM-gegevens die aan mbox-parameters zijn toegewezen, bevinden zich in de gebeurtenissenarray onder xdm

Inhoudsresponsinstantie

Doel specifieke elementen van het de reactielichaam van SDK van het Web van het Platform {modal="regular"}

  • De Platform Web SDK keert acties voor alle Adobe toepassingen onder het handle voorwerp terug
  • De handeling personalization:decisions geeft een reactie van Doel of offer decisioning aan
  • Doelvoorstellingen worden weergegeven als een array, elk met een unieke propositie-id vooraf vastgelegd met AT:
  • Het bereik en de activiteitdetails van de beslissing zijn te vinden in de reeks voorstellen
  • De details van de aanbieding bevinden zich in de array items onder data
  • Responstkens bevinden zich in de array items onder meta .

Payload van Proposition-gebeurtenis

de voorstellingsgebeurtenisvoorbeeld van het Doel {modal="regular"}

  • Doelspecifieke SDK-gebeurtenissen zijn decisioning.propositionDisplay voor een indruk of decisioning.propositionInteract voor een interactie, zoals een klik
  • De details van de proposition-gebeurtenis bevinden zich in de gebeurtenisarray onder xdm._experience.decisioning
  • De propositie-id van de weergave- of interactiegebeurtenis moet overeenkomen met de propositie-id van de inhoud die door Doel wordt geretourneerd

Gefeliciteerd, u hebt het einde van de zelfstudie bereikt! Veel succes bij het migreren van uw Adobe Target-implementatie naar Web SDK!

NOTE
Wij zijn geëngageerd om u met uw migratie van het Doel van at.js aan Web SDK te helpen succesvol zijn. Als u in obstakels met uw migratie loopt of als er kritieke informatie ontbreekt in deze gids voelt, gelieve ons te vertellen door in deze communautaire besprekingte posten.
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110