Documentatie Experience Platform Dataverzameling

Overzicht van end-to-end gegevensverzameling

Laatst bijgewerkt: 25 juli 2024

Onderwerpen:
Aankoop-id's

Gemaakt voor:

Ontwikkelaar

Adobe Experience Platform verzamelt en stuurt uw gegevens naar andere producten van de Adobe en andere bestemmingen. Om gebeurtenisgegevens van uw toepassing naar de Edge Network van het Experience Platform te verzenden, is het belangrijk om deze kerntechnologieën te begrijpen en hoe te hen vormen om uw gegevens aan de bestemmingen te leveren u vereist, wanneer u het vereist.

Deze gids verstrekt een zelfstudie op hoog niveau van hoe te om een gebeurtenis door de Edge Network te verzenden gebruikend de mogelijkheden van de gegevensinzameling van het Platform. Specifiek, doorloopt het leerprogramma de stappen om de de marktextensie van SDK van het Web van Adobe Experience Platform binnen UI van de Inzameling van Gegevens (vroeger Adobe Experience Platform Launch) te installeren en te vormen.

NOTE

U kunt er ook voor kiezen om de SDK handmatig te installeren en te configureren als u geen tags wilt gebruiken, maar de omringende stappen moeten nog steeds worden uitgevoerd zoals hieronder wordt beschreven.

Alle stappen die de UI van de Inzameling van Gegevens impliceren kunnen ook in de UI van het Experience Platform worden uitgevoerd.

Vereisten

Dit leerprogramma gebruikt UI van de Inzameling van Gegevens om een schema tot stand te brengen, een gegevensstroom te vormen, en SDK van het Web te installeren. Om deze acties in UI uit te voeren, moet u toegang tot minstens één Webbezit samen met de volgende bezitsrechtenworden verleend:

Ontwikkelen
Extensies beheren

Zie de gids over het leiden toestemmingen voor gegevensinzamelingleren hoe te om toegang tot eigenschappen en bezitsrechten te verlenen.

Om de diverse producten van de Inzameling van Gegevens te gebruiken die in deze gids worden vermeld, moet u toegang tot gegevensstromen en de capaciteit ook hebben om schema's tot stand te brengen en te beheren. Als u toegang tot een van deze functies nodig hebt, neemt u contact op met het accountteam van de Adobe om u te helpen de benodigde toegang te krijgen. Houd er rekening mee dat als u Adobe Experience Platform niet hebt aangeschaft, Adobe u zonder extra kosten toegang biedt tot de SDK.

Als u reeds toegang tot Platform hebt, moet u ervoor zorgen dat u alle toestemmingenonder de volgende toegelaten categorieën hebt:

Gegevensmodellering
Identiteiten

Zie het overzicht van toegangsbeheer UIleren hoe te om toestemmingen voor de mogelijkheden van het Platform aan gebruikers te verlenen.

Procesoverzicht

Het proces om gegevensinzameling voor uw website te vormen kan als volgt worden samengevat:

creeer een schemaom te bepalen hoe uw gegevens wanneer wordt verzonden naar de Edge Network gestructureerd zullen zijn.
creeer een datastreamom te vormen welke bestemmingen u uw gegevens wilt worden verzonden naar.
installeer en vorm SDK van het Webom gegevens naar de gegevensstroom te verzenden wanneer bepaalde gebeurtenissen op uw website voorkomen.

Zodra u gegevens naar de Edge Network kunt verzenden, kunt u naar keuze gebeurtenis ook vormen door:sturenals uw organisatie een vergunning voor het heeft.

Een schema maken

Model van de Gegevens van de Ervaring (XDM)is een open-bronspecificatie die gemeenschappelijke structuren en definities voor gegevens in de vorm van schema's verstrekt. Met andere woorden, XDM is een manier om uw gegevens op een manier te structureren en te formatteren die door de Edge Network en andere toepassingen van Adobe Experience Cloud kan actie ondernemen.

