De grootste streaminggegevens
In deze les, zult u gegevens stromen gebruikend het Web SDK van Adobe Experience Platform.
Er zijn twee belangrijke taken wij in de interface van de Inzameling van Gegevens moeten voltooien:
-
We moeten Web SDK implementeren op de Luma-website om gegevens over bezoekersactiviteit van de website naar het Adobe Edge-netwerk te verzenden. We zullen een eenvoudige implementatie uitvoeren met behulp van labels (voorheen Starten)
-
We moeten een datastream configureren, die het Edge-netwerk vertelt waar de gegevens moeten worden doorgestuurd. Wij zullen het vormen om de gegevens naar onze
Luma Web Events
dataset in onze zandbak van het Platform te verzenden.
de Ingenieurs van Gegevens zullen het stromen gegevens buiten dit leerprogramma moeten opnemen. Wanneer het uitvoeren van het Web van Adobe Experience Platform of Mobiele SDKs, typisch is een Web of een mobiele ontwikkelaar betrokken bij de verwezenlijking van de gegevenslaag en de configuratie van het markeringsbezit.
Voordat u met de oefeningen begint, bekijkt u deze twee korte video's voor meer informatie over het streamen van gegevensinvoer en Web SDK:
Vereiste machtigingen
In vorm toestemmingenles, u opstelling alle toegangscontroles die worden vereist om deze les te voltooien.
De gegevensstroom configureren
Eerst zullen wij de datastream vormen. Een gegevensstroom vertelt het netwerk van Adobe Edge waar te om de gegevens te verzenden na het ontvangen van het van de vraag van SDK van het Web. Wilt u de gegevens bijvoorbeeld naar Experience Platform, Adobe Analytics of Adobe Target verzenden? De stromen van gegevens worden beheerd in het gebruikersinterface van de Inzameling van Gegevens (vroeger Lancering) en zijn kritiek aan gegevensinzameling met Web SDK.
Maak uw datastream als volgt:
-
Logboek in het gebruikersinterface van de Inzameling van de Gegevens van het Experience Platform
-
Selecteren Datastreams in de linkernavigatie
-
Selecteer de knop New Datastream in de rechterbovenhoek
-
Voor Friendly Name, ga
Luma Platform Tutorial
in (voeg uw naam aan het eind toe, als de veelvoudige mensen van uw bedrijf deze zelfstudie nemen) -
Selecteer de knop Save
In het volgende scherm geeft u op waar u gegevens wilt verzenden. Gegevens verzenden naar Experience Platform:
- In-/uitschakelen Adobe Experience Platform om extra velden beschikbaar te maken
- Selecteer
Luma Tutorial
bij Sandbox - Selecteer
Luma Web Events Dataset
bij Event Dataset - Als u andere toepassingen van de Adobe gebruikt, voel vrij om de andere secties te onderzoeken om te zien welke informatie in de Configuratie van Edge van deze andere oplossingen wordt vereist. Herinner me, werd SDK van het Web ontwikkeld niet alleen om gegevens in Experience Platform te stromen, maar ook om alle vorige bibliotheken te vervangen van JavaScript die door andere toepassingen van de Adobe worden gebruikt. De Configuratie van Edge wordt gebruikt om de rekeningsdetails van elke toepassing te specificeren waarnaar u de gegevens wilt verzenden.
- Selecteren Save
Zodra de Configuratie van Edge heeft bewaard, zal het resulterende scherm drie milieu's voor Ontwikkeling, het Opvoeren, en Productie tonen zijn gecreeerd. Er kunnen extra ontwikkelomgevingen worden toegevoegd:
hebben
Alle drie de milieu's bevatten de details van het Platform u enkel inging. Nochtans, kunnen deze details verschillend per milieu worden gevormd. U kunt bijvoorbeeld elke omgeving gegevens laten verzenden naar een andere platformsandbox. In deze zelfstudie maken we geen verdere aanpassingen van onze gegevensstroom door.
De web SDK-extensie installeren
Een eigenschap toevoegen
Eerst moeten we een eigenschap tag maken (voorheen een eigenschap tag). Een eigenschap is een container voor alle JavaScript, regels en andere functies die zijn vereist voor het verzamelen van gegevens van een webpagina en het verzenden ervan naar verschillende locaties.
Een eigenschap maken:
- Ga naar Properties in de linkernavigatie
- Selecteer de knop New Property
toe - Als Name, ga
Luma Platform Tutorial
in (voeg uw naam aan het eind toe, als de veelvoudige mensen van uw bedrijf deze zelfstudie nemen) - Als Domains voert u
enablementadobe.com
in (zoals verderop wordt uitgelegd) - Selecteren Save
De Web SDK-extensie toevoegen
Nu u een bezit hebt kunt u SDK van het Web toevoegen gebruikend een uitbreiding. Een extensie is een pakket code waarmee de interface en functionaliteit voor gegevensverzameling worden uitgebreid. De extensie toevoegen:
- De eigenschap tag openen
- Ga naar Extensions in de linkernavigatie
- Ga naar de tab Catalog
- Er zijn veel extensies beschikbaar voor tags. De catalogus filteren met de term
Web SDK
- Selecteer in de extensie Adobe Experience Platform Web SDK de knop Install
- Er zijn verscheidene configuraties beschikbaar voor de uitbreiding van SDK van het Web, maar er slechts twee zullen wij voor dit leerprogramma vormen. Werk Edge Domain aan
data.enablementadobe.com
bij. Met deze instelling kunt u cookies van de eerste partij instellen met uw Web SDK-implementatie, wat wordt aangemoedigd. Later in deze les wijst u een website op het domeinenablementadobe.com
toe aan uw eigenschap tag. De CNAME voor hetenablementadobe.com
-domein is al geconfigureerd, zodatdata.enablementadobe.com
door zal sturen naar Adobe servers. Wanneer u Web SDK op uw eigen website implementeert, moet u een CNAME maken voor uw eigen gegevensverzamelingsdoeleinden, bijvoorbeelddata.YOUR_DOMAIN.com
- Selecteer in het vervolgkeuzemenu Datastream de
Luma Platform Tutorial
-gegevensstroom. - Voel vrij om de andere configuratieopties (maar verander hen niet!) te bekijken en selecteer vervolgens Save
Een regel maken voor het verzenden van gegevens
Nu maken we een regel voor het verzenden van gegevens naar Platform. Een regel is een combinatie van gebeurtenissen, voorwaarden en handelingen die ervoor zorgen dat tags iets doen. Een regel maken:
- Ga naar Rules in de linkernavigatie
- Selecteer de knop Create New Rule
- Naam van de regel
All Pages - Library Loaded
- Selecteer onder Events de knop Add
toe - Gebruik Core Extension en selecteer Library Loaded (Page Top) als Event Type. Deze instelling betekent dat de regel wordt geactiveerd wanneer de bibliotheek Starten op een pagina wordt geladen.
- Selecteer Keep Changes om terug te keren naar het hoofdregelscherm
toe - Laat Conditions leeg, want we willen dat deze regel op alle pagina's wordt toegepast, zoals bij de naam die we hem gaven
- Selecteer onder Actions de knop Add
- Gebruik Adobe Experience Platform Web SDK Extension en selecteer Send Event als Action Type
- Selecteer rechts in het vervolgkeuzemenu Type de optie web.webpagedetails.pageViews . Dit is een van de XDM-velden in onze
Luma Web Events Schema
- Selecteer Keep Changes om terug te keren naar het hoofdregelscherm
toe - Selecteer Save om de regel op te slaan
Publish the rule in a library
Vervolgens publiceren we de regel naar onze ontwikkelomgeving, zodat we kunnen controleren of deze werkt.
Een bibliotheek maken:
- Ga naar Publishing Flow in de linkernavigatie
- Selecteren Add Library
toe - Voer bij Name
Luma Platform Tutorial
in - Selecteer
Development
voor Environment - Selecteer de knop Add All Changed Resources . (Naast de extensie Adobe Experience Platform Web SDK en de
All Pages - Library Loaded
-regel, wordt ook de extensie Core toegevoegd die de basis-JavaScript bevat die is vereist voor alle wegeigenschappen van Launch.) - Selecteer de knop Save & Build for Development
Het kan enkele minuten duren voordat de bibliotheek is gemaakt en wanneer deze is voltooid, wordt links van de naam van de bibliotheek een groene stip weergegeven:
Zoals u kunt zien op het scherm Publishing Flow , is er veel meer aan het publicatieproces dat buiten het bereik van deze zelfstudie valt. We gaan gewoon één bibliotheek gebruiken in onze ontwikkelomgeving.
De gegevens in de aanvraag valideren
Het Adobe Experience Platform Debugger toevoegen
Foutopsporing voor Experience Platforms is een extensie die beschikbaar is voor Chrome- en Firefox-browsers en waarmee u de Adobe-technologie kunt bekijken die in uw webpagina's is geïmplementeerd. Download de versie voor uw voorkeursbrowser:
Als u Foutopsporing nooit eerder hebt gebruikt—en deze is anders dan de oudere Adobe Experience Cloud Debugger—kunt u deze overzichtsvideo van vijf minuten bekijken:
De Luma-website openen
Voor deze zelfstudie gebruiken we een openbaar gehoste versie van de Luma-demo-website. Laten we het openen en een bladwijzer maken:
- In een nieuw browser lusje, open de website van de Luma.
- Bladwijzer maken van de pagina voor gebruik in de rest van de zelfstudie
Daarom hebben we enablementadobe.com
in het veld Domains van de initiële configuratie met de eigenschap tag gebruikt en hebben we data.enablementadobe.com
gebruikt als het domein van de eerste partij in de extensie Adobe Experience Platform Web SDK . Zie je, ik had een plan!
Gebruik Foutopsporing Experience Platform om aan uw markeringsbezit in kaart te brengen
Foutopsporing voor Experience Platform heeft een coole functie waarmee u een bestaande eigenschap voor tags kunt vervangen door een andere eigenschap. Dit is nuttig voor bevestiging en staat ons toe om vele implementatiestappen in dit leerprogramma over te slaan.
-
Zorg ervoor dat de Luminasite is geopend en selecteer het extensiepictogram Experience Platform debugger
-
Foutopsporing opent en toont sommige details van de hard-gecodeerde implementatie, die met dit leerprogramma niet verwant is (u kunt de plaats van de Luma na het openen van Debugger moeten opnieuw laden)
-
Bevestig dat Debugger "Connected to Luma"zoals hieronder afgebeeld is en selecteer dan het "lock"pictogram is om Debugger aan de plaats van de Luma te sluiten.
-
Selecteer de knop Sign In rechtsboven om te verifiëren.
-
Ga nu naar Launch in de linkernavigatie
-
Selecteer het tabblad Configuratie
-
Open rechts van waar de Page Embed Codes wordt weergegeven het vervolgkeuzemenu Actions en selecteer Replace
-
Aangezien u voor authentiek wordt verklaard, zal Foutopsporing in uw beschikbare eigenschappen en milieu's van de Lancering trekken. Selecteer uw eigenschap
Luma Platform Tutorial
-
Selecteer uw
Development
-omgeving -
Selecteer de knop Apply
-
De website van de Luma zal met uw markeringsbezit nu opnieuw laden. Help, ik ben gehackt! Grapje.
-
Ga naar Summary in de linkernavigatie om de details van uw eigenschap Launch te bekijken
-
Ga nu naar AEP Web SDK in de linkernavigatie om de Network Requests te zien
-
De rij events openen
-
Let op hoe we het gebeurtenistype
web.webpagedetails.pageView
zien dat we in onze Send Event -actie hebben opgegeven, en andere variabelen die zich buiten het vak bevinden, in deAEP Web SDK ExperienceEvent Mixin
-indeling.
-
Deze types van verzoekdetails zijn ook zichtbaar in de hulpmiddelen van de Webontwikkelaar van browser Netwerk tabel. Open het en laad de pagina opnieuw. Filter voor vraag met
interact
om van de vraag de plaats te bepalen, het te selecteren, en dan in het Kopballen lusje, gebied van de Payload van het Verzoek te kijken.
-
Ga naar het lusje van de Reactie en neem nota hoe de ECID waarde in de reactie inbegrepen is. Kopieer deze waarde zoals u deze gebruikt om de profielgegevens in de volgende oefening te valideren.
Gegevens in Experience Platform valideren
U kunt controleren of de gegevens in Platform landen door de batches met gegevens in de Luma Web Events Dataset
te bekijken. (Ik weet dat het streaming data-opname heet, maar nu zeg ik dat het in batches aankomt! Het stroomt in real time aan Profiel, zodat kan het voor segmentatie en activering in real time worden gebruikt, maar wordt verzonden in partijen om de 15 minuten aan het gegevenspeer.)
De gegevens valideren:
- Ga in de gebruikersinterface van het Platform naar Datasets in de linkernavigatie
- Open
Luma Web Events Dataset
en bevestig dat een partij is aangekomen. Herinner me, worden zij verzonden om de 15 minuten, zodat zou u op de partij kunnen moeten wachten om omhoog te verschijnen. - Selecteer de knop Preview dataset
- Let in de voorvertoningsmodus op hoe u verschillende velden van het schema aan de linkerkant kunt selecteren om een voorvertoning van die specifieke gegevenspunten weer te geven:
U kunt ook bevestigen dat het nieuwe profiel wordt weergegeven:
- Ga in de gebruikersinterface van het Platform naar Profiles in de linkernavigatie
- Selecteer de naamruimte ECID en zoek naar de ECID-waarde (kopieer deze uit de reactie). Het profiel heeft een eigen id, gescheiden van de ECID.
- Selecteer de Profile ID om het profiel te openen
- Selecteer het tabblad Events om de weergegeven pagina's weer te geven
\
Aangepaste gegevens aan de gebeurtenis toevoegen
Een gegevenselement voor een paginanaam maken
-
Open in de interface met tags voor gegevensverzameling rechtsboven in de eigenschap
Luma Platform Tutorial
het vervolgkeuzemenu Select a Working Library en selecteer deLuma Platform Tutorial
-bibliotheek. Met deze instelling kunt u gemakkelijker aanvullende updates naar onze bibliotheek publiceren. -
Ga nu naar Data Elements in de linkernavigatie
-
Selecteer de knop Create New Data Element
-
Als Name voert u
Page Name
in -
Als Data Element Type selecteert u
JavaScript Variable
-
Als JavaScript variable name voert u
digitalData.page.pageInfo.pageName
in -
Als u de notatie van de waarden wilt standaardiseren, schakelt u de selectievakjes Force lowercase value en Clean text in
-
Zorg ervoor dat
Luma Platform Tutorial
is geselecteerd als de werkbibliotheek -
Selecteren Save to Library
De paginanaam toewijzen aan het gegevenselement XDM Object
Nu zullen wij onze paginanaam aan het Web SDK in kaart brengen.
Luma Tutorial Platform
-profiel en voegt u het machtigingsitem Sandboxes > Prod toe. Voer vervolgens een SHIFT-Opnieuw laden op de pagina Data Elements uit om de cache te wissenOp de pagina Data Elements :
- Een nieuw gegevenselement maken
- Als Name voert u
XDM Object
in - Als Extension selecteert u
Adobe Experience Platform Web SDK
- Als Data Element Type selecteert u
XDM object
- Als Sandbox selecteert u de
Luma Tutorial
-sandbox - Als de Schema , selecteert u uw
Luma Web Events Schema
- Selecteer het veld
web.webPageDetails.name
- Als Value selecteert u het pictogram waarmee u het selectiemodel van het gegevenselement wilt openen en het gegevenselement
Page Name
wilt kiezen - Selecteren Save to Library
toe
Hetzelfde proces wordt gebruikt om extra aangepaste gegevens op uw website toe te wijzen aan XDM-velden.
De XDM-gegevens toevoegen aan de handeling Verzendgebeurtenis
Nu u gegevens hebt toegewezen aan XDM-velden, kunt u deze opnemen in de handeling Verzendgebeurtenis:
- Naar het Rules -scherm gaan
- De regel
All Pages - Library Loaded
openen - De handeling
Adobe Experience Platform Web SDK - Send Event
openen - Als XDM data selecteert u het pictogram waarmee u het selectiemodel van het gegevenselement wilt openen en het gegevenselement
XDM Object
wilt kiezen - Selecteer de knop Keep Changes
- Nu u
Luma Platform Tutorial
als werkbibliotheek hebt geselecteerd voor de laatste paar oefeningen, zijn uw recente wijzigingen direct opgeslagen in de bibliotheek. In plaats van onze wijzigingen te publiceren via het scherm Publishing Flow, kunt u gewoon het vervolgkeuzemenu op de blauwe knop openen en Save to Library and Build selecteren
Hiermee maakt u een nieuwe tagbibliotheek met de drie wijzigingen die u zojuist hebt aangebracht.
De XDM-gegevens valideren
U moet nu de startpagina Luma opnieuw kunnen laden, terwijl deze aan uw markeringseigenschap is toegewezen met de foutopsporing zoals u eerder hebt geleerd, en controleren of het veld Paginanaam in de aanvraag wordt ingevuld!
U kunt ook controleren of de gegevens van de paginanaam zijn ontvangen in Platform door een voorbeeld van de gegevensset en het profiel weer te geven.
Extra identiteiten verzenden
Uw implementatie van SDK van het Web verzendt nu gebeurtenissen met Experience Cloud identiteitskaart (ECID) als primaire herkenningsteken. De ECID wordt automatisch gegenereerd door de Web SDK en is uniek per apparaat en browser. Eén klant kan meerdere ECID's hebben, afhankelijk van het apparaat en de browser die hij of zij gebruikt. Dus hoe kunnen we een uniforme weergave van deze klant krijgen en hun online activiteiten koppelen aan onze gegevens over CRM, Loyalty en offline aankoop? Dat doen we door tijdens hun sessie aanvullende identiteiten te verzamelen en hun profiel via identiteitsstitching vastberaden te koppelen.
Als u zich herinnert, vermeldde ik dat wij ECID en identiteitskaart van CRM als identiteiten voor onze Webgegevens in de Identiteiten van de Kaartles zouden gebruiken. Zo verzamelen wij CRM identiteitskaart met het Web SDK!
Gegevenselement toevoegen voor de CRM-id
Eerst slaan wij CRM identiteitskaart in een gegevenselement op:
- Voeg een gegevenselement met de naam
CRM Id
toe aan de taginterface - Als Data Element Type selecteert u JavaScript Variable
- Als JavaScript variable name voert u
digitalData.user.0.profile.0.attributes.username
in - Selecteer de knop Save to Library (
Luma Platform Tutorial
moet nog steeds uw werkbibliotheek zijn)
toe
Voeg CRM-id toe aan het gegevenselement Identiteitskaart
Nu we de CRM-id-waarde hebben vastgelegd, moeten we deze koppelen aan een speciaal type gegevenselement, het gegevenselement Identity Map genaamd:
-
Een gegevenselement met de naam
Identities
toevoegen -
Als Extension selecteert u Adobe Experience Platform Web SDK
-
Als Data Element Type selecteert u Identity map
-
Als Namespace, ga
Luma CRM Id
in, dat is namespace wij in een vroegere les creeerdennote warning WARNING Met de Adobe Experience Platform Web SDK-extensie versie 2.2 kunt u Namespace selecteren in een vooraf ingevuld vervolgkeuzemenu met de werkelijke waarden in uw Platform-account. Helaas is deze functie nog niet 'bewust van de sandbox' en wordt de waarde Luma CRM Id
mogelijk niet weergegeven in het vervolgkeuzemenu. Hierdoor kan het voorkomen dat u deze oefening voltooit. We zullen een tijdelijke oplossing plaatsen zodra dit is bevestigd. -
Als ID selecteert u het pictogram waarmee u het selectiemodel van het gegevenselement wilt openen en het gegevenselement
CRM Id
wilt kiezen -
Als Authenticated State selecteert u Authenticated
-
Verlaat Primary ongecontroleerd. Aangezien identiteitskaart van CRM niet aanwezig voor de meeste bezoekers aan de website van de Luma is, wilt u zeker niet ECID als primaire herkenningsteken met voeten treden. Het zou een zeldzaam geval zijn om iets anders dan de ECID als primaire identificator te gebruiken. Meestal noem ik de standaardinstellingen niet in deze instructies, maar ik roep deze aan om u te helpen hoofdproblemen later in uw eigen implementatie te voorkomen.
-
Selecteer de knop Save to Library (
Luma Platform Tutorial
moet nog steeds uw werkbibliotheek zijn)
Het gegevenselement Identiteitskaart toevoegen aan het XDM-object
Er is nog één gegevenselement dat we moeten bijwerken: het XDM Object-gegevenselement. Het kan vreemd lijken om drie afzonderlijke gegevenselementen bij te werken om deze ene identiteit door te geven, maar dit proces is ontworpen om te schalen voor meerdere identiteiten. Maak je geen zorgen, we zijn bijna klaar met deze les!
- Het XDM Object-gegevenselement openen
- Open het XDM-veld IdentityMap
- Als Data element selecteert u het pictogram waarmee u het selectiemodel van het gegevenselement wilt openen en het gegevenselement
Identities
wilt kiezen - Nu u
Luma Platform Tutorial
als werkbibliotheek hebt geselecteerd voor de laatste paar oefeningen, zijn uw recente wijzigingen direct opgeslagen in de bibliotheek. In plaats van onze wijzigingen te publiceren via het scherm Publishing Flow, kunt u het vervolgkeuzemenu op de blauwe knop openen en Save to Library and Build selecteren
toe
De identiteit valideren
Om te bevestigen dat CRM identiteitskaart nu door het Web SDK wordt verzonden:
- Open de website Luma
- Wijs het aan uw markeringsbezit toe gebruikend Debugger, zoals in vroegere instructies
- Selecteer de Login verbinding op het hoogste recht van de website van de Luma
- Meld u aan met de aanmeldingsgegevens
test@adobe.com
/test
- Zodra voor authentiek verklaard, inspecteer de vraag van SDK van het Web van het Experience Platform in Debugger (Adobe Experience Platform Web SDK > Network Requests > events van het meest recente verzoek) en u zou
lumaCrmId
moeten zien:
- Zoek het gebruikersprofiel op met behulp van de ECID-naamruimte en -waarde. In het profiel, zult u CRM identiteitskaart en ook Loyalty identiteitskaart en de profieldetails zoals de naam en het telefoonaantal zien. Alle identiteiten en gegevens zijn samengevoegd tot één enkel, real-time klantenprofiel!
Aanvullende bronnen
Geweldig werk! Dat was veel informatie over Web SDK en Starten. Er is veel meer betrokken bij een volledige implementatie, maar dat zijn de basisbeginselen om u te helpen aan de slag te gaan en de resultaten in Platform te zien.
Luma Tutorial Platform
verwijderenDe Ingenieurs van gegevens, als u van mening bent kunt vooruit aan de looppas vraaglesoverslaan.
De Architecten van gegevens, kunt u zich op bewegen verenigt beleid!