카카오 키워드광고

광고 생성: 광고그룹

이 문서는 광고 생성: 광고그룹 API 사용 방법을 안내합니다.

광고그룹은 캠페인 하위에 광고그룹을 생성할 수 있으며, 광고그룹별로 게재 설정, 입찰가, 집행기간 등 상세한 전략 설정이 가능합니다.

광고그룹 목록 조회

기본 정보

메서드	URL	인증 방식
`GET`	`https://api.keywordad.kakao.com/openapi/v1/adGroups`	비즈니스 토큰

요구 사항	참고
비즈 앱 전환 비즈니스 리다이렉트 URI 등록 비즈니스 동의항목 설정	에러 코드 용어집

광고그룹 목록을 반환합니다.

요청

헤더

이름	설명	필수
Authorization	인증 방식, 비즈니스 토큰으로 인증 요청 `Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}`	O
adAccountId	광고계정 ID `adAccountId: ${AD_ACCOUNT_ID}`	O

쿼리 파라미터

이름	타입	설명	필수
campaignId	`Long`	캠페인 ID	O
config	`Enum: Config`	광고그룹 상태(기본값: `ON,OFF`)	X

응답

본문

이름	타입	설명
campaignId	`Long`	캠페인 ID
id	`Long`	광고그룹 ID
name	`String`	광고그룹 이름
config	`Enum: Config`	광고그룹 상태
status	`Enum: Status[]`	광고그룹 운영상태
placements	`Enum: Placement[]`	상세 매체유형 설정 정보
deviceTypes	`Enum: DeviceTypes[]`	상세 디바이스 설정 정보
useKeywordExtension	`Boolean`	키워드확장 설정여부
exceptionKeywords	`String[]`	키워드확장 제외 키워드
dailyBudgetAmount	`Long`	일예산
dailyBudgetAmountOver	`Long`	일예산 초과 여부
bidAmount	`Long`	기본입찰가
mobileBidWeight	`Long`	모바일 입찰가중치
pcBidWeight	`Long`	PC 입찰가중치
keywordExtensionBidWeight	`Long`	키워드확장 입찰가중치
contentBidAmount	`Long`	콘텐츠매체 입찰가
schedule	`Schedule`	집행기간

예제

요청

curl -v -G GET "https://api.keywordad.kakao.com/openapi/v1/adGroups" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -d "campaignId=1234" \
    -d "config=ON"

응답

// HTTP/1.1 200 OK
// Content-Type: application/json;charset=UTF-8
[
  {
    "campaignId": "3333333331",
    "id": "4444444441",
    "name": "광고그룹1",
    "config": "ON",
    "status": ["OFF_BY_BIZ_CHANNEL_WAITING", "WAITING"],
    "placements": ["PREMIUM_LINK_SEARCH_KAKAO", "PREMIUM_LINK_CONTENT_KAKAO", "PREMIUM_LINK_CONTENT_PARTNER"],
    "deviceTypes": ["PC", "MOBILE"],
    "useKeywordExtension": true,
    "exceptionKeywords": ["키워드1", "키워드2"],
    "dailyBudgetAmount": 10000,
    "dailyBudgetAmountOver": false,
    "bidAmount": 70,
    "mobileBidWeight": 150,
    "pcBidWeight": 140,
    "keywordExtensionBidWeight": 100,
    "contentBidAmount": 70,
    "schedule": {
      "beginDate": "2021-01-01",
      "endDate": "2021-02-20",
      "detailTime": true,
      "mondayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "tuesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "wednesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "thursdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "fridayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "saturdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "sundayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"]
    }
  },
  {
    "campaignId": "3333333331",
    "id": "4444444442",
    "name": "광고그룹2",
    "config": "ON",
    "status": ["OFF_BY_BIZ_CHANNEL_WAITING", "WAITING"],
    "placements": ["PREMIUM_LINK_SEARCH_KAKAO", "PREMIUM_LINK_CONTENT_KAKAO", "PREMIUM_LINK_CONTENT_PARTNER"],
    "deviceTypes": ["PC", "MOBILE"],
    "useKeywordExtension": true,
    "exceptionKeywords": ["키워드1", "키워드2"],
    "dailyBudgetAmount": 10000,
    "dailyBudgetAmountOver": false,
    "bidAmount": 70,
    "mobileBidWeight": 150,
    "pcBidWeight": 140,
    "keywordExtensionBidWeight": 100,
    "contentBidAmount": 70,
    "schedule": {
      "beginDate": "2021-01-01",
      "endDate": "2021-02-20",
      "detailTime": true,
      "mondayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "tuesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "wednesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "thursdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "fridayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "saturdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
      "sundayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"]
    }
  }
]

