DokumentationExperience PlatformAnvändarhandbok om webb-SDK

Frågor och svar

Last update: Fri Apr 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Developer

Den här guiden ger svar på frågor om Adobe Experience Platform Web SDK.

Vad är Adobe Experience Platform Web SDK?

Adobe Experience Platform Web SDK är ett JavaScript-bibliotek på klientsidan som gör att du kan interagera med de olika tjänsterna i Adobe Experience Cloud.

Web SDK skickar data på ett lösningsagnostiskt sätt (XDM) till Experience Platform Edge Network, som sedan mappar data till lösningsspecifika format och destinationer och skickar dem i realtid.

I följande video finns mer information om Web SDK: Möt Alloy.js och Aldrig tagg för en eVar eller Mbox Igen.

Hur skiljer sig Adobe Experience Platform Web SDK från tidigare lösningar?

Före Experience Platform Web SDK

För närvarande måste du distribuera olika JavaScript-bibliotek baserat på varje enskild lösning.

  • Varje lösning har ett eget JavaScript-bibliotek, -schema och -domän.
  • Inget av dessa bibliotek har tagits fram för att fungera tillsammans.
  • Samlingslösningar och Adobe Experience Platform-fall kräver att dessa olika bibliotek är beroende av varandra, vilket ger rörelsefrihet vid driftsättningen.

Även om taggar i Platform gör det så enkelt att driftsätta och hantera dessa bibliotek finns det fortfarande problem med:

  • Biblioteksstorlek (för mycket Adobe-kod på en sida)
  • Prestanda (det tar för lång tid att läsa in webbplatser)
  • Flera anrop till ett och samma ärende
  • Väntar på ECID-retur före personaliseringsanrop (orsakar fördröjning)
  • Fraktad datainsamling (vad är en evar?)
  • Schemaförväxling mellan lösningar (A4T)
  • Många andra mindre optimala saker

Dessutom finns det för närvarande inget JavaScript-bibliotek som skickar data direkt till Adobe Experience Platform.

Med Experience Platform Web SDK

Nya Web SDK skickar data för följande lösningar till ett enda mål (Experience Platform Edge Network) och löser de vanligaste användningsområdena för de ovannämnda lösningarna.

  • Adobe Analytics
  • Adobe Audience Manager
  • Adobe Target
  • Besökar-ID
  • Adobe Experience Platform

Andra lösningar kommer att följa.

Adobe Experience Platform Web SDK kan även skicka data direkt till Adobe Experience Platform. Dessa data är i XDM-format och mappas till lösningsschemat på serversidan.

Vad är värdet med nya Web SDK?

Prestanda: SDK för webben är mindre än för alla Adobe-bibliotek och ger avsevärt snabbare sidinläsning.

Enkelt: Kombinationen av XDM, Web SDK, taggar, Edge Network, Adobe Experience Cloud och Adobe Experience Platform skapar en lättbegriplig och lättanvänd datainsamlingsberättelse.

  • XDM Det lösningsagnostiska schema som du använder för att skicka data till Adobe. Ingen mer taggning för variabler eller rutor.
  • Web SDK: Gör det enkelt att skicka och ta emot data till Adobe Experience Platform Edge Network.
  • Taggar: Förenklar driftsättning och konfiguration av Web SDK (och andra JavaScript-taggar) på en plats.
  • Edge Network: Skicka enkelt data till Adobe Experience Platform och lösningar i det format de behöver.
  • Adobe Experience Platform och Adobe: Aktivera deras värdeförslag.

Kontroll: Eftersom alla data använder en enda och sammankopplad dataström kan ni logiskt följa och styra hur data ser ut under varje millisekund av resan, till och från program.

Modern och redo för framtiden: Web SDK och dess anslutning till Edge Network har gjort det möjligt för Adobe att avsevärt modernisera hur Adobe hanterar datainsamling, personalisering, samtycke och framtiden för cookies från tredje part. (Det aktiverar en förstahandsdomän som hanteras av Adobe.)

Tid till värde: Adobe har arbetat hårt (och kommer att fortsätta) för att göra det så enkelt som möjligt att driftsätta Web SDK via taggar och mappa klientdata till XDM. När detta arbete är klart kan alla andra Adobe-lösningar och Adobe Experience Platform-tjänster aktiveras eller inaktiveras på serversidan. Om du t.ex. använder detta för Adobe Analytics och vill aktivera Target eller Experience Platform kan du enkelt växla mellan olika datastream-konfigurationer och ljusa upp dessa användningsfall.

Vad är alloy.js?

alloy.js är namnet på JavaScript-biblioteket för Web SDK. Den refereras i SDK-källkoden och -filnamnet.

Behöver kunderna köpa Adobe Experience Platform för att använda Web SDK?

Nej. Alla som använder Adobe Digital Experience kan använda Adobe Experience Platform Web SDK kostnadsfritt. Kunder som vill använda Web SDK måste konfigurera rätt behörigheter för att skapa scheman, datauppsättningar, identitetsnamnutrymmen och datastreams i användargränssnittet för datainsamlingen eller Experience Platform.

