Créer une intégration de test avec Google Analytics

Ce guide explique comment intégrer un outil de test A/B tiers à Google Analytics. L'intégration permet à vos utilisateurs d'exécuter des variantes de test dans votre outil et d'utiliser Google Analytics pour interpréter les résultats.

À qui cela s'adresse-t-il ?

Ce guide s'adresse principalement aux fournisseurs de solutions de tests A/B tiers.

Présentation

L'intégration entre votre outil de test tiers et Google Analytics nécessite que vous utilisiez :

De plus, l'utilisateur qui lance le test dans votre outil doit disposer du rôle Éditeur (ou supérieur) dans la propriété Google Analytics.

Ajouter le paramètre exp_variant_string à un événement

Vous devez créer un identifiant pour chaque variante, puis l'ajouter au paramètre exp_variant_string dans l'événement experience_impression suivant. Vous utiliserez le paramètre pour créer une audience permettant d'associer un utilisateur à une variante.

gtag('event', 'experience_impression', {
  // Replace the value with the Experiment-variant ID
  exp_variant_string: "ABC-F2948574-3495F49"
});

Envoyez l'événement experience_impression lorsqu'un utilisateur est ajouté à une variante, par exemple lorsqu'une page de test se charge.

Mettre en forme le paramètre

Pour éviter les doublons entre les tests et les autres partenaires, nous vous recommandons d'utiliser le format TOOL_ID-EXPERIENCE_ID-VARIANT_ID pour la valeur du paramètre exp_variant_string, où :

  • TOOL_ID est l'ID de votre outil tiers.
  • EXPERIENCE_ID est l'ID de l'expérience.
  • VARIANT_ID est l'ID de la variante.

Vous pouvez utiliser n'importe quel nombre de caractères pour vos outils, expériences et variantes.

Définir une audience à l'aide du paramètre exp_variant_string

Les audiences vous permettent de regrouper les utilisateurs qui ont été ajoutés à une variante, en fonction du paramètre exp_variant_string. En utilisant ce paramètre comme condition d'appartenance à une audience, vous pouvez ajouter des utilisateurs à l'audience appropriée en fonction de la variante à laquelle ils ont été ajoutés.

Pour créer des audiences pour de nouvelles expériences et archiver celles pour des expériences terminées, utilisez la ressource properties.audiences dans l'API Google Analytics Admin.

Créer des audiences

Le corps de requête suivant crée une audience pour les utilisateurs qui ont été ajoutés à une variante avec l'ID ABC-F2948574-3495F49 à l'aide de la méthode properties.audiences.create. Notez que vous pouvez ajuster la durée de validité en fonction de la durée de l'expérience (540 jours maximum).

Nous vous recommandons de définir le paramètre atAnyPointInTime sur true pour réduire les écarts de données entre les tests. Lorsque vous définissez le paramètre sur true, un utilisateur qui a été attribué à un test réussi peut être attribué à un nouveau test. Lorsque vous définissez le paramètre sur false ou s'il n'est pas défini, l'utilisateur ne peut pas être ajouté à un nouveau test s'il a déjà été attribué à un test réussi.

