Overzicht van end-to-end gegevensverzameling

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.

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:

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:

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:

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 schema

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.

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.

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.

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.

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.

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

toe

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

Een gegevensstroom maken datastream

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.

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.

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 install

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.

Het proces kan als volgt worden samengevat:

De SDK installeren op een tag-eigenschap install-sdk

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.

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 .

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 .

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

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.

Een XDM-gegevenselement maken data-element

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 .

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

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.

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.

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

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 .

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 .

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 .

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 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.

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.

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.

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

Bibliotheek maken en installeren library

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.

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) event-forwarding

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.

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.

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.