Introduction

AAM pour mobile peut être utilisé pour ingérer, organiser et segmenter ainsi que des données d’audience mobile internes et tierces d’un annonceur et de bureau. Assister un spécialiste marketing pour la création d’audience, l’analyse et l’exécution de campagnes marketing. Audience Manager peut être intégré à plusieurs plates-formes et systèmes d’exploitation mobiles.

Cet article porte sur l’implémentation d’Adobe Audience Manager dans les applications mobiles android.  Cet article est de nature technique car le public visé est les développeurs Android qui implémentent la solution et la valident.

Le guide d’implémentation est spécifique pour l’implémentation d’ Audience Manager lorsque le service Experience Cloud et les services de base sont implémentés pour le client. Si le service Experience Cloud est implémenté pour le client et que les services de base ne sont pas implémentés, vérifiez la technologie de mise en œuvre spécifique au service Experience Cloud. Si le service Experience Cloud (service d’identification des visiteurs) n’est pas activé, reportez-vous au guide d’implémentation côté client correspondant.

Conditions préalables

Vous devez avoir téléchargé les fichiers du kit SDK Adobe pour lancer l’implémentation d’Audience Manager. Si vous disposez d’un accès administrateur Analytics, vous pouvez configurer l’application dans Adobe Mobile Services et télécharger le SDK pour votre application. Si vous n’avez pas accès à Adobe Mobile Services, vous pouvez télécharger le SDK à partir de ce lien : https://github.com/Adobe-Marketing-Cloud/mobile-services/releases?

Recherche du dernier SDK Android et téléchargement d’AdobeMobileLibrary -4.*-Android.zip fichier. Vous devez disposer des composants logiciels suivants :

  • adobeMobileLibrary.jar : bibliothèque conçue pour être utilisée avec les périphériques et simulateurs Android.
  • ADBMobileConfig.json : fichier de configuration du SDK personnalisé pour votre application.

Ajoutez adobeMobileLibrary.jar en tant que dépendance de fichier sous Dépendances dans la structure de votre projet, comme illustré ci-dessous :

image1

Si votre application est déjà configurée pour Adobe Analytics, les étapes ci-dessus ont déjà été effectuées en même temps que lʼimplémentation de base et les métriques de cycle de vie. Vous pouvez alors passer directement à la section de configuration dʼAudience Manager.

Implémentation de base et cycle de vie

Le SDK téléchargé nécessite Android 2.2 ou version ultérieure pour que lʼimplémentation fonctionne.

1. Ajoutez le fichier ADBMobileConfig.json dans le dossier assets de votre projet.

2. Ajoutez des autorisations dʼapplication pour permettre à la bibliothèque AppMeasurement dʼenvoyer et dʼenregistrer des appels de suivi hors ligne. Pour ajouter ces autorisations, ajoutez les lignes suivantes à votre fichier AndroidManifest.xml (dans le répertoire du projet d’application) :

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

3. Implémentez les mesures du cycle de vie (dans chaque activité de votre application) :

a. Importez la bibliothèque suivante :

 import com.adobe.mobile.*; 

b. Dans la fonction onResume, commencez à collecter les données de cycle de vie :

@Override
public voidonResume() {
Config.collectLifecycleData(this);
// -or- Config.collectLifecycleData(this, contextData);
}

 c. Dans la fonction onPause, interrompez la collecte des données de cycle de vie.

@Override
public voidonPause() {
Config.pauseCollectingLifecycleData();
}

4. Pour inclure des données supplémentaires avec des appels de mesure de cycle de vie, transmettez un paramètre supplémentaire au collectLifecycleData qui contient des données contextuelles :

@Override
public voidonResume() {
HashMap<String, Object> contextData = new HashMap<String, Object>();
contextData.put("myapp.category", "Game");
Config.collectLifecycleData(this, contextData);
}

Vous pouvez consulter cette documentation pour connaître les étapes à suivre si vous utilisez IntelliJ IDEA ou Eclipse au lieu d’Android Studio pour configurer les applications : https://marketing.adobe.com/resources/help/fr_FR/mobile/android/dev_qs.html

Configuration d’Audience Manager

1. Lorsque nous configurons l’application dans Interface Mobile Services User : https://mobilemarketing.adobe.com nous obtenons des options pour activer le Transfert côté serveur (SSF) dans la section de configuration du SDK Audience Manager.

À partir de là, nous pouvons vérifier le Transfert analytique et saisir le sous-domaine pour Audience Manager. Ainsi, après le téléchargement du fichier ADBMobileConfig.json, il comportera tous les champs requis.

 

image2
image2_1
"marketingCloud" : {
  "org": "YOUR-MCORG-ID"
}
"audienceManager": {
    "server": "",
    "analyticsForwardingEnabled": "true",
  },

Les étapes ci-dessous permettent de saisir manuellement ces valeurs dans le fichier ADBMobileConfig.json. Dans le fichier ADBMobileConfig.json de la section pour audienceManager et marketingCloud, vous trouverez les détails de configuration suivants :

 

"marketingCloud" : {
  "org": "YOUR-MCORG-ID"
}
"audienceManager": {
    "server": "",
    "analyticsForwardingEnabled": "true",
  },

Remarque :

  • Une condition préalable à l’utilisation du transfert des données analytiques côté serveur est que le client soit provisionné pour le service Experience Cloud ID (https://marketing.adobe.com/resources/help/fr_FR/mcvid/).
  • Les identifiants d’organisation Experience Cloud ID de manière unique chaque entreprise cliente dans Adobe Experience Cloud et sont similaires à la valeur suivante : 016D5C175213CCA80A490D05@AdobeOrg.       

Lorsque la configuration ci-dessus est définie, toutes les mesures de cycle de vie sont capturées dans l’appel d’analyse et sont transférées directement via le serveur :

image3

2. Dans la méthode onCreate de l’activité principale, autorisez le SDK à accéder au contexte de votre application à l’aide de Config.setContext :

@Override
public voidonCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
// Allow the SDK access to the application context
Config.setContext(this.getApplicationContext());
}

Si vous avez déjà ajouté cet appel de méthode lorsque vous avez implémenté Analytics ou Target, il n’est pas nécessaire de l’ajouter de nouveau.

Vérification de l’implémentation

Voici quelques points de vérification des journaux d’appels pour vérifier l’implémentation côté serveur :

Si une synchronisation de l’ID client se produit, elle apparaît dans : d_cid_ic in the dpm.demdex.net network call. Lorsque l’implémentation côté serveur est terminée, aucun appel réseau Audience Manager supplémentaire n’est effectué. Les données d’Analytics sont envoyées au côté serveur d’Audience Manager.

image4

Notez que d_uuid ne sera pas disponible dans l’appel de requête si la redirection côté serveur est établie avec l’implémentation d’ID visiteur (contrairement à l’implémentation côté client). Vous devriez être en mesure de voir la valeur d_mid et les valeurs d_orgid à la place des valeurs associées au service d’ID du visiteur dans l’appel dpm.demdex.net. Toutefois, la valeur uuid s’affiche dans la réponse, comme ceci (s’affiche dans l’appel réseau Analytics) :

image5

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne