Guía para desarrolladores del complemento de Google Analytics para Unity v3 (heredado)

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:

Ajustes y configuración

Elige una plataforma para los detalles de configuración:

Android
  1. 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/.
  2. 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"/>
    :
  3. Si deseas habilitar el seguimiento de campañas, agrega el servicio de la siguiente manera: 
    <service android:name="com.google.analytics.tracking.android.CampaignTrackingService" />
<receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver"
          android:exported="true" >
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>
iOS
  1. Agrega las siguientes bibliotecas al proyecto de Xcode:
    • AdSupport.framework
    • CoreData.framework
    • SystemConfiguration.framework
    • libz.dylib
    • libsqlite3.dylib
  2. 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.
  3. 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 GAv3

Sigue estos pasos para configurar el prefab de GAv3:

  1. Haz clic en el objeto prefab GAv3.prefab, que se encuentra en Assets/Plugins/GoogleAnalyticsV3 en Project View.
  2. 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 Property ID: UA-XXXXXXX-1
    • iOS Property ID: UA-XXXXXXX-2
    • Other Property ID: UA-XXXXXXX-3
    • App Name: MyGame
    • Bundle ID: com.example.games
    • App Version: 1.0
    • Dispatch Period: 5
    • Sample Frequency: 100
    • Debug Mode: VERBOSE
    • Anonymize IP: false
    • Dry Run: false
  3. Arrastra el GAv3 propagado desde la vista Project a la Jerarquía de objetos.

Haz un seguimiento de un objeto

Después de configurar el prefab GAv3, tendrás todo listo para comenzar a realizar el seguimiento de un objeto con Google Analytics. Para ello, sigue estos pasos:

  1. 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.
  2. Crea una variable pública en la clase que contenga el objeto GoogleAnalyticsV3. Por ejemplo: 
    public GoogleAnalyticsV3 googleAnalytics;
  3. Guarda la secuencia de comandos y regresa a la ventana de Unity.
  4. 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 GAv3 de la vista Jerarquía de objetos al campo.
  5. 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

Recursos