구글 광고 로고

광고

연결하다 구글 광고 엑셀, 구글 시트, AI 및 REST로

캠페인, 광고 그룹, 키워드 및 지출액을 쿼리 가능한 테이블 형태로 제공합니다. 이러한 테이블을 PostgreSQL 또는 스프레드시트 내보내기 폴더에 있는 자체 전환 데이터와 결합하세요.

무료로 시작하세요 13개 목적지

하나의 연결, 모든 표면

Google Ads 데이터가 저장될 수 있는 위치

구글 광고 실시간 API 데이터 SQL 테이블로
연합 쿼리 + 기타 커넥터 · SQL 하나 다양한 출처에서 · 모든 계획
네트워크 에이전트
  • 1 발신 연결
  • 0 입국항
  • 읽기 전용 · 자격 증명은 그대로 유지됩니다

실행 중

쿼리 스트림은 Google Ads 계정을 캠페인, 광고 그룹, 광고, 키워드, 검색어, 지역, 기기, 인구 통계, 방문 페이지 및 변경 내역 등 12개의 SQL 테이블로 변환합니다. 이 테이블은 Microsoft Excel, Google Sheets, Power BI, MCP를 통한 AI 비서 및 REST 엔드포인트에서 읽을 수 있습니다. 지출 내역은 수익 내역과 조인할 수 있는 열로 제공되는데, 이것이 바로 쿼리 스트림의 핵심입니다. 일반적으로 매달 스프레드시트에서 수행되는 대조 작업이 하나의 명세서로 통합됩니다.

  1. 귀사 팀, 협력업체 및 파트너 여러분께

  2. 엑셀용 구글 광고 마이크로소프트 엑셀 · 엑셀 추가 기능

    Google Ads 실시간 결과를 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. (데스크톱 Excel, Excel Online, Microsoft 365 지원)

    엑셀 작동 방식

  3. Google Ads에서 Google Sheets로 스프레드시트 추가 기능

    사이드바에서 저장된 Google Ads 쿼리를 실행하고 결과를 스프레드시트에 드래그 앤 드롭하세요. 공동 작업자는 스프레드시트를 직접 새로 고칠 수 있습니다.

    Google Sheets 작동 방식

  4. 노바에게 구글 광고에 대해 문의하세요 Nova AI · 텍스트를 SQL로 변환

    쉬운 영어로 질문하세요. Nova는 이미 Google Ads 테이블을 알고 있으므로 SQL 쿼리를 작성하고 실행한 다음 답변을 설명하고 차트로 보여줍니다. 쿼리를 직접 작성하거나 계정 정보를 제공할 필요가 없습니다.

    Nova는 어떻게 작동하나요?

  5. Google Ads에서 데이터 뷰어로 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱

    Google Ads 실시간 결과를 동료, 협력업체, 파트너 등 누구와도 북마크 가능한 그리드 형식으로 공유하세요. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 최신 결과가 표시됩니다. 상대방은 결과만 볼 수 있고, SQL 쿼리나 계정 정보는 절대 노출되지 않습니다.

    데이터 뷰어 작동 방식
  6. 앱 및 시스템용

  7. Google Ads REST API HTTP 엔드포인트

    인증된 JSON 엔드포인트로 Google Ads 쿼리를 게시하여 모든 애플리케이션에서 호출할 수 있도록 합니다. OpenAPI 3.1 사양을 지원하며 Postman, Insomnia, Hoppscotch에서 바로 사용할 수 있는 컬렉션이 제공됩니다. 데이터베이스 포트는 열지 않습니다.

    REST API 작동 방식

  8. Google Ads에서 Power BI로 파워 쿼리 M

    생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 ODBC 드라이버나 데이터베이스 포트를 열 필요 없이 HTTPS를 통해 실시간 Google Ads 결과를 보고서에서 읽어옵니다.

    Power BI 작동 방식

  9. Google Ads에서 Airtable로 자동화 플랫폼

    Google Ads 행을 예약된 시간에 Airtable 데이터베이스에 동기화하거나 Airtable 자동화 스크립트 내에서 가져올 수 있습니다.

    Airtable 작동 방식

  10. Baserow에 대한 Google Ads 자동화 플랫폼

    Google Ads에서 REST 엔드포인트를 통해 Baserow 테이블에 데이터를 제공합니다(자체 호스팅 또는 Baserow 클라우드 환경).

    Baserow의 작동 방식

  11. SeaTable에 대한 Google 광고 자동화 플랫폼

    파일을 내보내거나 데이터베이스를 노출하지 않고도 SeaTable 데이터베이스를 Google Ads 데이터로 최신 상태로 유지하세요.

    SeaTable 작동 방식

  12. Google Ads에서 Smartsheet로 자동화 플랫폼

    Google Ads 결과를 Smartsheet 그리드에 추가하여 계획 및 보고서가 지난주 내보내기 데이터가 아닌 원본 시스템에서 가져오도록 합니다.

    Smartsheet 작동 방식

  13. Google Ads에서 Anvil까지 앤빌 웍스 · 앱 플랫폼

    Anvil Python 앱을 Google Ads로 백엔드하려면 앱에 데이터베이스 자격 증명을 직접 삽입하는 대신 REST 엔드포인트를 사용하면 됩니다.

    Anvil의 작동 방식
  14. AI 도구의 경우

  15. Google Ads MCP 서버 Claude, Cursor 및 MCP 고객

    AI 어시스턴트에게 Google Ads에 대한 읽기 전용 액세스 권한을 부여하되, 올바른 SQL 쿼리를 작성하는 데 필요한 스키마만 제공하세요. 채팅창에 자격 증명을 입력할 필요는 없습니다.

    구글 광고 가이드
  16. 사람들에게 전달됨

  17. Google Ads 알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅

    Google Ads 쿼리를 예약하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송하거나, 설정한 행 수, 임계값 또는 백분율 변화 기준치를 넘을 때까지 메시지를 보류할 수 있습니다.

    알림 및 보고서 작동 방식

