Show Menu
SUJETS×

Messagerie in-app

Vous pouvez envoyer des messages in-app déclenchés par une donnée ou un événement Analytics. Après la mise en œuvre, les messages sont envoyés dynamiquement à l’application et ne requièrent pas de mise à jour du code.

Nouvelle mise à jour du SDK Adobe Experience Cloud

Vous recherchez des informations et de la documentation à propos du SDK Adobe Experience Platform Mobile ? Cliquez ici pour consulter notre 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 .
Si vous utilisez les SDK Adobe Experience Platform Mobile avec Adobe Launch, vous devez également installer l’extension Adobe Analytics Mobile Services pour utiliser les fonctionnalités Adobe Mobile Services comme la messagerie intégrée (in-app) et les notifications Push. Pour en savoir plus, reportez-vous à la section Adobe Analytics - Mobile Services . Pour plus d’informations sur l’utilisation de la messagerie push et de la messagerie in-app avec les SDK Experience Cloud, voir Configuration de la messagerie push et Configuration de la messagerie in-app .
Pour utiliser la messagerie in-app, vous devez disposer du SDK version 4.2 ou supérieure.
Vous pouvez créer des messages et les règles dans Adobe Mobile Services qui définissent le moment où les messages s’affichent. Pour obtenir plus d’informations, voir Création d’un message in-app . Pour afficher des messages in-app, des mises à jour doivent être apportées au SDK. Vous pouvez terminer ces étapes même si vous n’avez pas encore défini de messages. Une fois que vous avez défini les messages, ils sont envoyés dynamiquement à l’application et affichés sans mise à jour de la boutique d’applications.

Activation de la messagerie in-app

  1. Ajoutez la bibliothèque à votre projet et mettez en œuvre le cycle de vie.
    Pour plus d’informations, voir Ajout du SDK et du fichier de configuration au projet IntelliJ IDEA ou Eclipse dans Mise en œuvre principale et cycle de vie .
  2. Mettez à jour le fichier 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 avez sélectionné une disposition modale, sélectionnez un des thèmes suivants pour le message :
    • 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" />
    
    
  3. Importez la bibliothèque :
    import com.adobe.mobile.*;
    
    
  4. Dans chaque appel collectLifecycleData , transmettez this pour fournir une référence à l’activité en cours :
    @Override 
    public void onResume() { 
        Config.collectLifecycleData(this); 
    }
    
    
  5. Vérifiez que le fichier ADBMobileConfig.json contient les paramètres requis pour la messagerie intégrée (in-app).
    messages ou remotes est obligatoire.
    Pour que les messages in-app soient mis à jour dynamiquement au lancement, l’objet remotes doit être présent et correctement configuré :
    “messages”: [ 
        { 
            “messageId”: “de45c43c-37bf-441f-8cbd-cc3ba3469ebe”, 
            “template”: “fullscreen”, 
            “showOffline”: false, 
            “showRule”: “always”, 
            “endDate”: 2524730400, 
            “startDate”: 0, 
            “audiences”: [], 
            “triggers”: [], 
            “payload”: { // contents change depending on template 
                “html”: “<html>html code goes here</html>” 
            }, 
        }, 
        … 
    ] 
    “remotes” : { 
        “analytics.poi”: “https://assets.adobedtm.com/…/yourfile.json”, 
        “messages”: “https://assets.adobedtm.com/…/yourfile.json” 
    }
    
    
    Si cet objet n’est pas configuré, téléchargez un fichier ADBMobileConfig.json mis à jour depuis Adobe Mobile Services. Pour obtenir plus d’informations, voir Avant de commencer .

Suivi des messages in-app

Les SDK Android Mobile Services effectuent le suivi des mesures suivantes pour vos messages in-app :
  • Pour les messages in-app en plein écran et de type alerte :
    • Impressions  : lorsque l’utilisateur déclenche un message in-app.
    • Clics publicitaires  : lorsque l’utilisateur appuie sur Clic publicitaire .
    • Annulations  : lorsque l’utilisateur appuie sur Annuler .
  • Pour les messages in-app personnalisés en plein écran, le contenu HTML du message doit contenir le code approprié pour notifier le suivi du SDK concernant les boutons suivants :
    • Exemple de suivi des Clics publicitaires (redirections) :
      adbinapp://confirm/?url=https://www.yoursite.com
    • Exemple de suivi - Annuler (fermer) :
      adbinapp://cancel

Image de secours locale

Lors de la création d’un message Plein écran, vous avez la possibilité, si vous le souhaitez, de spécifier une image de secours. Si le message ne peut pas récupérer l’image prévue depuis le web, le SDK tente de charger l’image portant le même nom depuis le dossier assets de l’application. Cela permet d’afficher le message dans son format d’origine, même si l’utilisateur est hors ligne ou si l’image prédéterminée n’est pas accessible.
Le nom de ressource de l’image de secours est spécifié lors de la configuration du message dans Adobe Mobile Services. Vous devez vous assurer que la ressource spécifiée est disponible.

Configuration des icônes de notification

Les méthodes suivantes permettent de configurer la petite icône et la grande icône qui apparaissent dans la zone de notification ainsi que la grande icône affichée lorsque des notifications apparaissent dans le tiroir de notification.
  • Config.setSmallIconResourceId(int resourceId)
    Définit la petite icône qui sera utilisée pour les notifications créées par le SDK. Cette icône apparaît dans la barre d’état et est l’image secondaire qui s’affiche lorsque l’utilisateur voit l’ensemble de la notification dans le Centre de notifications.
    • Voici la syntaxe de cette méthode :
      public static void setSmallIconResourceId(final int resourceId); 
      
      
    • Voici un exemple de code pour cette méthode :
      Config.setSmallIconResourceId(R.drawable.appIcon);
      
      
  • Config.setLargeIconResourceId(int resourceId)
    Définit la grande icône qui sera utilisée pour les notifications créées par le SDK. Cette icône est l’image principale affichée lorsque l’utilisateur voit l’ensemble de la notification dans le Centre de notifications.
    • Voici la syntaxe de cette méthode :
      public static void setLargeIconResourceId(final int resourceId); 
      
      
    • Voici l’exemple de code pour cette méthode :
      Config.setLargeIconResourceId(R.drawable.appIcon);