De webSDK-tagextensie configureren

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

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

Met de tagextensie Web SDK worden gegevens vanuit wegeigenschappen via de Edge Network Experience Platform naar Adobe Experience Cloud verzonden.

Met de extensie kunt u gegevens streamen naar Platform, identiteiten synchroniseren, de toestemmingssignalen van de klant verwerken en automatisch contextgegevens verzamelen.

In dit document wordt uitgelegd hoe u de tagextensie configureert in de gebruikersinterface voor tags.

De extensie van de Web SDK-tag installeren install

De de markeringsuitbreiding van SDK van het Web moet een bezit worden geïnstalleerd. Als u dit niet reeds hebt gedaan, zie de documentatie bij het creëren van een markeringsbezit.

Nadat u een eigenschap hebt gemaakt, opent u de eigenschap en selecteert u de tab Extensions op de linkerzijbalk.

Selecteer het tabblad Catalog. Zoek in de lijst met beschikbare extensies naar de extensie Web SDK en selecteer Install .

Beeld dat de Markeringen UI met de geselecteerde uitbreiding van SDK van het Web toont

Nadat u Install hebt geselecteerd, moet u de extensie van de Web SDK-tag configureren en de configuratie opslaan.

NOTE

De tagextensie wordt alleen geïnstalleerd nadat de configuratie is opgeslagen. Zie de volgende secties om te leren hoe te om de markeringsuitbreiding te vormen.

Instantie-instellingen configureren general

De configuratieopties boven aan de pagina vertellen Adobe Experience Platform waar de gegevens moeten worden gerouteerd en welke configuraties op de server moeten worden gebruikt.

Beeld dat de algemene montages van de de markeringsuitbreiding van SDK van het Web in de markeringen UI toont

Name: De extensie Adobe Experience Platform Web SDK ondersteunt meerdere exemplaren op de pagina. De naam wordt gebruikt om gegevens naar veelvoudige organisaties met een markeringsconfiguratie te verzenden. De instantienaam is standaard ingesteld op alloy . U kunt de instantienaam echter wijzigen in elke geldige JavaScript-objectnaam.
IMS organization ID: De id van de organisatie waarnaar u de gegevens op de Adobe wilt verzenden. Meestal gebruikt u de standaardwaarde die automatisch wordt ingevuld. Wanneer u meerdere exemplaren op de pagina hebt, vult u dit veld met de waarde van de tweede organisatie waarnaar u gegevens wilt verzenden.
Edge domain: Het domein waarvan de extensie gegevens verzendt en ontvangt. De Adobe adviseert gebruikend een 1st-partijdomein (CNAME) voor deze uitbreiding. Het standaard domein van derden werkt voor ontwikkelomgevingen, maar is niet geschikt voor productieomgevingen. De instructies op hoe te opstelling zijn een eerste-partij CNAME vermeld hier.

Gegevensstroominstellingen configureren datastreams

Deze sectie staat u toe om de gegevensstromen te selecteren die voor elk van de drie beschikbare milieu's (productie, het opvoeren, en ontwikkeling) zouden moeten worden gebruikt.

Wanneer een verzoek naar de Edge Network wordt verzonden, wordt een gegevensstroom ID gebruikt om naar de server-zijconfiguratie te verwijzen. U kunt de configuratie bijwerken zonder dat u codewijzigingen op uw website hoeft aan te brengen.

Zie de gids op gegevensstromenleren hoe te om een gegevensstroom te vormen.

U kunt een gegevensstroom kiezen in de beschikbare vervolgkeuzemenu's of Enter values selecteren en een aangepaste gegevensstroom-id invoeren voor elke omgeving.

Beeld dat de gegevensstroommontages van de de markeringsuitbreiding van SDK van het Web in de markeringen UI toont

Privacy-instellingen configureren privacy

Deze sectie staat u toe om te vormen hoe de SDK van het Web de signalen van de gebruikerstoestemming van uw website behandelt. Met name kunt u het standaardniveau van toestemming selecteren dat wordt aangenomen door een gebruiker als er geen andere voorkeur voor expliciete toestemming is opgegeven.

Het standaard toestemmingsniveau wordt niet bewaard aan het gebruikersprofiel.

