Show Menu
TÓPICOS×

Métodos do Analytics

Esta é uma lista de métodos do Adobe Analytics fornecidos pela biblioteca do iOS.
Atualmente, o SDK é compatível com várias soluções da Adobe Experience Cloud, como o Analytics, o Target, o Audience Manager e o Adobe Experience Platform Identity Service. Métodos recebem o prefixo de acordo com a solução. Os métodos da Experience Cloud ID recebem o prefixo track .
Cada um desses métodos é usado para enviar dados para seu conjunto de relatórios do Adobe Analytics.
  • trackState:​data:
    Os estados são as exibições disponíveis no aplicativo, como home dashboard , app settings , cart , e assim por diante. Esses estados são semelhantes às páginas em um site, e as chamadas de trackState aumentam as visualizações de página. Se state estiver vazio, ele é exibido como nome do aplicativo versão do aplicativo(build) nos relatórios. Caso veja esse valor em relatórios, certifique-se de configurar um state em cada chamada de trackState .
    Esta é a única chamada de rastreamento que aumenta as exibições de página.
    • Esta é a sintaxe para este método:
      + (void)  trackState:(NSString  *)state
                      data:(NSDictionary  *)data;
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile  trackState:@"loginScreen"
                        data:nil]; 
      
      
  • trackAction:​data:
    Rastreia uma ação no seu aplicativo. Ações que deseja medir, como logons , banner taps , feed subscriptions e outras métricas, ocorrem no aplicativo.
    Se você tem um código que pode funcionar enquanto o aplicativo é executado em segundo plano (por exemplo, uma recuperação de dados em segundo plano), use trackActionFromBackground .
    • Esta é a sintaxe para este método:
      +  (void)  trackAction:(NSString  *)action
                        data:(NSDictionary  *)data; 
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile  trackAction:@"heroBannerTouched"
                         data:nil]; 
      
      
  • trackingIdentifier
    Recupera o identificador do rastreamento de análises.
    • Esta é a sintaxe para este método:
      + (NSString *) trackingIdentifier; 
      
      
    • Esta é a amostra de código para este método:
      NSString *trackingId = [ADBMobile trackingIdentifier];
      
      
  • trackActionFromBackground:​data:
    Rastreia uma ação que ocorreu em segundo plano, o que impede os eventos do ciclo de vida de dispararem em determinados cenários.
    Este método deve ser chamado somente no código em execução enquanto o aplicativo estiver em segundo plano.
    • Esta é a sintaxe para este método:
       +  (void)  trackActionFromBackground:(NSString  *)action
                                       data:(NSDictionary  *)data; 
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile  trackActionFromBackground:@"downloadedUpdate"
                                       data:nil];
      
      
  • trackLocation:​data:
    Envia as coordenadas x e y atuais. Também usa pontos de interesse definidos no arquivo ADBMobileConfig.json a fim de determinar se o local fornecido como parâmetro está no POI. Se as coordenadas atuais estão dentro de um POI definido, uma variável de dados de contexto é preenchida e enviada com a chamada trackLocation .
    • Esta é a sintaxe para este método:
      +  (void)  trackLocation:(CLLocation  *)location
                          data:(NSDictionary  *)data; 
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile  trackLocation:userLocation
                           data:nil]; 
      
      
  • trackBeacon:​data:
    Rastreia quando um usuário está perto de um beacon.
    • Esta é a sintaxe para este método:
      +  (void)  trackLocation:(CLBeacon  *)beacon
                          data:(NSDictionary  *)data;
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile  trackBeacon:beacon
                         data:nil];
      
      
  • trackingClearCurrentBeacon
    Apaga os dados de beacons depois que o usuário se distancia de um.
    • Esta é a sintaxe para este método:
      + (void) trackingClearCurrentBeacon;
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile trackingClearCurrentBeacon];
      
      
  • trackLifetimeValueIncrease:​data:
    Adiciona uma amount ao valor do ciclo de vida do usuário.
    • Esta é a sintaxe para este método:
       +  (void)  trackLifetimeValueIncrease:(NSDecimalNumber  *)amount
                                       data:(NSDictionary  *)data; 
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile  trackLifetimeValueIncrease:30
                                         data:nil];
      
      
  • trackTimedActionStart:​data:
    Inicia uma ação programada com a action de nome. Se você chamar este método para uma ação já iniciada, a ação programada anterior será substituída.
    Essa chamada não envia uma ocorrência.
    • Esta é a sintaxe para este método:
      +  (void)  trackTimedActionStart:(NSString  *)action
                                  data:(NSDictionary  *)data; 
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile  trackTimedActionStart:@"cartToCheckout"
                                  data:nil]; 
      
      
  • trackTimedActionUpdate:​data:
    Transmite data para atualizar os dados de contexto associados à action . Os data passados estão anexados aos dados existentes da ação e, se a mesma chave já estiver definida como action , eles substituirão os dados.
    Essa chamada não envia uma ocorrência.
    • Esta é a sintaxe para este método:
       +  (void)  trackTimedActionUpdate:(NSString  *)action
                                    data:(NSDictionary  *)data; 
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile  trackTimedActionUpdate:@"cartToCheckout"
                                    data:@{@"quantity":@"3"}];
      
      
  • trackTimedActionEnd:​logic:
    Encerra uma ação programada. Se você fornecer block , terá acesso aos valores de tempo finais e poderá manipular os data antes de enviar a ocorrência final.
    Se você fornecer block , deverá retornar YES para enviar uma ocorrência. Transmitir nil para block envia a ocorrência final.
    • Esta é a sintaxe para este método:
      +  (void)  trackTimedActionEnd:(NSString  *)action
                          logic:(BOOL  (^)  (NSTimeInterval  inAppDuration,
                                                  NSTimeInterval totalDuration,
                                                  NSMutableDictionary *data))block; 
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile  trackTimedActionEnd:@"cartToCheckout"
                    logic:^(NSTimeInterval inApp,
                    NSTimeInterval  total,
                    NSMutableDictionary  *data)  {
                        data[@"price"]  =  @"49.95";
                        return  YES;
                    }];
      
      
  • trackingTimedActionExists
    Retorna se uma ação cronometrada estiver em andamento.
    • Esta é a sintaxe para este método:
      + (BOOL) trackingTimedActionExists:(NSString *)action;
      
      
    • Esta é a amostra de código para este método:
      BOOL *actionExists = [ADBMobile trackingTimedActionExists];
      
      
  • trackingSendQueuedHits
    Exige SDK 4.1. Independentemente da quantidade de ocorrências presentes atualmente na fila, força a biblioteca a enviar todas as ocorrências da fila offline.
    • Esta é a sintaxe para este método:
      + (void) trackingSendQueuedHits;
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile trackingSendQueuedHits]; 
      
      
  • trackingGetQueueSize
    Recupera o número de ocorrências na fila offline.
    • Esta é a sintaxe para este método:
       + (NSUInteger) trackingGetQueueSize;
      
      
    • Esta é a amostra de código para este método:
      NSUInteger *queueSize = [ADBMobile trackingGetQueueSize];
      
      
  • trackingClearQueue
    Apaga todas as ocorrências da fila offline.
    Tenha cuidado ao limpar a fila manualmente. Esse processo não pode ser revertido.
    • Esta é a sintaxe para este método:
      + (void) trackingClearQueue;
      
      
    • Esta é a amostra de código para este método:
      [ADBMobile trackingClearQueue]; 
      
      
  • trackPushMessageClickThrough
    Rastreia um clique na mensagem por push.
    Este método não incrementa as visualizações de página.
    • Esta é a sintaxe para este método:
      + (void) trackPushMessageClickThrough:(NSDictionary *)userInfo;
      
      
    • Esta é a amostra de código para este método:
      -  (void)application:(UIApplication  *)application  
      didReceiveRemoteNotification:(NSDictionary  *)userInfo  
      fetchCompletionHandler:(void  (^)
      (UIBackgroundFetchResult))completionHandler  {
          // only send the hit if the app is not active
          if (application.applicationState !=  UIApplicationStateActive)  {
              [ADBMobile  trackPushMessageClickThrough:userInfo];
      
          }
          completionHandler(UIBackgroundFetchResultNoData);
      }