Plug-in do Google Analytics para Unity v3 (legado) – guia do desenvolvedor

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:

Configuração

Escolha uma plataforma para os detalhes de configuração:

Android
  1. 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/.
  2. 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"/>
  3. 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>
iOS
  1. Adicione as seguintes bibliotecas ao seu projeto do Xcode:
    • AdSupport.framework
    • CoreData.framework
    • SystemConfiguration.framework
    • libz.dylib
    • libsqlite3.dylib
  2. 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.
  3. 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:

  1. Clique no objeto prefab GAv3.prefab, que pode ser encontrado em Assets/Plugins/GoogleAnalyticsV3 na Visualização do projeto.
  2. 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
  3. 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:

  1. 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.
  2. Crie uma variável pública na classe para conter o objeto GoogleAnalyticsV3. Por exemplo: 
    public GoogleAnalyticsV3 googleAnalytics;
  3. Salve o script e volte à janela do Unity.
  4. 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.
  5. 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

Recursos