Balises Universal Analytics

Pour apporter des modifications à l'exécution de votre implémentation Google Analytics sans avoir à recompiler ni à renvoyer le binaire de votre application vers les places de marché, intégrez Universal Analytics (UA) dans votre application avec Google Tag Manager (GTM).

Ce guide explique comment utiliser les balises Universal Analytics et le SDK Google Tag Manager pour iOS pour:

• Envoyer des vues de l'écran
• Envoyer des événements
• Envoyer des transactions e-commerce
• Envoyer des données d'e-commerce amélioré

Remarque : Dans ce guide, nous partons du principe que vous avez suivi le guide de démarrage pour implémenter Google Tag Manager pour iOS.

Envoyer des visionnages de l'écran

Pour envoyer un visionnage de l'écran à Google Analytics chaque fois qu'un nouvel écran est ouvert dans votre application, procédez comme suit:

1. Créez une variable de nom d'écran.
2. Créez un déclencheur d'événement d'écran ouvert.
3. Créez une balise de visionnage de l'écran Universal Analytics.
4. Déployer l'événement d'écran ouvert et le nom de l'écran dans la couche de données

1. Créer une variable de nom d'écran

Pour créer une variable de nom d'écran dans GTM:

1. Connectez-vous à votre compte Google Tag Manager.
2. Sélectionnez un conteneur pour mobile.
3. Dans la barre de navigation de gauche, cliquez sur Variables.
4. Sous Variables définies par l'utilisateur, cliquez sur Nouvelle.
5. Cliquez sur Variable sans titre pour saisir le nom de la variable nom de l'écran.
6. Sélectionnez le type de variable Variable de couche de données.
7. Saisissez screenName dans le champ Nom de la variable de couche de données et définissez sa valeur par défaut : écran inconnu.

   Consultez la capture d'écran expliquant comment créer une variable de nom d'écran.

   

8. Cliquez sur Créer une variable.

2. Créer un déclencheur d'événement d'écran ouvert

Pour créer un déclencheur dans GTM afin d'activer la balise Universal Analytics de visionnage de l'écran, procédez comme suit:

1. Connectez-vous à votre compte Google Tag Manager.
2. Sélectionnez un conteneur pour mobile.
3. Dans la barre de navigation de gauche, cliquez sur Déclencheurs.
4. Cliquez sur New (Nouveau).
5. Cliquez sur Untitled Trigger (Déclencheur sans titre) pour saisir le nom du déclencheur OpenScreenEvent.
6. Sélectionnez un événement Personnalisé.
7. Sous Déclenchement, saisissez la condition suivante:

   

8. Cliquez sur Créer un déclencheur.

3. Créer une balise de visionnage de l'écran Universal Analytics

Pour créer une balise de vue d'écran Universal Analytics déclenchée par l'événement d'écran ouvert:

