DokumentationExperience PlatformTaggar

Konfigurera SDK-taggtillägget för webben

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Utvecklare

Taggtillägget Web SDK skickar data till Adobe Experience Cloud från webbegenskaper via Experience Platform Edge Network.

Tillägget gör att ni kan strömma data till plattformen, synkronisera identiteter, bearbeta kundens medgivandesignaler och automatiskt samla in kontextdata.

I det här dokumentet förklaras hur du konfigurerar taggtillägget i tagggränssnittet.

Installera SDK-taggtillägget för webben install

För Web SDK-taggtillägget krävs en egenskap som ska installeras på. Om du inte redan har gjort det läser du dokumentationen om att skapa en taggegenskap.

När du har skapat en egenskap öppnar du den och väljer fliken Extensions i det vänstra fältet.

Klicka på fliken Catalog. Leta reda på tillägget Web SDK i listan över tillgängliga tillägg och välj Install.

Bild som visar användargränssnittet för taggar med Web SDK-tillägget markerat

När du har valt Install måste du konfigurera Web SDK-taggtillägget och spara konfigurationen.

NOTE
Taggtillägget installeras endast efter att konfigurationen har sparats. I nästa avsnitt får du lära dig hur du konfigurerar taggtillägget.

Konfigurera instansinställningar general

Konfigurationsalternativen högst upp på sidan anger för Adobe Experience Platform var data ska skickas och vilka konfigurationer som ska användas på servern.

Bild som visar de allmänna inställningarna för Web SDK-taggtillägget i tagggränssnittet

  • Name: Adobe Experience Platform Web SDK-tillägget stöder flera instanser på sidan. Namnet används för att skicka data till flera organisationer med en taggkonfiguration. Instansnamnet är som standard alloy. Du kan dock ändra instansnamnet till ett giltigt JavaScript-objektnamn.
  • IMS organization ID: ID:t för organisationen som du vill att data ska skickas till på Adobe. För det mesta använder du standardvärdet som fylls i automatiskt. När du har flera instanser på sidan fyller du i det här fältet med värdet för den andra organisationen som du vill skicka data till.
  • Edge domain: Domänen som tillägget skickar och tar emot data från. Adobe rekommenderar att du använder en CNAME (1st-party domain) för det här tillägget. Standarddomänen från tredje part fungerar för utvecklingsmiljöer men är inte lämplig för produktionsmiljöer. Instruktioner om hur du konfigurerar en CNAME från en första part visas här.

Konfigurera inställningar för dataström datastreams

I det här avsnittet kan du välja de datastreams som ska användas för var och en av de tre tillgängliga miljöerna (produktion, mellanlagring och utveckling).

När en begäran skickas till Edge Network används ett datastream-ID för att referera till konfigurationen på serversidan. Du kan uppdatera konfigurationen utan att behöva göra kodändringar på webbplatsen.

Mer information om hur du konfigurerar ett datastream finns i guiden för datastreams.

Du kan antingen välja ett datastream från de tillgängliga listrutorna eller välja Enter values och ange ett anpassat datastream-ID för varje miljö.

Bild som visar datastream-inställningarna för Web SDK-taggtillägget i tagggränssnittet

Konfigurera sekretessinställningar privacy

I det här avsnittet kan du konfigurera hur Web SDK hanterar tillståndssignaler från din webbplats. Det gör i synnerhet att du kan välja den standardnivå för samtycke som antas av en användare om ingen annan explicit medgivandeinställning har angetts.

Standardnivån för samtycke sparas inte i användarprofilen.

Bild som visar sekretessinställningarna för Web SDK-taggtillägget i tagggränssnittet

Default consent level
Beskrivning
In
Samla in händelser som inträffar innan användaren ger sitt samtycke.
Out
Ignorera händelser som inträffar innan användaren ger sitt medgivande.
Pending
Köhändelser som inträffar innan användaren ger sitt samtycke. När du har angett medgivandeinställningar kommer händelserna att samlas in eller tas bort beroende på vilka inställningar som har angetts.
Provided by data element
Standardnivån för samtycke bestäms av ett separat dataelement som du definierar. När du använder det här alternativet måste du ange dataelementet med den angivna listrutan.
TIP
Använd Out eller Pending om du kräver uttryckligt användargodkännande för dina affärsåtgärder.

Konfigurera identitetsinställningar identity

I det här avsnittet kan du definiera hur Web SDK ska fungera när det gäller hantering av användaridentifiering.

