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

카카오모먼트

캠페인

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

캠페인 목록 보기

기본 정보
메서드 URL 인증 방식
GET https://apis.moment.kakao.com/openapi/v4/campaigns 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목		 필요 필요

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

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청		 O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID		 O
쿼리 파라미터
이름 타입 설명 필수
config String ON, OFF, DEL(삭제) 중 하나 X

응답

본문
이름 타입 설명
content Campaign[] 캠페인 정보 목록
Campaign
이름 타입 설명
id Long 캠페인 번호
name String 캠페인명
config String 캠페인 상태
ON, OFF, DEL(삭제) 중 하나
userConfig String 캠페인 상태
ON, OFF, DEL(삭제) 중 하나
참고: config와 동일한 값으로, config로 개선하기 이전에 사용하던 필드입니다. 현재 해당 필드는 사용이 불가하며, 히스토리 관리를 위한 조회용으로만 참고 가능합니다.
systemConfig String 캠페인 시스템 상태
ON, ADMIN_STOP(관리자정지), EXTERNAL_SERVICE_STOP(연결 서비스 제한) 중 하나

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

예제

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

캠페인 보기

기본 정보
메서드 URL 인증 방식
GET https://apis.moment.kakao.com/openapi/v4/campaigns/${ID} 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목		 필요 필요

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

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청		 O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID		 O
경로 변수
이름 타입 설명 필수
ID Long 캠페인 번호 O

응답

본문
이름 타입 설명
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로 변경

예제

요청
curl -X GET "https://apis.moment.kakao.com/openapi/v4/campaigns/${ID}" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}"
응답: 성공
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
}
응답: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "detailCode": 31001,
       "detailMsg": "캠페인이 존재하지 않습니다."
    }
}

캠페인 생성하기

기본 정보
메서드 URL 인증 방식
POST https://apis.moment.kakao.com/openapi/v4/campaigns 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목		 필요 필요

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

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

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

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

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

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

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

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청		 O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID		 O
본문
이름 타입 설명 필수
name String 캠페인 이름
최대 50자
요청 시 포함되지 않으면 자동 생성		 X
campaignTypeGoal CampaignTypeGoal 캠페인 유형 X 목표 O
objective Objective 광고 목표 설정
유형 X 목표, 전환추적 설정 조건 참조		 O*
dailyBudgetAmount Long 일 예산
입력하지 않은 경우 예산 "한도 없음"과 같은 의미		 X
trackId String 전환추적 설정 번호
캠페인 목표가 방문인 경우 픽셀&SDK 보기 결과의 id 를 전환추적 설정 번호로 입력할 수 있습니다.		 X

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

응답

본문
이름 타입 설명
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로 변경

예제

요청
curl -X POST "https://apis.moment.kakao.com/openapi/v4/campaigns" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "name": "첫번째_캠페인",
            "campaignTypeGoal" : {
                "campaignType" : "DISPLAY",
                "goal" : "CONVERSION"
            },
            "objective" : {
                "type" : "TALK_CHANNEL",
                "value" : "abcd1234"
            },
            "dailyBudgetAmount" : 200000
        }'
응답: 성공
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
}
응답: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "status": 400,
        "message": "존재하지 않는 광고계정입니다."
    }
}

캠페인 수정하기

기본 정보
메서드 URL 인증 방식
PUT https://apis.moment.kakao.com/openapi/v4/campaigns 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목		 필요 필요

캠페인 정보를 수정합니다. 다음 쇼핑, 동영상, 카카오 비즈보드 X 도달을 제외한 캠페인만 수정이 가능합니다.

전환 목표를 가진 캠페인은 카카오톡 채널 프로필 리스트 조회 및 픽셀 & SDK 목록 보기 조회를 한 후 수정할 수 있습니다. 카카오톡채널, 개인화 메시지 유형 X 도달 캠페인의 경우 이름, 전환추적 ID 수정만 가능하며, 이를 제외한 다른 필드들의 변경사항은 반영되지 않습니다.

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청		 O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID		 O
본문
이름 타입 설명 필수
id Long 캠페인 번호 O
name String 캠페인 이름
입력하지 않은 경우 이전 이름 유지		 X
dailyBudgetAmount Long 일 예산 X
trackId String 전환추적 설정 번호
캠페인 목표가 방문인 경우 픽셀 & SDK 목록 보기 결과의 ID를 전환추적 설정 번호로 입력
방문외 목표의 경우 수정하려는 기존 캠페인에 설정된 ID 를 입력
* 기존 캠페인에 설정된 ID 가 없는 경우에는 입력하지 않음		 X

