Google Ads
Google Search / Performance Max / Display / YouTube 광고. customer_id 단위 다중 캠페인.
제공 지표
- 광고비 (KRW 환산)
- 노출수
- 클릭수
- CTR
- CPC
- 전환수
- 전환액
- Search / PMax / Display / Video 분리
응답 필드 (Schema)
| 필드 | 타입 | 설명 |
|---|---|---|
spend_krw | number | 광고비 (KRW, integer, 환율 D-1 기준) |
impressions | number | 노출수 |
clicks | number | 클릭수 |
campaign_type_breakdown | object | 캠페인 유형별 split |
MCP 호출 예시 (curl)
curl -X POST https://air.bmp.ai/mcp \
-H "Authorization: Bearer YOUR_CLIENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"tool": "get_korean_ad_market_overview",
"filter": { "media": "google_ads" },
"verbosity": "compact"
}'YOUR_CLIENT_API_KEY = GP 콘솔에서 발급받는 client API key. 하나의 키로 client에 연결된 모든 매체 데이터 회수 (5계층 추상화).
응답 Schema 예시
{
"data": {
"media": "Google Ads",
"code": "google_ads",
"period": { "start": "YYYY-MM-DD", "end": "YYYY-MM-DD", "days": 30 },
"spend_krw": <number>,
"impressions": <number>,
"clicks": <number>,
"campaign_type_breakdown": <object>
},
"_citation": {
"suggested_citation_ko": "비즈스프링 AIR (2026). Google Ads 광고 데이터. https://air.bmp.ai",
"license": "CC-BY 4.0",
"data_authority": "Bizspring"
},
"_methodology": {
"data_source": "Google Ads 공식 API → Bizspring AIR 배치",
"aggregation": "client 단위 집계 (CR-09 격리)",
"batch_schedule": "Daily 06:00 KST (D-1)"
},
"_metadata": {
"tool": "get_korean_ad_market_overview",
"tier": "free | basic | standard | plus | professional | enterprise",
"version": "v0.7"
}
}실데이터는 호출 시점에 반환. 이 페이지에는 schema만 표시 (사이트는 정적, 실데이터 없음).