작동 방식

5단계, 인바운드 방화벽 변경 없음

01

Google Ads 계정용 개발자 토큰을 발급받고 도메인 전체 위임이 가능한 서비스 계정을 만드세요.

02

네트워크 에이전트를 설치하고 서비스 계정 키, 개발자 토큰, 가장할 이메일 주소 및 고객 ID를 입력하십시오. 하위 계정에 접근하기 위한 관리자 계정 ID는 선택 사항입니다.

03

12개의 테이블 중 동기화할 테이블을 선택하세요. 캠페인, 광고 그룹, 키워드, 검색어, 지역, 기기 및 계정 자체는 기본적으로 동기화됩니다.

04

gads.campaign, gads.search_term_view 등을 대상으로 일반 SQL 쿼리를 직접 작성하거나, Nova가 자동으로 작성하도록 할 수 있습니다.

05

Excel, Sheets, Power BI, MCP 또는 REST에서 데이터를 읽어와 수익 정보가 저장된 모든 장치와 연결하세요.

기능 심층 분석

Google Ads가 제공하는 기능

지출과 수익을 하나의 명세서에 표시하세요.

Google Ads는 광고비 지출 내역은 알지만, 고객이 실제로 얼마를 지불했는지는 알지 못합니다. 중요한 보고서를 작성하려면 두 가지 모두 필요합니다.

  • gads.campaign은 일별 노출수, 클릭수, 비용, 전환수 및 전환 가치를 제공하므로 캠페인 이름이나 UTM으로 검색된 모든 데이터와 깔끔하게 결합됩니다.
  • gads.search_term_view는 사용자가 실제로 입력한 검색어이며, 바로 이 부분에서 보통 비용이 새어나갑니다. — 또한 광고 인터페이스에 갇히는 대신 자체 전환 데이터와 결합할 수 있습니다.
  • 송금액은 API에서 보고하는 그대로 마이크로달러 단위로 들어옵니다. 1달러는 1,000,000이므로, 직접 나누기 전에는 반올림된 금액이 없습니다.

12개의 테이블

  • 구조 — 고객, 캠페인, 광고그룹, 광고그룹광고.
  • 찾다 — 키워드 조회수, 검색어 조회수, 랜딩 페이지 조회수.
  • 고장 — 지리적 보기, 기기 보기, 연령대 보기, 성별 보기.
  • 심사 — 변경 내역.
  • 각 행에는 전체 API 응답이 raw_data JSON 열에 저장되므로 명명된 열이 아닌 메트릭도 여전히 남아 있습니다.

솔직히 말해서, 숫자가 멈추는 지점은 어디일까요?

광고 데이터에 관해 어떤 도구를 사용하든 간에 필연적으로 마주하게 되는 두 가지 사실이 있는데, 이는 나중에 발견되는 것이 아니라 명확하게 드러나는 사실입니다.

  • 보고서는 오늘 날짜가 아닌 어제 날짜까지 집계됩니다. — 오늘 발표된 수치는 구글 측의 불완전한 자료이며, 오해를 불러일으킬 수 있습니다.
  • 각 증분 실행은 최근 며칠간의 데이터와 새로운 데이터를 모두 다시 읽어들입니다. 전환율은 늦게 반영되므로 월요일에 가져온 수치가 Google이 목요일에 확정할 수치와 다를 수 있기 때문입니다.
  • Google Ads API 자체에서 변경 내역은 29일로 제한됩니다. 이는 최근 변경 사항 피드일 뿐이며 영구적인 감사 로그가 아닙니다.
  • 일부 지리적 열에는 장소 이름 대신 Google의 검색 기준 ID가 포함되어 있으며, 몇몇 광고 문구 열은 아직 채워지지 않았습니다. 있는 데이터는 정확하며, 없는 데이터는 오류가 아니라 비어 있는 것입니다.

