Identifiant utilisateur

 

Avant-propos

Le SDK AT Internet vous permet de choisir parmi deux types d’identifiant utilisateur afin de réaliser le suivi de vos visiteurs. Vous pouvez également choisir d’utiliser un identifiant personnalisé. Vous pourrez ensuite retrouver cet identifiant dans la variable idclient présent dans les hits.

 

Identifications disponibles

Le choix du type d’identifiant à utiliser se fait initialement dans l’interface de configuration Tag Composer. Il est également possible de modifier ce paramètre directement dans le code de votre application. Voici les différents types :

Nous vous recommandons de lire la documentation Android officielle au sujet des bonne pratiques sur l’utilisation des identifiants

 

UUID uuid

Le SDK génère un identifiant unique (appelé UUID) pour un utilisateur lors de sa première utilisation de l’application. Il sera ensuite toujours utilisé, sauf si vous changez de type d’identifiant ou que l’utilisateur supprime l’application de son téléphone.

Depuis la version 2.18.0 du SDK, cet identifiant est renouvelé au bout de 13 mois par défaut (modifiable via UUIDDuration)

 

Android ID androidId

Défaut – Le SDK récupère cet identifiant fourni par Android. Cet identifiant est unique pour chaque téléphone (des exceptions existent). Il sera ensuite toujours utilisé, sauf si vous changez de type d’identifiant.

 

Google Advertising ID googleAdId

Disponible depuis la version 2.15.0

L’Advertising ID est l’identifiant publicitaire fourni par Google. Il est unique, mais réinitialisable par l’utilisateur.
Pour utiliser l’Advertising ID dans votre application, vous devez intégrer, au minimum, le module Google Mobile Ads des Google Play Services, en suivant la procédure : https://developer.android.com/google/play-services/setup.html.

 

Huawei Open Advertising ID huaweiOAId

Disponible depuis la version 2.15.0

L’Open Advertising ID est l’identifiant publicitaire fourni par Huawei via les Huawei Mobile Services.

Pour utiliser l’Open Advertising ID dans votre application, vous devez intégrer, au minimum, le module HUAWEI Ads Kit SDK des Huawei Mobile Services, en suivant la procédure : https://developer.huawei.com/consumer/en/doc/development/HMS-Guides/19068235.

 

Advertising ID advertisingId

L’advertising ID utilise l’identifiant publicitaire disponible selon l’environnement. Il tente de récupérer l’AdId de Google (voir googleAdId), puis l’OAId de Huawei (voir huaweiOAId).

Avec ce mode d’identification, l’utilisateur sera considéré comme opt-out par défaut et donc exclu des analyses s’il a activé le suivi publicitaire limité.

Depuis la version 2.11.2, le SDK AT Internet permet de modifier ce comportement grâce à la clé de configuration ignoreLimitedAdTracking. Lorsque cette configuration est active et que l’utilisateur a activé le suivi publicitaire limité, le mode d’identification bascule automatiquement sur le type UUID.

 

Identifiant personnalisé

Vous pouvez forcer l’utilisation par notre SDK d’un type personnalisé d’identifiant client.

 

Suivi publicitaire limité

L’utilisation d’un identifiant publicitaire (advertisingId, googleAdId ou huaweiOAId) est soumis à la volonté de l’utilisateur de désactiver le suivi publicitaire auquel cas l’utilisateur ne pourra pas être identifié.

Par défaut, si l’utilisateur active le suivi publicitaire limité, il sera alors considéré comme opt-out, et sera donc exclu des analyses.

Depuis la version 2.11.2, le SDK AT Internet permet de modifier ce comportement grâce à la clé de configuration ignoreLimitedAdTracking. Lorsque cette configuration est active et que l’utilisateur a activé le suivi publicitaire limité, le mode d’identification bascule automatiquement sur le type UUID.

 

Arbre de décision

