Show Menu
TÓPICOS×

Ações cronometradas

As ações cronometradas permitem medir o tempo no aplicativo e o tempo total entre o início e o fim de uma ação. O SDK calcula a quantidade de tempo em cada sessão e o tempo total em todas as sessões que levará para uma ação ser concluída. É possível usar as ações cronometradas para definir segmentos e comparar o tempo de compra, o nível de passagem, o fluxo de finalização da compra e assim por diante.
As seguintes métricas são relatadas para ações cronometradas:
  • Número total de segundos no aplicativo entre as sessões de início e de término - sessões cruzadas
  • Número total de segundos entre o início e o término (hora do relógio)
Um retorno de chamada opcional permite que você tome uma ação adicional quando a ação cronometrada for concluída:
  • Execute o código e adicione qualquer lógica - lógica personalizada opcional baseada em resultados de duração.
  • Adicione dados de contexto antes de transmitir as durações.
  • O cancelamento das ocorrências e durações ainda não foi enviado.

Rastreamento de ações cronometradas

  1. Adicione a biblioteca ao projeto e implemente o ciclo de vida.
    Para obter mais informações, consulte Adicionar o SDK e o arquivo de configuração ao seu projeto em Implementação principal e ciclo de vida .
  2. Importe a biblioteca:
    #import "ADBMobile.h"
    
    
  3. Chame trackTimedActionStart e forneça um nome de ação cronometrada e dados de contexto opcionais.
    [ADBMobile trackTimedActionStart:@"TimeUntilPurchase"  
                                data:@{@"ExperienceName" : experience}];
    
    
  4. (Opcional) Para adicionar dados de contexto adicionais, é possível chamar trackTimedActionUpdate com o nome da ação agendada.
    [ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"  
                                 data:@{@"myapp.ImageLiked" : imageName}];
    
    
  5. Quando o evento for concluído, faça uma chamada para trackTimedActionEnd e passe o nome da ação agendada e TimedActionBlock (chamada de retorno) que verificará todos os dados e calculará as durações.
    As métricas de eventos cronometrados são salvas em variáveis da solução móvel para relatórios automáticos.
    [ADBMobile trackTimedActionEnd:@"TimeUntilPurchase"  
                             logic:nil];
    
    

Envio de dados adicionais

Além do nome da ação cronometrada, você pode enviar dados de contexto adicionais com as chamadas de ação de atualização e de início:
[ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"  
                             data:@{@"myapp.ImageLiked" : imageName}];

Os valores dos dados de contexto devem ser mapeados para variáveis personalizadas:

Exemplo

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