이 문서는 광고그룹 맞춤타겟 조회 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 규칙은 다음과 같습니다.
이름 | 설명 | 필수 |
---|---|---|
Authorization | Authorization: Bearer ${BUSINESS_ACCESS_TOKEN} 인증 방식, 비즈니스 토큰으로 인증 요청 |
O |
이름 | 타입 | 설명 |
---|---|---|
type | String |
카테고리 타입 INTEREST(관심사) 또는 BUSINESS_TYPE(업종) |
이름 | 타입 | 설명 |
---|---|---|
type | String |
카테고리 타입 |
data | CategoryData[] |
카테고리 데이터 |
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/data/categories?type=INTEREST" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}"
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/data/categories?type=BUSINESS_TYPE" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}"
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": []
},
{
}
]
},
{
}
]
},
...
]
}
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[] |
조회된 주소 목록 |
이름 | 타입 | 설명 |
---|---|---|
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
}
]
}