Beeld dat de privacymontages van de de markeringsuitbreiding van SDK van het Web in de Markeringen UI toont

Default consent level

Beschrijving

Verzamel gebeurtenissen die plaatsvinden voordat de gebruiker voorkeuren voor toestemming geeft.

Out

Gebeurtenissen negeren die plaatsvinden voordat de gebruiker voorkeuren voor toestemming geeft.

Pending

Wachtrij-gebeurtenissen die plaatsvinden voordat de gebruiker voorkeuren voor toestemming geeft. Als er voorkeuren voor toestemming zijn opgegeven, worden de gebeurtenissen verzameld of genegeerd, afhankelijk van de opgegeven voorkeuren.

Provided by data element

Het standaard toestemmingsniveau wordt bepaald door een afzonderlijk gegevenselement dat u bepaalt. Wanneer u deze optie gebruikt, moet u het gegevenselement opgeven met behulp van het opgegeven vervolgkeuzemenu.

TIP

Gebruik Out of Pending als u expliciete toestemming van de gebruiker voor uw bedrijfsactiviteiten nodig hebt.

Identiteitsinstellingen configureren identity

Deze sectie staat u toe om het gedrag van SDK van het Web te bepalen wanneer het over de behandeling van gebruikersidentificatie komt.

Beeld dat de identiteitsmontages van de de markeringsuitbreiding van SDK van het Web in de markeringen UI toont

Migrate ECID from VisitorAPI: Deze optie is standaard ingeschakeld. Wanneer deze functie is ingeschakeld, kan de SDK de AMCV - en s_ecid -cookies lezen en de AMCV -cookie instellen die door Visitor.js wordt gebruikt. Deze functie is belangrijk bij het migreren naar Web SDK, omdat sommige pagina's wellicht nog steeds Visitor.js gebruiken. Met deze optie kan de SDK hetzelfde ECID blijven gebruiken, zodat gebruikers niet worden geïdentificeerd als twee aparte gebruikers.

Use third-party cookies: Wanneer deze optie is ingeschakeld, probeert de Web SDK een gebruikers-id op te slaan in een cookie van een andere fabrikant. Als dit gelukt is, wordt de gebruiker geïdentificeerd als één gebruiker terwijl deze in meerdere domeinen navigeert en niet als een afzonderlijke gebruiker op elk domein wordt geïdentificeerd. Als deze optie is ingeschakeld, kan de SDK de gebruikersnaam nog steeds niet opslaan in een cookie van een andere fabrikant als de browser cookies van derden niet ondersteunt of door de gebruiker is geconfigureerd om cookies van derden niet toe te staan. In dit geval slaat de SDK alleen de id op in het domein van de eerste partij.

