Google Ads API

Last updated: 2026-08-19

Google Ads API Usage

This page describes how DEALY uses the Google Ads API. It is published for the Google Ads API access review. English first, Korean below.

English

1. Who we are

DEALY (https://dealy.co.kr) is a sneaker and apparel price-comparison service operated by 엔콕, a company registered in the Republic of Korea (business registration no. 216-24-23526, CEO 임동혁).

DEALY collects publicly available listing prices from resale and retail platforms and shows consumers where a given product is cheapest. The service is free to consumers and we are not a party to any transaction.

2. Why we advertise on Google

DEALY acquires users through paid search and display campaigns on Google Ads. We operate our own Google Ads account and pay for that media directly. Advertising is our primary user-acquisition channel, so campaign performance is reviewed by our team on a daily basis.

3. Tool type: internal (in-house) tool

The tool we are requesting Google Ads API access for is an INTERNAL TOOL. It is built by us, hosted on our own servers, and used only by our own employees to manage our own Google Ads account.

  • It is not offered, sold, licensed, or made available to any third party.
  • It does not manage advertising accounts belonging to anyone other than DEALY / ENCOC.
  • It has no public-facing interface, no sign-up, and no external users.
  • We do not resell, sublicense, or redistribute any data obtained through the Google Ads API.

4. What the tool does

The tool replaces manual spreadsheet exports from the Google Ads UI. It runs on a schedule and writes results into our internal reporting database, which is then rendered in an internal dashboard used by our marketing team.

  • Performance reporting (read): retrieve campaign, ad group, and ad-level performance metrics — impressions, clicks, cost — via GoogleAdsService.SearchStream.
  • Conversion reporting (read): retrieve Google Ads conversion counts and conversion value alongside cost, so the team can review campaign efficiency in the same dashboard.
  • Change history (read): retrieve change_event records — what was changed, when, by which user, and the before/after values — via GoogleAdsService.SearchStream. The Google Ads UI retains this for 30 days only; we archive it so we can later explain what caused a change in performance. This is the primary reason we need API access rather than the UI.
  • YouTube campaign linkage (read): retrieve video-level rows (video ID, channel ID, campaign ID, views, cost) so that spend on a YouTube video can be matched to that video's organic performance in the same report.

The tool is read-only. It never creates, edits, pauses, or deletes any Google Ads entity. All access is through GoogleAdsService.SearchStream.

5. Who uses it

Only employees of ENCOC — currently the marketing and engineering staff responsible for the DEALY account. Access is restricted by internal authentication. No customer, agency, partner, or member of the public can access the tool or its output.

6. Data handling

Google Ads API data is stored on infrastructure controlled by ENCOC and is used exclusively for the internal reporting purposes described above.

  • We do not share, sell, or transfer Google Ads API data to any third party.
  • We do not combine Google Ads API data with personally identifiable information of end users.
  • Access credentials (OAuth client, refresh token, developer token) are stored as encrypted server-side secrets and are never exposed to the client.
  • We comply with the Google Ads API Terms and Conditions, the Required Minimum Functionality policy, and Google Ads policies.

7. Contact

엔콕 (DEALY)

서울특별시 성동구 뚝섬로3길 11-5 (성수동1가)

Email: dh@encoc.co.kr


한국어

1. 회사 소개

DEALY(https://dealy.co.kr)는 엔콕(대표 임동혁, 사업자등록번호 216-24-23526)이 운영하는 스니커즈·의류 가격비교 서비스입니다.

리셀·리테일 플랫폼에 공개된 판매가를 수집해 이용자에게 최저가를 보여주며, 서비스는 무료이고 회사는 거래의 당사자가 아닙니다.

2. 구글 광고를 집행하는 이유

DEALY는 Google Ads 검색·디스플레이 캠페인을 통해 이용자를 확보합니다. 자사 명의의 Google Ads 계정을 직접 운영하고 광고비를 직접 집행하며, 광고가 주요 유입 경로이므로 캠페인 성과를 매일 확인합니다.

3. 도구 유형: 사내 전용(Internal Tool)

Google Ads API 사용을 신청하는 도구는 사내 전용 도구입니다. 자체 개발·자체 서버 운영이며, 자사 임직원이 자사 Google Ads 계정을 관리하는 목적으로만 사용합니다.

  • 외부에 판매·제공·라이선스하지 않습니다.
  • DEALY / 엔콕 이외의 광고 계정은 다루지 않습니다.
  • 공개 화면·가입 기능·외부 사용자가 없습니다.
  • Google Ads API로 취득한 데이터를 재판매·재배포하지 않습니다.

4. 도구가 수행하는 기능

Google Ads UI에서 수동으로 내려받던 리포트를 대체합니다. 정해진 주기로 실행되어 사내 리포팅 DB에 적재하고, 마케팅팀 전용 대시보드에 표시합니다.

  • 성과 리포팅(읽기): GoogleAdsService.SearchStream으로 캠페인·광고그룹·소재 단위 노출수, 클릭수, 비용 조회
  • 전환 리포팅(읽기): 비용과 함께 Google Ads 전환수·전환 가치를 조회해 같은 대시보드에서 캠페인 효율을 확인
  • 변경 이력(읽기): change_event로 무엇이·언제·누구에 의해 바뀌었는지와 변경 전후 값을 조회합니다. Google Ads UI는 30일만 보관하므로, 성과 변동의 원인을 나중에 설명할 수 있도록 보관합니다. UI가 아니라 API가 필요한 가장 큰 이유입니다.
  • 유튜브 캠페인 연결(읽기): 영상 단위 행(영상 ID·채널 ID·캠페인 ID·조회수·비용)을 조회해, 특정 영상에 집행한 광고비를 같은 리포트에서 그 영상의 오가닉 성과와 나란히 봅니다.

이 도구는 읽기 전용입니다. 캠페인·예산·키워드 등 어떤 항목도 생성·수정·중지·삭제하지 않으며, 모든 접근은 GoogleAdsService.SearchStream 조회로만 이루어집니다.

5. 사용 주체

엔콕 임직원(DEALY 계정을 담당하는 마케팅·엔지니어링 인력)만 사용합니다. 사내 인증으로 접근을 제한하며, 고객·대행사·파트너·일반 이용자는 도구와 그 산출물에 접근할 수 없습니다.

6. 데이터 취급

Google Ads API 데이터는 엔콕이 관리하는 인프라에 저장되며 위 사내 리포팅 목적으로만 사용합니다.

  • 제3자에게 공유·판매·이전하지 않습니다.
  • 최종 이용자의 개인식별정보와 결합하지 않습니다.
  • 인증정보(OAuth 클라이언트, 리프레시 토큰, 개발자 토큰)는 서버 측 암호화 시크릿으로 보관하며 클라이언트에 노출하지 않습니다.
  • Google Ads API 이용약관, Required Minimum Functionality 정책 및 Google Ads 정책을 준수합니다.

7. 문의

엔콕 (DEALY)

서울특별시 성동구 뚝섬로3길 11-5 (성수동1가)

이메일: dh@encoc.co.kr