페이지 이동경로
  • 문서>
  • 카카오모먼트>
  • 광고 만들기: 캠페인

카카오모먼트

캠페인

이 문서는 광고 만들기: 캠페인 API 사용 방법을 안내합니다.

캠페인 목록 보기

캠페인 목록을 조회합니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청하며, 성공 시 응답 바디에 JSON 객체로 캠페인 정보 목록을 받습니다.

Request
URL
GET /openapi/v4/campaigns 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
config String ON, OFF중 하나 X
Response
Name Type Description
content Campaign[] 캠페인 정보 목록
Campaign
Name Type Description
id Long 캠페인 번호
name String 캠페인명
config String 캠페인 상태
ON, OFF, DEL(삭제) 중 하나
systemConfig String 캠페인 시스템 상태
ON, ADMIN_STOP(관리자정지), EXTERNAL_SERVICE_STOP(연결 서비스 제한) 중 하나

* adminStop: 관리자 정지 여부(Boolean), systemConfig로 변경

Sample
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/campaigns?config=ON" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}"
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "content": [
    {
      "id": 1111,
      "name": "캠페인 1",
      "config": "ON",
      "systemConfig": "ADMIN_STOP"
    },
    {
      "id": 1112,
      "name": "캠페인 2",
      "config": "OFF",
      "systemConfig": " ON"
    }
  ]
}

캠페인 보기

지정한 한 캠페인의 상세 정보를 조회합니다. 캠페인 상세 정보 중 캠페인의 게재와 관련된 상태(statusDescription)는 캠페인 상태(config), 일 예산 초과 여부(isDailyBudgetAmountOver)의 조합으로 만들어집니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청합니다. 성공 시 응답 바디에 JSON 객체로 캠페인 상세 정보를 받습니다. 실패 시 에러 코드상세 에러 코드로 사유를 확인합니다.

Request
URL
GET /openapi/v4/campaigns/${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: Path
Name Type Description Required
id Long 캠페인 번호 O
Response
Name Type Description
id Long 캠페인 번호
name String 캠페인 이름
campaignTypeGoal CampaignTypeGoal 캠페인 유형 X 목표
objective Objective 광고 목표 설정
dailyBudgetAmount Long 일 예산
입력하지 않은 경우 예산 "한도 없음"과 같은 의미
config String 캠페인 상태
ON, OFF, DEL(삭제) 중 하나
statusDescription String 캠페인의 게재와 관련된 현재 상태
trackId String 전환추적 설정 번호
adAccountId Long 광고계정 번호
status String 상태
Status 참고
systemConfig String 캠페인 시스템 상태
ON, ADMIN_STOP(관리자정지), EXTERNAL_SERVICE_STOP(연결 서비스 제한) 중 하나
isDailyBudgetAmountOver Boolean 일 예산 초과 여부

* adminStop: Deprecated, 관리자 정지 여부(Boolean), systemConfig로 변경

Sample
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/campaigns/${id}" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}"
Response: 성공
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "id": 1234,
    "name": "캠페인1",
    "campaignTypeGoal": {
        "campaignType": "DISPLAY",
        "goal": "VISITING"
    },
    "objective": null,
    "dailyBudgetAmount": null,
    "config": "ON",
    "statusDescription": "운영중",
    "trackId": "5360727718927577526",
    "adAccountId": 10000,
    "status": [
        "LIVE"
    ],
    "systemConfig": "ON",
    "isDailyBudgetAmountOver": false
}
Response: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "detailCode": 31001,
       "detailMsg": "캠페인이 존재하지 않습니다."
    }
}

캠페인 생성하기

새로운 캠페인을 생성합니다. 스폰서드 보드, 다음 쇼핑 및 동영상, 카카오 비즈보드 X 도달 유형을 제외한 캠페인만 생성이 가능합니다.

전환 목표를 가진 캠페인을 생성할 경우, 카카오톡 채널 프로필 목록 보기 및 픽셀&SDK 보기 요청 후 캠페인을 생성할 수 있습니다.

카카오톡채널 X 도달 캠페인의 경우 전환 목표는 메세지를 발송하고자 하는 카카오톡 채널 프로필을 입력하셔야 합니다.

