페이지 이동경로
  • 문서>
  • 카카오모먼트>
  • 보고서

카카오모먼트

보고서

이 문서는 카카오모먼트 보고서 API 사용 방법을 안내합니다.

광고계정 보고서 보기

광고계정에 대한 보고서를 조회합니다. 광고계정 보고서는 디스플레이 캠페인, 메시지 캠페인을 포함한 값을 확인할 수 있습니다. 보고서 지표 그룹(metricsGroup)은 복수 선택이 가능합니다.

특정 일자에 해당하는 보고서는 그 다음날 오전 8시 이전까지는 변동 가능한 실시간성 지표로 참고합니다. 오늘(실시간) 보고서가 궁금하다면 datePreset=TODAY를, 시간대별 데이터가 궁금하다면 dimension=HOUR를 사용합니다.

datePreset의 다른 값들, start, end를 이용한 조회에서 오늘 날짜는 제외됩니다.

요청 성공 시 응답은 data 필드 하위에 배열로 보고서 데이터를 포함합니다.

보고서 조회 기준(dimension) 중 연령, 성별, 연령 및 성별, 지역, 디바이스, 게재지면은 디스플레이 타입일 때만 값이 있습니다.

디스플레이 캠페인만 있는 광고계정의 경우 메시지 기본 지표(MESSAGE), 메시지 추가 지표(MESSAGE_ADDITION), 메시지 클릭 지표(MESSAGE_CLICK)를 선택하는 경우 값이 없습니다.

메시지 캠페인만 있는 광고계정의 경우 기본 지표(BASIC), 추가 지표(ADDITION), 카카오친구 지표(PLUS_FRIEND), 픽셀 전환 지표(PIXEL_CONVERSION), SDK 전환 지표(SDK_CONVERSION), 동영상 지표(VIDEO)를 선택하는 경우 값이 없습니다.

이 API는 광고계정 번호, 앱 ID당 5초에 한 번으로 요청이 제한됩니다. 마지막 요청 후 5초 이내로 다시 요청하는 것은 허용되지 않습니다.

Request
URL
GET /openapi/v4/adAccounts/report HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
datePreset DatePreset 사전 정의된 보고서 조회기간
TODAY, YESTERDAY...
X
timeUnit TimeUnit 보고서 집계단위 (default : DAY)
시간대별 조회는 dimension 필드의 HOUR를 이용하여 확인가능합니다.
보고서 집계단위(timeUnit)에 따라 조회할 수 있는 최대 기간이 다릅니다.
DAY
X
start String 보고서 조회기간 (시작일 (yyyyMMdd))
start, end 둘중에 하나라도 null이면 datePreset 기준으로 조회됩니다.
datePreset도 명시되지 않았다면 datePreset 중 TODAY 기준으로 조회됩니다.
시작일은 조회일 전일까지 설정 가능합니다.
X
end String 보고서 조회기간 (종료일 (yyyyMMdd))
종료일은 시작일부터 조회일 전일까지 설정 가능합니다.
X
level Dimension 보고서 조회 레벨 기준 (default: AD_ACCOUNT)
보고서 조회시 데이터가 그룹화 될 레벨 기준을 지정합니다.
광고계정 레벨의 보고서에서는 광고계정 혹은 광고계정 하위의 캠페인별 보고서 조회가 가능합니다.
AD_ACCOUNT, CAMPAIGN
O
dimension Dimension 보고서 조회 기준
보고서 조회시 데이터가 그룹화 될 기준을 지정합니다.
CREATIVE_FORMAT, PLACEMENT, AGE, GENDER, AGE_GENDER, LOCATION, DEVICE_TYPE, HOUR
X
metricsGroup MetricsGroup 보고서 지표 그룹
보고서 조회 지표들을 지정합니다.
기본값 : BASIC
지표 그룹별 상세 지표리스트는 MetricGroup 정의 테이블을 참조해주세요.
BASIC, ADDITION, MESSAGE, MESSAGE_ADDITION, MESSAGE_CLICK, PLUS_FRIEND, PIXEL_CONVERSION, SDK_CONVERSION, VIDEO
O
Response
Key Type Description
code Integer 응답 코드
message String 결과 안내 메시지
data Data[] 각 보고서 상세 데이터
Data
Key Type Description
start String 시작일 (yyyyMMdd)
end String 종료일 (yyyyMMdd)
dimensions Dimension 보고서 기준과 값
metrics Metrics 보고서 지표와 값
Sample
Request: datePreset 지정
curl -X GET "https://apis.moment.kakao.com/openapi/v4/adAccounts/report?datePreset=TODAY&level=AD_ACCOUNT&dimension=CREATIVE_FORMAT&metricsGroup=BASIC" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Request: datePreset 미지정
curl -X GET "https://apis.moment.kakao.com/openapi/v4/adAccounts/report?start=20200101&end=20200101&level=AD_ACCOUNT&dimension=CREATIVE_FORMAT&metricsGroup=BASIC" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response: 요청 성공
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "start": "2020-01-01",
            "end": "2020-01-01",
            "dimensions": {
                "creative_format": "IMAGE BANNER",
                "ad_account_id": "1234"
            },
            "metrics": {
                "imp": 4,
                "click": 0,
                "ctr": 0.0,
                "cost": 0.0
            }
        }
    ]
}
Response: 보고서 데이터가 없을 경우
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "start": "2020-01-01",
            "end": "2020-01-01",
            "dimensions": {},
            "metrics": {}
        }
    ]
}

광고계정 보고서 여러 개 보기

광고계정에 대한 보고서를 조회합니다.

한번의 요청으로 최대 5개의 광고계정 보고서 조회가 가능하며 디스플레이 캠페인, 메시지 캠페인을 포함한 값을 확인할 수 있습니다. 보고서 지표 그룹(metricsGroup)은 복수 선택이 가능합니다.

이 API는 광고계정 번호, 앱 ID당 5초에 한 번으로 요청이 제한됩니다. 마지막 요청 후 5초 이내로 다시 요청하는 것은 허용되지 않습니다.

조회 기준 파라미터 및 응답 필드에 대한 자세한 설명은 광고계정 보고서 보기를 참고합니다.

Request
URL
GET /openapi/v4/adAccounts/report HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
Parameter
Name Type Description Required
adAccountId Long[] 광고계정 번호
최대 5개까지 한번에 조회가 가능
O
datePreset DatePreset 사전 정의된 보고서 조회기간
TODAY, YESTERDAY...
X
timeUnit TimeUnit 보고서 집계단위 (default : DAY)
시간대별 조회는 dimension 필드의 HOUR를 이용하여 확인가능합니다.
보고서 집계단위(timeUnit)에 따라 조회할 수 있는 최대 기간이 다릅니다.
DAY
X
start String 보고서 조회기간 (시작일 (yyyyMMdd))
start, end 둘중에 하나라도 null이면 datePreset 기준으로 조회됩니다.
datePreset도 명시되지 않았다면 datePreset 중 TODAY 기준으로 조회됩니다.
시작일은 조회일 전일까지 설정 가능합니다.
X
end String 보고서 조회기간 (종료일 (yyyyMMdd))
종료일은 시작일부터 조회일 전일까지 설정 가능합니다.
X
level Dimension 보고서 조회 레벨 기준 (default: AD_ACCOUNT)
보고서 조회시 데이터가 그룹화 될 레벨 기준을 지정합니다.
광고계정 레벨의 보고서에서는 광고계정 혹은 광고계정 하위의 캠페인별 보고서 조회가 가능합니다.
AD_ACCOUNT, CAMPAIGN
O
dimension Dimension 보고서 조회 기준
보고서 조회시 데이터가 그룹화 될 기준을 지정합니다.
CREATIVE_FORMAT, PLACEMENT, AGE, GENDER, AGE_GENDER, LOCATION, DEVICE_TYPE, HOUR
X
metricsGroup MetricsGroup 보고서 지표 그룹
보고서 조회 지표들을 지정합니다.
기본값 : BASIC
지표 그룹별 상세 지표리스트는 MetricGroup 정의 테이블을 참조해주세요.
BASIC, ADDITION, MESSAGE, MESSAGE_ADDITION, MESSAGE_CLICK, PLUS_FRIEND, PIXEL_CONVERSION, SDK_CONVERSION, VIDEO
O
Sample
Request: datePreset 지정
curl -X GET "https://apis.moment.kakao.com/openapi/v4/adAccounts/report?datePreset=TODAY&level=AD_ACCOUNT&dimension=CREATIVE_FORMAT&metricsGroup=BASIC&adAccountId=1,2,3,4,5" \
    -H "Authorization: Bearer {ACCESS_TOKEN}"