De eerste stap in vestiging uw verrichtingen van de gegevensinzameling is een schema te creëren XDM om uw gegevens te vertegenwoordigen. In een latere stap in deze zelfstudie wijst u de gegevens toe die u naar de structuur van dit schema wilt verzenden.

NOTE

XDM-schema's zijn zeer aanpasbaar. In plaats van overdreven voorschrijvend te zijn, concentreren de hieronder geschetste stappen zich specifiek op de schemavereisten voor het Web SDK. Buiten deze parameters kunt u de resterende structuur van uw gegevens definiëren, hoe u dat ook wilt.

Selecteer in de gebruikersinterface Schemas in de linkernavigatie. Van hier, kunt u een lijst van eerder gecreeerd schema's zien die tot uw organisatie behoren. Selecteer Create schema en selecteer vervolgens XDM ExperienceEvent in het vervolgkeuzemenu om door te gaan.

werkruimte van Schemas

Er wordt een dialoogvenster weergegeven waarin u wordt gevraagd veldgroepen aan het schema toe te voegen. Als u gebeurtenissen wilt verzenden met de SDK van Web, moet u de veldgroep AEP Web SDK ExperienceEvent Mixin toevoegen. Deze gebiedsgroep bevat definities voor gegevensattributen die automatisch door de bibliotheek van SDK van het Web worden verzameld.

Gebruik de zoekbalk om de lijst te versmallen, zodat u deze veldgroep gemakkelijker kunt vinden. Nadat u deze hebt gevonden, selecteert u deze in de lijst voordat u Add field groups selecteert.

werkruimte van Schemas

Het schemacanvas verschijnt, tonend een boomstructuur van uw schema XDM met inbegrip van de gebieden die door de het gebiedsgroep van SDK van het Web worden verstrekt.

Schemastructuur

Selecteer het basisveld in de boomstructuur dat u Schema properties wilt openen in de rechtertrack, waar u een naam en een optionele beschrijving voor het schema kunt opgeven.

Naam het schema

Als u meer velden aan het schema wilt toevoegen, selecteert u Add onder de sectie Field groups in de linkertrack.

voeg gebiedsgroepen toe

NOTE

Zie de gids op toevoegend gebiedsgroepenin de documentatie XDM voor gedetailleerde stappen op hoe te om naar verschillende gebiedsgroepen te zoeken om uw gebruiksgevallen aan te passen.

U kunt het beste alleen velden toevoegen voor gegevens die u wilt verzenden via de Edge Network. Nadat u velden hebt toegevoegd aan een schema en dit hebt opgeslagen, kunnen alleen aanvullende wijzigingen in het schema worden aangebracht. Zie de sectie over de regels van schemaevolutievoor meer informatie.

Nadat u de gewenste velden hebt toegevoegd, selecteert u Save om het schema op te slaan.

sparen het schema

Een gegevensstroom maken

Een gegevensstroom is een configuratie die de Edge Network vertelt waar u uw gegevens wilt worden verzonden. Specifiek, specificeert een datastream welke producten van het Experience Cloud u de gegevens naar wilt verzenden, en hoe u de gegevens wilt worden behandeld en in elk product worden opgeslagen.

NOTE

Als u gebeurtenis wilt gebruiken door:sturen(veronderstellend uw organisatie voor de functionaliteit) vergunning wordt gegeven, moet u het voor een gegevensstroom op de zelfde manier toelaten dat u de producten van de Adobe toelaat. De details op dit proces worden behandeld in a recentere sectie.

Selecteer Datastreams in de linkernavigatie. Van hier, kunt u een bestaande gegevensstroom van de lijst selecteren om uit te geven, of u kunt een nieuwe configuratie tot stand brengen door New Datastream te selecteren.

Datastreams

De configuratievereisten voor een gegevensstroom hangen af van welke producten en mogelijkheden u gegevens naar verzendt. Voor gedetailleerde informatie over de configuratieopties voor elk product, verwijs naar het overzicht van gegevensstromen.

De SDK van het Web installeren en configureren

Zodra u een schema en een gegevensstroom hebt gecreeerd, moet de volgende stap het Web SDK van het Platform installeren en vormen beginnen gegevens naar de Edge Network te verzenden.