Voici un diagramme présentant l’arbre de décision de l’identifiant utilisateur utilisé par le SDK, en fonction de la configuration.

 

Exemples de marquage

Pour les versions antérieures à la 2.12.1, le SDK bascule automatiquement sur l’identifiant publicitaire (Advertising ID) en cas de non-respect du format des types prédéfinis : « androidId », « advertisingId », « UUID » (sensible à la casse).

Depuis la version 2.12.1, le SDK bascule automatiquement sur l’identifiant unique (UUID) en cas non-respect du format des types prédéfinis : « androidId », « advertisingId », « UUID » (non sensible à la casse).

  1. Sélection de l’Android ID comme type d’identifiant
    • Utilisation de la méthode setConfig()
      ATInternet.getInstance().getDefaultTracker().setConfig("identifier", "androidId", new SetConfigCallback() {
                              @Override
                              public void setConfigEnd() {
                                  Log.d(null, "SDK is now using Android ID as visitor identifier");
                              }
                          });
    • Utilisation de la méthode setIdentifierType()
      ATInternet.getInstance().getDefaultTracker().setIdentifierType(Tracker.IdentifierType.androidId, new SetConfigCallback() {
                              @Override
                              public void setConfigEnd() {
                                  Log.d(null, "SDK is now using Android ID as visitor identifier");
                              }
                          });
  2. Sélection de l’Advertising ID comme type d’identifiant
    • Utilisation de la méthode setConfig()
      ATInternet.getInstance().getDefaultTracker().setConfig("identifier", "advertisingId", new SetConfigCallback() {
                              @Override
                              public void setConfigEnd() {
                                  Log.d(null, "SDK is now using Advertising ID as visitor identifier");
                              }
                          });
    • Utilisation de la méthode setIdentifierType()
      ATInternet.getInstance().getDefaultTracker().setIdentifierType(Tracker.IdentifierType.advertisingId, new SetConfigCallback() {
                              @Override
                              public void setConfigEnd() {
                                  Log.d(null, "SDK is now using Advertising ID as visitor identifier");
                              }
                          });
    • Activation de la configuration liée au suivi publicitaire limité
      ATInternet.getInstance().getDefaultTracker().setIgnoreLimitedAdTrackingEnabled(true, null, true);
  3. Sélection de l’UUID comme type d’identifiant
    • Utilisation de la méthode setConfig()
      ATInternet.getInstance().getDefaultTracker().setConfig("identifier", "UUID", new SetConfigCallback() {
                              @Override
                              public void setConfigEnd() {
                                  Log.d(null, "SDK is now using UUID as visitor identifier");
                              }
                          });
    • Utilisation de la méthode setIdentifierType()
      ATInternet.getInstance().getDefaultTracker().setIdentifierType(Tracker.IdentifierType.UUID, new SetConfigCallback() {
                              @Override
                              public void setConfigEnd() {
                                  Log.d(null, "SDK is now using UUID as visitor identifier");
                              }
                          });
  4. Sélection d’un identifiant personnalisé
    ATInternet.getInstance().getDefaultTracker().setParam("idclient", "123ABC");

Exemples d’identifiants générés par défaut en fonction de la configuration (versions 2.12.1 et ultérieures) :

ATInternet.getInstance().getDefaultTracker().setConfig("identifier", "", null, true); // &idclient=xxxxxxxxxxxxxxxx (androidId)
ATInternet.getInstance().getDefaultTracker().setConfig("identifier", "error", null, true); // &idclient=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (UUID)
ATInternet.getInstance().getDefaultTracker().setConfig("identifier", "androidId", null, true); // &idclient=xxxxxxxxxxxxxxxx (androidId)
ATInternet.getInstance().getDefaultTracker().setConfig("identifier", "advertisingId", null, true); // &idclient=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (advertisingId)
ATInternet.getInstance().getDefaultTracker().setConfig("identifier", "uuid", null, true); // &idclient=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (UUID)
Dernière mise à jour : 29/09/2020