Ответы на вопросы о разработке и монетизации моментальных игр, а также об управлении ими.
Войдите на сайт Facebook.com и нажмите закладку Игры слева или откройте страницу https://www.facebook.com/games/instantgames.
Убедитесь, что ваше приложение относится к категории Игры. Для приложений из других категорий Моментальные игры в списке не отображаются.
Ознакомьтесь со списком совместимых движков.
Мы не накладываем строгих ограничений на размер игры, но рекомендуем сделать так, чтобы ее первоначальное скачивание занимало не более 5 секунд. Вы можете размещать пакеты объемом до 200 МБ, однако начальная загрузка должна включать только самые необходимые файлы. Дополнительные сведения см. в разделе Рекомендации.
Существует несколько способов хранения информации.
Сторонний бэкенд, с которым ваша игра обменивается информацией при помощи XMLHttpRequest
, fetch
, WebSocket
или EventSource
. Этот подход обеспечивает максимальную гибкость, но влечет за собой расходы на хостинг, соразмерные с аудиторией вашей игры.
Наши решения на базе SDK, которые изначально поддерживают многие серверные функции. Для хранения информации об игроке используйте наши методы player.getDataASync
и player.setDataAsync
. Информацию о таблицах лидеров см. в руководстве по API Leaderboard.
Сторонние сервисы (например, PlayFab), которые предоставляют кроссплатформенные услуги бэкенда с поддержкой LiveOps, организации состязаний и сбора статистики. Узнайте, какие ещё инструменты можно использовать.
Минимальные требования к системе для запуска Моментальных игр — ОС iOS 8 или Android 5.0.
Дополнительную информацию см. в нашем руководстве по облегченным играм.
О проблемах можно сообщить непосредственно на странице Howler.js Github. Чтобы разработчики могли быстрее помочь вам, укажите "[IG]" в заголовке вопроса.
Обращайтесь к параметрам window.innerWidth
и window.innerHeight
после разрешения FBInstant.startGameAsync()
.
Вы можете использовать (и редактировать) треки из Коллекции звуков Facebook в своих играх. Материалы из Коллекции звуков можно использовать только на платформе Facebook, так что все версии вашей игры с такими материалами можно распространять только на нашей платформе.
Метод FBInstant.context.shareAsync()
содержит параметр intent
, который принимает такие значения, как 'INVITE'
, 'SHARE'
и т. д. В версии 4.0 этот параметр не служит никакой конкретной цели. Он был добавлен "на перспективу": в дальнейшем он будет сообщать о тех или иных пользовательских изменениях.
В SDK нет метода, который позволил бы получить информацию о противнике, когда вы впервые бросаете вызов другому игроку в переписке. Мы рекомендуем использовать общее обозначение, (например, "соперник"), пока игрок не ответит на приглашение. После этого вы сможете подставить его фото и имя, используя объект FBinstant.player
.
Чаще всего это происходит из-за его некорректной настройки. Изучите полное руководство по настройке игровых ботов здесь.
В панели разработчика проверьте следующее:
messages
и messaging_game_plays
.Сообщения об ошибках в ответе на запросы 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:
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)},
To update your payment information:
We can issue payouts to your bank or PayPal account (does not apply to Audience Netowrk users).
Вам понадобятся:
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.
Администраторы счета для выплат могут редактировать информацию о компании и финансовую информацию, чего не могут делать администраторы приложений и Страниц. Последние имеют доступ только к функциям на уровне приложения и Страницы.
С ними можно ознакомиться на этой странице.
Информацию о начислении и выплате налогов можно найти в разделе 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:
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:
Facebook отправляет платежи только в долларах США. Если вашему банку требуется корреспондентский счет для получения платежей в долларах США, укажите следующие данные:
Facebook issues payments twice a month:
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:
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 числа, проверьте следующее, прежде чем обращаться в службу поддержки.
Если у вас есть вопросы по поводу вашего счета для выплат или проблемы с ним, свяжитесь с нами.
Подробную информацию об обновлении информации в своем аккаунте см. здесь. Каждый раз после обновления финансовой информации аккаунт на 10 дней переводится в состояние ожидания. Платежи обрабатываются только по прошествии этого периода. Период ожидания может быть сокращен, если вы подтвердите владение аккаунтом PayPal или банковским счетом. Для подтверждения владения счетом отправьте нам выписку по нему или справку из банка на фирменном бланке. Для подтверждения владения аккаунтом PayPal можно отправить снимок экрана.
Если вы — администратор аккаунта, информация о связанном с вашим аккаунтом финансовом администраторе доступна на панели Business Manager. Если вы хотите, чтобы вас добавили в качестве финансового администратора аккаунта, обратитесь к администратору своей организации. Когда вы добавите друг друга в друзья на Facebook, администратор сможет добавить вас напрямую через сайт Facebook Developers.
В форме поддержки "Монетизация: поддержка платежей" выберите Игра/приложение (разработчик) > Обновить записи аккаунта > Изменить организацию, связанную с моим приложением или Страницей Facebook.
В форме поддержки Монетизация: поддержка платежей на Facebook выберите Игра/приложение (разработчик) > Обновить записи аккаунта > Изменить организацию, связанную с моим приложением или Страницей Facebook.
Если ваше приложение использует функции оплаты и подписки Facebook, подробную информацию о возвратах платежей вы можете найти в отчетах о платежах Facebook. Полное руководство можно найти на странице, посвященной отчетам о платежах.
Система уведомлений не предусмотрена, но мы включаем информацию о возврате средств в извещение о переводе, которое отправляем каждый месяц.
Возмещения выплачиваются ежемесячно, однако срок задержки выплаты составляет 60 дней, то есть выплаты за январь будут получены в марте.
Это можно сделать в настройках в разделе Платежи. Дополнительную информацию игроки могут получить в разделе справки, посвященном Платежам Facebook.
Чтобы предоставить доступ к игре только в выбранных вами странах, сделайте следующее:
В Руководстве по проверке Apple App Store указано, что при отправке Моментальной игры на проверку необходимо указать ID команды разработчиков Apple. Без этого ID ваша игра будет недоступна на платформе iOS. Если вы используете недействительный ID команды разработчиков Apple (например, с истекшим сроком действия), ваша игра может быть удалена.
Чтобы найти этот ID, войдите в свой аккаунт разработчика Apple.
Разработчики могут отправлять и запускать игры только один раз в неделю. Чтобы отправить и опубликовать две игры, потребуется две недели. Facebook может проверять и публиковать только по одной игре в неделю. Игры публикуются после проверки и утверждения. Это ограничение призвано помочь разработчикам, поскольку оно способствует успешному запуску игры.
Подробнее о том, как проводится проверка, см. в разделе Отправка на проверку статьи Контрольный список для проверки перед запуском.
Отправить игру на проверку можно на вкладке Проверка панели разработчика.
Игру необходимо отправить на проверку для использования следующих функций:
Для использования следующей возможности потребуется Monetization Manager:
Перед подачей на проверку покупок приложение должно быть одобрено для Audience Network.
Узнайте больше об отправке приложения на проверку.
Как правило, приложения рассматриваются меньше недели.
Цель проверок — обеспечить качество всех новых приложений на платформе Моментальных игр и их соответствие стандартам.
В частности, мы контролируем игры на соответствие политике платформы и требованиям к функциональности.
Прежде чем подавать свою игру на проверку, ознакомьтесь с нашими требованиями к выпуску.
Если в связи с вашей текущей заявкой нам потребуется дополнительная информация, у вас будет 30 дней с момента получения запроса на то, чтобы предоставить ее и отправить приложение на проверку повторно. В течение этого периода от команды проверки приложений могут поступить дополнительные запросы. При повторной отправке 30-дневный период, предоставляемый для доработки, не продлевается.
При тестировании интеграции вашего приложения с Facebook наши сотрудники будут использовать ваши инструкции.
Если вы считаете, что ваше приложение отвергнуто несправедливо, обновите инструкции по проверке, включив в них больше информации, и заново отправьте заявку на проверку.
Процесс проверки — это лучший способ взаимодействия с проверяющим; при этом вы должны обновлять свои заметки в соответствии с полученным отзывом.
ID приложения Facebook, созданный для Моментальной игры, нельзя использовать на другой платформе. Подробнее об этом см. в нашей документации.
Игровые приложения, подаваемые на проверку, должны быть связаны с компанией (подтвержденной или неподтвержденной).
Если приложение запускается в масштабах страны или по всему миру, связанная компания должна быть подтверждена. Без этого мы не сможем добавить приложение в наши сервисы поиска и распространения (список игр и другие). После проверки игра по-прежнему будет работать в стандартном режиме.
Чтобы пройти проверку компании, нужно создать аккаунт Business Manager. Подробнее о проверке компании см. здесь.
Узнать статус проверки компании можно в соответствующем разделе на вкладке "Проверка приложения" панели приложений. Здесь же можно найти контракты и инструкции. В процессе проверки вы будете получать уведомления о необходимых действиях.
Если у вас уже есть аккаунт Business Manager, рекомендуем подключить приложение к нему.
Если у вашей компании несколько аккаунтов Business Manager, выберите наиболее подходящий из них и свяжите с ним свое приложение. Если у вашей компании настроена кредитная линия в Business Manager, рекомендуем подключить приложение к аккаунту с кредитной линией.