Perguntas frequentes sobre Jogos Instantâneos

Veja respostas para perguntas sobre como desenvolver, gerenciar e monetizar Jogos Instantâneos.

Informações gerais

Entre no Facebook.com e clique no favorito Jogos à esquerda ou acesse https://www.facebook.com/games/instantgames.

Como desenvolver um jogo

Verifique se o seu aplicativo está na categoria Jogos. O produto dos Jogos Instantâneos não aparecerá para aplicativos que não pertençam a essa categoria.

Não impomos limites rígidos para o tamanho dos jogos, mas recomendamos que o tamanho do download inicial não exceda 5 segundos. É possível hospedar pacotes de jogos de até 200 MB, mas exija somente os arquivos necessários na carga inicial. Para obter mais detalhes, consulte a seção Melhores práticas.

Quando se trata de decidir onde armazenar suas informações, há várias opções:

  1. Ter um backend de terceiros com o qual seu jogo se comunica via XMLHttpRequest, fetch, WebSocket ou EventSource. Isso significará mais flexibilidade, mas também incorrerá em custos de hospedagem proporcionais ao público do jogo.

  2. Use nossas soluções baseadas em SDK que ativam a funcionalidade no servidor pronta para usar. Para armazenar informações específicas do jogador, use nossos métodos player.getDataASync e player.setDataAsync. Para quadros de líderes, veja nosso Guia da API do Quadro de líderes.

  3. Serviços de terceiros como o PlayFab fornecem plataformas de backend como serviço totalmente multiplataforma, desenvolvidas para oferecer suporte ao LiveOps, a pareamento e análises. Procure mais ferramentas.

Para usar os jogos instantâneos, é necessário ter no mínimo o iOS 8 ou Android 5.0.

Leia nosso guia reduzido de jogos para obter mais informações.

É possível relatar problemas diretamente na página Github sobre Howler.js. Coloque "[IG]" no título do problema para ajudar os desenvolvedores a priorizá-lo.

Você deve chamar window.innerWidth e window.innerHeight depois que FBInstant.startGameAsync() for resolvido.

Você pode usar (e editar) faixas da coleção de sons do Facebook em seus jogos. O conteúdo da coleção de sons pode ser usado apenas na plataforma do Facebook; por isso, qualquer versão de seu jogo que incorpore o conteúdo da coleção de sons pode ser distribuída somente em nossa plataforma.

Como adicionar recursos a um jogo

Nosso método FBInstant.context.shareAsync() contém um parâmetro intent que aceita valores como 'INVITE', 'SHARE', etc. Desde a versão 4.0, esse parâmetro não desempenha uma finalidade específica. Ele foi adicionado para proteger o SDK e oferecerá alterações voltadas para o usuário no futuro.

Quando você está desafiando outro jogador no tópico pela primeira vez, não há método SDK para recuperar informações sobre a pessoa que está sendo desafiada. Recomendamos usar um nome de espaço reservado, como "oponente", até o segundo jogador aceitar o convite. Depois que o outro jogador aceitar o convite para jogar, você poderá usar FBinstant.player para incluir sua foto e seu nome.

Bots de jogos

A causa mais comum para um bot não receber webhooks é a configuração incorreta no aplicativo. Acesse nossa página Configuração do bot para obter um guia completo sobre como configurar o bot de seu jogo.

Verifique seu Painel de desenvolvedor para garantir que:

  1. Você tenha uma página de aplicativo configurada na seção dos jogos instantâneos
  2. Você tenha uma inscrição nos eventos messages e messaging_game_plays na seção Messenger
  3. A página do aplicativo é configurada no painel Páginas inscritas na seção Messenger
  4. Sua página é categorizada como uma Página de aplicativo e tem um nome que contenha o nome de seu jogo.

Se você estiver recebendo erros como resposta às chamadas de envio da Graph API, isso significa que está ocorrendo uma das situações abaixo:

-Você está tentando enviar mensagens fora do limite de 5 mensagens durante 10 dias por usuário

-Você está tentando enviar mensagens para um usuário que excluiu, bloqueou ou silenciou seu bot

-Seu aplicativo está no modo de desenvolvimento, e você está tentando enviar mensagens para pessoas que não têm uma função de administrador ou de desenvolvedor no aplicativo

Para obter mais informações, consulte a documentação da API de Envio.

Gerenciamento de dados