응답

본문
이름 타입 설명
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로 변경

예제

요청
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/campaigns" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "id": 5678,
            "name" : "첫번째_캠페인_수정",
            "dailyBudgetAmount":100000,
            "trackId":null
        }'
응답
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
}

캠페인 상태 변경하기

기본 정보
메서드 URL 인증 방식
PUT https://apis.moment.kakao.com/openapi/v4/campaigns/onOff 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목		 필요 필요

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

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

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

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 PUT으로 요청하며, 성공 시 HTTP 상태 코드 200에 응답 본문은 없습니다.

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청		 O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID		 O
본문
이름 타입 설명 필수
id Long 캠페인 번호 O
config String ON, OFF 중 하나 O

예제

요청
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/campaigns/onOff" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "id": 5678,
            "config" : "ON"
        }'
응답: 성공
HTTP/1.1 200 OK
Content-Length: 0
Content-Type: application/json;charset=UTF-8
응답: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "detailCode": 31001,
        "detailMsg": "캠페인이 존재하지 않습니다."
    }
}

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

기본 정보
메서드 URL 인증 방식
PUT https://apis.moment.kakao.com/openapi/v4/campaigns/dailyBudgetAmount 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목		 필요 필요

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

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

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

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 PUT으로 요청하며, 캠페인 일 예산을 입력하지 않은 경우 캠페인 기준의 통합 지출 한도 없이 광고그룹별 일 예산 기준으로 예산이 소진됩니다. 성공 시 HTTP 상태 코드 200에 응답 본문은 없습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청		 O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID		 O
본문
이름 타입 설명 필수
id Long 캠페인 번호 O
dailyBudgetAmount Long 캠페인 일예산
미설정 가능
설정하는 경우 최소 50,000원에서 최대 1,000,000,000원까지 설정 가능하며 10원 단위로 가능		 X

예제

요청: 캠페인 일예산 설정
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/campaigns/dailyBudgetAmount" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "id": 5678,
            "dailyBudgetAmount": 5000000
        }'
요청: 캠페인 일예산 미설정
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/campaigns/dailyBudgetAmount" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "dailyBudgetAmount" : null
        }'
응답: 성공
HTTP/1.1 200 OK
Content-Length: 0
Content-Type: application/json;charset=UTF-8
응답: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "detailCode": 31011,
        "detailMsg": "캠페인 일예산은 최소 50,000보다 크거나 같아야 합니다."
    }
}

캠페인 삭제하기

기본 정보
메서드 URL 인증 방식
DELETE https://apis.moment.kakao.com/openapi/v4/campaigns/${ID} 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목		 필요 필요

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

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청		 O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID		 O
경로 변수
이름 타입 설명 필수
ID Long 캠페인 번호 O

예제

요청
curl -X DELETE "https://apis.moment.kakao.com/openapi/v4/campaigns/${ID}" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json"
응답: 성공
HTTP/1.1 200 OK
Content-Length: 0
Content-Type: application/json;charset=UTF-8
응답: 실패
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"
    }
}

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

기본 정보
메서드 URL 인증 방식
GET https://apis.moment.kakao.com/openapi/v4/campaigns/${ID}/latestSystemConfigHistory 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목		 필요 필요

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

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청		 O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID		 O
경로 변수
이름 타입 설명 필수
ID Long 캠페인 번호 O

응답

본문
이름 타입 설명
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으로 변경

예제

요청
curl -X GET "https://apis.moment.kakao.com/openapi/v4/campaigns/${ID}/latestSystemConfigHistory" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}"
응답: 성공
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"
}
응답: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "detailCode": 31001,
       "detailMsg": "캠페인이 존재하지 않습니다."
    }
}

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

기본 정보
메서드 URL 인증 방식
GET https://apis.moment.kakao.com/openapi/v4/campaigns/${ID}/systemConfigHistories 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목		 필요 필요

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

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청		 O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID		 O
경로 변수
이름 타입 설명 필수
ID Long 캠페인 번호 O

응답

본문
이름 타입 설명
- SystemStopReason[] 시스템 정지 사유 목록
SystemStopReason
이름 타입 설명
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으로 변경

예제

요청
curl -X GET "https://apis.moment.kakao.com/openapi/v4/campaigns/${ID}/systemConfigHistories" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}"
응답: 성공
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"
    }
]
응답: 실패
{
    "code": -813,
    "msg": "KakaoMomentException",
    "extras": {
        "detailCode": 31001,
       "detailMsg": "캠페인이 존재하지 않습니다."
    }
}

더 보기

카카오모먼트> 광고 만들기: 캠페인