Игры на Facebook

    События в приложении для игр на Facebook

    Этот App Events API Facebook SDK (JS) упразднен и перестал поддерживаться 1 июля 2022 г. Мы не планируем добавлять новые функции в этот продукт. Мы рекомендуем не использовать FB.AppEvents.LogEvent, а отправлять эти события через пиксель Meta.

    События в приложении позволяют вам измерять результативность рекламы и строить аудитории для таргетинга рекламы для игр на Facebook.

    Для этого необходимо отправить событие из приложения через Facebook SDK для JavaScript. Это может быть одно из предопределенных событий, например добавление в корзину в приложении для покупок или достижение уровня в игре, либо специально настроенные события.

    Предварительные требования

    Прежде чем добавить код для измерения событий, зарегистрируйте свое приложение в Facebook. Если оно еще не зарегистрировано в Facebook, это можно сделать здесь.

    Реализация

    Ваша игра на Facebook должна использовать Facebook SDK для JavaScript. Если это не так, прочтите наше руководство по началу работы с JavaScript.

    Зарегистрированные события можно посмотреть в Facebook Events Manager.

    Автоматическая регистрация событий

    Мы автоматически регистрируем для игр на Facebook следующие события:

    • установка приложения — когда человек впервые принимает пользовательское соглашение вашего приложения;
    • запуск приложения — каждый раз, когда человек открывает веб-страницу с вашим приложением.

    Если вы включили платежи на Facebook, будут регистрироваться следующие дополнительные события:

    • начало оформления заказа — человек начал процесс оплаты, чтобы сделать покупку;
    • покупка — человек выполнил оплату в вашем приложении;
    • отмена покупки — человек отменил оплату (сюда относятся как отмененные вручную платежи, так и проблемы с выбранным способом оплаты).

    Примечание. Событие "Отмена покупки" может не регистрироваться, если человек закрыл окно браузера в процессе покупки. Поэтому количество событий "Отмена покупки" может быть не равно разности количества событий "Начало оформления заказа" и "Покупка".

    Зарегистрированные события можно посмотреть в Facebook Events Manager.

    Регистрация событий с параметрами

    Вы можете регистрировать информацию, не предусмотренную автоматической регистрацией событий, чтобы более точно измерять результаты работы вашего приложения на Facebook.com. Например, вы можете регистрировать события прохождения пользователями уровней в игре.

    Ниже показано, как можно регистрировать события с параметром, который его описывает:

    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
);

    Мы рекомендуем использовать одно из предопределенных событий. Однако регистрация специально настроенных событий также поддерживается.

    Можно использовать не более 1 000 уникальных имен событий. Примечание. После достижения этого лимита регистрация новых типов событий прекращается, и выдается ошибка 100 Invalid parameter. Подробную информацию об ограничениях для событий см. в часто задаваемых вопросах.

    Регистрация покупок

    В Facebook SDK имеется специальная функция для регистрации покупок. Для ее работы необходимо указать валюту.

    Платежи, сделанные через игры на Facebook, автоматически регистрируются как события покупки. Следующий код необходимо использовать только для продажи физических товаров.

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

    Чтобы использовать предопределенные параметры, создайте объект params и передайте его в эту функцию, как показано ниже.

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

    Специально настроенные события в приложении

    Вы можете создавать собственные специально настроенные события, указав имя события в виде строки:

    FB.AppEvents.logEvent('battledAnOrc');

    Максимальная длина имени специально настроенного события — 40 знаков. Имя должно содержать только буквы, цифры, символы подчеркивания и дефисы или тире.

    Обработка исключений

    Вызов этой функции SDK JavaScript с неправильными параметрами приведет к исключению. Убедитесь, что в вашем коде передаются правильные параметры и предусмотрена обработка исключений.

    Отладка

    Для повышения производительности SDK для JavaScript загружается в минифицированной версии. Для отладки можно загрузить неминифицированную версию SDK для JavaScript, в которой используется более подробная регистрация и более строгая проверка аргументов. Для этого используется в коде загрузки следующее значение параметра js.src:

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

    Справка