De webSDK-tagextensie configureren
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 .
Nadat u Install hebt geselecteerd, moet u de extensie van de Web SDK-tag configureren en de configuratie opslaan.
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.
- 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.
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.
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.
-
Migrate ECID from VisitorAPI: Deze optie is standaard ingeschakeld. Wanneer deze functie is ingeschakeld, kan de SDK de
AMCV
- ens_ecid
-cookies lezen en deAMCV
-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.
- Migrate Target from at.js to the Web SDK: Gebruik deze optie om Web SDK in te schakelen om de verouderde
mbox
- enmboxEdgeCluster
-cookies die door at.js1.x
- of2.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.js1.x
of2.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.
Instellingen voor gegevensverzameling configureren data-collection
Configuratieinstellingen voor gegevensverzameling beheren. Vergelijkbare instellingen in de JavaScript-bibliotheek zijn beschikbaar via de opdracht configure
.
-
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 tagonBeforeEventSend
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.
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 propertiesInstellingen 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.
- 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 van10
tot50
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 van1
tot10
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.
Standaard is de configuratieoverschrijving van de gegevensstroom uitgeschakeld. De optie Match datastream configuration is standaard geselecteerd.
Als u gegevensstroomoverschrijvingen wilt inschakelen in de tagextensie, selecteert u Enabled in het keuzemenu.
Nadat u de gegevensstroomconfiguratie met voeten treedt, kunt u de overschrijvingen voor elke hieronder beschreven dienst vormen.
De onderstaande gegevensstroomoverschrijvingsinstellingen overschrijven alle configuraties en regels van de gegevensstroom aan de serverzijde voor de geselecteerde omgeving.
Adobe Analytics analytics
Gebruik de montages in deze sectie om gegevens met voeten te treden die aan de dienst van Adobe Analytics verpletteren.
{het beeld van de de marktextensie UI van SDK van 0} Web die de montages van de de gegevensstroom van Adobe Analytics met voeten treedt.
- Enabled / Disabled: gebruik dit vervolgkeuzemenu om gegevensroutering naar de Adobe Analytics-service in of uit te schakelen.
- Report suites: De id's voor de bestemmingsrapportsuites in Adobe Analytics. De waarde moet een vooraf geconfigureerde rapportsuite (of een door komma's gescheiden lijst met rapportsuites) van uw gegevensstroomconfiguratie zijn. Deze instelling overschrijft de primaire rapportsuites.
- Add Report Suite: selecteer deze optie om extra rapportsuites toe te voegen.
Adobe Audience Manager audience-manager
Gebruik de montages in deze sectie om gegevens met voeten te treden die aan de dienst van Adobe Audience Manager verpletteren.
{het beeld van de de marktextensie UI van SDK van 0} Web die de montages van de de gegevensstroom van Adobe Audience Manager met voeten treedt.
- Enabled / Disabled: gebruik dit vervolgkeuzemenu om gegevensroutering naar de Adobe Audience Manager-service in of uit te schakelen.
- Third-party ID sync container: De id voor de synchronisatiecontainer van de doel-id van derden in Audience Manager. De waarde moet een preconfigured secundaire container van uw gegevensstroomconfiguratie zijn en treedt de primaire container met voeten.
Adobe Experience Platform experience-platform
Gebruik de montages in deze sectie om gegevens met voeten te treden die aan de dienst van Adobe Experience Platform verpletteren.
{het beeld van de de marktextensie UI van SDK van 0} Web die de montages van de de gegevensstroom van Adobe Experience Platform met voeten treedt.
- Enabled / Disabled: gebruik dit vervolgkeuzemenu om gegevensroutering naar de Adobe Experience Platform-service in of uit te schakelen.
- Event dataset: De id voor de gegevensset met doelgebeurtenissen in de Adobe Experience Platform. De waarde moet een preconfigured secundaire dataset van uw configuratie van de gegevensstroom zijn.
- Offer Decisioning: gebruik dit vervolgkeuzemenu om gegevensroutering naar de Offer Decisioning -service in of uit te schakelen.
- Edge Segmentation: gebruik dit vervolgkeuzemenu om gegevensroutering naar de Edge Segmentation -service in of uit te schakelen.
- Personalization Destinations: Gebruik dit drop-down menu om gegevens toe te laten of onbruikbaar te maken die aan verpersoonlijkingsbestemmingen verpletteren.
- Adobe Journey Optimizer: gebruik dit vervolgkeuzemenu om gegevensroutering naar de Adobe Journey Optimizer -service in of uit te schakelen.
Adobe Server-kant gebeurtenis doorsturen ssf
Gebruik de montages in deze sectie om gegevens met voeten te treden die aan de server-zij gebeurtenis door:sturen dienst van de Adobe verpletteren.
{het beeld van de de markeringsuitbreiding UI van SDK van 0} Web die de Adobe Server-zij Gebeurtenis toont die montages van de gegevensstroom met voeten treedt.
- Enabled / Disabled: gebruik dit vervolgkeuzemenu om het verzenden van gegevens naar de service Adobe Server-Side Event Forwarding in of uit te schakelen.
Adobe Target target
Gebruik de montages in deze sectie om gegevens met voeten te treden die aan de dienst van Adobe Target verpletteren.
{het beeld van de de marktextensie UI van SDK van 0} Web die de montages van de de gegevensstroom van Adobe Target met voeten treedt.
- Enabled / Disabled: gebruik dit vervolgkeuzemenu om gegevensroutering naar de Adobe Target-service in of uit te schakelen.
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.