Aggiungere Adobe Analytics

In questa lezione, abiliterai il tracciamento di Adobe Analytics nella tua app.

Adobe Analytics è una soluzione leader di settore che ti consente di comprendere i tuoi clienti come persone e gestire la tua attività grazie alle informazioni sul cliente.

Nelle lezioni Aggiungere estensioni e Installare l’SDK di Mobile , hai aggiunto l’estensione Adobe Analytics alla proprietà tag e l’hai importata nell’applicazione di esempio. Ora è sufficiente aggiungere il codice per tenere traccia degli stati e delle azioni nell’app.

NOTA

Adobe Experience Platform Launch viene integrato in Adobe Experience Platform come suite di tecnologie per la raccolta dati. Nell’interfaccia sono state introdotte diverse modifiche terminologiche di cui tenere conto durante l’utilizzo di questo contenuto:

Finalità di apprendimento

Alla fine di questa lezione, potrai:

  • Verificare che le metriche del ciclo di vita vengano inviate ad Adobe Analytics
  • Aggiungere codice per tenere traccia degli stati nell’app con dati aggiuntivi
  • Aggiungere codice per tenere traccia delle azioni nell’app con dati aggiuntivi

Puoi implementare molti elementi per Analytics nei tag. Questa lezione non è esaustiva, ma fornisce una panoramica delle tecniche principali necessarie da implementare nella tua app.

Prerequisiti

Devi aver già completato le lezioni nella sezione Configura tag . In questa sezione hai aggiunto l’estensione Analytics e hai configurato il server di tracciamento e gli ID suite per report.

Metriche del ciclo di vita e Adobe Analytics

Le metriche del ciclo di vita sono metriche e dimensioni basate sull’ambiente che possono essere facilmente abilitate in un’app tramite l’SDK di Mobile di Experience Platform. In realtà, le hai già aggiunte.

Hai già abilitato le metriche del ciclo di vita quando hai aggiunto l’estensione Core alla tua proprietà e hai seguito le istruzioni di installazione mobile fornite nell’interfaccia. Queste metriche e dimensioni, comprese le metriche specifiche per l’ambiente e l’app quali la versione dell’app, il numero di utenti coinvolti, la versione del sistema operativo, la suddivisione del tempo, i giorni dall’ultimo utilizzo, ecc. possono essere molto utili nell’analisi dell’app, soprattutto quando crei segmenti Analytics da esse che poi applichi a tutti i tuoi report. L’elenco completo delle metriche è disponibile nella documentazione.

Visualizzazione dell’hit del ciclo di vita di Analytics

Sebbene sia possibile visualizzare gli hit del ciclo di vita in qualsiasi programma di debug/packet sniffer, tali hit verranno semplicemente visualizzati nella console di debug Xcode.

  1. Creare ed eseguire il progetto in Xcode in modo che avvii il simulatore

  2. Nella console di debug Xcode, digita lifecycle nel filtro nella parte in basso per limitare la visualizzazione, quindi scorri fino alla parte inferiore delle voci

  3. Osserva la sezione Analytics request was sent with body

  4. Le metriche del ciclo di vita includono elementi come AppID, CarrierName, DayOfWeek, DaysSinceFirstUse e altre metriche/dimensioni elencate nella documentazione

    Debug degli hit del ciclo di vita

Importare la libreria ACPCore

Negli esercizi successivi, utilizzerai le API per monitorare gli stati (“trackState”) e le azioni (“trackAction”) nell’app. Per utilizzare queste API, è necessario importare la libreria che le contiene. Nel nuovo Experience Cloud Platform Mobile SDK, le API trackState e trackAction sono state spostate dalla libreria Analytics alla libreria Core, consentendo l’utilizzo di queste API per scopi diversi dal tracciamento Adobe Analytics.

In questo tutorial, potrai tenere traccia di un solo stato, ma nell’app effettiva dovrai farlo con più stati.

Importare la libreria ACPCore

  1. Apri il file BookingViewController.m in Xcode

  2. Nella parte superiore del file, in genere insieme ad altre istruzioni di importazione, aggiungi #import "ACPCore.h"

  3. Salva

  4. Ora puoi utilizzare le API trackState o trackAction in questo file

Tracciamento degli stati

Nell’app, puoi avere diverse schermate di contenuto che fornisci agli utenti. Sono l’equivalente delle pagine di un sito web. Adobe Analytics fornisce un metodo che consente di inviare questi “hit di visualizzazione delle pagine” e di visualizzarli negli stessi report utilizzati per le proprietà web. Questo metodo è denominato “trackState”.

