Google Data Layer-extensie

Met de extensie Google-gegevenslaag kunt u een Google-gegevenslaag gebruiken in de implementatie van Tags. De extensie kan onafhankelijk of gelijktijdig worden gebruikt met Google-oplossingen en met open source uit Google Helpbibliotheek gegevenslaag.

De Helperbibliotheek verstrekt gelijkaardige gebeurtenis-gedreven functionaliteit aan de Laag van de Gegevens van de Cliënt van de Adobe (ACDL). De gegevenselementen, regels en handelingen van de extensie Google Data Layer bieden vergelijkbare functionaliteit als in de ACDL-extensie.

Installatie

Als u de extensie wilt installeren, navigeert u naar de extensiecatalogus in de gebruikersinterface voor gegevensverzameling en selecteert u Google Data Layer.

Nadat de extensie is geïnstalleerd, wordt een gegevenslaag gemaakt of geopend bij elke keer dat de Adobe Experience Platform-tagbibliotheek wordt geladen.

Extensieweergave

De extensieconfiguratie kan worden gebruikt om de naam te definiëren van de gegevenslaag die de extensie gebruikt. Als geen gegevenslaag met de gevormde naam aanwezig is wanneer de Markeringen van Adobe Experience Platform wordt geladen, leidt de uitbreiding tot één.

De standaardnaam van de gegevenslaag is de Google-standaardnaam dataLayer.

Gebeurtenissen

De extensie biedt u de mogelijkheid te luisteren naar wijzigingen in de gegevenslaag.

Google-gebeurtenistypen

Google ondersteunt twee manieren om gebeurtenissen te verdringen: Google Tag Manager, met de push() methode en Googles Analytics 4, waarbij de gtag() methode.

Google Data Layer extension versies vóór 1.2.1 die alleen door gebeurtenissen worden ondersteund die zijn gemaakt door push(), zoals wordt weergegeven in de codevoorbeelden op deze pagina.

Versies 1.2.1 en hoger ondersteunen gebeurtenissen die zijn gemaakt met gtag(). Dit is optioneel en kan worden ingeschakeld in het dialoogvenster voor extensieconfiguratie.

Voor meer informatie over push() en gtag() gebeurtenissen, zie Google-documentatie. De informatie wordt ook verstrekt in de configuratie en regeldialogen van de uitbreiding.

Luisteren naar alle markeringen op de gegevenslaag

Als u deze optie selecteert, luistert uw gebeurtenislistener naar elke wijziging die in de gegevenslaag is aangebracht.

Luisteren naar pushberichten, gebeurtenissen uitsluiten

Als u deze optie selecteert, luistert uw gebeurtenislistener naar een willekeurige druk op de gegevens in de gegevenslaag, gebeurtenissen niet inbegrepen.

De volgende voorbeeldpushgebeurtenissen worden door de listener bijgehouden:

dataLayer.push({"data":"something"})

De volgende voorbeeldpushgebeurtenissen worden niet door de listener bijgehouden:

dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})

Luisteren naar alle gebeurtenissen

Als u deze optie selecteert, luistert uw gebeurtenislistener naar elke gebeurtenis die naar de gegevenslaag wordt geduwd.

De volgende voorbeeldpushgebeurtenissen worden door de listener bijgehouden:

dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})

De volgende voorbeeldpushgebeurtenis wordt niet door de listener bijgehouden:

dataLayer.push({"data":"something"})

Luisteren naar specifieke gebeurtenis

Als u een gebeurtenis opgeeft, houdt de gebeurtenislistener alle gebeurtenissen bij die overeenkomen met een bepaalde tekenreeks.

Stel bijvoorbeeld myEvent wanneer u deze configuratie gebruikt, wordt in de listener alleen de volgende pushgebeurtenis bijgehouden:

dataLayer.push({"event":"myEvent"})

Een regex (ECMAScript / JavaScript) kan worden gebruikt om gebeurtenisnamen aan te passen.

Als u bijvoorbeeld 'myEvent\d' instelt, wordt bijgehouden myEvent met een cijfer (\d):

dataLayer.push({"event":"myEvent1"})
dataLayer.push({"event":"myEvent2"})

Acties

Naar gegevenslaag duwen push-to-data-layer

De extensie biedt u twee acties om JSON naar de gegevenslaag te duwen, een vrij tekstveld om handmatig de JSON te maken die moet worden geduwd en een sleutelwaardevenster van versie 1.2.0.

Vrije tekst JSON

Met de actie Vrije tekst kunt u gegevenselementen rechtstreeks in de JSON gebruiken. Binnen de redacteur JSON, gegevenselementen zouden moeten worden van verwijzingen voorzien gebruikend percentenaantekening. Bijvoorbeeld: %dataElementName%.

{
  "page": {
    "url": "%url%",
    "previous_url": "%previous_url%",
    "concatenated_values": "static string %dataElement%"
  }
}

Sleutelwaarde multifield

De nieuwere zeer belangrijke multifield dialoog is een gebruikersvriendelijker interface die een duw om toestaat worden gevormd zonder JSON manueel te schrijven.

Google DL Herstellen naar computerstatus

De extensie biedt u een handeling om de gegevenslaag opnieuw in te stellen. Indien gebruikt in een regel die een verandering van de gegevenslaag van Google verwerkt, wordt de gegevenslaag teruggesteld aan de gegevens verwerkte staat van de gegevenslaag op het tijdstip dat de regel werd teweeggebracht. Als de handeling wordt gebruikt in een regel die geen wijziging in een Google-gegevenslaag verwerkt, wordt de gegevenslaag gewist door de handeling.

Gegevenselementen

Het opgegeven gegevenselement kan worden gebruikt tijdens de uitvoering van een regel die wordt geactiveerd door een wijziging in de Google-gegevenslaag (push-gebeurtenis) of in een niet-gerelateerde regel zoals Bibliotheek geladen. In het eerste geval retourneert het gegevenselement een waarde die is ontleend aan de berekende status op het moment van de wijziging van de gegevenslaag. In het laatste geval wordt de berekende status op het tijdstip van de uitvoering van de regel gebruikt.

Een knevelschakelaar staat u toe om te selecteren of het gegevenselement waarden van de volledige gegevens verwerkte staat, of slechts van gebeurtenisinformatie zou moeten terugkeren (als gebruikt in een regel die door een verandering van de gegevenslaag wordt teweeggebracht).

Het gegevenselement kan daarom worden geretourneerd:

Aanvullende informatie

Het gegevenselement en de gebeurtenisdialoogvensters van de extensie bevatten gedetailleerde gebruiksinformatie en voorbeelden.

Aanvullende algemene informatie vindt u in het gedeelte project README