Complemento de Google Analytics para Unity: guía para desarrolladores

En este documento se explican conceptos importantes sobre el uso del complemento de Google Analytics para Unity.

Antes de empezar

Antes de empezar, asegúrate de haber completado los puntos siguientes:

Configuración

Elige una plataforma para obtener la información de configuración:

Android
  1. Si tu proyecto no tiene un archivo llamado AndroidManifest.xml en el directorio <YOUR PROJECT ROOT>/Assets/Plugins/Android/, compila el proyecto para Android y copia el archivo AndroidManifest.xml del directorio Temp/StagingArea/ (se encuentra debajo del directorio elegido para la compilación). Pégalo en <YOUR PROJECT ROOT>/Assets/Plugins/Android/.
  2. Agrega los siguientes permisos al archivo AndroidManifest.xml en <YOUR PROJECT ROOT>/Assets/Plugins/Android/ encima de la etiqueta <application>:
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
          
  3. Si quieres habilitar el seguimiento de campañas, agrega el servicio del siguiente modo:
    <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. Agrega las siguientes bibliotecas a tu proyecto Xcode:
    • AdSupport.framework
    • CoreData.framework
    • SystemConfiguration.framework
    • libz.dylib
    • libsqlite3.dylib
  2. Si prefieres que las bibliotecas se agreguen automáticamente durante la compilación para iOS, copia el archivo PostProcessBuildPlayer_GA del directorio iOS Extras e inclúyelo en el directorio <YOUR PROJECT ROOT>/Assets/Editor.
  3. Descarga la secuencia de comandos mod_pbxproj.py y cópiala en el directorio Editor. Las bibliotecas se agregarán automáticamente durante la compilación.

Configurar el objeto prefab GAv4

Para configurar el objeto prefab GAv4:

  1. Haz clic en el objeto prefab GAv4.prefab, que se encuentra en Assets/Plugins/GoogleAnalyticsV4 en la vista de proyecto. Arrástralo a la jerarquía de juegos.
  2. En la vista de inspector se mostrará un componente de secuencia de comandos adjunto al objeto prefab con varias propiedades. Completa estas propiedades con los valores correctos de tu proyecto. De este modo se completará el objeto para que se pueda usar en cualquier parte del proyecto. Por ejemplo:
    • 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

Realizar el seguimiento de un objeto

Tras configurar el objeto prefab GAv4, sigue estos pasos para realizar el seguimiento de un objeto con Google Analytics:

  1. Identifica el objeto GameObject del que quieras hacer el seguimiento (por ejemplo, un objeto Player) y haz clic en él en la vista de jerarquía de objetos. Si todavía no has adjuntado una secuencia de comandos al objeto del que quieres realizar el seguimiento, crea una con el botón Add Component (Agregar componente) de la vista de inspector.
  2. Crea una variable pública en la clase para que incluya el objeto GoogleAnalyticsV4. Por ejemplo:
    public GoogleAnalyticsV4 googleAnalytics;
  3. Guarda la secuencia de comandos y vuelve a la ventana de Unity.
  4. En la vista de inspector del objeto GameObject del que quieres realizar el seguimiento se mostrará la secuencia de comandos que has creado y un campo para rellenar que se llama "Google Analytics" (o el nombre de variable que hayas elegido). Arrastra el objeto GAv4 de la vista de jerarquía de objetos al campo.
  5. Ahora ya estás preparador para iniciar el seguimiento del objeto GameObject. Repite el proceso para los demás objetos de los que quieras hacer el seguimiento mediante el mismo objeto prefab.

Pasos siguientes

Recursos