인스턴트 게임 FAQ

Facebook.com에 로그인하여 왼쪽의 게임 북마크를 클릭하거나 https://www.facebook.com/games/instantgames를 방문하세요.

앱이 게임 카테고리에 포함되어 있는지 확인하세요. 이 카테고리 외 앱의 경우 인스턴트 게임 제품이 표시되지 않습니다.

호환 엔진 리스트를 참조하세요.

게임 크기에 고정된 한도가 있는 것은 아니지만 최초 다운로드 시간이 5초를 넘지 않는 것이 좋습니다. 최대 200MB의 게임 번들을 호스팅할 수 있지만 초기 로드 시 꼭 필요한 파일만 요구해야 합니다. 자세한 내용은 모범 사례 섹션을 참조하세요.

정보를 저장할 위치를 결정하는 데는 여러 가지 옵션이 있습니다.

1. 게임이 XMLHttpRequest, fetch, WebSocket 또는 EventSource를 통해 통신하는 타사 백엔드를 유지합니다. 이 방법은 유연성이 개선되는 효과가 있지만 게임의 타겟에 비례하여 호스팅 비용이 발생합니다.

2. 서버 측 기능을 즉시 활성화하는 SDK 기반 솔루션을 사용합니다. 플레이어별 정보를 저장하려면 player.getDataASync와 player.setDataAsync 메서드를 사용하세요. 리더보드에 관한 정보는 Leaderboard API 가이드를 참조하세요.

3. PlayFab과 같은 타사 서비스는 LiveOps, 결혼 중매, 분석을 지원하기 위해 구축된 표면형 완전 교차 플랫폼 백엔드를 지원하는 플랫폼을 제공합니다. 더 많은 도구를 살펴보세요.

인스턴트 게임을 위해 필요한 최소 시스템 사양은 iOS 8 또는 Android 5.0입니다.

자세한 내용은 저사양 게임 가이드를 참조하세요.

Howler.js Github 페이지에서 직접 문제를 신고할 수 있습니다. 개발자가 우선순위를 지정하는 데 도움이 되도록 문제 신고의 제목에 "[IG]"를 넣으세요.

FBInstant.startGameAsync()가 실행된 후 window.innerWidth와 window.innerHeight를 호출해야 합니다.

게임에서 Facebook 사운드 컬렉션의 트랙을 사용(및 수정)할 수 있습니다. 사운드 컬렉션 콘텐츠는 Facebook 플랫폼에서만 사용할 수 있으므로 사운드 컬렉션이 통합된 게임 버전은 Facebook 플랫폼에만 배포할 수 있습니다.

Facebook의 FBInstant.context.shareAsync() 메서드에는 'INVITE', 'SHARE' 등의 값을 받는 intent 매개변수가 포함됩니다. 버전 4.0부터 이 매개변수는 특정한 목적으로 사용되지 않습니다. 이 매개변수는 SDK의 추후 기능을 위해 추가되었으며 향후에 사용자용 변경 사항을 제공할 예정입니다.

대화에서 다른 플레이어에게 처음으로 도전할 때 상대방에 대한 정보를 가져올 수 있는 SDK 메서드는 없습니다. 두 번째 플레이어가 초대에 응답할 때까지는 'opponent'와 같은 자리 표시자 이름을 사용하는 것이 좋습니다. 상대 플레이어가 게임 초대를 수락하면 FBinstant.player를 사용하여 사진과 이름을 채울 수 있습니다.

봇에서 webhooks를 수신하지 않는 가장 일반적인 원인은 앱의 webhooks 구성에 문제가 있기 때문입니다. 게임 봇 설정에 대한 자세한 가이드는 봇 설정 페이지를 참조하세요.

개발자 대시보드에서 다음 사항을 확인하세요.

1. 인스턴트 게임 섹션에 앱 페이지가 구성되어 있어야 합니다.
2. Messenger 섹션에서 messages 및 messaging_game_plays 이벤트를 받아봐야 합니다.
3. Messenger 섹션에 있는 받아보는 페이지 패널에 앱 페이지가 구성되어 있어야 합니다.
4. 페이지는 앱 페이지 카테고리로 설정되어 있고 페이지 이름에 게임 이름이 포함되어야 합니다.