{
  "displayName": "Audience ABC - experiment F2948574 variant 3495F49",
  "membershipDurationDays": 30,
  "filterClauses": [
    {
      "clauseType": "INCLUDE",
      "simpleFilter": {
        "scope": "AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS",
        "filterExpression": {
          "andGroup": {
            "filterExpressions": [
              {
                "orGroup": {
                  "filterExpressions": [
                    {
                      "eventFilter": {
                        "eventName": "experience_impression",
                        "eventParameterFilterExpression": {
                          "andGroup": {
                            "filterExpressions": [
                              {
                                "orGroup": {
                                  "filterExpressions": [
                                    {
                                      "dimensionOrMetricFilter": {
                                        "fieldName": "exp_variant_string",
                                        "stringFilter": {
                                          "matchType": "EXACT",
                                          "value": "ABC-F2948574-3495F49"
                                        },
                                        "atAnyPointInTime": true
                                      }
                                    }
                                  ]
                                }
                              }
                            ]
                          }
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        }
      }
    }
  ]
}

L'extrait de code précédent crée l'audience suivante :

  • Nom de l'audience : "Audience ABC – variante 3495F49 du test F2948574"
  • Définition d'audience : "Inclure les utilisateurs lorsque : les événements nommés 'experience_impression' ont un paramètre nommé 'exp_variant_string' dont la valeur correspond exactement à 'ABC-F2948574-3495F49'"
  • Durée de l'abonnement : 30 jours

Archiver des audiences

Lorsqu'une expérience se termine, vous devez archiver l'audience à l'aide de la méthode properties.audiences.archive. Archiver des audiences vous permet de libérer de l'espace pour que les utilisateurs puissent créer davantage d'expériences. Les utilisateurs pourront toujours accéder aux données de leurs audiences archivées à l'aide des données historiques de Google Analytics.

Ciblage par type d'audience

Le ciblage d'audience permet à vos clients d'axer un test sur un groupe d'utilisateurs adoptant des comportements spécifiques sur leur site Web. Par exemple, un client peut utiliser le ciblage d'audience pour cibler les clients à fort potentiel avec des offres spéciales et des avantages. Grâce au ciblage d'audience, seuls les utilisateurs inclus dans l'audience voient un test.

Vous pouvez permettre à vos clients de configurer le ciblage d'audience en important les utilisateurs d'une audience depuis Google Analytics, puis en comparant les User-ID ou les identifiants d'appareil de Google Analytics avec les identifiants de votre système. Si ces identifiants correspondent, l'utilisateur est ajouté au test.

Pour exporter des utilisateurs depuis Google Analytics et les importer dans votre client, utilisez l'API Audience List. L'API Audience List fournit un instantané quotidien des utilisateurs d'une audience et vous permet d'exporter les ID utilisateur ou les identifiants d'appareil d'une audience.

Nous vous recommandons de ne demander une liste d'audience qu'une fois par jour et par audience.

Limites

Lorsque vous intégrez des données de test à Google Analytics, tenez compte des capacités et des contraintes suivantes.

Mettre en veille des expériences

Il n'est pas possible de mettre en veille des audiences dans Google Analytics.

Pour permettre aux utilisateurs de suspendre les expériences, vous devez :

  • Arrêter d'envoyer l'événement qui se déclenche lorsqu'un utilisateur devient membre d'une variante
  • Ignorer les événements lorsque l'expérience est suspendue
  • Ajouter des filtres de rapport au rapport Google Analytics pour exclure le temps mis en veille

Vous pouvez également fournir aux utilisateurs un lien leur permettant de modifier manuellement la date dans Google Analytics.

Retraiter les données d'expérience

Si des informations sur les événements manquent aux utilisateurs, Analytics peut retraiter leurs données d'expérience. Lorsque Google Analytics retraite les données d'expérience, les audiences archivées des expériences terminées sont perdues. Toutefois, les utilisateurs peuvent toujours récupérer les données de leur expérience grâce aux événements avec exp_variant_string dans les explorations. Cette méthode est moins précise que les audiences, car les explorations incluent les événements qui se sont produits avant et après l'expérience.

Données d'échantillonnage de l'expérience

Si les utilisateurs peuvent être attribués à plusieurs audiences simultanées, les clients s'exposent à des problèmes de cardinalité (qui peuvent entraîner l'affichage de la ligne "(autre)"). La probabilité que cela se produise augmente à mesure que le nombre d'expériences simultanées et le nombre d'audiences utilisées à d'autres fins (par exemple, les enchères Ads) augmentent.

Toutefois, si le client utilise Google Analytics 360, Google Analytics activera les ensembles de données développés automatiquement lorsque les données seront regroupées dans la ligne "(autre)" pour lui donner un aperçu plus complet de ses données.

Limites de comparaison

Les rapports Google Analytics peuvent afficher jusqu'à quatre comparaisons à la fois. Lorsqu'un utilisateur dispose de plus de quatre variantes, il peut échanger ses audiences dans les comparaisons. Envisagez de privilégier les variantes qui génèrent les meilleurs taux de conversion.

Tests internes et personnalisés

Si vous développez un framework de test personnalisé ou interne au lieu d'intégrer un outil tiers, vous pouvez suivre les performances des tests dans Google Analytics à l'aide d'événements côté client.

Pour enregistrer le moment où un utilisateur est exposé à un test et à une variante :

  1. Envoyez un événement (par exemple, experiment_impression ou un événement personnalisé) contenant des paramètres identifiant l'expérience et la variante.
  2. Enregistrez des dimensions personnalisées de portée événement pour ces paramètres dans votre propriété Google Analytics (par exemple, experiment_id et variant_id).
  3. Pour les rapports, créez des rapports personnalisés dans Explorations et utilisez vos dimensions personnalisées pour comparer les métriques entre différentes variantes.

Exemple : gtags

L'exemple suivant envoie un événement personnalisé pour suivre l'impression d'une variante de test :

// Triggered when a user is bucketed into a variant
gtag('event', 'experiment_impression', {
  'experiment_id': 'homepage_hero_test',
  'variant_id': 'variant_A'
});