문서
Data Studio: AutoPSEO 데이터로 리포트 만들기
AutoPSEO는 자체 Data Studio 커넥터를 제공하지 않습니다. Google의 Search Console 커넥터, CSV 업로드, 또는 REST API로 최신 상태를 유지하는 Google Sheet를 사용하세요.
AutoPSEO는 Data Studio(이전 이름은 Looker Studio인 Google의 대시보드 도구)용 커넥터를 제공하지 않습니다. 그래도 세 가지 방법으로 AutoPSEO의 수치를 Data Studio에서 차트로 만들 수 있습니다. 원본 데이터는 Google의 Search Console 커넥터로 가져오고, AutoPSEO 리포트에서 내보낸 CSV를 업로드하거나, 예약 실행되는 스크립트가 AutoPSEO의 REST API로 채워 넣는 Google Sheet를 연결하는 방식입니다. 어떤 방법이 맞는지는 대시보드가 얼마나 최신이어야 하는지, 그리고 AutoPSEO의 분석 결과가 필요한지 아니면 원본 지표만 있으면 되는지에 따라 달라집니다.
옵션 1: Google의 Search Console 커넥터
Google의 커넥터는 Search Console에서 데이터를 직접 읽어 오므로 원본 지표만 제공하고 AutoPSEO의 분석은 포함하지 않습니다. Google의 커넥터 안내에 따르면 다음과 같습니다.
- Site Impression과 URL Impression의 두 테이블을 제공하며, 데이터 소스 하나는 둘 중 하나만 사용합니다. 두 테이블을 모두 보여 주려면 리포트에 데이터 소스를 두 개 추가하세요.
- 두 제품 모두에 같은 Google 계정으로 로그인해야 하며, 해당 Search Console 속성에 대해 최소한 보기 권한이 있어야 합니다.
- Site Impression은 웹, 이미지, 동영상, 뉴스 결과를 다루고, URL Impression은 여기에 Discover와 Google News를 더합니다.
추가하려면 Create → Data Source → Search Console을 선택한 다음 사이트, 테이블, 기본 검색 유형을 고르고 Connect를 누르세요.
옵션 2: AutoPSEO에서 CSV 업로드
일회성 또는 월간 대시보드라면 어떤 리포트에서든 표를 내보내고(데이터 내보내기) Data Studio의 CSV 파일 업로드 커넥터로 추가하세요. 내보내는 방식은 Google의 업로드 요건에 따라 정해집니다.
- 필드는 쉼표로 구분해야 하므로 먼저 Account → CSV export format을 Standard (US / UK)로 설정하세요.
- 파일은 UTF-8이어야 하고 머리글 행이 있어야 하는데, AutoPSEO의 내보내기 파일은 이 조건을 충족합니다.
- 하나의 데이터 세트에 추가하는 모든 파일은 열의 구성과 순서가 완전히 같아야 합니다. 따라서 매번 같은 리포트를 같은 열과 같은 비교 설정으로 내보내세요.
- 새 파일은 기존 데이터 뒤에 추가되며 중복은 제거되지 않으므로, 날짜 범위가 겹치는 파일은 업로드하지 마세요.
- 파일 하나는 최대 100 MB이고, 사용자당 업로드 저장 공간은 2 GB입니다.
백분율은 퍼센트 기호가 붙은 채로(27.03%) 내보내지므로, 업로드한 뒤에 필드 유형을 확인하세요.
옵션 3: REST API로 채우는 Google Sheet
스스로 최신 상태를 유지하는 대시보드가 필요하다면, 예약 실행되는 작업이 AutoPSEO의 수치를 Google Sheet에 기록하게 하고 그 시트를 연결하세요. Google의 Sheets 커넥터는 리포트가 쿼리할 때마다 변경된 값과 새 행이 있는지 확인합니다.
- AutoPSEO에서 MCP & API를 열고 Read only 범위의 API 키를 만드세요. 키는 한 번만 표시되므로 작업의 시크릿에 저장해 두세요.
- 예약 실행되는 작업(Google Apps Script, cron 작업 또는 워크플로 도구)에서 REST API를 호출해 행을 시트에 기록하세요.
- Data Studio에서 Google Sheets 커넥터로 시트를 추가하고 Use first row as headers를 선택하세요.
최근 28일간의 상위 쿼리를 가져오는 호출은 다음과 같습니다.
curl -s "https://app.autopseo.com/v1/properties/sc-domain%3Aexample.com/queries?range=28d&limit=1000" \
-H "Authorization: Bearer apk_live_..."응답은 모두 JSON이며, 결과는 data에, 호출에 관한 세부 정보는 meta에 담깁니다. REST API는 MCP 서버와 동일한 19개의 Search Console 및 GA4 도구를 제공합니다. 속성, 검색 애널리틱스 행, 상위 쿼리·페이지·국가, 기간 비교, 순위 변동, 신규 및 소실 순위, 콘텐츠 감소, 키워드 카니발라이제이션, CTR 벤치마크, 페이지 포칭, URL 검사, 사이트맵, 주석, 그리고 GA4 개요·세부 분석·주요 이벤트가 여기에 해당합니다. 상위 쿼리와 상위 페이지는 최대 1,000개 행, 상위 국가는 최대 300개 행을 반환하며, search-analytics는 차원이 하나 또는 두 개일 때 최대 5,000개의 원본 행을 반환합니다. 호출은 키당 분당 60회, 계정당 시간당 1,000회로 제한되며, https://app.autopseo.com/v1/openapi.json의 OpenAPI 3.1 문서에 모든 매개변수가 설명되어 있습니다.
어떤 옵션을 선택할까
| 필요한 것 | 사용할 방법 |
|---|---|
| Google이 최신 상태로 유지하는 원본 클릭 수와 노출 수 | Google의 Search Console 커넥터 |
| AutoPSEO 리포트 하나의 월간 스냅샷 | CSV 업로드 |
| 순위 변동이나 감소 같은 AutoPSEO의 분석을 일정에 따라 제공 | REST API로 채우는 Google Sheet |
대시보드의 주된 목적이 고객에게 수치를 보여 주는 것이라면 공유 리포트 링크나 예약된 Slack 또는 Teams 리포트가 더 수월할 수 있습니다. Google의 커넥터에 대해서는 Looker Studio의 Search Console FAQ에서 더 자세히 다룹니다.