Contrôler les paramètres d'événement disponibles pour les balises grâce aux transformations

Ce document est destiné aux utilisateurs du taggage côté serveur qui ont besoin de contrôler les paramètres d'événement exposés aux tags.

Un conteneur côté serveur contient un client qui accepte les requêtes HTTP entrantes. Les informations de la requête HTTP sont traduites en objets de données d'événement. Vos tags côté serveur lisent l'objet de données d'événement.

Les transformations s'exécutent une fois que le client a créé l'objet de données d'événement.

Que sont les transformations ?

Les transformations vous permettent d'inclure, d'exclure ou de modifier les paramètres d'événements générés par votre client avant qu'ils ne soient exposés à des balises. Les transformations vous permettent de protéger les informations sensibles et de contrôler précisément les paramètres d'événement disponibles pour un traitement ultérieur.

Les transformations vous permettent de créer des règles pour:

  • Autoriser le partage avec des tags uniquement pour les paramètres d'événement définis explicitement.
  • Enrichissez les paramètres d'événements en créant des règles pour les modifier ou les ajouter
  • Masquer les informations entrantes en excluant les paramètres d'événement des tags

Vous pouvez appliquer une transformation à l'ensemble de vos balises, à des types de balises entiers ou à un ensemble sélectionné individuellement. De plus, vous pouvez appliquer un ensemble de conditions qui doivent être remplies avant l'exécution de la transformation.

Les variables sont évaluées chaque fois qu'une transformation est exécutée. Selon ce que font vos transformations, vos variables peuvent être résolues en différentes valeurs.

Autoriser les balises à utiliser les paramètres d'événement

La transformation Autoriser les paramètres vous permet de spécifier certains paramètres d'événement que vous souhaitez exposer à vos tags. Les paramètres d'événement qui ne sont pas définis explicitement sont supprimés.

Pour autoriser les balises à utiliser certains paramètres d'événement:

  1. Dans votre espace de travail, ouvrez le menu Transformations.
  2. Créez une règle de transformation.
  3. Cliquez sur Configuration de la transformation et sélectionnez Autoriser les paramètres.
  4. Ajoutez des paramètres d'événement que les tags peuvent utiliser. Consultez tous les paramètres d'événement courants.
  5. Facultatif: Les conditions de correspondance vous permettent de définir des règles indiquant quand activer la transformation. Par défaut, les règles de transformation s'appliquent toujours.
  6. Dans Tags concernés, choisissez les types de tags ou des tags individuels qui répondent à cette règle de transformation. Par défaut, la transformation s'applique à toutes les balises.
  7. Nommez et enregistrez la règle de transformation.

Exemple: Consigner les informations de sélection dans votre table BigQuery

En contrôlant les paramètres que vous enregistrez, vous pouvez:

  • Assurez-vous que les informations sensibles ne sont pas consignées dans votre datastore interne.
  • Évitez la journalisation excessive et économisez de l'espace de stockage, ainsi que des coûts associés au cloud.
  • Stocker des métriques pertinentes pour la surveillance et la création de rapports

Démonstration

Pour autoriser uniquement certains paramètres à être enregistrés:

  1. Créez une règle de transformation.
  2. Cliquez sur Configuration de la transformation et sélectionnez Autoriser les paramètres.
  3. Dans Paramètres à autoriser, ajoutez les paramètres dont vous avez besoin, par exemple event_name, page_hostname, page_path, client_id, etc.
  4. Dans Tags concernés, sélectionnez le tag qui envoie des données à votre entrepôt de données. Pour BigQuery, vous pouvez utiliser addEventCallback et BigQuery APIs dans une balise personnalisée, ou explorer la galerie de modèles de la communauté pour trouver des options prédéfinies permettant de surveiller votre conteneur de serveur.
  5. Nommez et enregistrez la transformation. Le résultat devrait ressembler à ceci: Capture d'écran d'une transformation d'autorisation des paramètres

Enrichir les paramètres d'événements

La transformation Augment des événements vous permet de modifier les valeurs des paramètres d'événement ou d'ajouter de nouveaux paramètres à rendre disponibles aux balises.

Pour modifier ou ajouter certains paramètres d'événement:

  1. Dans votre espace de travail, ouvrez le menu Transformations.
  2. Créez une règle de transformation.
  3. Cliquez sur "Configuration de la transformation", puis sélectionnez Augmenter l'événement.
  4. Dans Paramètres à enrichir:

    • Pour modifier des paramètres d'événement existants, saisissez le paramètre à modifier dans le champ Nom, puis ajoutez une nouvelle valeur. Consultez tous les paramètres d'événement courants.

    • Pour ajouter une valeur d'objet de données d'événement, saisissez le nom et la variable de votre choix.

  5. Facultatif: Les conditions de correspondance vous permettent de définir des règles indiquant quand activer la transformation. Par défaut, les règles de transformation s'appliquent toujours.

  6. Dans Tags concernés, choisissez les types de tags ou des tags individuels qui répondent à cette règle de transformation. Par défaut, la transformation s'applique à toutes les balises.

  7. Nommez et enregistrez la règle de transformation.

Exemple: Configurer des enchères basées sur la valeur pour les événements d'achat

Les enchères basées sur la valeur vous permettent d'améliorer les performances des campagnes en optimisant votre budget publicitaire afin de cibler les utilisateurs les plus intéressants pour votre entreprise. Une fois que vous avez configuré les enchères basées sur la valeur, Google Ads utilise votre valeur de conversion pour définir des enchères plus intéressantes pour vous. La transformation Augment des événements est utile pour configurer des enchères basées sur la valeur côté serveur.