NOTE

Deze sectie gebruikt UI van de Inzameling van Gegevens om de de markeringsuitbreiding van SDK van het Web te vormen, maar u kunt het ook installeren en vormen gebruikend ruwe code in plaats daarvan. Raadpleeg de volgende hulplijnen voor meer informatie:

Merk ook op dat zelfs als u gebeurtenis slechts wilt gebruiken die door:sturen, u SDK moet nog installeren en vormen zoals die vóór het vormen gebeurtenis die bij a wordt door:sturen later stapwordt beschreven.

Het proces kan als volgt worden samengevat:

installeer SDK van het Web van Adobe Experience Platform op een markeringsbezitom toegang tot zijn mogelijkheden te krijgen.
creeer een XDM gegevenselement van Objectenom variabelen op uw website aan de structuur van het XDM schema in kaart te brengen u eerder creeerde.
creeer een regelom SDK te vertellen wanneer het gegevens naar de Edge Network zou moeten verzenden.
bouwt en installeert een bibliotheekom de regel op uw website uit te voeren.

De SDK installeren op een tag-eigenschap

Selecteer Tags in de linkernavigatie om een lijst met eigenschappen van tags weer te geven. U kunt desgewenst een bestaande eigenschap kiezen die u wilt bewerken, of u kunt New Property selecteren.

Eigenschappen

Als u een nieuwe eigenschap maakt, geeft u een beschrijvende naam op en stelt u Platform in op Web . Geef het volledige domein voor de webeigenschap op en selecteer vervolgens Save .

creeer bezit

De overzichtspagina voor de eigenschap wordt weergegeven. Selecteer hier Extensions in de navigatie links en selecteer vervolgens Catalog . Zoek de vermelding voor de Platform Web SDK (optioneel met de zoekbalk) en selecteer Install .

installeer SDK van het Web

De configuratiepagina voor de SDK wordt weergegeven. De meeste vereiste waarden worden automatisch ingevuld met standaardwaarden die u desgewenst kunt wijzigen.

vorm SDK van het Web

Voordat u de SDK kunt installeren, moet u echter een gegevensstroom selecteren, zodat deze weet waarnaar de gegevens moeten worden verzonden. Onder Datastreams, gebruik het dropdown menu om de gegevensstroom te selecteren die u bij een vroegere stapvormde. Nadat u de gegevensstroom hebt ingesteld, selecteert u Save om de installatie van de SDK op de eigenschap te voltooien.

plaats gegevensstroom en sparen

Een XDM-gegevenselement maken

Opdat SDK gegevens naar de Edge Network verzendt, moeten die gegevens aan het schema worden in kaart gebracht XDM u in a vorige stapcreeerde. Deze toewijzing wordt verwezenlijkt door het gebruik van een gegevenselement.

Selecteer in de gebruikersinterface Data Elements en selecteer vervolgens Create New Data Element .

creeer nieuw gegevenselement

Selecteer in het volgende scherm Adobe Experience Platform Web SDK onder het vervolgkeuzemenu Extension en selecteer vervolgens XDM object voor het type gegevenselement.

XDM objecten type

Het configuratiedialoogvenster wordt weergegeven voor het XDM-objecttype. In het dialoogvenster wordt automatisch de sandbox Platform geselecteerd. Vanuit deze sandbox kunt u alle schema's zien die in die sandbox zijn gemaakt. Selecteer het XDM-schema dat u eerder in de lijst hebt gemaakt.

XDM objecten type

De structuur van het schema wordt weergegeven. Alle gebieden met een asterisk (*) wijzen op gebieden die automatisch bevolken wanneer de gebeurtenissen brand. Voor alle andere gebieden, kunt u de structuur van het schema onderzoeken en de rest gegevens invullen.

gegevens van de Kaart aan XDM gebieden

NOTE

De screenshot hierboven toont hoe u een algemeen toegankelijke variabele van de clientzijde van uw website (cartAbandonsTotal) aan een XDM-veld kunt toewijzen door naar de naam ervan te verwijzen in het Value -veld, omringd door procentuele tekens (%).

