Ajout de requêtes Adobe Target

Adobe Mobile Services SDK (v4) fournit des méthodes et des fonctionnalités Adobe Target qui vous permettent de personnaliser votre application avec différentes expériences pour différents utilisateurs. En règle générale, une ou plusieurs requêtes sont effectuées de l’application vers Adobe Target pour récupérer le contenu personnalisé et mesurer l’impact de ce contenu.

Dans cette leçon, vous allez préparer l’application We.Travel à la personnalisation en implémentant des demandes Target.

Conditions préalables

Veillez à télécharger et mettre à jour l’exemple d’application.

Objectifs d’apprentissage

À la fin de cette leçon, vous serez en mesure de :

Terminologie

Vous trouverez ci-dessous certains termes clés de Target que nous utiliserons dans la suite de ce tutoriel.

Ajout d’une requête de prérécupération par lots

La première demande que nous allons implémenter dans We.Travel est une demande de prérécupération par lots avec deux emplacements Target sur l’écran d’accueil. Dans une leçon ultérieure, nous allons configurer des offres pour ces emplacements qui affichent des messages pour aider les nouveaux utilisateurs à passer par le processus de réservation.

Une requête de prérécupération récupère Target contenu aussi minimalement que possible en mettant en cache la réponse du serveur Adobe Target (offre). Une requête de prérécupération par lots récupère et met en cache plusieurs offres, chacune associée à un emplacement différent. Tous les emplacements prérécupérés sont mis en cache sur l’appareil pour une utilisation ultérieure dans la session utilisateur. En prérécupérant plusieurs emplacements sur l’écran d’accueil, nous pouvons récupérer les offres à utiliser ultérieurement lorsque le visiteur navigue dans l’application. Reportez-vous à la documentation de prérécupération pour plus d’informations sur les méthodes de prérécupération.

Ajout de la requête de prérécupération par lot

Mettons à jour le contrôleur HomeActivity (le code source de l’écran d’accueil), qui se trouve sous app > main > java > com.wetravel > Controller. Nous allons ajouter les deux blocs de code affichés en rouge :

Nous allons commencer par le contrôleur HomeActivity (le code source de l’écran d’accueil), qui se trouve sous app > main > java > com.wetravel > Controller.

Nous allons ajouter les deux blocs de code affichés en rouge :

Faites défiler jusqu’à la fin du code de HomeActivity et ajoutez le code fourni ci-dessous après la fonction setHeader() et en remplaçant la fonction onResume() actuelle :

@Override
protected void onResume() {
    super.onResume();
    targetPrefetchContent();
}

public void targetPrefetchContent() {
    List<TargetPrefetchObject> prefetchList = new ArrayList<>();
    prefetchList.add(Target.createTargetPrefetchObject(Constant.wetravel_engage_home, null));
    prefetchList.add(Target.createTargetPrefetchObject(Constant.wetravel_engage_search, null));
    Target.TargetCallback<Boolean> prefetchStatusCallback = new Target.TargetCallback<Boolean>() {
        @Override
        public void call(final Boolean status) {
            HomeActivity.this.runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    String cachingStatus = status ? "YES" : "NO";
                    System.out.println("Received Response from prefetch : " + cachingStatus);
                    setUp();

                }
            });
        }};
    Target.prefetchContent(prefetchList, null, prefetchStatusCallback);
}

Votre IDE vous avertira probablement que les classes Target ne sont pas importées dans le fichier . Veillez à importer les classes Target en haut du contrôleur HomeActivity, comme illustré en rouge ci-dessous :

import com.adobe.mobile.Target;
import com.adobe.mobile.TargetPrefetchObject;

Vous verrez probablement également des erreurs pour « impossible de trouver la variable de symbole wetravel_engage_home » et « impossible de trouver la variable de symbole wetravel_engage_search ». Ajoutez-les au fichier Constant.java (dans app > src > main > java > com > wetravel > Utils) :

public static final String wetravel_engage_home = "wetravel_engage_home";
public static final String wetravel_engage_search = "wetravel_engage_search";

Explication Du Code De Demande De Prérécupération Par Lot

À propos des modes asynchrone et synchrone

Avec le code que nous venons d’implémenter, la requête de prérécupération est effectuée sous la forme d’un appel de blocage synchrone, juste avant le rendu de l’écran d’accueil. Lorsque nous avons collé le nouveau code dans le contrôleur HomeActivity, nous avons déplacé l’exécution de la fonction setUp() de la fonction onResume() jusqu’à après la requête Target. Cela peut s’avérer bénéfique dans les scénarios où vous souhaitez personnaliser le contenu lors de la première ouverture de l’application, car cela garantit que le contenu personnalisé des serveurs Target est renvoyé (ou a expiré) avant le rendu du premier écran. Pour permettre aux requêtes de se charger de manière asynchrone (en arrière-plan), appelez simplement setUp() dans la fonction onCreate() .

