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

Kakao Moment API 설정 가이드

카카오 모먼트 광고를 Funnely에 연동하기 위한 Kakao Developers 설정 방법을 안내합니다.

현재 준비 중인 기능입니다

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

시작하기 전에

  • 카카오 계정이 필요합니다
  • Kakao Developers 앱이 필요합니다
  • 카카오 모먼트 광고 계정이 필요합니다
1

Kakao Developers 앱 등록

1-1. Kakao Developers 접속

아래 링크로 이동하여 카카오 계정으로 로그인합니다:

Kakao Developers 열기 →

1-2. 애플리케이션 추가

  1. 우측 상단의 "내 애플리케이션" 클릭
  2. "애플리케이션 추가하기" 버튼 클릭
  3. 앱 정보 입력:
    • • 앱 이름: "Funnely 광고 연동" (또는 원하는 이름)
    • • 사업자명: 회사 이름 또는 사업자명
  4. "저장" 클릭

💡 팁: 앱 등록 후 카카오 검수가 필요할 수 있습니다. 개인 개발자는 즉시 사용 가능하지만, 비즈니스 용도는 사업자 등록증 제출이 필요할 수 있습니다.

2

API 키 확인

2-1. REST API 키 복사

  1. 생성한 앱을 클릭하여 앱 설정 페이지로 이동
  2. 좌측 메뉴에서 "앱 키" 클릭
  3. "REST API 키" 확인 및 복사

REST API 키 예시:

1234567890abcdef1234567890abcdef

2-2. JavaScript 키 복사

  1. 같은 "앱 키" 페이지에서
  2. "JavaScript 키" 확인 및 복사

JavaScript 키 예시:

abcdef1234567890abcdef1234567890

보안 경고: API 키는 절대 공개 저장소나 클라이언트 코드에 노출하지 마세요.

3

플랫폼 설정

3-1. 플랫폼 추가

  1. 좌측 메뉴에서 "플랫폼" 클릭
  2. "Web 플랫폼 등록" 클릭
  3. 사이트 도메인 입력:
    https://your-domain.com
  4. "저장" 클릭

💡 팁: 로컬 개발 환경을 위해 http://localhost:3000도 추가할 수 있습니다.

4

Redirect URI 설정

4-1. 카카오 로그인 활성화

  1. 좌측 메뉴에서 "카카오 로그인" 클릭
  2. "활성화 설정"의 "ON" 버튼 클릭
  3. "Redirect URI" 섹션으로 이동
  4. "Redirect URI 등록" 클릭
  5. 다음 URI 입력:
    https://your-domain.com/auth/callback/kakao
  6. "저장" 클릭

주의: Redirect URI는 정확히 일치해야 합니다. http/https, 포트 번호까지 모두 확인하세요.

5

동의 항목 설정

5-1. 필수 동의 항목 설정

  1. 좌측 메뉴에서 "동의 항목" 클릭
  2. 다음 항목들을 "필수 동의"로 설정:
    • • 닉네임
    • • 카카오계정 (이메일)
    • • 프로필 사진
  3. 광고 관련 권한 확인 (카카오 모먼트 사용 시):
    • • 카카오 모먼트 광고 관리

💡 팁: 일부 권한은 카카오 비즈니스 검수가 필요할 수 있습니다. 초기에는 기본 정보만 사용하고, 필요에 따라 추가 권한을 신청하세요.

6

카카오 모먼트 연동 (광고 계정)

6-1. 카카오 모먼트 접속

카카오 모먼트 광고 관리 페이지로 이동:

카카오 모먼트 열기 →

6-2. 광고 계정 생성

  1. 카카오 계정으로 로그인
  2. "광고 계정 만들기" 클릭
  3. 광고 계정 정보 입력:
    • • 광고주명: 회사 이름
    • • 사업자 정보: 사업자 등록 정보
    • • 업종: 의료/건강
  4. 결제 수단 등록 (신용카드 또는 계좌)

참고: 카카오 모먼트는 사업자 등록이 필수입니다. 개인 개발자 계정으로는 광고 집행이 제한될 수 있습니다.

7

Funnely에 인증 정보 입력

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

• Kakao Developers → 앱 키에서 복사한 REST API 키

• Kakao Developers → 앱 키에서 복사한 JavaScript 키

Funnely에 인증 정보 입력하기

문제 해결

❌ "Invalid API Key" 오류

  • REST API 키를 정확하게 복사했는지 확인
  • 앞뒤 공백이 포함되지 않았는지 확인
  • Native App Key가 아닌 REST API Key인지 확인

❌ "Redirect URI Mismatch" 오류

  • 카카오 로그인이 활성화되어 있는지 확인
  • Redirect URI가 정확히 일치하는지 확인 (대소문자, 슬래시 포함)
  • http/https 프로토콜이 일치하는지 확인

❌ 카카오 모먼트 광고 계정 생성 불가

  • 사업자 등록증이 정확히 입력되었는지 확인
  • 의료 광고는 추가 심사가 필요할 수 있음
  • 카카오 비즈니스 고객센터에 문의 필요

❌ "권한이 없습니다" 오류

  • 동의 항목에서 필요한 권한이 활성화되어 있는지 확인
  • 일부 권한은 카카오 비즈니스 검수가 필요
  • 앱 상태가 "개발 중"이 아닌 "서비스 중"인지 확인

추가 리소스