캠페인 이름은 생성 시 지정하지 않을 경우 카카오모먼트의 기본 명명 규칙에 따라 yyyyMMddHHmm_{유형}_{목표} 형식으로 설정됩니다.

캠페인 일예산은 필수값이 아니며 카카오톡채널 X 도달 캠페인의 경우 일예산 지정이 불가능합니다. 캠페인 전략에 대한 조건은 다음을 참고합니다.

유형 X 목표 광고목표 & 전환 추적 설정 조건

유형 광고 목표 설정 필수 전환추적 설정
디스플레이 X 방문 - X 픽셀 & SDK(옵션)
디스플레이 X 전환 픽셀&SDK O 픽셀 & SDK 광고 목표 설정과 동일한 대상으로 자동 설정
캠페인 생성시 ID 직접 입력 불가
캠페인 수정시 자동설정된 ID 입력 필수
디스플레이 X 전환 카카오톡 채널 제공안함 전환 추적 설정 불가
카카오 비즈보드 X 방문 - X 픽셀 & SDK(옵션)
카카오 비즈보드 X 전환 픽셀&SDK O 픽셀 & SDK 광고 목표 설정과 동일한 대상으로 자동 설정
캠페인 생성시 ID 직접 입력 불가
캠페인 수정시 자동설정된 ID 입력 필수
카카오 비즈보드 X 전환 카카오톡 채널 제공안함 전환 추적 설정 불가
카카오톡 채널 X 도달 카카오톡 채널 제공안함 전환 추적 설정 불가

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 POST로 요청합니다. 성공 시 생성된 캠페인 정보를 받으며, 실패 시 에러 코드상세 에러 코드로 사유를 확인합니다.

Request
URL
POST /openapi/v4/campaigns 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
name String 캠페인 이름
최대 50자
요청 시 포함되지 않으면 자동 생성
X
campaignTypeGoal CampaignTypeGoal 캠페인 유형 X 목표 O
objective Objective 광고 목표 설정
유형 X 목표, 전환추적 설정 조건 참조
O*
dailyBudgetAmount Long 일 예산
입력하지 않은 경우 예산 "한도 없음"과 같은 의미
X
trackId String 전환추적 설정 번호
캠페인 목표가 방문인 경우 픽셀&SDK 보기 결과의 id 를 전환추적 설정 번호로 입력할 수 있습니다.
X

* objective: 해당 유형의 광고 목표 설정을 지정하는 경우에만 필수

Response
Name Type Description
id Long 캠페인 번호
name String 캠페인 이름
campaignTypeGoal CampaignTypeGoal 캠페인 유형 X 목표
objective Objective 광고 목표 설정
dailyBudgetAmount Long 일 예산
입력하지 않은 경우 예산 "한도 없음"과 같은 의미
config String 캠페인 상태
ON, OFF, DEL(삭제) 중 하나
statusDescription String 캠페인의 게재와 관련된 현재 상태
trackId String 전환추적설정 번호
adAccountId Long 광고계정 번호
status String 상태
Status 참고
systemConfig String 캠페인 시스템 상태
ON, ADMIN_STOP(관리자정지), EXTERNAL_SERVICE_STOP(연결 서비스 제한) 중 하나
isDailyBudgetAmountOver Boolean 일 예산 초과 여부

* adminStop: Deprecated, 관리자 정지 여부(Boolean), systemConfig로 변경

Sample
Request
curl -X POST "https://apis.moment.kakao.com/openapi/v4/campaigns" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}" \
    -H "Content-Type: application/json" \
    -d '{
            "name": "첫번째_캠페인",
            "campaignTypeGoal" : {
                "campaignType" : "DISPLAY",
                "goal" : "CONVERSION"
            },
            "objective" : {
                "type" : "TALK_CHANNEL",
                "value" : "abcd1234"
            },
            "dailyBudgetAmount" : 200000
        }'
Response: 성공
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "id": 1234,
    "name": "캠페인1",
    "campaignTypeGoal": {
        "campaignType": "DISPLAY",
        "goal": "VISITING"
    },
    "objective": null,
    "dailyBudgetAmount": null,
    "config": "ON",
    "statusDescription": "운영중",
    "trackId": "5360727718927577526",
    "adAccountId": 10000,
    "status": [
        "LIVE"
    ],
    "systemConfig": "ON",
    "isDailyBudgetAmountOver": false
}
Response: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "status": 400,
        "message": "존재하지 않는 광고계정입니다."
    }
}