모든 API 커넥터에서 공유됨

모든 API 커넥터의 작동 방식

  • 귀하의 계정은 테이블이 됩니다. 엔드포인트는 기본 키와 인덱스가 있는 형식화된 SQL 테이블에 매핑되므로 JSON을 페이지별로 탐색하는 대신 SELECT, JOIN 및 GROUP BY를 작성할 수 있습니다.
  • 동기화할 항목과 동기화 빈도를 직접 선택할 수 있습니다. 각 테이블마다 고유한 업데이트 간격이 있거나 아예 없을 수도 있습니다. 공급업체의 API에서 지원하는 경우, 마지막 실행 이후 변경된 레코드만 가져옵니다.
  • 이 사본은 당신 것입니다. — 해당 정보는 에이전트와 함께 사용자의 컴퓨터에 있는 AES-256-GCM으로 암호화된 DuckDB 파일에 저장됩니다. 저희 클라우드에 저장되는 것이 아닙니다.
  • 판매자는 오직 당신에게서만 연락을 받습니다. — 에이전트가 사용자 네트워크에서 직접 API를 호출하므로 Query Streams가 쿼리에 응답하는 데 토큰이 필요하지 않습니다.

알아두면 좋겠네요.

  • 이것은 동기화된 복사본이며, 실시간 프록시가 아닙니다. — 쿼리는 이미 가져온 데이터를 다시 읽기 때문에 SQL 속도로 반환되며 API 사용량 제한을 초과하지 않습니다. 또한 선택한 테이블은 읽는 즉시 오래된 행을 새로 고칠 수 있습니다.
  • 요금 제한이 준수됩니다. 각 커넥터는 공급업체가 게시한 제한 범위 내에서 안정적으로 작동하므로, 보고서로 인해 해당 커넥터를 사용하는 다른 모든 서비스에 대한 계정 속도가 제한되는 일은 없습니다.
  • 아무것도 버려지지 않습니다 — 테이블에 이름이 지정되지 않은 필드는 raw_data JSON 열에 저장되므로 해당 열을 쿼리할 수 있습니다.
  • 데이터베이스에 연결하세요 — 동일한 명령문에서 API 테이블과 SQL Server 테이블을 함께 사용하는 것은 일반적인 쿼리일 뿐, 통합 프로젝트가 아닙니다.

크로스 소스 SQL

Google Ads 데이터를 다른 데이터와 통합하세요

지출은 구글 광고에서 발생하고 수익은 완전히 다른 곳에서 발생하기 때문에 일반적으로 한 달에 한 번 스프레드시트에서 두 항목을 대조합니다. 하나의 명세서에서 캠페인, 해당 캠페인을 통해 발생한 계정, 그리고 청구서 정보를 모두 확인할 수 있습니다. 각 소스는 자신이 처리할 수 있는 부분만 실행하고 결과를 전송하며, 모든 데이터는 중앙에서 통합됩니다. 소스 간의 직접적인 데이터 교환은 없으며, 어떤 정보도 복사되지 않습니다.

3개의 연결 · 3명의 에이전트

구글 광고 광고
PostgreSQL 관계형 엔진
스트라이프 결제 및 청구

한 가지 진술

-- 구글 광고 지출, 데이터베이스 계정, 스트라이프 수익
선택   g.campaign_name, SUM(g.cost_micros) / 1000000 AS spend, SUM(i.amount_due) AS invoiced
FROM     광고.gads.캠페인1       g
JOIN     pg_crm.공개.고객2 c ON c.utm_campaign = g.campaign_name
JOIN     청구.stripe.invoices3 i ON i.customer = c.stripe_id
그룹 기준 g.캠페인_이름
주문 기준 청구서 발행 DESC;

세 가지 요소는 연결, 스키마, 테이블이며, 연결 이름은 사용자가 지정한 대로 지정할 수 있습니다. 예시 열은 예시일 뿐이며, 테이블은 사용자가 직접 지정해야 합니다. 비용은 Google Ads API에서 보고하는 대로 마이크로초 단위로 제공되므로, 계산은 사용자가 직접 해야 하며 반올림된 값은 없습니다. 모든 항목은 읽기 전용으로 처리되며, SELECT, WITH, EXPLAIN 문만 사용 가능하고, 단일 쿼리에 대해 특정 소스에서 제공할 수 있는 데이터 양에는 상한선이 있습니다. 연합 쿼리의 작동 방식

연결 정보

