사이드 메뉴
Getting started
Kakao Developers
Login
Communication
Advertisement
- Concepts
- Ad creation: Ad account
- Ad creation: Campaign
- Ad creation: Ad group
- Targeting for ad group
- Custom audience targeting for ad group
- Ad creation: Creative common
- Ad creation: Display creative
- Ad creation: Message creative
- Ad creation: Personalized message creative
- Bizboard landing settings
- Report
- Message management
- Personalized message management
- Message ad management
- Message ad operation
- Ad View management
- Business Form+ management
- Business Form linkage management
- Pixel & SDK linkage management
- Audience management
- Engagement targeting management
- Customer file management
- Friend group management
- Ad account management
- Reference
- Type information
- Error code
Kakao Moment
Custom audience targeting
This document describes how to use the Custom audience targeting APIs.
| Method | URL | Authorization |
|---|---|---|
GET | https://apis.moment.kakao.com/openapi/v4/targetings/data/categories | Business token |
| Permission | Prerequisite | Business Authentication | Business consent items |
|---|---|---|---|
| Required: Request permission | Switch to a Biz app Set Business redirect URI Business consent items | Required | Required |
Returns the category (interest or business type) data for custom audience targeting that you can use as a targeting option when creating or editing an ad group.
The category ID rules are applied as follows:
- Upper category: 3-digit alphanumeric string
- Middle category: 5-digit string that consists of the 3-digit Upper category ID and a unique 2-digit number.
- Lower category: 7-digit string that consists of the 5-digit Middle category ID and a unique 2-digit number.
| Name | Description | Required |
|---|---|---|
| Authorization | Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}Business token as a type of user authentication. | O |
| Name | Type | Description | Required |
|---|---|---|---|
| type | String | Category type, one of the following:
| O |
| Name | Type | Description |
|---|---|---|
| type | String | Category type. |
| data | CategoryData[] | Category data. Used as the targeting.ufoInterests or targeting.ufoBusinessTypes value according to type when creating or editing an ad group. |
Request: INTEREST
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/data/categories?type=INTEREST" \-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}"
Request: BUSINESS_TYPE
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/data/categories?type=BUSINESS_TYPE" \-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}"
Response: 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": []},{}]},{}]}// ...]}
Response: 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": []}]}// ...]}
| Method | URL | Authorization |
|---|---|---|
GET | https://apis.moment.kakao.com/openapi/v4/targetings/location/map | Business token |
| Permission | Prerequisite | Business Authentication | Business consent items |
|---|---|---|---|
| Required: Request permission | Switch to a Biz app Set Business redirect URI Business consent items | Required | Required |
Returns the locations that you can use as a targeting option when creating or editing an ad group for geotargeting.
You can retrieve the locations used for geotargeting by passing the detailed address or place name when you request this API. You must specify the place name or the detailed address by passing either the street name and building number or - dong and -lot number. The search results are provided in order of accuracy according to the requested detailed address or place.
| Name | Description | Required |
|---|---|---|
| Authorization | Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}Business token as a type of user authentication. | O |
| Name | Type | Description | Required |
|---|---|---|---|
| keyword | String | Detailed address you want to search for. Detailed address or location including the street name + building number or -dong + -lot information. | O |
| Name | Type | Description |
|---|---|---|
| query | String | Detailed address you requested. |
| items | Item[] | List of the retrieved address. |
| Name | Type | Description |
|---|---|---|
| address | String | Retrieved detailed address. Required value when creating or editing an ad group. |
| labelName | String | Reference position. Required value when creating or editing an ad group. |
| geohash | String | Geo hash value. Required value when creating an ad group. Use this value for geohashes as an array when creating or editing an ad group. |
| centerLatitude | Double | Latitude of the center. Required value when creating or editing an ad group. |
| centerLongitude | Double | Longitude of the center. Required value when creating or editing an ad group. |
| latitude | Double | Latitude of the retrieved location. Required value when creating or editing an ad group. |
| longitude | Double | Longitude of the retrieved location. Required value when creating or editing an ad group. |
| poi | String | Representative code of the searched location. |
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/location/map?keyword=판교역로 235" \-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}"
Response
// 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}]}