Bild som visar identitetsinställningarna för Web SDK-taggtillägget i tagggränssnittet

  • Migrate ECID from VisitorAPI: Det här alternativet är aktiverat som standard. När den här funktionen är aktiverad kan SDK läsa cookies för AMCV och s_ecid och ange den cookie för AMCV som används av Visitor.js. Den här funktionen är viktig vid migrering till Web SDK, eftersom vissa sidor fortfarande använder Visitor.js. Med det här alternativet kan SDK fortsätta att använda samma ECID så att användare inte identifieras som två separata användare.

  • Use third-party cookies: När det här alternativet är aktiverat försöker Web SDK lagra en användaridentifierare i en cookie från tredje part. Om det lyckas identifieras användaren som en enskild användare när de navigerar mellan flera domäner, i stället för att identifieras som en separat användare på varje domän. Om det här alternativet är aktiverat kanske SDK fortfarande inte kan lagra användaridentifieraren i en tredjeparts-cookie om webbläsaren inte stöder cookies från tredje part eller har konfigurerats av användaren så att cookies från tredje part inte tillåts. I det här fallet lagrar SDK bara identifieraren i förstahandsdomänen.

    note important
    IMPORTANT
    ​>Cookies från tredje part är inte kompatibla med funktionen för första parts enhets-ID i Web SDK.

Du kan antingen använda enhets-ID:n från en annan leverantör eller använda cookies från tredje part, men du kan inte använda båda funktionerna samtidigt.

Konfigurera personaliseringsinställningar personalization

I det här avsnittet kan du konfigurera hur du vill dölja vissa delar av en sida medan anpassat innehåll läses in. Detta garanterar att besökarna bara ser den personaliserade sidan.

Bild som visar personaliseringsinställningarna för Web SDK-taggtillägget i tagggränssnittet

  • Migrate Target from at.js to the Web SDK: Använd det här alternativet om du vill att Web SDK ska kunna läsa och skriva de gamla mbox och mboxEdgeCluster cookies som används av at.js 1.x - eller 2.x-bibliotek. Detta hjälper dig att behålla besökarprofilen när du flyttar från en sida där Web SDK används till en sida där at.js 1.x- eller 2.x-bibliotek används och vice versa.

Dölja stil prehiding-style

Med den fördolda formatredigeraren kan du definiera anpassade CSS-regler för att dölja specifika avsnitt på en sida. När sidan har lästs in använder Web SDK den här stilen för att dölja avsnitt som behöver anpassas, hämtar personaliseringen och tar sedan bort de anpassade sidavsnitten. På så sätt kan besökarna se de sidor som redan är personaliserade, utan att se processen för hämtning av personalisering.

Dölja fragment prehiding-snippet

Det fördolda fragmentet är användbart när Web SDK-biblioteket läses in asynkront. För att undvika flimmer rekommenderar vi att du döljer innehållet innan Web SDK-biblioteket har lästs in.

Om du vill använda det fördolda fragmentet kopierar och klistrar du in det inuti <head>-elementet på sidan.

IMPORTANT
När du använder det fördolda fragmentet rekommenderar Adobe att du använder samma CSS-regel som den som används i fördöljningsformatet.

Konfigurera inställningar för datainsamling data-collection

Hantera konfigurationsinställningar för datainsamling. Liknande inställningar i JavaScript-biblioteket är tillgängliga med kommandot configure.

Bild som visar inställningarna för datainsamling i Web SDK-taggtillägget i tagggränssnittet.

  • On before event send callback: En callback-funktion som utvärderar och ändrar nyttolasten som skickas till Adobe. Använd variabeln content i callback-funktionen för att ändra nyttolasten. Det här återanropet motsvarar taggen onBeforeEventSend i JavaScript-biblioteket.

  • Collect internal link clicks: En kryssruta som aktiverar insamling av länkspårningsdata som är interna för din webbplats eller egenskap. När du markerar den här kryssrutan visas alternativ för händelsegruppering:

    • No event grouping: Länkspårningsdata skickas till Adobe i olika händelser. Länkklickningar som skickas i olika händelser kan öka den avtalsenliga användningen av data som skickas till Adobe Experience Platform.
    • Event grouping using session storage: Lagra länkspårningsdata i sessionslagring tills nästa sidhändelse. På följande sida skickas data för den lagrade länkspårningen och sidvisningsdata till Adobe samtidigt. Adobe rekommenderar att den här inställningen aktiveras när interna länkar spåras.
    • Event grouping using local object: Lagra länkspårningsdata i ett lokalt objekt fram till nästa sidhändelse. Om en besökare navigerar till en ny sida, försvinner länkspårningsdata. Den här inställningen är mest användbar för enkelsidiga program.

  • Collect external link clicks: En kryssruta som aktiverar samlingen av externa länkar.

  • Collect download link clicks: En kryssruta som aktiverar samlingen med hämtningslänkar.

  • Download link qualifier: Ett reguljärt uttryck som kvalificerar en länk-URL som en nedladdningslänk.

  • Filter click properties: En callback-funktion som utvärderar och ändrar klickrelaterade egenskaper före samlingen. Den här funktionen körs före On before event send callback.

  • Kontextinställningar: Samla in besökarinformation automatiskt, vilket fyller i specifika XDM-fält åt dig. Välj All default context information eller Specific context information. Det är taggen som motsvarar context i JavaScript-biblioteket.

    • Web: Samlar in information om den aktuella sidan.
    • Device: Samlar in information om användarens enhet.
    • Environment: Samlar in information om användarens webbläsare.
    • Place context: Samlar in information om användarens plats.
    • High entropy user-agent hints: Samlar in mer detaljerad information om användarens enhet.
TIP
Fältet On before link click send är ett föråldrat återanrop som bara är synligt för egenskaper som redan har det konfigurerat. Det är taggen som motsvarar onBeforeLinkClickSend i JavaScript-biblioteket. Använd motringningen Filter click properties för att filtrera eller justera klickdata, eller använd On before event send callback för att filtrera eller justera den totala nyttolasten som skickas till Adobe. Om både Filter click properties-återanropet och On before link click send-återanropet är inställda körs bara Filter click properties-återanropet.

Konfigurera inställningar för mediesamling media-collection

Funktionen för mediainsamling hjälper dig att samla in data relaterade till mediesessioner på din webbplats.

De insamlade data kan innehålla information om medieuppspelningar, pauser, slutföranden och andra relaterade händelser. När de samlats in kan du skicka dessa data till Adobe Experience Platform och/eller Adobe Analytics för att generera rapporter. Den här funktionen är en heltäckande lösning för att spåra och förstå hur medieanvändningen fungerar på din webbplats.

Bild som visar inställningarna för mediesamlingen för Web SDK-taggtillägget i tagggränssnittet

  • Channel: Namnet på den kanal där mediesamlingen sker. Exempel: Video channel.
  • Player Name: Namnet på mediespelaren.
  • Application Version: Mediespelarprogrammets version.
  • Main ping interval: Frekvensen pingar för huvudinnehåll, i sekunder. Standardvärdet är 10. Värdena kan ligga mellan 10 och 50 sekunder. Om inget värde anges används standardvärdet när automatiskt spårade sessioner används.
  • Ad ping interval: Täthet för pingar för annonsinnehåll, i sekunder. Standardvärdet är 10. Värdena kan ligga mellan 1 och 10 sekunder. Om inget värde anges används standardvärdet när automatiskt spårade sessioner används

Konfigurera åsidosättningar av dataström datastream-overrides

Med åsidosättningar av dataström kan du definiera ytterligare konfigurationer för dina dataströmmar, som skickas till Edge Network via Web SDK.

Detta hjälper dig att utlösa andra datastream-beteenden än standardbeteendena, utan att du behöver skapa ett nytt datastream eller ändra dina befintliga inställningar.

Åsidosättning av dataströmskonfiguration är en tvåstegsprocess:

  1. Först måste du definiera åsidosättningar av datastream-konfigurationen på datastreams konfigurationssida.
  2. Sedan måste du skicka åsidosättningarna till Edge Network antingen via ett Web SDK-kommando eller via taggtillägget Web SDK.

Mer information om hur du åsidosätter datastream-konfigurationer finns i konfigurationen åsidosätter dokumentation.

Som ett alternativ till att skicka åsidosättningarna via ett Web SDK-kommando kan du konfigurera åsidosättningarna på taggtilläggsskärmen som visas nedan.

IMPORTANT
Åsidosättningar av dataström måste konfigureras per miljö. Utvecklings-, staging- och produktionsmiljöerna har alla olika åsidosättningar. Du kan kopiera inställningarna mellan dem med hjälp av de dedikerade alternativen som visas på skärmen nedan.

Bild som visar åsidosättningar av dataströmskonfigurationer med hjälp av tilläggssidan för Web SDK-taggen.

Konfigurera avancerade inställningar

Använd fältet Edge base path om du behöver ändra grundsökvägen som används för att interagera med Edge Network. Det här behöver inte uppdateras, men om du deltar i en beta eller alfa kan Adobe be dig att ändra det här fältet.

Bild som visar de avancerade inställningarna på tilläggssidan för Web SDK-taggen.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743