광고그룹 조회

기본 정보

메서드	URL	인증 방식
`GET`	`https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}`	비즈니스 토큰

요구 사항	참고
비즈 앱 전환 비즈니스 리다이렉트 URI 등록 비즈니스 동의항목 설정	에러 코드 용어집

각 광고그룹 상세 정보를 반환합니다.

요청

헤더

이름	설명	필수
Authorization	인증 방식, 비즈니스 토큰으로 인증 요청 `Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}`	O
adAccountId	광고계정 ID `adAccountId: ${AD_ACCOUNT_ID}`	O

경로 변수

이름	타입	설명	필수
ID	`Long`	광고그룹 ID	O

응답

본문

이름	타입	설명
campaignId	`Long`	캠페인 ID
id	`Long`	광고그룹 ID
name	`String`	광고그룹 이름
config	`Enum: Config`	광고그룹 상태
status	`Enum: Status[]`	광고그룹 운영상태
placements	`Enum: Placement[]`	상세 매체유형 설정 정보
deviceTypes	`Enum: DeviceTypes[]`	상세 디바이스 설정 정보
useKeywordExtension	`Boolean`	키워드확장 설정여부
exceptionKeywords	`String[]`	키워드확장 제외 키워드
dailyBudgetAmount	`Long`	일예산
dailyBudgetAmountOver	`Long`	일예산 초과 여부
bidAmount	`Long`	기본입찰가
mobileBidWeight	`Long`	모바일 입찰가중치
pcBidWeight	`Long`	PC 입찰가중치
keywordExtensionBidWeight	`Long`	키워드확장 입찰가중치
contentBidAmount	`Long`	콘텐츠매체 입찰가
schedule	`Schedule`	집행기간

예제

요청

curl -v -G GET "https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}"

응답: 성공

// HTTP/1.1 200 OK
// Content-Type: application/json;charset=UTF-8
{
  "campaignId": "3333333331",
  "id": "4444444441",
  "name": "광고그룹1",
  "config": "ON",
  "status": ["OFF_BY_BIZ_CHANNEL_WAITING", "WAITING"],
  "placements": ["PREMIUM_LINK_SEARCH_KAKAO", "PREMIUM_LINK_CONTENT_KAKAO", "PREMIUM_LINK_CONTENT_PARTNER"],
  "deviceTypes": ["PC", "MOBILE"],
  "useKeywordExtension": true,
  "exceptionKeywords": ["키워드1", "키워드2"],
  "dailyBudgetAmount": 10000,
  "dailyBudgetAmountOver": false,
  "bidAmount": 70,
  "mobileBidWeight": 150,
  "pcBidWeight": 140,
  "keywordExtensionBidWeight": 100,
  "contentBidAmount": 70,
  "schedule": {
    "beginDate": "2021-01-01",
    "endDate": "2021-02-20",
    "detailTime": true,
    "mondayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "tuesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "wednesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "thursdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "fridayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "saturdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "sundayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"]
  }
}

광고그룹 생성

기본 정보

메서드	URL	인증 방식
`POST`	`https://api.keywordad.kakao.com/openapi/v1/adGroups`	비즈니스 토큰

요구 사항	참고
비즈 앱 전환 비즈니스 리다이렉트 URI 등록 비즈니스 동의항목 설정	에러 코드 용어집

새로운 광고그룹을 생성합니다.

요청

헤더

이름	설명	필수
Authorization	인증 방식, 비즈니스 토큰으로 인증 요청 `Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}`	O
adAccountId	광고계정 ID `adAccountId: ${AD_ACCOUNT_ID}`	O

본문

