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:
- Debes tener al menos una propiedad de Google Analytics y una vista (perfil) a las que se enviarán los datos desde el juego.
- Descarga el paquete de Unity adecuado del repositorio del complemento de Google Analytics para Unity e impórtalo a tu proyecto de Unity (bastará con hacer doble clic en el archivo).
- Con compatibilidad con el formato bitcode:
GoogleAnalyticsV4_bitcode.unitypackage
- Sin compatibilidad con el formato bitcode:
GoogleAnalyticsV4.unitypackage
- Con compatibilidad con el formato bitcode:
Configuración
Elige la plataforma que utilizas:
- 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/.
- 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" />
- 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>
-
Añade las bibliotecas siguientes a tu proyecto de Xcode:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- 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.
- 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:
- 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. - 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:
- 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.
- Crea una variable pública en la clase para que incluya el objeto GoogleAnalyticsV4. Por ejemplo:
public GoogleAnalyticsV4 googleAnalytics;
- Guarda la secuencia de comandos y vuelve a la ventana de Unity.
- 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.
- 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
- Consulta la guía de referencia de la API para saber qué tipos de hits puedes enviar a Google Analytics.
- Consulta la Guía de implementación de aplicaciones para dispositivos móviles para obtener información sobre cómo usar Google Analytics para medir las interacciones de usuario y responder a preguntas sobre el uso de juegos.