페이지 이동경로
  • 문서>
  • 카카오모먼트>
  • 광고반응타겟 관리

카카오모먼트

광고반응타겟 관리

이 문서는 광고반응타겟 관리 API 사용법을 안내합니다.

광고반응타겟은 광고그룹 생성 및 수정 시 타게팅 정보로 활용할 수 있습니다. 광고에서 발생한 클릭, 재생, 반응 데이터를 조합하여 만들 수 있는 타게팅 정보이며 카카오모먼트에서 집행되는 캠페인 전체가 대상이 됩니다.

카카오모먼트 광고는 캠페인의 목표와 유형에 따라 다양한 반응 데이터를 제공합니다. 사용자 선택에 따라 다양한 광고반응 데이터를 설정하여 광고할 수 있으며, 캠페인의 유형에 따라 선택할 수 있는 광고반응 데이터의 종류가 달라질 수 있습니다.

캠페인 유형별 정책
구분 디스플레이 카카오 비즈보드/다음쇼핑 카카오톡 채널
재생 동영상을 3초 이상 혹은 25% 이상 재생한 사용자
동영상 재생에는 클릭 혹은 전환까지 한 사용자가 포함될 수 있습니다.
- -
클릭 광고의 클릭 영역 중에서 1곳이라도 클릭한 사용자 광고의 클릭 영역 중에서 곳이라도 클릭한 사용자 열람한 메시지의 클릭 영역 중에서 1곳이라도 클릭한 사용자
전환 1) 카카오 픽셀 & SDK로 전환이 수집된 사용자
디스플레이 X 전환 중 광고 목표 설정이 카카오톡 채널인 경우 제외
2) 광고를 통하여 카카오톡 채널을 추가한 사용자
디스플레이 X 전환 중 광고목표설정이 카카오톡 채널인 경우
카카오 픽셀 & SDK로 전환이 수집된 사용자 -
열람 - - 카카오톡 채널과의 채팅방을 열어서 메시지를 읽음 처리한 사용자

연산 및 반응 종류 정책
구분 클릭/재생/전환(전체) 클릭-재생/재생-클릭/클릭-전환 재생&클릭
디스플레이 X 전환
디스플레이 X 방문
카카오 비즈보드 X 전환
카카오 비즈보드 X 방문
클릭
operation : ONLY
firstIndicator : CLICK

재생
operation : ONLY
firstIndicator : PLAY

전환
operation : ONLY
firstIndicator : CONVERSION
클릭-재생
operation : MINUS
firstIndicator : CLICK
secondIndicator : PLAY

재생-클릭
operation : MINUS
firstIndicator : PLAY
secondIndicator : CLICK

클릭-전환
operation : MINUS
firstIndicator : CLICK
secondIndicator : CONVERSION
operation : AND
firstIndicator : PLAY
secondIndicator : CLICK
구분 열람(전체) 클릭(전체) 열람-클릭
카카오톡 채널 X 도달 operation : ONLY
firstIndicator : OPEN
operation : ONLY
firstIndicator : CLICK
operation : MINUS
firstIndicator : OPEN
secondIndicator : CLICK

광고반응타겟 목록 보기

광고그룹 생성 및 수정 시 타게팅 정보로 활용 가능한 광고반응타겟 목록을 조회합니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청하며, 성공 시 응답 바디(Body)에 JSON 객체로 광고반응타겟의 목록을 받습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

