Een gegevenselement, een regel en een bibliotheek toevoegen

In deze les, zult u uw eerste Element van Gegevens, Regel, en Bibliotheek creëren.

Gegevenselementen en regels zijn de basisbouwstenen van tags. In Data Elements worden de kenmerken opgeslagen die u naar uw marketing- en advertentieoplossingen wilt verzenden, terwijl Regels de aanvragen naar die oplossingen onder de juiste voorwaarden afhandelen. Bibliotheken zijn de JavaScript-bestanden die op de pagina worden geladen om al het werk te doen. In deze les, zult u alle drie gebruiken om onze steekproefpagina te maken iets doen.

NOTE
Adobe Experience Platform Launch wordt in Adobe Experience Platform geïntegreerd als een reeks technologieën voor gegevensverzameling. Verschillende terminologiewijzigingen zijn geïmplementeerd in de interface die u tijdens het gebruik van deze inhoud moet onthouden:

Leerdoelen

Aan het eind van deze les, zult u kunnen:

  • Een data-element maken
  • Een regel maken
  • Een bibliotheek maken
  • Wijzigingen toevoegen aan een bibliotheek
  • Controleren of uw bibliotheek in uw webbrowser wordt geladen
  • De functie 'Werkbibliotheek' gebruiken om efficiënter te werken

Een gegevenselement voor paginanaam maken

Gegevenselementen zijn de versie van een gegevenslaag van een tag. Ze kunnen waarden opslaan van uw eigen gegevenslaagobject, cookies, lokale opslagobjecten, querytekenreeksparameters, pagina-elementen, metatags enzovoort. In deze oefening, zult u een gegevenselement voor de Naam van de Pagina creëren, dat u later in uw Doel en implementaties van Analytics zult gebruiken.

Een gegevenselement maken

  1. Klik in de linkernavigatie op Gegevenselementen

  2. Aangezien u nog geen gegevenselementen in dit bezit hebt gecreeerd, verschijnt een korte video met extra informatie over dit onderwerp. Kijk naar deze video, als je wilt.

  3. Klik op de knop Nieuw gegevenselement maken knop:

    Klik op de knop Nieuw data-element maken

  4. Geef het gegevenselement een naam, bijvoorbeeld Page Name

  5. Gebruik de JavaScript-variabele Het type van Element van gegevens om aan een waarde in de de gegevenslaag van uw steekproefpagina te richten: digitalData.page.pageInfo.pageName

  6. Schakel de selectievakjes in voor Waarde in kleine letters forceren en Tekst opschonen om het hoofdlettergebruik te standaardiseren en vreemde ruimten te verwijderen

  7. Verlaten Geen als de Opslagduur instellen omdat deze waarde op elke pagina anders is

  8. Klik op de knop Opslaan knop om het gegevenselement op te slaan

    Het gegevenselement Paginanaam maken .

NOTE
Mogelijkheden gegevenselement kan worden uitgebreid met extensies. Bijvoorbeeld, staat de uitbreiding ContextHub u toe om gegevenselementen toe te voegen gebruikend eigenschappen van de uitbreiding.

Een regel maken

Vervolgens gebruikt u dit gegevenselement in een eenvoudige regel. Regels zijn een van de krachtigste functies in tags en u kunt opgeven wat er moet gebeuren als de bezoeker communiceert met uw website. Wanneer aan de criteria in uw regels wordt geschetst, teweegbrengt de regel de actie teweeg u hebt gespecificeerd.

U gaat een regel tot stand brengen die de het gegevenselementwaarde van de Naam van de Pagina aan de browser console uitvoert.

Een regel maken

  1. Klik in de linkernavigatie op Regels

  2. Aangezien u nog geen regels in dit bezit hebt gecreeerd, verschijnt een korte video met extra informatie over het onderwerp. Kijk naar deze video, als je wilt.

  3. Klik op de knop Nieuwe regel maken knop:

    Klik op de knop Nieuwe regel maken

  4. Naam van de regel All Pages - Library Loaded. Deze naamgevingsconventie geeft aan waar en wanneer de regel wordt geactiveerd, zodat u deze eenvoudiger kunt herkennen en gebruiken wanneer de eigenschap tag rijpt.

  5. Klik onder Gebeurtenissen op Toevoegen. De gebeurtenis vertelt tags wanneer de regel moet worden geactiveerd en kan vele dingen zijn, zoals het laden van een pagina, een klik, een aangepaste JavaScript-gebeurtenis, enzovoort.

    Geef een naam op voor de regel en voeg een gebeurtenis toe

    1. Als gebeurtenistype selecteert u Bibliotheek geladen (pagina boven). Wanneer u het gebeurtenistype selecteert, wordt met de labels vooraf een naam voor de gebeurtenis ingevuld met uw selectie. De standaardvolgorde voor de gebeurtenis is 50. Orderen is een krachtige functie in tags die u nauwkeurige controle geeft over de volgorde van handelingen wanneer u meerdere regels hebt die door dezelfde gebeurtenis worden geactiveerd. Deze functie wordt later in de zelfstudie gebruikt.

    2. Klik op de knop Wijzigingen behouden knop

    Selecteer een gebeurtenis

  6. Aangezien deze regel op alle pagina's moet worden toegepast, laat u Voorwaarden leeg. Als u het modaal van Voorwaarden opent, zult u zien dat de voorwaarden zowel beperkingen als uitsluitingen kunnen toevoegen die op een grote verscheidenheid van opties, met inbegrip van URLs, de waarden van het gegevenselement, datumwaaiers, en meer worden gebaseerd.

  7. Klik onder Handelingen op Toevoegen

  8. Selecteren Handelingstype > Aangepaste code, wat op dit moment de enige optie is. Later in de tutorial worden meer opties beschikbaar wanneer u uitbreidingen toevoegt.

  9. Selecteren </> Editor openen om de code-editor te openen

    Een handeling selecteren

  10. Voeg het volgende toe aan de code-editor. Deze code zal de waarde van het gegevenselement van de Naam van de Pagina aan de browser console uitvoeren zodat kunt u het bevestigen werkt:

    code language-javascript
    console.log('The page name is '+_satellite.getVar('Page Name'));
    
  11. De code-editor opslaan

    Aangepaste code invoeren

  12. Klik in het configuratiescherm Handeling op Wijzigingen behouden

  13. Klikken Opslaan om de regel op te slaan

