Lägg till Adobe Target-förfrågningar

Adobe Mobile Services SDK (v4) innehåller Adobe Target metoder och funktioner som gör att du kan anpassa din app med olika upplevelser för olika användare. Normalt görs en eller flera förfrågningar från appen till Adobe Target för att hämta det personaliserade innehållet och mäta effekten av det innehållet.

I den här lektionen förbereder du appen We.Travel för personalisering genom att implementera Target-begäranden.

Förutsättningar

Hämta och uppdatera exempelappen.

Utbildningsmål

När lektionen är klar kan du:

Terminologi

Nedan finns några viktiga Target-termer som vi kommer att använda i resten av kursen.

Lägg till en förhämtningsbegäran för grupp

Den första begäran som vi implementerar i We.Travel är en förhämtningsbegäran för batch med två Target platser på hemskärmen. I en senare lektion kommer vi att konfigurera erbjudanden för dessa platser som visar meddelanden som hjälper nya användare genom bokningsprocessen.

En förhämtningsbegäran hämtar Target-innehåll så minimalt som möjligt genom att cachelagra Adobe Target-serversvar (erbjudande). En begäran om batchförhämtning hämtar och cachelagrar flera erbjudanden, som var och en är kopplad till en annan plats. Alla förhämtade platser cachelagras på enheten för framtida bruk i användarsessionen. Genom att förhämta flera platser på hemskärmen kan vi hämta erbjudanden som kan användas senare när besökaren navigerar genom appen. Mer information om förhämtningsmetoder finns i förhämtningsdokumentationen.

Lägg till förhämtningsbegäran för grupp

Vi uppdaterar HomeActivity-kontrollen (hemskärmens källkod), som finns under app > main > java > com.wetravel > Controller. Vi lägger till de två kodblocken som visas i rött:

Vi börjar med HomeActivity-kontrollen (hemskärmens källkod) som finns under app > main > java > com.wetravel > Controller.

Vi lägger till de två kodblocken som visas i rött:

Bläddra ned till slutet av HomeActivity-koden och lägg till koden som anges nedan efter setHeader()-funktionen och ersätta den aktuella onResume()-funktionen:

@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);
}

Din utvecklingsmiljö kommer antagligen att varna dig om att du inte har Target-klasserna importerade i filen. Se till att importera Target-klasserna högst upp i HomeActivity-kontrollenheten, vilket visas i rött nedan:

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

Felen "cannot find symbol variable wetravel_engage_home" och "cannot find symbol variable wetravel_engage_search" visas förmodligen också. Lägg till dessa i filen Constant.java (i app > src > main > java > com > weravel > Utils):

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

Förklaring av begärandekod för batchförhämtning

Om asynkron jämfört med synkron

Med den kod vi just har implementerat görs förhämtningsbegäran som ett synkront, blockerande anrop, precis innan hemskärmen återges. När vi klistrade in den nya koden i HomeActivity-kontrollen flyttade vi setUp()-funktionskörningen från funktionen onResume() till efter Target-begäran. Detta kan vara bra i scenarier där du vill anpassa innehåll när appen öppnas, eftersom det ser till att anpassat innehåll från målservrarna har returnerats (eller timeout) innan den första skärmen återges. Om du vill tillåta att begäranden läses in asynkront (i bakgrunden) anropar du setUp() i funktionen onCreate() i stället.

Validera begäran om batchförhämtning

Återskapa appen och öppna Android Emulator. (I följande skärmbilder används pixel 2 i Android Q version 9+, API-nivå 29). Prefetch-svaret ska vara "prefetch response receive":

När hemskärmen återges bör förhämtningsbegäran läsas in. Med Logcat kan du filtrera efter “Target” för att se begäran och svar:

Om du inte ser något svar kontrollerar du inställningarna i filen ADBMobileConfig.json och kodsyntaxen i filen HomeActivity.

Två platser cachelagras nu till enheten. Platsnamnen kommer snart att läsas in i Target-gränssnittet, där de kan väljas i olika nedrullningsbara menyer när du använder dem i en aktivitet.

Lägg till lastbegäranden för varje cachelagrad plats