그래프 API 보내기 호출에 대한 응답에서 오류가 발생하면 다음과 같은 상황 중 하나가 발생했다는 것을 의미합니다.

-10일간 메시지 5개의 사용자당 한도를 벗어나 메시지를 보내려고 시도했습니다.

-봇을 삭제하거나 차단하거나 알림을 해제한 사용자에게 메시지를 보내려고 시도했습니다.

-앱이 개발 모드에 있으며 앱의 관리자 또는 개발자 역할이 없는 사람에게 메시지를 보내려고 시도했습니다.

자세한 내용은 보내기 API 문서를 참조하세요.

Facebook 앱 설정은 앱이 Facebook으로부터 사용자에 대해 수집한 데이터를 삭제해달라고 사용자가 앱에 요청할 수단을 제공합니다.

사용자가 데이터 삭제를 요청할 경우 Facebook에서 제공하는 기술적 수단을 통해 사용자의 데이터 삭제 요청을 수신하였음을 확인하고 링크와 확인 번호를 제공해야 합니다. 사용자가 링크와 확인 번호를 통해 요청 상태에 대해 사람이 읽을 수 있는 설명을 확인할 수 있어야 합니다. 여기에는 삭제 거절에 대한 타당한 근거가 포함되어야 합니다(타당성은 제시된 이유와 관련이 있기 때문에 관할 지역 및 Facebook 정책에 대한 사례별 해석에 따라 달라집니다).

요청을 해석하고 여기에 응답하려면 "데이터 삭제 요청" 콜백을 구현해야 합니다. 콜백은 안전한 HTTPS 프로토콜을 사용해야 하고 앱의 앱 대시보드에 있는 인스턴트 게임 > 설정 페이지의 데이터 삭제 요청 URL 필드에 등록되어야 합니다.

빠른 시작 또는 테스트, 게시, 공유 가이드를 따르는 경우 포함(embed)된 플레이어의 개념을 잘 알고 있어야 합니다. 이 방법으로 인스턴트 게임 SDK의 모든 라이브 함수에 연결되었으며 컴퓨터의 로컬 HTTP 서비스에서 실행되는 인스턴트 게임을 테스트할 수 있습니다.

이 방법을 사용하려고 할 때 게임을 읽어들이는 중에 중단되는 경우가 있습니다. 브라우저의 개발자 콘솔에 메시지가 전혀 표시되지 않거나 Failed to execute 'postMessage' on 'DOMWindow'라는 메시지가 표시되기도 합니다. 두 경우 모두 같은 유형의 오류를 나타내며 보통 로컬 서버에서 인증서 문제로 인해 자산 제공을 거부하여 발생합니다.