In questa esercitazione, inserirai il codice per una chiamata trackState in una sola schermata (pagina) dell’app. In uno scenario reale, replicherai questa operazione su tutti gli altri schermi/stati dell’app. Verranno inoltre esplorati alcuni modi diversi di inviare dati (coppie chiave/valore) con l’hit.

Di seguito sono riportati la sintassi e un esempio di codice ripresi dalla documentazione, che potrai copiare e incollare in questa esercitazione o nella tua app.

Sintassi:

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

Esempio:

[ACPCore trackState:@"state name" data:@{@"key":@"value"}];

Tracciare uno stato senza dati

  1. Con l’app di esempio aperta in Xcode, vai a BookingViewController.m e, nella funzione viewDidLoad(), aggiungi una chiamata del metodo trackState

  2. Imposta state name su “Home Screen”

  3. Invece di aggiungere altri dati, aggiungi null come segnaposto nella chiamata del metodo

  4. Oppure copia e incolla i seguenti elementi:

    [ACPCore trackState:@"Home Screen" data:nil];
    

    Chiamata trackState di base

Convalidare trackState

  1. Salvare, generare ed eseguire il progetto.

  2. Quando il simulatore viene eseguito e apre la schermata iniziale dell’app, viene visualizzata la console Xcode

  3. Filtra la console in base alle voci con “home” e osserva la voce in basso che mostra che Analytics request was sent with body

  4. La variabile pageName è impostata su Home Screen e non sono presenti altre coppie di dati personalizzate. Anche se tecnicamente stai impostando un “state name” e non un “page name”, il nome del parametro utilizzato è pageName allo scopo di fornire coerenza con le implementazioni del sito web.

    Risultato trackState di base

Tracciare uno stato con i dati

  1. Torna a BookingViewController.m e, nella funzione viewDidLoad(), commenta (o elimina) la chiamata trackState di base (nessun dato aggiunto) dall’ultimo esercizio

  2. Aggiungi una nuova chiamata del metodo trackState, questa volta con i dati, utilizzando key1 come chiave e value1 come valore

  3. Lascia state name come “Home Screen”

  4. Oppure copia e incolla in:

    [ACPCore trackState:@"Home Screen" data:@{@"key1":@"value1"}];
    

    Chiamata trackState di base

Convalidare trackState con i dati

  1. Salvare, generare ed eseguire nuovamente il progetto.

  2. Quando il simulatore viene eseguito e apre la schermata iniziale dell’app, viene visualizzata la console Xcode

  3. Lascia il filtro come “home” e osserva la voce inferiore che mostra che il Analytics request was sent with body

  4. Ora puoi vedere che oltre all’impostazione pageName, hai anche la coppia chiave/valore che è stata inviata sull’hit

    Risultato trackState di base

NOTA

Se hai familiarità con “props and eVars” in Analytics, noterai che questi nomi di variabili non sono nell’SDK. Tutti i dati chiave/valore provenienti dall’SDK saranno inviati come variabili contextData e come tali dovranno essere mappate su proprietà o eVar (o altre variabili) utilizzando le Regole di elaborazione nell’interfaccia utente di Analytics.

Opzioni aggiuntive di invio dei dati

Nei due esercizi precedenti hai effettuato due richieste, una con dati aggiuntivi e una senza. Tuttavia, cosa succede se vuoi inviare più punti dati ad Analytics con uno schermo o un caricamento di stato? Di seguito sono riportate due opzioni.

Opzione 1: più coppie chiave/valore

Nella chiamata trackState è possibile inviare più coppie chiave/valore semplicemente separandole con una virgola nel set di dati. Ad esempio:

[ACPCore trackState:@"Home Screen" data:@{@"key1":@"value1",@"key2":@"value2",@"key3":@"value3"}];

Opzione 2: oggetto del dizionario

Puoi anche definire un dizionario nel codice e inviarlo anch’esso con trackState. Naturalmente, se hai già definito alcuni oggetti del dizionario nel codice e vuoi inviarli ad Analytics, questa potrebbe essere l’opzione perfetta per te. Ad esempio:

NSDictionary *theStuff = @{@"key1": @"value1",@"key2": @"value2"};
[ACPCore trackState:@"Home Screen" data:theStuff];