이름	타입	설명	필수
campaignId	`Long`	캠페인 ID	O
name	`String`	광고그룹 이름	O
placements	`Enum: Placement[]`	상세 매체유형 설정 정보(기본값: 전체 매체유형)	X
deviceTypes	`Enum: DeviceTypes[]`	상세 디바이스 설정 정보(기본값: 전체 디바이스)	X
useKeywordExtension	`Boolean`	키워드확장 설정여부(기본값: `true`)	X
exceptionKeywords	`String[]`	키워드확장 제외 키워드	X
bidAmount	`Long`	기본입찰가(기본값: `300`)	X
dailyBudgetAmount	`Long`	일예산(기본값: `100000`)	X
mobileBidWeight	`Long`	모바일 입찰가중치(기본값: `100`)	X
pcBidWeight	`Long`	PC 입찰가중치(기본값: `100`)	X
keywordExtensionBidWeight	`Long`	키워드확장 입찰가중치(기본값: `100`)	X
contentBidAmount	`Long`	콘텐츠매체 입찰가(기본값: 미설정)	X
schedule	`Schedule`	집행기간	X

응답

본문

이름	타입	설명
campaignId	`Long`	캠페인 ID
id	`Long`	광고그룹 ID
name	`String`	광고그룹 이름
config	`Enum: Config`	광고그룹 상태 `ON`: 활성화 `OFF`: 비활성화 참고: 광고계정 ID 입력 시 `DEL` 값 노출 가능
status	`Enum: Status[]`	광고그룹 운영상태
placements	`Enum: Placement[]`	상세 매체유형 설정 정보
deviceTypes	`Enum: DeviceTypes[]`	상세 디바이스 설정 정보
useKeywordExtension	`Boolean`	키워드확장 설정여부
exceptionKeywords	`String[]`	키워드확장 제외 키워드
dailyBudgetAmount	`Long`	일예산
dailyBudgetAmountOver	`Long`	일예산 초과 여부
bidAmount	`Long`	기본입찰가
mobileBidWeight	`Long`	모바일 입찰가중치
pcBidWeight	`Long`	PC 입찰가중치
keywordExtensionBidWeight	`Long`	키워드확장 입찰가중치
contentBidAmount	`Long`	콘텐츠매체 입찰가
schedule	`Schedule`	집행기간

예제

요청

curl -v -X POST "https://api.keywordad.kakao.com/openapi/v1/adGroups" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "campaignId": "3333333331",
            "name": "광고그룹1",
            "placements": ["PREMIUM_LINK_SEARCH_KAKAO", "PREMIUM_LINK_CONTENT_KAKAO", "PREMIUM_LINK_CONTENT_PARTNER"],
            "deviceTypes": ["PC","MOBILE"],
            "useKeywordExtension": true,
            "exceptionKeywords": [
                  "키워드1",
                  "키워드2"
            ],
            "bidAmount": 70,
            "dailyBudgetAmount": 100000,
            "mobileBidWeight": 150,
            "pcBidWeight": 140,
            "contentBidAmount": 70,
            "schedule": {
                  "beginDate": "2021-01-01",
                  "endDate": "2021-02-20",
                  "detailTime": true,
                  "mondayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "tuesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "wednesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "thursdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "fridayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "saturdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "sundayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"]
              }
        }'

응답

// HTTP/1.1 200 OK
// Content-Type: application/json;charset=UTF-8
{
  "campaignId": "3333333331",
  "id": "4444444441",
  "name": "광고그룹1",
  "config": "ON",
  "status": ["OFF_BY_BIZ_CHANNEL_WAITING", "WAITING"],
  "placements": ["PREMIUM_LINK_SEARCH_KAKAO", "PREMIUM_LINK_CONTENT_KAKAO", "PREMIUM_LINK_CONTENT_PARTNER"],
  "deviceTypes": ["PC", "MOBILE"],
  "useKeywordExtension": true,
  "exceptionKeywords": ["키워드1", "키워드2"],
  "dailyBudgetAmount": 100000,
  "dailyBudgetAmountOver": false,
  "bidAmount": 70,
  "mobileBidWeight": 150,
  "pcBidWeight": 140,
  "keywordExtensionBidWeight": 100,
  "contentBidAmount": 70,
  "schedule": {
    "beginDate": "2021-01-01",
    "endDate": "2021-02-20",
    "detailTime": true,
    "mondayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "tuesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "wednesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "thursdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "fridayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "saturdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "sundayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"]
  }
}

광고그룹 수정

기본 정보

메서드	URL	인증 방식
`PUT`	`https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}`	비즈니스 토큰

