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 het Netwerk van de Rand van het Experience Platform te verzenden, is het belangrijk om deze kerntechnologieën te begrijpen en hoe te om hen te 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 het Netwerk van de Rand 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 het volgende worden verleend eigendomsrechten:
- Ontwikkelen
- Extensies beheren
Zie de handleiding op machtigingen voor gegevensverzameling beheren leren hoe u toegang tot eigendommen en eigendomsrechten kunt 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 al toegang hebt tot Platform, moet u ervoor zorgen dat u allen hebt machtigingen onder de volgende categorieën ingeschakeld:
- Gegevensmodellering
- Identiteiten
Zie de overzicht van de interface voor toegangsbeheer om te leren 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:
- Een schema maken om te bepalen hoe uw gegevens zullen worden gestructureerd wanneer wordt verzonden naar het Netwerk van de Rand.
- Een gegevensstroom maken om te vormen welke bestemmingen u uw gegevens wilt worden verzonden naar.
- De SDK van het Web installeren en configureren om gegevens naar de gegevensstroom te verzenden wanneer bepaalde gebeurtenissen op uw website voorkomen.
Zodra u gegevens naar het Netwerk van de Rand kunt verzenden, kunt u naar keuze ook gebeurtenis doorsturen als uw organisatie hiervoor een licentie heeft.
Een schema maken schema
Experience Data Model (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 het Netwerk van de Rand 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 selecteert u vervolgens XDM ExperienceEvent in het vervolgkeuzemenu.
Er wordt een dialoogvenster weergegeven waarin u wordt gevraagd veldgroepen aan het schema toe te voegen. Om gebeurtenissen te verzenden die SDK van het Web gebruiken, moet u de gebiedsgroep toevoegen AEP Web SDK ExperienceEvent Mixin. 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 de optie selecteert Add field groups.
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.
Het hoofdveld in de structuur selecteren dat u wilt openen Schema properties in het rechterspoor, waar u een naam en facultatieve beschrijving voor het schema kunt verstrekken.
Als u meer velden aan het schema wilt toevoegen, selecteert u Add onder de Field groups in het linkerspoor.
Nadat u de gewenste velden hebt toegevoegd, selecteert u Save het schema opslaan.
Een gegevensstroom maken datastream
Een gegevensstroom is een configuratie die het Netwerk van de Rand 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.
Selecteren Datastreams in de linkernavigatie. Van hieruit kunt u een bestaande gegevensstroom selecteren in de lijst die u wilt bewerken, of u kunt een nieuwe configuratie maken door New Datastream.
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 raadpleegt u de datastreams, overzicht.
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 het Netwerk van de Rand te verzenden.
Het proces kan als volgt worden samengevat:
- De SDK van Adobe Experience Platform Web installeren op een tag-eigenschap toegang te krijgen tot zijn mogelijkheden.
- Een XDM Object-gegevenselement maken om variabelen op uw website aan de structuur van het XDM schema toe te wijzen u eerder creeerde.
- Een regel maken om SDK te vertellen wanneer het gegevens naar het Netwerk van de Rand zou moeten verzenden.
- Bibliotheek maken en installeren om de regel op uw website te implementeren.
De SDK installeren op een tag-eigenschap install-sdk
Selecteren Tags in de linkernavigatie om een lijst van markeringseigenschappen te tonen. U kunt desgewenst een bestaande eigenschap kiezen die u wilt bewerken, of u kunt New Property in plaats daarvan.
Geef bij het maken van een nieuwe eigenschap een beschrijvende naam op en stel de Platform tot Web. Geef het volledige domein voor de webeigenschap op en selecteer Save.
De overzichtspagina voor de eigenschap wordt weergegeven. Van hier, selecteer Extensions in de linkernavigatie selecteert u vervolgens Catalog. Zoek de lijst voor het Web SDK van het Platform (naar keuze het gebruiken van de onderzoeksbar om resultaten te beperken) 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 gebruikt u het vervolgkeuzemenu om de gegevensstroom te selecteren die u in een eerdere stap. Als u de gegevensstroom hebt ingesteld, selecteert u Save om de SDK naar de eigenschap te installeren.
Een XDM-gegevenselement maken data-element
De SDK kan alleen gegevens naar het Edge-netwerk verzenden als die gegevens zijn toegewezen aan het XDM-schema dat u hebt gemaakt in een vorige stap. Deze toewijzing wordt verwezenlijkt door het gebruik van een gegevenselement.
Selecteer in de gebruikersinterface Data Elements selecteert u vervolgens Create New Data Element.
Selecteer in het volgende scherm de optie Adobe Experience Platform Web SDK onder de Extension vervolgkeuzelijst, selecteert u vervolgens XDM object voor het elementtype data.
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 velden met een sterretje (*) geeft velden aan die automatisch worden ingevuld wanneer gebeurtenissen worden gestart. Voor alle andere gebieden, kunt u de structuur van het schema onderzoeken en de rest gegevens invullen.
cartAbandonsTotal
) naar een XDM-veld door naar de naam ervan in het veld Value veld, omgeven door procenttekens (%
).Nadat u de gegevens hebt toegewezen aan het schema, geeft u een naam voor het gegevenselement op voordat u selecteert Save.
Een regel maken
Nadat u het gegevenselement hebt opgeslagen, is de volgende stap een regel te creëren die het naar het Netwerk van de Rand 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 de optie Rules in de linkernavigatie selecteert u 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). Selecteren Add krachtens 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 optie Core en selecteert u vervolgens de extensie Submit gebeurtenistype onder de Form categorie.
Met de gebeurtenis voor het verzenden van formulieren kunt u een CSS-kiezer om naar een specifiek element te verwijzen waarop de regel moet worden geactiveerd. In het onderstaande voorbeeld wordt de id add-to-cart-form
wordt gebruikt, zodat deze regel alleen wordt geactiveerd voor het formulier "Toevoegen aan winkelwagentje". Selecteren 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 de "If" door aan de regel aanvullende voorwaarden toe te voegen.
Anders, is de volgende stap een actie voor de regel toe te voegen om uit te voeren wanneer het brandt. Selecteren Add krachtens Actions om door te gaan.
De pagina voor actieconfiguratie wordt weergegeven. Om de regel te krijgen om gegevens naar het Netwerk van de Rand te verzenden, selecteer Adobe Experience Platform Web SDK voor de verlenging, 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 de kleur eventType
XDM-veld. Onder XDM data, geef de naam op van het XDM-gegevenstype dat u eerder hebt gemaakt (omringd door percentagetekens) of selecteer het databasepictogram (
Selecteren Keep Changes wanneer gereed.
Zodra u klaar bent met het configureren van de regel, 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.
Zie de handleiding voor meer informatie over het maken van een bibliotheek, het toevoegen van extensies en regels aan de bibliotheek en het bouwen van die bibliotheek aan een omgeving. bibliotheken beheren in 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 installeren, omgevingen voor meer informatie .
Nadat u de omgeving op uw website hebt geïnstalleerd, kunt u uw implementatie testen met Adobe Experience Platform Debugger.
Gebeurtenis door:sturen configureren (optioneel) event-forwarding
Zodra u SDK hebt gevormd om gegevens naar het Netwerk van de Rand te verzenden, kunt u opstelling gebeurtenis door:sturen om het Netwerk van de Rand te vertellen waar u dat gegevens wilt worden geleverd.
Om gebeurtenis te gebruiken door:sturen, moet u eerst een gebeurtenis creëren door:sturen bezit. Selecteren Event Forwarding in de linkernav selecteert u vervolgens New Property. Geef een naam op voor de eigenschap voordat u deze selecteert Save.
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 build is voltooid, bestaat de laatste stap uit het bijwerken van de gegevensstroom die u eerder geconfigureerd en laat gebeurtenis toe door:sturen. Navigeer naar Datastreams en selecteer de desbetreffende gegevensstroom in de lijst. 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 het Netwerk van de Rand 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.