이러한 경우에는 로컬 서버의 루트(보통 https://localhost:8000 또는 https://127.0.0.1:8000)로 이동하여 브라우저의 안내에 따라 인증서를 수락하거나 이 웹사이트에 대한 보안 예외를 추가하세요. 이 작업을 완료한 후 포함(embed)된 플레이어 URL로 돌아가면 모두 정상적으로 작동해야 합니다.

이 오류는 과거에 실패한 AdInstance에서 광고를 읽어들이려고 할 때 발생합니다. AdInstance의 loadAsync 메서드에서 이미 한 번 거부한 경우 사용을 다시 시도하지 마세요. 대신 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

비즈니스 리소스 페이지에서 자세히 알아보세요.

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 이메일, 국가, 가맹점 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은 미국 달러(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 재무팀에서 발행합니다. 이 인보이스에 있는 계정 번호는 기록을 위한 내부 번호입니다.

송금 명세서에는 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 플랫폼에서 진행되는 각 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은 Facebook에 대한 회원님의 신뢰를 소중히 여기며, 회원님의 정보에 대한 무단 액세스를 방지하기 위해 필요한 조치를 취합니다. Facebook은 금융 정보를 보안 서버에 철저하게 저장하며 해커로부터 회원님의 소중한 정보를 보호하기 위해 추가적인 조치를 취합니다.

회원님의 연락처 또는 기타 프로필 정보가 Facebook의 데이터 정책에 따라 공유될 수도 있지만 결제 또는 법률에 따른 요구 사항을 준수하기 위해 필요한 경우를 제외하고는 어떠한 은행 또는 PayPal 정보도 공유되지 않습니다.

Facebook은 향후 정산 시 정보를 다시 입력하는 번거로움을 줄이고자 회원님의 정보를 저장할 수도 있습니다. 또한, 회원님이 Facebook에 회원님의 결제 정보 변경을 요청하는 경우 해당 변경 사항을 뒷받침하는 특정 증거(예: 은행 정보)를 보관할 수도 있습니다.

문제가 발생했거나 결제와 관련하여 궁금한 점이 있으면 Facebook에 문의하세요. 문제가 해결될 수 있도록 최선을 다해 지원하겠습니다.

해당 월의 21일까지 결제 대금을 받지 못했다면 지원팀에 문의하기 전에 다음 사항을 확인하세요.

1. 누적 수입이 100달러 이상인지 확인합니다.
2. 은행에서 대금 지급을 거절하지 않았고 회원님의 은행 계좌가 미국 달러로 정산 금액을 받을 수 있는지 은행에 문의합니다.
3. 정산 계좌 정보가 정확한지 검토합니다.

정산 계좌와 관련하여 궁금한 점이나 문제가 있으면 Facebook에 문의하세요.

계정에서 정보를 업데이트하는 데 도움이 필요할 경우 결제 지원 페이지를 방문하세요. 금융 정보가 업데이트되면 10일간 계좌를 보류했다가 결제를 처리합니다. 은행 계좌 또는 PayPal 계좌 소유권을 증명하는 문서를 보내면 보류를 더욱 신속히 해제할 수 있습니다. 증빙 문서로 은행 명세서, 적합한 은행 주소 정보가 머리글에 들어간 은행 문서 또는 PayPal 스크린샷을 보낼 수 있습니다.

본인이 계정 관리자일 경우 비즈니스 관리자 대시보드에서 계정과 연결된 금융 법인을 확인할 수 있습니다. 금융 계정 관리자로 등록되고 싶다면 현재 관리자에게 본인 기관에 대해 요청하세요. Facebook 친구가 되면 Facebook Developers 사이트에서 직접 여러분을 추가할 수 있습니다.

수익자를 위한 Facebook 결제 지원 양식을 사용하여 게임/앱(개발자) > 계정 기록 업데이트 > 앱 또는 Facebook 페이지와 관련된 기관 변경을 선택하세요.

수익자를 위한 Facebook 결제 지원 양식으로 가서 게임/앱(개발자) > 계정 기록 업데이트 > 앱 또는 Facebook 페이지와 관련된 기관 변경을 선택하세요.

Facebook 결제와 구독 기능을 사용하는 앱을 개발했다면 Facebook 결제의 보고 기능을 사용하여 환불 및 결제 취소 활동에 대한 전체 분석 데이터를 받아볼 수 있습니다. 자세한 가이드는 결제 보고 페이지를 참조하세요.

알림 시스템은 없지만 매월 송부하는 송금 PDF에 환불 정보를 포함합니다.

환급금은 매달 지급되지만, 정산 기간이 60일입니다. 즉 1월에 정산된 내역은 3월에 지급됩니다.

각 플레이어는 설정, 정확히는 결제 섹션에서 정보를 확인할 수 있습니다. 플레이어에게 자세한 내용은 Facebook 결제를 참조하라고 안내하세요.

맞춤 설정한 국가 리스트에 게임 액세스를 금지하는 방법:

1. 앱의 대시보드에서 설정 / 고급으로 이동합니다.
2. 국가 제한을 활성화합니다.
3. 허용되는 국가 선택 도구에서 국가를 선택합니다.
4. 변경 내용 저장을 클릭합니다.

인스턴트 게임 앱 검수를 위해 제출하는 동안 Apple의 App Store 검수 가이드라인에 따라 Apple Developer Team ID를 제공해야 합니다. 이는 iOS에서 게임을 배포하는 데 필요한 요소입니다. 잘못되거나 만료된 Developer Team ID를 사용하면 게임이 삭제될 수도 있습니다.

Apple 개발자 계정에 로그인하면 팀 ID를 확인할 수 있습니다.

개발자의 게임 제출과 출시는 일주일에 1개로 제한되어 있습니다. 2주에 걸쳐 게임을 2개 제출할 수 있습니다. Facebook에서 게임 하나를 검수하고, 검수와 승인이 완료되면 일주일에 게임 하나를 게시할 수 있습니다. 게임을 출시하는 데 성공하도록 돕기 위해 이러한 제한을 설정했습니다.

검수 과정에 대한 자세한 내용은 출시 체크리스트에서 검수를 위해 제출 섹션을 참조하세요.

개발자 대시보드의 검수 탭을 사용하면 게임을 Facebook의 검수 팀에 제출할 수 있습니다.

다음과 같은 검수에 대해 게임을 제출해야 합니다.

1. 인스턴트 게임
2. 앱 내 구매
3. Pages_messaging(봇)

다음을 위해 게임을 제출하려면 수익 관리자가 필요합니다.

1. Audience Network 광고 수익화.

IAP 검수를 위해 게임을 제출하기 전에 Audience Network에 대해 앱을 승인받아야 합니다.

검수를 위해 앱 전송하기에 대해 자세히 알아보세요.

일반적으로 Facebook 개발자 운영팀에서는 일주일 이내에 제출된 앱을 처리합니다.

각 검수의 목적은 인스턴트 게임 플랫폼에 온보딩할 만큼 품질 및 무결성 기준을 충족했는지 확인하는 것입니다.

특히, 게임이 기능과 플랫폼 정책 가이드라인을 준수했는지 검수합니다.

검수를 위해 제출하기 전에 릴리스 가이드라인을 참조하세요.

기존의 제출과 관련하여 추가 정보를 요구할 경우 요청을 받은 날로부터 30일 이내에 문제를 해결하고 검수를 위해 다시 제출할 수 있습니다. 이 30일 동안 앱 검수팀에서 추가 정보를 요청할 수 있습니다. 이 기간에는 제출할 때마다 30일로 설정된 기간이 재설정되지 않습니다.

Facebook 검수팀이 개발자가 제공하는 내용을 사용하여 앱의 Facebook 통합을 테스트합니다.

검수자가 앱을 거부한 것이 잘못되었다고 생각하는 경우 더욱 자세한 정보를 제공하도록 검수 지침을 업데이트하여 다시 제출해야 합니다.

검수 절차는 노트를 업데이트하여 개발자가 받은 피드백을 설명할 수 있으므로 검수자와 소통하는 데 가장 효율적인 방법입니다.

인스턴트 게임용으로 만든 Facebook 앱 ID는 다른 플랫폼에 사용할 수 없습니다. 자세한 내용은 문서를 참조하세요.

앱 검수를 위해서는 게임 제출이 (인증되거나 인증되지 않은) 비즈니스와 연결되어야 합니다.

국제 및 국가별 출시의 경우 앱에 링크된 비즈니스는 인증을 받아야 게임을 발견 화면(예: 게임 리스트)에 출시할 수 있습니다. 게임은 검수 승인 후에도 계속 플레이할 수 있습니다.

비즈니스를 인증하려면 비즈니스 관리자를 생성해야 합니다. 비즈니스 인증에 대한 자세한 내용은 여기를 참조하세요.

비즈니스 관리자 생성 방법에 대해 알아보세요.

비즈니스 인증 방법을 알아보세요.

언제든 앱 대시보드의 앱 검수 탭에서 비즈니스 인증 및 계약 상태와 비즈니스 인증 패널에서 실행해야 하는 단계를 확인할 수 있습니다. 절차를 진행하는 동안 어떤 조치가 필요한지 알림을 보내드릴 것입니다.

이미 비즈니스 관리자 계정이 있다면 기존 비즈니스 관리자에 앱을 연결하는 것이 좋습니다.

비즈니스에 속한 비즈니스 관리자 계정이 여러 개라면 각 비즈니스 관리자 계정을 생성한 목적을 확인하고 가장 적절한 비즈니스 관리자와 앱을 연결합니다. 비즈니스가 비즈니스 관리자를 통해 설정된 크레딧 라인이 있다면 크레딧 라인이 있는 비즈니스 관리자와 앱을 연결하는 것이 좋습니다.