구글 워크스페이스 · 구글 애즈 온보딩 플랫폼 연동 흐름
브랜드(부서)마다 워크스페이스 계정과 구글 애즈 계정을 따로 두고, 각 계정의 인증으로만 캠페인을 생성합니다.
단계
담당자브라우저에서 직접
온보딩 서버자동 처리 · DB 저장
구글Workspace / Google Ads
STEP 1계정 생성
수동관리자 화면에서 생성 요청아이디 · 이름 · 브랜드 입력 (CSV 일괄 가능)
자동워크스페이스 계정 생성이메일 · 초기 비밀번호(암호화) · 도메인 · 생성일을 DB에 저장
구글Google WorkspaceAdmin SDK로 user@도메인 계정 생성
STEP 2애즈 개설 · 결제 등록
수동생성 계정으로 최초 로그인구글 애즈 계정 개설 · 결제수단 등록 후 관리자 화면에서 [준비완료] 체크
자동상태 변경준비완료 계정만 다음 단계 진행 가능
구글Google Ads계정별 독립 광고계정 · 결제수단
STEP 3계정별 개별 연동
수동[애즈 연동] 클릭해당 계정으로 구글 로그인 → 권한 허용 (계정당 1회)
자동토큰 · 광고계정 ID 1:1 저장계정마다 별도 토큰(암호화) · 다른 계정으로 로그인하면 저장 거부 · 공용 토큰 없음
구글Google OAuth계정별 Refresh Token · Customer ID 발급
STEP 4캠페인 일괄 생성
수동캠페인 내용 등록예산 · 광고문구 · 키워드를 대기열에 등록
자동워커가 계정별 토큰으로 생성
예산→검색 캠페인→광고그룹→반응형 검색광고→키워드 · 제외키워드
실패한 항목만 로그 기록 후 다음 항목 계속 진행
구글Google Ads API해당 계정에만 캠페인 생성
STEP 5광고 심사 결과 확인
수동거절된 광고 수정화면에서 거절 사유 확인 후 문구 수정
자동1시간마다 심사 결과 수집승인 · 제한승인 · 거절 상태와 사유를 화면에 표시
구글Google 광고 심사생성 후 구글이 별도로 승인/거절 판정
확인 부탁드립니다
- 1계정마다 구글 애즈를 개별 인증으로 연동하고, 관리자(MCC) 계정으로 묶지 않습니다.
- 2STEP 2 애즈 개설 · 결제수단 등록은 계정마다 담당자가 직접 진행합니다.
- 3구글 애즈 API 개발자 토큰은 구글 심사 승인 후 실제 계정에 적용됩니다. 승인 전에는 테스트 계정으로 검증합니다.
- 4광고 승인 · 거절은 캠페인 생성 후 구글 심사로 결정되며, 시스템은 결과를 수집해 보여줍니다.
- 5계정 정지 · 정책 위반 대응은 각 계정 담당자 측에서 처리합니다.
- 6워크스페이스 계정 1개당 구글 라이선스 비용(월)이 발생합니다.
사전 준비
서버
- 설치 서버 · 접속 정보
- Python 3.10 이상, MySQL
- HTTPS 도메인 (OAuth 콜백 주소용)
- 관리 화면: Flask + gunicorn + 리버스프록시
- 워커 상시 실행(systemd), 심사 확인 1시간 주기(cron)
Google Ads 개발자 토큰
- 토큰 발급용 관리자(MCC) 계정 1개 생성 (브랜드 계정은 연결하지 않음)
- API 센터에서 개발자 토큰 신청
- 처음 받는 테스트 토큰은 테스트 계정에서만 동작
- Basic Access 신청 → 구글 심사 통과 후 실계정 사용 (수일 소요)
Google Cloud (워크스페이스 슈퍼관리자)
- 프로젝트 생성, Admin SDK API · Google Ads API 사용 설정
- 서비스 계정 생성 · 키(JSON) 발급
- 관리 콘솔 > 보안 > API 제어 > 도메인 전체 위임 등록
범위 admin.directory.user
- OAuth 동의 화면 내부(Internal) — 같은 도메인 계정만 사용, 앱 검수 불필요
- OAuth 클라이언트(웹 애플리케이션) · 리디렉션 URI에 콜백 주소 등록
범위 openid userinfo.email adwords
정해야 할 것
- 설치 서버와 OAuth 콜백 도메인
- 워크스페이스 도메인, 슈퍼관리자 계정
- Google Cloud · 개발자 토큰 세팅 담당 (의뢰처 / 제작사)
구현 내용
DB 테이블
| 테이블 | 내용 |
workspace_accounts | 워크스페이스 계정 — 이메일, 도메인, 이름, 브랜드, 초기 비밀번호(암호화), 상태(생성중 → 생성 → 준비완료 → 연동완료), 생성일 |
ads_credentials | 계정별 OAuth — Refresh Token(암호화), Customer ID, 인증 이메일. 계정 1개 ↔ 광고계정 1개 고정 |
ads_campaigns_queue | 캠페인 생성 대기열 — 캠페인 내용(JSON), 상태(대기 · 처리중 · 완료 · 일부실패 · 실패 · 재시도 · 차단), 시도 횟수 |
ads_entities | 생성된 예산 · 캠페인 · 광고그룹 · 광고 · 키워드 기록 — 재시도 때 중복 생성 방지 |
ads_job_logs | 단계별 처리 로그 — 에러코드, 메시지, 요청ID, 대상 항목 |
ads_policy_status | 광고별 심사 상태 — 승인 / 제한승인 / 거절, 사유 |
oauth_states | 연동 요청 1회용 확인값 (10분 유효) |
1. 계정 생성
- 서비스 계정이 슈퍼관리자 권한을 위임받아 Admin SDK
users.insert 호출
- 비밀번호 16자 자동 생성(대·소문자, 숫자, 기호), 암호화 저장
- DB 기록 → 구글 생성 → 성공 시 확정, 실패 시 기록 삭제 (중복 계정은 이미 존재로 처리)
- CSV 일괄 생성 지원
2. 계정별 개별 연동
- 관리 화면 [애즈 연동] → 구글 로그인(대상 계정 자동 지정) → 서버 콜백에서 토큰 수신
- 로그인한 이메일이 대상 계정과 다르면 저장하지 않음
- 접근 가능한 광고계정 조회 → 1개면 자동 선택, 여러 개면 화면에서 선택
- 이미 다른 계정에 연결된 광고계정은 연결 거부
- 토큰 만료 · 철회 시 자동으로 "재연동 필요" 표시
3. 캠페인 일괄 생성 워커
- 대기열에서 1건씩 꺼내 해당 계정 토큰으로만 구글 애즈 접속
- 예산 → 검색 캠페인(기본 일시중지 상태) → 지역 · 언어 · 캠페인 제외키워드 → 광고그룹 → 반응형 검색광고 → 키워드 · 광고그룹 제외키워드
- 입찰: 수동 CPC / 클릭수 최대화(CPC 상한) / 전환수 최대화
- 광고 문구는 전송 전 글자수 검사 (제목 3~15개 각 30자, 설명 2~4개 각 90자, 한글은 2자로 계산)
- 광고 · 키워드는 묶어서 전송하되 실패한 항목만 골라 로그 기록, 나머지는 정상 생성
- 광고그룹 하나가 실패해도 다음 광고그룹 계속 진행
- 예산 · 캠페인 생성이 실패하면 해당 건 중단, 일시적 오류는 최대 3회 재시도
- 작업 사이 간격을 두고 순차 처리
4. 심사 결과 확인
- 1시간마다 생성된 캠페인의 광고 심사 상태 조회 → 거절 · 제한승인은 사유와 함께 표시
캠페인 입력 예시
{
"budget": { "name": "브랜드A 검색", "amount_micros": 30000000000 },
"campaign": {
"name": "브랜드A_검색_2026-12", "status": "PAUSED",
"bidding": "MAXIMIZE_CLICKS", "cpc_ceiling_micros": 1500000000,
"start_date": "2026-12-01", "end_date": "2026-12-31",
"geo_target_ids": [2410], "language_ids": [1012]
},
"campaign_negative_keywords": ["무료"],
"ad_groups": [{
"name": "메인키워드", "cpc_bid_micros": 800000000,
"ads": [{
"final_urls": ["https://example.com/"], "path1": "브랜드", "path2": "공식",
"headlines": [{"text": "브랜드A 공식몰", "pin": 1}, "신상품 출시", "무료배송 이벤트"],
"descriptions": ["브랜드A 공식 온라인몰입니다.", "지금 확인해 보세요."]
}],
"keywords": [{"text": "브랜드A", "match": "EXACT"}, "브랜드A 쇼핑몰"],
"negative_keywords": ["채용"]
}]
}
금액은 원 × 1,000,000 단위입니다. 예: 하루 30,000원 = 30000000000
설치 순서
- 서버에 Python 환경 · MySQL 준비, 라이브러리 설치
- 설정 파일 작성, 암호화 키 생성 및 별도 백업
- 서비스 계정 키 · OAuth 클라이언트 파일 업로드
- DB 테이블 생성
- 관리 화면 · HTTPS · OAuth 콜백 주소 연결
- 테스트: 계정 1개 생성 → 애즈 개설 · 결제 등록 → 연동 → 테스트 계정에 캠페인 1건 생성
- 개발자 토큰 Basic 승인 후 실제 계정 적용, 워커 · 심사 확인 상시 실행