Présentation du module externe PhoneGap

Ce module externe permet d’envoyer des appels AppMeasurement pour Android à partir de votre projet PhoneGap. Pour créer un projet PhoneGap, voir PhoneGap.

Nouvelle mise à jour du SDK Adobe Experience Platform Mobile

Vous recherchez des informations et de la documentation concernant le SDK d’Adobe Experience Platform Mobile ? Cliquez ici pour consulter la documentation la plus récente.

Nous avons lancé, en septembre 2018, une version majeure du SDK. Ces nouveaux SDK Adobe Experience Platform Mobile peuvent être configurés via Experience Platform Launch.

Installation du module externe à l’aide de npm

Exécutez la commande suivante :

cordova plugin add adobe-mobile-services

Installation manuelle du module externe

Inclusion du module externe

  1. Faites glisser le fichier ADBMobile_PhoneGap.java vers votre dossier src.

    Pour déplacer ce fichier, cliquez sur OK.

  2. Faites glisser le fichier ADB_Helper.js dans le dossier contenant le fichier index.html

    Pour déplacer ce fichier, cliquez sur OK.

  3. Dans le dossier res/xml, ouvrez le fichier config.xml et enregistrez un nouveau module externe en ajoutant ce qui suit :

    <feature name="ADBMobile_PhoneGap"> 
  <param name="android-package" value="[YOUR_PACKAGE_NAME].ADBMobile_PhoneGap" /> 
</feature>

    Par exemple, si votre module est nommé com.example.phonegaptest, la valeur de android-package serait la suivante :

    <param name="android-package" value="com.example.phonegaptest.ADBMobile_PhoneGap" />

Inclusion de la bibliothèque AppMeasurement

  1. Pour télécharger la bibliothèque AppMeasurement, voir Obtention du SDK.

  2. Faites glisser le fichier adobeMobileLibrary.jar vers votre dossier src.

    Pour déplacer ce fichier, cliquez sur OK.

  3. Cliquez avec le bouton droit sur le fichier adobeMobileLibrary.jar et sélectionnez Ajouter en tant que bibliothèque.

  4. Selon les exigences de votre projet, saisissez le nom, le niveau et l’emplacement de la bibliothèque.

  5. Faites glisser le fichier ADBMobileConfig.json vers le dossier assets de la racine de l’application.

  6. Confirmez que vous avez sélectionné l’application racine et non une application dans une application.

    Pour déplacer ce fichier, cliquez sur OK.

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" />

Pour activer la messagerie intégrée (in-app), procédez comme suit :

Mettez à jour AndroidManifest.xml pour déclarer l’activité Plein écran et activer le gestionnaire de notifications de messages :

<activity  
android:name="com.adobe.mobile.MessageFullScreenActivity"  
android:theme="@android:style/Theme.Translucent.NoTitleBar" /> 
<receiver android:name="com.adobe.mobile.MessageNotificationHandler" />

Si vous sélectionnez la disposition modale lorsque vous créez un message dans Adobe Mobile Services, sélectionnez l’un des thèmes suivants :

  • Theme.Translucent.NoTitleBar.Fullscreen
  • Theme.Translucent.NoTitleBar
  • Theme.Translucent

Par exemple :

<activity 
android:name="com.adobe.mobile.MessageFullScreenActivity" 
android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" 
android:windowSoftInputMode="adjustUnspecified|stateHidden" /> 
<receiver android:name="com.adobe.mobile.MessageNotificationHandler" />

Mise en œuvre d’un suivi personnalisé

Dans les fichiers html pour lesquels vous voulez utiliser le suivi, ajoutez le code ci-après à la balise <head> :

<script type="text/javascript" charset="utf-8" src="ADB_Helper.js"></script>

Sur cette page