Démonstration

Les instructions suivantes ne s'appliquent que si la balise de suivi des conversions Google Ads ne spécifie aucune valeur de conversion.

Pour configurer des enchères basées sur la valeur:

  1. Créez une règle de transformation.
  2. Cliquez sur Configuration de la transformation et sélectionnez Augmenter l'événement.
  3. Dans Paramètres à augmenter, ajoutez une ligne. Configurez une variable pour charger la valeur monétaire de votre article dans la transformation :
    1. Dans le paramètre Nom, saisissez le nom de la valeur que vous souhaitez ajuster ; par exemple value. Remplacez tous les champs value, car ils représentent la valeur monétaire d'un événement.
    2. Dans le paramètre Value (Valeur), configurez une variable qui récupère les prix de votre base de données. Par exemple, si vous stockez des données produit dans Firestore, ajoutez une variable Firestore Lookup.
  4. Dans Conditions de correspondance, configurez cette transformation uniquement pour certains événements. Si vous souhaitez appliquer uniquement les enchères basées sur la valeur aux événements d'achat, définissez {{Event Name}} est égal à purchase.
  5. Dans Balises concernées, ajoutez toutes les balises de suivi des conversions Google Ads auxquelles cette transformation doit s'appliquer.
  6. Attribuez un nom à la balise, puis enregistrez-la. Le résultat devrait ressembler à ceci : Capture d'écran montrant une transformation des paramètres d'amélioration

Exclure des paramètres d'événement des tags

La transformation Exclure les paramètres est utile pour supprimer des paramètres d'événement spécifiques de vos balises.

Attention: Les tags peuvent ne pas fonctionner comme prévu lorsque les paramètres requis sont exclus. Vérifiez les paramètres sur lesquels reposent vos balises avant de transformer les paramètres.

Pour exclure des balises de certains paramètres d'événement:

  1. Dans votre espace de travail, ouvrez le menu Transformations.
  2. Créez une règle de transformation.
  3. Cliquez sur "Configuration de la transformation" et sélectionnez Exclure les paramètres.
  4. Ajoutez des paramètres d'événement que les balises ne peuvent pas utiliser. Consultez tous les paramètres d'événement courants.
  5. Facultatif: Les conditions de correspondance vous permettent de définir des règles indiquant quand activer la transformation. Par défaut, les règles de transformation s'appliquent toujours.
  6. Dans Tags concernés, choisissez les types de tags ou des tags individuels qui répondent à cette règle de transformation. Par défaut, la transformation s'applique à toutes les balises.
  7. Nommez et enregistrez la règle de transformation.

Exemple: Exclure certaines dimensions personnalisées GA4 en fonction du consentement de l'utilisateur

Les paramètres d'exclusion vous permettent de contrôler les données first party envoyées à Google. Par exemple, lorsqu'un utilisateur refuse les cookies analytics_storage, vous pouvez supprimer certaines dimensions personnalisées.

Démonstration

Pour supprimer une dimension personnalisée:

  1. Créez une règle de transformation.
  2. Cliquez sur Configuration de la transformation et sélectionnez Exclure les paramètres.
  3. Dans Paramètres à exclure, ajoutez une ligne et définissez les dimensions personnalisées que vous souhaitez exclure, par exemple payment_type ou payment_status.
  4. Dans Conditions de correspondance, configurez la transformation uniquement si l'utilisateur refuse les cookies analytics_storage.
    Formez les conditions suivantes :
    • {{gcs}} est égal à G100
    • {{gcs}} est égal à G110
  5. (Facultatif) Sous Tags concernés, ajoutez tous les tags auxquels cette transformation doit s'appliquer.
  6. Attribuez un nom à la balise, puis enregistrez-la. Le résultat devrait ressembler à ceci:Exemple de transformation de paramètres d'exclusion

Vérifier l'application de vos règles de transformation

Pour vérifier vos règles de transformation, prévisualisez votre espace de travail:

  1. Ouvrez votre site Web.
  2. Dans votre conteneur de serveur Google Tag Manager, sélectionnez Aperçu.

    Tag Assistant démarre et charge votre conteneur de serveur.

  3. Pour afficher toutes les balises et actions déclenchées pour un événement, sélectionnez un nom d'événement dans la liste de gauche.

Vérifiez qu'une transformation a été exécutée:

  1. Si vous souhaitez faire valider votre identité, ouvrez l'onglet Tags.
  2. Sélectionnez une balise qui s'est déclenchée pour afficher ses propriétés, ses requêtes HTTP sortantes, ses déclencheurs de déclenchement et ses transformations.

    Remarque: Les transformations n'affectent que les balises déclenchées. Une transformation peut empêcher le déclenchement de votre balise si elle modifie ou supprime des champs de paramètre d'événement requis.

  3. La vue d'ensemble Détails des balises vous indique les transformations exécutées pour une balise et leur ordre. Voici l'ordre par défaut:

    1. Autoriser les paramètres
    2. Enrichir les paramètres
    3. Exclure les paramètres

    Écran Tag Assistant affichant une vue d'ensemble d'une balise GA4

  4. Pour afficher les détails de la transformation, cliquez sur celle-ci. Les paramètres d'événement fournis au tag s'affichent dans la section Données d'événement.

    Tag Assistant affichant les détails d'une transformation.

  5. Lorsque vous cliquez sur la zone Données d'événement, vous pouvez voir l'état des paramètres des événements après l'exécution de toutes les transformations. Pour afficher les paramètres d'origine et les événements transformés, cochez Afficher l'original.

    Présentation des paramètres d'événement modifiés