요구 사항	참고
비즈 앱 전환 비즈니스 리다이렉트 URI 등록 비즈니스 동의항목 설정	에러 코드 용어집

광고그룹을 수정합니다.

기존 광고그룹 정보를 조회한 후 수정하고자 하는 필드와 수정을 원치 않는 필드를 조합하여 요청해야 합니다. 수정을 원치 않는 필드도 기존 값으로 요청되어야 광고그룹의 정보를 유지할 수 있습니다.

요청

헤더

이름	설명	필수
Authorization	인증 방식, 비즈니스 토큰으로 인증 요청 `Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}`	O
adAccountId	광고계정 ID `adAccountId: ${AD_ACCOUNT_ID}`	O

경로 변수

이름	타입	설명	필수
ID	`Long`	광고그룹 ID	O

본문

이름	타입	설명	필수
name	`String`	광고그룹 이름	O
placements	`Enum: Placement[]`	상세 매체유형 설정 정보(기본값: 전체 매체유형)	O
deviceTypes	`Enum: DeviceTypes[]`	상세 디바이스 설정 정보(기본값: 전체 디바이스)	O
useKeywordExtension	`Boolean`	키워드확장 설정여부	O
exceptionKeywords	`String[]`	키워드확장 제외 키워드 `useKeywordExtension` 값이 `false`일 경우, `exceptionKeywords` 값이 입력되어도 미반영	X
bidAmount	`Long`	기본입찰가	O
dailyBudgetAmount	`Long`	일예산	O
mobileBidWeight	`Long`	모바일 입찰가중치	O
pcBidWeight	`Long`	PC 입찰가중치	O
keywordExtensionBidWeight	`Long`	키워드확장 입찰가중치	O
contentBidAmount	`Long`	콘텐츠매체 입찰가(기본값: 미설정)	X
schedule	`Schedule`	집행기간	O

응답

본문

이름	타입	설명
campaignId	`Long`	캠페인 ID
id	`Long`	광고그룹 ID
name	`String`	광고그룹 이름
config	`Enum: Config`	광고그룹 상태 `ON`: 활성화 `OFF`: 비활성화 참고: 광고계정 ID 입력 시 `DEL` 값 노출 가능
status	`Enum: Status[]`	광고그룹 운영상태
placements	`Enum: Placement[]`	상세 매체유형 설정 정보
deviceTypes	`Enum: DeviceTypes[]`	상세 디바이스 설정 정보
useKeywordExtension	`Boolean`	키워드확장 설정여부
exceptionKeywords	`String[]`	키워드확장 제외 키워드
dailyBudgetAmount	`Long`	일예산
dailyBudgetAmountOver	`Long`	일예산 초과 여부
bidAmount	`Long`	기본입찰가
mobileBidWeight	`Long`	모바일 입찰가중치
pcBidWeight	`Long`	PC 입찰가중치
keywordExtensionBidWeight	`Long`	키워드확장 입찰가중치
contentBidAmount	`Long`	콘텐츠매체 입찰가
schedule	`Schedule`	집행기간

예제

요청

curl -v -X PUT "https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "name": "광고그룹1",
            "placements": ["PREMIUM_LINK_SEARCH_KAKAO", "PREMIUM_LINK_CONTENT_KAKAO", "PREMIUM_LINK_CONTENT_PARTNER"],
            "deviceTypes": ["PC","MOBILE"],
            "useKeywordExtension": true,
            "exceptionKeywords": [
                  "키워드1",
                  "키워드2"
            ],
            "bidAmount": 1000,
            "dailyBudgetAmount": 2000,
            "mobileBidWeight": 150,
            "pcBidWeight": 140,
            "keywordExtensionBidWeight": 100,
            "contentBidAmount": 1000,
            "schedule": {
                  "beginDate": "2021-01-01",
                  "endDate": "2021-02-20",
                  "detailTime": true,
                  "mondayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "tuesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "wednesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "thursdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "fridayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "saturdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
                  "sundayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"]
              }
        }'

응답