Request
URL
GET /openapi/v4/targetings/cohort/list HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Response
Name Type Description
- CohortTarget[] 타게팅 정보로 활용 가능한 광고반응타겟 목록
CohortTarget
Name Type Description
id Long 광고반응타겟 번호
audienceType String 광고반응 타겟 유형
광고그룹, 오디언스 생성/수정시 올바르게 매칭하여 사용
DISPLAY, MESSAGE 중 하나
name String 광고반응타겟 이름
baseAds BaseAd[] 광고반응 데이터 목록
collectDuration Integer 수집 기간
오늘은 기준으로 수집기간 동안 쌓인 사용자 데이터를 광고 타게팅에 사용함
단, 광고집행 이력이 있어도 수집기간 내 반응한 사용자가 없는 경우 노출 대상이 없을 수 있음
cohortStatus String 타겟 모수 상태
WAITING (준비 중),
AVAILABLE_ERROR (모출 추출 에러),
AVAILABLE (모수 추출 완료),
SEED_NOT_ENOUGH (모수부족),
DELETE (삭제 또는 삭제중),
ERROR (그 외 에러) 중 하나
score Long 타겟 모수
타겟 모수 상태가 AVAILABLE 인 경우 정상 추출된 모수
선택한 광고에 반응한 카카오 사용자 추정 도달수로 광고반응타겟 생성 요청 후 익일 모수 추출이 완료되고,
수집기간에 따라 모수는 매일 새롭게 갱신되며
준비중 상태인 타겟은 모수 추출 전 단계로 타게팅에 사용 불가능
createdDate String 생성일시
yyyy-MM-dd'T'HH:mm:ss
lastModifiedDate String 마지막 수정일시
yyyy-MM-dd'T'HH:mm:ss
Sample
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/cohort/list" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "adAccountId": 1234,
        "id": 1,
        "audienceType": "MESSAGE",
        "name": "첫번째_광고반응타겟",
        "baseAds": [
            {
                "campaign": {
                    "id": 5678,
                    "name": "첫번째_캠페인",
                    "campaignTypeGoal": {
                        "campaignType": "TALK_CHANNEL",
                        "goal": "REACH"
                    }
                },
                "adGroup": {
                    "id": 20425,
                    "name": "첫번째_광고그룹"
                },
                "operation": "ONLY",
                "firstIndicator": "OPEN"
            }
        ],
        "collectDuration": 90,
        "cohortStatus": "AVAILABLE",
        "createdDate": "2020-01-01 00:00:00",
        "lastModifiedDate": "2020-01-01 00:00:00"
    }
]

광고반응타겟 보기

지정한 광고반응타겟의 상세 정보를 조회합니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청하며, 정보를 조회할 광고반응타겟의 번호를 전달해야 합니다. 요청 성공 시 응답은 해당 광고반응타겟의 상세 정보 및 상태를 포함합니다.

Request
URL
GET /openapi/v4/targetings/cohort/{id} HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
id Long 광고반응타겟 번호 O
Response
Name Type Description
id Long 광고반응타겟 번호
audienceType String 광고반응 타겟 유형
광고그룹, 오디언스 생성/수정시 올바르게 매칭하여 사용
DISPLAY, MESSAGE 중 하나
adAccountId Long 광고계정 번호
name String 광고반응타겟 이름
baseAds BaseAd[] 광고반응 데이터 목록
collectDuration Integer 수집 기간
오늘은 기준으로 수집기간 동안 쌓인 사용자 데이터를 광고 타게팅에 사용함
단, 광고집행 이력이 있어도 수집기간 내 반응한 사용자가 없는 경우 노출 대상이 없을 수 있음
cohortStatus String 타겟 모수 상태
WAITING (준비 중),
AVAILABLE_ERROR (모출 추출 에러),
AVAILABLE (모수 추출 완료),
SEED_NOT_ENOUGH (모수부족),
DELETE (삭제 또는 삭제중),
ERROR (그 외 에러) 중 하나
createdDate String 생성일시
yyyy-MM-dd'T'HH:mm:ss
lastModifiedDate String 마지막 수정일시
yyyy-MM-dd'T'HH:mm:ss
Sample
Request
curl -X GET 'https://apis.moment.kakao.com/openapi/v4/targetings/cohort/{id}' \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "adAccountId": 1234,
    "id": 1,
    "audienceType": "MESSAGE",
    "name": "첫번째_광고반응타겟",
    "baseAds": [
        {
            "campaign": {
                "id": 5678,
                "name": "첫번째_캠페인",
                "campaignTypeGoal": {
                    "campaignType": "TALK_CHANNEL",
                    "goal": "REACH"
                }
            },
            "adGroup": {
                "id": 9012,
                "name": "첫번째_광고그룹"
            },
            "operation": "ONLY",
            "firstIndicator": "OPEN"
        }
    ],
    "collectDuration": 90,
    "cohortStatus": "AVAILABLE",
    "createdDate": "2020-01-01 00:00:00",
    "lastModifiedDate": "2020-01-01 00:00:00"
}

광고반응타겟 생성 가능 대상 보기

광고반응타겟 생성하기에 필요한 정보인 광고계정 하위의 캠페인 및 광고그룹 정보의 목록을 조회합니다.

캠페인의 경우, 다음 유형의 캠페인 유형X목표의 조합만 검색 가능합니다:

  • 카카오 비즈보드X방문
  • 카카오 비즈보드X전환
  • 디스플레이X방문
  • 디스플레이X전환
  • 다음쇼핑X도달
  • 동영상X조회
  • 카카오톡 채널X도달

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청합니다. 검색할 캠페인의 유형 X 목표 및 이름을 선택 파라미터로 전달할 수 있습니다. 성공 시 광고그룹 및 캠페인 정보를 받습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

