사이드 메뉴
시작하기
로그인
커뮤니케이션
광고
카카오모먼트
광고그룹 맞춤타겟 조회
이 문서는 광고그룹 맞춤타겟 조회 API 사용 방법을 안내합니다.
| 메서드 | URL | 인증 방식 |
|---|---|---|
GET | https://apis.moment.kakao.com/openapi/v4/targetings/data/categories | 비즈니스 토큰 |
광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 맞춤타겟의 카테고리 관심사/업종 데이터를 조회합니다.
비즈니스 토큰을 헤더에 담아 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(업종) | O |
| 이름 | 타입 | 설명 |
|---|---|---|
| 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 OKContent-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 OKContent-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 | 비즈니스 토큰 |
광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 맞춤타겟의 모먼트 타게팅을 위한 지역을 조회합니다.
상세주소, 장소 이름으로 모먼트 타게팅을 위한 지역을 조회할 수 있습니다. 도로명과 건물번호, 동과 지번이 포함된 상세 주소 또는 장소로 검색해야 하며 입력된 상세주소 및 장소에 따라 정확도 순으로 검색결과를 제공합니다.
비즈니스 토큰을 헤더에 담아 GET으로 요청합니다. keyword 파라미터로 검색할 상세 주소를 전달해야 합니다. 성공 시 응답은 검색한 주소 정보와 조회된 주소 목록을 포함합니다. 실패 시 에러 코드에서 원인을 확인합니다.
| 이름 | 설명 | 필수 |
|---|---|---|
| Authorization | Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}인증 방식, 비즈니스 토큰으로 인증 요청 | O |
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| keyword | String | 검색할 상세 주소 도로명+건물번호, 동+지번이 포함된 상세주소 또는 장소 | O |
| 이름 | 타입 | 설명 |
|---|---|---|
| query | String | 요청한 상세 주소 |
| items | 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 OKContent-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}]}