Aan de slag met de webextensie SDK
Het gebruik Adobe Experience Platform markeringen (vroeger Lancering) om gebeurtenisgegevens van uw website naar Edge Network en stroomafwaartse oplossingen van Adobe te verzenden.
Alvorens deze stappen te volgen, zorg ervoor dat u tot de volgende bezitsrechten kunt toegang hebben:
- Develop
- Manage extensions
Bovendien zorg ervoor dat u alle toestemmingen onder de volgende categorieën hebt:
- Gegevensmodellering
- Identiteiten
Een XDM-schema maken schema
Het 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. Het is aan te raden een schema te configureren wanneer u gegevens naar de Edge Network verzendt.
- Login aan experience.adobe.com gebruikend uw geloofsbrieven van Adobe ID.
- Ga naar Data Collection > Schemas.
- Selecteer Create schema.
- Selecteer Experience Event en selecteer vervolgens Next .
- Geef het schema een gewenste naam en selecteer vervolgens Finish .
- (Facultatief) kunt u meer gebieden of gebiedsgroepen voor om het even welke extra gegevens toevoegen die u wilt verzamelen.
Een gegevensstroom maken datastream
A Datastream is een configuratie die Edge Network vertelt hoe te om de gegevens te behandelen die u het verzendt. Wanneer u een gegevensstroom vormt om gegevens naar een bepaald product te verzenden, gaat de gegevensstroom automatisch relevante gegevens over aan elk respectieve product op een manier die het specifieke product begrijpt.
- Ga naar Data Collection > Datastreams.
- Selecteer New datastream.
- Geef de gegevensstroom een gewenste naam en selecteer het onlangs gemaakte schema onder Mapping schema .
- Selecteer Save.
Een tag-eigenschap maken
Nadat u een schema en een gegevensstroom hebt gemaakt, kunt u een eigenschap voor tags maken en configureren.
- Ga naar Data Collection > Tags.
- Selecteer New property.
- Geef de eigenschap tag een gewenste naam en domein en selecteer vervolgens Save .
De extensie van de tag installeren
De Web SDK-tagextensie is geïnstalleerd op een bepaalde tag-eigenschap.
- Navigeer naar Data Collection > Tags > Extensions .
- Selecteer het tabblad Catalog.
- Gebruik de zoekopdracht om de extensie Adobe Experience Platform Web SDK te zoeken.
- Selecteer de extensiekaart en selecteer vervolgens Install aan de rechterkant.
De tagextensie configureren
Wanneer u de de markeringsuitbreiding van SDK van het Web installeert, wordt u automatisch genomen aan de pagina van de Configuratie .
- Onder de sectie van Gegevensstromen , selecteer de gewenste gegevensstroom voor elk milieu.
Alle andere configuratie-instellingen worden voor u ingevuld of optioneel. Stel de gewenste configuratie-instellingen in en selecteer vervolgens Save .
Een gegevenselement met variabele maken
Adobe adviseert gebruikend Veranderlijke gegevenselementen om de nuttige lading op te slaan die u naar Adobe wilt verzenden. XDM-objecten zijn ook beschikbare gegevenselementen, maar zijn ouder en beperkter in toepasselijke gebruiksgevallen.
-
Ga naar Data Collection > Tags.
-
Selecteer de gewenste eigenschap tag.
-
Selecteer Data elements > Create new data element .
-
Geef het gegevenselement de volgende eigenschappen op de linkerzijde:
- Name: Elke gewenste naam
- Extension: Adobe Experience Platform Web SDK
- Data element type: Variable
-
Stel de volgende eigenschappen in aan de rechterkant:
Variabel type: XDM
Sandbox: De sandbox waarin u het schema hebt gemaakt
Schema: Het gewenste schema -
Selecteer Save.
Een regel maken
Regels bepalen wanneer u iets wilt activeren of variabelen wilt instellen. Als u een regel maakt die wordt uitgevoerd wanneer de bibliotheek wordt geladen, kunt u gemakkelijk variabelen vullen die u op elke pagina een waarde wilt bevatten.
-
Ga naar Data Collection > Tags.
-
Selecteer de gewenste eigenschap tag.
-
Selecteer Rules > Add rule .
-
Geef de regel een gewenste naam.
-
Selecteer het pictogram '
+' naast Events . -
Geef de gebeurtenis de volgende instellingen:
- Extension: Core
- Event type: Library loaded (page top)
-
Selecteer Keep changes.
In de bovenstaande stappen wordt het criterium onderdeel van de regel vastgelegd, dat moet worden geactiveerd zodra de bibliotheek is geladen. In de volgende stappen wordt aangegeven welke maatregelen moeten worden genomen wanneer aan die criteria wordt voldaan.
-
Selecteer het pictogram '
+' naast Actions . -
Geef de actie de volgende montages op de linkerzijde:
- Extension: Adobe Experience Platform Web SDK
- Action type: Send event
-
Stel de volgende velden rechts in:
- XDM: Het XDM-gegevenselement voor variabelen
-
Selecteer Keep changes.
Publiceren
De eigenschap tag bevat alle componenten die nodig zijn om gegevens naar de Edge Network te verzenden.
- Ga naar Data Collection > Publishing flow.
- Selecteer Add library.
- Geef de bibliotheek een gewenste naam. Denk aan deze naam gelijkaardig aan a commit name wanneer het werken in de software van de versiecontrole.
- Stel het vervolgkeuzemenu voor de omgeving in op Development .
- Selecteer Add all changed resources.
- Selecteer Save & build to Development.
Uw wijzigingen worden nu geïmplementeerd in uw ontwikkelomgeving.
- Ga naar Data Collection > Environments.
- Selecteer het installatiepictogram naast de ontwikkelomgeving
- Installeer de insluitcode in een testwebpagina op uw site.
Nadat u hebt gecontroleerd of de tag werkt in uw ontwikkelomgeving, kunt u de interface van Publishing flow gebruiken om de bibliotheek te publiceren naar 'staging' en uiteindelijk naar productie.
- Voeg de uitbreiding en de regel aan a Bibliotheek toe, bouw het aan een Milieu, en installeer de ingebedde code op uw plaats.
- Valideer met Adobe Experience Platform Debugger.
U hebt nu een slanke opstelling die gebeurtenissen vangt en hen naar Edge Network verzendt. U kunt uw implementatie nu verder opbouwen door velden toe te voegen aan uw schema, producten toe te voegen aan een gegevensstroom of gegevenselementen toe te voegen aan uw markeringseigenschap.