1. Connectez-vous à votre compte Google Tag Manager.
2. Sélectionnez un conteneur pour mobile.
3. Dans la barre de navigation de gauche, cliquez sur Balises.
4. Cliquez sur New (Nouveau).
5. Cliquez sur Balise sans titre pour saisir le nom de balise Ouvrir l'écran.
6. Sélectionnez le produit Google Analytics.
7. Saisissez l'ID de suivi.
8. Sélectionnez App View (Vue de l'application) comme type de suivi.
9. Cliquez sur Plus de paramètres.
10. Cliquez sur Champs à définir.
11. Cliquez à plusieurs reprises sur + Ajouter un champ pour ajouter les champs suivants:

    

12. Cliquez sur Continuer.
13. Sous Déclenchement, cliquez sur Personnalisé.
14. Sélectionnez le déclencheur personnalisé OpenScreenEvent.
15. Cliquez sur Enregistrer.
16. Cliquez sur Créer une balise.

4. Pousser l'événement d'écran ouvert et le nom de l'écran dans la couche de données

Ajoutez du code à votre application pour envoyer un événement openScreen et une valeur screenName à la couche de données, par exemple:

//  ViewController.m
//  Push an 'openScreen' event to the data layer.
//
#import "ViewController.h"
#import "TAGDataLayer.h"
#import "TAGManager.h"

@implementation ViewController

- (void)viewDidAppear {
    [super viewDidAppear];

    // NOTE: A GTM container should already have been opened, otherwise events
    //     pushed to the DataLayer will not fire tags in that container.
    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    [dataLayer push:@{@"event": @"openScreen",          // Event, name of Open Screen Event.
                      @"screenName": @"Home Screen"}];  // Name of the screen name field, screen name value.
}

// Rest of the ViewController implementation

@end

Envoyer des événements

Pour envoyer un événement à Google Analytics lorsqu'un utilisateur interagit avec les commandes de l'interface utilisateur ou le contenu de votre application, procédez comme suit:

1. (Facultatif) Créez des variables d'événement.
2. Créez un déclencheur d'événement.
3. Créez un tag d'événement Universal Analytics.
4. Transférer les valeurs d'événement et de variable d'événement vers la couche de données

Les étapes suivantes montrent comment un événement est envoyé à Google Analytics lorsqu'un utilisateur lance la lecture d'une vidéo.

1. (Facultatif) Créer des variables d'événement

Si l'événement utilise des variables de couche de données pour représenter ses champs de catégorie, d'action, de libellé ou de valeur, vous devez d'abord créer ces variables. Dans cet exemple, le tag d'événement de lecture de la vidéo utilise une variable de couche de données pour obtenir le nom de la vidéo.

Pour créer une variable de nom de vidéo dans GTM:

1. Connectez-vous à votre compte Google Tag Manager.
2. Sélectionnez un conteneur pour mobile.
3. Dans la barre de navigation de gauche, cliquez sur Variables.
4. Sous Variables définies par l'utilisateur, cliquez sur Nouvelle.
5. Cliquez sur Variable sans titre pour saisir le nom de variable nom de la vidéo.
6. Sélectionnez le type de variable Variable de couche de données.
7. Saisissez videoName dans le champ Nom de la variable de couche de données et définissez sa valeur par défaut sur vidéo inconnue.

   Reportez-vous à la capture d'écran expliquant comment créer une variable de nom de vidéo.

   

8. Cliquez sur Créer une variable.

2. Créer un déclencheur d'événement

Pour créer un déclencheur d'événement dans GTM afin d'activer le tag d'événement Universal Analytics, procédez comme suit:

1. Connectez-vous à votre compte Google Tag Manager.
2. Sélectionnez un conteneur pour mobile.
3. Dans la barre de navigation de gauche, cliquez sur Déclencheurs.
4. Cliquez sur New (Nouveau).
5. Cliquez sur Untitled Trigger (Déclencheur sans titre) pour saisir le nom du déclencheur VideoPlayEvent.
6. Sélectionnez un événement Personnalisé.
7. Sous Déclenchement, saisissez la condition suivante:

   

8. Cliquez sur Créer un déclencheur.

3. Créer un tag d'événement Universal Analytics

Pour créer un tag d'événement Universal Analytics déclenché par l'événement de lecture de la vidéo:

1. Connectez-vous à votre compte Google Tag Manager.
2. Sélectionnez un conteneur pour mobile.
3. Dans la barre de navigation de gauche, cliquez sur Balises.
4. Cliquez sur New (Nouveau).
5. Cliquez sur Balise sans titre pour saisir le nom de balise Événement de lecture vidéo.
6. Sélectionnez le produit Google Analytics.
7. Saisissez l'ID de suivi.
8. Dans Type de suivi, sélectionnez Événement.
9. Saisissez les paramètres de suivi des événements suivants:

   

10. Cliquez sur Plus de paramètres.
11. Cliquez sur Champs à définir.
12. Cliquez à plusieurs reprises sur + Ajouter un champ pour ajouter les champs suivants:

    

13. Cliquez sur Continuer.
14. Sous Déclenchement, cliquez sur Personnalisé.
15. Sélectionnez le déclencheur personnalisé VideoPlayEvent.
16. Cliquez sur Enregistrer.
17. Cliquez sur Créer une balise.

4. Transmettre les valeurs de l'événement et des variables d'événement à la couche de données

Écrivez le code permettant de transmettre un événement videoPlay et une valeur videoName à la couche de données, par exemple:

//  VideoPlayer.m
//  Push a 'videoPlay' event to the data layer.
//
#import "TAGDataLayer.h"
#import "TAGManager.h"
#import "Video.h"
#import "VideoPlayer.h"

@implementation VideoPlayer
// Called when a user initiates a video playback.
- (void)onPlay:(Video *)video {

    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    // This call assumes the container has already been opened, otherwise events
    // pushed to the DataLayer will not fire tags in that container.
    [dataLayer push:@{@"event": @"videoPlay",          // Event, name of Video Play Event.
                      @"videoName": video.title,       // Additional data layer variables used by the event tag.
                      @"screenName": @"Home Screen"}];

    [self play:video];
}

// Rest of the implementation
@end

Envoyer des transactions e-commerce

Important : Pour effectuer le suivi de l'e-commerce, vous devez utiliser les types de suivi des transactions et des articles. Vous ne devez pas utiliser les fonctionnalités de l' e-commerce amélioré pour le suivi standard de l'e-commerce.

Lorsqu'un utilisateur effectue un achat via une application, procédez comme suit pour envoyer la transaction et les articles associés à Google Analytics:

1. Créez un déclencheur de transaction.
2. Créez un tag de transaction Universal Analytics.
3. Transmettre les événements de transaction, les transactions et les articles à la couche de données.

Pour obtenir la liste des noms de variables de transaction et d'article compatibles, consultez la section Variables de couche de données d'e-commerce compatibles.

1. Créer un déclencheur de transaction

Pour créer un déclencheur de transaction dans GTM afin d'activer la balise de transaction Universal Analytics, procédez comme suit:

1. Connectez-vous à votre compte Google Tag Manager.
2. Sélectionnez un conteneur pour mobile.
3. Dans la barre de navigation de gauche, cliquez sur Déclencheurs.
4. Cliquez sur New (Nouveau).
5. Cliquez sur Untitled Trigger (Déclencheur sans titre) pour saisir le nom du déclencheur TransactionTerminé.
6. Sélectionnez un événement Personnalisé.
7. Sous Déclenchement, saisissez la condition suivante:

   

8. Cliquez sur Créer un déclencheur.

2. Créer une balise de transaction Universal Analytics

Pour créer une balise de transaction Universal Analytics déclenchée par l'événement de transaction:

1. Connectez-vous à votre compte Google Tag Manager.
2. Sélectionnez un conteneur pour mobile.
3. Dans la barre de navigation de gauche, cliquez sur Balises.
4. Cliquez sur New (Nouveau).
5. Cliquez sur Balise sans titre pour saisir le nom de balise Transaction Completed (Transaction terminée).
6. Sélectionnez le produit Google Analytics.
7. Saisissez l'ID de suivi.
8. Sélectionnez Transaction comme type de suivi.
9. Cliquez sur Plus de paramètres.
10. Cliquez sur Champs à définir.
11. Cliquez à plusieurs reprises sur + Ajouter un champ pour ajouter les champs suivants:

    

12. Cliquez sur Continuer.
13. Sous Déclenchement, cliquez sur Personnalisé.
14. Sélectionnez le déclencheur personnalisé TransactionCompleted.
15. Cliquez sur Enregistrer.
16. Cliquez sur Créer une balise.

3. Pousser l'événement de transaction, la transaction et les articles dans la couche de données

Écrivez le code permettant de transmettre l'événement de transaction, la transaction et les articles associés à la couche de données. Vous devez utiliser les noms de variables de transaction et d'article compatibles pour transmettre les données sur les transactions et les articles à la couche de données. Exemple :

// Called when a user completes a transaction.
- (void)onPurchaseCompleted:(Purchase *)purchase {

  TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

  // An array to store dictionaries of item data.
  NSMutableArray *purchasedItems = [NSMutableArray array];

  // Push item data into dictionaries and store in the purchasedItems array.
  // Note that item.price and item.quantity must be of type NSString.
  for (id item in purchase.items) {
    [purchasedItems addObject:@{@"name": item.name,
                                @"sku": item.sku,
                                @"category": item.category,
                                @"price": item.price,
                                @"currency": @"USD",
                                @"quantity": item.quantity}];
  }

  // This call assumes the container has already been opened, otherwise events
  // pushed to the DataLayer will not fire tags in that container.
  // Note that purchase.tax, purchase.shipping, and purchase.total must be of type NSString.
  [dataLayer push:@{@"event": @"transaction",                  // Event, name of Transaction Event.
                    @"transactionId": purchase.transactionId,  // Additional fields required by the tag.
                    @"transactionTotal": purchase.total,
                    @"transactionAffiliation": @"In-app Store",
                    @"transactionTax": purchase.tax,
                    @"transactionShipping": purchase.shipping,
                    @"transactionCurrency": @"USD",
                    @"transactionProducts": purchasedItems}];

  // Since the data layer is persistent, you should reset fields to [NSNull null] after
  // you are done pushing the transaction.
  [dataLayer push:@{@"transactionId": [NSNull null],
                    @"transactionTotal": [NSNull null],
                    @"transactionAffiliation": [NSNull null],
                    @"transactionTax": [NSNull null],
                    @"transactionShipping": [NSNull null],
                    @"transactionCurrency": [NSNull null],
                    @"transactionProducts": [NSNull null]}];
}