캠페인 수정하기

캠페인 정보를 수정합니다. 스폰서드 보드, 다음 쇼핑 및 동영상 유형, 카카오 비즈보드 X 도달 유형을 제외한 캠페인만 수정이 가능합니다. 전환 목표를 가진 캠페인은 카카오톡 채널 프로필 리스트 조회 및 픽셀 & SDK 목록 보기 조회를 한 후 수정할 수 있습니다. 카카오톡채널 X 도달 캠페인의 경우 이름 수정만 가능하며, 이름을 제외한 다른 필드들의 변경사항은 반영되지 않습니다.

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

Request
URL
PUT /openapi/v4/campaigns 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 캠페인 이름
입력하지 않은 경우 이전 이름 유지
X
dailyBudgetAmount Long 일 예산 X
trackId String 전환추적 설정 번호
캠페인 목표가 방문인 경우 픽셀 & SDK 목록 보기 결과의 ID를 전환추적 설정 번호로 입력
방문외 목표의 경우 수정하려는 기존 캠페인에 설정된 ID 를 입력
* 기존 캠페인에 설정된 ID 가 없는 경우에는 입력하지 않음
X
Response
Name Type Description
id Long 캠페인 번호
name String 캠페인 이름
campaignTypeGoal CampaignTypeGoal 캠페인 유형 X 목표
objective Objective 광고 목표 설정
dailyBudgetAmount Long 일 예산
입력하지 않은 경우 예산 "한도 없음"과 같은 의미
config String 캠페인 상태
ON, OFF, DEL(삭제) 중 하나
statusDescription String 캠페인의 게재와 관련된 현재 상태
trackId String 전환추적설정 번호
adAccountId Long 광고계정 번호
status String 상태
Status 참고
systemConfig String 캠페인 시스템 상태
ON, ADMIN_STOP(관리자정지), EXTERNAL_SERVICE_STOP(연결 서비스 제한) 중 하나
isDailyBudgetAmountOver Boolean 일 예산 초과 여부

* adminStop: Deprecated, 관리자 정지 여부(Boolean), systemConfig로 변경

Sample
Request
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/campaigns" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}" \
    -H "Content-Type: application/json" \
    -d '{
            "id": 5678,
            "name" : "첫번째_캠페인_수정",
            "dailyBudgetAmount":100000,
            "trackId":null
        }'
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "id": 1234,
    "name": "캠페인1",
    "campaignTypeGoal": {
        "campaignType": "DISPLAY",
        "goal": "VISITING"
    },
    "objective": null,
    "dailyBudgetAmount": null,
    "config": "ON",
    "statusDescription": "운영중",
    "trackId": "5360727718927577526",
    "adAccountId": 10000,
    "status": [
        "LIVE"
    ],
    "systemConfig": "ON",
    "isDailyBudgetAmountOver": false
}

캠페인 상태 변경하기

지정한 캠페인의 상태를 변경합니다.

캠페인 상태가 ON 또는 OFF일 경우에만 변경 가능하고, 다음 쇼핑 및 동영상, 카카오 비즈보드 X 도달 캠페인은 수정할 수 없습니다.

카카오톡 채널X 도달 캠페인은 하위 광고그룹이 모두 OFF 상태이거나 계약해지 상태여야합니다. 카카오톡 채널X 도달 캠페인 상태 변경을 요청하면 발송 중, 발송 예정인 메시지가 일시중지됩니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 PUT으로 요청하며, 성공 시 HTTP 상태 코드 200에 응답 바디는 없습니다.

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

Request
URL
PUT /openapi/v4/campaigns/onOff 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
config String ON, OFF 중 하나 O
Sample
Request
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/campaigns/onOff" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}" \
    -H "Content-Type: application/json" \
    -d '{
            "id": 5678,
            "config" : "ON"
        }'
Response: 성공
HTTP/1.1 200 OK
Content-Length: 0
Content-type: application/json;charset=UTF-8
Response: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "detailCode": 31001,
        "detailMsg": "캠페인이 존재하지 않습니다."
    }
}

디스플레이 캠페인 일 예산 수정하기

