Plug-in do Google Analytics para Unity — 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ê já concluiu estas etapas:

Configuração

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

Android
  1. 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/.
  2. 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" />
          
  3. 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>
          
iOS
  1. Adicione as seguintes bibliotecas ao seu projeto 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 GAv4

Para configurar o prefab do GAv4:

  1. 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.
  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 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:

  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ê deseja 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 GoogleAnalyticsV4. Por exemplo:
    public GoogleAnalyticsV4 googleAnalytics;
  3. Salve o script e volte à janela do Unity.
  4. 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.
  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