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 ze al toegevoegd!

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 Levenscyclus Analytics weergeven

Hoewel u de klappen van de Levenscyclus in om het even welke het zuiveren programma/pakketsniffer kunt zien, zullen wij hen eenvoudig in de het zuiveren van Xcode console tonen.

  1. Bouw en stel uw project in Xcode in werking zodat het de simulator lanceert

  2. Typ lifecycle in het filter onderaan in de Xcode-foutopsporingsconsole om te beperken wat er wordt weergegeven en blader vervolgens naar de onderkant van de items

  3. Let op de sectie Analytics request was sent with body

  4. De metriek van de levenscyclus omvat dingen zoals AppID, CarrierName, DayOfWeek, DaysSinceFirstUse, en andere metriek/afmetingen die in documentatie worden vermeld

    Foutopsporing in levenscyclus

De ACPCore-bibliotheek importeren

Bij de volgende oefeningen gebruikt u API's om staten ("trackState") en handelingen ("trackAction") in uw app bij te houden. Als u deze API's wilt gebruiken, moet u de bibliotheek importeren die deze bevat. 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.

In deze zelfstudie wordt slechts één status bijgehouden, maar in uw werkelijke app wilt u meerdere staten bijhouden.

De ACPCore-bibliotheek importeren

  1. BookingViewController.swift openen in Xcode

  2. Aan de bovenkant van het bestand, doorgaans naast andere instructies voor importeren, voegt u import ACPCore toe

  3. Opslaan

  4. U kunt nu trackState- of trackAction-API's gebruiken in dit bestand

    ACPCore importeren naar bestand

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. U zult ook een paar verschillende manieren onderzoeken om gegevens (sleutel/waardeparen) met de slag te verzenden.

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:

+ (void) trackState: (nullable NSString*) state data: (nullable NSDictionary*) data;

Voorbeeld:

ACPCore.trackState("state name", data: ["key": "value"])

Een status zonder gegevens bijhouden

  1. Open de voorbeeldtoepassing in Xcode en ga naar BookingViewController.swift. Voeg in de functie viewDoLoad() een trackState-methodeaanroep toe

  2. state name instellen op Home Screen

  3. In plaats van extra gegevens toe te voegen, voegt u nil toe als tijdelijke aanduiding in de aanroep van de methode

  4. Of kopieer en plak in het volgende:

    ACPCore.trackState("Home Screen", data: nil)
    

    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 Xcode-console

  3. Filter de console naar items met "home" en bekijk de onderste vermelding waaruit blijkt dat de Analytics request was sent with body

  4. De variabele pageName wordt ingesteld op Home Screen 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 BookingViewController.swift, en in de viewDidLoad() functie, commentaar uit (of schrap) de basis (geen toegevoegde gegevens) trackState vraag van de laatste oefening

  2. Voeg een nieuwe trackState methodevraag, dit keer met gegevens toe, gebruikend key1 als sleutel en value1 als waarde

  3. state name laten staan als "Homescherm"

  4. Of kopieer en plak in:

    ACPCore.trackState("Home Screen", data: ["key1": "value1"])
    

    Basic trackState Call

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 Xcode-console

  3. Laat het filter staan als "home" en bekijk de onderste vermelding die aangeeft dat de Analytics request was sent with body

  4. Nu zie dat naast pageName die wordt geplaatst, u ook het sleutel/waardepaar hebt dat binnen op hit werd verzonden

    Basic trackState Result

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.

Aanvullende opties voor gegevensverzending

In de vorige twee oefeningen hebt u twee verzoeken gedaan: één met aanvullende gegevens en één zonder gegevens. Maar wat als u meerdere gegevenspunten wilt verzenden naar Analytics met een scherm- of statusbelasting? Hieronder ziet u twee opties.

Optie 1: Meerdere sleutel-/waardeparen

In de trackState vraag, hebt u de optie om veelvoudige sleutel/waardeparen te verzenden, eenvoudig door komma's die hen in de gegevensreeks scheiden. Bijvoorbeeld:

