Часто задаваемые вопросы о моментальных играх

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

Общая информация

Войдите на сайт Facebook.com и нажмите закладку Игры слева или откройте страницу https://www.facebook.com/games/instantgames.

Разработка игр

Убедитесь, что ваше приложение относится к категории Игры. Для приложений из других категорий Моментальные игры в списке не отображаются.

Мы не накладываем строгих ограничений на размер игры, но рекомендуем сделать так, чтобы ее первоначальное скачивание занимало не более 5 секунд. Вы можете размещать пакеты объемом до 200 МБ, однако начальная загрузка должна включать только самые необходимые файлы. Дополнительные сведения см. в разделе Рекомендации.

Существует несколько способов хранения информации.

  1. Сторонний бэкенд, с которым ваша игра обменивается информацией при помощи XMLHttpRequest, fetch, WebSocket или EventSource. Этот подход обеспечивает максимальную гибкость, но влечет за собой расходы на хостинг, соразмерные с аудиторией вашей игры.

  2. Наши решения на базе SDK, которые изначально поддерживают многие серверные функции. Для хранения информации об игроке используйте наши методы player.getDataASync и player.setDataAsync. Информацию о таблицах лидеров см. в руководстве по API Leaderboard.

  3. Сторонние сервисы (например, PlayFab), которые предоставляют кроссплатформенные услуги бэкенда с поддержкой LiveOps, организации состязаний и сбора статистики. Узнайте, какие ещё инструменты можно использовать.

Минимальные требования к системе для запуска Моментальных игр — ОС iOS 8 или Android 5.0.

Дополнительную информацию см. в нашем руководстве по облегченным играм.

О проблемах можно сообщить непосредственно на странице Howler.js Github. Чтобы разработчики могли быстрее помочь вам, укажите "[IG]" в заголовке вопроса.

Вы можете использовать (и редактировать) треки из Коллекции звуков Facebook в своих играх. Материалы из Коллекции звуков можно использовать только на платформе Facebook, так что все версии вашей игры с такими материалами можно распространять только на нашей платформе.

Добавление функций в игру

Метод FBInstant.context.shareAsync() содержит параметр intent, который принимает такие значения, как 'INVITE', 'SHARE' и т. д. В версии 4.0 этот параметр не служит никакой конкретной цели. Он был добавлен "на перспективу": в дальнейшем он будет сообщать о тех или иных пользовательских изменениях.

В SDK нет метода, который позволил бы получить информацию о противнике, когда вы впервые бросаете вызов другому игроку в переписке. Мы рекомендуем использовать общее обозначение, (например, "соперник"), пока игрок не ответит на приглашение. После этого вы сможете подставить его фото и имя, используя объект FBinstant.player.

Игровые боты

Чаще всего это происходит из-за его некорректной настройки. Изучите полное руководство по настройке игровых ботов здесь.

В панели разработчика проверьте следующее:

  1. В разделе "Моментальные игры" панели разработчика должна быть настроена Страница приложения.
  2. В разделе "Messenger" должно быть указано, что вы подписаны на события messages и messaging_game_plays.
  3. На панели Подписанные страницы в разделе "Messenger" должна быть настроена та же Страница приложения.
  4. Страница должна иметь категорию "Страница приложения", а ее название — содержать название вашей игры.

Сообщения об ошибках в ответе на запросы API Graph могут указывать на следующее:

вы уже исчерпали лимит в 5 сообщений за 10 дней для одного пользователя;

вы пытаетесь отправить сообщение пользователю, который был удален или заблокирован (временно или окончательно);

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

Дополнительную информацию см. в документации по API Send.

Управление данными

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

Разработчик обязан подтвердить получение запроса, предоставив пользователю ссылку и номер подтверждения, по которым можно ознакомиться с понятным описанием статуса запроса и, если это необходимо, законного основания для отказа в удалении данных. В Facebook для этого предусмотрены все необходимые технические возможности. Законные основания зависят от юрисдикции, обозначенных разработчиком причин и толкования соответствующих правил Facebook в каждом отдельном случае.

Чтобы иметь возможность анализировать запросы и отвечать на них, необходимо сначала реализовать в приложении функцию обратного вызова с запросом на удаление данных. Используйте для этого безопасный протокол HTTPS. Вызов следует указать в поле URL запроса на удаление данных (панель приложений > Моментальные игры > Сведения).

