Analytics

Após adicionar a biblioteca ao seu projeto, é possível realizar qualquer uma das chamadas de método do Analytics em qualquer lugar no aplicativo (certifique-se de importar o ADBMobile.h para sua classe).

Ativar relatórios de aplicativos móveis no Analytics

Antes de adicionar o código, peça para que o administrador do Analytics conclua o seguinte procedimento para ativar o rastreamento do ciclo de vida do aplicativo móvel. Essas ações garantem que o conjunto de relatórios esteja pronto para capturar métricas assim que você começar o desenvolvimento.

  1. Abra Ferramentas administrativas > Report Suites e selecione os seus conjuntos de relatórios móveis.

  2. Clique em Editar configurações > Gerenciamento móvel > Relatório de aplicativo móvel.

    Configurações móveis

  3. Clique em Ativar os Relatórios de Aplicativo mais recentes.

    Opcionalmente, também é possível clicar em Ativar o rastreamento de localização em dispositivos móveis e Ativar os relatórios e atribuições herdados para ocorrências em segundo plano.

    Ativar ciclo de vida

Agora, as medições de ciclo de vida estão prontas para serem capturadas, e os Relatórios de aplicativo móvel são exibidos no menu Relatórios na interface dos relatórios de marketing.

Coletar medições de ciclo de vida

  1. Para coletar medições de ciclo de vida no aplicativo, chame collectLifecycleData() no construtor ApplicationUI.

    Por exemplo:

    ApplicationUI::ApplicationUI(bb::cascades::Application *app): QObject(app) {
    //...
    ADBMobile::collectLifecycleData();
    }
    

    Se collectLifecycleData() for chamado duas vezes na mesma sessão, o aplicativo reportará uma falha em cada chamada após a primeira. O SDK define um sinalizador quando o aplicativo é desligado, indicando uma saída bem-sucedida. Se esse sinalizador não estiver definido, collectLifecyleData() relata uma falha.

Eventos, propriedades e eVars

Se você tiver observado o ADBMobile Class and Method Reference, provavelmente está se perguntando onde definir eventos, eVars, props, herdeiros e listas. Na versão 4, não é mais possível atribuir esses tipos de variáveis diretamente no aplicativo. Em vez disso, o SDK usa dados de contexto e regras de processamento para mapear os dados do aplicativo para as variáveis do Analytics para os relatórios.

As regras de processamento oferecem várias vantagens:

  • Você pode alterar o mapeamento de dados sem enviar uma atualização para a loja de aplicativos.
  • Você pode usar nomes significativos para dados em vez de definir variáveis específicas para um conjunto de relatórios.
  • Há pouco impacto no envio de dados extras. Esses valores não aparecerão nos relatórios até que sejam mapeados usando as regras de processamento.

Quaisquer valores atribuídos diretamente às variáveis devem ser adicionados ao HashMap data.

Regras de processamento

As regras de processamento são usadas para copiar os dados enviados em variáveis de dados de contexto para eVars, props e outras variáveis de relatório.

Regras de processamento

O Adobe recomenda agrupar suas variáveis de dados de contexto usando "namespaces", pois ajuda a manter a ordem lógica. Por exemplo, se você quiser coletar informações sobre um produto, defina as seguintes variáveis:

"product.type":"hat";
"product.team":"mariners";
"product.color":"blue";

As variáveis de dados de contexto são classificadas alfabeticamente na interface das regras de processamento, portanto, os namespaces permitem que você visualize rapidamente as variáveis que estão no mesmo namespace.

Além disso, ouvimos que alguns de você estão nomeando chaves de dados de contexto usando o eVar ou número de propriedade:

"eVar1":"jimbo";

Isso pode tornar ligeiramente mais fácil ao executar o mapeamento único nas regras de processamento, mas você perde a legibilidade durante a depuração e futuras atualizações de código podem ser mais difíceis. Em vez disso, recomendamos o uso de nomes descritivos para chaves e valores:

"username":"jimbo";

As variáveis de contexto que definem eventos de contador podem ter a mesma chave e valor:

"logon":"logon";

As variáveis de dados de contexto que definem eventos de incremento podem ter o evento como a chave e a quantidade a ser incrementada como o valor:

"levels completed":"6";
DICA

A Adobe reserva o namespace a.. Além dessa pequena restrição, as variáveis de dados de contexto só precisam ser únicas no logon da empresa para evitar colisões.

Habilitar rastreamento offline

Para armazenar ocorrências quando o dispositivo estiver offline, é possível ativar o rastreamento offline no arquivo ADBMobileConfig.json.

Preste muita atenção aos requisitos do carimbo de data e hora descritos na referência do arquivo de configuração antes de ativar o rastreamento offline.

Métodos do Analytics

Para obter uma lista dos métodos do Analytics disponíveis para o BlackBerry, consulte Métodos do Analytics em Referência de método e classe móvel do Adobe.

Nesta página