캠페인 일 예산을 수정하는 API입니다. 도달 목표의 캠페인(카카오톡 채널, 다음쇼핑 유형)과 동영상 유형 캠페인과 카카오 비즈보드 X 도달 캠페인에서는 동작하지 않습니다.

캠페인 일예산 설정값은 최소 50,000원에서 최대 1,000,000,000원까지 설정 가능하며 10원 단위로 가능합니다. 단, 기존에 저장된 일예산보다 작은 값으로 수정 시, 하위의 광고그룹/소재 중 광고그룹 일예산/최대 입찰금액, 소재 입찰금액이 조건에 위배되는 광고그룹/소재는 일괄 변경됩니다.

  • 광고그룹 일예산이 변경되는 캠페인 일예산을 초과하는 경우
    → 변경되는 캠페인 일예산으로 수정
  • 광고그룹 최대 입찰금액이 변경되는 광고그룹 일예산 50%를 초과하는 경우
    → 변경되는 광고그룹 일예산 50%로 수정
  • 소재 입찰금액이 변경되는 광고그룹 최대 입찰금액을 초과하는 경우
    → 변경되는 광고그룹 최대 입찰금액으로 수정

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 PUT으로 요청하며, 캠페인 일 예산을 입력하지 않은 경우 예산 "한도 없음"과 같은 의미입니다. 성공 시 HTTP 상태 코드 200에 응답 바디는 없습니다. 실패 시 에러 코드상세 에러 코드로 사유를 확인합니다.

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

Request
URL
PUT /openapi/v4/campaigns/dailyBudgetAmount 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
dailyBudgetAmount Long 캠페인 일예산
미설정 가능
설정하는 경우 최소 50,000원에서 최대 1,000,000,000원까지 설정 가능하며 10원 단위로 가능
X
Sample
Request: 캠페인 일예산 설정
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/campaigns/dailyBudgetAmount" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}" \
    -H "Content-Type: application/json" \
    -d '{
            "id": 5678,
            "dailyBudgetAmount": 5000000
        }'
Request: 캠페인 일예산 미설정
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/campaigns/dailyBudgetAmount" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}" \
    -H "Content-Type: application/json" \
    -d '{
            "dailyBudgetAmount" : null
        }'
Response: 성공
HTTP/1.1 200 OK
Content-Length: 0
Content-type: application/json;charset=UTF-8
Response: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "detailCode": 31011,
        "detailMsg": "캠페인 일예산은 최소 50,000보다 크거나 같아야 합니다."
    }
}

캠페인 삭제하기

캠페인을 삭제합니다. 액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 DELETE로 요청합니다. 삭제하려는 캠페인의 ID를 파라미터로 지정해야 합니다. 성공 시 HTTP 상태 코드 200에 응답 바디는 없습니다. 실패 시 에러 코드상세 에러 코드로 사유를 확인합니다.

캠페인 삭제는 데이터 삭제를 의미하는 것이 아닌, 캠페인 하위에 대한 운영을 포기한다는 의미입니다. 스폰서드 보드, 카카오 비즈보드 X 도달, 다음쇼핑, 동영상 유형 캠페인은 삭제가 불가능합니다. 캠페인 삭제시 다음의 제약사항이 있습니다. - 수정, 실시 중지 등의 캠페인 관련 모든 기능 사용 불가 - 캠페인에 속한 모든 광고가 운영 & 노출 중지 - 하위 모든 광고그룹과 소재 삭제 - 단, 과거 운영 시점의 통계 내용 조회 가능

Request
URL
DELETE /openapi/v4/campaigns/${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: Path
Name Type Description Required
id Long 캠페인 번호 O
Sample
Request
curl -X DELETE "https://apis.moment.kakao.com/openapi/v4/campaigns/${id}" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}" \
    -H "Content-Type: application/json"
Response: 성공
HTTP/1.1 200 OK
Content-Length: 0
Content-type: application/json;charset=UTF-8
Response: 실패
HTTP/1.1 400 Bad request
Content-Type: application/json;charset=UTF-8
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "detailCode": 75006,
        "detailMsg": "카카오톡 채널_도달 캠페인은 삭제할 수 없습니다.",
        "path": "/v2/moment/campaigns",
        "timestamp": "2018-10-01T10:16:14.294+0000"
    }
}

