Intégration de Google Analytics

Assistance d'un développeur requise

Vous aurez besoin de l’aide de votre équipe de développement pour configurer l’intégration. Veuillez partager ce guide avec eux.

La fonctionnalité User ID de Google Analytics vous permet de collecter et d’appliquer des données utilisateur complètes en connectant plusieurs sources de données aux mêmes utilisateurs. Connectez Pushwoosh à Google Analytics et utilisez les données GA pour la segmentation de l’audience et le ciblage de vos campagnes de notifications push. Voyons comment cela fonctionne.

Activer le User ID

Pour activer la fonctionnalité User ID dans votre compte Google Analytics, suivez le guide de Google : https://support.google.com/analytics/answer/3123666

Note

N’oubliez pas de créer une vue de rapport User ID (comme décrit à l’Étape 3 du guide GA sur l’activation du User ID).

Configurer le User ID dans votre code de suivi

Note

Nous sommes compatibles avec Google Tag Manager

Nous vous encourageons à utiliser Google Tag Manager (GTM) pour intégrer le SDK Pushwoosh. Le code suivant est basé sur GTM, mais il est facile de le modifier pour qu’il s’exécute comme un simple Javascript sur une page.

Intégrer le SDK Web de Pushwoosh

Pour intégrer le SDK Pushwoosh dans votre Google Tag Manager, suivez le guide du SDK Web Push.

Créer une balise User ID dans GTM

Créez une Balise HTML personnalisée qui se déclenche sur le déclencheur Toutes les pages.
Utilisez le code suivant pour configurer le User ID qui correspond aux données utilisateur entre Pushwoosh et Google Analytics.

Dans l’exemple ci-dessous, nous utilisons l’ID matériel Pushwoosh (HWID) pour configurer le User ID. Vous pouvez utiliser un identifiant différent, mais veillez à ne pas mettre d’adresses e-mail ou d’autres informations personnellement identifiables (PII) dans le User ID, car cela n’est pas conforme à la Politique de confidentialité de Google Analytics.

JavaScript

<script>
  var registrationStatus = localStorage.deviceRegistrationStatus;
  var registrationId = localStorage.deviceRegistrationId;
  var gaRegistered = registrationStatus === 'registered' ? registrationId : false;

  if (!gaRegistered) {
    var Pushwoosh = Pushwoosh || [];
    Pushwoosh.push(['onPermissionGranted', function(api) {
      api.getParams()
        .then(function(params) {
          var hwid = params.hwid;
          ga('set', 'userId', hwid);
          ga('send', 'pageview');
          localStorage.setItem('deviceRegistrationId', hwid);
          api.registerUser(hwid);
        })
    }])
};
</script>

Ajouter le User ID à la balise de vue de page

Modifiez votre balise de vue de page pour inclure le User ID s’il est connu pour l’utilisateur :

JavaScript

<script>
  var hwid = localStorage.deviceRegistrationId;
  var registrationStatus = localStorage.deviceRegistrationStatus;
  var isNeedToTrackUser = hwid && registrationStatus === "registered";

  if (isNeedToTrackUser) {
    ga('set', 'userId', hwid);
  };
  ga('send', 'pageview');
</script>

Tester avec le rapport de couverture User ID

Pour tester l’intégration, utilisez le « rapport de couverture User ID » :
https://support.google.com/analytics/answer/3123670

Note

Veuillez noter que le traitement des données par GA prend environ une journée.

Explorateur d’utilisateurs

Sélectionnez votre vue de rapport User ID dans Google Analytics. Ajoutez-y des segments pour découper et analyser votre audience.

Vous pouvez voir vos User IDs affichés dans la colonne « User ID ». Utilisez le bouton Exporter et sélectionnez l’option CSV pour télécharger la liste des User IDs.

Envoyer des notifications push aux User IDs de GA

Pour envoyer un push aux utilisateurs de votre audience GA, utilisez One-Time Push et à l’étape Audience, choisissez Importer un segment. Téléchargez le fichier CSV que vous avez exporté de Google Analytics et mappez la colonne qui contient les User IDs au champ User ID. En savoir plus