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 entre sessões que levará para a 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 reportadas para ações cronometradas:

  • Número total de segundos no aplicativo entre o início e o 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 executar ações adicionais quando a ação cronometrada é concluída:

  • Execute o código e adicione qualquer lógica - lógica personalizada opcional com base nos resultados de duração.
  • Adicione dados de contexto antes de transmitir as durações.
  • Cancele a ocorrência e as durações ainda não enviadas.

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

Nesta página