Juegos en Facebook

    Eventos de la aplicación para los Juegos en Facebook

    Esta API de eventos de la aplicación del SDK de Facebook (JS) se ha retirado y se dejó de admitir el 1 de julio de 2022. No tenemos previsto añadir nuevas funciones 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 aplicación te permiten medir el rendimiento de los anuncios y crear audiencias con fines de segmentación de los anuncios de tu juego en Facebook.

    Esto se hace enviando un evento desde la aplicación mediante el SDK de Facebook para JavaScript. Puede tratarse de uno de los eventos predefinidos, como “Artículo añadido al carrito” en una aplicación comercial o “Nivel alcanzado” en un juego, o de cualquier otro evento personalizado.

    Requisitos previos

    Antes de incluir el código para medir eventos, debes registrar la aplicación en Facebook. Si no lo has hecho, puedes hacerlo aquí: Guía de inicio rápido sobre los juegos en Facebook.

    Implementación

    Tu juego en Facebook ya debería incluir el SDK de Facebook para JavaScript. Si no es así, lee la 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 automáticamente los siguientes eventos con relación a los juegos en Facebook:

    • Instalación de la aplicación: la primera vez que se aceptan las condiciones del servicio de tu aplicación.
    • Aplicación iniciada: cada vez que alguien abre la página web que contiene tu aplicación.

    Si has activado los pagos a través de Facebook, se registran los siguientes eventos adicionales:

    • Pago iniciado: una persona inicia el proceso de pago de una compra.
    • Compra efectuada: una persona completa correctamente el pago en tu aplicación.
    • Compra cancelada: una persona cancela el pago de una compra. (Se incluyen los pagos cancelados manualmente y por error en el método de pago).

    Nota: Es posible que un evento “Compra cancelada” no se registre si la persona cierra la ventana del navegador durante la compra. Por eso, el número de eventos “Compra cancelada” puede ser distinto de la diferencia entre los eventos “Finalización de compra iniciada” y “Compra efectuada”.

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

    Registro de eventos con parámetros

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

    A continuación se ofrece un ejemplo de cómo registrar un evento junto a 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
);

    Se recomienda utilizar uno de los eventos predefinidos. No obstante, también puedes registrar eventos personalizados.

    Puedes utilizar hasta 1000 nombres de evento distintos. Nota: Cuando se alcance este límite, no se registrarán nuevos tipos de eventos y, en caso de superarse, aparecerá el error 100 Invalid parameter durante el registro. 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 que se especifique la divisa.

    Los pagos realizados mediante Juegos en Facebook se registran automáticamente como eventos de compra. Solo hace falta utilizar el siguiente código 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 utilizar 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 personalizados de la aplicación

    También puedes crear tus propios eventos personalizados especificando su nombre como una cadena:

    FB.AppEvents.logEvent('battledAnOrc');

    La longitud máxima de un nombre de evento personalizado es de 40 caracteres, y solo puede contener caracteres alfanuméricos, guiones y guiones bajos.

    Capturar excepciones

    Si llamas a la función del SDK para JavaScript proporcionada con los parámetros incorrectos, la función producirá una excepción. Asegúrate de que tu código transmite los parámetros correctos y captura cualquier excepción que se produzca.

    Depuración

    Para mejorar el rendimiento, el SDK para JavaScript se carga minimizado. También puedes cargar una versión de depuración del SDK para JavaScript que incluye más registros y una comprobación de argumentos más estricta, y que además no está minimizada. Para ello, modifica el valor de js.src en el código de carga, como se muestra a continuación:

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

    Referencia