Mesure des campagnes – SDK iOS

Ce document explique comment mesurer les campagnes et les sources de trafic avec le SDK Google Analytics pour iOS v3.

Présentation

Mesurer les campagnes dans Google Analytics permet d'attribuer les campagnes et les sources de trafic à l'activité des utilisateurs dans votre application. Ces options sont disponibles pour l'attribution des campagnes et des sources de trafic dans le SDK Google Analytics pour iOS:

Mesure des campagnes d'installation iOS : identifiez les campagnes issues d'autres applications qui redirigent les utilisateurs vers iTunes pour télécharger votre application iOS.
Attribution générale des campagnes et des sources de trafic : identifiez les campagnes ou les URL de provenance qui lancent votre application une fois qu'elle est installée.

Les sections suivantes décrivent quand et comment implémenter chaque type de mesure de campagne dans votre application.

Paramètres des campagnes

Les paramètres de campagne permettent de transmettre des informations sur les sources de trafic et les campagnes qui redirigent les utilisateurs vers votre application.

Le tableau ci-dessous contient les paramètres de campagne disponibles qui peuvent être utilisés pour la mesure générale des campagnes:

Paramètres	Description	Exemple(s)
`utm_campaign`	Nom de la campagne ; utilisé pour l'analyse des mots clés afin d'identifier une campagne stratégique ou une promotion spécifique sur un produit	`utm_campaign=spring_sale`
`utm_source`	Source de la campagne : utilisée pour identifier un moteur de recherche, une newsletter ou une autre source	`utm_source=google`
`utm_medium`	Support de la campagne : utilisé pour identifier un support tel qu'un e-mail ou un coût par clic (CPC)	`utm_medium=cpc`
`utm_term`	Terme de la campagne : utilisé avec la recherche sponsorisée pour fournir les mots clés des annonces	`utm_term=running+shoes`
`utm_content`	Contenu de la campagne ; utilisé pour les tests A/B et les annonces ciblées sur le contenu afin de différencier les annonces ou liens qui renvoient vers la même URL	`utm_content=logolink` `utm_content=textlink`
`gclid`	Paramètre de taggage automatique Google Ads (utilisé pour mesurer les annonces). Cette valeur est générée dynamiquement et ne doit jamais être modifiée.

Attribution générale des campagnes et des sources de trafic

Une fois qu'une application a été installée, elle peut être lancée par le biais de sites référents à partir de campagnes publicitaires, de sites Web ou d'autres applications. Dans ce scénario, les sources de trafic référentes ou les campagnes marketing peuvent être attribuées à l'activité de l'utilisateur au cours des sessions suivantes en définissant les champs de la campagne directement sur un outil de suivi.

Le moyen le plus simple d'envoyer des données de campagne consiste à utiliser [GAIDictionaryBuilder setCampaignParametersFromUrl:urlString], où urlString est une chaîne représentant une URL pouvant contenir des paramètres de campagne Google Analytics. Notez que dans les exemples suivants, les données de campagne ne sont pas définies directement dans l'outil de suivi, car elles n'ont besoin d'être envoyées qu'une seule fois:

/*
 * MyAppDelegate.m
 *
 * An example of how to implement campaign and referral attribution.
 * If no Google Analytics campaign parameters are set in the referring URL,
 * use the hostname as a referrer instead.
 */

// For iOS 9.0 and later
- (BOOL)application:(UIApplication *)app openURL:(nonnull NSURL *)url
            options:(nonnull NSDictionary<NSString *,id> *)options {

// For iOS versions prior to 9.0
//- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
//  sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {

  NSString *urlString = [url absoluteString];

  id<GAITracker> tracker = [[GAI sharedInstance] trackerWithName:@"tracker"
                                                      trackingId:@"UA-XXXX-Y"];

  // setCampaignParametersFromUrl: parses Google Analytics campaign ("UTM")
  // parameters from a string url into a Map that can be set on a Tracker.
  GAIDictionaryBuilder *hitParams = [[GAIDictionaryBuilder alloc] init];

  // Set campaign data on the map, not the tracker directly because it only
  // needs to be sent once.
  [hitParams setCampaignParametersFromUrl:urlString];

  // Campaign source is the only required campaign field. If previous call
  // did not set a campaign source, use the hostname as a referrer instead.
  if(![hitParams get:kGAICampaignSource] && [url host].length !=0) {
    // Set campaign data on the map, not the tracker.
    [hitParams set:@"referrer" forKey:kGAICampaignMedium];
    [hitParams set:[url host] forKey:kGAICampaignSource];
  }

  NSDictionary *hitParamsDict = [hitParams build];

  // A screen name is required for a screen view.
  [tracker set:kGAIScreenName value:@"screen name"];

  // Previous V3 SDK versions.
  // [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:hitParamsDict] build]];

  // SDK Version 3.08 and up.
  [tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:hitParamsDict] build]];

Si vous disposez d'informations sur la campagne sous un format autre que les paramètres de campagne Google Analytics, vous pouvez les définir sur un NSDictionary et les envoyer manuellement:

// Assumes at least one tracker has already been initialized.
id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

// Note that it's not necessary to set kGAICampaignKeyword for this email campaign.
NSDictionary *campaignData = [NSDictionary dictionaryWithObjectsAndKeys:
    @"email", kGAICampaignSource,
    @"email_marketing", kGAICampaignMedium,
    @"summer_campaign", kGAICampaignName,
    @"email_variation1", kGAICampaignContent, nil];

