DokumentationExperience PlatformMigrera mål från at.js 2.x till Web SDK

Debug Target with the Platform Web SDK

Last update: Tue Jan 20 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Mellanliggande
  • Erfaren
  • Utvecklare

Verifiera Target-aktiviteter och felsöka webb-SDK för att felsöka problem med implementering, innehållsleverans och målgruppskvalifikation. På den här sidan i migreringsguiden förklaras skillnaderna mellan felsökning med at.js och Platform Web SDK.

Tabellen nedan sammanfattar funktioner och stöd för testning och felsökning.

Funktion eller verktyg
support för at.js
Stöd för SDK
URL för aktivitets-QA
Ja
Ja
URL-parametern mboxDisable
Ja
Se informationen nedan för att inaktivera Target-funktionen
URL-parametern mboxDebug
Ja
Använd parametern alloy_debug för liknande felsökningsinformation
URL-parametern mboxTrace
Ja
Använda webbläsartillägget Experience Platform Debugger
Adobe Experience Platform Debugger-tillägg
Ja
Ja
URL-parametern alloy_debug
Ej tillämpligt
Ja
Adobe Experience Platform Assurance
Ej tillämpligt
Ja

Adobe Experience Platform Debugger webbläsartillägg

Adobe Experience Platform Debugger-tillägget för Chrome och Firefox undersöker dina webbsidor och hjälper dig att validera dina Adobe Experience Cloud-implementeringar.

Du kan köra Platform Debugger på valfri webbsida och tillägget har tillgång till publika data. Om du vill få åtkomst till icke-offentliga data med tillägget, till exempel målspårningsinformation, måste du autentisera till Experience Cloud via länken Sign in.

Hämta och installera Adobe Experience Platform Debugger

Adobe Experience Platform Debugger kan installeras i Google Chrome. Följ lämplig länk nedan för att installera tillägget:

När du har installerat tillägget Chrome eller tillägget Firefox läggs en ikon ( ) till i tilläggsfältet. Med den här ikonen öppnar du tillägget.

Mer information om Adobe Experience Platform Debugger-tillägget och hur du felsöker alla Adobe webbprogram finns i den dedikerade guiden.

Förhandsgranska målaktiviteter med QA-URL:er

Med både at.js och Platform Web SDK kan du förhandsgranska Target-aktiviteter med hjälp av Target QA-URL:er, och båda implementeringsmetoderna har stöd för samma QA-funktioner.

Ange QA-URL:er som ska arbeta genom att instruera på.js eller Platform Web SDK att skriva en specifik cookie till din webbläsare med namnet at_qa_mode. Denna cookie används för att framtvinga kvalificering för en viss aktivitet och upplevelse.

CAUTION
Funktionen för mål-QA-läge stöds av Platform Web SDK version 2.13.0 eller senare. Mål-QA-läget är aktiverat baserat på det xdm.web.webPageDetails.URL-värde som skickades i sendEvent-anropet. Om du ändrar det här värdet, till exempel tar bort alla tecken, kan det medföra att mål-QA-läget inte fungerar som det ska.

Mer information om Målaktivitet QA finns i den dedikerade guiden.

Implementering av felsökningsmål

Tabellen nedan visar skillnaderna mellan felsökningsmetoderna at.js och Platform Web SDK:

at.js, funktion
SDK-motsvarighet för plattformar
Mbox Inaktivera - Inaktivera mål från hämtning och återgivning för att kontrollera om sidan har brutits utan målinteraktioner

Läs in sida med URL-parameter: mboxDisable=true
Ingen direkt motsvarighet. Du kan blockera alla förfrågningar från Platform Web SDK med utvecklarverktygen i din webbläsare.
Mbox Debug - loggar alla at.js-åtgärder i webbläsarens konsol för att felsöka återgivningsproblem

Läs in sida med URL-parameter: mboxDebug=true
Tillåt felsökning - loggar detaljerade åtgärder för SDK, inklusive men inte begränsat till Target-personaliseringsåtgärder.

Läs in sida med URL-parameter: alloy_debug=true

Eller kör alloy("setDebug", { "enabled": true }); i utvecklarkonsolen
Målspårning - med en mbox-spårningstoken genererad i målgränssnittet, är ett trace-objekt med information som har deltagit i beslutsprocessen tillgängligt under objektet window.___target_trace.

Läs in sida med URL-parameter: mboxTrace=window&authorization={TOKEN}
Använd Adobe Experience Platform felsökningstillägg eller Platform Assurance.
NOTE
Alla felsökningsfunktionerna i at.js ovan är tillgängliga med de förbättrade funktionerna i Adobe Experience Platform Debugger.

Inaktivera Target-funktioner

Platform Web SDK har för närvarande ingen funktion för att selektivt undertrycka Target-svar. Det är dock möjligt att inaktivera Platform Web SDK-begäranden med webbläsarens utvecklarverktyg, olika webbläsartillägg eller tredjepartsprogram. Om du till exempel vill blockera Platform Web SDK med Google Chrome:

  1. Högerklicka någonstans på sidan och välj Inspektera
  2. Välj fliken Nätverk
  3. Filtrera efter strängen //ee// så att endast SDK-anrop för plattformen visas
  4. Läs in sidan igen
  5. Högerklicka på en av de filtrerade nätverksförfrågningarna och välj Blockera begärandedomän
  6. Läs in sidan igen och observera att nätverksbegäran har blockerats
  7. När du är klar med felsökningen högerklickar du på den blockerade nätverksbegäran och väljer Ta bort blockering eller stänger panelen Utvecklingsverktyg

Visa felsökningsloggning

