Este documento explica conceitos importantes sobre como usar o plug-in do Google Analytics para Unity.
Antes de começar
Antes de começar, verifique se você concluiu os seguintes itens:
- Você precisa ter pelo menos uma propriedade e uma vista (perfil) do Google Analytics para enviar dados do seu jogo.
- Se você pretende acompanhar transações de e-commerce, ative esse recurso nos seus relatórios.
- Faça o download do interesse no repositório do plug-in do Google Analytics para Unity (link em inglês) e importe-o para seu projeto do Unity.Para isso, clique duas vezes no arquivo.
Configuração
Escolha uma plataforma para os detalhes de configuração:
- Se o projeto ainda não tiver um arquivo chamado AndroidManifest.xml no diretório <YOUR PROJECT ROOT>/Assets/Plugins/Android/, crie o projeto para Android e copie o AndroidManifest.xml do diretório Temp/StagingArea/ (ele vai estar no diretório escolhido para criação). Cole-o em <YOUR PROJECT ROOT>/Assets/Plugins/Android/.
- Adicione as seguintes permissões para o
AndroidManifest.xml em <YOUR PROJECT ROOT>
/Assets/Plugins/Android/ acima da
tag
<application>
:<uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
- Se você quiser ativar o acompanhamento de campanhas, adicione o serviço da seguinte maneira:
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService" /> <receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true" > <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
-
Adicione as seguintes bibliotecas ao seu projeto do Xcode:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- Se você preferir que as bibliotecas sejam adicionadas automaticamente ao criar projetos para iOS, copie o arquivo PostProcessBuildPlayer_GA do diretório iOS Extras e coloque-o no diretório <YOUR PROJECT ROOT>/Assets/Editor.
- Faça o download do script mod_pbxproj.py e copie-o para o diretório do Editor. As bibliotecas passarão a ser adicionadas automaticamente durante a criação.
Configurar o prefab do GAv3
São necessárias as seguintes etapas para configurar o prefab do GAv3:
- Clique no objeto prefab
GAv3.prefab
, que pode ser encontrado em Assets/Plugins/GoogleAnalyticsV3 na Visualização do projeto. - A Visualização do inspetor exibirá um Componente de script anexado ao prefab com várias propriedades listadas.
Preencha essas propriedades com os valores corretos para seu projeto. Isso preencherá o objeto para que ele possa ser usado em todos os lugares do seu projeto. Por
exemplo:
Android Property ID: UA-XXXXXXX-1
iOS Property ID: UA-XXXXXXX-2
Other Property ID: UA-XXXXXXX-3
App Name: MyGame
Bundle ID: com.example.games
App Version: 1.0
Dispatch Period: 5
Sample Frequency: 100
Debug Mode: VERBOSE
Anonymize IP: false
Dry Run: false
- Arraste o GAv3 preenchido da Vista do projeto para a Hierarquia de objetos.
Acompanhar um objeto
Depois de configurar o prefab do GAv3, você estará pronto para começar a acompanhar objetos usando o Google Analytics. Para isso, basta seguir estas etapas:
- Identifique um GameObject que você deseja acompanhar (por exemplo, um objeto de player) e clique nele na Vista Hierarquia do objeto. Se ainda não há um script anexado ao objeto que você quer acompanhar, crie um novo script usando o botão Adicionar componente na Visualização do inspetor.
- Crie uma variável pública na classe para conter o objeto GoogleAnalyticsV3. Por exemplo:
public GoogleAnalyticsV3 googleAnalytics;
- Salve o script e volte à janela do Unity.
- Na Visualização do inspetor do GameObject que você deseja acompanhar, verá o o script que criou e um campo a ser preenchido chamado Google Analytics (ou o nome da variável que escolheu). Arraste o objeto GAv3 da vista Hierarquia do objeto até o campo.
- Agora você está pronto para começar a acompanhar esse GameObject. Repita o processo para outros objetos que você quer acompanhar usando o mesmo prefab.
Próximas etapas
- Revise a Referência de APIs para saber quais tipos de hits você pode enviar ao Google Analytics.
- Leia o Guia de implementação de aplicativos para dispositivos móveis para saber como usar o Google Analytics para avaliar as interações dos usuários e responder a perguntas sobre o uso do jogo.