Web SDK configureren

De configuratie voor de SDK wordt uitgevoerd met de configure gebruiken.

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

Er zijn vele opties die tijdens configuratie kunnen worden geplaatst. Alle opties vindt u hieronder, gegroepeerd op categorie.

Algemene opties

edgeConfigId

Uw toegewezen configuratie-id, die de SDK koppelt aan de juiste accounts en configuratie. Wanneer het vormen van veelvoudige instanties binnen één enkele pagina, moet u verschillende vormen edgeConfigId voor elke instantie.

context context

Geeft aan welke contextcategorieën automatisch moeten worden verzameld, zoals beschreven in Automatische informatie. Als deze configuratie niet wordt gespecificeerd, worden alle categorieën gebruikt door gebrek.

Inschakelen hoge entropieclienthints op uw plaatsing van SDK van het Web, moet u extra omvatten highEntropyUserAgentHints naast uw bestaande configuratie.

Als u bijvoorbeeld hoge entropientroy-clienthints wilt ophalen van westeigenschappen, ziet uw configuratie er als volgt uit:

context: ["highEntropyUserAgentHints", "web"]

debugEnabled

Geeft aan of foutopsporing is ingeschakeld. Deze configuratie instellen op true schakelt de volgende functies in:

edgeDomain edge-domain

Vul dit veld met uw domein van de eerste partij. Zie voor meer informatie de documentatie.

Het domein is vergelijkbaar met data.{customerdomain.com} voor een website op www.{customerdomain.com}.

edgeBasePath edge-base-path

Pad na het edgeDomain dat wordt gebruikt voor communicatie en interactie met Adobe-services. Vaak zou dit alleen veranderen wanneer de standaardproductieomgeving niet wordt gebruikt.

orgId

Uw toegewezen Experience Cloud organisatie-id. Wanneer het vormen van veelvoudige instanties binnen een pagina, moet u een verschillende vormen orgId voor elke instantie.

Gegevensverzameling

clickCollectionEnabled clickCollectionEnabled

Geeft aan of gegevens die aan koppelingsklikken zijn gekoppeld, automatisch worden verzameld. Zie Automatisch koppelen bijhouden voor meer informatie . Koppelingen worden ook gelabeld als downloadkoppelingen als deze een downloadkenmerk bevatten of als de koppeling eindigt met een bestandsextensie. De de verbindingsbepalers van de download kunnen met een regelmatige uitdrukking worden gevormd. De standaardwaarde is "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"

onBeforeEventSend

Vorm callback die voor elke gebeurtenis vlak alvorens het wordt verzonden wordt geroepen. Een object met het veld xdm wordt verzonden binnen naar callback. Om te wijzigen wat wordt verzonden, wijzigt u de xdm object. Binnen de callback, xdm heeft de gegevens al doorgegeven in de gebeurtenisopdracht en de automatisch verzamelde informatie. Voor meer informatie over de timing van deze callback en een voorbeeld, zie Gebeurtenissen globaal wijzigen.

onBeforeLinkClickSend onBeforeLinkClickSend

Vorm een callback die voor elke verbinding wordt geroepen klikt volgende gebeurtenis vlak alvorens het wordt verzonden. De callback verzendt een voorwerp met xdm, clickedElement, en data velden.

Wanneer het filtreren van de verbinding het volgen door de DOM elementenstructuur te gebruiken, kunt u gebruiken clickElement gebruiken. clickedElement is de DOM elementenknoop die werd geklikt en de boom van ouderknopen heeft ingekapseld.

Als u wilt wijzigen welke gegevens worden verzonden, wijzigt u de xdm en/of data objecten. Binnen de callback, xdm heeft de gegevens al doorgegeven in de gebeurtenisopdracht en de automatisch verzamelde informatie.

Privacyopties

defaultConsent default-consent

Hiermee stelt u de standaardtoestemming van de gebruiker in. Gebruik deze instelling als er nog geen voorkeur voor toestemming is opgeslagen voor de gebruiker. De andere geldige waarden zijn "pending" en "out". Deze standaardwaarde wordt niet doorgevoerd in het profiel van de gebruiker. Het gebruikersprofiel wordt alleen bijgewerkt wanneer setConsent wordt aangeroepen.

Persoonlijke opties personalization

prehidingStyle prehidingStyle

Wordt gebruikt om een CSS-stijldefinitie te maken die inhoudsgebieden van uw webpagina verbergt terwijl gepersonaliseerde inhoud van de server wordt geladen. Als deze optie niet wordt opgegeven, probeert de SDK geen inhoudsgebieden te verbergen terwijl gepersonaliseerde inhoud wordt geladen, wat mogelijk resulteert in "flikkering".

Als een element op uw webpagina bijvoorbeeld een id heeft van container, waarvan u de standaardinhoud wilt verbergen terwijl gepersonaliseerde inhoud van de server wordt geladen, gebruikt u de volgende voorverbergingsstijl:

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

targetMigrationEnabled targetMigrationEnabled

Deze optie moet worden gebruikt bij het migreren van afzonderlijke pagina's van at.js naar Web SDK.

Gebruik deze optie om de SDK van het Web toe te laten om de erfenis te lezen en te schrijven mbox en mboxEdgeCluster cookies die worden gebruikt door at.js. Zo kunt u het bezoekersprofiel behouden terwijl u overschakelt van een pagina die de SDK van Web gebruikt naar een pagina die de at.js bibliotheek en omgekeerd.

Opties voor soorten publiek

cookieDestinationsEnabled

Inschakelen Audience Manager koekjesbestemmingen, die het plaatsen van koekjes toestaat die op segmentkwalificatie worden gebaseerd.

urlDestinationsEnabled

Inschakelen Audience Manager URL-doelen, waarmee URL's kunnen worden geactiveerd op basis van segmentkwalificatie.

Identiteitsopties

idMigrationEnabled id-migration-enabled

Indien waar (true), leest de SDK oude AMCV-cookies en stelt deze in. Deze optie helpt bij het overstappen naar het gebruik van Adobe Experience Platform Web SDK, terwijl sommige delen van de site wellicht nog steeds Visitor.js gebruiken.

Als de Bezoeker-API op de pagina is gedefinieerd, vraagt de SDK de Bezoeker-API voor de ECID. Met deze optie kunt u pagina's met twee tags toevoegen met de Adobe Experience Platform Web SDK en toch dezelfde ECID hebben.

thirdPartyCookiesEnabled

Hiermee schakelt u het instellen van cookies van derden voor de Adobe in. De SDK kan de bezoekersidentiteitskaart in een derdecontext voortzetten om de zelfde bezoekersidentiteitskaart toe te laten om over plaatsen worden gebruikt. Gebruik deze optie als u meerdere sites hebt of gegevens wilt delen met partners. Deze optie is echter soms niet gewenst vanwege privacyredenen.