Plug-in di Google Analytics per Unity - Guida per gli sviluppatori

Questo documento illustra concetti importanti sull'uso del plug-in di Google Analytics per Unity.

Prima di iniziare

Prima di iniziare, assicurati di aver completato quanto segue:

• Dovresti avere almeno una proprietà Google Analytics e una vista (profilo) a cui inviare i dati dal tuo gioco.
• Scarica il pacchetto Unity appropriato dal repository del plug-in di Google Analytics per Unity e importalo nel tuo progetto Unity. Per farlo, fai doppio clic sul file.
  • Con supporto di bitcode: GoogleAnalyticsV4_bitcode.unitypackage
  • Nessun supporto di codice bit: GoogleAnalyticsV4.unitypackage

Impostazione e configurazione

Scegli una piattaforma per i dettagli di configurazione:

Android

1. Se il tuo progetto non contiene già un file denominato AndroidManifest.xml nella directory <YOUR PROJECT ROOT>/Assets/plugin/Android/, crea il progetto per Android, quindi copia AndroidManifest.xml dalla directory Temp/StagingArea/ che si troverà nella directory che hai scelto di integrare. Incollalo in <YOUR PROJECT ROOT>/Assets/plugin/Android/.
2. Aggiungi le seguenti autorizzazioni al file AndroidManifest.xml in <YOUR PROJECT ROOT> /Assets/plugin/Android/ sopra il tag <application>:

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
         

3. Se vuoi attivare il monitoraggio delle campagne, aggiungi il servizio come segue:

   <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. Aggiungi le seguenti librerie al progetto Xcode:
   • AdSupport.framework
   • CoreData.framework
   • SystemConfiguration.framework
   • libz.dylib
   • libsqlite3.dylib
2. Se preferisci che le librerie vengano aggiunte automaticamente durante la creazione per iOS, copia il file PostProcessBuildPlayer_GA dalla directory iOS Extras e inseriscilo nella directory <YOUR PROJECT ROOT>/Assets/Editor.
3. Scarica lo script mod_pbxproj.py e copialo nella directory Editor. Le librerie verranno aggiunte automaticamente durante la build.

Nota: libsqlite3.dylib è richiesto solo se utilizzi il flag del linker -ObjC in Xcode e può essere rimosso in sicurezza dal file PostProcessBuildPlayer_GA se non utilizzi questo flag.

Configurare il prefabbricato GAv4

Per configurare il prefabbricato GAv4:

1. Fai clic sull'oggetto prefabbricato GAv4.prefab, che puoi trovare in Assets/plugin/GoogleAnalyticsV4 nella vista progetto. Trascinala nella gerarchia del gioco.
2. La visualizzazione Esaminatore mostra un componente Script associato al prefabbricato con diverse proprietà elencate. Compila queste proprietà con i valori corretti per il tuo progetto. In questo modo l'oggetto verrà compilato in modo che possa essere utilizzato ovunque nel progetto. Ad esempio:
   • 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

Nota: puoi utilizzare lo stesso ID proprietà per tutte le piattaforme. Per ulteriori informazioni, consulta le best practice per la configurazione di Analytics per app mobile.

Monitorare un oggetto

Dopo aver configurato il prefabbricato GAv4, per monitorare un oggetto con Google Analytics:

1. Identifica un GameObject che vuoi monitorare (ad esempio, un oggetto Player) e fai clic su di esso nella visualizzazione Gerarchia degli oggetti. Se non hai ancora uno script collegato all'oggetto di cui vuoi tenere traccia, crea un nuovo script utilizzando il pulsante Aggiungi componente nella visualizzazione Controllore.
2. Crea una variabile pubblica nella classe in cui inserire l'oggetto GoogleAnalyticsV4. Ad esempio:

   public GoogleAnalyticsV4 googleAnalytics;

3. Salva lo script e torna alla finestra Unity.
4. Nella vista ispettore per il GameObject che vuoi monitorare, vengono visualizzati lo script che hai creato e un campo da compilare chiamato Google Analytics (o il nome della variabile che hai scelto). Trascina l'oggetto GAv4 dalla visualizzazione Gerarchia degli oggetti sul campo.
   Se non vedi il campo per aggiungere il prefabbricato GAv4, verifica che non siano presenti errori di compilazione nello script. Il controllo non verrà aggiornato in caso di errori esistenti.
5. Ora tutto è pronto per iniziare il monitoraggio di GameObject. Ripeti il processo per gli altri oggetti che desideri tracciare utilizzando lo stesso prefabbricato.

Passaggi successivi

• Consulta la documentazione di riferimento API per scoprire che tipo di hit puoi inviare a Google Analytics.
• Leggi la Guida all'implementazione delle app mobile per scoprire come utilizzare Google Analytics per misurare le interazioni degli utenti e rispondere a domande sull'utilizzo dei giochi.

Risorse

• Risolvere i problemi
• Segnala un problema
• Richiedi assistenza
• Log delle modifiche