Adicionar o Adobe Analytics

Nesta lição, você ativará o rastreamento do Adobe Analytics no aplicativo.

O Adobe Analytics é uma solução líder do setor que torna você capaz de entender seus clientes como pessoas e orientar seus negócios com informações de inteligência de clientes.

Nas lições Adicionar extensões e Instalar o SDK do Mobile, você adicionou a extensão do Adobe Analytics à propriedade de tag e a importou para o aplicativo de amostra. Agora, basta adicionar código para rastrear os estados e as ações no aplicativo!

OBSERVAÇÃO

O Adobe Experience Platform Launch está sendo integrado à Adobe Experience Platform como um conjunto de tecnologias de coleção de dados. Várias alterações de terminologia foram implementadas na interface de que você deve estar ciente ao usar este conteúdo:

  • Agora o Platform launch (lado do cliente) é tags
  • O lado do servidor do Platform launch agora é event forwarding
  • As configurações de borda agora são datastreams

Objetivos de aprendizagem

No final desta lição, você poderá:

  • Verificar se as métricas do Lifecycle estão sendo enviadas para o Adobe Analytics
  • Adicionar código para rastrear estados em seu aplicativo com dados adicionais
  • Adicionar código para rastrear ações em seu aplicativo com dados adicionais

Há muitas coisas que podem ser implementadas para o Analytics nas tags. Este tutorial não é exaustivo, mas deve dar a você uma visão ampla das principais técnicas necessárias para a implementação em seu próprio aplicativo.

Pré-requisitos

Você já deve ter concluído as lições na seção Configurar tags. Naquela seção, você adicionou a extensão do Analytics e configurou o servidor de rastreamento e a(s) ID(s) do conjunto de relatórios.

Medições de ciclo de vida e Adobe Analytics

As métricas do Lifecycle são métricas e dimensões baseadas no ambiente que podem ser facilmente ativadas em um aplicativo usando o SDK móvel da Experience Platform. Na verdade, você já as adicionou!

Você já ativou as Medições de ciclo de vida ao adicionar a extensão principal à sua propriedade e seguiu as Instruções de instalação em dispositivos móveis fornecidas na interface. Essas métricas e dimensões, incluindo métricas específicas do ambiente e do aplicativo, como versão do aplicativo, número de usuários envolvidos, versão do SO, separação de tempo, dias desde a última utilização etc. podem ser muito úteis na análise do aplicativo, especialmente quando você cria segmentos do Analytics a partir delas para aplicá-las a todos os relatórios. A lista completa de métricas está disponível na documentação.

Exibição de ocorrência de ciclo de vida do Analytics

Embora você possa ver as ocorrências de ciclo de vida em qualquer programa de depuração/sniffer de pacote, vamos simplesmente mostrá-las no console de depuração do Xcode.

  1. Crie e execute seu projeto no Xcode para que ele inicie o simulador

  2. No console de depuração do Xcode, digite lifecycle no filtro na parte inferior para limitar o que aparece e role até o final das entradas

  3. Observe a seção Analytics request was sent with body

  4. As Medições de ciclo de vida incluem itens como AppID, CarrierName, DayOfWeek, DaysSinceFirstUse e outras métricas/dimensões listadas na documentação

    Depuração de ocorrências de ciclo de vida

Importar a biblioteca ACPCore

Nos próximos exercícios, você usará APIs para rastrear estados ("trackState") e ações ("trackAction") no aplicativo. Para usar essas APIs, é necessário importar a biblioteca que as contém. No novo SDK móvel da plataforma Experience Cloud, as APIs trackState e trackAction foram movidas da biblioteca do Analytics para a biblioteca principal, permitindo o uso dessas APIs para fins diferentes de apenas o rastreamento do Adobe Analytics.

Neste tutorial, você só rastreará um estado, no entanto, no aplicativo real, será desejável rastrear vários estados.

Para importar a biblioteca ACPCore

  1. Abra o arquivo BooksViewController.m no Xcode

  2. Na parte superior do arquivo, normalmente junto com outras declarações de importação, adicione #import "ACPCore.h"

  3. Salvar

  4. Agora você está pronto para usar as APIs trackState ou trackAction neste arquivo

Rastrear estados