Op de pagina van Regels, zou u uw nieuwe regel moeten zien:
De regel wordt op de pagina weergegeven

Uw wijzigingen in een bibliotheek opslaan

Nadat u een verzameling extensies, gegevenselementen en regels in de interface voor gegevensverzameling hebt geconfigureerd, moet u deze mogelijkheden en logica in een set JavaScript-code verpakken die u op uw website kunt implementeren, zodat marketingtags worden geactiveerd wanneer bezoekers naar de site komen. Een bibliotheek is de set JavaScript-code die dit doet.

In een vroegere les, uitvoerde u de inbedcode van uw ontwikkelomgeving op de steekproefpagina. Wanneer u de voorbeeldpagina hebt geladen, is een fout van 404 geretourneerd voor de insluitcode-URL omdat er nog geen tagbibliotheek is gemaakt en toegewezen aan de omgeving. Nu plaatst u het nieuwe gegevenselement en de nieuwe regel in een bibliotheek zodat de voorbeeldpagina iets kan doen.

Een bibliotheek toevoegen en maken

  1. Klik in de linkernavigatie op Publishing Flow

  2. Klikken Nieuwe bibliotheek toevoegen

    Nieuwe bibliotheek toevoegen

  3. Geef de bibliotheek een naam, bijvoorbeeld Initial Setup

  4. Selecteren Omgeving > Ontwikkeling

  5. Klikken Alle gewijzigde bronnen toevoegen

    Alle gewijzigde bronnen toevoegen

  6. Na het klikken op Alle gewijzigde bronnen toevoegen de markeringen vatten de veranderingen samen u enkel aanbracht.

  7. Klikken Opslaan en bouwen voor ontwikkeling

    Opslaan en samenstellen voor ontwikkeling

Na enkele ogenblikken wordt de statuspunt groen om aan te geven dat de bibliotheek is gemaakt.

Bibliotheek gemaakt

Uw werk valideren

Bevestig nu dat uw regel zoals verwacht werkt.

Laad de voorbeeldpagina opnieuw. Als u de Hulpmiddelen van de Ontwikkelaar -> het lusje van het Netwerk bekijkt, zou u nu een 200 reactie voor uw markeringsbibliotheek moeten zien!

Bibliotheek wordt geladen met 200 reacties

Als u de Developer Tools -> Console bekijkt, ziet u de tekst "De paginanaam is home"

Console-bericht

Gefeliciteerd, u hebt uw eerste gegevenselement en regel gemaakt en uw eerste tagbibliotheek gemaakt!

De functie Werkbibliotheek gebruiken

Wanneer u veel wijzigingen aanbrengt in tags, is het niet handig om naar het tabblad Publiceren te komen, wijzigingen toe te voegen en de bibliotheek te maken wanneer u het resultaat wilt zien. Nu u uw bibliotheek van de "Aanvankelijke Opstelling"hebt gecreeerd, kunt u een eigenschap gebruiken genoemd "het Werken Bibliotheek"om uw veranderingen snel te bewaren en de bibliotheek in één enkele stap opnieuw op te bouwen.

Breng een kleine wijziging aan in de regel "Alle pagina's - Bibliotheek geladen". Klik in de linkernavigatie op Regels en klik vervolgens op de knop All Pages - Library Loaded om het te openen.

De regel opnieuw openen

Op de Edit Rule pagina, klikt u op de knop Werkbibliotheek vervolgkeuzelijst en selecteer uw Initial Setup bibliotheek.

Eerste instelling selecteren als werkbibliotheek

Nadat u de bibliotheek hebt geselecteerd, ziet u dat de Opslaan knop wordt nu standaard ingesteld op Opslaan in bibliotheek. Als u een wijziging in de tags aanbrengt, kunt u deze optie gebruiken om de wijziging automatisch rechtstreeks toe te voegen aan uw werkbibliotheek en/of opnieuw samen te stellen.

Test het. Open de handeling Aangepaste code en voeg alleen een dubbele punt toe na de tekst 'De paginanaam is', zodat het hele codeblok wordt gelezen:

console.log('The page name is: '+_satellite.getVar('Page Name'));

Sla de code op, houd de wijzigingen in de actie en klik nu op de knop Opslaan in bibliotheek en samenstellen knop.

De optie Opslaan en samenstellen bestaat nu

Wacht even totdat de groene stip weer verschijnt naast de Werkbibliotheek vervolgkeuzelijst. Laad nu de voorbeeldpagina opnieuw en u ziet dat de wijziging doorwerkt in het consolemelding (u moet mogelijk de cache van de browser wissen en opnieuw laden om de wijziging in de pagina te kunnen zien):

Console-bericht met dubbele punt

Dit is een veel snellere manier van werken en u zult deze benadering voor de rest van het leerprogramma gebruiken.

Volgende "Omgevingen wisselen met de Experience Cloud Debugger" >

recommendation-more-help
45774420-d03e-4a6b-94b5-cd639ae825b2