Documentatie Experience Platform Tutorial voor Web SDK

De gebeurtenis van de opstelling door:sturen met de gegevens van SDK van het Web van het Platform

Laatst bijgewerkt: 16 juli 2024

Onderwerpen:

Gemaakt voor:

Beginner
tussenpersoon
Ontwikkelaar

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.

SDK van het Web en gebeurtenis die diagram door: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:

NOTE

De het Web SDK van het Platform en Mobiele SDK van het Platform vereisen geen plaatsing door markeringen, echter, wordt het gebruiken van markeringen om deze SDKs op te stellen geadviseerd.

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:
- Eerste configuratie
- Configuratie van tags

Een eigenschap voor het doorsturen van gebeurtenissen maken

Begin door een gebeurtenis-door:sturen bezit te creëren:

Open de interface van de Inzameling van Gegevens
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 Environment datastream
Selecteren Add Service
toe
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 Development

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.

NOTE

Een webhaak is een manier om verschillende systemen in halfreal-time te integreren. WebHaak.siteis een derdehulpmiddel dat u gemakkelijk (met de visuele Bouwer van de Acties van de Douane, of WebHaakScript) om het even welke inkomende HTTP- verzoek of e-mail laat inspecteren, testen en automatiseren.

IMPORTANT

U moet reeds gegevenselementen en in kaart gebrachte gegevenselementen aan een Voorwerp XDM, evenals gevormde markeringsregels hebben gecreeerd en die veranderingen binnen een bibliotheek aan een markeringsmilieu bouwt om verder te werk te gaan. Als u niet hebt, verwijs naar de stappen van de Configuratie van 0} Codes in de eerste vereistensectie. Die stappen zorgen ervoor dat het gegeven wordt verzonden naar de Edge Network van het Platform, en van daar kunt u een gebeurtenis-door:sturen bezit vormen om gegevens aan een niet-Adobe oplossing door:sturen.

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.

IMPORTANT

Er is één zeer belangrijk syntaxisverschil wanneer het van verwijzingen voorzien van gebieden XDM in gebeurtenis door:sturen tegenover andere contexten. Als u wilt verwijzen naar gegevens in een eigenschap voor het doorsturen van gebeurtenissen, moet het pad naar het gegevenselement het voorvoegsel arc.event bevatten:

arc staat voor de context van de Reactie van de Adobe.
Bijvoorbeeld: arc.event.xdm.web.webPageDetails.URL

Als dit pad onjuist is opgegeven, worden geen gegevens verzameld.

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.

TIP

U kunt de XDM objecten weg ook vinden door uw hulpmiddelen van het Webbrowser netwerk te gebruiken, die voor /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 CORE achter
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 CORE achter
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

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.

TIP
Wanneer het werken met uw eigen website, kunt u de XDM objecten weg met uw hulpmiddelen van het Webbrowser netwerk vinden, die voor /ee verzoeken 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.
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

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

NOTE

Als u het Staging en de productie gebeurtenis-door:sturen eigenschappen aan uw gegevensstroom niet hebt verbonden, zult u het milieu van de Ontwikkeling als enige optie zien om een bibliotheek aan te bouwen.

sparen gebeurtenis-door:sturen regel

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!

Volgende:

NOTE

Bedankt dat u tijd hebt geïnvesteerd in het leren over de SDK van Adobe Experience Platform Web. Als u vragen hebt, algemene terugkoppelen wilt delen, of suggesties over toekomstige inhoud hebben, gelieve hen op deze Communautaire besprekingspost van de Experience League te delen

recommendation-more-help