Mesure des campagnes - SDK Android v2 (ancien)

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

Présentation

Mesurer les campagnes dans Google Analytics peut vous aider à améliorer la valeur de vos canaux marketing en permettant l'attribution des campagnes et des sources de trafic à l'activité des utilisateurs dans votre application.

Plusieurs types de mesures de campagnes sont disponibles dans le SDK Google Analytics pour Android:

  • Mesure des campagnes Google Play : identifiez les campagnes, les sites Web et les applications qui ont redirigé les utilisateurs vers la page Google Play Store de votre application pour qu'elle la télécharge.
  • Mesure des campagnes générales : identifiez les campagnes ou les sources de trafic qui ont lancé votre application.
  • Mesurer les sites référents : découvrez quelle source de trafic référente, telle que les sites Web ou d'autres applications, a lancé votre application après son installation.

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

Mesure des campagnes Google Play

La mesure des campagnes Google Play vous permet d'identifier les campagnes et les sources de trafic qui incitent les utilisateurs à télécharger votre application à partir du Google Play Store. Nous recommandons à tous les développeurs d'implémenter la mesure des campagnes Google Play Store.

Fonctionnement des mesures des campagnes Google Play

La mesure des campagnes Google Play Store repose sur l'utilisation de paramètres de campagne pour transmettre des informations sur la campagne et les sources de trafic à votre application au moment de son téléchargement sur le Google Play Store.

Voici une description complète du fonctionnement de la mesure des campagnes Google Play:

  1. Un utilisateur clique sur un lien dans une annonce, un site Web ou une application. Il est redirigé vers la page Google Play Store de votre application. Le lien comporte des balises de paramètres de campagne.
  2. Une fois que l'utilisateur a téléchargé et installé votre application, le Google Play Store diffuse un intent INSTALL_REFERRER sur l'appareil, qui inclut les mêmes paramètres de campagne.
  3. Votre application répondra ensuite à cet intent à l'aide de l'objet BroadcastReceiver fourni ci-dessous, en lisant les paramètres de la campagne et en les utilisant pour mettre à jour les informations sur la campagne Google Analytics.

Implémenter la mesure des campagnes Google Play

Pour implémenter la mesure des campagnes Google Play Store:

1. Ajouter un nouveau BroadcastReceiver à votre fichier AndroidManifest.xml

L'élément BroadcastReceiver suivant permet à votre application de répondre à l'intent INSTALL_REFERRER diffusé par le Google Play Store lors de l'installation de votre application. Ajoutez-le à votre fichier AndroidManifest.xml comme suit:

<!-- Used for install referral measurement-->
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService"/>
<receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

2. Ajouter des paramètres de campagne à vos associations au Google Play Store

Les paramètres de campagne permettent de transmettre des informations sur la campagne ou la source de trafic ayant redirigé un utilisateur vers la page Google Play Store de votre application dans l'implémentation Google Analytics de votre application.

Pour savoir comment créer une chaîne de paramètre de campagne, utilisez l'outil de création d'URL Google Play ou consultez la section de référence sur les paramètres de campagne.

Une fois que vous avez créé votre chaîne de paramètre de campagne, ajoutez-la à vos URL Google Play Store en tant que valeur du paramètre referrer, comme dans cet exemple : 

https://play.google.com/store/apps/details?id=com.example.app
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3DdisplayAd1
%26utm_campaign%3Dshoe%252Bcampaign

Le Google Play Store ne transmet la valeur du paramètre referrer qu'à l'implémentation Google Analytics de votre application. Il est donc important de vous assurer qu'il est présent dans vos associations au Google Play Store.

Mesure des campagnes générales

La mesure générale des campagnes permet d'associer une campagne ou une source de trafic à un utilisateur après qu'il a déjà installé votre application.

Par exemple, si vous diffusez une campagne payante pour toucher les utilisateurs existants qui ont déjà installé votre application, vous pouvez mesurer les lancements d'applications résultant de cette campagne.