// HTTP/1.1 200 OK
// Content-Type: application/json;charset=UTF-8
{
  "campaignId": "3333333331",
  "id": "4444444441",
  "name": "광고그룹1",
  "config": "ON",
  "status": ["OFF_BY_BIZ_CHANNEL_WAITING", "WAITING"],
  "placements": ["PREMIUM_LINK_SEARCH_KAKAO", "PREMIUM_LINK_CONTENT_KAKAO", "PREMIUM_LINK_CONTENT_PARTNER"],
  "deviceTypes": ["PC", "MOBILE"],
  "useKeywordExtension": true,
  "exceptionKeywords": ["키워드1", "키워드2"],
  "bidAmount": 1000,
  "dailyBudgetAmount": 2000,
  "dailyBudgetAmountOver": false,
  "mobileBidWeight": 150,
  "pcBidWeight": 140,
  "keywordExtensionBidWeight": 100,
  "contentBidAmount": 1000,
  "schedule": {
    "beginDate": "2021-01-01",
    "endDate": "2021-02-20",
    "detailTime": true,
    "mondayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "tuesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "wednesdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "thursdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "fridayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "saturdayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"],
    "sundayTime": ["1", "1", "1", "1", "1", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "0", "1", "1"]
  }
}

광고그룹 상태 변경

기본 정보

메서드	URL	인증 방식
`PATCH`	`https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}/onOff`	비즈니스 토큰

요구 사항	참고
비즈 앱 전환 비즈니스 리다이렉트 URI 등록 비즈니스 동의항목 설정	에러 코드 용어집

광고그룹의 상태를 ON 또는 OFF로 변경합니다.

광고그룹 상태가 ON 또는 OFF일 경우만 변경 가능합니다.

요청

헤더

이름	설명	필수
Authorization	인증 방식, 비즈니스 토큰으로 인증 요청 `Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}`	O
adAccountId	광고계정 ID `adAccountId: ${AD_ACCOUNT_ID}`	O

경로 변수

이름	타입	설명	필수
ID	`Long`	광고그룹 ID	O

본문

이름	타입	설명	필수
config	`Enum: Config`	광고그룹의 상태 `ON`: 활성화 `OFF`: 비활성화	O

예제

요청

curl -v -X PATCH "https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}/onOff" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "config": "OFF"
        }'

응답

HTTP/1.1 200 OK
Content-Length: 0
Content-Type: application/json;charset=UTF-8

광고그룹 기본입찰가 수정

기본 정보

메서드	URL	인증 방식
`PATCH`	`https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}/bidAmount`	비즈니스 토큰

요구 사항	참고
비즈 앱 전환 비즈니스 리다이렉트 URI 등록 비즈니스 동의항목 설정	에러 코드 용어집

광고그룹의 기본입찰가를 수정합니다.

요청

헤더

이름	설명	필수
Authorization	인증 방식, 비즈니스 토큰으로 인증 요청 `Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}`	O
adAccountId	광고계정 ID `adAccountId: ${AD_ACCOUNT_ID}`	O

경로 변수

이름	타입	설명	필수
ID	`Long`	광고그룹 ID	O

본문

이름	타입	설명	필수
bidAmount	`Long`	기본입찰가	O

예제

요청

curl -v -X PATCH "https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}/bidAmount" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "bidAmount": 1000
        }'

응답

HTTP/1.1 200 OK
Content-Length: 0
Content-Type: application/json;charset=UTF-8

광고그룹 일 예산 수정

기본 정보

메서드	URL	인증 방식
`PATCH`	`https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}/dailyBudget`	비즈니스 토큰

요구 사항	참고
비즈 앱 전환 비즈니스 리다이렉트 URI 등록 비즈니스 동의항목 설정	에러 코드 용어집

광고그룹의 일예산을 수정합니다.

요청

헤더

이름	설명	필수
Authorization	인증 방식, 비즈니스 토큰으로 인증 요청 `Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}`	O
adAccountId	광고계정 ID `adAccountId: ${AD_ACCOUNT_ID}`	O

경로 변수

이름	타입	설명	필수
ID	`Long`	광고그룹 ID	O

본문

이름	타입	설명	필수
dailyBudgetAmount	`Long`	일예산	O

예제

요청

curl -v -X PATCH "https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}/dailyBudget" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "dailyBudgetAmount": 2000
        }'

응답

HTTP/1.1 200 OK
Content-Length: 0
Content-Type: application/json;charset=UTF-8

광고그룹 입찰가중치 수정

기본 정보

메서드	URL	인증 방식
`PATCH`	`https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}/bidWeight`	비즈니스 토큰

