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.

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.

Importação da biblioteca ACPCore

Na lição anterior, chamada "Install the Mobile SDK", você adicionou uma declaração de importação para disponibilizar a biblioteca do AdobeCore no arquivo BusBooksActivity. Essa mesma biblioteca será usada para chamadas de API adicionais nas atividades desta lição. Nos próximos exercícios, você usará APIs para rastrear estados ("trackState") e ações ("trackAction") no aplicativo, que são definidos na biblioteca do AdobeCore. 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.

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.

Abaixo estão 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:

public static void trackState(final String state, final Map<String, String> contextData)

Exemplo:

HashMap cData = new HashMap<String, String>();
contextData.put("key", "value");
MobileCore.trackState("state name",contextData);

Rastrear um estado sem dados

  1. Com o aplicativo de amostra aberto no Android™ Studio, vá para BusBooksActivity e role para baixo perto da parte inferior da função onResume

  2. Adicione uma chamada do método trackState

  3. Defina state name para "Booking Screen"

  4. Em vez de adicionar dados extras, adicione null como um espaço reservado na chamada de API

  5. Ou copie e cole no seguinte:

    MobileCore.trackState("Booking Screen", null);
    

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 de depuração do Logcat no Android™ Studio

  3. Procure no console por pageName=Booking%20Screen

  4. Observe que a variável pageName está definida como Booking Screen (com o %20 representando um espaço codificado) e 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 BusBooksActivity e adicione uma importação no começo do arquivo import java.util.HashMap;, abaixo das importações existentes

  2. Na função onResume(), comente (ou exclua) a chamada básica do trackState do último exercício

  3. Adicione uma nova chamada do método trackState, desta vez com dados, criando e nomeando um HashMap, usando o comando "put" para incluir alguns pares chave/valor e, em seguida, chamando esse HashMap na chamada do trackState

  4. Deixe state name como "Booking Screen"

  5. Ou copie e cole em:

    HashMap cData = new HashMap<String, String>();
    cData.put("cd.section", "Bus Booking");
    cData.put("cd.subSection", "Booking");
    cData.put("cd.conversionType", "Landing");
    MobileCore.trackState("Booking Screen", cData);
    

    Chamada do trackState com dados

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 de depuração do Logcat no Android™ Studio

  3. Pesquise por subSection (ou por qualquer uma das chaves ou valores inseridos no código)

  4. Agora veja que, além de pageName estar definido, você também tem os pares chave/valor enviados na ocorrência

    trackState com resultado de dados

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.

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 ao trackState usado acima, exceto que esse método é chamado de trackAction.

Abaixo estão a sintaxe e uma amostra de código da documentação.

Sintaxe:

public static void trackAction(final String action, final Map<String, String> contextData) data;

Exemplo:

HashMap<String, String> contextData = new HashMap<String, String>();
contextData.put("key", "value");
MobileCore.trackAction("action taken", contextData);

Rastrear interação com o alternador de destino

Nesta amostra de aplicativo Bus Booking, você pode alternar a cidade de origem com a cidade de destino clicando na seta entre esses dois valores. Você decidiu que deseja rastrear a interação com esse recurso no Adobe Analytics.

Alternador de destino

Esse alternador é controlado no arquivo BusBooksActivity do projeto de amostra. Neste exercício, você enviará uma ocorrência do trackAction sempre que as pessoas clicarem na ação.

Para adicionar o código do trackAction

  1. Com o projeto de amostra aberto no Android™ Studio, vá para BusBooksActivity

  2. Localize a função "mBtnFlip.setOnClickListener" na linha 57 ou ao redor dela

  3. Expanda a função, se necessário, para que você possa ver todo o código

  4. Na função onClick, em chamada a flipSourceDesti(), adicione uma chamada a trackAction()

  5. Defina o nome da ação como "Flip Destination" e adicione "null" para o parâmetro contextData (já que não precisamos enviar nenhuma informação adicional desta vez)

  6. Você pode copiar e colar o seguinte código

    MobileCore.trackAction("Flip Destination", null);
    

Agora as funções ficam assim:

Código do Alternador de destino

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 da lixeira para limpar o console do Logcat

  3. Clique na seta do Alternador de destino no simulador e observe que uma nova solicitação (ou mais) será exibida no console

  4. Procure por Flip%20Destination no Logcat

  5. Observe que os parâmetros action e pev2 são Flip%20Destination (com espaço codificado)

  6. Observe a chave/valor pe=lnk_o na mesma linha, mostrando que esta é uma ocorrência de "link personalizado" acionada por trackAction

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