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

Google Ads API 설정 가이드

Google 검색 광고 및 디스플레이 네트워크를 Funnely에 연동하기 위한 Google Cloud 및 Google Ads 설정 방법을 안내합니다.

현재 준비 중인 기능입니다

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

시작하기 전에

  • Google 계정이 필요합니다
  • Google Ads 계정이 필요합니다
  • Google Cloud Platform (GCP) 프로젝트가 필요합니다
  • Google Ads Developer Token이 필요합니다 (승인 과정 필요)
1

Google Cloud 프로젝트 생성

1-1. Google Cloud Console 접속

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

Google Cloud Console 열기 →

1-2. 새 프로젝트 만들기

  1. 상단의 프로젝트 선택 드롭다운 클릭
  2. "새 프로젝트" 클릭
  3. 프로젝트 정보 입력:
    • • 프로젝트 이름: "Funnely Ads" (또는 원하는 이름)
    • • 조직: 선택 (없으면 "조직 없음")
  4. "만들기" 클릭

💡 팁: Google Cloud는 무료 평가판($300 크레딧)을 제공합니다. API 호출은 소량이므로 크레딧 내에서 충분히 사용 가능합니다.

2

Google Ads API 활성화

2-1. API 라이브러리 접속

  1. Google Cloud Console 좌측 메뉴에서 "API 및 서비스""라이브러리" 클릭
  2. 검색창에 "Google Ads API" 입력
  3. "Google Ads API" 선택
  4. "사용" 버튼 클릭

주의: API 활성화 후 몇 분 정도 소요될 수 있습니다.

3

OAuth 2.0 클라이언트 ID 생성

3-1. OAuth 동의 화면 구성

  1. 좌측 메뉴에서 "API 및 서비스""OAuth 동의 화면" 클릭
  2. 사용자 유형 선택:
    • "외부" 선택 (조직 계정이 아닌 경우)
  3. "만들기" 클릭
  4. 앱 정보 입력:
    • • 앱 이름: "Funnely"
    • • 사용자 지원 이메일: 회사 담당자 이메일
    • • 개발자 연락처 정보: 개발자 이메일
  5. "저장 후 계속" 클릭
  6. 범위 추가:
    • "범위 추가 또는 삭제" 클릭
    • "https://www.googleapis.com/auth/adwords" 선택
    • "업데이트" 클릭
  7. "저장 후 계속" 클릭하여 완료

3-2. OAuth 클라이언트 ID 생성

  1. 좌측 메뉴에서 "사용자 인증 정보" 클릭
  2. 상단의 "+ 사용자 인증 정보 만들기""OAuth 클라이언트 ID" 클릭
  3. 애플리케이션 유형: "웹 애플리케이션" 선택
  4. 이름: "Funnely Web Client"
  5. "승인된 리디렉션 URI"에 다음 추가:
    https://your-domain.com/auth/callback/google
  6. "만들기" 클릭

3-3. 클라이언트 ID와 시크릿 복사

생성 완료 후 표시되는 팝업에서:

  • 클라이언트 ID 복사 및 저장
  • 클라이언트 보안 비밀번호 복사 및 저장

보안 경고: 클라이언트 보안 비밀번호는 절대 공개하지 마세요. 유출 시 즉시 새로운 클라이언트 ID를 생성하세요.

4

Google Ads Developer Token 신청

4-1. Google Ads 계정 접속

Google Ads 관리자 계정으로 이동:

Google Ads 열기 →

4-2. Developer Token 확인

  1. Google Ads 계정에 로그인
  2. 우측 상단의 "도구 및 설정" (렌치 아이콘) 클릭
  3. "설정""API 센터" 클릭
  4. Developer Token 섹션에서:
    • • 이미 토큰이 있다면 복사
    • • 없다면 "토큰 생성" 클릭

4-3. 토큰 승인 신청 (선택사항)

초기에는 "테스트" 수준의 토큰이 발급되며, 자신의 광고 계정에만 접근할 수 있습니다.

테스트 수준 토큰:

  • 자신의 Google Ads 관리자 계정 및 하위 계정에만 접근 가능
  • 일일 API 호출 한도: 15,000회
  • 별도 승인 과정 없이 즉시 사용 가능

프로덕션 수준 토큰 (고급):

  • 다른 사용자의 광고 계정에도 접근 가능
  • 일일 API 호출 한도: 무제한
  • Google 검토 및 승인 필요 (수 주 소요)
  • 회사 자체 광고만 관리한다면 테스트 수준으로 충분

참고: 대부분의 회사은 테스트 수준 Developer Token으로 충분합니다. 자신의 광고 계정만 관리하므로 프로덕션 승인이 불필요합니다.

5

Google Ads 관리자 계정 설정

5-1. 관리자 계정 확인

Google Ads API를 사용하려면 관리자 계정 (Manager Account, MCC)이 필요합니다.

  1. 이미 관리자 계정이 있다면 해당 계정 사용
  2. 없다면 관리자 계정 생성:
  3. 기존 광고 계정을 관리자 계정에 연결:
    • • 관리자 계정에서 "계정" 메뉴 클릭
    • "+ 추가""기존 계정 연결"
    • • 고객 ID 입력 후 연결 요청

💡 팁: 관리자 계정(MCC)은 여러 광고 계정을 하나의 인터페이스로 관리할 수 있게 해주는 계정입니다. API 접근을 위해 필수입니다.

6

Funnely에 인증 정보 입력

Google Cloud 및 Google Ads에서 확인한 정보를 Funnely에 입력합니다.

• Google Cloud Console → 사용자 인증 정보에서 생성한 OAuth 2.0 클라이언트 ID

• Google Cloud Console → 사용자 인증 정보에서 생성한 클라이언트 보안 비밀번호

• Google Ads → API 센터에서 발급받은 Developer Token

문제 해결

❌ "Invalid Client ID" 오류

  • 클라이언트 ID를 정확하게 복사했는지 확인
  • 앞뒤 공백이 포함되지 않았는지 확인
  • OAuth 2.0 클라이언트 ID가 활성화되어 있는지 확인

❌ "Redirect URI Mismatch" 오류

  • 승인된 리디렉션 URI가 정확히 일치하는지 확인
  • http/https 프로토콜이 일치하는지 확인
  • 포트 번호, 경로가 정확히 일치하는지 확인

❌ "Developer Token is invalid" 오류

  • Developer Token을 정확하게 복사했는지 확인
  • 토큰이 활성화되어 있는지 확인 (Google Ads API 센터에서)
  • 관리자 계정 (MCC)에서 발급한 토큰인지 확인

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

  • 관리자 계정(MCC)이 광고 계정과 연결되어 있는지 확인
  • OAuth 범위에 https://www.googleapis.com/auth/adwords가 포함되어 있는지 확인
  • 광고 계정 관리자 권한이 있는지 확인

❌ "API not enabled" 오류

  • Google Cloud Console에서 Google Ads API가 활성화되어 있는지 확인
  • 올바른 프로젝트에서 API를 활성화했는지 확인
  • API 활성화 후 5-10분 대기