요구 사항	참고
비즈 앱 전환 비즈니스 리다이렉트 URI 등록 비즈니스 동의항목 설정	에러 코드 용어집

광고그룹의 모바일 입찰가중치, PC 입찰가중치, 키워드확장 입찰가중치를 수정합니다.

요청

헤더

이름	설명	필수
Authorization	인증 방식, 비즈니스 토큰으로 인증 요청 `Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}`	O
adAccountId	광고계정 ID `adAccountId: ${AD_ACCOUNT_ID}`	O

경로 변수

이름	타입	설명	필수
ID	`Long`	광고그룹 ID	O

본문

이름	타입	설명	필수
mobileBidWeight	`Long`	모바일 입찰가중치	O
pcBidWeight	`Long`	PC 입찰가중치	O
keywordExtensionBidWeight	`Long`	키워드확장 입찰가중치	O

예제

요청

curl -v -X PATCH "https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}/bidWeight" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "mobileBidWeight": 100,
            "pcBidWeight": 100,
            "keywordExtensionBidWeight": 100
        }'

응답

HTTP/1.1 200 OK
Content-Length: 0
Content-Type: application/json;charset=UTF-8

광고그룹 콘텐츠 매체 입찰가 수정

기본 정보

메서드	URL	인증 방식
`PATCH`	`https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}/contentBidAmount`	비즈니스 토큰

요구 사항	참고
비즈 앱 전환 비즈니스 리다이렉트 URI 등록 비즈니스 동의항목 설정	에러 코드 용어집

광고그룹의 콘텐츠 매체 입찰가를 수정합니다.

요청

헤더

이름	설명	필수
Authorization	인증 방식, 비즈니스 토큰으로 인증 요청 `Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}`	O
adAccountId	광고계정 ID `adAccountId: ${AD_ACCOUNT_ID}`	O

경로 변수

이름	타입	설명	필수
ID	`Long`	광고그룹 ID	O

본문

이름	타입	설명	필수
contentBidAmount	`Long`	콘텐츠매체 입찰가(기본값: 미설정)	X

예제

요청

curl -v -X PATCH "https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}/contentBidAmount" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -H "Content-Type: application/json" \
    -d '{
            "contentBidAmount": 1000
        }'

응답

HTTP/1.1 200 OK
Content-Length: 0
Content-Type: application/json;charset=UTF-8

광고그룹 삭제

기본 정보

메서드	URL	인증 방식
`DELETE`	`https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}`	비즈니스 토큰

요구 사항	참고
비즈 앱 전환 비즈니스 리다이렉트 URI 등록 비즈니스 동의항목 설정	에러 코드 용어집

광고그룹을 삭제합니다.

요청

헤더

이름	설명	필수
Authorization	인증 방식, 비즈니스 토큰으로 인증 요청 `Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}`	O
adAccountId	광고계정 ID `adAccountId: ${AD_ACCOUNT_ID}`	O

경로 변수

이름	타입	설명	필수
ID	`Long`	광고그룹 ID	O

예제

요청

curl -v -X DELETE "https://api.keywordad.kakao.com/openapi/v1/adGroups/${ID}" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}"

응답

HTTP/1.1 200 OK
Content-Length: 0
Content-Type: application/json;charset=UTF-8

사이드 메뉴

시작하기

카카오디벨로퍼스

로그인

커뮤니케이션

광고

지도

내비게이션

검색

더 보기

광고 생성: 광고그룹

광고그룹 목록 조회

기본 정보

요청

헤더

쿼리 파라미터

응답

본문

예제

요청

응답

광고그룹 조회

기본 정보

요청

헤더

경로 변수

응답

본문

예제

요청

응답: 성공

광고그룹 생성

기본 정보

요청

헤더

본문

응답

본문

예제

요청

응답

광고그룹 수정

기본 정보

요청

헤더

경로 변수

본문

응답

본문

예제

요청

응답

광고그룹 상태 변경

기본 정보

요청

헤더

경로 변수

본문

예제

요청

응답

광고그룹 기본입찰가 수정

기본 정보

요청

헤더

경로 변수

본문

예제

요청

응답

광고그룹 일 예산 수정

기본 정보

요청

헤더

경로 변수

본문

예제

요청

응답

광고그룹 입찰가중치 수정