Felsökningsloggning för at.js med URL-parametern mboxDebug=true visar detaljerad information om varje Target-begäran, svar och försök att återge innehållet på sidan. SDK för plattformen har liknande felsökningsloggning med URL-parametern alloy_debug=true.

Loggad information
at.js (mboxDebug=true)
Plattform, SDK (alloy_debug=true)
Loggningsprefix för filtrering
AT:
[alloy]
Information om sidinläsningsbegäran
Ja
Ja
Mbox eller scope request details
Ja
Ja
Status för förfrågan
Ja
Ja
Svarsinformation
Ja
Ja
Återgivningsstatus
Slutförda och fel
Endast fel
Återgivningsinformation
Ja
Ja
NOTE
Felsökningsloggar för at.js och Platform Web SDK ger en liknande detaljnivå med det anmärkningsvärda undantaget att Web SDK endast meddelar om återgivningsfel på grund av ogiltiga väljare. Felsökningsloggningen bekräftar för närvarande inte att återgivningen lyckades.

Visa målspår

Målspår innehåller detaljerad information om aktivitetskvalifikationer och besökarens Target-profil. Eftersom målspårningar innehåller information som inte är allmänt tillgänglig, krävs en verifieringstoken eller autentisering i Adobe Experience Platform Debugger webbläsartillägg för att visa dem.

Målspårningsmetod
at.js
Platform Web SDK
URL-parametern mboxTrace
Ja
Nej
Adobe Experience Platform Debugger webbläsartillägg
Ja
Ja
Adobe Experience Platform Assurance
Nej
Ja

Så här visar du spårningar för Platform Web SDK Target med Adobe Experience Platform Debugger:

  1. Navigera till en sida på din webbplats som har Target implementerat med Platform Web SDK
  2. Öppna Adobe Experience Platform Debugger-tillägget genom att markera ikonen ( ) i webbläsarens navigeringsfält
  3. Markera länken Sign In
  4. Autentisera med din Adobe Experience Cloud-inloggning
  5. Välj fliken Logs till vänster
  6. Välj fliken Edge högst upp
  7. Du kan även ge felsökningssessionen ett namn och klicka på knappen Connect
  8. Läs in sidan igen så fylls loggen i med detaljerad information om gränsnätverkets interaktioner
  9. Fokusera på loggposterna som börjar med Målspår i beskrivningen och välj View om du vill visa information om målspårning

Så här visar du målspår med Adobe Experience Platform Debugger {modal="regular"}

När du har valt View visas en övertäckning som gör att du kan se följande information om begäran:

  • Matchade aktiviteter
  • Oöverträffade aktiviteter
  • Information om förfrågan
  • Ögonblicksbild av profil

Mer information om målspår finns i den dedikerade guiden om felsökning av leverans av målinnehåll.

Felsök med Assurance

Målspårningsinformation kan visas både i webbläsartillägget för Adobe Experience Platform Debugger och i Assurance (tidigare kallat Project Griffon). Så här visar du målspår i Assurance:

  1. Öppna Adobe Experience Platform Debugger webbläsartillägg och anslut en fjärrfelsökningssession enligt ovan
  2. Markera länken med ditt sessionsnamn ovanför felsökningsloggen
  3. Platform Assurance läser in och visar detaljerad loggning för alla Adobe-program som konfigurerats i dataströmmen för din implementering
  4. Filtrera loggen efter adobe.target
  5. Välj en loggpost med typen com.adobe.target.trace
  6. Expandera informationen om nyttolasten och visa informationen under context > targetTrace

Så här visar du målspår med Assurance {modal="regular"}

Undersök nätverksbegäran och svar

Nyttolasten för och svaret på begäran för SDK sendEvent-anropen för plattformen skiljer sig från at.js. Med hjälp av konturen nedan kan du förstå hur begäran och svaret är upplagda samtidigt som du undersöker nätverksanropen med webbläsarens utvecklingsverktyg.

Nyttolast för innehållsbegäran

Målspecifika element för SDK-nyttolasten för Platform Web {modal="regular"}

  • Profil, entitet och andra icke-mbox-parametrar skickas i händelsearrayen under data.__adobe.target
  • Beslutsomfattningarna finns i händelsearrayen under query.personalization.decisionScopes
  • XDM-data som mappas till mbox-parametrar längre ned finns i händelsearrayen under xdm

Innehållssvarets brödtext

Målspecifika element i SDK-svarstexten för plattformen {modal="regular"}

  • Platform Web SDK returnerar åtgärder för alla Adobe-program under objektet handle
  • Åtgärden personalization:decisions innebär ett svar från Target eller erbjudandebeslut
  • Målförslag presenteras som en matris, där vart och ett har ett unikt förslags-ID med prefixet AT:
  • Beslutsomfattandet och aktivitetsinformationen finns i förslagsarrayen
  • Erbjudandeinformationen finns i arrayen items under data
  • Svarstoken finns i items-matrisen under meta

Sprid händelsens nyttolast

Exempel på händelse för målprojektion {modal="regular"}

  • Målspecifika SDK-händelser är antingen decisioning.propositionDisplay för ett intryck eller decisioning.propositionInteract för en interaktion, till exempel ett klick
  • Information om händelsen proposition finns i arrayen events under xdm._experience.decisioning
  • Förslags-ID för visnings- eller interaktionshändelsen ska matcha förslags-ID för innehållet som returneras från Target

Grattis, du har kommit till slutet av självstudiekursen! Lycka till med att migrera din Adobe Target-implementering till Web SDK!

NOTE
Vi vill hjälpa dig att lyckas med din Target-migrering från at.js till Web SDK. Om du stöter på problem med din migrering eller om du känner att det saknas viktig information i den här guiden kan du meddela oss genom att publicera den här communitydiskussionen.
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110