U kunt ook andere eerder gemaakte gegevenselementen gebruiken om deze velden te vullen. Zie de verwijzing op gegevenselementenin de markeringsdocumentatie voor meer informatie.

Nadat u de gegevens aan het schema hebt toegewezen, geeft u een naam voor het gegevenselement op voordat u Save selecteert.

Naam en sparen gegevenselement

Een regel maken

Nadat u het gegevenselement hebt opgeslagen, is de volgende stap een regel te creëren die het naar de Edge Network zal verzenden wanneer een bepaalde gebeurtenis op uw website (zoals wanneer een klant een product aan een karretje toevoegt) voorkomt.

U kunt regels instellen voor vrijwel elke gebeurtenis die op uw website kan plaatsvinden. In deze sectie wordt bijvoorbeeld getoond hoe u een regel maakt die wordt geactiveerd wanneer een klant een formulier verzendt. De volgende HTML vertegenwoordigt een eenvoudige webpagina met het formulier "Toevoegen aan winkelwagentje", waarop de regel van toepassing is:

<!DOCTYPE html>
<html>
<body>

  <form id="add-to-cart-form">
    <label for="item">Product:</label><br>
    <input type="text" id="item" name="item"><br>
    <label for="amount">Amount:</label><br>
    <input type="number" id="amount" name="amount" value="1"><br><br>
    <input type="submit" value="Add to Cart">
  </form>

</body>
</html>

Selecteer in de gebruikersinterface voor gegevensverzameling Rules in de linkernavigatie en selecteer vervolgens Create New Rule .

Regels

Geef in het volgende scherm een naam voor de regel op. Van hier, is de volgende stap de gebeurtenis voor de regel (met andere woorden, wanneer de regel zal in brand steken). Selecteer Add onder Events .

regel van de Naam

De pagina voor gebeurtenisconfiguratie wordt weergegeven. Als u een gebeurtenis wilt configureren, moet u eerst het gebeurtenistype selecteren. Gebeurtenistypen worden geleverd door extensies. Als u bijvoorbeeld een gebeurtenis "form submit" wilt instellen, selecteert u de extensie Core en vervolgens het gebeurtenistype Submit onder de categorie Form .

NOTE

Voor meer informatie over de verschillende gebeurtenistypen die door het Webuitbreidingen van de Adobe worden verstrekt, met inbegrip van hoe te om hen te vormen, zie de verwijzing van de uitbreidingen van de Adobein de tagdocumentatie.

De vorm voorlegt gebeurtenis staat u toe om a CSS selecteurte gebruiken om een specifiek element voor de regel van verwijzingen te voorzien om op te slaan. In het onderstaande voorbeeld wordt de id add-to-cart-form gebruikt, zodat deze regel alleen geldt voor het formulier "Toevoegen aan winkelwagentje". Selecteer Keep Changes om de gebeurtenis aan de regel toe te voegen.

de configuratie van de Gebeurtenis

De pagina voor regelconfiguratie wordt opnieuw weergegeven en toont dat de gebeurtenis is toegevoegd. U kunt onderaan "If"versmallen door verdere voorwaarden aan de regel toe te voegen.

Anders, is de volgende stap een actie voor de regel toe te voegen om uit te voeren wanneer het brandt. Selecteer Add onder Actions om door te gaan.

voeg actie toe

De pagina voor actieconfiguratie wordt weergegeven. Als u de regel wilt gebruiken om gegevens naar de Edge Network te verzenden, selecteert u Adobe Experience Platform Web SDK voor de extensie en Send event voor het actietype.

Type van Actie

Het scherm wordt bijgewerkt om extra opties te tonen om de send gebeurtenisactie te vormen. Onder Type kunt u een aangepaste typewaarde opgeven om het eventType XDM-veld te vullen. Onder XDM data, verstrek de naam van het XDM gegevenstype u vroeger (omringd door percententekens) creeerde, of selecteer het gegevensbestandpictogram ( ) om het van een lijst te selecteren. Dit zijn de gegevens die uiteindelijk naar de Edge Network worden verzonden.

