Show Menu
SUJETS×

Mise en œuvre principale et cycle de vie

Ces informations vous aideront à mettre en œuvre la bibliothèque Android et à collecter les mesures de cycle de vie, par exemple les lancements, les mises à niveau, les sessions, les utilisateurs actifs, etc.

Téléchargement du kit SDK

Pour télécharger le SDK, vous devez utiliser Android 2.2 ou une version supérieure.
  1. Suivez les procédures décrites dans les sections ci-après pour configurer une suite de rapports de développement et télécharger une version prérenseignée du fichier de configuration :
  2. Téléchargez et décompressez le fichier [Your_App_Name_]AdobeMobileLibrary-4.*-Android.zip et vérifiez que les composants logiciels suivants existent :
    • adobeMobileLibrary.jar , qui est la bibliothèque qui sera utilisée avec les appareils et simulateurs Android.
    • ADBMobileConfig.json  : fichier de configuration du SDK personnalisé pour votre application.
    Si vous téléchargez le SDK en dehors de l’interface utilisateur Adobe Mobile Services, le fichier ADBMobileConfig.json doit être configuré manuellement. Si vous découvrez Analytics et le SDK Mobile et que vous souhaitez configurer une suite de rapports de développement et télécharger une version prérenseignée du fichier de configuration, consultez la rubrique Avant de démarrer.

Ajout du SDK et du fichier de configuration au projet IntelliJ IDEA ou Eclipse

Projet IntelliJ IDEA
Pour ajouter le SDK et le fichier de configuration au projet, procédez comme suit :
  1. Ajoutez le fichier ADBMobileConfig.json au dossier assets du projet.
  2. Cliquez avec le bouton droit sur le projet dans le volet de navigation du projet.
  3. Sélectionnez Ouvrir les paramètres du module .
  4. Sous Paramètres du projet , sélectionnez Bibliothèques .
  5. Cliquez sur l’icône + pour ajouter une nouvelle bibliothèque.
  6. Sélectionnez Java et accédez au fichier adobeMobileLibrary.jar .
  7. Sélectionnez les modules dans lesquels vous prévoyez d’utiliser la bibliothèque mobile.
  8. Cliquez sur Appliquer , puis sur OK pour fermer la fenêtre Paramètres du module.
Projet Eclipse
Pour ajouter le SDK et le fichier de configuration au projet, procédez comme suit :
  1. Ajoutez le fichier ADBMobileConfig.json au dossier assets du projet.
  2. Dans Eclipse IDE , cliquez avec le bouton droit sur le nom du projet.
  3. Cliquez sur Créer chemin  > Ajouter archives externes .
  4. Sélectionner adobeMobileLibrary.jar .
  5. Cliquez sur Ouvrir .
  6. Cliquez de nouveau avec le bouton droit sur le projet, puis sélectionnez Créer chemin  > Configurer création chemin .
  7. Dans l’onglet Ordonner et exporter , assurez-vous que le fichier adobeMobileLibrary.jar est sélectionné.

Ajout des autorisations des applications

La bibliothèque AppMeasurement nécessite les autorisations suivantes pour envoyer des données et enregistrer les appels de suivi hors ligne :
  • INTERNET
  • ACCESS_NETWORK_STATE
Pour ajouter ces autorisations, ajoutez les lignes suivantes au fichier AndroidManifest.xml situé dans le répertoire du projet d’application :
<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Définition du contexte de l’application

Le code suivant doit être ajouté à la méthode onCreate de votre activité principale :
   @Override
   public void onCreate(BundlesavedInstanceState){
     super.onCreate(savedInstanceState)
     setContentView(R.layout.main);
     Config.setContext(this.getApplicationContext());
   }

Mise en œuvre des mesures de cycle de vie

Une fois que vous avez activé le cycle de vie, chaque fois que l’application est lancée, un accès est envoyé permettant de mesurer les lancements, les mises à niveau, les sessions, les utilisateurs actifs, etc. Pour en savoir plus, voir la section Mesures de cycle de vie .
Procédez comme suit pour chaque activité de votre application :
  1. Importez la bibliothèque :
    import com.adobe.mobile.*;
    
    
  2. Pour la fonction onResume , démarrez la collecte des données du cycle de vie :
    @Override 
    public void onResume() { 
        Config.collectLifecycleData(this); 
        // -or- Config.collectLifecycleData(this, contextData); 
    }
    
    
  3. Pour la fonction onPause , arrêtez la collecte des données du cycle de vie :
    @Override 
    public void onPause() { 
        Config.pauseCollectingLifecycleData(); 
    }
    
    
Vous devez ajouter ces appels à chaque activité afin de garantir une création de rapports de blocage exacte. Pour plus d’informations, voir Suivi des blocages d’application .

Inclusion des données supplémentaires aux appels du cycle de vie

Pour inclure des données supplémentaires aux appels de mesures de cycle de vie, transmettez un paramètre supplémentaire à collectLifecycleData qui contient les données contextuelles :
@Override 
public void onResume() {
    HashMap<String, Object> contextData = new HashMap<String, Object>(); 
    contextData.put("myapp.category", "Game"); 
    Config.collectLifecycleData(this, contextData); 
}

Les valeurs des données contextuelles supplémentaires envoyées avec collectLifecycleData doivent être mises en correspondance avec les variables personnalisées dans Adobe Mobile Services :
Les autres mesures de cycle de vie sont collectées automatiquement. Pour en savoir plus, voir la section Mesures de cycle de vie .

Étapes suivantes

Exécutez les tâches ci-après :