Request
URL
GET /openapi/v4/targetings/cohort/creatables HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
campaignTypeGoal CampaignTypeGoal 검색할 캠페인 유형X목표 O
searchKeyword String 검색할 캠페인 이름 O
CampaignTypeGoal
Name Type Description Required
campaignType CampaignType 캠페인 유형
TALK_BIZ_BOARD(카카오톡 비즈보드) 또는 DISPLAY(디스플레이)
O
goal Goal 캠페인 목표
VISITING(방문) 또는 CONVERSION(전환)
O
Response
Name Type Description
- AdGroupAndCampaign[] 광고계정 하위의 캠페인 및 광고그룹 정보의 목록
AdGroupAndCampaign
Name Type Description
adGroup AdGroup 광고그룹
campaign Campaign 캠페인
Sample
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/cohort/creatables" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}" \
    -d '{
            "campaignTypeGoal": {
                "campaignType": "DISPLAY",
                "goal": "VISITING"
            },
            "searchKeyword":"HG"
        }'
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "campaign": {
            "id": 1234,
            "name": "첫번째_캠페인",
            "campaignTypeGoal": {
                "campaignType": "DISPLAY",
                "goal": "VISITING"
            }
        },
        "adGroup": [
            {
                "id": 56,
                "name": "첫번째_광고그룹"
            },
            {
                "id": 78,
                "name": "두번째_광고그룹"
            }
        ]
    }
]

광고반응타겟 생성하기

광고반응타겟을 생성합니다. 광고반응타겟은 광고그룹 생성 및 수정 시 타게팅 정보로 활용할 수 있습니다. 광고에서 발생한 클릭, 재생, 반응 데이터를 조합하여 만들 수 있는 타게팅 정보이며 계정당 30개까지만 등록 가능합니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 POST로 요청합니다. 성공 시 JSON 객체로 생성한 광고반응타겟 정보를 받습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

Request
URL
POST /openapi/v4/targetings/cohort HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
audienceType String 광고반응타겟 유형
DISPLAY, MESSAGE 중 하나
O
name String 광고반응타겟 이름
한글, 영문, 특수문자, 공백을 허용하며 50자를 넘을 수 없음
O
baseAds BaseAd[] 광고반응 데이터 O
광고반응타겟 유형별 적용 가능한 캠페인유형x목표 조합
유형 적용 가능 캠페인유형x목표 조합
DISPLAY 카카오 비즈보드 X 전환
카카오 비즈보드 X 방문
디스플레이 X 전환
디스플레이 X 방문
다음쇼핑 X 도달
동영상 X 조회
MESSAGE 카카오톡 채널 X 도달
BaseAd
Name Type Description Required
adGroup AdGroup 광고그룹 O
campaign Campaign 캠페인 O
operation Operation 연산 종류
연산 및 반응 종류 정책 참조
O
firstIndicator Indicator 첫번째 반응 종류
연산 및 반응 종류 정책 참조
O
secondIndicator Indicator 두번째 반응 종류
연산 및 반응 종류 정책 참조
X
AdGroup
Name Type Description
id Long 광고그룹 번호
Campaign
Name Type Description
id Long 캠페인 번호
Response
Name Type Description
id Long 광고반응타겟 번호
adAccountId Long 광고계정 번호
name String 광고반응타겟 이름
collectDuration Integer 수집 기간
오늘은 기준으로 수집기간 동안 쌓인 사용자 데이터를 광고 타게팅에 사용함
단, 광고집행 이력이 있어도 수집기간 내 반응한 사용자가 없는 경우 노출 대상이 없을 수 있음
baseAds BaseAd[] 광고반응 데이터
cohortStatus String 타겟 모수 상태
WAITING (준비 중),
AVAILABLE_ERROR (모출 추출 에러),
AVAILABLE (모수 추출 완료),
SEED_NOT_ENOUGH (모수부족),
DELETE (삭제 또는 삭제중),
ERROR (그 외 에러) 중 하나
createdDate String 생성일시
yyyy-MM-dd'T'HH:mm:ss
lastModifiedDate String 마지막 수정일시
yyyy-MM-dd'T'HH:mm:ss
Sample
Request
curl -X POST "https://apis.moment.kakao.com/openapi/v4/targetings/cohort" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}" \
    -d '{
            "name": "첫번째_광고반응",
            "audienceType": "MESSAGE",
            "baseAds": [
                {
                    "campaign": {
                        "id": 56,
                        "campaignTypeGoal": {
                            "campaignType": "TALK_CHANNEL"
                        }
                    },
                    "adGroup": {
                        "id": 78
                    },
                    "firstIndicator": "OPEN",
                    "operation": "ONLY"
                }
            ]
        }'
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "adAccountId": 1234,
    "id": 1,
    "audienceType": "MESSAGE",
    "collectDuration": 90,
    "cohortStatus": "WAITING",
    "name": "첫번째_광고반응",
    "baseAds": [
        {
            "campaign": {
                "id": 56,
                "name": "첫번째_캠페인",
                "campaignTypeGoal": {
                    "campaignType": "TALK_CHANNEL",
                    "goal": "REACH"
                }
            },
            "adGroup": {
                "id": 78,
                "name": "첫번째_광고그룹"
            },
            "operation": "ONLY",
            "firstIndicator": "OPEN"
        }
    ],
    "createdDate": "2020-01-01 00:00:00",
    "lastModifiedDate": "2020-01-01 00:00:00"
}

