Show Menu
TEMAS×

Acciones temporizadas

Las acciones temporizadas le permiten medir el tiempo en la aplicación y el tiempo total entre el comienzo y el final de una acción. El SDK calcula la cantidad de tiempo en cada sesión y el tiempo total entre sesiones que la acción tarda en completarse. Puede utilizar acciones temporizadas para definir segmentos y comparar tiempos de compra, niveles de pase, flujos de cierre de compra, etcétera.
Para las acciones temporizadas se comunican las siguientes métricas:
  • Total de segundos en la aplicación entre inicio y final (entre sesiones)
  • Total de segundos entre inicio y final (tiempo de reloj)
Una llamada de retorno opcional le permite realizar acciones adicionales cuando se completa la acción temporizada:
  • Ejecutar código y agregar cualquier lógica: lógica personalizada opcional basada en los resultados de duración.
  • Agregar datos de contexto antes de pasar las duraciones.
  • Cancelar visitas y duraciones no enviadas todavía.

Seguimiento de acciones temporizadas

  1. Agregue la biblioteca al proyecto e implemente el ciclo vital.
    Para obtener más información, consulte Agregar el SDK y el archivo de configuración a su proyecto en Implementación principal y ciclo de vida .
  2. Importe la biblioteca:
    #import "ADBMobile.h"
    
    
  3. Llame a trackTimedActionStart y proporcione un nombre de acción temporizada y datos de contexto opcionales.
    [ADBMobile trackTimedActionStart:@"TimeUntilPurchase"  
                                data:@{@"ExperienceName" : experience}];
    
    
  4. (Opcional) Para agregar datos de contexto adicionales en cualquier momento, llame a trackTimedActionUpdate con el nombre de la acción temporizada.
    [ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"  
                                 data:@{@"myapp.ImageLiked" : imageName}];
    
    
  5. Cuando el evento se complete, llame a trackTimedActionEnd y transfiera el nombre de la acción temporizada y TimedActionBlock (llamada de retorno), que buscará todos los datos y calculará las duraciones.
    Las métricas de eventos temporizados se guardan en variables de soluciones móviles para la realización automática de informes.
    [ADBMobile trackTimedActionEnd:@"TimeUntilPurchase"  
                             logic:nil];
    
    

Envío de datos adicionales

Además del nombre de la acción temporizada, puede enviar datos de contexto adicionales con las llamadas de inicio y de actualización de acción:
[ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"  
                             data:@{@"myapp.ImageLiked" : imageName}];

El valor de los datos de contexto debe asignarse a variables personalizadas:

Ejemplo

// 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 
                                     }];