As configurações de aplicativo do Facebook oferecem uma forma de as pessoas solicitarem que seu aplicativo exclua os dados que tem delas no Facebook.

Em resposta à solicitação do usuário, você deve confirmar o recebimento de uma solicitação de exclusão de dados do usuário com os meios técnicos que oferecemos, além de fornecer um link e um número de confirmação. O link e o número de confirmação devem dar ao usuário acesso a uma explicação legível por humanos do status da solicitação, incluindo uma justificativa legítima para a recusa da exclusão (a legitimidade variará com base na jurisdição e na nossa interpretação caso a caso da nossa política em relação aos motivos declarados).

Para analisar e responder à solicitação, você deve implementar um retorno de chamada "solicitação de exclusão de dados". O retorno de chamada deve usar o protocolo seguro de HTTPS e deve ser listado no campo URL de solicitação de exclusão de dados da página Jogos Instantâneos > Detalhes do aplicativo no Painel de Aplicativos.

Solução de problemas

Se você estiver seguindo nosso guia Início rápido ou Testar, publicar, compartilhar, deverá estar familiarizado com o conceito de jogador integrado. É uma forma de testar a execução de seu Jogo Instantâneo em um serviço HTTP local no computador, vinculado a todas as funções publicadas do SDK de Jogos Instantâneos.

Algumas vezes, quando você tentar essa abordagem, seu jogo poderá ficar travado no carregamento. Ocasionalmente, nenhuma mensagem será exibida no console do desenvolvedor do navegador ou uma mensagem será exibida indicando Failed to execute 'postMessage' on 'DOMWindow'. Isso tem origem do mesmo tipo de erro, geralmente causado porque seu servidor local está se recusando a fornecer ativos devido a um problema de certificado.

Se esse for o caso, navegue para a raiz de seu servidor local (geralmente https://localhost:8000 ou https://127.0.0.1:8000) e siga as instruções do navegador para aceitar certificados ou incluir uma exceção de segurança para o site. Depois de fazer isso, volte para a URL do jogador integrado e tudo deverá estar funcionando.

Esse erro acontece quando você tenta carregar um anúncio de um AdInstance que falhou anteriormente. Se o método loadAsync de seu AdInstance já foi rejeitado uma vez, não tente reutilizá-lo. Em vez disso, solicite um novo AdInstance chamando getInterstitialAsync ou getRewardedVideoAsync

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

Como monetizar um jogo

Publicidade

Pagamentos

Integração com o 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).

Você precisará do seguinte:

  • Informações da conta de pagamento (endereço, tipo de tributo, identificação fiscal)
  • Informações do proprietário (nome, endereço, data de nascimento)
  • Informações bancárias (nome do banco, número da conta ou IBAN, país, código SWIFT ou número de roteamento)
  • Informações do PayPal (email do PayPal, país, identificação do comerciante)

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.

Os administradores de contas de pagamentos podem editar informações financeiras e da empresa, enquanto os administradores de aplicativos e de Páginas têm acesso aos recursos do aplicativo e da página, mas não podem editar informações financeiras.

Detalhes sobre impostos podem ser encontrados na seção 3.9 de nossa página Termos de pagamento.

Como usar as informações da conta para recebimento

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.

O Facebook envia pagamentos somente em dólares dos Estados Unidos (USD). Se o banco exigir uma conta intermediária ou correspondente para receber pagamentos em dólares americanos, inclua o seguinte:

  • Nome do banco intermediário
  • País do banco intermediário
  • Código SWIFT do intermediário

Status do recebimento

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.

Uma fatura apresenta seus ganhos durante o período de um mês. A fatura de sua conta é gerada por nossa equipe financeira antes do pagamento. O número da conta nessa fatura é um número interno para nosso controle de registros.

Uma declaração de pagamento mostra o valor depositado pelo Facebook em sua conta como pagamento dos ganhos ao longo de um mês. Quando nosso banco iniciar o envio do pagamento para sua conta bancária, você receberá uma declaração de pagamento por volta da terceira semana do mês.

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.

Quando você concluir uma venda em nossa plataforma, o Facebook creditará os recursos dessa venda, menos a taxa de serviço, em seu saldo do desenvolvedor. O Facebook ganhará uma taxa de serviço de 30%, mais qualquer imposto sobre vendas ou IVA aplicável, relacionado a cada transação de Pagamentos do Facebook em nossa plataforma. Leia nossos Termos de Pagamento para obter mais detalhes.