ACPCore.trackState("Home Screen", data: ["key1": "value1", "key2": "value2"])

Optie 2: Woordenboekobject

U kunt ook een woordenboek in uw code definiëren en dat vervolgens ook met trackState verzenden. Natuurlijk, als u reeds sommige woordenboekvoorwerpen in uw code hebt bepaald, en hen naar Analytics wilt verzenden, kan dit de perfecte optie voor u zijn. Bijvoorbeeld:

let screenInfo = ["key1":"value1", "key2":"value2", "key3":"value3"]
ACPCore.trackState("Home Screen", data: screenInfo)

Extra
CreditGo en probeer deze twee opties uit in uw code, die de resultaten in de Xcode het zuiveren console bekijken. U kunt hetzelfde filter gebruiken als voorheen en de resultaten controleren om er zeker van te zijn dat de variabelen en waarden door komen

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 zeer gelijkaardig aan trackState u hierboven gebruikte, behalve dat wordt deze methode genoemd trackAction.

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:

+ (void) trackAction: (nullable NSString*) action data: (nullable NSDictionary*) data;

Voorbeeld:

ACPCore.trackAction("action name", data: ["key": "value"])

Interactie bijhouden met het selectievakje Geen stops

In deze voorbeeldapp voor het boeken van bussen is er een selectievakje waarmee gebruikers kunnen bepalen of ze hun zoekresultaten willen beperken tot opties. U hebt besloten dat u de interactie met dat selectievakje in Adobe Analytics wilt volgen.

Selectievakje Niet-stoppen

Dit checkbox wordt gecontroleerd in het dossier BookingViewController.swift in het steekproefproject. In deze oefening, zult u een hit trackAction verzenden wanneer de mensen of uncheck de doos controleren.

De code trackAction instellen

  1. Open het voorbeeldproject in Xcode, ga naar BookingViewController.swift, en bepaal de plaats van de "nonStopButtonToggled"functie

  2. In de if verklaring, schrapt de eerste sectie de doos als het reeds wordt geselecteerd. In dit scenario wilt u een hit met de waarde "off" verzenden met de volgende code:

    ACPCore.trackAction("NonStop Button Interaction", data: ["NonStop": "off"])
    
  3. In de volgende sectie (de sectie "else") wordt het selectievakje ingeschakeld als dit nog niet is ingeschakeld. In dit scenario wilt u een hit met de waarde "on" verzenden met de volgende code:

    ACPCore.trackAction("NonStop Button Interaction", data: ["NonStop": "on"])
    

Let op de andere aanpassingen in de code:

  • U plaatst action name aan "Interactie van de Knoop van het NonStop." Deze waarde vult de parameter "action" van de aanvraag en het aangepaste koppelingsrapport/de aangepaste dimensie in Adobe Analytics in
  • De naam van key u gebruikt is "NonStop." Dit is de zeer belangrijke naam die u in het Verwerken van Regels in de Admin Console van Analytics kunt zoeken, zodat u deze waarden aan een steun of een eVar kunt in kaart brengen.

De functie ziet er nu als volgt uit:

Selectievakje Niet-stoppen

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 console te wissen
  3. Controleer de doos in de simulator, opmerkend dat twee verzoeken in de console verschijnen. De laatste is het verzenden van de gegevens naar Adobe Analytics vanuit de code die u zojuist hebt toegevoegd.
  4. Zowel de parameters action als pev2 zijn ingesteld op "NonStop Button Interaction" (met gecodeerde spaties).
  5. Bericht dat de sleutel/waardepaar "NonStop=on"aanwezig zijn, en kan dan aan een steun/eVar in de Regels van de Verwerking worden toegewezen
  6. Let op de sleutel/waarde 'pe=lnk_o', die aangeeft dat dit een 'aangepaste link' is die wordt geactiveerd door trackAction.

trackAction Resultaat in Foutopsporing

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