구글 애즈 온보딩 플랫폼

구글 워크스페이스 · 구글 애즈 온보딩 플랫폼 연동 흐름

브랜드(부서)마다 워크스페이스 계정과 구글 애즈 계정을 따로 두고, 각 계정의 인증으로만 캠페인을 생성합니다.

단계
담당자브라우저에서 직접
온보딩 서버자동 처리 · 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. 1계정마다 구글 애즈를 개별 인증으로 연동하고, 관리자(MCC) 계정으로 묶지 않습니다.
  2. 2STEP 2 애즈 개설 · 결제수단 등록은 계정마다 담당자가 직접 진행합니다.
  3. 3구글 애즈 API 개발자 토큰은 구글 심사 승인 후 실제 계정에 적용됩니다. 승인 전에는 테스트 계정으로 검증합니다.
  4. 4광고 승인 · 거절은 캠페인 생성 후 구글 심사로 결정되며, 시스템은 결과를 수집해 보여줍니다.
  5. 5계정 정지 · 정책 위반 대응은 각 계정 담당자 측에서 처리합니다.
  6. 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. 계정 생성

2. 계정별 개별 연동

3. 캠페인 일괄 생성 워커

4. 심사 결과 확인

캠페인 입력 예시

{
  "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

설치 순서

  1. 서버에 Python 환경 · MySQL 준비, 라이브러리 설치
  2. 설정 파일 작성, 암호화 키 생성 및 별도 백업
  3. 서비스 계정 키 · OAuth 클라이언트 파일 업로드
  4. DB 테이블 생성
  5. 관리 화면 · HTTPS · OAuth 콜백 주소 연결
  6. 테스트: 계정 1개 생성 → 애즈 개설 · 결제 등록 → 연동 → 테스트 계정에 캠페인 1건 생성
  7. 개발자 토큰 Basic 승인 후 실제 계정 적용, 워커 · 심사 확인 상시 실행