Request: datePreset 미지정
curl -X GET "https://apis.moment.kakao.com/openapi/v4/adAccounts/report?start=20200101&end=20200101&level=AD_ACCOUNT&dimension=CREATIVE_FORMAT&metricsGroup=BASIC&adAccountId=1,2,3,4,5" \
    -H "Authorization: Bearer {ACCESS_TOKEN}"
Response: 요청 성공
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "start": "2020-01-01",
            "end": "2020-01-01",
            "dimensions": {
              "creative_format": "IMAGE BANNER",
              "ad_account_id": "1234"
            },
            "metrics": {
              "imp": 4,
              "click": 0,
              "ctr": 0.0,
              "cost": 0.0
            }
        },
        {
            "start": "2020-01-01",
            "end": "2020-01-01",
            "dimensions": {
              "creative_format": "IMAGE BANNER",
              "ad_account_id": "5678",
            },
            "metrics": {
              "imp": 4,
              "click": 0,
              "ctr": 0.0,
              "cost": 0.0
            }
        },
        ...
    ]
}
Response: 보고서 데이터가 없을 경우
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "start": "2020-01-01",
            "end": "2020-01-01",
            "dimensions": {},
            "metrics": {}
        }
    ]
}
주의: 광고계정 보고서

1. 특정일자에 해당하는 보고서는 그 다음날 오전 8시 이전까지는 변동가능한 실시간성 지표로 참고해 주시기 바랍니다. 2. 오늘(실시간) 보고서가 궁금하다면 datePreset=TODAY를 사용합니다. 3. datePreset의 다른 값들, start, end는 오늘 날짜는 제외됩니다. 4. 보고서 집계단위(timeUnit)에 따라 조회할 수 있는 최대 기간이 다릅니다. 보고서 집계단위 : DAY, 조회할 수 있는 최대 기간 : 최대 1개월 5. 시간대별 데이터가 궁금하다면 dimension=HOUR를 사용합니다. 6. 보고서 조회 기준(dimension) 중 연령, 성별, 연령 및 성별, 지역, 디바이스, 게재지면은 디스플레이 타입일 때만 값이 있습니다. 7. 광고계정 보고서는 디스플레이 캠페인, 메시지 캠페인을 포함한 값을 확인할 수 있습니다. 8. 보고서 지표 그룹(metricsGroup)은 복수 선택이 가능합니다. 9. 디스플레이 캠페인만 있는 광고계정의 경우 메시지 기본 지표(MESSAGE), 메시지 추가 지표(MESSAGE_ADDITION), 메시지 클릭 지표(MESSAGE_CLICK)를 선택하는 경우 값이 없습니다. 10. 메시지 캠페인만 있는 광고계정의 경우 기본 지표(BASIC), 추가 지표(ADDITION), 카카오친구 지표(PLUS_FRIEND), 픽셀 전환 지표(PIXEL_CONVERSION), SDK 전환 지표(SDK_CONVERSION), 동영상 지표(VIDEO)를 선택하는 경우 값이 없습니다.

캠페인 보고서 보기

캠페인에 대한 보고서를 조회합니다.

이 API는 광고계정 번호, 앱 ID당 5초에 한 번으로 요청이 제한됩니다. 마지막 요청 후 5초 이내로 다시 요청하는 것은 허용되지 않습니다.

조회 기준 파라미터 및 응답 필드에 대한 자세한 설명은 광고계정 보고서 보기를 참고합니다.

Request
URL
GET /openapi/v4/campaigns/report HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
campaignId Long[] 캠페인 번호
해당 캠페인 번호에 대한 보고서가 조회
최대 5개까지 한번에 조회 가능
O
datePreset DatePreset 사전 정의된 보고서 조회기간
TODAY, YESTERDAY...
X
timeUnit TimeUnit 보고서 집계단위 (default : DAY)
- DAY
시간대별 조회는 dimension 필드의 HOUR를 이용하여 확인가능합니다.
X
start String 보고서 조회기간 (시작일 (yyyyMMdd))
start, end 둘중에 하나라도 null이면 datePreset 기준으로 조회됩니다.
datePreset도 명시되지 않았다면 datePreset 중 TODAY 기준으로 조회됩니다.
시작일은 조회일 전일까지 설정 가능합니다.
X
end String 보고서 조회기간 (종료일 (yyyyMMdd))
종료일은 시작일부터 조회일 전일까지 설정 가능합니다.
X
level Dimension 보고서 조회 레벨 기준 (default: CAMPAIGN)
- CAMPAIGN, AD_GROUP
보고서 조회시 데이터가 그룹화 될 레벨 기준을 지정합니다.
광고계정 레벨의 보고서에서는 광고계정 혹은 광고계정 하위의 캠페인별 보고서 조회가 가능합니다.
O
dimension Dimension 보고서 조회 기준
- CREATIVE_FORMAT, PLACEMENT, AGE, GENDER, AGE_GENDER, LOCATION, DEVICE_TYPE, HOUR
보고서 조회시 데이터가 그룹화 될 기준을 지정합니다.
O
metricsGroup MetricsGroup 보고서 지표 그룹
- BASIC, ADDITION, MESSAGE, MESSAGE_ADDITION, MESSAGE_CLICK, PLUS_FRIEND, PIXEL_CONVERSION, SDK_CONVERSION, VIDEO
보고서 조회 지표들을 지정합니다.
지표 그룹별 상세 지표리스트는 Metric 정의 테이블을 참조해주세요.
X
Sample
Request: datePreset 지정
curl -X GET "https://apis.moment.kakao.com/openapi/v4/campaigns/report?datePreset=TODAY&dimension=CREATIVE_FORMAT&metricsGroup=BASIC&campaignId=11562&level=CAMPAIGN&campaignId=1,2,3,4,5" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Request: datePreset 미지정
curl -X GET "https://apis.moment.kakao.com/openapi/v4/campaigns/report?start=20200101&end=20200101&dimension=CREATIVE_FORMAT&metricsGroup=BASIC&campaignId=11562&level=CAMPAIGN&campaignId=1,2,3,4,5" \
    -H "Authorization: Bearer {ACCESS_TOKEN}"
    -H "adAccountId: {adAccountId}"
Response: 요청 성공
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "start": "2020-01-01",
            "end": "2020-01-01",
            "dimensions": {
                "creative_format": "IMAGE BANNER",
                "campaign_id": "1234"
            },
            "metrics": {
                "imp": 4,
                "click": 0,
                "ctr": 0.0,
                "cost": 0.0
            }
        },
        {
        }
    ]
}
Response: 보고서 데이터가 없을 경우
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "start": "2020-01-01",
            "end": "2020-01-01",
            "dimensions": {},
            "metrics": {}
        }
    ]
}
주의: 캠페인 보고서

1. 디스플레이 캠페인은 메시지 기본 지표(MESSAGE), 메시지 추가 지표(MESSAGE_ADDITION), 메시지 클릭 지표(MESSAGE_CLICK)를 선택하는 경우 값이 없습니다. 2. 메시지 캠페인은 기본 지표(BASIC), 추가 지표(ADDITION), 카카오친구 지표(PLUS_FRIEND), 픽셀 전환 지표(PIXEL_CONVERSION), SDK 전환 지표(SDK_CONVERSION), 동영상 지표(VIDEO)를 선택하는 경우 값이 없습니다. 3. 그 외 자세한 설명은 광고계정 보고서 조회를 참고합니다.

광고그룹 보고서 보기

광고그룹 보고서를 조회합니다.

이 API는 광고계정 번호, 앱 ID당 10초에 한 번으로 요청이 제한됩니다. 마지막 요청 후 10초 이내로 다시 요청하는 것은 허용되지 않습니다.

조회 기준 파라미터 및 응답 필드에 대한 자세한 설명은 광고계정 보고서 보기를 참고합니다.

Request
URL
GET /openapi/v4/adGroups/report HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
adGroupId Long[] 광고그룹 번호
해당 광고그룹 번호에 대한 보고서가 조회
최대 20개까지 조회 가능
O
datePreset DatePreset 사전 정의된 보고서 조회기간
- TODAY, YESTERDAY...
X
timeUnit TimeUnit 보고서 집계단위 (default : DAY)
- DAY
시간대별 조회는 dimension 필드의 HOUR를 이용하여 확인가능합니다.
X
start String 보고서 조회기간 (시작일 (yyyyMMdd))
start, end 둘중에 하나라도 null이면 datePreset 기준으로 조회됩니다.
datePreset도 명시되지 않았다면 datePreset 중 TODAY 기준으로 조회됩니다.
시작일은 조회일 전일까지 설정 가능합니다.
X
end String 보고서 조회기간 (종료일 (yyyyMMdd))
종료일은 시작일부터 조회일 전일까지 설정 가능합니다.
X
level Dimension 보고서 조회 레벨 기준 (default: AD_GROUP)
- AD_GROUP, CREATIVE
보고서 조회시 데이터가 그룹화 될 레벨 기준을 지정합니다.
광고계정 레벨의 보고서에서는 광고계정 혹은 광고계정 하위의 캠페인별 보고서 조회가 가능합니다.
O
dimension Dimension 보고서 조회 기준
- CREATIVE_FORMAT, PLACEMENT, AGE, GENDER, AGE_GENDER, LOCATION, DEVICE_TYPE, HOUR
보고서 조회시 데이터가 그룹화 될 기준을 지정합니다.
O
metricsGroup MetricsGroup 보고서 지표 그룹
- BASIC, ADDITION, MESSAGE, MESSAGE_ADDITION, MESSAGE_CLICK, PLUS_FRIEND, PIXEL_CONVERSION, SDK_CONVERSION, VIDEO
보고서 조회 지표들을 지정합니다.
지표 그룹별 상세 지표리스트는 Metric 정의 테이블을 참조해주세요.
X
Sample
Request: datePreset 지정
curl -X GET "https://apis.moment.kakao.com/openapi/v4/adGroups/report?datePreset=TODAY&level=AD_GROUP&dimension=CREATIVE_FORMAT&metricsGroup=BASIC&adGroupId=15970&adGroupId=1,2,3,4,5" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Request: datePreset 미지정
curl -X GET "https://apis.moment.kakao.com/openapi/v4/adGroups/report?start=20200501&end=20200501&level=AD_GROUP&dimension=CREATIVE_FORMAT&metricsGroup=BASIC&adGroupId=15970&adGroupId=1,2,3,4,5" \
    -H "Authorization: Bearer {ACCESS_TOKEN}"
    -H "adAccountId: {adAccountId}"
Response: 요청 성공
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "start": "2020-01-01",
            "end": "2020-01-01",
            "dimensions": {
                "creative_format": "IMAGE BANNER",
                "ad_group_id": "1234"
            },
            "metrics": {
                "imp": 4,
                "click": 0,
                "ctr": 0.0,
                "cost": 0.0
            }
        }
    ]
}
Response: 보고서 데이터가 없을 경우
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "start": "2020-01-01",
            "end": "2020-01-01",
            "dimensions": {},
            "metrics": {}
        }
    ]
}
주의: 광고그룹 보고서

1. 디스플레이 광고그룹은 메시지 기본 지표(MESSAGE), 메시지 추가 지표(MESSAGE_ADDITION), 메시지 클릭 지표(MESSAGE_CLICK)를 선택하는 경우 값이 없습니다. 2. 메시지 광고그룹은 기본 지표(BASIC), 추가 지표(ADDITION), 카카오친구 지표(PLUS_FRIEND), 픽셀 전환 지표(PIXEL_CONVERSION), SDK 전환 지표(SDK_CONVERSION), 동영상 지표(VIDEO)를 선택하는 경우 값이 없습니다. 3. 그 외 자세한 설명은 광고계정 보고서 조회를 참고합니다.

