페이지 이동경로

문서>
카카오모먼트>
광고그룹 맞춤타겟 조회

카카오모먼트

광고그룹 맞춤타겟 조회

이 문서는 광고그룹 맞춤타겟 조회 API 사용 방법을 안내합니다.

맞춤타겟 카테고리 타입 보기

기본 정보

메서드	URL	인증 방식
`GET`	`https://apis.moment.kakao.com/openapi/v4/targetings/data/categories`	액세스 토큰

권한	사전 설정	카카오 로그인	사용자 동의
필요	플랫폼 등록 카카오 로그인 활성화 비즈 앱	필요	-

광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 맞춤타겟의 카테고리 관심사/업종 데이터를 조회합니다.

액세스 토큰(Access token)을 헤더에 담아 GET으로 요청합니다. type 파라미터는 "INTEREST(관심사)"와 "BUSINESS_TYPE(업종)" 중 하나로 전달해야 합니다. 검색하려는 type을 명시하지 않으면 요청이 실패하고 에러 응답을 받습니다.

요청 성공 시 응답의 data 필드로 관심사 또는 업종 정보의 카테고리 ID 목록을 받아, 광고그룹 생성 및 수정 시 targeting 파라미터의 ufoInterests 또는 ufoBusinessTypes 값으로 전달할 수 있습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

카테고리 ID 규칙은 다음과 같습니다.

최상위 카테고리: 문자 및 숫자로 구성된 3자리 문자열
상위 카테고리: 최상위 카테고리 ID에 고유한 숫자 2자리를 붙인 5자리 문자열
하위 카테고리: 상위 카테고리 ID에 고유한 숫자 2자리를 붙인 7자리 문자열

요청

헤더

이름	설명	필수
Authorization	`Authorization: Bearer ${ACCESS_TOKEN}` 인증 방식, 액세스 토큰으로 인증 요청	O

쿼리 파라미터

이름	타입	설명
type	`String`	카테고리 타입 INTEREST(관심사) 또는 BUSINESS_TYPE(업종)

응답

본문

이름	타입	설명
type	`String`	카테고리 타입
data	`CategoryData[]`	카테고리 데이터

예제

요청: 관심사(INTEREST)

curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/data/categories?type=INTEREST" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}"

요청: 업종(BUSINESS_TYPE)

curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/data/categories?type=BUSINESS_TYPE" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}"

응답: 관심사(INTEREST)

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "type": "INTEREST",
    "data": [
        {
            "id": "I01",
            "name": "여가/일상",
            "children": [
                {
                    "id": "I0101",
                    "name": "소셜활동",
                    "children": []
                },
                {
                    "id": "I0102",
                    "name": "TV/라디오",
                    "children": [
                        {
                            "id": "I010201",
                            "name": "드라마",
                            "children": []
                        },
                        {
                        }
                    ]
                },
                {
                }
            ]
        },
        ...
    ]
}

응답: 업종(BUSINESS_TYPE)

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "type": "BUSINESS_TYPE",
    "data": [
        {
            "id": "P01",
            "name": "인터넷서비스",
            "children": [
                {
                    "id": "P0101",
                    "name": "SNS/커뮤니티",
                    "children": []
                },
                {
                    "id": "P0102",
                    "name": "포털",
                    "children": []
                },
                {
                    "id": "P0103",
                    "name": "동영상",
                    "children": []
                },
                {
                    "id": "P0104",
                    "name": "다운로드서비스",
                    "children": []
                },
                {
                    "id": "P0105",
                    "name": "리워드앱",
                    "children": []
                },
                {
                    "id": "P0106",
                    "name": "e러닝",
                    "children": []
                },
                {
                    "id": "P0107",
                    "name": "편의기능",
                    "children": []
                }
            ]
        },
        ...
    ]
}

맞춤타겟 모먼트 타게팅 보기

기본 정보

메서드	URL	인증 방식
`GET`	`https://apis.moment.kakao.com/openapi/v4/targetings/location/map`	액세스 토큰

권한	사전 설정	카카오 로그인	사용자 동의
필요	플랫폼 등록 카카오 로그인 활성화 비즈 앱	필요	-

광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 맞춤타겟의 모먼트 타게팅을 위한 지역을 조회합니다. 상세주소, 장소 이름으로 모먼트 타게팅을 위한 지역을 조회할 수 있습니다. 도로명과 건물번호, 동과 지번이 포함된 상세 주소 또는 장소로 검색해야 하며 입력된 상세주소 및 장소에 따라 정확도 순으로 검색결과를 제공합니다.

액세스 토큰(Access token)을 헤더에 담아 GET으로 요청합니다. keyword 파라미터로 검색할 상세 주소를 전달해야 합니다. 성공 시 응답은 검색한 주소 정보와 조회된 주소 목록을 포함합니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

요청

헤더

이름	설명	필수
Authorization	`Authorization: Bearer ${ACCESS_TOKEN}` 인증 방식, 액세스 토큰으로 인증 요청	O

쿼리 파라미터

이름	타입	설명	필수
keyword	`String`	검색할 상세 주소 도로명+건물번호, 동+지번이 포함된 상세주소 또는 장소	O

응답

본문

이름	타입	설명
query	`String`	요청한 상세 주소
items	`Item[]`	조회된 주소 목록

Item

이름	타입	설명
address	`String`	검색된 상세 주소 광고그룹 생성/수정시 필요한 값
labelName	`String`	기준 위치 광고그룹 생성/수정시 필요한 값
geohash	`String`	Geo 해쉬 값 광고그룹 생성시 필요한 값 해당 값은 광고그룹 생성/수정 요청시 geohashes에 Array로 요청
centerLatitude	`Double`	중앙 위치의 위도 광고그룹 생성/수정시 필요한 값
centerLongitude	`Double`	중앙 위치의 경도 광고그룹 생성/수정시 필요한 값
latitude	`Double`	검색된 위치의 위도 광고그룹 생성/수정시 필요한 값
longitude	`Double`	검색된 위치의 경도 광고그룹 생성/수정시 필요한 값
poi	`String`	검색된 지역의 대표 코드

예제

요청

curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/location/map?keyword=판교역로 235" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}"

응답

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "query": "판교역로 235",
    "items": [
        {
            "poi": "N33885142",
            "labelName": "경기 성남시 분당구 판교역로 235",
            "address": "경기 성남시 분당구 삼평동 681",
            "longitude": 127.108638414972,
            "latitude": 37.402095568027,
            "geohash": "wydku2",
            "centerLongitude": 127.1063232421875,
            "centerLatitude": 37.40020751953125
        }
    ]
}

kakao developers

menu

시작하기

로그인

커뮤니케이션

지도/로컬

내비게이션

검색

인공지능

광고

더 보기

카카오모먼트

광고그룹 맞춤타겟 조회

맞춤타겟 카테고리 타입 보기

기본 정보

요청

헤더

쿼리 파라미터

응답

본문

예제

요청: 관심사(INTEREST)

요청: 업종(BUSINESS_TYPE)

응답: 관심사(INTEREST)

응답: 업종(BUSINESS_TYPE)

맞춤타겟 모먼트 타게팅 보기

기본 정보

요청

헤더

쿼리 파라미터

응답

본문

Item

예제

요청

응답

더 보기