De webSDK-tagextensie configureren
De Web SDK de markeringsuitbreiding verzendt gegevens naar Adobe Experience Cloud van Web-eigenschappen door de Edge Network van het Experience Platform.
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 nog niet hebt gedaan, raadpleegt u de documentatie op een tag-eigenschap maken.
Nadat u een eigenschap hebt gemaakt, opent u de eigenschap en selecteert u de Extensions op de linkerzijbalk.
Selecteer het tabblad Catalog. Zoek in de lijst met beschikbare extensies naar de Web SDK en selecteert u Install.
Na het selecteren Install, moet u de de markeringsuitbreiding van SDK van het Web vormen 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 bij 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. Instructies over hoe te opstelling een eerste-partij CNAME zijn 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 handleiding op datastreams leren hoe u een gegevensstroom kunt configureren.
U kunt een gegevensstroom kiezen in de beschikbare vervolgkeuzemenu's of Enter values en voer een aangepaste gegevensstroom-id in 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 en stel deAMCV
cookie gebruikt door Visitor.js. Deze eigenschap is belangrijk wanneer het migreren aan Web SDK, aangezien sommige pagina's nog kunnen gebruiken Visitor.js. Met deze optie kan de SDK hetzelfde blijven gebruiken ECID zodat gebruikers niet als twee afzonderlijke gebruikers worden geïdentificeerd. -
Use third-party cookies: Wanneer deze optie wordt toegelaten, probeert SDK van het Web om een gebruikersherkenningsteken in een derdekoekje op te slaan. 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 >Cookies van derden zijn niet compatibel met de apparaat-id van eerste partij functionaliteit 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 in te schakelen Web SDK lezen en schrijven van de nalatenschap
mbox
enmboxEdgeCluster
cookies die worden gebruikt door at.js1.x
of2.x
bibliotheken. 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 gebruikt1.x
of2.x
en omgekeerd.
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 dialoogvenster <head>
-element van uw pagina.
Instellingen voor gegevensverzameling configureren data-collection
Configuratieinstellingen voor gegevensverzameling beheren. Vergelijkbare instellingen in de JavaScript-bibliotheek zijn beschikbaar via de configure
gebruiken.
-
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 dat de verzameling van gegevens voor het bijhouden van koppelingen intern aan uw site of eigenschap inschakelt. 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: Sla koppelingsvolggegevens op 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.
-
Contextinstellingen: Verzamel automatisch bezoekersinformatie, die specifieke XDM gebieden voor u bevolkt. U kunt All default context information of Specific context information. 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 Filter click properties callback om klikgegevens te filtreren of aan te passen, of gebruik On before event send callback om de totale lading te filteren of aan te passen die naar Adobe wordt verzonden. Als beide Filter click properties callback en de On before link click send callback wordt ingesteld, alleen de Filter click properties callback-uitvoering.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.
- 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 toepassing Media Player.
- Main ping interval: Frequentie van pingelt voor hoofdinhoud, in seconden. De standaardwaarde is
10
. Waarden kunnen variëren van10
tot50
seconden. Als er geen waarde is opgegeven, wordt de standaardwaarde gebruikt bij het gebruik automatisch bijgehouden sessies. - Ad ping interval: Frequentie van pingelt voor advertentie-inhoud, in seconden. De standaardwaarde is
10
. Waarden kunnen variëren van1
tot10
seconden. Als er geen waarde is opgegeven, wordt de standaardwaarde gebruikt bij het gebruik automatisch bijgehouden sessies
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 de configuratie van uw gegevensstroom overschrijven in het dialoogvenster configuratiepagina gegevensstroom.
- 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 gegevensstroom documentatie bij overschrijvingen van configuratie voor gedetailleerde instructies op hoe te om configuraties met betrekking tot 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.
Geavanceerde instellingen configureren
Gebruik de Edge base path veld 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.