Устранение неполадок

Если вы следуете нашему руководству по началу работы или тестированию, публикации и перепостам, вам должна быть знакома наша концепция встраиваемого плеера. Это способ тестирования Моментальной игры посредством запуска из локальной HTTP-службы на вашем компьютере с доступом ко всем функциям SDK Моментальных игр.

Иногда при этом игра зависает на этапе загрузки. В других случаях в консоли разработчика в браузере не отображаются сообщения или появляется сообщение Failed to execute 'postMessage' on 'DOMWindow'. В обоих случаях возникает ошибка одного типа. Как правило, она вызвана тем, что ваш локальный сервер отказывается обрабатывать объекты из-за проблем с сертификатом.

В этом случае перейдите в корневой каталог локального сервера (как правило, https://localhost:8000 или https://127.0.0.1:8000) и следуйте инструкциям в браузере, чтобы принять сертификаты или добавить этот сайт в список исключений системы безопасности. По завершении вновь перейдите по URL встраиваемого плеера и убедитесь, что проблема устранена.

Эта ошибка возникает при попытке загрузить рекламу из объекта AdInstance, в котором ранее произошел сбой. Если метод loadAsync AdInstance ранее был отклонен, не пытайтесь использовать его повторно. Вместо этого вызовите метод getInterstitialAsync или getRewardedVideoAsync, чтобы запросить новый AdInstance.

Since we removed "blob:" from our CSP configuration, some games made with Unity might encounter an issue at loading time. The error you might get in your web browser's console will look something like this: Refused to load the script 'blob:https://apps-xxx.apps.fb UnityLoader.js'

To solve this issue, you could try to:

  1. Upgrade to a newer version of Unity
  2. Replace the Unity Loader code to use this version of “loadCode” function: loadCode:function(e,t,r){var s=document.createElement("script");s.src="Build/"+r.url,s.onload=function(){t(r.url.split('.').slice(0,-1).join('.')),delete s.onload},document.body.appendChild(s)},
  3. Contact Unity support team

Монетизация игр

Реклама

Платежи

Начало работы с Facebook

To update your payment information:

  1. Go to the Facebook Developers site.
  2. Click My Apps and select Audience Network or Developer tab.
  3. Click the Payout tab.
  4. Select an existing Payout method or create a new one.

We can issue payouts to your bank or PayPal account (does not apply to Audience Netowrk users).

Вам понадобятся:

  • Информация о счете для выплат (адрес, тип налогообложения, номер налогоплательщика)
  • Информация о владельце (имя и фамилия, адрес, дата рождения)
  • Банковские реквизиты (название банка, номер счета или IBAN, страна, код SWIFT или маршрутный номер банка)
  • Реквизиты PayPal (электронный адрес, страна, ID продавца)

Government agencies use tax ID numbers to identify both individuals and businesses when assessing any taxes required by law. Where you live and how your run your business factors into which tax ID numbers you'll need.

  • If you represent a business in the United States or European Union, you'll need to provide a federal employer identification number (FEIN) or a value-added tax identification number (VAT.)
  • If you run your business individually as a sole proprietorship, you'll need to provide a social security number (SSN) or other tax identification (ex: country ID or passport number.)
  • If you live outside of the United States and European Union, you'll need to provide an applicable identification number issued by a government agency. This number should not only uniquely identify you or your business, but it should also be associated with your Audience Network Account.

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

Информацию о начислении и выплате налогов можно найти в разделе 3.9 Условий оплаты.

Использование информации счета для выплат

To update your payout account and financial information, you must be the Financial Admin of your payout account.To update your account information:

  • Go to the Facebook Developers site.
  • Click your profile photo in the top right corner and select Company Settings.
  • Choose the appropriate tab to update your company or financial info. Scroll to the bottom and click Save Changes.

Please note, it may take a few days to finalize any changes you make to your company or financial information. Additionally, your ability to receive your payout may be affected if you edit any info before a payment is scheduled.

You must be the Financial Admin of your payout account to modify or add new users. To update or add someone as an admin:

  1. Visit the Facebook Developers site.
  2. Click your profile photo in the top right corner and select Company Settings.
  3. Click Admins.
  4. Enter the name of the new admin and then click Save Changes.

Facebook отправляет платежи только в долларах США. Если вашему банку требуется корреспондентский счет для получения платежей в долларах США, укажите следующие данные:

  • название банка-корреспондента;
  • страну банка-корреспондента;
  • код SWIFT банка-корреспондента.

Статус выплаты

Facebook issues payments twice a month:

  1. A payment for activity between the 1st through 15th of the month.
  2. A payment for activity between the 16th and the end of the month.
  3. A payment for Google Play from two months ago.

Facebook will issue payments approximately 21 days after each bi-monthly period. Visit the Facebook Developer Payments Terms for more information.

Google Play payments will be made approximately 45 days after each monthly period.

To check the status of your payment:

  1. Visit the Facebook Developers Site.
  2. Click the Audience Network tab.
  3. Click the Payout tab.
  4. Select Payment Reports to view your app's payments status.

If the status shows "Rejected/Pending Payment", please confirm that your Payout Account Detail Information is accurate. Additionally, you can also contact us by clicking on the "Need Help?" button within the Audience Network Dashboard for further information.

В счете на оплату отображается ваш доход за месяц. Наш финансовый отдел формирует такие счета перед платежом. Номер счета на оплату — это внутренний номер в нашей системе учета.

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

You can view your daily reports and payout reports to calculate your current balance by using our payments API. You can download daily reports for the previous 45 days. For details, see Payments Reports.

Каждый раз, когда вы совершаете продажу на платформе Facebook, полученные деньги зачисляются на ваш баланс разработчика (за вычетом комиссии за услуги Facebook). Комиссия за услуги Facebook составляет 30 % от каждой транзакции, совершенной через Платежи Facebook. Кроме того, удерживаются все применимые налоги на продажу или НДС. Дополнительные сведения см. в наших условиях оплаты.

Деньги будут переведены на ваш счет, когда у вас накопится не менее 100 долларов выручки. Если сумма платежей за весь платежный период составляет менее 100 долларов, этот платеж будет перенесен на следующий цикл выплат. Так будет происходить, пока баланс вашего счета не достигнет 100 долларов.

Чтобы задать вопрос по своим последним выплатам, воспользуйтесь формой поддержки Монетизация: поддержка платежей на Facebook и выберите категорию Игра/приложение (разработчик) > Выплаты > У меня вопрос о недавней выплате.

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

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

Конфиденциальность и безопасность

To verify you're the Financial Admin of your payout account, please visit the Facebook Developers site.

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

Хотя наша политика использования данных разрешает разглашать вашу контактную информацию или другую информацию из профиля, мы не разглашаем банковскую информацию или данные PayPal — кроме случаев, когда это необходимо для совершения платежей или по закону.

Facebook может сохранить вашу информацию, чтобы вам не приходилось вводить ее повторно. Кроме того, если вы попросите Facebook изменить платежную информацию, мы можем сохранить свидетельства об этом (например, банковскую информацию).

Если у вас возникнут проблемы или вопросы по платежам, обратитесь к нам за помощью.


Получение помощи с платежами

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

  1. Убедитесь, что у вас накопилось не менее 100 долларов выручки.
  2. Обратитесь в свой банк и убедитесь в том, что платеж не был отклонен и что на ваш банковский счет можно принимать платежи в долларах США.
  3. Проверьте актуальность информации счета для выплат.

Если у вас есть вопросы по поводу вашего счета для выплат или проблемы с ним, свяжитесь с нами.

Подробную информацию об обновлении информации в своем аккаунте см. здесь. Каждый раз после обновления финансовой информации аккаунт на 10 дней переводится в состояние ожидания. Платежи обрабатываются только по прошествии этого периода. Период ожидания может быть сокращен, если вы подтвердите владение аккаунтом PayPal или банковским счетом. Для подтверждения владения счетом отправьте нам выписку по нему или справку из банка на фирменном бланке. Для подтверждения владения аккаунтом PayPal можно отправить снимок экрана.

Если вы — администратор аккаунта, информация о связанном с вашим аккаунтом финансовом администраторе доступна на панели Business Manager. Если вы хотите, чтобы вас добавили в качестве финансового администратора аккаунта, обратитесь к администратору своей организации. Когда вы добавите друг друга в друзья на Facebook, администратор сможет добавить вас напрямую через сайт Facebook Developers.

В форме поддержки "Монетизация: поддержка платежей" выберите Игра/приложение (разработчик) > Обновить записи аккаунта > Изменить организацию, связанную с моим приложением или Страницей Facebook.

В форме поддержки Монетизация: поддержка платежей на Facebook выберите Игра/приложение (разработчик) > Обновить записи аккаунта > Изменить организацию, связанную с моим приложением или Страницей Facebook.

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

Система уведомлений не предусмотрена, но мы включаем информацию о возврате средств в извещение о переводе, которое отправляем каждый месяц.

Возмещения выплачиваются ежемесячно, однако срок задержки выплаты составляет 60 дней, то есть выплаты за январь будут получены в марте.

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

Публикация игр

Общая информация

Чтобы предоставить доступ к игре только в выбранных вами странах, сделайте следующее:

  1. На панели приложения откройте Настройки > Дополнительно.
  2. Включите функцию Ограничение по стране.
  3. Выберите страны в списке Допустимые страны.
  4. Нажмите Сохранить изменения.

В Руководстве по проверке Apple App Store указано, что при отправке Моментальной игры на проверку необходимо указать ID команды разработчиков Apple. Без этого ID ваша игра будет недоступна на платформе iOS. Если вы используете недействительный ID команды разработчиков Apple (например, с истекшим сроком действия), ваша игра может быть удалена.

Чтобы найти этот ID, войдите в свой аккаунт разработчика Apple.

Разработчики могут отправлять и запускать игры только один раз в неделю. Чтобы отправить и опубликовать две игры, потребуется две недели. Facebook может проверять и публиковать только по одной игре в неделю. Игры публикуются после проверки и утверждения. Это ограничение призвано помочь разработчикам, поскольку оно способствует успешному запуску игры.

Подробнее о том, как проводится проверка, см. в разделе Отправка на проверку статьи Контрольный список для проверки перед запуском.


Процедура проверки

Отправить игру на проверку можно на вкладке Проверка панели разработчика.

Игру необходимо отправить на проверку для использования следующих функций:

  1. Моментальные игры.
  2. Покупки в приложении.
  3. Pages_messaging (для ботов).

Для использования следующей возможности потребуется Monetization Manager:

  1. монетизация рекламы в Audience Network.

Перед подачей на проверку покупок приложение должно быть одобрено для Audience Network.

Узнайте больше об отправке приложения на проверку.

Как правило, приложения рассматриваются меньше недели.

Цель проверок — обеспечить качество всех новых приложений на платформе Моментальных игр и их соответствие стандартам.

В частности, мы контролируем игры на соответствие политике платформы и требованиям к функциональности.

Прежде чем подавать свою игру на проверку, ознакомьтесь с нашими требованиями к выпуску.

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

При тестировании интеграции вашего приложения с Facebook наши сотрудники будут использовать ваши инструкции.

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

Процесс проверки — это лучший способ взаимодействия с проверяющим; при этом вы должны обновлять свои заметки в соответствии с полученным отзывом.

ID приложения Facebook, созданный для Моментальной игры, нельзя использовать на другой платформе. Подробнее об этом см. в нашей документации.

Игровые приложения, подаваемые на проверку, должны быть связаны с компанией (подтвержденной или неподтвержденной).

Если приложение запускается в масштабах страны или по всему миру, связанная компания должна быть подтверждена. Без этого мы не сможем добавить приложение в наши сервисы поиска и распространения (список игр и другие). После проверки игра по-прежнему будет работать в стандартном режиме.

Чтобы пройти проверку компании, нужно создать аккаунт Business Manager. Подробнее о проверке компании см. здесь.

Узнать статус проверки компании можно в соответствующем разделе на вкладке "Проверка приложения" панели приложений. Здесь же можно найти контракты и инструкции. В процессе проверки вы будете получать уведомления о необходимых действиях.

Если у вас уже есть аккаунт Business Manager, рекомендуем подключить приложение к нему.

Если у вашей компании несколько аккаунтов Business Manager, выберите наиболее подходящий из них и свяжите с ним свое приложение. Если у вашей компании настроена кредитная линия в Business Manager, рекомендуем подключить приложение к аккаунту с кредитной линией.