Adobe Analytics toevoegen

In deze les schakelt u het bijhouden van Adobe Analytics in uw app in.

Adobe Analyse een industrie-leidende oplossing die u machtigt om uw klanten als mensen te begrijpen en uw zaken met klantenintelligentie te sturen.

In Voeg Uitbreidingen toe en Installeer de lessen van de Mobiele SDK, voegde u de uitbreiding van Adobe Analytics aan uw markeringsbezit toe en voerde het in de steekproeftoepassing in. U hoeft nu alleen maar code toe te voegen om de statussen en acties in uw app bij te houden.

OPMERKING

Adobe Experience Platform Launch wordt in Adobe Experience Platform geïntegreerd als een reeks technologieën voor gegevensverzameling. Verschillende terminologiewijzigingen zijn geïmplementeerd in de interface die u tijdens het gebruik van deze inhoud moet onthouden:

Leerdoelen

Aan het eind van deze les, zult u kunnen:

  • Controleren of levenscyclusgegevens naar Adobe Analytics worden verzonden
  • Code toevoegen om de statussen in uw app bij te houden met aanvullende gegevens
  • Code toevoegen om handelingen in uw app bij te houden met extra gegevens

Er zijn veel dingen die voor Analytics in markeringen zouden kunnen worden uitgevoerd. Deze les is niet uitputtend, maar zou u een stevig overzicht van de belangrijkste technieken moeten geven u voor implementatie in uw eigen app zult vereisen.

Vereisten

