get_performance_report
Read-only
Retrieve aggregated performance reports for Kakao Keyword Ads by account, campaign, ad group, keyword, or creative level to analyze ad metrics and gain insights.
Instructions
레벨 지정 통합 성과 리포트 (KEYWORD 포함). 인사이트 도출용 1급 툴. AD_GROUP/KEYWORD/CREATIVE 레벨은 campaign_id 필수.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | 종료일 yyyyMMdd | |
| level | Yes | 집계 레벨: AD_ACCOUNT | CAMPAIGN | AD_GROUP | KEYWORD | CREATIVE | |
| start | No | 시작일 yyyyMMdd | |
| time_unit | No | 기간 단위(선택): DAY 등. 미지정 시 기간 합계 | |
| adgroup_id | No | 광고그룹 ID (KEYWORD/CREATIVE 선택) | |
| campaign_id | No | 캠페인 ID (AD_GROUP/KEYWORD/CREATIVE 레벨 필수) | |
| date_preset | No | TODAY/YESTERDAY/LAST_7DAY 등 (기간과 택일) | |
| ad_account_id | No | 대상 광고계정 ID (미지정 시 use_account 세션 사용) | |
| metrics_group | No | 지표 그룹(쉼표구분 복수 가능): BASIC/ADDITION/PIXEL_SDK_CONVERSION | BASIC |
| business_token | No | 비즈니스 토큰 (미지정 시 login 세션 사용). override용 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |