Événements recommandés et personnalisés Google Analytics

Utilisez l'API Data Manager pour envoyer des événements recommandés et des événements personnalisés Google Analytics.

Envoyer des événements recommandés et personnalisés

Si vous effectuez une mise à niveau depuis le protocole de mesure Google Analytics, consultez Passer du protocole de mesure à l'API Data Manager pour obtenir des instructions.

Présentation du workflow

Pour envoyer des données d'événement avec l'API Data Manager, procédez comme suit :

1. Préparer les destinations : définissez les objets Destination pour le champ destinations de la requête d'ingestion afin de spécifier le compte cible et la destination de la conversion ou de l'événement. Pour en savoir plus, consultez Préparer les destinations.

2. Préparer les données d'événement et les identifiants : renseignez les champs Event avec les détails de l'événement et les identifiants requis (par exemple, les identifiants de clic sur une annonce, de client ou d'instance d'application). Si vous incluez les coordonnées de l'utilisateur dans userData, normalisez et hachez les identifiants en SHA-256 conformément aux consignes de mise en forme, et éventuellement chiffrez-les. Pour en savoir plus, consultez Préparer les données d'événement.

3. Créer et envoyer la requête d'ingestion : envoyez une requête events.ingest contenant votre destinations, vos enregistrements Event et encryptionInfo si vous avez chiffré userData. Utilisez validateOnly: true pour tester votre charge utile afin de détecter les erreurs d'échec rapide avant d'envoyer les données de production. Consultez Envoyer des événements pour connaître les exigences concernant les champs et obtenir des exemples de code.

4. Vérifier les diagnostics : récupérez les diagnostics de traitement asynchrone et vérifiez l'état d'ingestion avec requestStatus.retrieve.

Cas d'utilisation

Important : L'API Data Manager est destinée à compléter la collecte automatique via gtag, Tag Manager et Google Analytics pour Firebase, et non à la remplacer.

Voici quelques cas d'utilisation pour l'envoi d'événements recommandés et personnalisés avec l'API Data Manager :

• Établir un lien entre les comportements en ligne et hors connexion.

• mesurent les interactions côté client et côté serveur ;

• Envoyer des événements qui se produisent hors de l'interaction utilisateur standard, comme les conversions hors connexion

• Envoyer des événements effectués sur les appareils et dans les applications où la collecte automatique n'est pas disponible (comme les kiosques et les montres)

Données fournies par l'utilisateur

Vous pouvez envoyer des données client first party, telles que des adresses e-mail, des numéros de téléphone et des adresses physiques hachés, dans le champ userData d'un Event. Cela permet d'améliorer la mesure des conversions, l'attribution et la création d'audiences dans Google Analytics.

Tenez compte des points suivants lorsque vous envoyez des données fournies par l'utilisateur :

• Envoyées avec les événements : dans l'API Data Manager, les données fournies par l'utilisateur doivent être envoyées dans un Event. Les importations autonomes sans événement ne sont pas acceptées.

• Mise en forme et hachage : les identifiants personnels (comme l'adresse e-mail, le numéro de téléphone, le nom et l'adresse postale) doivent être normalisés et hachés à l'aide de SHA-256 avant l'importation. Les autres champs (tels que la ville, l'État ou la province, le code postal et le code pays) sont normalisés, mais pas hachés. Suivez le guide Mettre en forme les données utilisateur pour connaître les exigences spécifiques.

• Chiffrement : vous pouvez éventuellement chiffrer les données utilisateur hachées.

• User-ID : nous vous recommandons de fournir userId avec userData chaque fois qu'un identifiant utilisateur cohérent est disponible.

• Implémentation : consultez Ajouter des données fournies par l'utilisateur pour savoir comment créer des requêtes.

Facteurs d'intégration

Tenez compte des points suivants lorsque vous utilisez l'API Data Manager.

Remarketing

Google Analytics est compatible avec le remarketing sur le même appareil lorsque vous activez les signaux Google. Pour le remarketing multi-appareil, userId est obligatoire.

Vous pouvez également envoyer des données fournies par l'utilisateur pour activer la mise en correspondance des audiences propriétaires.

Identifiants publicitaires

Google Analytics associe automatiquement les identifiants publicitaires (comme GBRAID ou WBRAID) collectés lors des interactions en ligne aux événements de l'API Data Manager à l'aide de clientId ou appInstanceId.

Paramètres de confidentialité

Google Analytics associe les événements de l'API Data Manager aux interactions en ligne à l'aide de clientId ou appInstanceId pour adopter les paramètres de confidentialité des utilisateurs tels que "Annonces non personnalisées" et "Limiter le suivi des annonces".

Vous pouvez également spécifier les paramètres de consentement utilisateur directement sur chaque événement à l'aide de l'objet consent.

Informations géographiques et sur l'appareil

Google Analytics associe automatiquement les informations géographiques et sur l'appareil les plus récentes issues du taggage aux événements de l'API Data Manager à l'aide de clientId ou appInstanceId. Cela permet de s'assurer que vos événements de l'API Data Manager sont reflétés dans les rapports qui incluent des dimensions géographiques et d'appareil.

Si vous souhaitez qu'un événement de l'API Data Manager reflète les informations géographiques et sur l'appareil d'une session spécifique au lieu des dernières informations pour clientId ou appInstanceId, incluez une entrée dans additionalEventParameters avec parameterName défini sur session_id et value défini sur l'ID de la session spécifique, puis envoyez l'événement dans les 24 heures suivant le début de la session.

Vous pouvez fournir des informations géographiques et des informations sur l'appareil pour les événements à l'aide de l'API Data Manager.

Intégration complète de serveur à serveur

Bien qu'il soit possible d'envoyer des événements à Google Analytics uniquement avec l'API Data Manager, il se peut que seuls des rapports partiels soient disponibles. L'API Data Manager permet d'enrichir les événements existants collectés à l'aide de gtag, Tag Manager ou Firebase. Certains noms d'événements et de paramètres sont réservés à la collecte automatique et ne peuvent pas être envoyés via l'API Data Manager.

Générer ou renommer des événements

Les événements envoyés avec l'API Data Manager ne déclenchent pas de règles pour générer ou renommer des événements. Votre application doit implémenter la logique permettant d'envoyer des événements personnalisés via l'API Data Manager, de la même manière que les règles configurées dans l'interface utilisateur de Google Analytics.