광고반응타겟 이름 수정하기

광고반응타겟의 이름을 수정합니다. 이미 삭제된 광고반응타겟은 수정할 수 없으며, 수정하고자 하는 광고반응타겟 이름이 기존에 존재하는 경우에도 수정이 불가능합니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 PUT으로 요청합니다. 성공 시 수정된 광고반응타겟 정보를 받습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

이 API는 사용자 계정마다 10초에 한 번씩 요청이 가능하도록 제한되어 있습니다.

Request
URL
PUT /openapi/v4/targetings/cohort/name HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
id Long 광고반응타겟 번호 O
name String 광고반응타겟 이름
한글, 영문, 특수문자, 공백을 허용하며
50자를 넘을 수 없음
O
Response
Name Type Description
adAccountId Long 광고계정 번호
id Long 광고반응타겟 번호
audienceType String 광고반응 타겟 유형
광고그룹, 오디언스 생성/수정시 올바르게 매칭하여 사용
DISPLAY, MESSAGE 중 하나
name String 광고반응타겟 이름
collectDuration Integer 수집 기간
오늘은 기준으로 수집기간 동안 쌓인 사용자 데이터를 광고 타게팅에 사용함
단, 광고집행 이력이 있어도 수집기간 내 반응한 사용자가 없는 경우 노출 대상이 없을 수 있음
baseAds BaseAd[] 광고반응 데이터
cohortStatus String 타겟 모수 상태
WAITING (준비 중),
AVAILABLE_ERROR (모출 추출 에러),
AVAILABLE (모수 추출 완료),
SEED_NOT_ENOUGH (모수부족),
DELETE (삭제 또는 삭제중),
ERROR (그 외 에러) 중 하나
createdDate String 생성일시
yyyy-MM-dd'T'HH:mm:ss
lastModifiedDate String 마지막 수정일시
yyyy-MM-dd'T'HH:mm:ss
Sample
Request
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/targetings/cohort/name" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}" \
    -d '{
            "id": 1,
            "name": "광고반응타겟_이름_수정"
        }'
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "adAccountId": 1234,
    "id": 1,
    "audienceType": "MESSAGE",
    "collectDuration": 90,
    "cohortStatus": "WAITING",
    "name": "광고반응타겟_이름_수정",
    "baseAds": [
        {
            "campaign": {
                "id": 56,
                "name": "첫번째_캠페인",
                "campaignTypeGoal": {
                    "campaignType": "TALK_CHANNEL",
                    "goal": "REACH"
                }
            },
            "adGroup": {
                "id": 78,
                "name": "첫번째_광고그룹"
            },
            "operation": "ONLY",
            "firstIndicator": "OPEN"
        }
    ],
    "createdDate": "2020-01-01 00:00:00",
    "lastModifiedDate": "2020-01-01 12:00:00"
}

광고반응타겟 데이터 수정하기

광고반응타겟의 데이터를 수정합니다. 이 API로는 광고반응타겟 이름은 수정할 수 없습니다. 광고반응타겟 보기 API를 통해 기존 광고반응타겟의 정보를 조회한 다음, 수정하고자 하는 필드와 수정을 원치 않는 필드를 조합하여 요청해야 합니다. 수정을 원치 않는 필드도 기존 값으로 요청해야 광고반응타겟의 정보를 유지할 수 있습니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 PUT으로 요청합니다. 성공 시 응답은 수정된 광고반응타겟 정보를 받습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

주의: 반응 고객 데이터 수정

반응 고객 데이터를 수정하면 타겟이 새롭게 반영되기까지 1일이 소요됩니다.