No seu aplicativo, você pode ter telas de conteúdo diferentes sendo fornecidas aos seus usuários. Elas são o equivalente às páginas em um site. O Adobe Analytics fornece um método para que você envie essas "ocorrências de exibição de página" e as visualize nos mesmos relatórios usados para suas propriedades da Web. Esse método é chamado "trackState".

Neste tutorial, você colocará o código de uma chamada trackState em apenas uma tela (página) no aplicativo. Na vida real, você replicará isso em todas as outras telas/estados do aplicativo. Você também explorará algumas maneiras diferentes de enviar dados (pares chave/valor) com a ocorrência.

Abaixo está a sintaxe e um exemplo de código da documentação que você pode copiar e colar neste tutorial ou em seu próprio aplicativo.

Sintaxe:

+ (void) trackState: (nullable NSString*) state data: (nullable NSDictionary*) data;

Exemplo:

[ACPCore trackState:@"state name" data:@{@"key":@"value"}];

Rastrear um estado sem dados

  1. Com o aplicativo de amostra aberto no Xcode, vá para BooksViewController.m e, na função viewDidLoad(), adicione uma chamada ao método trackState

  2. Defina state name como "Home Screen"

  3. Em vez de adicionar dados extras, adicione null como um espaço reservado na chamada de método

  4. Ou copie e cole no seguinte:

    [ACPCore trackState:@"Home Screen" data:nil];
    

    Chamada básica do trackState

Para validar o trackState

  1. Salvar, criar e executar o projeto

  2. Quando o simulador executar e abrir a tela inicial do aplicativo, exiba o console do Xcode

  3. Filtre o console para entradas com "home" e observe a entrada inferior que mostra que Analytics request was sent with body

  4. Observe que a variável pageName está definida como Home Screen e que não há outros pares de dados personalizados. Embora tecnicamente você esteja definindo um "nome de estado" e não um "nome de página", o nome de parâmetro usado é pageName para fornecer consistência às implementações do site.

    Resultado básico do trackState

Rastrear um estado com dados

  1. Volte para BooksViewController.m e, na função viewDidLoad(), comente (ou exclua) a chamada básica do trackState (sem dados adicionados) do último exercício

  2. Adicione uma nova chamada do método trackState, desta vez com dados, usando key1 como chave e value1 como valor

  3. Deixe state name como "Home Screen"

  4. Ou copie e cole em:

    [ACPCore trackState:@"Home Screen" data:@{@"key1":@"value1"}];
    

    Chamada básica do trackState

Para validar o trackState com dados

  1. Salve, crie e execute o projeto novamente

  2. Quando o simulador executar e abrir a tela inicial do aplicativo, exiba o console do Xcode

  3. Deixe o filtro como "home" e observe a entrada no final que mostra que Analytics request was sent with body

  4. Agora veja que, além de pageName estar definido, o par chave/valor é enviado na ocorrência

    Resultado básico do trackState

OBSERVAÇÃO

Caso tenha familiaridade com "props e eVars" no Analytics, você observará que esses nomes de variáveis não estão no SDK. Todos os dados de chave/valor provenientes do SDK serão enviados como variáveis contextData e, portanto, precisarão ser mapeados como props ou eVars (ou outras variáveis) usando Regras de processamento na interface do usuário do Analytics.

Opções adicionais de envio de dados

Nos dois exercícios anteriores você fez dois pedidos, um com dados adicionais e outro sem. E se você quiser enviar vários pontos de dados para o Analytics junto com uma tela ou um estado de carregamento? Abaixo estão duas opções.

Opção 1: vários pares chave/valor

Na chamada do trackState, você tem a opção de enviar vários pares chave/valor simplesmente separando-os por vírgula no conjunto de dados. Por exemplo:

[ACPCore trackState:@"Home Screen" data:@{@"key1":@"value1",@"key2":@"value2",@"key3":@"value3"}];

Opção 2: objeto de dicionário

Você também pode definir um dicionário em seu código e enviá-lo para o trackState. É claro que, se você já tiver definido alguns objetos de dicionário em seu código e quiser enviá-los para o Analytics, essa pode ser a opção perfeita para você. Por exemplo:

NSDictionary *theStuff = @{@"key1": @"value1",@"key2": @"value2"};
[ACPCore trackState:@"Home Screen" data:theStuff];

