Eventos de la app de Meta

Primeros pasos: Unity

En esta guía, se muestra cómo puedes agregar eventos a tu app nueva o preexistente usando el SDK de Facebook de Unity.

Antes de empezar

Registro de inicios de la app

El SDK proporciona el método auxiliar FB.ActivateApp para registrar los inicios de la app. Es necesario que inicialices el SDK con FB.Init antes de que puedas llamar a FB.ActivateApp.

Usa la función Awake de MonoBehavior para registrar cuando un usuario inicia tu app.

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

Usa la función OnApplicationPause de MonoBehavior para registrar cuando un usuario reanuda tuu 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();
      });
    }
  }
}

Eventos registrados de forma manual

Los siguientes ejemplos de código muestran cómo registrar eventos manualmente.

Registrar una compra en la app

En este ejemplo, priceCurrency es una cadena que contiene el valor ISO code de tres letras y que representa la divisa usada; priceAmount es un valor float que contiene el precio del artículo comprado; y packageName es una cadena que contiene el SKU code del artículo comprado.

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

Haz seguimiento de un evento en un juego

En el segundo ejemplo, hacemos seguimiento del número de créditos que utiliza un usuario en un juego. numGold es un valor float que contiene el número de créditos que utilizados, y storeItem es una cadena que contiene el nombre del artículo que compró el usuario.

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

Desactivar eventos registrados de forma automática

Después de que integras el SDK de Facebook, se registran y recopilan automáticamente determinados eventos de la app en el administrador de eventos, a menos que desactives el registro automático de eventos. Puedes cambiar esta configuración en el código de tu app o mediante el botón de activación de eventos de la app, ubicado en el panel de apps o en el administrador de eventos. Ten en cuenta que, en el caso de que haya valores contradictorios entre la marca AutoLogAppEventsEnabled y el botón de activación, prevalecerá el valor del botón de activación del "registro automático de eventos del SDK de Facebook". Para obtener información sobre qué información se recopila y cómo desactivar el registro de eventos de la app de manera automática, consulta Registro automático de eventos de la app.

De forma predeterminada, nuestro SDK de Unity permite los eventos registrados automáticamente. Para desactivar o activar el registro automático de eventos, ve a Facebook -> Editar configuración en la barra de menú IDE de Unity y selecciona o desmarca Registro automático de eventos de la app en la sección Configuración de los eventos de la app.

Puedes desactivar mediante programación eventos registrados automáticamente si configuras el método SetAutoLogAppEventsEnabled() de Fb.Mobile en false.

FB.Mobile.SetAutoLogAppEventsEnabled(false);

En algunos casos, es posible que desees volver a activar el registro automático después de que un usuario final dé su consentimiento. Puedes hacerlo configurando el método SetAutoLogAppEventsEnabled() en true.

FB.Mobile.SetAutoLogAppEventsEnabled(true);

Desactivar la recopilación de identificadores de anunciantes

De manera predeterminada, nuestro SDK de Unity permite recolectar los identificadores del anunciante. Para desactivar o activar el registro automático de eventos, ve a Facebook -> Editar configuración en la barra de menú IDE de Unity y selecciona o desmarca Obtención de AdvertiserID en la sección Configuración de los eventos de la app.

Puedes desactivar mediante programación que se obtenga el identificador del anunciante si configuras el método SetAdvertiserIDCollectionEnabled () de Fb.Mobile en false.

FB.Mobile.SetAdvertiserIDCollectionEnabled (false);

En algunos casos, es posible que desees volver a activar la obtención del identificador del anunciante después de que un usuario final dé su consentimiento. Puedes hacerlo configurando el método SetAdvertiserIDCollectionEnabled() en true.

FB.Mobile.SetAdvertiserIDCollectionEnabled (true);

Más información