// A screen name is required for a screen view.
[tracker set:kGAIScreenName value:@"screen name"];

// Note that the campaign data is set on the Dictionary, not the tracker.
// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:campaignData] build]];

// SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:campaignData] build]];

Mesure des campagnes d'installation iOS

Google Analytics prend directement en charge la mesure des campagnes d'installation iOS pour les réseaux populaires et permet de générer vos propres URL personnalisées pour tout réseau supplémentaire.

Pour activer la mesure des campagnes d'installation d'iOS, utilisez l'outil de création d'URL de suivi des campagnes pour iOS ci-dessous afin de générer des URL de destination pour vos annonces qui redirigent les utilisateurs vers l'App Store. Pour que le suivi des campagnes iOS fonctionne, vous devez avoir implémenté Google Analytics dans votre application iOS, activé la collecte de l'IDFA et suivi un ou plusieurs visionnages de l'écran ou événements dans votre application. Vous devez également ajouter un framework supplémentaire à votre application si vous souhaitez utiliser la mesure automatique des campagnes d'installation d'annonces iAd.

Diagnostic en libre-service pour le suivi des conversions iOS

Si vous ne voyez pas de conversions pour vos campagnes iOS, procédez comme suit pour résoudre le problème:

Vérifier que le suivi des campagnes iOS est activé
Vérifier que l'ID d'application correspond
Vérifier que le SDK GA envoie l'IDFA
Consulter le rapport sur les données démographiques pour vérifier que l'IDFA est bien envoyé
Vérifier que les URL de suivi des campagnes iOS sont correctes

Étape 1: Vérifiez que le suivi des campagnes iOS est activé

Pour vérifier que le suivi des campagnes iOS est activé pour la propriété cible:

Cliquez sur l'onglet Admin.
Sélectionnez la propriété, puis cliquez sur Paramètres de la propriété.
Assurez-vous que l'option Suivi des campagnes iOS est ACTIVÉE.

Remarque : Si le suivi des campagnes iOS n'est pas activé, Google Analytics n'attribue pas de données de campagnes iOS aux données de l'application.

Étape 2: Vérifiez que les ID d'application correspondent

Pour attribuer correctement les données d'une campagne à une campagne, l' URL de suivi des campagnes iOS et l'implémentation du suivi de votre application doivent utiliser le même ID d'application. Pour déterminer l'ID de l'application d'une application que vous suivez actuellement, créez un rapport personnalisé dans l'interface Web Google Analytics avec ID de l'application comme dimension et Sessions comme métrique.

Lors de la création d'une URL de suivi d'une campagne iOS, utilisez l'ID de l'application qui apparaît dans le rapport personnalisé.

créer un rapport personnalisé

Étape 3: vérifiez que le SDK Google Analytics envoie l'IDFA

Google Analytics utilise l'identifiant publicitaire (IDFA) comme l'une des clés permettant d'associer les clics sur mobile aux appels Google Analytics. Vérifiez les points suivants :

Votre application utilise le SDK Google Analytics pour iOS (version 3.10 ou version ultérieure).
Si vous utilisez le téléchargement autonome du SDK :
- Votre application est associée à libAdIdAccess.a dans le cadre de la version iOS de Google Analytics.
- Votre application est associée à AdSupport.framework.
Si vous utilisez CocoaPods pour installer et gérer les dépendances, ajoutez le CocoaPod GoogleIDFASupport au Podfile :
```
pod 'GoogleIDFASupport'
```
Vous avez activé la collecte de l'IDFA sur chaque traceur :
```
tracker.allowIDFACollection = YES;
```
Si possible, utilisez une application de proxy de débogage pour afficher les requêtes HTTP et confirmer que l'IDFA est inclus.

Étape 4: Consultez le rapport "Données démographiques" pour confirmer l'envoi de l'IDFA

Google Analytics utilise l'IDFA pour générer les rapports sur les données démographiques. Dans Google Analytics, cliquez sur l'onglet Rapports, puis sur Audience > Données démographiques > Vue d'ensemble pour vérifier si des données démographiques s'affichent. Dans ce cas, l'IDFA est envoyé correctement.

rapport personnalisé

Étape 5: Vérifiez que les URL de suivi des campagnes iOS sont correctes

Utilisez l' outil de création d'URL de suivi des campagnes pour iOS afin de vérifier que les URL de suivi des campagnes iOS sont correctes.

Lorsque vous sélectionnez l'option Personnalisé pour le réseau publicitaire, consultez également ce réseau afin de vérifier qu'il accepte le suivi des ID d'appareils individuels à l'aide d'URL de redirection. Si ce n'est pas le cas, aucune donnée ne s'affichera dans les rapports Google Analytics.

Outil de création d'URL de suivi des campagnes pour iOS

Utilisez l'outil ci-dessous pour générer des URL permettant de mesurer la source des installations d'applications iOS.

Important: Les URL de suivi Google AdMob nécessitent un paramètre &hash=md5. L'outil de création d'URL pour iOS ajoute ce paramètre automatiquement. Si vous créez vos URL manuellement, vous devez ajouter ce paramètre afin que le suivi des installations AdMob pour iOS fonctionne correctement. Si vous choisissez des réseaux publicitaires autres qu'AdMob, le paramètre &hash=md5 n'est pas obligatoire.