Request
URL
PUT /openapi/v4/targetings/cohort HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
id Long 광고반응타겟 번호 O
baseAds BaseAd[] 광고반응 O
BaseAd
Name Type Description Required
adGroup Long 광고그룹 O
campaign Long 캠페인 O
operation Operation 연산 종류
"ONLY","MINUS","AND" 중 하나
연산 및 반응 종류 정책 참조
O
firstIndicator Indicator 첫번째 반응 종류
"PLAY", "CLICK", "OPEN", CONVERSION" 중 하나
연산 및 반응 종류 정책 참조
O
secondIndicator Indicator 두번째 반응 종류
"PLAY", "CLICK", "CONVERSION" 중 하나
연산 및 반응 종류 정책 참조
X
Response
Name Type Description
id Long 광고반응타겟 번호
audienceType String 광고반응 타겟 유형
광고그룹, 오디언스 생성/수정시 올바르게 매칭하여 사용
DISPLAY, MESSAGE 중 하나
adAccountId Long 광고계정 번호
name String 광고반응타겟 이름
collectDuration Integer 수집 기간
오늘은 기준으로 수집기간 동안 쌓인 사용자 데이터를 광고 타게팅에 사용함
단, 광고집행 이력이 있어도 수집기간 내 반응한 사용자가 없는 경우 노출 대상이 없을 수 있음
baseAds BaseAd[] 광고반응 데이터
cohortStatus String 타겟 모수 상태
WAITING (준비 중),
AVAILABLE_ERROR (모출 추출 에러),
AVAILABLE (모수 추출 완료),
SEED_NOT_ENOUGH (모수부족),
DELETE (삭제 또는 삭제중),
ERROR (그 외 에러) 중 하나
createdDate String 생성일시
yyyy-MM-dd'T'HH:mm:ss
lastModifiedDate String 마지막 수정일시
yyyy-MM-dd'T'HH:mm:ss
Sample
Request
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/targetings/cohort" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}" \
    -d '{
            "id": 1234,
            "name": "광고반응타겟_데이터_수정",
            "baseAds": [
                {
                    "campaign": {
                        "id": 56,
                        "campaignTypeGoal": {
                            "campaignType": "TALK_CHANNEL"
                        }
                    },
                    "adGroup": {
                        "id": 78
                    },
                    "firstIndicator": "OPEN",
                    "operation": "ONLY"
                }
            ]
        }'
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "adAccountId": 1234,
    "id": 1,
    "audienceType": "MESSAGE",
    "collectDuration": 90,
    "cohortStatus": "WAITING",
    "name": "광고반응타겟_이름_수정",
    "baseAds": [
        {
            "campaign": {
                "id": 56,
                "name": "첫번째_캠페인",
                "campaignTypeGoal": {
                    "campaignType": "TALK_CHANNEL",
                    "goal": "REACH"
                }
            },
            "adGroup": {
                "id": 78,
                "name": "첫번째_광고그룹"
            },
            "operation": "ONLY",
            "firstIndicator": "OPEN"
        }
    ],
    "createdDate": "2020-01-01 00:00:00",
    "lastModifiedDate": "2020-01-01 15:00:00"
}

광고반응타겟 삭제하기

광고반응타겟을 삭제합니다. 이미 삭제된 광고반응타겟 또는 사용 중인 광고반응타겟은 삭제할 수 없습니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 DELETE로 요청하고, 성공 시 HTTP 상태 코드 200에 응답 바디는 없습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

이 API는 사용자 계정마다 1초에 한 번씩 요청이 가능하도록 제한되어 있습니다.

Request
URL
DELETE /openapi/v4/targetings/cohort/{id} HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
id Long 광고반응타겟 번호 O
Sample
Request
curl -X DELETE "https://apis.moment.kakao.com/openapi/v4/targetings/cohort/{id}" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8

광고반응타겟 사용 현황 보기

광고반응타겟 사용 현황 목록을 조회할 수 있습니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청하며, 광고반응타겟 번호를 전달해야 합니다. 성공 시 계정 내 해당 광고반응타겟이 타게팅에 사용된 광고그룹 목록을 받습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

Request
URL
GET /openapi/v4/targetings/cohort/usages/{id} HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer {ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer {ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
id Long 광고반응타겟 번호 O
Response
Name Type Description
- AdGroupAndCampaign[] 광고반응타겟 사용 현황 목록
AdGroupAndCampaign
Name Type Description
adGroup AdGroup 광고그룹
campaign Campaign 캠페인
Sample
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/cohort/usages/{id}" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "adGroup": {
            "id": 1234,
            "name": "첫번째_광고그룹",
            "adGroupStatus": [
                "LIVE"
            ],
            "adGroupType": "DISPLAY"
        },
        "campaign": {
            "id": 5678,
            "name": "첫번째_캠페인",
            "campaignTypeGoal": {
                "campaignType": "DISPLAY",
                "goal": "VISITING"
            }
        }
    }
]

더보기