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ê já concluiu estas etapas:
- Você deve ter pelo menos uma propriedade e uma vista da propriedade (perfil) do Google Analytics para as quais enviar dados do seu jogo.
- Faça o download do pacote apropriado do Unity no repositório do Plug-in do Google Analytics para Unity e importe-o para seu projeto do Unity. Para isso, clique duas vezes no arquivo.
- Com suporte a bitcode:
GoogleAnalyticsV4_bitcode.unitypackage
- Sem suporte a bitcode:
GoogleAnalyticsV4.unitypackage
- Com suporte a bitcode:
Configuração
Escolha uma plataforma para os detalhes de configuração:
- Se seu projeto ainda não tem um arquivo chamado AndroidManifest.xml no diretório <YOUR PROJECT ROOT>/Assets/Plugins/Android/, crie o projeto para Android e copie o arquivo AndroidManifest.xml do diretório Temp/StagingArea/. Ele fica abaixo do diretório em que você criou o projeto. Cole-o em <YOUR PROJECT ROOT>/Assets/Plugins/Android/.
- Adicione as seguintes permissões a 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.android.gms.analytics.CampaignTrackingService" /> <receiver android:name="com.google.android.gms.analytics.CampaignTrackingReceiver" android:exported="true" > <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
-
Adicione as seguintes bibliotecas ao seu projeto 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 GAv4
Para configurar o prefab do GAv4:
- Clique no objeto do prefab do
GAv4.prefab
, localizado em Assets/Plugins/GoogleAnalyticsV4 na Visualização do projeto. Arraste-o para a hierarquia de jogos. - 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 Tracking Code: UA-XXXXXXX-1
iOS Tracking Code: UA-XXXXXXX-2
Other Tracking Code: UA-XXXXXXX-3
Product Name: MyGame
Bundle Identifier: com.example.games
Bundle Version: 1.0
Dispatch Period: 5
Sample Frequency: 100
Log Level: VERBOSE
Anonymize IP: false
Uncaught Exception Reporting: false
Send Launch Event: false
Session Timeout: 1800
Dry Run: false
Advertiser Id Support - Send IDFA/AdID: false
Acompanhar um objeto
Depois de configurar o prefab do GAv4, para acompanhar um objeto com o Google Analytics:
- 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ê deseja 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 GoogleAnalyticsV4. Por exemplo:
public GoogleAnalyticsV4 googleAnalytics;
- Salve o script e volte à janela do Unity.
- Na Visualização do inspetor do GameObject que deseja acompanhar, você verá o script que criou e um campo a ser preenchido chamado Google Analytics (ou o nome da variável que escolheu). Arraste o objeto GAv4 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.