Eventos de la app para juegos en Facebook

Esta API de eventos de la app del SDK de Facebook (JS) quedó obsoleta y dejó de recibir asistencia a partir del 1 de julio de 2022. No hay planes de agregar nuevas características a este producto. En lugar de usar FB.AppEvents.LogEvent, te recomendamos que envíes estos eventos mediante el píxel de Meta.

Los eventos de la app te permiten medir el rendimiento de los anuncios y crear públicos para la segmentación de anuncios de tu juego en Facebook.

Para eso, envía un evento de tu app por medio del SDK de Facebook para JavaScript. Este evento puede ser uno de los eventos predefinidos como "artículo agregado al carrito" en una app de comercio o "nivel alcanzado" en un juego, o algún otro evento personalizado.

Requisitos previos

Antes de incluir el código para medir eventos, debes registrar tu app en Facebook. Si no registraste tu app en Facebook, puedes hacerlo aquí: Inicio rápido de juegos en Facebook.

Implementación

Tu juego en Facebook ya debería incluir el SDK de Facebook para JavaScript. Si no, lee nuestra guía de inicio rápido de JavaScript.

Puedes ver los eventos registrados con el administrador de eventos de Facebook.

Registro automático de eventos

Registramos de forma automática los siguientes eventos de juegos en Facebook:

Instalación de la app: La primera vez que una persona acepta las Condiciones del servicio de tu app.
App iniciada: cada vez que una persona abre la página web que contiene tu app.

Si habilitaste los pagos a través de Facebook, se registrarán los siguientes eventos adicionales:

Pago iniciado: una persona inicia el proceso de pago para realizar una compra.
Comprado: una persona completa con éxito un pago en tu app.
Compra cancelada: Una persona canceló su pago (incluye los pagos cancelados manualmente y los errores en el método de pago).

Nota: Es posible que un evento "Comprar" cancelado no se registre si la persona cierra la ventana del navegador durante la compra. Este es el motivo por el que los eventos "Compra cancelada" pueden no ser equivalentes a la diferencia entre los eventos "Pago iniciado" y "Compra efectuada".

Puedes ver los eventos registrados con el administrador de eventos de Facebook.

Registrar eventos con parámetros

Puedes registrar más información además de los eventos registrados automáticamente para medir mejor el rendimiento de tu app en Facebook.com. Por ejemplo, podrías registrar un evento cada vez que alguien completa un nivel del juego.

A continuación, se ofrece un ejemplo de cómo registrar un evento junto con un parámetro que lo describe:

var params = {};
params[FB.AppEvents.ParameterNames.LEVEL] = '12'; //player level
FB.AppEvents.logEvent(
  FB.AppEvents.EventNames.ACHIEVED_LEVEL,
  null,  // numeric value for this event - in this case, none
  params
);

Recomendamos usar uno de los eventos predefinidos. Sin embargo, también admitimos el registro de eventos personalizados.

La cantidad máxima de nombres de eventos diferentes es 1.000. Nota: No se registrarán tipos nuevos de eventos una vez alcanzado este límite y, si lo excedes, es posible que veas el error 100 Invalid parameter cuando intentes registrar un nuevo evento. Obtén más información sobre los límites de los eventos en las preguntas frecuentes.

Registro de compras

El SDK de Facebook incluye una función dedicada para registrar compras, que requiere la especificación de una divisa.

Los pagos realizados mediante los juegos en Facebook se registran automáticamente como eventos de compra. Es necesario usar el siguiente código solo para la venta de artículos físicos.

var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = 'QW-12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

Para usar los parámetros predefinidos, crea el objeto "params" y luego pásalo a la función, como se muestra a continuación.

var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = '12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

Eventos de la aplicación personalizados

También puedes crear tus propios eventos personalizados especificando sus nombres como cadenas:

FB.AppEvents.logEvent('battledAnOrc');

El nombre de un evento personalizado puede tener una duración máxima de 40 caracteres y solo puede contener caracteres alfanuméricos, guiones y guiones bajos.

Capturar excepciones

Si llamas a la función SDK de JavaScript proporcionada con parámetros incorrectos, la función arrojará una excepción. Asegúrate de que tu código pasa los parámetros correctos y captura las excepciones que se produzcan.

Depuración

Para mejorar el rendimiento, se carga una versión minificada del SDK para JavaScript. También puedes cargar una versión de depuración del SDK para JavaScript que incluya una verificación mayor de registros y de argumentos estrictos y que no se reduzca. Para hacerlo, cambia el valor js.src en el código de carga de la siguiente manera:

js.src = "https://connect.facebook.net/en_US/sdk/debug.js";