Mer information om hur du konfigurerar dessa behörigheter finns i vår dokumentation om behörighetshantering för insamling.

Vem ska använda Web SDK?

Adobe Experience Platform Web SDK har utvecklats för följande kunder:

  • Adobe Experience Platform

    • Om du behöver skicka data direkt från en enhet till Adobe Experience Platform är detta det officiellt rekommenderade sättet.
    • Adobe är medveten om att det går snabbare att använda Adobe Analytics Connector om du redan har Adobe Analytics, men det är inte den långsiktiga strategin för datainsamling.

  • Kunder med Adobe Experience Cloud

    • Nya Adobe Analytics-, Adobe Audience Manager- och Adobe Target-kunder bör börja med nya Web SDK och inte använda äldre bibliotek.
    • Befintliga kunder som vill få optimerad implementering bör använda nya Web SDK.

Hur får jag tillgång till Web SDK?

Web SDK är för närvarande tillgängligt för allmänheten och kan användas för att skicka data till Adobe Experience Cloud-produkter. Möjligheten att skicka data till tredjepartslösningar kommer inom den närmaste framtiden.

Det kostar inget för SDK och Adobe står för det gratis. Om det behövs kan du ladda ned det och lägga det på dina egna servrar utan kostnad.

Web SDK kräver åtkomst till datastream-konfigurationer och Experience Platform XDM Schemaversion, för att Adobe-servrar ska kunna hantera inkommande data från SDK på rätt sätt. Om du vill få åtkomst kontaktar du ditt Adobe-kontoteam för att starta processen.

Vilka användningsfall stöds för närvarande av Web SDK?

Web SDK utvecklas snabbt. Fler användningsexempel håller på att bearbetas. Du hittar lista över de användningsfall som stöds här.

Måste befintliga kunder tagga om sina webbplatser?

Det beror på. Adobe Experience Platform Web SDK kan användas i två olika format. Ett dokument för framtida migrering kommer att innehålla ytterligare information.

  • Bara en annan tagg: Om webbplatsen redan är taggad för lösningar och du inte kan tagga om, men du vill skicka data till Adobe Experience Platform Edge Network för Experience Platform eller kommande händelsevidarebefordringsfunktioner (se nedan), kan du lägga till alloy.js -taggen till webbplatsen, där den fungerar som"bara en annan tagg".

  • Den enda taggen: Om du vill använda Web SDK för en Experience Cloud-lösning måste du använda den för alla av lösningarna på den sidan. Om din webbplats till exempel redan är taggad för Adobe Analytics och du vill använda den för Target måste du använda den för både och för alla andra i framtiden.

Med andra ord, om du bestämmer dig för att använda Adobe Experience Platform Web SDK för icke-lösningsexempel, kan du tagga webbplatsen med alloy.js och gå vidare som om det vore en ny lösning. Om du vill använda den för Adobe Analytics, Target eller Audience Manager, eller för programanvändning, kan du behöva ta bort någon av de äldre koderna på sidan.

Kan jag migrera ECID:n när jag börjar använda Web SDK så att webbplatsens besökare inte börjar visas som nya besökare?

Ja, Adobe Experience Platform Web SDK har en funktion för identitetsmigrering. Följ instruktionerna för ID-migrering i Identitetsdokumentation för Platform Web SDK för mer information.

Hur skiljer sig Web SDK från taggar?

  • Taggar i Experience Platform hantera enhetskoden. Använd dem för att enklare distribuera koden. De är kostnadsfria och kraftfulla.

  • Adobe Experience Platform Web SDK är det officiella namnet på den nya koden som ska distribueras av taggar för Adobe-användningsfall. Den är också kostnadsfri och kraftfull.

  • alloy.js är filnamnet på Adobe Experience Platform Web SDK-koden.

Måste jag använda taggar för att distribuera Web SDK?

Nej. Du kan ladda ned alloy.js själv.

Men:

  • Adobe Experience Platform Web SDK kräver något som kallas dataström-ID så att edge-nätverket kan identifiera dataströmmen och avgöra vad som ska göras med data. Detta ID skapas i Experience Platform. Det innebär inte att du måste använda användargränssnittet för att skapa egenskaper eller distribuera JavaScript-koden, men du måste använda taggar för att skapa ett konfigurations-ID.

  • Taggar är inte bara den bästa tillgängliga taggen och SDK-hanteraren, det är mycket enkelt att distribuera alloy.js och mappa data till XDM-scheman. Om du bestämmer dig för att inte använda taggar måste du hantera distributionen alloy.js, händelser och mappning av data till XDM innan de skickas. Det här är en mycket svårare än att använda taggar.

  • Vi rekommenderar att du använder taggar för att distribuera alloy.js, även om det är den enda taggen som du använder den för.

Vad innebär vidarebefordran av händelser?