U zou de lessen in Configure markeringen sectie reeds moeten reeds hebben voltooid. In die sectie hebt u de extensie Analytics toegevoegd en de id('s) van de trackingserver en de rapportsuite geconfigureerd.

Levenscyclusstatistieken en Adobe Analytics

Levenscyclusmetriek zijn maatstaven en afmetingen op basis van de omgeving die in een app eenvoudig kunnen worden ingeschakeld met de Experience Platform Mobile SDK.

U hebt de levenscyclusmetriek al ingeschakeld toen u de Core-extensie aan uw eigenschap toevoegde en de instructies voor het installeren van mobiele apparaten in de interface volgde. Deze maatstaven en afmetingen, inclusief omgevings- en toepassingsspecifieke meetgegevens zoals app-versie, aantal betrokken gebruikers, OS-versie, tijdsverdeling, dagen sinds laatste gebruik, enz. Dit kan erg handig zijn bij de analyse van uw app, vooral wanneer u vanuit deze segmenten analytische elementen maakt die u op al uw rapporten wilt toepassen. De volledige lijst van metriek is beschikbaar in documentatie.

De ACPCore-bibliotheek importeren

In de eerdere les met de naam "Installeer de mobiele SDK", hebt u een importinstructie toegevoegd om de AdobeCore-bibliotheek beschikbaar te maken in het BusBookingActivity-bestand. Deze zelfde bibliotheek zal voor extra API vraag in de activiteiten in deze les worden gebruikt. Bij de volgende oefeningen gebruikt u API's om de statussen ("trackState") en acties ("trackAction") in uw app bij te houden, die in de AdobeCore-bibliotheek zijn gedefinieerd. In het nieuwe Experience Cloud Platform Mobile SDK zijn de API's trackState en trackAction verplaatst van de Analytics-bibliotheek naar de Core-bibliotheek, zodat deze API's kunnen worden gebruikt voor andere doeleinden dan alleen Adobe Analytics tracking.

Frames bijhouden

In uw app hebt u mogelijk veel verschillende schermen met inhoud die u aan uw gebruikers biedt. Dit is het equivalent van pagina's op een website. Adobe Analytics biedt een methode waarmee u deze "paginaweergavehits" kunt verzenden en deze kunt weergeven in dezelfde rapporten als waarmee u voor uw wegeigenschappen werkt. Deze methode wordt ''trackState'' genoemd.

In deze zelfstudie plaatst u de code voor een trackState-aanroep in slechts één scherm (pagina) in uw app. In de praktijk zult u dit repliceren op alle andere schermen/staten in uw app.

Hieronder vindt u syntaxis en een codevoorbeeld uit de documentatie die u in deze zelfstudie of in uw eigen app kunt kopiëren en plakken.

Syntaxis:

public static void trackState(final String state, final Map<String, String> contextData)

Voorbeeld:

HashMap cData = new HashMap<String, String>();
contextData.put("key", "value");
MobileCore.trackState("state name",contextData);

Een status zonder gegevens bijhouden

  1. Open de voorbeeldtoepassing in Android™ Studio en ga naar BusBookingActivity en schuif omlaag onderaan naar de functie onResume

  2. Een aanroep van de methode trackState toevoegen

  3. state name instellen op "Boekscherm"

  4. Voeg null toe als tijdelijke aanduiding in de API-aanroep in plaats van extra gegevens toe te voegen

  5. Of kopieer en plak in het volgende:

    MobileCore.trackState("Booking Screen", null);
    

Basic trackState Call

De trackState valideren

  1. Het project opslaan, bouwen en uitvoeren

  2. Wanneer de simulator het beginscherm van de app uitvoert en opent, bekijkt u de Foutopsporingsconsole voor Android™ Studio Logcat

  3. Zoek in de console naar pageName=Booking%20Screen

  4. De variabele pageName wordt ingesteld op Booking Screen (met de %20 als gecodeerde ruimte) en er zijn geen andere aangepaste gegevensparen. Hoewel u technisch gezien een "staatsnaam" instelt en geen "paginanaam", wordt de parameternaam pageName gebruikt om consistentie met website-implementaties te verzekeren.

    Basic trackState Result

Een status bijhouden met gegevens

  1. Ga terug naar BusBookingActivity, en voeg een invoer aan de bovenkant van het dossier import java.util.HashMap; onder de bestaande invoer toe

  2. In de functie onResume(), verwijder (of schrap) de basistrackState vraag van de laatste oefening

  3. Voeg een nieuwe trackState methodevraag, dit keer met gegevens toe door HashMap te creëren en te noemen, gebruikend het "put"bevel om sommige zeer belangrijke/waardeparen te omvatten, en dan die HashMap in de vraag aan trackState te roepen

  4. state name laten staan als "Boekscherm"

  5. Of kopieer en plak in:

    HashMap cData = new HashMap<String, String>();
    cData.put("cd.section", "Bus Booking");
    cData.put("cd.subSection", "Booking");
    cData.put("cd.conversionType", "Landing");
    MobileCore.trackState("Booking Screen", cData);
    

    trackState Call with Data

De trackState valideren met gegevens

  1. Het project opslaan, bouwen en opnieuw uitvoeren

  2. Wanneer de simulator het beginscherm van de app uitvoert en opent, bekijkt u de Foutopsporingsconsole voor Android™ Studio Logcat

  3. Zoeken naar subSection (of een van de toetsen of waarden die u in de code hebt ingevoerd)

  4. Nu zie dat naast pageName die wordt geplaatst, u ook de sleutel/waardeparen hebt die binnen op hit werden verzonden

    trackState met gegevensresultaat

OPMERKING

Als u bekend bent met 'props and eVars' in Analytics, zult u merken dat deze variabelenamen niet in de SDK staan. Alle sleutel/waardegegevens die afkomstig zijn van de SDK worden als contextData variabelen verzonden en als zodanig moeten aan props of eVars (of andere variabelen) worden toegewezen door Processing Rules in de Analytics UI te gebruiken.

Handelingen bijhouden

Net als bij het bijhouden van handelingen die niet op een website worden geladen, wilt u vaak een handeling bijhouden die een gebruiker in uw app uitvoert, bijvoorbeeld klikken op dingen die geen ander scherm laden. Dit wordt behandeld gelijkaardig aan trackState u hierboven gebruikte, behalve dat wordt deze methode genoemd trackAction.

Hieronder vindt u een syntaxis en een codevoorbeeld uit de documentatie.

Syntaxis:

public static void trackAction(final String action, final Map<String, String> contextData) data;

Voorbeeld:

HashMap<String, String> contextData = new HashMap<String, String>();
contextData.put("key", "value");
MobileCore.trackAction("action taken", contextData);

De Interactie van het spoor met de Schakelaar van de Bestemming

In deze voorbeeldapp voor het boeken van de bus kunt u de plaats van herkomst veranderen in de plaats van bestemming door op de pijl tussen deze twee waarden te klikken. Je hebt besloten dat je de interactie met deze functie in Adobe Analytics wilt volgen.

Bestemmingsschakelaar

Deze schakelaar wordt gecontroleerd in het dossier BusBookingActivity in het steekproefproject. In deze oefening, zult u een hit trackAction verzenden wanneer de mensen op het klikken.

De code trackAction toevoegen

  1. Ga met het voorbeeldproject geopend in Android™ Studio naar BusBookingActivity

  2. Zoek de functie "BtnFlip.setOnClickListener" op of rond regel 57

  3. Vouw indien nodig de functie uit, zodat u alle code kunt zien

  4. In de functie onClick, onder de vraag aan flipSourceDesti(), voeg een trackAction() vraag toe

  5. Plaats de actienaam aan "Bestemming van de Tik", en voeg "ongeldig"voor de parameter contextData toe (aangezien wij echt niet in om het even welke extra info deze keer moeten verzenden)

  6. U kunt de volgende code kopiëren en plakken

    MobileCore.trackAction("Flip Destination", null);
    

De functie ziet er nu als volgt uit:

Code doelswitch

De code trackAction valideren

  1. Nadat u de code hebt toegevoegd, slaat u het project op, voert u het uit en bouwt u het

  2. Klik op het pictogram voor ongewenste details om de Logcat-console te wissen

  3. Klik de pijl van de Omschakeling van de Bestemming in de simulator, opmerkend dat een nieuw verzoek (of meer) in de console verschijnt.

  4. Zoeken naar Flip%20Destination in Logcat

  5. Merk op dat zowel de actie als de parameters pev2 %20Doel omdraaien (met gecodeerde ruimte)

  6. Merk de pe=lnk_o sleutel/waarde op de zelfde lijn op, die aantoont dat dit een "douaneverbindingsaanraakeffect"is, die door trackAction wordt teweeggebracht

Mooi werk! U hebt de les Analytics voltooid. Natuurlijk zijn er veel andere dingen die u kunt doen om onze analytische implementatie te verbeteren, maar hopelijk heeft dit u een aantal van de kernvaardigheden gegeven om de rest van uw behoeften aan te pakken.

Aanvullende voordelen van trackState en trackAction

In deze laatste oefeningen, kon u gegevens van app naar Adobe Analytics verzenden door trackState en trackAction APIs te gebruiken. Omdat het Experience Platform Mobile SDK in markeringen geworteld is, zijn er veel meer dingen die u in de interface van de Inzameling van Gegevens kunt doen gebruikend de code u enkel toevoegde.

In markeringen, kunt u Regels tot stand brengen die door trackState en trackAction APIs worden teweeggebracht, en hen hebben uitvoeren extra acties, zoals het doen van verzoeken aan andere oplossingen van de Adobe of externe partners.

Volgende "Adobe Audience Manager toevoegen" >

Op deze pagina