En este documento, se explican conceptos importantes sobre el uso del complemento de Google Analytics para Unity.
Antes de comenzar
Antes de comenzar, asegúrate de haber completado los siguientes elementos:
- Debes tener, al menos, una propiedad de Google Analytics y una vista (perfil) a la que puedas enviar datos desde tu juego.
- Descarga el paquete de Unity adecuado del repositorio del complemento de Google Analytics para Unity y, luego, impórtalo a tu proyecto de Unity (para hacerlo, haz doble clic en el archivo).
- Compatibilidad con códigos de bits:
GoogleAnalyticsV4_bitcode.unitypackage
- Sin compatibilidad con códigos de bits:
GoogleAnalyticsV4.unitypackage
- Compatibilidad con códigos de bits:
Ajustes y configuración
Elige una plataforma para los detalles de configuración:
- Si tu proyecto aún no incluye un archivo llamado AndroidManifest.xml en el directorio <YOUR PROJECT ROOT>/Assets/Plugins/Android/, compila el proyecto para Android y, luego, copia el archivo AndroidManifest.xml del directorio Temp/StagingArea/ (se encontrará en el directorio que elegiste compilar). Pégalo en <YOUR PROJECT ROOT>/Assets/Plugins/Android/.
- Agrega los siguientes permisos a 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" />
: - Si deseas habilitar el seguimiento de campañas, agrega el servicio de la siguiente manera:
<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>
-
Agrega las siguientes bibliotecas al proyecto de Xcode:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- Si prefieres que se agreguen las bibliotecas automáticamente cuando se compila para iOS, copia el archivo PostProcessBuildPlayer_GA del directorio iOS Extras y colócalo en el directorio <YOUR PROJECT ROOT>/Assets/Editor.
- Descarga la secuencia de comandos mod_pbxproj.py y cópiala en el directorio del Editor. Ahora, las bibliotecas se agregarán automáticamente durante la compilación.
Cómo configurar el prefab de GAv4
Para configurar el prefab de GAv4, haz lo siguiente:
- Haz clic en el objeto prefab
GAv4.prefab
, que se encuentra en Assets/Plugins/GoogleAnalyticsV4 en Project View. Arrástralo a la jerarquía del juego. - En la vista del Inspector, se mostrará un componente de Script adjunto al prefab con varias propiedades enumeradas.
Propaga estas propiedades con los valores correctos para tu proyecto. Esto
propagará el objeto para que pueda usarse en cualquier parte de tu 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
Haz un seguimiento de un objeto
Después de configurar el prefab GAv4, haz lo siguiente para realizar el seguimiento de un objeto con Google Analytics:
- Identifica un GameObject con el cual desees hacer un seguimiento (por ejemplo, un objeto Player) y haz clic en él en la vista Object Hierarchy. Si todavía no tienes una secuencia de comandos adjunta al objeto del que deseas realizar un seguimiento, crea una nueva secuencia de comandos con el botón Add Component en la vista del Inspector.
- Crea una variable pública en la clase que contenga el objeto GoogleAnalyticsV4. Por ejemplo:
public GoogleAnalyticsV4 googleAnalytics;
- Guarda la secuencia de comandos y regresa a la ventana de Unity.
- En la vista del Inspector del GameObject del que deseas hacer un seguimiento, verás la secuencia de comandos que creaste y un campo para completar llamado Google Analytics (o el nombre de la variable que hayas elegido). Arrastra el objeto GAv4 de la vista Jerarquía de objetos al campo.
- Ya está todo listo para comenzar a hacer un seguimiento de ese GameObject. Repite el proceso para otros objetos de los que desees hacer un seguimiento con el mismo prefab.
Próximos pasos
- Revisa la referencia de la API para saber qué tipo de hits puedes enviar a Google Analytics.
- Lee la Guía de implementación de apps para dispositivos móviles a fin de obtener información sobre cómo usar Google Analytics para medir las interacciones de los usuarios y responder preguntas sobre el uso del juego.