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, comprueba que hayas realizado estas tareas:

Configuración

Elige la plataforma que utilizas:

Android
  1. Si tu proyecto no tiene un archivo llamado AndroidManifest.xml en el directorio <RAÍZ DEL PROYECTO>/Assets/Plugins/Android/, crea el proyecto para Android y luego copia el archivo AndroidManifest.xml del directorio Temp/StagingArea/ (lo encontrarás en el directorio que vayas a crear el proyecto). A continuación, pégalo en <RAÍZ DEL PROYECTO>/Assets/Plugins/Android/.
  2. Añade los siguientes permisos a AndroidManifest.xml en el directorio <RAÍZ DEL PROYECTO> /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, añade el servicio tal y como se indica a continuación:
    <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. Añade las bibliotecas siguientes a tu proyecto de Xcode:
    • AdSupport.framework
    • CoreData.framework
    • SystemConfiguration.framework
    • libz.dylib
    • libsqlite3.dylib
  2. Si prefieres que las bibliotecas se añadan automáticamente al crear el proyecto en iOS, copia el archivo PostProcessBuildPlayer_GA del directorio iOS Extras y pégalo en el directorio <RAÍZ DEL PROYECTO>/Assets/Editor.
  3. Descarga la secuencia de comandos mod_pbxproj.py y cópiala en el directorio Editor. Las bibliotecas se añadirán automáticamente cuando crees el proyecto.

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 del juego.
  2. En la vista de inspector se mostrará un componente de secuencia de comandos adjunto al objeto prefab con varias propiedades. Asigna los valores correspondientes del proyecto a estas propiedades. El objeto se rellenará con el valor adecuado y podrá usarse en todo el 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. Ya puedes empezar a hacer el seguimiento del GameObject. Repite el proceso para todos los objetos que quieras supervisar con el mismo objeto prefab.

Pasos siguientes

Recursos