Jogos no Facebook

    Eventos do app para jogos no Facebook

    A API de Eventos do App do SDK do Facebook (JS) ficou obsoleta e não é mais compatível desde 1º de julho de 2022. Não temos planos de adicionar novos recursos ao produto. Recomendamos enviar esses eventos pelo Pixel da Meta, em vez de usar FB.AppEvents.LogEvent.

    Os evento do app permitem que você mensure o desempenho de anúncios e crie públicos para segmentar o público-alvo de anúncios em Jogos no Facebook.

    Isso é feito ao enviar um evento do seu app com o SDK do Facebook para JavaScript. Esse evento pode ser um dos eventos predefinidos, como "adicionado ao carrinho" em um app de comércio ou "nível alcançado" em um jogo, ou outros eventos personalizados.

    Pré-requisitos

    Antes de incluir o código para mensurar eventos, é necessário registrar o app no Facebook. Se ainda não registrou seu app no Facebook, você pode fazer isso aqui: Início rápido para Jogos da Web do Facebook.

    Implementação

    Seu jogo no Facebook já deve incluir o SDK do Facebook para JavaScript. Caso ainda não inclua, leia nosso guia de início rápido do JavaScript.

    É possível ver os eventos registrados por meio do Gerenciador de Eventos do Facebook.

    Registro automático de eventos

    Registramos de forma automática os seguintes eventos em Jogos no Facebook:

    • Instalação do app: a primeira vez que uma pessoa aceita os Termos de Serviço do app.
    • Inicialização do app: toda vez que uma pessoa abre a página da web do seu app.

    Se você tiver habilitado os pagamentos do Facebook, estes eventos adicionais também são registrados:

    • Finalização da compra iniciada: uma pessoa iniciou o processo de pagamento em uma compra.
    • Compra efetuada: uma pessoa conclui um pagamento no seu app.
    • Compra cancelada: uma pessoa cancelou o pagamento. Isso inclui pagamentos cancelados manualmente e falhas no método de pagamento.

    Observação: um evento de compra cancelada pode não ser registrado se a pessoa fechar a janela do navegador no meio da compra. Por isso, o número de eventos de compra cancelada pode não ser igual à diferença entre eventos de finalização da compra iniciada e de compras.

    É possível ver os eventos registrados por meio do Gerenciador de Eventos do Facebook.

    Registrar eventos com parâmetros

    Você pode registrar informações além dos eventos registrados automaticamente para mensurar com mais precisão o desempenho do seu app em Facebook.com. Por exemplo, é possível registrar um evento sempre que uma pessoa concluir um nível no jogo.

    Veja um exemplo de como registrar um evento com um parâmetro que o descreve:

    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 um evento predefinido. Também aceitamos o registro de eventos personalizados.

    O número máximo de nomes de eventos distintos é mil. Observação: nenhum tipo de evento novo será registrado quando esse limite for atingido; se for ultrapassado, o erro 100 Invalid parameter poderá aparecer durante o registro. Leia mais sobre os limites de eventos nas perguntas frequentes.

    Registrar compras

    O SDK do Facebook inclui uma função dedicada para registrar compras, o que exige a especificação de uma moeda.

    Os pagamentos feitos por meio dos Jogos no Facebook são registrados automaticamente como eventos de compra. O código a seguir só é necessário para vendas de itens físicos.

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

    Para usar os parâmetros predefinidos, crie o objeto de parâmetros e, depois, passe-o para a função, conforme mostrado abaixo.

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

    Eventos personalizados do app

    Você também pode criar os próprios eventos personalizados especificando o nome como uma string:

    FB.AppEvents.logEvent('battledAnOrc');

    O tamanho máximo do nome para eventos personalizados é de 40 caracteres (alfanuméricos, sublinhados ou traços).

    Encontrar exceções

    Se você chamar a função SDK do JavaScript com parâmetros incorretos, a função lançará uma exceção. Verifique se você está passando os parâmetros corretos e encontre as exceções, caso ocorram.

    Depurar

    Para melhorar o desempenho, o SDK do JavaScript carrega minificado. Você também pode carregar uma versão de depuração do SDK do JavaScript que inclui mais registros e verificação de argumentos mais rigorosa, além de não ser minificado. Para isso, altere o valor de js.src no código de carregamento para isto:

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

    Referência