Google Ads 연동

## 이 연동으로 보이는 것 - 캠페인별 노출 · 클릭 · CTR · CPC - 광고비 지출과 전환 지표 - 모닝 대시보드의 광고비 합계에 반영 - 광고 분석 화면에서 Meta · 네이버와 나란히 비교 ## 사전 준비물 | 항목 | 어디서 | 비고 | |---|---|---| | Google Ads **관리자 권한** 계정 | — | API 센터 접근에 필요 | | **Developer Token** | Ads → 도구 및 설정 → API 센터 | ⚠️ **승인까지 수 일** | | **Customer ID** | Ads 화면 우상단 10자리 숫자 | 하이픈 제외 | | Refresh Token (선택) | Google Cloud Console OAuth | 실시간 동기화용 | > **가장 먼저 신청하세요.** Developer Token 승인이 이 연동의 유일한 병목입니다. > 신청해 두고 다른 채널을 먼저 붙이는 것이 효율적입니다. ## 발급 절차 ### 1. Developer Token 신청 1. [Google Ads](https://ads.google.com) 에 관리자 계정으로 로그인 2. 우상단 **도구 및 설정** → **설정** → **API 센터** - 메뉴가 안 보이면 계정 권한이 부족합니다. 관리자 권한을 받으세요 3. 약관 동의 후 **Developer Token 신청** 4. 신청 사유에 "자사 광고 성과 조회·분석" 등 용도를 기재 5. 승인 대기 (수 일). 승인 전에는 **테스트 계정에서만** 동작합니다 ### 2. Customer ID 확인 Google Ads 화면 **우상단**에 표시되는 10자리 숫자입니다 (`123-456-7890` 형식). 모닝인사이트에는 **하이픈을 제외한 숫자만** 입력합니다. > ⚠️ **MCC(관리자 계정) ID 를 넣으면 데이터가 안 나옵니다.** > 실제 광고가 집행되는 **광고 계정의 ID** 를 입력하세요. > 여러 광고 계정을 운영하면 각각 확인해야 합니다. ### 3. Refresh Token (선택) 정기 수집만으로 충분하면 건너뛰어도 됩니다. 실시간 동기화가 필요하면 Google Cloud Console 에서 OAuth 클라이언트를 만들어 Refresh Token 을 발급받아 함께 입력합니다. ## 모닝인사이트에 입력 1. **설정 → 데이터 연동** 탭 2. **광고 플랫폼 → Google Ads** 카드 클릭 3. 입력: - Developer Token - Customer ID (숫자만) - Refresh Token (선택) 4. **저장** → **연결 테스트** ## 확인 방법 1. 카드 상태가 `연동됨` 인지 2. **광고 분석** 화면에 캠페인이 나오는지 3. **모닝 대시보드** 의 광고비에 반영됐는지 당일 광고비는 확정값이 아닙니다. Google 이 무효 클릭을 제거하고 전환을 사후 반영하므로 **어제 숫자가 오늘 바뀌는 것은 정상**입니다. ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | 저장은 되는데 데이터가 없다 | Developer Token 이 아직 **승인 대기** | 승인 메일 확인 후 재시도 | | 특정 계정만 조회되지 않는다 | MCC ID 를 입력함 | 실제 광고 계정 ID 로 교체 | | `API 센터` 메뉴가 없다 | 계정 권한 부족 | 관리자 권한 요청 | | 인증 실패 | Customer ID 에 하이픈 포함 | 숫자만 입력 | | 일부 캠페인만 보인다 | 다른 광고 계정에 있는 캠페인 | 계정별로 연동 필요 | ## 제약 - Developer Token 승인 전에는 실데이터를 조회할 수 없습니다 - 광고 계정이 여러 개면 **계정별로 확인**해야 하며, 합계는 연동한 계정만 포함됩니다 - 플랫폼 집계 지연으로 당일 지표는 불완전합니다 ## 관련 문서 - [플랫폼별 사전 준비물](/news/guide/integration-checklist) - [Meta Ads 연동](/news/guide/meta-ads) · [네이버 검색광고 연동](/news/guide/naver-ads) - [연동이 실패할 때](/news/guide/trouble-integration)