Lägg till parametrar i begäranden

I den här lektionen ska vi lägga till Adobe livscykelstatistik och anpassade parametrar till de Target-begäranden som lades till i den föregående lektionen. Dessa mått och parametrar kommer att användas för att skapa personaliserade målgrupper senare i självstudiekursen.

Utbildningsmål

När lektionen är klar kan du:

  • Lägg till Adobe livscykelstatistik för mobila enheter
  • Lägga till parametrar i en förhämtningsbegäran
  • Lägga till parametrar till en aktiv plats
  • Validera parametrarna för båda förfrågningarna

Lägg till livscykelparametrar

Låt oss aktivera Adobe mobilstatistik för livscykler. Detta lägger till parametrar i platsförfrågningar som innehåller omfattande information om användarens enhet och hur appen används. Vi bygger målgrupper i nästa lektion med hjälp av data som tillhandahålls i livscykelbegäran.

Om du vill aktivera livscykelmått öppnar du HomeActivity-kontrollen igen och lägger till Config.collectLifecycleData(this); i onResume()-funktionen:

Livscykelbegäran

Validera livscykelparametrar för förhämtningsbegäran

Kör emulatorn och använd Logcat för att validera livscykelparametrarna. Filtrera efter "prefetch" för att hitta prefetch-svaret och leta efter de nya parametrarna:
Livscykelvalidering

Även om vi bara har lagt till Config.collectLifecycleData() i HomeActivity-styrenheten bör du också se livscykelvärdena som skickas med Target-begäran på TackYou-skärmen.

Lägg till parametern at_property i förhämtningsbegäran

Adobe Target-egenskaper definieras i Target-gränssnittet och används för att skapa gränser för personalisering av appar och webbplatser. Parametern at_property identifierar den specifika egenskap där dina erbjudanden och aktiviteter finns tillgängliga och underhålls. Vi ska lägga till en egenskap till förhämtnings- och direktplatsförfrågningarna.

NOTE
Beroende på din licens kan du eventuellt se egenskapsalternativen i gränssnittet Target. Om du inte har de här alternativen, eller om du inte använder Egenskaper i ditt företag, går du vidare till nästa avsnitt i den här lektionen.

Du kan hämta at_property-värdet i Target-gränssnittet under Setup > Properties. Håll markören över egenskapen, markera ikonen för kodfragment och kopiera värdet at_property:

Kopiera vid_egenskap

Lägg till den som en parameter för varje plats i förhämtningsbegäran enligt följande:
Lägg till parametern at_property
Här är den uppdaterade koden för funktionen targetPrefetchContent() (kom ihåg att uppdatera platshållartexten för your at_property value goes here!):

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

Kommentarer om parametrar

För framtida projekt kanske du vill implementera ytterligare parametrar. Metoden createTargetPrefetchObject() tillåter tre typer av parametrar: locationParams, orderParams och productParams. I dokumentationen finns mer information om hur du lägger till de här parametrarna i förhämtningsbegäran.

Observera också att olika platsparametrar kan läggas till på varje plats i förhämtningsbegäran. Du kan t.ex. skapa en annan karta med namnet param2, lägga in en ny parameter och sedan ange param2 på en plats och param1 på den andra platsen. Här är ett exempel:

prefetchList.add(Target.createTargetPrefetchObject(location1_name, params1);
prefetchList.add(Target.createTargetPrefetchObject(location2_name, params2);

Validera parametern at_property i förhämtningsbegäran

Kör nu emulatorn och använd Logcat för att verifiera att at_property visas på förhämtningsbegäran och svar för båda platserna:
Validera parametern at_property

Lägg till anpassade parametrar i Live-platsbegäran

Begäran om aktiv plats (wetravel_context_dest) lades till i föregående lektion så att vi kunde visa en relevant befordran på den sista bekräftelseskärmen i bokningsprocessen. Vi vill anpassa kampanjen utifrån användarens destination och för att göra det lägger vi till den som en parameter i begäran. Vi ska också lägga till en parameter för troppens ursprung och at_property-värdet.

Lägg till följande parametrar i funktionen targetLoadRequest() i kontrollenheten TackYouActivity:
Lägg till parametrar i Live-platsbegäran
Här är den uppdaterade koden för funktionen targetLoadRequest() (se till att uppdatera platshållartexten"add your at_property value here"!):

public void targetLoadRequest(final ArrayList<Recommandation> recommandations) {
    Map<String, Object> locationParams = new HashMap<>();
    locationParams.put("at_property","add your at_property value here");
    locationParams.put("locationSrc", (""+Utility.getInSharedPreference(ThankYouActivity.this,Constant.departure,"")));
    locationParams.put("locationDest", (""+Utility.getInSharedPreference(ThankYouActivity.this,Constant.destination,"")));

    Target.loadRequest(Constant.wetravel_context_dest, "", null, null, locationParams, 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();
        }
        }
    });
    Target.clearPrefetchCache();
}

Validera de anpassade parametrarna i Live-platsbegäran

Kör emulatorn och öppna Logcat. Filtrera efter en av parametrarna för att verifiera att begäran innehåller de parametrar som krävs:
Verifiera anpassade parametrar i Live-platsbegäran

NOTE
Begäranden och parametrar för orderbekräftelse: Även om de inte används i det här demoprojektet registreras orderinformationen vanligtvis i en verklig implementering så att Target kan använda orderdetaljer som mått/dimensioner. I dokumentationen finns instruktioner om hur du implementerar beställningsbekräftelsebegäran och parametrar.
NOTE
Analyser för mål (A4T): Adobe Analytics kan konfigureras som rapportkälla för Target. På så sätt kan alla mått som samlas in av Target SDK visas i Adobe Analytics. Mer information finns i A4T-översikten.

Snyggt jobbat! Nu när parametrarna finns på plats är vi redo att använda dessa parametrar för att skapa målgrupper och erbjudanden i Adobe Target.

NÄSTA :"Skapa publiker och erbjudanden" >

recommendation-more-help
8218628f-a032-465b-92c6-10af87ff3168