Validation de la demande de prérécupération par lots

Recréez l’application et ouvrez l’émulateur Android. (Les captures d’écran suivantes utilisent le Pixel 2 sur Android Q version 9+, niveau API 29). La réponse de prérécupération doit indiquer « réponse de prérécupération reçue » :

Lors du rendu de l’écran d’accueil , la requête de prérécupération doit être chargée. Avec Logcat, filtrez les “Target” pour afficher la requête et la réponse :

Si aucune réponse réussie ne s’affiche, vérifiez les paramètres du fichier ADBMobileConfig.json et la syntaxe du code dans le fichier HomeActivity.

Deux emplacements sont désormais mis en cache sur l’appareil. Les noms des emplacements seront bientôt chargés en différé dans l’interface Target, où ils peuvent être sélectionnés dans divers menus déroulants lorsque vous les utilisez dans une activité.

Ajout de requêtes de chargement pour chaque emplacement mis en cache

Maintenant que les emplacements sont prérécupérés et leurs réponses mises en cache sur l’appareil, ajoutons la méthode Target.loadRequest() qui récupère le contenu de l’offre à partir du cache afin que vous puissiez l’utiliser pour mettre à jour votre application. Nous allons ajouter une nouvelle méthode personnalisée appelée engageMessage() qui s’exécutera avec la requête de prérécupération. engageMessage() appellera Target.loadRequest(). engageMessage() s’exécute avant setUp() pour s’assurer que la demande de chargement est appelée avant la configuration de l’écran.

Tout d’abord, ajoutez la méthode et l’appel engageMessage() pour l’emplacement wetravel_engage_home dans HomeActivity :

Voici le code mis à jour :

    public void targetPrefetchContent() {
        List<TargetPrefetchObject> prefetchList = new ArrayList<>();
        Map<String, Object> params1;
        params1 = new HashMap<String, Object>();
        params1.put("at_property", "your at_property value goes here");
        prefetchList.add(Target.createTargetPrefetchObject(Constant.wetravel_engage_home, params1));
        prefetchList.add(Target.createTargetPrefetchObject(Constant.wetravel_engage_search, params1));
        Target.TargetCallback<Boolean> prefetchStatusCallback = new Target.TargetCallback<Boolean>() {
            @Override
            public void call(final Boolean status) {
                HomeActivity.this.runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        String cachingStatus = status ? "YES" : "NO";
                        System.out.println("Received Response from prefetch : " + cachingStatus);
                        engageMessage();
                        setUp();
                    }
                });
            }};
        Target.prefetchContent(prefetchList, null, prefetchStatusCallback);
    }
    public void engageMessage() {
        Target.loadRequest(Constant.wetravel_engage_home, "", null, null, null,
            new Target.TargetCallback<String>(){
                @Override
                public void call(final String s) {
                    runOnUiThread(new Runnable() {
                        @Override
                        public void run() {
                            System.out.println("Engage Message : " + s);
                            if(s != null && !s.isEmpty()) Utility.showToast(getApplicationContext(), s);
                        }
                    });
                }
            });
    }

Ajoutez maintenant l’appel engageMessage() et la méthode pour l’emplacement wetravel_engage_search dans SearchBusActivity. Notez que l’appel engageMessage() est défini dans la méthode onResume() avant l’appel à setUpSearch() afin qu’il s’exécute avant la configuration de l’écran :

Voici le code mis à jour :

    @Override
    public void onResume() {
        super.onResume();
        engageMessage();
        setUpSearch();
    }
    public void engageMessage() {
        Target.loadRequest(Constant.wetravel_engage_search, "", null, null, null,
                new Target.TargetCallback<String>(){
                    @Override
                    public void call(final String s) {
                        runOnUiThread(new Runnable() {
                            @Override
                            public void run() {
                                System.out.println("Engage Message : " + s);
                                if(s != null && !s.isEmpty()) Utility.showToast(getApplicationContext(), s);
                            }
                        });
                    }
                });
    }

Puisque vous venez d’ajouter des méthodes Target à SearchBusActivity, veillez à importer les classes Target :

import com.adobe.mobile.Target;
import com.adobe.mobile.TargetPrefetchObject;