Crediti aggiuntivi
Prova queste due opzioni nel codice, visualizzando i risultati nella console di debug Xcode. Puoi utilizzare lo stesso filtro di prima e verificare i risultati per avere la certezza di elaborare le variabili e i valori.

Tracciare le azioni

Simile al tracciamento delle azioni non caricate di pagina su un sito web, spesso desideri tracciare un’azione eseguita da un utente nell’app, ad esempio i clic sugli elementi che non caricano un’altra schermata. Questa operazione viene gestita in modo molto simile al trackState utilizzato in precedenza, con la differenza che questo metodo viene chiamato trackAction.

Di seguito sono riportati la sintassi e un esempio di codice ripresi dalla documentazione, che potrai copiare e incollare in questa esercitazione o nella tua app.

Sintassi:

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

Esempio:

[ACPCore trackAction:@"action name" data:@{@"key":@"value"}];

Tracciare l’interazione con la casella di controllo 'No Stops'

In questa app Bus Booking di esempio, è presente una casella di controllo che consente agli utenti di decidere se limitare i risultati della ricerca alle opzioni. Hai deciso di monitorare l’interazione con quella casella di controllo all’interno di Adobe Analytics.

Casella di controllo NonStop

Questa casella di controllo è controllata nel file BookingViewController.m nel progetto di esempio. In questo esercizio, invierai un hit trackAction ogni volta che gli utenti selezionano o deselezionano la casella.

Impostazione del codice trackAction

  1. Con il progetto di esempio aperto in Xcode, vai a BookingViewController.m e individua la funzione “nonStopButtonToggle”.

  2. Nell’istruzione if, la prima sezione deseleziona la casella se è già selezionata. In questo scenario, desideri inviare un hit con un valore “off”, utilizzando il seguente codice:

    [ACPCore trackAction:@"NonStop Button Interaction" data:@{@"NonStop":@"off"}];
    
  3. Nella sezione successiva (sezione “else”), la casella viene selezionata se non lo è già. In questo scenario, desideri inviare un hit con un valore “on”, utilizzando il seguente codice:

    [ACPCore trackAction:@"NonStop Button Interaction" data:@{@"NonStop":@"on"}];
    

Osserva le altre personalizzazioni nel codice:

  • Stai impostando action name su “NonStop Button Interaction”. Questo valore popolerà il parametro “action” della richiesta e il report/dimensione del collegamento personalizzato in Adobe Analytics.
  • Il nome della key che stai utilizzando è “NonStop”. Questo è il nome chiave che puoi cercare nelle Regole di elaborazione nell’Admin Console di Analytics, in modo da mappare questi valori a una prop o a eVar.

Adesso la funzione si presenta così:

Casella di controllo NonStop

Convalidare il codice trackAction

  1. Dopo aver aggiunto il codice, salva il progetto, esegui e genera.

  2. Fai clic sull’icona del cestino per cancellare la console.

  3. Seleziona la casella nel simulatore, notando che vengono visualizzate due richieste nella console. L’ultima è l’invio di dati ad Adobe Analytics dal codice appena aggiunto.

  4. Potresti notare che entrambi i parametri action e pev2 sono impostati su “NonStop Button Interaction” (con spazi codificati).

  5. Noterai che la coppia chiave/valore "NonStop=on" è presente e può quindi essere assegnata a una prop/eVar nelle Regole di elaborazione.

  6. Osserva il valore o la chiave "pe=lnk_o", che indica che si tratta di un hit di “collegamento personalizzato”, attivato da trackAction.

    Risultato trackAction in Debugger

Ottimo lavoro. Hai completato la lezione di Analytics. Naturalmente, ci sono molte altre cose che puoi fare per migliorare la nostra implementazione di Analytics, ma spero che questo ti abbia dato alcune delle competenze principali per affrontare il resto delle tue esigenze.

Ulteriori vantaggi di trackState e trackAction

In questi ultimi esercizi, hai potuto inviare dati dall’app ad Adobe Analytics utilizzando le API trackState e trackAction. Poiché l’SDK di Experience Platform Mobile ha le radici nei tag, nell’interfaccia di raccolta dati puoi eseguire molte altre operazioni utilizzando il codice appena aggiunto.

Nei tag puoi creare regole attivate dalle API trackState e trackAction e far loro eseguire azioni aggiuntive, ad esempio inviare richieste ad altre soluzioni Adobe o a partner esterni.

Avanti “Aggiungere Adobe Audience Manager” >

In questa pagina