Meta 앱 등록 (운영자)

## 한 번에 세 개 Meta 앱 **하나**로 아래를 모두 처리합니다. - Meta Ads (Facebook · Instagram 광고) - Facebook 페이지 - Instagram Business ## 사전 준비물 - [ ] Facebook 개인 계정 (개발자 계정으로 1회 전환) - [ ] **Facebook 비즈니스 계정** — [business.facebook.com](https://business.facebook.com) 에서 생성 (필수) - [ ] 테스트용 Facebook 페이지 또는 Instagram Business 계정 1개 - [ ] 서비스 도메인 (**HTTPS 필수**) - [ ] 개인정보 처리방침 · 이용약관 공개 URL - [ ] 앱 아이콘 1024×1024 ## 등록 절차 ### 1. 앱 만들기 1. [Meta for Developers](https://developers.facebook.com) → **내 앱** → **앱 만들기** 2. 앱 유형: **비즈니스** 3. 앱 이름 · 연락 이메일 · 비즈니스 계정 선택 ### 2. 제품 추가 좌측 메뉴 → **제품 추가** 에서 아래를 모두 추가합니다. | 제품 | 무엇을 위해 | |---|---| | **Facebook 로그인** | 모든 OAuth 흐름의 공통 기반 | | **Marketing API** | 광고 데이터 | | **Instagram Graph API** | Instagram Business | ### 3. Facebook 로그인 설정 **Valid OAuth Redirect URIs** 에 등록합니다. ``` https://<서비스 도메인>/auth/meta/callback https://<서비스 도메인>/auth/instagram/callback ``` ### 4. 앱 기본 설정 **앱 설정 → 기본 설정** | 항목 | 값 | |---|---| | 앱 도메인 | 서비스 도메인 | | 개인정보 처리방침 URL | 서비스의 개인정보 처리방침 페이지 | | 서비스 약관 URL | 서비스의 이용약관 페이지 | | 앱 아이콘 | 1024×1024 | 같은 화면 하단에서 **앱 ID** 와 **앱 시크릿** 을 확인합니다. ### 5. 권한 및 기능 신청 **권한 및 기능** 에서 아래를 신청합니다. | 권한 | 무엇을 위해 | |---|---| | `ads_read` | 광고 데이터 조회 | | `business_management` | 비즈니스 계정 관리 | | `instagram_basic` | Instagram 기본 정보 | | `instagram_manage_insights` | Instagram 인사이트 | | `pages_show_list` | 페이지 목록 | | `pages_read_engagement` | 페이지 반응 | | `pages_read_user_content` | 페이지 게시물 | > 신청하지 않은 권한을 요청하면 `invalid_scope` 가 발생합니다. ## 모닝인사이트에 입력 `/admin` 운영자 콘솔 → Meta 섹션 | 항목 | |---| | App ID | | App Secret | > Instagram·Facebook 페이지용 별도 키를 만들 필요 없습니다. > **Meta 앱 값을 공유**해 사용합니다. ## 심사 (App Review) | 모드 | 조건 | |---|---| | **개발 모드** | 운영자 본인 + 등록한 테스트 사용자만 OAuth 가능 | | **라이브 모드** | 일반 고객 OAuth 가능. **권한별 심사 필요** | 라이브 전환 시 요구되는 것: - **화면 녹화** — 해당 권한을 실제로 어떻게 쓰는지 시연 - **사용 시나리오 설명** - **비즈니스 검증** (사업자 확인) 기간은 보통 **1~3주**입니다. > ⚠️ Meta 는 정책 심사가 까다롭습니다. > 신청 전 [Meta 플랫폼 정책](https://developers.facebook.com/policy/)을 한 번 읽어 두세요. > 반려 사유가 모호하게 오는 경우가 많아, 화면 녹화에서 **데이터를 어디에 어떻게 표시하는지** > 명확히 보여주는 것이 통과율을 크게 높입니다. ## 자주 나는 오류 | 오류 | 원인 | 해결 | |---|---|---| | `unauthorized_client` | 앱이 개발 모드 + 테스트 사용자 미등록 | 테스트 사용자 추가 또는 라이브 전환 | | `invalid_scope` | 권한 미신청 | 권한 및 기능에서 신청 | | `redirect_uri_mismatch` | Redirect URI 불일치 | Facebook 로그인 설정에서 정확히 등록 | | 토큰은 받는데 광고 데이터 없음 | 광고 계정 자산이 앱/System User 에 미할당 | 비즈니스 설정에서 자산 할당 | | Instagram 데이터 없음 | 고객 계정이 비즈니스 계정이 아님 | 고객 안내 → [Instagram 연동](/news/guide/instagram) | ## 관련 문서 - [Naver 앱 등록](/news/guide/operator-naver) - [심사 준비 체크리스트](/news/guide/operator-review) - 고객용: [Meta Ads 연동](/news/guide/meta-ads) · [Instagram 연동](/news/guide/instagram) · [Facebook 페이지 연동](/news/guide/facebook-pages)