De gebeurtenis van de opstelling door:sturen met de gegevens van SDK van het Web van het Platform
Leer hoe te om gebeurtenis te gebruiken die met de gegevens van SDK van het Web van Adobe Experience Platform door:sturen.
Het door:sturen van de gebeurtenis is een nieuw type van bezit beschikbaar in de Inzameling van Gegevens. Het door:sturen van gebeurtenissen geeft u de capaciteit om gegevens naar derde, niet-Adobe verkopers rechtstreeks van de Edge Network van Adobe Experience Platform in plaats van traditionele cliënt-zijbrowser te verzenden. Kom meer over de voordelen van gebeurtenis te weten door:sturen in de Gebeurtenis die overzichtdoor:sturen.
Om gebeurtenis te gebruiken die in Adobe Experience Platform door:sturen, moeten de gegevens naar de Edge Network van Adobe Experience Platform eerst worden verzonden gebruikend één of meerdere van de volgende drie opties:
Na de voltooiing van de vorige lessen in dit leerprogramma, zou u gegevens naar de Edge Network van het Platform moeten verzenden gebruikend het Web SDK. Zodra het gegeven in de Edge Network van het Platform is, kunt u gebeurtenis toelaten door:sturen en een gebeurtenis-door:sturen bezit gebruiken om gegevens naar niet-Adobe oplossingen te verzenden.
Leerdoelstellingen
Aan dit eind van deze les, zult u kunnen:
- Een eigenschap voor het doorsturen van gebeurtenissen maken
- Koppel een gebeurtenis-door:sturen bezit aan een gegevensbestand van SDK van het Web van het Platform
- Begrijp de verschillen tussen de gegevenselementen en de regels van het markeringsbezit en gebeurtenis-door:sturen bezitsgegevenselementen en regels
- Een gegevenselement voor het doorsturen van gebeurtenissen maken
- Vorm een gebeurtenis-door:sturen regel
- Valideer een gebeurtenis-door:sturen bezit met succes verzendt gegevens
Vereisten
-
Een softwarelicentie die het doorsturen van gebeurtenissen omvat. Het doorsturen van gebeurtenissen is een betaalde eigenschap van de Inzameling van Gegevens. Neem contact op met het accountteam van uw Adobe voor meer informatie.
-
Het door:sturen van de gebeurtenis wordt toegelaten in uw organisatie van het Experience Cloud.
-
Gebruikersmachtiging voor het doorsturen van gebeurtenissen. (In Admin Console, onder het product van Adobe Experience Platform Launch, toestemmingspunten voor Platforms > Edge en allen Property Rights). Als deze eenmaal is toegekend, ziet u Event Forwarding in de linkernavigatie van de interface voor gegevensverzameling:
-
Adobe Experience Platform Web of Mobiele SDK wordt gevormd om gegevens naar Edge Network te verzenden. U moet de volgende lessen uit deze zelfstudie hebben geleerd:
Een eigenschap voor het doorsturen van gebeurtenissen maken
Begin door een gebeurtenis-door:sturen bezit te creëren:
-
Selecteer Event Forwarding in de linkernavigatie
-
Selecteer New Property.
-
Geef de eigenschap een naam. In dit geval,
Server-Side - Web SDK Course -
Selecteer Save.
De gegevensstroom configureren
Voor gebeurtenis door:sturen om de gegevens te gebruiken u naar de Edge Network van het Platform verzendt, moet u het onlangs gecreeerde gebeurtenis-door:sturen bezit aan de zelfde gegevensstroom verbinden die wordt gebruikt om gegevens naar de oplossingen van de Adobe te verzenden.
Om Doel in de gegevensstroom te vormen:
-
Ga naar de Inzameling van Gegevens{target=“blank”} interface
-
Selecteer Datastreams bij de linkernavigatie
-
Selecteer de eerder gemaakte
Luma Web SDK: Development Environmentdatastream
-
Selecteren Add Service
-
Selecteer Event Forwarding als de Service
-
Selecteer onder het vervolgkeuzemenu Property ID de naam die u aan de eigenschap voor het doorsturen van gebeurtenissen hebt gegeven, in dit geval
Server-Side - Web SDK Course -
Selecteer onder het vervolgkeuzemenu Environment ID de tagomgeving waarnaar u de omgeving voor het doorsturen van gebeurtenissen koppelt, in dit geval
Developmentnote tip TIP Als u gegevens naar een gebeurtenis wilt verzenden die een omgeving buiten de Adobe org doorstuurt, selecteert u Manually enter IDs en plakt u deze in een id. Identiteitskaart wordt verstrekt wanneer u een gebeurtenis-door:sturen bezit creeert. -
Selecteer Save.
Herhaal deze stappen voor het opvoeren en productie gegevensstromen wanneer u bereid bent om uw veranderingen door de het publiceren stroom te bevorderen.
Gegevens doorsturen van de Edge Network Platform naar een oplossing zonder Adobe
In deze oefening leert u hoe te opstelling een gebeurtenis-door:sturen gegevenselement, vormt een gebeurtenis-door:sturen regel, en bevestigt het gebruiken van een derdedeel hulpmiddel genoemd Webhaak.site.
Een gegevenselement voor het doorsturen van gebeurtenissen maken
Het XDM voorwerp u eerder vormde gebruikend de de markeringsuitbreiding van SDK van het Web van het Platform wordt de gegevensbron voor gegevenselementen in een gebeurtenis-door:sturen bezit. U gebruikt de zelfde gegevens die u reeds in het markeringsbezit als gegevensbron voor gebeurtenis-door:sturen hebt gevormd.
arc.event bevatten:arcstaat voor de context van de Reactie van de Adobe.- Bijvoorbeeld:
arc.event.xdm.web.webPageDetails.URL
In deze oefening, zult u de browser viewport hoogte en identiteitskaart van het Experience Cloud van het Voorwerp XDM aan een webhaak door:sturen. Het XDM gebiedspad wordt bepaald door het schema XDM dat tijdens wordt gecreeerd vormt een XDM schemales.
/ee verzoeken filtreren, die de baken Payload openen en neer aan veranderlijk boren u zoekt. Klik vervolgens met de rechtermuisknop en selecteer "Pad eigenschap kopiëren". Hier volgt een voorbeeld voor de Viewport-hoogte van de browser:
-
Ga naar de eigenschap Event Forwarding die u onlangs hebt gemaakt
-
Selecteer Data Elements bij de linkernavigatie
-
Selecteren tot Create New Data Element
-
Name the data element
environment.browserDetails.viewportHeight -
Onder Extension laat u
COREachter -
Onder Data Element Type selecteert u
Path -
Typ het XDM-objectpad dat de weergavehoogte van de browser bevat
arc.event.xdm.environment.browserDetails.viewportHeight -
Selecteren Save
-
Een ander gegevenselement maken
-
Name it
ecid -
Onder Extension laat u
COREachter -
Onder Data Element Type selecteert u
Path -
Typ het XDM-objectpad dat de Experience Cloud-id bevat
arc.event.xdm.identityMap.ECID.0.id -
Selecteren Save
note caution CAUTION Zorg ervoor dat u het voorvoegsel arc.event.in het pad opneemt. Zorg er ook voor dat u de exacte hoofdletter van het veld XDM-object volgt. De naamruimte ECID moet zich in alle hoofdletters bevinden.note tip TIP Wanneer het werken met uw eigen website, kunt u de XDM objecten weg met uw hulpmiddelen van het Webbrowser netwerk vinden, die voor /eeverzoeken filtreren, die het baken Payload openen en neer aan de variabele boren u zoekt. Klik vervolgens met de rechtermuisknop en selecteer "Pad eigenschap kopiëren". Hier volgt een voorbeeld voor de Viewport-hoogte van de browser:
Adobe Cloud Connector-extensie installeren
Als u gegevens naar locaties van derden wilt verzenden, moet u eerst de extensie Adobe Cloud Connector installeren.
-
Selecteer Extensions bij de linkernavigatie
-
Selecteer de tab Catalog
-
Zoek naar Adobe Cloud Connector, uitgezocht Install
Er is geen extensieconfiguratie nodig. Met deze extensie kunt u nu gegevens doorsturen naar een oplossing zonder Adobe!
Creeer een gebeurtenis-door:sturen regel
Er zijn een paar belangrijkste verschillen tussen het vormen regels in een markeringsbezit en een regel in een gebeurtenis-door:sturen bezit:
-
Events&Conditions :
- Markeringen: Alle regels worden teweeggebracht door een Gebeurtenis die in de regel moet worden gespecificeerd, bijvoorbeeld,
Library Loaded - Page Top. Voorwaarden zijn optioneel. - Gebeurtenis door:sturen: Men veronderstelt dat elke gebeurtenis die naar de Edge Network van het Platform wordt verzonden een trekker is om gegevens door:sturen. Daarom zijn er geen Events die in gebeurtenis-door:sturen regels moet worden geselecteerd. Om te beheren welke gebeurtenissen een gebeurtenis-door:sturen regel teweegbrengen, moet u voorwaarden vormen.
- Markeringen: Alle regels worden teweeggebracht door een Gebeurtenis die in de regel moet worden gespecificeerd, bijvoorbeeld,
-
het element van Gegevens kenization:
-
Markeringen: De namen van het gegevenselement worden samengevoegd met a
%aan het begin en eind van de naam van het gegevenselement wanneer gebruikt in een regel. Bijvoorbeeld%viewportHeight%. -
Gebeurtenis door:sturen: De namen van het gegevenselement worden samengevoegd met
{{aan het begin en}}aan het eind van de naam van het gegevenselement wanneer gebruikt in een regel. Bijvoorbeeld{{viewportHeight}}.
-
-
Opeenvolging van regelacties:
- De sectie van Acties van een gebeurtenis die regel door:sturen wordt altijd opeenvolgend uitgevoerd. Zorg ervoor dat de volgorde van de handelingen correct is wanneer u een regel opslaat. Deze uitvoeringsvolgorde kan niet asynchroon worden uitgevoerd, zoals met tags.
Om een regel te vormen om gegevens aan uw webhaak door:sturen, moet u uw persoonlijke webhaak eerst verkrijgen:
-
Ga naar WebHaak.site
-
Vind Uw unieke URL, gebruikt u dit als verzoek URL in uw gebeurtenis-door:sturen regel
-
Selecteren Copy to clipboard
-
Laat dit venster open aangezien u de gebeurtenis kunt bevestigen die gegevens in real time door:sturen die door Webhaak wordt gevangen
-
Ga terug Data Collection > Event Forwarding > Rules van de linkernavigatie
-
Selecteren Create New Rule
-
Naam geven
all events - ad cloud connector - webhook -
Een handeling toevoegen
-
Onder Extension selecteert u Adobe Cloud Connector
-
Onder Action Type selecteert u Make Fetch Call
-
Plak de URL van uw webhaak in het veld URL
-
Onder [de Params van de Vraag], zult u beide gegevenselementen toevoegen u vroeger creeerde.
-
Op het Key kolomtype in
viewPortHeight. Voer in de kolom Value het gegevenselement{{environment.browserDetails.viewportHeight}}in door het in te voeren of te selecteren met het pictogram voor de gegevenselementkiezer -
Selecteer + Voeg nog een toe om een andere vraagparameter toe te voegen
-
Op het Key kolomtype in
ecid. Voer in de kolom Waarde het gegevenselement{{ecid}}in -
Selecteren Keep Changes
-
Je regel moet er hieronder uitzien
-
Selecteren Save
De bibliotheek maken en bouwen
Creeer een bibliotheek en bouw alle veranderingen in uw gebeurtenis-door:sturen ontwikkelomgeving zoals u normaal in een markeringsbezit zou doen.
Valideer gebeurtenis-door:sturen regel
Nu kunt u uw gebeurtenis-door:sturen bezit bevestigen gebruikend de Debugger van het Platform, en WebHaak.site:
-
Volg de stappen aan schakelaar de markeringsbibliotheekop de plaats van de Demo van de Lumaaan het de markeringsbezit van SDK van het Web waaraan u uw gebeurtenis-door:sturen bezit in de datastream in kaart bracht.
-
Voordat u de pagina opnieuw laadt, opent u op Foutopsporing Experience Platform Logs vanuit de linkernavigatie
-
Selecteer het tabblad Edge en selecteer vervolgens Connect om de verzoeken van de Edge Network Platform weer te geven
-
De pagina opnieuw laden
-
U zult extra verzoeken zien die u zicht in de server-zijverzoeken geven die door de Edge Network van het Platform aan WebHook worden verzonden
-
De aanvraag om validatie te activeren is de aanvraag die de volledig samengestelde URL weergeeft die door het Edge-netwerk wordt verzonden
-
Noteer de parameters viewPortHeight en ecid voor de queryreeks
-
Ze komen overeen met de gegevens in het XDM-object
-
Ten slotte, bevestig de gegevensgelijken in Webhaak.siteeveneens door uw open venster van Webhaak te bekijken
Gefeliciteerd! U hebt gebeurtenis gevormd door:sturen!