小游戏常见问题

开发、管理以及利用小游戏变现的相关问题解答。

一般信息

登录 Facebook.com,点击左侧的游戏 书签,或访问 https://www.facebook.com/games/instantgames。

开发游戏

请确定您的应用类别为游戏。如果应用不是设为这一类别,则不会显示小游戏产品。

我们对游戏大小未作硬性限制,但建议初始下载时间不要超过 5 秒。您可以托管最大 200 MB 的游戏捆绑包,但在初始加载时,仅需下载必要的文件。如需更多详情,请参阅我们的最佳实践部分

在决定信息的存储位置时,您有以下几个选项:

  1. 使用第三方后端,您的游戏可以通过 XMLHttpRequestfetchWebSocketEventSource 与该第三方后端进行通讯。这意味着您可以获得更多灵活性,但也会产生与游戏受众成正比的托管费用。

  2. 使用我们基于 SDK 的解决方案,让服务器端功能即时可用。如需存储玩家的特定信息,请使用 player.getDataASyncplayer.setDataAsync 方法。对于排行榜,请参阅我们的排行榜 API 导览

  3. PlayFab 等第三方服务可以提供完全跨平台的后端即服务平台,此类平台专为支持 LiveOps、配对和分析功能而打造。浏览更多工具。

玩小游戏的最低系统要求是 iOS 8 或 Android 5.0。

如需了解更多信息,请参阅我们的轻量级游戏导览

您可以直接在 Howler.js Github 页面上报告问题。请在问题标题中注明“[IG]”,以便得到开发者的优先处理。

您应该在 FBInstant.startGameAsync() 解析完成后再调用 window.innerWidthwindow.innerHeight

您可以在游戏中使用(并编辑) Facebook 音频收藏夹中的音乐。音频收藏夹中的内容只能在 Facebook 开放平台使用,因此包含音频收藏夹内容的任何版本的游戏都只能在我们的平台上分发。

为游戏添加功能

我们的 FBInstant.context.shareAsync() 方法包含 intent 参数,用于接受 'INVITE''SHARE' 等值。从版本 4.0 开始,此参数不再用于某种特定用途。添加该参数是为了让我们的 SDK 不过时,并用于日后提供面向用户的更改。

首次在游戏中向另一玩家发起挑战时,没有 SDK 方法可用于检索被挑战玩家的信息。建议您使用“opponent”等占位符姓名,直到第二个玩家回应邀请。等到另一玩家接受游戏邀请后,您可以使用 FBinstant.player 填充他们的头像和姓名。

游戏智能助手

智能助手未收到 Webhook 最常见的原因是应用内配置错误。请访问我们的智能助手设置页面,获取有关游戏智能助手设置的完整指南。

检查您的开发者面板,以确认:

  1. 您已经在小游戏版块内配置应用主页
  2. 您已经在 Messenger 版块中订阅 messagesmessaging_game_plays 事件
  3. 您已在 Messenger 版块的已订阅的主页面板中配置应用主页
  4. 您的页面类别为应用主页,并且其名称中包含游戏名称。

如果在发出图谱 API 调用后收到错误响应,则表示发生了下列情况之一:

-您尝试发送的消息超出了以下限制:10 天内最多只可向每位用户发送 5 条消息

-您发送消息的对象删除或屏蔽了您的智能助手,或将智能助手设置为免打扰模式

-您的应用处于开发模式,而您尝试向应用管理员或开发者以外的用户发送消息

如需更多信息,请参阅发送 API 参考文档

数据管理

Facebook 应用设置支持用户请求您的应用删除从 Facebook 获得的用户数据。

如要响应用户请求,您需要通过我们提供的技术手段来确认您收到删除用户数据的请求,并提供链接和确认编号。此链接和确认编号必须授权用户访问有关其请求状态的说明,相关内容应简单易懂,且包括任何拒绝删除数据的合法理由(根据司法管辖区和我们对所陈述原因相关政策的具体解读,对“合法”的界定会有所不同)。

如要解析和响应请求,您需要执行“数据删除请求”回调。您的回调必须使用安全的 HTTPS 协议,且必须列于您应用的应用面板小游戏 > 详情页面的数据删除请求网址字段

疑难解答

如果您依照我们的快速入门测试、发布、分享导览操作,就一定非常熟悉嵌入式播放器的概念。嵌入式播放器连接小游戏 SDK 的所有有效功能,可方便您在电脑中测试通过本地 HTTP 服务运行的小游戏。

有时,尝试这种方式时,您的游戏可能无法顺利加载。有时,浏览器的开发者面板中不会显示任何消息,有时则会显示如下消息:Failed to execute 'postMessage' on 'DOMWindow'。这些字段源于同一类型的错误,导致此类错误最常见的原因是,您的本地服务器因证书问题而拒绝提供素材。

