Introducción a los eventos de la aplicación (Android)

En esta guía se muestra cómo añadir eventos de la aplicación a una aplicación nueva o existente mediante la integración del SDK de Facebook y el registro de dichos eventos.

Antes de empezar

Necesitarás lo siguiente:

• Una cuenta de desarrollador de Meta.
• Un identificador de aplicación de Meta.
• Una cuenta publicitaria vinculada a tu aplicación.
• Implementar el SDK de Facebook para Android.

Añadir eventos de la aplicación

Existen tres maneras de realizar un seguimiento de los eventos en la aplicación:

• Eventos registrados automáticamente: las descargas y los inicios de la aplicación, así como las compras realizadas en ella se registran automáticamente con el SDK de Facebook.
• Herramienta de eventos de la aplicación sin código: usa esta herramienta para añadir eventos estándar sin añadir código a la aplicación.
• Eventos registrados manualmente: añade código a la aplicación para realizar un seguimiento de los eventos estándar y personalizados.

Eventos registrados automáticamente

Cuando utilizas el SDK de Facebook, determinados eventos de la aplicación se registran y recopilan automáticamente para Facebook, a menos que desactives el registro automático de eventos. Estos eventos son pertinentes para todos los casos de uso: segmentación, medición y optimización. Existen tres eventos clave que se recopilan como parte del registro automático de eventos de la aplicación: descarga e inicio de la aplicación, y compra. Si el registro automático está activado, los anunciantes pueden desactivar estos eventos y otros internos de Facebook, como los de impresión de inicio de sesión. No obstante, si has desactivado el registro automático, pero quieres seguir registrando eventos específicos, como los de descarga o compra, implementa manualmente el registro de estos eventos en la aplicación.

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
           android:value="false"/>
  ...
</application>

setAutoLogAppEventsEnabled(true);

setAutoLogAppEventsEnabled(false);

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AutoInitEnabled"
           android:value="false"/>
  ...
</application>

FacebookSdk.setAutoInitEnabled(true)
FacebookSdk.fullyInitialize()

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AdvertiserIDCollectionEnabled"
           android:value="false"/>
  ...
</application>

setAdvertiserIDCollectionEnabled(true);

setAdvertiserIDCollectionEnabled(false);

AppEventsLogger logger = AppEventsLogger.newLogger(this);

logger.logEvent(AppEventsConstants.EVENT_NAME_X);

Bundle params = new Bundle();
params.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT, "[{\"id\": \"1234\", \"quantity\": 2}, {\"id\": \"5678\", \"quantity\": 1}]");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASE,
                54.23,
                params);
Bundle params = new Bundle();
params.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "HDFU-8452");

logger.logEvent(AppEventsConstants.EVENT_NAME_ADDED_TO_CART,
                54.23,
                params);

Para registrar un evento personalizado, simplemente pasa el nombre del evento como una cadena. Esta función supone que el registrador es una instancia de AppEventsLogger y que se ha creado mediante una llamada a AppEventsLogger.newLogger().

public void logBattleTheMonsterEvent () {
    logger.logEvent("BattleTheMonster");
}

Parámetros de eventos

Cada evento se puede registrar con una propiedad valueToSum y un conjunto de hasta 25 parámetros. Se pasan mediante un elemento Bundle, en el que la clave incluye el nombre del parámetro y el valor, un objeto de tipo String o int. Si proporcionas otro tipo de valor no compatible, como boolean, el SDK registra una advertencia en LogginBehavior.APP_EVENT.

Consulta la guía de referencia de los parámetros de eventos estándar para saber cuáles son los parámetros que se usan normalmente con los eventos estándar. La finalidad de estos parámetros es ofrecer orientación, pero también puedes proporcionar tus propios parámetros. La aplicación debe registrar los parámetros para los que te interesa ver desgloses en los insights.

No uses “event” como nombre de un parámetro. Los parámetros personalizados con el nombre “event” no se registrarán. Utiliza otro nombre o añádele un prefijo o un sufijo (por ejemplo, my_custom_event).

Probar el registro de eventos

Con el asistente para anuncios sobre aplicaciones, puedes probar los eventos de la aplicación en tu aplicación para asegurarte de que esta los envía a Facebook.

1. Abre el asistente para anuncios sobre aplicaciones.
2. En Seleccionar una aplicación, elige la aplicación y haz clic en Enviar.
3. Ve a la parte inferior y elige Probar eventos de la aplicación.
4. Inicia la aplicación y envía un evento. Dicho evento se muestra en la página web.

Activar los registros de depuración

Activa los registros de depuración para verificar el uso de eventos de la aplicación desde el lado del cliente. Los registros de depuración contienen respuestas JSON y solicitudes detalladas. Para activar los registros de depuración, añade el código siguiente después de inicializar el SDK de Facebook para Android:

FacebookSdk.setIsDebugEnabled(true);
FacebookSdk.addLoggingBehavior(LoggingBehavior.APP_EVENTS);

Esto se realiza únicamente con fines de depuración. Inhabilita los registros de depuración antes de implementar la aplicación para el público.

Más información

Para obtener más información y consejos útiles sobre los eventos de la aplicación, consulta los documentos siguientes:

• Documentación de referencia del SDK de Facebook para Android.
• Guía de prácticas recomendadas: descubre una gran variedad de aplicaciones de ejemplo y cómo gestiona cada una de ellas los eventos de la aplicación.
• Preguntas frecuentes: consulta nuestras preguntas frecuentes.
• Administrador de anuncios: consulta la información sobre tus anuncios.
• Administrador de eventos: consulta la información sobre los eventos de los que estás realizando un seguimiento.
• Curso de Meta Blueprint: Configure the SDK and App Events for Android
• Curso de Meta Blueprint: Usa eventos de la app para la segmentación, optimización y medición

Aplicaciones de ejemplo

Hemos creado algunos ejemplos para distintos tipos de aplicaciones para mostrarte cómo usar los eventos de la aplicación. Cada una de las aplicaciones de ejemplo ofrece un desglose por pantallas de los distintos eventos con ejemplos de código. Es importante tener en cuenta que estos ejemplos son un punto de partida para tu aplicación y que debes personalizarlos.