Azioni temporizzate

Le azioni temporizzate consentono di misurare il tempo trascorso in-app e il tempo totale dall’inizio alla fine di un’azione. L’SDK calcola il tempo di una sessione e il tempo totale (per più sessioni) necessario per completare l’azione. Puoi usare le azioni temporizzate per definire i segmenti e confrontare il tempo necessario per effettuare un acquisto, per passare al livello successivo, per le fasi del checkout e così via.

Per le azioni temporizzate vengono riportate le metriche seguenti:

  • Numero totale di secondi trascorsi nell’app dall’inizio alla fine, per più sessioni
  • Numero totale di secondi dall’inizio alla fine (in base all’ora effettiva)

Una callback facoltativa consente di eseguire azioni aggiuntive al completamento dell’azione temporizzata:

  • Eseguire il codice e aggiungere qualsiasi logica; logica personalizzata facoltativa in base ai risultati della durata.
  • Aggiungere dati contestuali prima di passare le durate.
  • Annullare l’hit e le durate non ancora inviate.

Tracciamento delle azioni temporizzate

  1. Aggiungi la libreria al tuo progetto e implementa le funzioni di ciclo di vita (lifecycle).

    Per ulteriori informazioni, consulta Aggiungere l’SDK e il file di configurazione al progetto in Implementazione e ciclo di vita di base.

  2. Importa la libreria:

    #import "ADBMobile.h"
    
  3. Invoca trackTimedActionStart e fornisci il nome di un'azione temporizzata ed eventuali dati contestuali.

    [ADBMobile trackTimedActionStart:@"TimeUntilPurchase"  
                                data:@{@"ExperienceName" : experience}];
    
  4. (Facoltativo) Per aggiungere dati di contesto aggiuntivi in qualsiasi momento, puoi invocare trackTimedActionUpdate con il nome dell'azione temporizzata.

    [ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"  
                                 data:@{@"myapp.ImageLiked" : imageName}];
    
  5. Al completamento dell'evento, invoca trackTimedActionEnd e passa il nome dell'azione temporizzata e TimedActionBlock (callback) che controlleranno tutti i dati e le durate calcolate.

    Le metriche degli eventi temporizzati vengono salvate come le variabili della soluzione mobile a scopo di reportistica automatica.

    [ADBMobile trackTimedActionEnd:@"TimeUntilPurchase"  
                             logic:nil];
    

Invio di dati aggiuntivi

Oltre al nome dell'azione temporizzata, con le chiamate di inizio azione e aggiornamento azione puoi inviare anche dati di contesto aggiuntivi:

[ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"  
                             data:@{@"myapp.ImageLiked" : imageName}];

I valori dei dati contestuali devono essere mappati su variabili personalizzate:

Esempio

// Timed Action Start Example 
[ADBMobile trackTimedActionStart:@"TimeUntilPurchase"  
                            data:@{@"ExperienceName" : experience}];

// Timed Action Update Example 
[ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"  
                             data:@{@"ImageLiked" : imageName}];

// Timed Action End Example 
[ADBMobile trackTimedActionEnd:@"TimeUntilPurchase"  
                         logic:nil]; 
 
// Timed Action End Example with Callback 
[ADBMobile trackTimedActionEnd:@"TimeUntilPurchase"  
                         logic:^BOOL(NSTimeInterval inAppDuration,  
                                     NSTimeInterval totalDuration,  
                                     NSMutableDictionary *data) { 
                                        [data setObject:@"PurchaseItem" forKey:@"Item453"]; 
                                        return YES; //return YES to send the hit, NO to cancel 
                                     }];

In questa pagina