如果是这种情况,请找到本地服务器的根目录(通常是 https://localhost:8000https://127.0.0.1:8000),并按照浏览器的说明接受证书,或为此网站添加安全例外。完成此操作后,返回嵌入式播放器网址,一切即应该恢复正常运行。

如果您尝试通过曾经失败的 AdInstance 加载广告,便会出现此错误。如果 AdInstance 的 loadAsync 方法已经遭拒过一次,请不要尝试重复使用这个方法。建议通过调用 getInterstitialAsyncgetRewardedVideoAsync 来请求新的 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 信息(PayPal 邮箱、国家/地区、商家编号)

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 只会以美元 (USD) 付款。如果您的银行需要一个中间或代理帐户才能接收美元汇款,请提供下列信息:

  • 中间银行的名称
  • 中间银行所在的国家/地区
  • 中间银行的 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 为支付您一个月的收入而向您的帐户支付的金额。当我们的银行向您的银行帐户发起付款时,您将在该月第 3 周前后收到一张汇款单。

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% 的服务费,外加任何适用的销售税或增值税。详情请参阅我们的支付条款

当您的收入累计达到最低 $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 的截图。

如果您是帐户管理员,则可在商务管理平台面板中查看与您的帐户关联的财务实体。如果希望组织将您添加为财务帐户管理员,请向您所在组织的当前管理员提出请求。在你们成为 Facebook 好友后,他们便可直接在 Facebook 开发者网站上添加您。

请使用我们的创收者支付支持表单,然后选择游戏/应用(开发者) > 更新帐户记录 > 更改与我的应用或 Facebook 主页关联的组织。

请访问 Facebook 创收者支付支持表单,然后选择游戏/应用(开发者) > 更新帐户记录 > 更改与我的应用或 Facebook 主页关联的组织。

如果您开发的应用使用 Facebook 的支付和订阅功能,则您可以使用 Facebook 支付的报告功能获取退款和拒付活动的完整细分数据。您可以在我们的支付报告页面找到完整指南。

我们没有通知系统,但是我们每个月会发送 pdf 格式的汇款单,其中包含退款信息。

补偿款按月支付,但其放款期为 60 天,即一月份的收款活动会在三月份结清。

每位玩家都可以在“设置”中查看支付状态,具体而言,是在支付版块中。建议玩家在 Facebook 支付中了解详情。

发布游戏

一般信息

如要将游戏访问权限限于一个自定义的国家/地区列表:

  1. 在应用程序的面板中,前往设置/高级
  2. 启用受限国家/地区
  3. 允许使用的国家/地区选择器中选择国家/地区
  4. 点击保存更改

提交小游戏应用供审核时,您必须按照 Apple App Store 审核指南提供 Apple 开发团队编号。这有助于您在 iOS 平台上传播游戏。使用无效或过期的开发团队编号可能会导致您的游戏被移除。

您可以登录 Apple 开发者帐户查看团队编号。

我们每周只允许开发者提交和发布一款游戏。您可以在两周内提交并发布两款游戏。Facebook 每周审核一款游戏,您可以每周发布一款通过审批的游戏。设立该限制的目的在于,帮助您在发布游戏时一举成功。

如需详细了解审核流程,请查看发布检查表中的提交供审核部分。


审核流程

您可以通过开发者面板的审核功能选项向我们的审核团队提交游戏。

您必须提交游戏以进行以下审核:

  1. 小游戏
  2. 应用内购买
  3. Pages_messaging(针对智能助手)

您需要使用创收管理工具提交游戏,以实现:

  1. Audience Network 广告创收

在提交游戏进行 IAP 审核之前,该应用须先通过 Audience Network 批准。

详细了解有关发送应用供审核的更多信息。

我们的开发者运营团队通常会在一周内处理好您提交的应用。

每次审核都是为了确保游戏发布到小游戏平台时符合质量和完整性标准。

具体而言,我们会筛选出符合功能及平台政策指导原则的游戏。

提交审核前,请务必查看发布指导原则

如果您当前提交的内容需要补充信息,您可以在收到请求后的 30 天内解决并重新提交审核。在这 30 天内,应用审核团队可能会要求您提供更多信息。请注意,在此期间,这个 30 天的期限不会随着每次重新提交而重置。

我们的审核团队会使用您提供的说明测试应用的 Facebook 集成。

如果您认为我们的审核员错误地拒绝了您的应用,您应当更新审核说明,为审核员提供更多信息,然后重新提交应用供他们审核。

审核流程是与审核员沟通联系的最佳方式。请更新说明,解决所收到的反馈。

您为小游戏创建的 Facebook 应用编号不能用于任何其他平台。详情请参阅我们的文档

在应用审核方面,所提交的游戏必须关联至公司(无论是否经过验证)。

在全球与国家/地区发布方面,应用所关联的公司必须经过验证,才能将游戏发布至我们的发现渠道(游戏列表等)。在审核通过后,游戏仍然可玩。

如要进行公司验证,您需要创建商务管理平台。请在此处了解有关公司验证的更多信息。

在应用面板的应用审核选项卡中找到公司验证面板,在公司验证面板中可以随时查看公司验证状态、合同以及要采取的步骤。我们将在整个过程中向您发送通知,以便您了解需要采取的操作。

如果您已有商务管理平台帐户,建议您将应用关联至已有的商务管理平台。

如果您的多个商务管理平台帐户隶属于同一公司,建议您确定拥有多个商务管理平台帐户的原因,并将应用关联至最适当的商务管理平台。如果公司通过商务管理平台设置了信用额度,建议您将应用关联至有信用额度的商务管理平台帐户。