Om du använder våra SDK:er och skickar XDM till Edge Network kan du med dessa nya funktioner för händelsevidarebefordran installera nya tillägg på serversidan och mappa dessa data till vad som helst - och skicka dem var som helst - från vårt edge-nätverk. Se det som"datainsamling som en tjänst". Detta kommer att vara kostnadsfritt och paketeras som en del av Adobe Experience Platform.

Vad är en CNAME- eller First Party-domän och varför spelar det någon roll?

Mer information om CNAME finns i Adobe dokumentation

Använder Adobe Experience Platform Web SDK cookies? Om så är fallet, vilka cookies använder den?

Ja, för närvarande använder Web SDK var som helst mellan en och sju cookies beroende på implementeringen. Nedan visas en lista över de cookies som du kan se med Web SDK och hur de används:

Namn
maxAge
Egen ålder
Beskrivning
kndct_orgid_identity
34128000
395 dagar
I identitetscookie lagras ECID och annan information om ECID.
kndctr_original_medgivande_check
7200
2 timmar
Denna sessionsbaserade cookie signalerar till servern att leta upp serversidan för medgivandeinställningar.
kndctr_orgid_medgivande
15552000
180 dagar
Denna cookie lagrar användarens medgivandeinställning för webbplatsen.
kndctr_orgid_Cluster
1800
30 minuter
Denna cookie lagrar det Edge Network-område som betjänar den aktuella användarens begäran. Regionen används i URL-sökvägen så att Edge Network kan dirigera begäran till rätt region. Denna cookie har en livslängd på 30 minuter, så om en användare ansluter till en annan IP-adress kan begäran dirigeras till närmaste region.
mbox
63072000
2 år
Den här cookien visas när inställningen för målmigrering är true. Detta tillåter att målet mbox cookie anges av Web SDK.
mboxEdgeCluster
1800
30 minuter
Den här cookien visas när inställningen för målmigrering är true. Med denna cookie kan Web SDK kommunicera rätt edge-kluster till at.js så att Target-profiler kan vara synkroniserade när användare navigerar på en webbplats.
AMCV_###@AdobeOrg
34128000
395 dagar
Denna cookie visas bara när ID-migrering på Adobe Experience Platform Web SDK är aktiverat. Denna cookie är användbar vid övergång till Web SDK medan vissa delar av webbplatsen fortfarande använder visitor.js. Se idMigrationEnabled för mer information.

När du använder Web SDK anger Edge Network en eller flera av cookierna ovan. Edge Network ställer in alla cookies med secure och sameSite="none" attribut.

Om du för närvarande har både säkra och osäkra avsnitt på webbplatsen kan det störa användaridentifieringen. När en användare navigerar från ett säkert avsnitt på webbplatsen till ett osäkert avsnitt, genererar Edge Network ett nytt ECID med begäran.

Vilka webbläsare stöder Adobe Experience Platform Web SDK?

Adobe Experience Platform Web SDK är utformat för att fungera optimalt i de senaste versionerna av Google Chrome, Safari, Firefox, Internet Explorer 11 och Microsoft Edge Chromium. Du kan ha problem med att använda vissa funktioner i äldre versioner av webbläsare.

Var kan jag få mer information om Adobe Experience Platform Web SDK?

Stöd för Internet Explorer support-internet-explore

Denna SDK använder löften, som är ett sätt att kommunicera slutförandet av asynkrona uppgifter. The Lova implementering som används av SDK stöds internt av alla målwebbläsare utom Internet Explorer. Använda SDK på Internet Explorermåste du ha window.Promise polyfylld.

För att avgöra om du redan har window.Promise polyfylld:

  1. Öppna webbplatsen i Internet Explorer.
  2. Öppna webbläsarens felsökningskonsol.
  3. Typ window.Promise till konsolen och tryck sedan på Retur.

Om något annat än undefined visas, du har antagligen redan polyfyllt window.Promise. Ett annat sätt att avgöra om window.Promise fylls i genom att webbplatsen läses in när ovanstående installationsanvisningar är klara. Om SDK genererar ett fel som talar om något om ett löfte har du troligen inte polyfyllt window.Promise.

Om du har bestämt att du måste polyfyll window.Promiseinkluderar du följande script-tagg ovanför den tidigare angivna baskoden:

<script src="https://cdn.jsdelivr.net/npm/promise-polyfill@8/dist/polyfill.min.js"></script>

Den här taggen läser in ett skript som ser till att window.Promise är en giltig Promise-implementering.

NOTE
Om du väljer att läsa in en annan Promise-implementering måste den ha stöd för Promise.prototype.finally.

Stöd för Internet Explorer

Adobe Experience Platform SDK använder löften, som är ett sätt att kommunicera slutförandet av asynkrona uppgifter. The Lova implementering som används av SDK stöds internt av alla målwebbläsare utom Internet Explorer. Använda SDK på Internet Explorermåste du ha window.Promise polyfylld.

Ett bibliotek som man kan använda för att polyfill-löftet är en utfästelse-polyfill. Se dokumentation för promise-polyfill om du vill ha mer information om hur du installerar med NPM.

NOTE
Om du väljer att läsa in en annan Promise-implementering måste den ha stöd för Promise.prototype.finally.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636