Crédito extra
Vá em frente e tente essas duas opções no código, visualizando os resultados no console de depuração do Xcode. Você pode usar o mesmo filtro de antes e verificar os resultados para certificar-se de que as variáveis e os valores estão aparecendo.

Rastrear ações

Semelhante ao rastreamento de ações não relacionadas ao carregamento de página em um site, geralmente é desejável rastrear uma ação que um usuário realiza no aplicativo, como, por exemplo, cliques em coisas que não carregam outra tela. Isso é feito de forma semelhante à do trackState usado acima, exceto que esse método é chamado de trackAction.

Abaixo está a sintaxe e uma amostra de código da documentação que você pode copiar e colar neste tutorial ou em seu próprio aplicativo.

Sintaxe:

+ (void) trackAction: (nullable NSString*) action data: (nullable NSDictionary*) data;

Exemplo:

[ACPCore trackAction:@"action name" data:@{@"key":@"value"}];

Rastrear interação com a caixa de seleção “Sem interrupções”

Neste aplicativo de amostra Bus Booking, há uma caixa de seleção que permite que os usuários decidam se desejam limitar os resultados da pesquisa às opções. Você decidiu que deseja rastrear a interação com essa caixa de seleção no Adobe Analytics.

Caixa de seleção NonStop

Essa caixa de seleção é controlada no arquivo BooksViewController.m no projeto de amostra. Neste exercício, você enviará uma ocorrência trackAction sempre que as pessoas marcarem ou desmarcarem a caixa.

Configuração do código trackAction

  1. Com o projeto de amostra aberto no Xcode, vá para BooksViewController.m e localize a função "nonStopButtonToggled"

  2. Na declaração if, a primeira seção desmarca a caixa se ela já estiver selecionada. Nesse cenário, é desejável enviar uma ocorrência com um valor "off" usando o seguinte código:

    [ACPCore trackAction:@"NonStop Button Interaction" data:@{@"NonStop":@"off"}];
    
  3. Na próxima seção (a seção "else"), ela marca a caixa se ainda não estiver marcada. Nesse cenário, é desejável enviar uma ocorrência com um valor "on" usando o seguinte código:

    [ACPCore trackAction:@"NonStop Button Interaction" data:@{@"NonStop":@"on"}];
    

Observe as outras personalizações no código:

  • Você está configurando o botão action name como "NonStop Button Interaction". Esse valor preencherá o parâmetro "action" da solicitação e do relatório/dimensão do link personalizado no Adobe Analytics
  • O nome da key que você está usando é "NonStop". Esse é o nome principal que pode ser procurado nas Regras de processamento no Admin Console do Analytics, para que você possa mapear esses valores como prop ou eVar.

Agora as funções ficam assim:

Caixa de seleção NonStop

Validação do código do trackAction

  1. Depois de adicionar o código, salve o projeto, execute e gere a build

  2. Clique no ícone de lixeira para limpar o console

  3. Marque a caixa no simulador e observe que duas solicitações no console são exibidas. A última coisa é o envio dos dados para o Adobe Analytics a partir do código que você acabou de adicionar

  4. Observe que os parâmetros action e pev2 estão definidos como "NonStop Button Interaction" (com espaços codificados)

  5. Observe que o par chave/valor "NonStop=on" está presente e que pode ser atribuído a uma prop/eVar nas Regras de processamento

  6. Observe a chave/valor "pe=lnk_o" que mostra que se trata de uma ocorrência "custom link" acionada pelo trackAction

    Resultado do trackAction no Depurador

Bom trabalho! Você concluiu a lição do Analytics. É claro que há muitas outras coisas que você pode fazer para aprimorar nossa implementação do Analytics, mas espero que isso tenha lhe dado algumas das principais habilidades para atender o resto de suas necessidades.

Benefícios adicionais da trackState e da trackAction

Nesses últimos exercícios, você conseguiu enviar dados do aplicativo para o Adobe Analytics usando as APIs trackState e trackAction. Como o SDK do Experience Platform Mobile está enraizado em tags, há muito mais coisas que você pode fazer na interface da Coleta de dados usando o código que acabou de adicionar.

Em tags, é possível criar Regras acionadas pelas APIs trackState e trackAction e fazer com que elas executem ações adicionais, como fazer solicitações a outras soluções do Adobe ou parceiros externos.

Próximo: "Adicionar o Adobe Audience Manager" >

Nesta página