Selecteer Keep Changes wanneer u klaar bent.

config van de Actie

Nadat u de regel hebt geconfigureerd, selecteert u Save om het proces te voltooien.

sparen regel

Bibliotheek maken en installeren

Nadat de regel is gevormd, bent u bereid om het aan een markeringsbibliotheek toe te voegen, die bibliotheek aan een milieu te bouwen, en die bouwt op uw website te installeren.

NOTE

Als u nog geen milieu in de Inzameling van Gegevens UI opstelling hebt, moet u dit doen alvorens u een bouwstijl kunt tot stand brengen. Zie de sectie op vormend een milieu voor een Webbezitin de markeringsdocumentatie voor meer informatie.

Leren hoe te om een bibliotheek tot stand te brengen, uitbreidingen en regels aan de bibliotheek toe te voegen, en die bibliotheek aan een milieu te bouwen, zie de gids op het leiden bibliothekenin de tagdocumentatie. Wanneer u de bibliotheek creeert, zorg ervoor dat u de uitbreiding van SDK van het Web van het Platform en de regels van de gegevensinzameling omvat u eerder creeerde.

Nadat u de bibliotheek hebt gemaakt en de build ervan aan een omgeving is toegewezen, kunt u die omgeving op de client van uw website installeren. Zie de sectie over het installeren van milieu'svoor meer informatie.

Nadat u het milieu op uw website hebt geïnstalleerd, kunt u uw implementatietesten gebruikend Adobe Experience Platform Debugger.

Gebeurtenis door:sturen configureren (optioneel)

NOTE

Het doorsturen van gebeurtenissen is alleen beschikbaar voor organisaties die hiervoor een licentie hebben gekregen.

Zodra u SDK hebt gevormd om gegevens naar de Edge Network te verzenden, kunt u gebeurtenis opstelling door:sturen om de Edge Network te vertellen waar u die gegevens wilt worden geleverd.

Om gebeurtenis te gebruiken door:sturen, moet u eerst een gebeurtenis creëren door:sturen bezit. Selecteer Event Forwarding in de linkernav en selecteer vervolgens New Property . Geef een naam op voor de eigenschap voordat u Save selecteert.

Zodra u een gebeurtenis creeert die bezit door:sturen, moet de volgende stap een regel tot stand brengen die bepaalt waar de gegevens zouden moeten worden verzonden. De regels voor gebeurtenis die eigenschappen door:sturen worden geconstrueerd op ongeveer de zelfde manier zoals markeringseigenschappen, met uitzondering dat geen gebeurtenissen kunnen worden gespecificeerd (aangezien gebeurtenis die slechts gebeurtenissen door:sturen behandelt het direct van de datastream ontvangt). Voor de actie van de regel, kunt u gebruik maken van één van de beschikbare gebeurtenis die uitbreidingen door:sturen, of douanecode gebruiken om de gebeurtenis in plaats daarvan te leveren.

Gebeurtenis door:sturen regel

Gelijkaardig aan vroeger, zodra u de regel hebt gevormd, moet u het aan een bibliotheek toevoegen en die bibliotheek aan een milieu bouwen.

Nadat de bouwstijl volledig is, moet de definitieve stap de datastream bijwerken u eerdervormde en gebeurtenis toelaten door:sturen. Navigeer naar Datastreams en selecteer de desbetreffende gegevensstroom in de lijst om te beginnen. Van hier, laat knevel voor gebeurtenis toe door:sturen, en verstrek de namen van het bezit en het milieu dat u enkel vormde.

Gebeurtenis die gegevensstroom door:sturen

Volgende stappen

Deze gids verstrekte een overzicht op hoog niveau van begin tot eind van hoe te om gegevens naar de Edge Network te verzenden gebruikend het Web SDK van het Platform. Raadpleeg de documentatie bij deze handleiding voor meer informatie over de verschillende onderdelen en services in kwestie.

recommendation-more-help