Primi passi: Unity

Questa guida mostra come aggiungere App Events alla tua app nuova o esistente utilizzando l'SDK per Unity di Facebook.

Prima di iniziare

Un account sviluppatore di Facebook
Un ID app di Facebook
SDK per Unity di Facebook v4.27 o versioni successive: se non hai ancora implementato l'SDK per Unity di Facebook, consulta la nostra Guida introduttiva.

Avvii dell'app di registro

L'SDK fornisce il metodo dello strumento di assistenza FB.ActivateApp per gli avvii dell'app di registro. Dovrai avviare l'SDK con FB.Init prima di poter chiamare FB.ActivateApp.

Usa la funzione Awake da MonoBehavior per registrare il momento in cui un utente avvia la tua app.

void Awake ()
{
  if (FB.IsInitialized) {
    FB.ActivateApp();
  } else {
    //Handle FB.Init
    FB.Init( () => {
      FB.ActivateApp();
    });
  }
}

Usa la funzione OnApplicationPause da MonoBehavior per registrare il momento in cui un utente riprende la tua app.

// Unity will call OnApplicationPause(false) when an app is resumed
// from the background
void OnApplicationPause (bool pauseStatus)
{
  // Check the pauseStatus to see if we are in the foreground
  // or background
  if (!pauseStatus) {
    //app resume
    if (FB.IsInitialized) {
      FB.ActivateApp();
    } else {
      //Handle FB.Init
      FB.Init( () => {
        FB.ActivateApp();
      });
    }
  }
}

Registrazione manuale degli eventi

I seguenti esempi di codice dimostrano come registrare manualmente gli eventi.

Registrazione di un acquisto in-app

In questo esempio priceCurrency è una stringa contenente l'ISO code di 3 lettere che rappresenta la valuta usata, priceAmount è un float contenente il prezzo dell'articolo acquistato e packageName è una stringa contenente l'SKU code per l'articolo acquistato.

var iapParameters = new Dictionary<string, object>();
iapParameters["mygame_packagename"] = packageName;
FB.LogPurchase(
  priceAmount,
  priceCurrency,
  iapParameters
);

Monitoraggio di un evento in un gioco

Nel secondo esempio stiamo monitorando il numero di crediti che un utente ha speso in un gioco. numGold è un float contenente il numero di crediti spesi e storeItem è una stringa contenente il nome dell'articolo acquistato dall'utente.

var softPurchaseParameters = new Dictionary<string, object>();
softPurchaseParameters["mygame_purchased_item"] = storeItem;
FB.LogAppEvent(
  Facebook.Unity.AppEventName.SpentCredits,
  (float)numGold,
  softPurchaseParameters
);

Disabilitazione degli eventi registrati automaticamente

Dopo aver integrato l'SDK di Facebook, alcuni eventi nell'app vengono registrati e raccolti automaticamente per Gestione eventi, a meno che tu non disabiliti la registrazione automatica degli eventi nell'app. Puoi modificare questa scelta nel codice della tua app o tramite un pulsante di attivazione/disattivazione in Eventi nell'app nella Dashboard gestione app o in Gestione eventi. Tieni presente che in caso di conflitti di valori tra il flag AutoLogAppEventsEnabled e il pulsante di attivazione/disattivazione, sarà seguito il valore nel pulsante "Registrazione automatica degli eventi per l'SDK di Facebook". Per maggiori dettagli sul tipo di informazioni raccolte e su come disabilitare la registrazione automatica degli eventi nell'app, consulta Registrazione automatica degli eventi nell'app.

Il nostro SDK Unity abilita gli eventi registrati automaticamente per impostazione predefinita. Per disabilitare o abilitare la registrazione automatica degli eventi, accedi a Facebook -> Modifica impostazioni nella barra del menu Unity IDE e seleziona o deseleziona Registrazione automatica di App Events nella sezione Impostazioni di App Events.

Puoi disabilitare in modo programmatico gli eventi registrati automaticamente impostando il metodo SetAutoLogAppEventsEnabled() di Fb.Mobile su false.

FB.Mobile.SetAutoLogAppEventsEnabled(false);

In alcuni casi, potresti voler riabilitare la registrazione automatica dopo che un utente finale ha fornito il consenso. Puoi effettuare questa operazione, impostando il metodo SetAutoLogAppEventsEnabled() su true.

FB.Mobile.SetAutoLogAppEventsEnabled(true);

Disabilitazione della raccolta degli ID dell'inserzionista

Il nostro SDK Unity abilita la raccolta degli ID dell'inserzionista per impostazione predefinita. Per disabilitare o abilitare la raccolta dell'ID dell'inserzionista, accedi a Facebook -> Modifica impostazioni nella barra del menu Unity IDE e seleziona o deseleziona Raccolta ID dell'inserzionista nella sezione Impostazioni di App Events.

Puoi disabilitare in modo programmatico la raccolta degli ID dell'inserzionista impostando il metodo SetAdvertiserIDCollectionEnabled () di Fb.Mobile su false.

FB.Mobile.SetAdvertiserIDCollectionEnabled (false);

In alcuni casi, potresti voler riabilitare la raccolta degli ID dell'inserzionista dopo che un utente finale ha fornito il consenso. Puoi effettuare questa operazione impostando il metodo SetAdvertiserIDCollectionEnabled() su true.

FB.Mobile.SetAdvertiserIDCollectionEnabled (true);