note important
IMPORTANT
>De koekjes van de derde zijn niet compatibel met de ](https://experienceleague.adobe.com/web-sdk/identity/first-party-device-ids.html?lang=nl) functionaliteit 1} van identiteitskaart van het eerste apparaat in Web SDK.

[
U kunt apparaat-id's van andere leveranciers gebruiken of cookies van andere leveranciers, maar u kunt beide functies niet tegelijkertijd gebruiken.

Aanpassingsinstellingen configureren personalization

In deze sectie kunt u configureren hoe u bepaalde delen van een pagina wilt verbergen terwijl gepersonaliseerde inhoud wordt geladen. Zo weet u zeker dat uw bezoekers alleen de gepersonaliseerde pagina zien.

Beeld dat de verpersoonlijkingsmontages van de de markeringsuitbreiding van SDK van het Web in de Markeringen UI toont

Migrate Target from at.js to the Web SDK: Gebruik deze optie om Web SDK in te schakelen om de verouderde mbox - en mboxEdgeCluster -cookies die door at.js 1.x - of 2.x -bibliotheken worden gebruikt, te lezen en te schrijven. Dit helpt u het bezoekersprofiel te houden terwijl het bewegen van een pagina die SDK van het Web aan een pagina gebruikt die at.js 1.x of 2.x bibliotheken en vice versa gebruikt.

Stijl vooraf verbergen prehiding-style

Met de preHide style editor kunt u aangepaste CSS-regels definiëren om specifieke secties van een pagina te verbergen. Wanneer de pagina wordt geladen, gebruikt SDK van het Web deze stijl om de secties te verbergen die moeten worden gepersonaliseerd, wint de verpersoonlijking terug, dan unhides de gepersonaliseerde paginagedeelten. Op deze manier zien uw bezoekers de reeds gepersonaliseerde pagina's, zonder het proces van de personalisatieherwinning te zien.

Fragment vooraf verbergen prehiding-snippet

Het voorbeeldfragment is handig wanneer de Web SDK-bibliotheek asynchroon wordt geladen. In deze situatie, om het flikkeren te vermijden, adviseren wij het verbergen van de inhoud alvorens de bibliotheek van SDK van het Web wordt geladen.

Als u het voorverborgen fragment wilt gebruiken, kopieert en plakt u het in het <head> -element van de pagina.

IMPORTANT

Wanneer het gebruiken van het prehide fragment, adviseert de Adobe om de zelfde CSS regel te gebruiken zoals die door wordt gebruikt prehide stijl.

Instellingen voor gegevensverzameling configureren data-collection

Configuratieinstellingen voor gegevensverzameling beheren. Vergelijkbare instellingen in de JavaScript-bibliotheek zijn beschikbaar via de opdracht configure .

Beeld dat de montages van de gegevensinzameling van de de markeringsuitbreiding van SDK van het Web in de Markeringen UI toont.

On before event send callback: Een callback-functie voor het evalueren en wijzigen van de lading die naar de Adobe wordt verzonden. Gebruik de content variabele binnen de callback functie om de nuttige lading te wijzigen. Deze callback is gelijk aan de tag onBeforeEventSend in de JavaScript-bibliotheek.
Collect internal link clicks: Een selectievakje waarmee de verzameling van gegevens voor het bijhouden van koppelingen binnen uw site of eigenschap wordt ingeschakeld. Wanneer u dit selectievakje inschakelt, worden opties voor gebeurtenisgroepering weergegeven:
- No event grouping: Gegevens voor het bijhouden van koppelingen worden in afzonderlijke gebeurtenissen naar de Adobe verzonden. Koppelingsklikken die in afzonderlijke gebeurtenissen worden verzonden, kunnen het contractuele gebruik van gegevens die naar Adobe Experience Platform worden verzonden verhogen.
- Event grouping using session storage: Gegevens voor het bijhouden van koppelingen opslaan in sessieopslag tot de volgende paginagebeurtenis. Op de volgende pagina worden de opgeslagen gegevens voor het bijhouden van koppelingen en de paginaweergave tegelijkertijd naar de Adobe verzonden. Adobe raadt aan deze instelling in te schakelen bij het bijhouden van interne koppelingen.
- Event grouping using local object: Sla koppelingsvolggegevens in een lokaal object op tot de volgende paginagebeurtenis. Als een bezoeker naar een nieuwe pagina navigeert, gaan de gegevens voor het bijhouden van koppelingen verloren. Deze instelling is het meest geschikt voor toepassingen van één pagina.
Collect external link clicks: Een selectievakje waarmee externe koppelingen kunnen worden verzameld.
Collect download link clicks: Een selectievakje waarmee downloadkoppelingen kunnen worden verzameld.
Download link qualifier: Een reguliere expressie die een link-URL kwalificeert als een downloadkoppeling.
Filter click properties: Een callback-functie voor het evalueren en wijzigen van klikgerelateerde eigenschappen vóór de verzameling. Deze functie wordt uitgevoerd vóór de On before event send callback .
montages van de Context: Verzamel automatisch bezoekersinformatie, die specifieke gebieden XDM voor u bevolkt. U kunt All default context information of Specific context information kiezen. De tag komt overeen met context in de JavaScript-bibliotheek.
- Web: verzamelt informatie over de huidige pagina.
- Device: verzamelt informatie over het apparaat van de gebruiker.
- Environment: verzamelt informatie over de browser van de gebruiker.
- Place context: verzamelt informatie over de locatie van de gebruiker.
- High entropy user-agent hints: verzamelt meer gedetailleerde informatie over het apparaat van de gebruiker.

TIP

Het veld On before link click send is een afgekeurde callback die alleen zichtbaar is voor eigenschappen waarvoor deze al is geconfigureerd. De tag komt overeen met onBeforeLinkClickSend in de JavaScript-bibliotheek. Gebruik de callback van Filter click properties om klikgegevens te filteren of aan te passen, of On before event send callback te gebruiken om de algemene nuttige lading te filtreren of aan te passen die naar Adobe wordt verzonden. Wanneer zowel de callback als de callback On before link click send zijn ingesteld, wordt alleen de callback Filter click properties uitgevoerd.Filter click properties

Instellingen voor mediaverzamelingen configureren media-collection

Met de functie voor het verzamelen van media kunt u gegevens verzamelen die betrekking hebben op mediasessies op uw website.

De verzamelde gegevens kunnen informatie over media playbacks, pauzes, voltooiing, en andere verwante gebeurtenissen omvatten. Nadat deze gegevens zijn verzameld, kunt u deze naar Adobe Experience Platform en/of Adobe Analytics verzenden om rapporten te genereren. Deze functie biedt een uitgebreide oplossing voor het bijhouden en begrijpen van het gedrag van het mediaconsumptie op uw website.

Beeld dat de montages van de media inzameling van de de markeringsuitbreiding van SDK van het Web in de Markeringen UI toont

Channel: De naam van het kanaal waar de media inzameling voorkomt. Voorbeeld: Video channel .
Player Name: De naam van de mediaspeler.
Application Version: De versie van de mediaspeltoepassing.
Main ping interval: Frequentie van pings voor hoofdinhoud, in seconden. De standaardwaarde is 10 . Waarden kunnen variëren van 10 tot 50 seconden. Als geen waarde wordt gespecificeerd, wordt de standaardwaarde gebruikt wanneer het gebruiken van automatisch-gevolgde zittingen.
Ad ping interval: Frequentie van pings voor advertentie-inhoud, in seconden. De standaardwaarde is 10 . Waarden kunnen variëren van 1 tot 10 seconden. Als geen waarde wordt gespecificeerd, wordt de standaardwaarde gebruikt wanneer het gebruiken van automatisch-gevolgd zittingen

Gegevensstroomoverschrijvingen configureren datastream-overrides

Met overschrijvingen van gegevensstroom kunt u aanvullende configuraties voor uw gegevensstreams definiëren. Deze configuraties worden via de SDK van het web doorgegeven aan de Edge Network.

Dit helpt u verschillend gegevensstroomgedrag dan de standaarddegenen teweegbrengen, zonder het creëren van een nieuwe gegevensstroom of het wijzigen van uw bestaande montages.

De configuratieopheffing van gegevensstroom is een proces in twee stappen:

Eerst, moet u uw configuratie van de gegevensstroom met voeten treden in de gegevenstream configuratiepagina.
Dan, moet u de met voeten treden naar de Edge Network of via een bevel van SDK van het Web, of door de de markeringsuitbreiding van SDK van het Web te gebruiken.

Zie de datastream configuratie met voeten treedt documentatievoor gedetailleerde instructies op hoe te om configuraties van de gegevensstroom met voeten te treden.

Als alternatief voor het overgaan van de met voeten treedt door een bevel van SDK van het Web, kunt u de met voeten treden in het scherm van de markeringsuitbreiding vormen hieronder wordt getoond die.

IMPORTANT

DataStream-overschrijvingen moeten per omgeving worden geconfigureerd. De ontwikkelings-, staging- en productieomgevingen hebben allemaal verschillende overschrijvingen. U kunt de instellingen tussen de instellingen kopiëren met behulp van de speciale opties die in het onderstaande scherm worden weergegeven.

Beeld dat de configuratie van de gegevensstroom toont treedt met voeten gebruikend de de marktextensiepagina van SDK van het Web.

Geavanceerde instellingen configureren

Gebruik het veld Edge base path als u het basispad moet wijzigen dat wordt gebruikt voor interactie met de Edge Network. Dit zou niet het bijwerken moeten vereisen, maar in het geval dat u aan bèta of alpha deelneemt, zou de Adobe u kunnen vragen om dit gebied te veranderen.

Beeld dat de geavanceerde montages toont gebruikend de de marktextensiepagina van SDK van het Web.

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743