페이지 이동경로
  • 문서>
  • 카카오모먼트>
  • 광고그룹 맞춤타겟 조회

카카오모먼트

광고그룹 맞춤타겟 조회

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

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

기본 정보
메서드 URL 인증 방식
GET https://apis.moment.kakao.com/openapi/v4/targetings/data/categories 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목
필요 필요

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

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

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

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

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_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 ${BUSINESS_ACCESS_TOKEN}"
요청: 업종(BUSINESS_TYPE)
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/data/categories?type=BUSINESS_TYPE" \
    -H "Authorization: Bearer ${BUSINESS_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 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목
필요 필요

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

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_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 ${BUSINESS_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
        }
    ]
}

더 보기