성과 API (1.0)
Download OpenAPI specification:Download
사외용 성과 조회는 다음 두 조회 계층으로 구분됩니다.
- 소재 계층: 광고 계정 → 캠페인 → 광고 그룹 → 소재
- 애셋 그룹 계층: 광고 계정 → 캠페인 → 애셋 그룹
과거 성과는 다음 두 조회 계층으로 구분해 조회합니다.
- 소재 계층: 광고 계정 → 캠페인 → 광고 그룹 → 소재
- 애셋 그룹 계층: 광고 계정 → 캠페인 → 애셋 그룹
조회 단위보다 하위 요소로 집계한 결과가 제공되며, 성과는 날짜, 시간별 조회 시 시간, 요청한 집계 단위 번호 순으로 오름차순 정렬되어 제공됩니다.
조회 기간은 최대 31일이며, 2년 전부터 전일 데이터까지 조회가 가능합니다. (전일 데이터는 금일 02시부터 조회가 가능합니다.)
한 번에 최대 1000개 까지 조회가 가능하며, 이를 초과하는 개수가 존재하는 경우 페이징이 적용됩니다. 응답의 next 필드 값을 다음 요청의 next 파라미터로 포함시키면 다음 페이지를 조회할 수 있으며, 해당 토큰은 10분간 유효합니다.
애셋 그룹(assetGroups) 단위 조회 시 vplayCount 는 항상 0 입니다.
광고 계정 과거 성과 조회
특정 광고 계정의 과거 성과를 캠페인, 광고 그룹, 소재 또는 애셋 그룹 단위로 집계하여 조회합니다.
path Parameters
| aggregationType required | string Enum: "campaigns" "adSets" "creatives" "assetGroups" 성과 집계 단위 ( 캠페인 : campaigns, 광고 그룹 : adSets, 소재 : creatives, 애셋 그룹 : assetGroups ) |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| startDate required | string <date> Example: startDate=2023-01-01 조회 시작일 (yyyy-MM-dd 형식) |
| endDate required | string <date> Example: endDate=2023-01-30 조회 종료일 (yyyy-MM-dd 형식) |
| next | string Example: next=zwMvjK6XRhyiJoFGZZkqhw:1707978058060 다음 페이지 조회를 위한 토큰 |
| limit | int Default: "1000" 조회할 레코드 수 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "next": "string"
}소재 과거 성과 조회
특정 소재의 과거 성과를 조회합니다.
path Parameters
| creativeNo required | integer <int64> Example: 5678 소재 번호 |
| aggregationType required | string Value: "creatives" 성과 집계 단위 ( 소재 : creatives ) |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| startDate required | string <date> Example: startDate=2023-01-01 조회 시작일 (yyyy-MM-dd 형식) |
| endDate required | string <date> Example: endDate=2023-01-30 조회 종료일 (yyyy-MM-dd 형식) |
| next | string Example: next=zwMvjK6XRhyiJoFGZZkqhw:1707978058060 다음 페이지 조회를 위한 토큰 |
| limit | int Default: "1000" 조회할 레코드 수 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "next": "string"
}캠페인 과거 성과 조회
특정 캠페인의 과거 성과를 광고 그룹, 소재 또는 애셋 그룹 단위로 집계하여 조회합니다.
path Parameters
| campaignNo required | integer <int64> Example: 5678 캠페인 번호 |
| aggregationType required | string Enum: "adSets" "creatives" "assetGroups" 성과 집계 단위 ( 광고 그룹 : adSets, 소재 : creatives, 애셋 그룹 : assetGroups ) |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| startDate required | string <date> Example: startDate=2023-01-01 조회 시작일 (yyyy-MM-dd 형식) |
| endDate required | string <date> Example: endDate=2023-01-30 조회 종료일 (yyyy-MM-dd 형식) |
| next | string Example: next=zwMvjK6XRhyiJoFGZZkqhw:1707978058060 다음 페이지 조회를 위한 토큰 |
| limit | int Default: "1000" 조회할 레코드 수 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "next": "string"
}광고 그룹 과거 성과 조회
특정 광고 그룹의 과거 성과를 소재 단위로 집계하여 조회합니다.
path Parameters
| adSetNo required | integer <int64> Example: 5678 광고 그룹 번호 |
| aggregationType required | string Value: "creatives" 성과 집계 단위 ( 소재 : creatives ) |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| startDate required | string <date> Example: startDate=2023-01-01 조회 시작일 (yyyy-MM-dd 형식) |
| endDate required | string <date> Example: endDate=2023-01-30 조회 종료일 (yyyy-MM-dd 형식) |
| next | string Example: next=zwMvjK6XRhyiJoFGZZkqhw:1707978058060 다음 페이지 조회를 위한 토큰 |
| limit | int Default: "1000" 조회할 레코드 수 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "next": "string"
}애셋 그룹 과거 성과 조회
특정 애셋 그룹의 과거 성과를 조회합니다.
path Parameters
| assetGroupNo required | integer <int64> Example: 5678 애셋 그룹 번호 |
| aggregationType required | string Value: "assetGroups" 성과 집계 단위 ( 애셋 그룹 : assetGroups ) |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| startDate required | string <date> Example: startDate=2023-01-01 조회 시작일 (yyyy-MM-dd 형식) |
| endDate required | string <date> Example: endDate=2023-01-30 조회 종료일 (yyyy-MM-dd 형식) |
| next | string Example: next=zwMvjK6XRhyiJoFGZZkqhw:1707978058060 다음 페이지 조회를 위한 토큰 |
| limit | int Default: "1000" 조회할 레코드 수 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "next": "string"
}실시간 성과는 다음 두 조회 계층으로 구분해 조회합니다.
- 소재 계층: 광고 계정 → 캠페인 → 광고 그룹 → 소재
- 애셋 그룹 계층: 광고 계정 → 캠페인 → 애셋 그룹
오늘 또는 어제 데이터를 조회할 수 있으며, 성과는 업데이트 시점을 기준으로 오름차순 정렬되어 제공됩니다.
응답의 until 필드 값을 다음 요청의 since 파라미터로 포함시키면 이전 응답의 until 이후에 업데이트된 성과만 조회할 수 있습니다.
실시간 성과는 조회 시점 이후라도 정합성 검증 및 보정 작업에 따라 변동이 발생할 수 있습니다.
애셋 그룹(assetGroups) 단위 조회 시 vplayCount 는 항상 0 입니다.
광고 계정 실시간 성과 조회
특정 광고 계정의 실시간 성과를 소재 단위로 조회합니다.
path Parameters
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "until": 1675907423000
}소재 실시간 성과 조회
특정 소재의 실시간 성과를 조회합니다.
path Parameters
| creativeNo required | integer <int64> Example: 5678 소재 번호 |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "until": 1675907423000
}캠페인 실시간 성과 조회
특정 캠페인의 실시간 성과를 소재 단위로 조회합니다.
path Parameters
| campaignNo required | integer <int64> Example: 5678 캠페인 번호 |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "until": 1675907423000
}광고 그룹 실시간 성과 조회
특정 광고 그룹의 실시간 성과를 소재 단위로 조회합니다.
path Parameters
| adSetNo required | integer <int64> Example: 5678 광고 그룹 번호 |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "until": 1675907423000
}캠페인 실시간 성과 조회 (애셋 그룹)
특정 캠페인의 실시간 성과를 애셋 그룹 단위로 조회합니다.
path Parameters
| campaignNo required | integer <int64> Example: 5678 캠페인 번호 |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "until": 1675907423000
}광고 계정 실시간 성과 조회 (애셋 그룹)
특정 광고 계정의 실시간 성과를 애셋 그룹 단위로 조회합니다.
path Parameters
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "until": 1675907423000
}애셋 그룹 실시간 성과 조회
특정 애셋 그룹의 실시간 성과를 조회합니다.
path Parameters
| assetGroupNo required | integer <int64> Example: 5678 애셋 그룹 번호 |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
| timeUnit | string Default: "daily" Enum: "daily" "hourly" 조회 시간 단위 ( 일자별 : daily, 시간별 : hourly ) |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "hour": "string",
- "impCount": 0,
- "clickCount": 0,
- "vplayCount": 0,
- "sales": 0.1
}
], - "until": 1675907423000
}과거 전환 성과는 다음 두 조회 계층으로 구분해 조회합니다.
- 소재 계층: 광고 계정 → 캠페인 → 광고 그룹 → 소재
- 애셋 그룹 계층: 광고 계정 → 캠페인 → 애셋 그룹
조회 단위보다 하위 요소로 집계한 결과가 제공되며, 성과는 날짜, 요청한 집계 단위 번호, 전환 유형 순으로 오름차순 정렬되어 제공됩니다.
조회 기간은 최대 31일이며, 2년 전부터 전일 데이터까지 조회가 가능합니다. (전일 데이터는 금일 02시부터 조회가 가능합니다.)
한 번에 최대 1000개 까지 조회가 가능하며, 이를 초과하는 개수가 존재하는 경우 페이징이 적용됩니다. 응답의 next 필드 값을 다음 요청의 next 파라미터로 포함시키면 다음 페이지를 조회할 수 있으며, 해당 토큰은 10분간 유효합니다.
전환 성과는 시간 단위 조회를 지원하지 않으며 일별 조회만 가능하며, 응답의 convType 필드에 대한 설명은 '시작하기 > 성과 관리 > 전환 성과 조회' 페이지를 참고해주세요.
광고 계정 과거 전환 성과 조회
특정 광고 계정의 과거 전환 성과를 캠페인, 광고 그룹, 소재 또는 애셋 그룹 단위로 집계하여 조회합니다.
path Parameters
| aggregationType required | string Enum: "campaigns" "adSets" "creatives" "assetGroups" 성과 집계 단위 ( 캠페인 : campaigns, 광고 그룹 : adSets, 소재 : creatives, 애셋 그룹 : assetGroups ) |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| startDate required | string <date> Example: startDate=2023-01-01 조회 시작일 (yyyy-MM-dd 형식) |
| endDate required | string <date> Example: endDate=2023-01-30 조회 종료일 (yyyy-MM-dd 형식) |
| next | string Example: next=zwMvjK6XRhyiJoFGZZkqhw:1707978058060 다음 페이지 조회를 위한 토큰 |
| limit | int Default: "1000" 조회할 레코드 수 |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "next": "string"
}소재 과거 전환 성과 조회
특정 소재의 과거 전환 성과를 조회합니다.
path Parameters
| creativeNo required | integer <int64> Example: 5678 소재 번호 |
| aggregationType required | string Value: "creatives" 성과 집계 단위 ( 소재 : creatives ) |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| startDate required | string <date> Example: startDate=2023-01-01 조회 시작일 (yyyy-MM-dd 형식) |
| endDate required | string <date> Example: endDate=2023-01-30 조회 종료일 (yyyy-MM-dd 형식) |
| next | string Example: next=zwMvjK6XRhyiJoFGZZkqhw:1707978058060 다음 페이지 조회를 위한 토큰 |
| limit | int Default: "1000" 조회할 레코드 수 |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "next": "string"
}캠페인 과거 전환 성과 조회
특정 캠페인의 과거 전환 성과를 광고 그룹, 소재 또는 애셋 그룹 단위로 집계하여 조회합니다.
path Parameters
| campaignNo required | integer <int64> Example: 5678 캠페인 번호 |
| aggregationType required | string Enum: "adSets" "creatives" "assetGroups" 성과 집계 단위 ( 광고 그룹 : adSets, 소재 : creatives, 애셋 그룹 : assetGroups ) |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| startDate required | string <date> Example: startDate=2023-01-01 조회 시작일 (yyyy-MM-dd 형식) |
| endDate required | string <date> Example: endDate=2023-01-30 조회 종료일 (yyyy-MM-dd 형식) |
| next | string Example: next=zwMvjK6XRhyiJoFGZZkqhw:1707978058060 다음 페이지 조회를 위한 토큰 |
| limit | int Default: "1000" 조회할 레코드 수 |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "next": "string"
}광고 그룹 과거 전환 성과 조회
특정 광고 그룹의 과거 전환 성과를 소재 단위로 집계하여 조회합니다.
path Parameters
| adSetNo required | integer <int64> Example: 5678 광고 그룹 번호 |
| aggregationType required | string Value: "creatives" 성과 집계 단위 ( 소재 : creatives ) |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| startDate required | string <date> Example: startDate=2023-01-01 조회 시작일 (yyyy-MM-dd 형식) |
| endDate required | string <date> Example: endDate=2023-01-30 조회 종료일 (yyyy-MM-dd 형식) |
| next | string Example: next=zwMvjK6XRhyiJoFGZZkqhw:1707978058060 다음 페이지 조회를 위한 토큰 |
| limit | int Default: "1000" 조회할 레코드 수 |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "next": "string"
}애셋 그룹 과거 전환 성과 조회
특정 애셋 그룹의 과거 전환 성과를 조회합니다.
path Parameters
| assetGroupNo required | integer <int64> Example: 5678 애셋 그룹 번호 |
| aggregationType required | string Value: "assetGroups" 성과 집계 단위 ( 애셋 그룹 : assetGroups ) |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| startDate required | string <date> Example: startDate=2023-01-01 조회 시작일 (yyyy-MM-dd 형식) |
| endDate required | string <date> Example: endDate=2023-01-30 조회 종료일 (yyyy-MM-dd 형식) |
| next | string Example: next=zwMvjK6XRhyiJoFGZZkqhw:1707978058060 다음 페이지 조회를 위한 토큰 |
| limit | int Default: "1000" 조회할 레코드 수 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "next": "string"
}실시간 전환 성과는 다음 두 조회 계층으로 구분해 조회합니다.
- 소재 계층: 광고 계정 → 캠페인 → 광고 그룹 → 소재
- 애셋 그룹 계층: 광고 계정 → 캠페인 → 애셋 그룹
오늘 또는 어제 데이터를 조회할 수 있으며, 성과는 업데이트 시점을 기준으로 오름차순 정렬되어 제공됩니다.
응답의 until 필드 값을 다음 요청의 since 파라미터로 포함시키면 이전 응답의 until 이후에 업데이트된 성과만 조회할 수 있습니다.
실시간 성과는 조회 시점 이후라도 정합성 검증 및 보정 작업에 따라 변동이 발생할 수 있습니다.
전환 성과는 시간 단위 조회를 지원하지 않으며 일별 조회만 가능하며, 응답의 convType 필드에 대한 설명은 '시작하기 > 성과 관리 > 전환 성과 조회' 페이지를 참고해주세요.
광고 계정 실시간 전환 성과 조회
특정 광고 계정의 실시간 전환 성과를 소재 단위로 조회합니다.
path Parameters
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "until": 1675907423000
}소재 실시간 전환 성과 조회
특정 소재의 실시간 전환 성과를 조회합니다.
path Parameters
| creativeNo required | integer <int64> Example: 5678 소재 번호 |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "until": 1675907423000
}캠페인 실시간 전환 성과 조회
특정 캠페인의 실시간 전환 성과를 소재 단위로 조회합니다.
path Parameters
| campaignNo required | integer <int64> Example: 5678 캠페인 번호 |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "until": 1675907423000
}광고 그룹 실시간 전환 성과 조회
특정 광고 그룹의 실시간 전환 성과를 소재 단위로 조회합니다.
path Parameters
| adSetNo required | integer <int64> Example: 5678 광고 그룹 번호 |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
header Parameters
| AccessManagerAccountNo | integer <int64> 해당 광고 계정의 성과에 대한 접근 권한이 있는 관리 계정 번호 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "until": 1675907423000
}캠페인 실시간 전환 성과 조회 (애셋 그룹)
특정 캠페인의 실시간 전환 성과를 애셋 그룹 단위로 조회합니다.
path Parameters
| campaignNo required | integer <int64> Example: 5678 캠페인 번호 |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "until": 1675907423000
}광고 계정 실시간 전환 성과 조회 (애셋 그룹)
특정 광고 계정의 실시간 전환 성과를 애셋 그룹 단위로 조회합니다.
path Parameters
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "until": 1675907423000
}애셋 그룹 실시간 전환 성과 조회
특정 애셋 그룹의 실시간 전환 성과를 조회합니다.
path Parameters
| assetGroupNo required | integer <int64> Example: 5678 애셋 그룹 번호 |
| version required | number Default: 1 API 버전 |
| adAccountNo required | integer <int64> Example: 1234 광고 계정 번호 |
query Parameters
| timeUnit | string Default: "daily" Value: "daily" 조회 시간 단위 ( 일자별 : daily ) |
| targetDate | string Default: "today" Enum: "today" "yesterday" 조회 대상 일자 ( 오늘 : today, 어제 : yesterday ) |
| since | integer <int64> Example: since=1675907423000 특정 시점 이후 업데이트된 성과만을 조회하기 위한 밀리초 단위 타임스탬프 |
Responses
Response samples
- 200
{- "rows": [
- {
- "campaignNo": 0,
- "adSetNo": 0,
- "creativeNo": 0,
- "assetGroupNo": 0,
- "targetDate": "2019-08-24",
- "convCount": 0,
- "convSales": 0.1,
- "updatedAt": "2019-08-24T14:15:22Z",
- "convType": "string"
}
], - "until": 1675907423000
}