Konfigurera Web SDK

Konfigurationen för SDK görs med configure -kommando.

alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

Det finns många alternativ som kan anges under konfigurationen. Alla alternativ finns nedan, grupperade efter kategori.

Allmänna alternativ

edgeConfigId

Ditt tilldelade konfigurations-ID, som länkar SDK till rätt konton och konfiguration. När du konfigurerar flera instanser på en sida måste du konfigurera ett edgeConfigId för varje instans.

context context

Anger vilka sammanhangskategorier som ska samlas in automatiskt enligt beskrivningen i Automatisk information. Om den här konfigurationen inte anges används alla kategorier som standard.

Aktivera hög entropi-klienttips i Web SDK-distributionen måste du lägga till highEntropyUserAgentHints kontextalternativ, tillsammans med befintlig konfiguration.

Om du till exempel vill hämta klienttips för hög entropi från webbegenskaper ser konfigurationen ut så här:

context: ["highEntropyUserAgentHints", "web"]

debugEnabled

Anger om felsökning är aktiverat. Anger den här konfigurationen till true har följande funktioner:

edgeDomain edge-domain

Fyll i det här fältet med din förstahandsdomän. Mer information finns i dokumentation.

Domänen liknar data.{customerdomain.com} på www.{customerdomain.com}.

edgeBasePath edge-base-path

Sökväg efter den edgeDomain som används för att kommunicera och interagera med Adobes tjänster. Detta ändras ofta bara om du inte använder standardproduktionsmiljön.

orgId

Ditt uppdrag Experience Cloud organisations-ID. När du konfigurerar flera instanser på en sida måste du konfigurera en annan orgId för varje instans.

Datainsamling

clickCollectionEnabled clickCollectionEnabled

Anger om data som är associerade med länkklick samlas in automatiskt. Se Automatisk länkspårning för mer information. Länkarna kallas också för nedladdningslänkar om de innehåller ett nedladdningsattribut eller om länken avslutas med ett filtillägg. Hämtningslänkkvalificerare kan konfigureras med ett reguljärt uttryck. Standardvärdet är "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"

onBeforeEventSend

Konfigurera ett återanrop som anropas för varje händelse precis innan den skickas. Ett objekt med fältet xdm skickas in till återanropet. Om du vill ändra vad som skickas ändrar du xdm -objekt. Inuti återanropet finns xdm -objektet har redan data som skickas i händelsekommandot och den automatiskt insamlade informationen. Mer information om tidpunkten för det här återanropet och ett exempel finns i Ändra händelser globalt.

onBeforeLinkClickSend onBeforeLinkClickSend

Konfigurera ett återanrop som anropas för varje länkklickningshändelse precis innan det skickas. Callback-funktionen skickar ett objekt med xdm, clickedElementoch data fält.

När du filtrerar länkspårningen med hjälp av DOM-elementstrukturen kan du använda clickElement -kommando. clickedElement är DOM-elementnoden som du klickade på och som har kapslat in det överordnade nodträdet.

Om du vill ändra vilka data som skickas ändrar du xdm och/eller data objekt. Inuti återanropet finns xdm -objektet har redan data som skickas i händelsekommandot och den automatiskt insamlade informationen.

Sekretessalternativ

defaultConsent default-consent

Anger användarens standardsamtycke. Använd den här inställningen när ingen inställning för samtycke redan har sparats för användaren. De andra giltiga värdena är "pending" och "out". Det här standardvärdet sparas inte i användarens profil. Användarprofilen uppdateras bara när setConsent anropas.

Anpassningsalternativ personalization

prehidingStyle prehidingStyle

Används för att skapa en CSS-formatdefinition som döljer innehållsområden på webbsidan när anpassat innehåll läses in från servern. Om det här alternativet inte anges försöker SDK inte dölja några innehållsområden när anpassat innehåll läses in, vilket kan leda till"flimmer".

Om ett element på webbsidan till exempel har ID:t container, vars standardinnehåll du vill dölja när anpassat innehåll läses in från servern, använder följande fördolda format:

  prehidingStyle: "#container { opacity: 0 !important }"

targetMigrationEnabled targetMigrationEnabled

Det här alternativet bör användas när du migrerar enskilda sidor från at.js till Web SDK.

Använd det här alternativet om du vill att Web SDK ska kunna läsa och skriva det äldre mbox och mboxEdgeCluster cookies som används av at.js. 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 bibliotek och vice versa.

Målgruppsalternativ

cookieDestinationsEnabled

Aktiverar Audience Manager cookie-destinationer, som gör det möjligt att ställa in cookies baserat på segmentkvalificering.

urlDestinationsEnabled

Aktiverar Audience Manager URL-destinationer, som gör det möjligt att bränna URL:er baserat på segmentkvalificering.

Identitetsalternativ

idMigrationEnabled id-migration-enabled

Om true läser SDK in gamla AMCV-cookies. Med det här alternativet kan du gå över till Adobe Experience Platform Web SDK medan Visitor.js fortfarande används i vissa delar av webbplatsen.

Om Visitor API är definierat på sidan frågar SDK om Visitor API för ECID. Med det här alternativet kan du dubbeltagga sidor med Adobe Experience Platform Web SDK och fortfarande ha samma ECID.

thirdPartyCookiesEnabled

Aktiverar inställningen av cookies från tredje part från Adobe. SDK:n kan behålla besökar-ID:t i ett tredjepartssammanhang för att samma besökar-ID ska kunna användas på olika platser. Använd det här alternativet om du har flera webbplatser eller om du vill dela data med partner, men ibland är det här alternativet inte önskvärt av sekretesskäl.