Mise en œuvre de la mesure générale des campagnes

Pour définir des valeurs de campagne pour une campagne générale, appelez setCampaign() et transmettez une chaîne de paramètre de campagne en tant qu'argument.

Une implémentation type peut appeler setCampaign() lorsque l'application est lancée et vérifier l'intent qui l'a lancée pour voir si des paramètres de campagne valides sont présents:

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before calling activityStart().
    EasyTracker.getInstance().setContext(this);

    if (intent.getData() != null) {
      EasyTracker.getTracker().setCampaign(uri.getPath());
    }
    ... // The rest of your onCreate() code.
  }

  @Override
  public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

Mesurer les sites référents

La mesure des sites référents est semblable à d'autres types de mesures des campagnes, car elle vous permet de mesurer une source référente qui a lancé votre application sur l'appareil d'un utilisateur. Toutefois, la mesure des sites référents utilise une chaîne simple telle que "google.com" ou "myOtherApp", plutôt qu'une chaîne de paramètres de campagne.

Lorsque vous définissez une source, telle que "google.com", la dimension source est définie sur "google.com", tandis que la dimension du support est implicitement définie sur "URL de provenance".

Comme pour la mesure des campagnes, si vous définissez une source référente, le prochain appel d'envoi démarrera une nouvelle session par défaut.

Dans l'extrait de code suivant, nous partons du principe que vous avez tagué tous les liens qui ouvriraient votre application avec des paramètres de campagne Google Analytics ou un simple paramètre referrer décrivant la source du site référent. Si le paramètre referrer est présent en l'absence d'autres paramètres de campagne, les informations sur la campagne de l'utilisateur sont mises à jour avec la nouvelle source référente:

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before activityStart() is called.
    EasyTracker.getInstance().setContext(this);

    if (uri != null) {
      if(uri.getQueryParmeter("utm_source") != null) {    // Use campaign parameters if avaialble.
        EasyTracker.getTracker().setCampaign(uri.getPath());
      } else if (uri.getQueryParameter("referrer") != null) {    // Otherwise, try to find a referrer parameter.
        EasyTracker.getTracker().setReferrer(uri.getQueryParameter("referrer"));
      }
    }
  }


  @Override
    public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

Problèmes connus

  • Le Javadoc pour CampaignTrackingReceiver utilise un chemin de classe incorrect dans son exemple d'utilisation. Consultez Implémenter la mesure des campagnes Google Play pour savoir comment les utiliser.
  • Vous ne pouvez spécifier qu'une seule classe BroadcastReceiver par application. Si vous devez intégrer au moins deux BroadcastReceivers provenant de différents SDK, vous devez créer votre propre classe BroadcastReceiver qui recevra toutes les annonces et appellera le BroadcastReceivers approprié pour chaque type de diffusion.
  • Pour le moment, la mesure des campagnes Google Play ne prend pas en charge les installations Web-to-appareil effectuées depuis le Play Store sur le Web.

Paramètres de la campagne

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.

  • En règle générale, une chaîne de paramètre de campagne non encodée est transmise en tant qu'argument à setCampaign().
  • Dans la mesure des campagnes Google Play, un paramètre referrer avec une chaîne de paramètre de campagne encodée en tant que valeur est ajouté à toutes les URL qui renvoient vers la page Play Store de votre application.

Voici un exemple de chaîne de campagne non codée valide pouvant être utilisée pour mesurer les performances générales des campagnes:

"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"

Le tableau ci-dessous présente la liste complète des paramètres de campagne disponibles dans Google Play ou la mesure générale d'une campagne.

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 performances Google Ads. Cette valeur est générée dynamiquement et ne doit jamais être modifiée.

Outil de création d'URL Google Play

Utilisez l'outil de création d'URL Google Play afin de générer des URL pour les mesures des campagnes Google Play.