API 인증 정보 설정으로 돌아가기
f

Meta Ads API 설정 가이드

Facebook과 Instagram 광고를 Funnely에 연동하기 위한 Meta for Developers 설정 방법을 안내합니다.

현재 준비 중인 기능입니다

아래 설정을 완료해도 실제 광고 계정 연동은 아직 활성화되지 않았습니다. 가이드는 준비 과정 안내용으로 미리 제공되고 있으며, 연동 기능이 열리면 별도로 안내드립니다.

시작하기 전에

  • Facebook 비즈니스 계정이 필요합니다
  • Meta for Developers 계정이 필요합니다
  • 광고 계정 관리자 권한이 있어야 합니다
1

Meta for Developers 앱 생성

1-1. Meta for Developers 접속

아래 링크로 이동하여 로그인합니다:

Meta for Developers 열기 →

1-2. 새 앱 만들기

  1. 오른쪽 상단의 "내 앱" 클릭
  2. "앱 만들기" 버튼 클릭
  3. 앱 유형 선택: "비즈니스" 선택
  4. 앱 정보 입력:
    • • 앱 이름: "Funnely 광고 연동" (또는 원하는 이름)
    • • 앱 연락처 이메일: 회사 담당자 이메일
  5. "앱 만들기" 클릭

💡 팁: 앱 이름은 나중에 변경할 수 있으니 걱정하지 마세요.

2

Marketing API 제품 추가

2-1. Marketing API 설정

  1. 앱 대시보드 왼쪽 메뉴에서 "제품 추가" 클릭
  2. "Marketing API" 찾기
  3. "설정" 버튼 클릭
  4. 도구 선택에서 "시작하기" 클릭

주의: Marketing API는 광고 관리 권한이 필요합니다. Facebook 비즈니스 계정과 연결되어 있는지 확인하세요.

3

앱 ID와 앱 시크릿 확인

3-1. 앱 ID 복사

  1. 앱 대시보드 왼쪽 메뉴에서 "설정" → "기본 설정" 클릭
  2. 페이지 상단에 "앱 ID" 표시됨
  3. 앱 ID 옆의 복사 버튼 클릭하여 복사

3-2. 앱 시크릿 확인

  1. 앱 ID 아래 "앱 시크릿" 필드 찾기
  2. "표시" 버튼 클릭 (Facebook 비밀번호 입력 필요)
  3. 표시된 앱 시크릿 복사

보안 경고: 앱 시크릿은 절대 공개하지 마세요. 이 정보가 유출되면 광고 계정이 위험에 노출될 수 있습니다.

4

OAuth 리디렉션 URI 설정

4-1. 리디렉션 URI 추가

  1. 여전히 "기본 설정" 페이지에서 진행
  2. 아래로 스크롤하여 "앱 도메인" 섹션 찾기
  3. 다음 도메인 추가:
    https://your-domain.com
  4. 더 아래로 스크롤하여 "Facebook 로그인" → "설정" 메뉴 클릭
  5. "유효한 OAuth 리디렉션 URI"에 다음 추가:
    https://your-domain.com/auth/callback/meta
  6. "변경 내용 저장" 클릭

💡 팁: 로컬 테스트를 위해 http://localhost:3000/auth/callback/meta도 추가할 수 있습니다.

5

앱 모드 변경 (선택사항)

개발 모드에서는 앱 관리자와 개발자만 사용할 수 있습니다. 실제 사용자들이 접근하려면 라이브 모드로 전환해야 합니다.

라이브 모드 전환 방법

  1. 앱 대시보드 상단의 모드 토글 스위치 확인
  2. "개발 모드"에서 "라이브 모드"로 전환
  3. 필요한 권한 검토 및 앱 검수 제출 (필요한 경우)

참고: 초기 테스트 단계에서는 개발 모드로 진행해도 됩니다. 테스트 사용자를 앱 역할에 추가하면 개발 모드에서도 접근할 수 있습니다.

6

Funnely에 인증 정보 입력

Meta for Developers에서 확인한 정보를 Funnely에 입력합니다.

• Meta for Developers → 설정 → 기본 설정에서 복사한 앱 ID

• Meta for Developers → 설정 → 기본 설정에서 복사한 앱 시크릿

Funnely에 인증 정보 입력하기

문제 해결

❌ "Invalid App ID" 오류

  • 앱 ID를 정확하게 복사했는지 확인
  • 앞뒤 공백이 포함되지 않았는지 확인
  • Meta for Developers에서 앱이 활성화되어 있는지 확인

❌ "Redirect URI Mismatch" 오류

  • OAuth 리디렉션 URI가 정확하게 설정되었는지 확인
  • http/https 프로토콜이 일치하는지 확인
  • 포트 번호가 포함된 경우 정확히 일치하는지 확인

❌ 광고 계정에 접근할 수 없음

  • Facebook 비즈니스 계정이 광고 계정과 연결되어 있는지 확인
  • Marketing API 제품이 앱에 추가되었는지 확인
  • 필요한 권한 (ads_management, ads_read)이 요청되었는지 확인

❌ 앱이 개발 모드에 고정됨

  • 앱 검수가 필요한 권한을 요청하는 경우 Meta 앱 검수 제출 필요
  • 개발 모드에서는 테스트 사용자를 앱 역할에 추가하여 사용
  • 비즈니스 앱의 경우 비즈니스 인증이 필요할 수 있음

추가 리소스