캠페인 시스템 정지 사유 보기

지정한 한 캠페인의 시스템 정지 사유를 조회합니다. 시스템 정지 사유가 여러 건 있는 경우 가장 최근의 정지 사유를 조회합니다. 캠페인의 systemConfigADMIN_STOP 또는 EXTERNAL_SERVICE_STOP인 경우에만 응답이 있습니다. 시스템 정지 사유가 여러건 있는 경우 가장 최근의 시스템 정지 사유를 조회합니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청합니다. 성공 시 응답 바디에 JSON 객체로 시스템 정지 사유 상세정보를 받습니다. 실패 시 에러 코드상세 에러 코드로 사유를 확인합니다.

Request
URL
GET /openapi/v4/campaigns/${id}/adminStopHistory 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: Path
Name Type Description Required
id Long 캠페인 번호 O
Response
Name Type Description
id Long 관리자 정지 번호
systemConfig String 시스템 상태
reason String 시스템 정지 사유
detailReason String 시스템 정지 사유 상세, 있는 경우에만 응답에 포함
createdDate String 시스템 정지 사유 생성일시
yyyy-MM-dd'T'HH:mm:ss
lastModifiedDate String 시스템 정지 사유 마지막 수정일시
yyyy-MM-dd'T'HH:mm:ss

* adminStopReason: Deprecated, 관리자 정지 사유(String), reason으로 변경

Sample
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/campaigns/${id}/adminStopHistory" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}"
Response: 성공
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "id": 1234,
    "systemConfig": "EXTERNAL_SERVICE_STOP",
    "reason": "채널 관리자센터에서 규제됨",
    "detailReason": "메시지 집행 가이드, 운영정책 위반으로 yyyy년 mm월 dd일까지 메시지 발송이 불가",
     "createdDate":"2021-01-01T00:00:00",
    "lastModifiedDate": "2021-01-01T00:00:00"
}
Response: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "detailCode": 31001,
       "detailMsg": "캠페인이 존재하지 않습니다."
    }
}

캠페인 시스템 정지 사유 목록 보기

지정한 캠페인의 최근 2년 동안의 시스템 정지 사유를 조회합니다. 캠페인의 systemConfigADMIN_STOP 또는 EXTERNAL_SERVICE_STOP인 경우에만 응답이 있습니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청합니다. 성공 시 응답 바디에 JSON 객체로 시스템 정지 사유 상세정보 리스트를 받습니다. 실패 시 에러 코드상세 에러 코드로 사유를 확인합니다.

Request
URL
GET /openapi/v4/campaigns/${id}/adminStopHistories 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: Path
Name Type Description Required
id Long 캠페인 번호 O
Response
Name Type Description
- SystemStopReason[] 시스템 정지 사유 목록
SystemStopReason
Name Type Description
id Long 시스템 정지 번호
systemConfig String 시스템 상태
reason String 시스템 정지 사유
detailReason String 시스템 정지 사유 상세, 있는 경우에만 응답에 포함
createdDate String 시스템 정지 사유 생성일시
yyyy-MM-dd'T'HH:mm:ss
lastModifiedDate String 시스템 정지 사유 마지막 수정일시
yyyy-MM-dd'T'HH:mm:ss

* adminStopReason: Deprecated, 관리자 정지 사유(String), reason으로 변경

Sample
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/campaigns/${id}/adminStopHistory" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}"
Response: 성공
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "id": 1235,
        "systemConfig": "ADMIN_STOP",
        "reason": "해당 캠페인유형은 지원 종료되었습니다.",
        "createdDate":"2021-01-01T00:00:00",
        "lastModifiedDate": "2021-01-01T00:00:00"
    },
    {
        "id": 1234,
        "systemConfig": "EXTERNAL_SERVICE_STOP",
        "reason": "채널 관리자센터에서 규제됨",
        "detailReason": "메시지 집행 가이드, 운영정책 위반으로 yyyy년 mm월 dd일까지 메시지 발송이 불가",
        "createdDate":"2021-01-01T00:00:00",
        "lastModifiedDate": "2021-01-01T00:00:00"
    }
]
Response: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "detailCode": 31001,
       "detailMsg": "캠페인이 존재하지 않습니다."
    }
}

더보기