Os pagamentos serão transferidos para sua conta vinculada quando você acumular um valor mínimo de receita de US$ 100,00. Caso seu saldo de pagamento seja menor do que US$ 100,00 para qualquer período, o pagamento será transferido para o próximo ciclo de pagamento. As transferências continuarão até que o saldo de pagamento alcançar US$ 100,00.

Para quaisquer problemas relacionados a seus pagamentos recentes, envie uma consulta por meio do Formulário de suporte de pagamento do Facebook para monetizadores e selecione Jogo/aplicativo (desenvolvedor) > Pagamentos > Eu tenho uma pergunta sobre meu pagamento recente.

Para perguntas sobre pagamento e relatórios, entre em contato com o Suporte a pagamentos do Facebook.

Encaminhar o problema para outro local ou reabrir outro ticket complicarão sua consulta atual com nossa equipe de Operações de pagamentos. Aconselhamos todos os parceiros a enviar todos os acompanhamentos pelo canal de comunicação existente que você tem com a equipe de operações de pagamentos.

Privacidade e segurança

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

O Facebook valoriza a confiança em nós depositada e toma as medidas necessárias para evitar acesso não autorizado a suas informações. Armazenamos suas informações financeiras em servidores seguros e tomamos precauções adicionais para protegê-las contra invasores.

Embora possamos compartilhar seu contato ou outras informações do perfil de acordo com nossa política de dados, nenhuma informação financeira é compartilhada, exceto conforme necessário para realizar pagamentos ou cumprir requisitos legais.

O Facebook pode armazenar suas informações para evitar que você precise reinseri-las em pagamentos futuros. Além disso, caso você solicite que o Facebook altere os dados de pagamento, podemos preservar evidências que comprovem essas alterações (por exemplo, informações bancárias).

Se você estiver enfrentando problemas ou tiver dúvidas sobre pagamentos, entre em contato conosco. Trabalharemos para garantir que o problema seja resolvido.


Como receber ajuda com pagamentos

Se você não receber o pagamento até o dia 21 do mês, faça o seguinte antes de entrar em contato com o suporte:

  1. Verifique se você acumulou uma receita de pelo menos US$ 100,00.
  2. Entre em contato com seu banco para verificar se o pagamento foi rejeitado e se sua conta bancária pode receber pagamentos em dólares americanos.
  3. Analise as informações de sua conta de pagamento para confirmar se estão corretas.

Se você tiver outras dúvidas ou problemas com sua conta de pagamentos, fale conosco.

Se você precisar de ajuda para atualizar as informações em sua conta, visite nossa página de ajuda de pagamentos. Quando as informações financeiras são atualizadas, colocamos uma retenção de 10 dias em sua conta antes de processar um pagamento. Talvez possamos remover essa retenção mais rapidamente se você nos enviar um comprovante de propriedade do banco ou da conta do PayPal. Como comprovante, você pode nos enviar um extrato bancário ou uma carta bancária no papel timbrado apropriado ou uma captura de tela do PayPal.

Se você for o administrador da conta, será possível ver a entidade financeira associada à sua conta no painel do Gerenciador de Negócios. Se você quiser ser incluído como administrador de conta financeira, peça a um administrador atual da sua organização. Depois que você ficarem amigos no Facebook, ele pode adicionar você diretamente ao Site do Facebook Developers.

Acesse nosso formulário Suporte de pagamento para monetizadores e selecione Jogo/Aplicativo (desenvolvedor) >Atualizar registros de conta > Alterar a organização associada ao meu aplicativo ou à Página do Facebook.

Acesse nosso formulário Suporte de pagamento do Facebook para monetizadores e selecione Jogo/Aplicativo (desenvolvedor) >Atualizar registros de conta > Alterar a organização associada ao meu aplicativo ou à Página do Facebook.

Se você desenvolveu aplicativos que usam pagamentos do Facebook e recursos de assinatura, você pode obter um detalhamento completo de suas atividades de reembolso e estornos usando o recurso Relatórios de pagamentos do Facebook. Um guia completo pode ser encontrado em nossa página Relatórios de pagamentos.

Não temos um sistema de notificação, mas incluímos informações de reembolso no pdf de pagamento que enviamos todos os meses.

Os reembolsos são pagos mensalmente, mas o período de lançamento do pagamento é 60 dias, ou seja, atividades de pagamento de janeiro serão pagas em março.

Os jogadores podem acessá-lo em Configurações e especificamente na seção Pagamento. Para saber mais, sugira que os jogadores acessem Pagamentos do Facebook.