구글 광고에 필요한 것

입증
도메인 전체 위임 권한이 있는 Google 서비스 계정 키, 개발자 토큰, 그리고 해당 토큰이 사용하는 이메일 주소. 이 모든 정보는 에이전트에 저장됩니다.
계정
고객 ID와 하위 계정에 접근하기 위한 선택적 관리자 계정 ID가 필요합니다.
손을 뻗었다
사용자 네트워크에서 Google Ads API까지 HTTPS 연결을 사용합니다. 수신 측에서는 아무런 연결이 없습니다.
스키마
gads — 그래서 gads.campaign, gads.search_term_view
테이블
12개의 옵션 중 7개는 기본적으로 활성화되어 있습니다. 해당 옵션은 고객, 캠페인, 광고 그룹, 키워드 보기, 검색어 보기, 지역 보기, 기기 보기입니다.
돈
API에서 보고하는 마이크로 단위는 통화 변환을 위해 백만으로 나누면 됩니다.
선도
어제까지의 데이터를 실행합니다. 각 단계별 실행은 이전 3일간의 데이터를 다시 읽어오므로 늦게 발생한 변환도 반영됩니다.
역사
최초 동기화 시 90일 동안의 변경 내역이 저장됩니다. Google은 변경 내역을 29일로 제한합니다.
로컬 복사본
에이전트 옆에 있는 AES-256-GCM으로 암호화된 DuckDB 파일이 사용자 컴퓨터에 있습니다.

읽기 전용은 구조적인 문제입니다. 커넥터는 Google의 검색 쿼리만 실행하며, 변형(mutate) 호출은 전혀 포함하지 않으므로 쿼리를 통해 입찰가를 변경하거나 캠페인을 일시 중지하거나 비용을 지출할 수 없습니다.

크로스 소스 쿼리에서 3부분 참조의 중간 부분은 gads입니다. campaign 테이블을 읽는 ads라는 연결은 ads.gads.campaign으로 작성됩니다.

공급업체 문서: 광고.구글.com

자주 묻는 질문

구글 광고 관련 질문

쿼리 스트림을 통해 Google Ads 데이터를 읽을 수 있는 도구는 무엇인가요?

Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 도구를 하나의 연결로 이용할 수 있습니다. 계정을 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.

구글 광고 계정에 접근하려면 방화벽 포트를 열어야 하나요?

아니요. Query Streams 네트워크 에이전트는 네트워크 내부에서 실행되며 암호화된 외부 연결을 하나만 설정합니다. 수신 트래픽을 수신하는 기능은 없으며 VPN도 필요하지 않고 계정은 기존 방화벽 규칙을 그대로 유지합니다.

쿼리 스트림을 통해 Google Ads의 데이터를 변경할 수 있나요?

아니요. 에이전트는 실행 시점에 읽기 전용을 적용합니다. 즉, 한 번에 하나의 문장만 처리하며, SELECT 및 관련 문만 사용 가능합니다. 자격 증명은 에이전트에 저장되며 쿼리 스트림으로 전송되지 않습니다.

Query Streams가 Google Ads에 연결하려면 무엇이 필요합니까?

접근 가능한 호스트, 역할 및 해당 암호 — 에이전트가 드라이버를 보유하므로 계정에 아무것도 설치되지 않습니다. 인증: 도메인 전체 위임이 있는 Google 서비스 계정 키, 개발자 토큰 및 해당 토큰이 사용하는 이메일 주소. 이 모든 정보는 에이전트에 저장됩니다. 계정: 고객 ID와 하위 계정에 접근하기 위한 선택적 관리자 계정 ID. 접근 경로: 네트워크에서 Google Ads API까지 HTTPS를 통해 연결됩니다. 인바운드 트래픽은 없습니다. 스키마: gads — 따라서 gads.campaign, gads.search_term_view와 같습니다.

Google Ads를 다른 데이터베이스와 동일한 쿼리로 연결할 수 있나요?

네, 맞습니다. 연합 쿼리입니다. 하나의 문장으로 Google Ads와 다른 연결을 동시에 참조할 수 있으며, 연결 스키마 테이블 형식으로 작성됩니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 다시 스트리밍합니다. 조인은 중앙에서 이루어지므로 소스 간에 직접 연결되지 않으며, 데이터 복사나 예약 실행도 없습니다. 모든 부분에는 읽기 전용(SELECT, WITH, EXPLAIN만 해당)이 적용되며, 단일 쿼리에 대해 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 요금제 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.

업무가 이루어지는 곳에 Google 광고를 배치하세요.

에이전트를 설치하고, 계정을 지정한 다음, 목적지를 선택하세요.

무료로 시작하세요 모든 커넥터

읽기 전용 출국 전용 자격 증명은 에이전트에 저장됩니다.