Plug-in di Google Analytics per Unity v3 (legacy) - Guida per gli sviluppatori

Importante: questo documento descrive una versione precedente del plug-in. I nuovi utenti devono utilizzare il plugin più recente.

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.
• Se intendi monitorare le transazioni e-commerce, attiva l'e-commerce nei report.
• Scarica googleanalyticsv3.unitypackage dal repository Google Analytics Plugin for Unity e importalo nel tuo progetto Unity (dovresti fare doppio clic sul file).

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.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. 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.

Configura il prefabbricato GAv3

Per configurare il prefabbricato GAv3 è necessario seguire questi passaggi:

1. Fai clic sull'oggetto prefabbricato GAv3.prefab, che puoi trovare in Assets/plugin/GoogleAnalyticsV3 nella vista progetto.
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 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. Trascina il GAv3 compilato dalla vista Progetto verso l'alto nella Gerarchia degli oggetti.

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 GAv3, puoi iniziare a monitorare un oggetto utilizzando Google Analytics seguendo questa procedura:

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 GoogleAnalyticsV3. Ad esempio:

   public GoogleAnalyticsV3 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 GAv3 dalla visualizzazione Gerarchia degli oggetti sul campo.
   Se non vedi il campo per aggiungere il prefabbricato GAv3, 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