Como publicar um jogo

Informações gerais

Para restringir o acesso ao jogo para uma lista personalizada de países:

  1. No painel do aplicativo, acesse Configurações/Avançado.
  2. Ative Restrição de país.
  3. Selecione os países no seletor Países permitidos.
  4. Clique em Salvar alterações.

Durante o envio para a análise do aplicativo do Jogo Instantâneo, você deve fornecer uma identificação da equipe de desenvolvedores da Apple de acordo com as Diretrizes de Análise da App Store da Apple. Isso permite a distribuição de seu jogo em iOS. Usar uma identificação da equipe de desenvolvedores inválida ou expirada poderá fazer com que seu jogo seja removido.

Para encontrar a identificação de sua equipe, entre em sua conta de desenvolvedor da Apple.

Os envios e lançamentos de jogos de desenvolvedores são limitados a um por semana. Você pode enviar e publicar dois jogos ao longo de duas semanas. O Facebook pode analisar um jogo por semana e publicar um jogo por semana após sua análise e aprovação. Estabelecemos esse limite para ajudar seu jogo a ter sucesso no lançamento.

Para saber mais sobre o processo de análise, consulte a seção Envio para análise na Lista de verificação de lançamento.


Processo de análise

A guia Análise do painel do desenvolvedor permite enviar seu jogo para a equipe de análise.

Você precisa enviar seu jogo para as seguintes análises:

  1. Jogos Instantâneos
  2. Compras no aplicativo
  3. Pages_messaging (para bots)

Você precisará de um Gerenciador de Monetização para enviar seu jogo para:

  1. Monetização de anúncios do Audience Network.

Antes de enviar seu jogo para análise de IAP, o aplicativo deve ser aprovado para o Audience Network.

Saiba mais sobre como enviar seu aplicativo para análise.

Normalmente, nossa equipe de Operações de desenvolvedor demora menos de uma semana para processar o envio.

O objetivo de cada análise é garantir que padrões de qualidade e integridade sejam atendidos para integração com a plataforma dos Jogos Instantâneos.

Especificamente, nós examinamos jogos para verificar a conformidade com a funcionalidade e as diretrizes da política da Plataforma.

Antes de enviar o jogo para análise, verifique as diretrizes de lançamento.

Caso seu envio atual exija mais informações, você terá 30 dias a partir do recebimento da solicitação para resolver e reenviá-la para análise. Durante esses 30 dias, a equipe de Análise do Aplicativo pode solicitar que você forneça mais informações. A janela de 30 dias não será redefinida com cada reenvio durante esse período.

Nossa equipe de análise usará as instruções fornecidas por você para testar as integrações de seu aplicativo ao Facebook.

Se você entender que o revisor rejeitou seu aplicativo indevidamente, envie novamente para análise com instruções atualizadas que contenham mais informações para o revisor.

O processo de análise é a melhor maneira de se comunicar com o revisor, com a atualização de suas notas para abordar os comentários recebidos.

O ID do aplicativo do Facebook criado para o seu Jogo Instantâneo não pode ser usado em outras plataformas. Para obter mais informações, consulte nossa documentação.

Para a Análise do Aplicativo, os envios de jogos precisam estar vinculados a uma empresa (verificada ou não).

Para lançamentos globais e no país, a empresa vinculada do aplicativo deve ser verificada para lançar o jogo nas superfícies de descoberta (lista de jogos etc.). Ainda será possível jogar após a aprovação da análise.

Para verificar sua empresa, você precisará criar um Gerenciador de Negócios. Saiba mais sobre a Verificação de empresas aqui.

Você pode encontrar o status da verificação da empresa e dos contratos, além de etapas para seguir no painel de verificação de empresas na guia de análise do aplicativo do Painel de Aplicativos. Enviaremos a você notificações durante o processo para avisá-lo qual ação é necessária.

Se você já tiver uma conta do Gerenciador de Negócios, recomendamos que você conecte o aplicativo ao Gerenciador de Negócios existente.

Se houver várias contas do Gerenciador de Negócios que pertençam à empresa, recomendamos determinar a lógica para várias contas do Gerenciador e alinhar o aplicativo ao Gerenciador mais apropriado. Se a empresa tiver uma linha de crédito configurada por meio do Gerenciador de Negócios, recomendamos que você conecte o aplicativo àquela que tiver a linha de crédito.