Extension de la couche de données Google

L’extension de couche de données Google vous permet d’utiliser une couche de données Google dans votre implémentation des balises. L’extension peut être utilisée indépendamment ou simultanément avec les solutions Google et avec Google open source Bibliothèque d’assistance de couche de données.

La bibliothèque d’assistance fournit des fonctionnalités similaires, pilotées par des événements, à la couche de données client Adobe (ACDL). Les éléments de données, les règles et les actions de l’extension de la couche de données de Google fournissent des fonctionnalités similaires à celles de la variable Extension ACDL.

Installation

Pour installer l’extension, accédez au catalogue d’extensions dans l’interface utilisateur de la collecte de données et sélectionnez Couche de données Google.

Une fois installée, l’extension crée ou accède à une couche de données à chaque chargement de la bibliothèque de balises Adobe Experience Platform.

Affichage de l’extension

La configuration de l’extension peut être utilisée pour définir le nom de la couche de données utilisée par l’extension. Si aucune couche de données avec le nom configuré n’est présente lors du chargement des balises Adobe Experience Platform, l’extension en crée une.

Le nom de couche de données par défaut est le nom par défaut de Google. dataLayer.

NOTE
Peu importe que le code Google ou Adobe se charge en premier et crée la couche de données. Les deux systèmes se comportent de la même manière : créez la couche de données si elle n’est pas présente ou utilisez la couche de données existante.

Événements

NOTE
Le mot event est surchargé lorsqu’une couche de données pilotée par un événement est utilisée dans les balises Adobe Experience Platform. Événements peut être :
  • Événements Balises Adobe Experience Platform (bibliothèque chargée, etc.).
  • Événements JavaScript.
  • Données transmises à la couche de données avec la variable event mot-clé.

L’extension vous permet d’écouter les modifications apportées à la couche de données.

NOTE
Il est important de comprendre l’utilisation de la variable event mot-clé lorsque des données sont transmises à une couche de données Google, comme la couche de données client Adobe. La variable event change le comportement de la couche de données Google et donc de cette extension.
Veuillez lire la documentation de Google ou effectuer des recherches si vous n’êtes pas sûr de ce point.

Types d’événement Google

Google prend en charge deux moyens de pousser les événements : Google Tag Manager, à l’aide de la méthode push() et les Google Analytics 4, à l’aide de la méthode gtag() .

Les versions de l’extension de la couche de données Google antérieures à la version 1.2.1 ne prenaient en charge que les événements créés par push(), comme illustré dans les exemples de code de cette page.

Événements de prise en charge 1.2.1 et versions ultérieures créés à l’aide de gtag(). Cette option est facultative et peut être activée dans la boîte de dialogue Configuration de l’extension .

Pour plus d’informations sur push() et gtag() , voir Documentation Google. Des informations sont également fournies dans les boîtes de dialogue de configuration et de règle de l’extension.

Écoute de toutes les transmissions vers la couche de données

Si vous sélectionnez cette option, votre écouteur d’événement écoute toute modification apportée à la couche de données.

Écoute des publications excluant des événements

Si vous sélectionnez cette option, votre écouteur d’événement écoute toute notification push de données vers la couche de données, à l’exception des événements.

L’exemple d’événement push suivant est suivi par l’écouteur :

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

L’exemple d’événement push suivant ne serait pas suivi par l’écouteur :

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

Écoute de tous les événements

Si vous sélectionnez cette option, votre écouteur d’événement écoute tout événement transmis à la couche de données.

L’exemple d’événement push suivant est suivi par l’écouteur :

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

L’exemple d’événement push suivant ne serait pas suivi par l’écouteur :

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

Écoute d’un événement spécifique

Si vous spécifiez un événement, l’écouteur d’événement suit tout événement correspondant à une chaîne spécifique.

Par exemple, si vous définissez myEvent lors de l’utilisation de cette configuration, l’écouteur ne suit que l’événement push suivant :

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

Une expression régulière (ECMAScript/JavaScript) peut être utilisée pour faire correspondre les noms d’événement.

Par exemple, la définition de "myEvent\d" effectue le suivi myEvent avec un chiffre (\d) :

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

Actions

Push to Data Layer (Envoi vers couche de données) push-to-data-layer

L’extension vous fournit deux actions pour pousser JSON vers la couche de données ; un champ de texte libre pour créer manuellement le JSON à transmettre, et à partir de la version 1.2.0, une boîte de dialogue multichamp valeur-clé.

JSON de texte libre

L’action de texte libre permet d’utiliser des éléments de données directement dans le fichier JSON. Dans l’éditeur JSON, les éléments de données doivent être référencés à l’aide de la notation de pourcentage. Par exemple : %dataElementName%.

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

Multi-champ Clé-Valeur

La nouvelle boîte de dialogue multichamp clé-valeur est une interface plus conviviale qui permet de configurer une notification push sans écrire manuellement JSON.

Réinitialisation du langage DL Google à l’état calculé

L’extension vous fournit une action pour réinitialiser la couche de données. Si elle est utilisée dans une règle qui traite une modification de couche de données Google, la couche de données est réinitialisée à l’état calculé de la couche de données au moment où la règle a été déclenchée. Si l’action est utilisée dans une règle qui ne traite pas de modification de couche de données Google, l’action vide la couche de données.

Éléments de données

L’élément de données fourni peut être utilisé lors de l’exécution d’une règle déclenchée par un changement de couche de données Google (événement push) ou dans une règle non liée telle que Bibliothèque chargée. Dans le premier cas, l’élément de données renvoie une valeur extraite de l’état calculé au moment du changement de couche de données. Dans ce dernier cas, l’état calculé au moment de l’exécution de la règle est utilisé.

Un commutateur à bascule vous permet de choisir si l’élément de données doit renvoyer des valeurs de l’état calculé entier ou uniquement des informations d’événement (si utilisé dans une règle déclenchée par un changement de couche de données).

L’élément de données peut donc renvoyer :

  • Champ vide : état calculé de la couche de données.
  • Champ avec clé (tel que page.previous_url dans l’exemple ci-dessus) : valeur de la clé dans l’objet d’événement ou l’état calculé.

Informations supplémentaires

Les boîtes de dialogue d’élément de données et d’événement de l’extension contiennent des informations d’utilisation détaillées et des exemples.

Vous trouverez des informations générales supplémentaires dans la section project README

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743