Ajouter une requête en temps réel

La prochaine demande que nous ajouterons à l’application sera une demande en temps réel sur l’écran de remerciement. Par « temps réel », nous voulons dire que la requête sera effectuée et que la réponse sera appliquée immédiatement (et non mise en cache pour une utilisation ultérieure). Dans une leçon ultérieure, nous allons créer une expérience à l’aide de cette requête, qui est personnalisée en fonction de la destination du voyage de l’utilisateur.

Ajoutons donc une requête en temps réel à l’écran de remerciement. Dans le fichier ThanksYouActivity, nous apporterons les modifications indiquées en rouge :

Faites défiler l’écran jusqu’à la fin du fichier ThanksYouActivity. Commentez les trois lignes de la fonction getRecommandations() et ajoutez l’appel de la fonction targetLoadRequest() :

// AppDialogs.dialogLoaderHide();
// recommandations.addAll(recommandation.recommandations);
// recommandationbAdapter.notifyDataSetChanged();

Ajoutez cette ligne de code à la fonction getRecommandations() :

targetLoadRequest(recommandation.recommandations);

Maintenant, nous devons définir la fonction targetLoadRequest() :

Ajoutez ce bloc de code après la fonction filterRecommendationBasedOnOffer() :

public void targetLoadRequest(final ArrayList<Recommandation> recommandations) {
    Target.loadRequest(Constant.wetravel_context_dest, "", null, null, null, new Target.TargetCallback<String>() {
        @Override
        public void call(final String response) {
            try {
                runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        AppDialogs.dialogLoaderHide();
                        filterRecommendationBasedOnOffer(recommandations, response);
                        recommandationbAdapter.notifyDataSetChanged();
                    }
                });
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    });
}

Puisque vous venez d’ajouter des méthodes Target à l’activité Merci, veillez à importer les classes Target :

import com.adobe.mobile.Target;
import com.adobe.mobile.TargetPrefetchObject;

Explication du code targetLoadRequest()

Il s’agissait d’une mise à jour plus sophistiquée de l’application, ajoutée à la demande sur l’écran d’accueil. Prenons quelques instants pour examiner ce que nous avons fait :

Il s’agit d’un modèle d’utilisation très courant lors de l’utilisation de Target dans les applications mobiles. Il est à la fois très puissant, dans la mesure où vous pouvez personnaliser presque tous les aspects de votre application mobile. Il nécessite également une coordination entre le code de l'application et les offres que nous définirons ultérieurement dans l'interface Target. En raison de cette coordination, certains cas d’utilisation de la personnalisation peuvent nécessiter que vous mettiez à jour votre application dans l’App Store pour lancer l’activité.

Valider la requête en temps réel

Ouvrez l’émulateur Android et suivez toutes les étapes pour réserver un voyage : Accueil > Résultats de la recherche de bus > Sélection des places, Options de paiement (toute option de paiement avec des données vides fonctionnera).

Sur le dernier écran de remerciement, regardez Logcat pour la réponse. La réponse doit indiquer « Le contenu par défaut a été renvoyé pour « wetravel_context_dest » :

Effacement des emplacements prérécupérés du cache

Dans certains cas, les emplacements prérécupérés doivent être effacés au cours d’une session. Par exemple, lorsqu’une réservation se produit, il est logique d’effacer les emplacements mis en cache, car l’utilisateur est désormais « engagé » et comprend le processus de réservation. S'ils réservent un autre voyage au cours de leur session, ils n'auront pas besoin des emplacements d'origine sur l'écran d'accueil et l'écran des résultats de recherche pour guider leur réservation. Il serait plus logique de vider les emplacements du cache et de prérécupérer de nouvelles offres pour peut-être une deuxième réservation à prix réduit ou un autre scénario pertinent. Une logique peut être ajoutée à l’écran d’accueil et à l’écran des résultats de recherche pour prérécupérer de nouveaux emplacements si une réservation a eu lieu au cours de la session.

Pour cet exemple, nous allons simplement effacer les emplacements prérécupérés pour la session lorsqu’une réservation a lieu. Pour ce faire, appelez la fonction Target.clearPrefetchCache() . Définissez la fonction dans la fonction targetLoadRequest() comme illustré ci-dessous :

Target.clearPrefetchCache()

Félicitations ! Votre application dispose désormais du framework pour la personnalisation. Dans la leçon suivante, nous allons améliorer nos fonctionnalités de personnalisation en ajoutant des paramètres à ces emplacements.

NEXT : « Ajouter des paramètres » >