소재 보고서 보기

소재 보고서를 조회합니다. 한번의 요청으로 최대 100개의 소재 보고서 조회가 가능합니다.

이 API는 광고계정 번호, 앱 ID당 10초에 한 번으로 요청이 제한됩니다. 마지막 요청 후 10초 이내로 다시 요청하는 것은 허용되지 않습니다.

조회 기준 파라미터 및 응답 필드에 대한 자세한 설명은 광고계정 보고서 보기를 참고합니다.

Request
URL
GET /openapi/v4/creatives/report HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
creativeId Long[] 소재 번호
해당 광고소재 번호에 대한 보고서가 조회
최대 100개까지 조회 가능
O
datePreset DatePreset 사전 정의된 보고서 조회기간
- TODAY, YESTERDAY...
X
timeUnit TimeUnit 보고서 집계단위 (default : DAY)
- DAY
시간대별 조회는 dimension 필드의 HOUR를 이용하여 확인가능합니다.
X
start String 보고서 조회기간 (시작일 (yyyyMMdd))
start, end 둘중에 하나라도 null이면 datePreset 기준으로 조회됩니다.
datePreset도 명시되지 않았다면 datePreset 중 TODAY 기준으로 조회됩니다.
시작일은 조회일 전일까지 설정 가능합니다.
X
end String 보고서 조회기간 (종료일 (yyyyMMdd))
종료일은 시작일부터 조회일 전일까지 설정 가능합니다.
X
dimension Dimension 보고서 조회 기준
- CREATIVE_FORMAT, PLACEMENT, AGE, GENDER, AGE_GENDER, LOCATION, DEVICE_TYPE, HOUR
보고서 조회시 데이터가 그룹화 될 기준을 지정합니다.
O
metricsGroup MetricsGroup 보고서 지표 그룹
- BASIC, ADDITION, MESSAGE, MESSAGE_ADDITION, MESSAGE_CLICK, PLUS_FRIEND, PIXEL_CONVERSION, SDK_CONVERSION, VIDEO
보고서 조회 지표들을 지정합니다.
지표 그룹별 상세 지표리스트는 Metric 정의 테이블을 참조해주세요.
X
Sample
Request: datePreset 지정
curl -X GET "https://apis.moment.kakao.com/openapi/v4/creatives/report?datePreset=TODAY&dimension=CREATIVE_FORMAT&metricsGroup=BASIC&creativeId=40068,40065" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Request: datePreset 미지정
curl -X GET "https://apis.moment.kakao.com/openapi/v4/creatives/report?start=20200101&end=20200101&dimension=CREATIVE_FORMAT&metricsGroup=BASIC&creativeId=40068,40065" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response: 요청 성공
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "start": "2020-01-01",
            "end": "2020-01-01",
            "dimensions": {
                "creative_format": "IMAGE BANNER",
                "creative_id": "1234"
            },
            "metrics": {
                "imp": 4,
                "click": 0,
                "ctr": 0.0,
                "cost": 0.0
            }
        }
    ]
}
Response: 보고서 데이터가 없을 경우
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "start": "2020-01-01",
            "end": "2020-01-01",
            "dimensions": {},
            "metrics": {}
        }
    ]
}
주의: 소재 보고서

1. 소재 단위의 보고서 요청은 소재 Level만 조회되므로 Level 지정이 별도로 필요 없습니다. 2. 디스플레이 광고 소재는 메시지 기본 지표(MESSAGE), 메시지 추가 지표(MESSAGE_ADDITION), 메시지 클릭 지표(MESSAGE_CLICK)를 선택하는 경우 값이 없습니다. 3. 메시지 광고 소재는 기본 지표(BASIC), 추가 지표(ADDITION), 카카오친구 지표(PLUS_FRIEND), 픽셀 전환 지표(PIXEL_CONVERSION), SDK 전환 지표(SDK_CONVERSION), 동영상 지표(VIDEO)를 선택하는 경우 값이 없습니다.

더보기