Nu när platserna är förhämtade och deras svar cachelagrade till enheten lägger vi till metoden Target.loadRequest() som hämtar erbjudandeinnehållet från cachen så att du kan använda den för att uppdatera programmet. Vi lägger till en ny anpassad metod med namnet engageMessage() som körs med förhämtningsbegäran. engageMessage() anropar Target.loadRequest(). engageMessage() körs före setUp() för att säkerställa att inläsningsbegäran anropas innan skärmen konfigureras.

Lägg först till anropet och metoden engageMessage() för platsen wetravel_engage_home i HomeActivity:

Här är den uppdaterade koden:

    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);
                        }
                    });
                }
            });
    }

Lägg nu till anropet och metoden engageMessage() för platsen wetravel_engage_search i SearchBusActivity. Observera att anropet engageMessage() är inställt i metoden onResume() före anropet till setUpSearch(), så det körs innan skärmen är konfigurerad:

Här är den uppdaterade koden:

    @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);
                            }
                        });
                    }
                });
    }

Eftersom du precis har lagt till Target-metoder i SearchBusActivity, måste du importera Target-klasserna:

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

Lägg till en begäran i realtid

Nästa begäran som vi lägger till i appen blir en begäran i realtid på Tack-skärmen. Med"realtid" menar vi att både begäran kommer att göras och att svaret kommer att tillämpas omedelbart (inte cachelagras senare). I en senare lektion kommer vi att bygga en upplevelse med denna begäran, som är anpassad efter användarens resa.

Låt oss lägga till en förfrågan i realtid på Tack-skärmen. I filen TackYouActivity gör vi de ändringar som visas i rött:

Bläddra till slutet av filen TackAktivitet. Kommentera de tre raderna i funktionen getRecommandations() och lägg till anropet för funktionen targetLoadRequest():

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

Lägg till den här kodraden i funktionen getRecommandations():

targetLoadRequest(recommandation.recommandations);

Nu måste vi definiera funktionen targetLoadRequest():

Lägg till det här kodblocket efter funktionen 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();
            }
        }
    });
}

Eftersom du just har lagt till Target-metoder i TackYouActivity måste du importera Target-klasserna:

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

targetLoadRequest(), kodförklaring

Det här var en mer sofistikerad uppdatering som vi gjorde i appen med den begäran vi lade till på startskärmen, så vi ska titta på vad vi gjorde:

Detta är ett mycket vanligt användningsmönster när Target används i mobilappar. Det är båda mycket kraftfullt, eftersom du kan anpassa praktiskt taget alla aspekter av din mobilapp. Det kräver också samordning mellan programkoden och de erbjudanden som vi definierar senare i Target-gränssnittet. På grund av den här samordningen kan vissa användningsexempel kräva att du uppdaterar din app i appbutiken för att starta aktiviteten.

Validera begäran i realtid

Öppna Android Emulator och gå igenom alla steg för att boka en resa: Hem > Busssökningsresultat > Platsval, Betalningsalternativ (alla betalningsalternativ med tomma data fungerar).

På den sista Tack-skärmen tittar du på Logcat för svaret. Svaret ska vara "Standardinnehåll returnerades för "wetravel_context_dest":

Rensa förhämtade platser från cache

Det kan finnas situationer där förhämtade platser måste rensas under en session. När en bokning görs är det till exempel klokt att rensa de cachelagrade platserna eftersom användaren nu är"engagerad" och förstår bokningsprocessen. Om de bokar en annan resa under sessionen behöver de inte de ursprungliga platserna på startskärmen och sökresultatskärmen för att vägleda bokningen. Det skulle vara vettigare att rensa platserna från cacheminnet och förhämta nya erbjudanden för kanske en rabatterad andra bokning eller ett annat relevant scenario. Logik kan läggas till på startskärmen och sökresultatskärmen för att hämta nya platser i förväg om en bokning har gjorts under sessionen.

I det här exemplet rensar vi förhämtade platser för sessionen när en bokning görs. Detta görs genom att funktionen Target.clearPrefetchCache() anropas. Ställ in funktionen inuti funktionen targetLoadRequest() så som visas nedan:

Target.clearPrefetchCache()

Grattis! Din app har nu ramverket för personalisering. I nästa lektion ska vi förbättra våra personaliseringsfunktioner genom att lägga till parametrar till dessa platser.

NÄSTA : "Lägg till parametrar" >