Este guia de migração descreve as novidades da versão 2 do SDK e oferece aos desenvolvedores dicas para migrar de uma implementação v1.x. Os desenvolvedores que não precisarem migrar de uma implementação v1.x podem começar a usar a versão 2 agora.
Introdução
O Google Analytics lançou recentemente a versão 2 do SDK do Google Analytics para Android. A versão 2 do SDK oferece suporte a novos recursos e uma nova interface de relatórios projetada especificamente para desenvolvedores de apps.
Recomendamos que todos os desenvolvedores atuais do Google Analytics migrem para a versão 2 do SDK do Google Analytics para Android e aproveitem os novos recursos e relatórios.
Novidades da versão 2
A versão 2 do SDK do Google Analytics para Android apresenta uma nova experiência de geração de relatórios projetada para desenvolvedores de apps, novas dimensões e métricas eficientes e muito mais. Confira o que os desenvolvedores ganham com a versão 2:
- Relatórios mais eficientes para desenvolvedores de apps
- Os relatórios padrão foram reformulados para desenvolvedores de apps, adicionando novos relatórios, como Fluxo de engajamento e fontes do Google Play, para ajudar os desenvolvedores a ter novos insights sobre aquisição e experiência de usuários. Leia nossas Práticas recomendadas de configuração da conta para saber mais sobre a melhor forma de configurar sua propriedade para a versão 2.
- Novas dimensões e métricas de aplicativos
- Novas dimensões e métricas específicas do app foram introduzidas na versão 2 do SDK, incluindo nome e exibições de tela, nome do app, versão do aplicativo e muito mais.
- Medir falhas e exceções
- O SDK do Google Analytics para Android apresenta a avaliação de exceções e o tipo de hit de exceção. Com a medição de exceções, é possível saber o número e o tipo de falhas e exceções não fatais. Para saber como implementar a avaliação de exceções, consulte o Guia para desenvolvedores sobre exceções.
- Dimensões e métricas personalizadas
- Crie dimensões personalizadas para segmentar seus dados de novas maneiras. Saiba mais sobre dimensões e métricas personalizadas.
- Medir as interações em redes sociais
- Receba novos insights sobre o valor das redes sociais no seu app medindo as interações do usuário com widgets e plug-ins de redes sociais incorporados. Saiba mais sobre como avaliar interações em redes sociais.
Antes de começar
Todos os desenvolvedores precisam seguir estas duas etapas antes de iniciar a migração:
- Fazer o download do SDK do Google Analytics para Android v2
- Crie uma vista da propriedade (perfil) de aplicativo que você usará para acessar seus novos relatórios e dados de aplicativos.
Depois de concluir as etapas acima, siga as etapas abaixo para seu caminho de migração.
Migrar do EasyTracker
Há três etapas para migrar seu app da v1 para a v2 da biblioteca EasyTracker:
- Atualizar os parâmetros no seu arquivo de recursos GoogleAnalytics.xml
- Atualizar nomes de métodos
- Atualizar o broadcast receiver (acompanhamento de campanha do Google Play)
1. Atualizar parâmetros no GoogleAnalytics.xml
Ao migrar para a versão 2, atualize os parâmetros no arquivo de recurso GoogleAnalytics.xml, já que alguns deles mudaram desde a v1.x e novos parâmetros foram adicionados na versão 2.
A tabela abaixo mostra os parâmetros que foram atualizados na versão 2:
| Nome do parâmetro v1.x | Nome do parâmetro v2.x |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | descontinuado |
Para saber mais, consulte os parâmetros novos e atualizados do EasyTracker.
2. Nomes de métodos de atualização
Embora grande parte da sintaxe permaneça a mesma na versão 2 do EasyTracker, há algumas diferenças notáveis nos nomes e sintaxes dos métodos que exigem que você atualize sua implementação:
trackPageView()ésendView()na versão 2. Para mais informações, consulte o Guia do desenvolvedor sobre acompanhamento de tela- A implementação do comércio eletrônico foi simplificada. Saiba como implementar a avaliação de e-commerce na versão 2.
- As variáveis personalizadas foram substituídas pelas dimensões e métricas personalizadas. Todas
as chamadas para
setCustomVar()precisam ser atualizadas para aproveitar o novo recurso. Saiba como implementar dimensões e métricas personalizadas.
3. Atualizar o broadcast receiver (acompanhamento de campanha do Google Play)
Os desenvolvedores que implementaram o acompanhamento de campanhas do Google Play usando a v1.x precisam observar que o caminho de classe do receptor mudou. Consulte o Guia de acompanhamento de campanhas do Google Play para mais informações.
Migrar de uma implementação personalizada
Se você não usava a biblioteca EasyTracker na v1.x do SDK do Google Analytics para Android, recomendamos que comece a usar o EasyTracker na versão 2.
A biblioteca EasyTracker agora está incluída no SDK e é recomendada para todos os desenvolvedores. Comece a usar o EasyTracker no SDK do Google Analytics v2.
Se você tiver necessidades avançadas de coleta de dados, como o uso de vários IDs de propriedade em uma única implementação, leia o Guia de configuração avançada para saber como usar os recursos avançados da v2.x do SDK.