[파이썬] 다음 카카오 광고 캠페인 API 발급 및 광고 데이터 추출

파이썬 다음 카카오 광고 캠페인 API 발급 및 광고 데이터 추출

다음 카카오 광고 캠페인 API 발급

카카오 광고 캠페인 API를 사용하면, 카카오 광고 관리 콘솔에서 하는 것과 동일한 기능을 프로그램으로 수행할 수 있습니다. 이를 위해서는 먼저 카카오 개발자 콘솔에서 광고 API를 사용할 수 있는 권한을 받아야 합니다.

카카오 개발자 콘솔에 로그인합니다.
상단 메뉴에서 [내 애플리케이션] > [애플리케이션 등록]을 클릭합니다.
애플리케이션 이름과 설명을 작성하고, 광고 API를 사용할 수 있도록 체크합니다.
애플리케이션을 등록합니다.
애플리케이션 상세정보 페이지에서 [애플리케이션 키]를 확인합니다.
애플리케이션 키를 이용해 API를 호출할 때 사용합니다.

카카오 광고 캠페인 API를 사용하려면 애플리케이션 키를 이용하여 인증을 해야합니다. 인증은 다음과 같은 방식으로 할 수 있습니다.

OAuth2.0 인증 : 카카오 계정으로 로그인하면서 애플리케이션에 권한을 부여할 수 있는 인증방식입니다.
API Key 인증 : 애플리케이션 키를 이용해 인증하는 방식입니다.
여기서는 API Key 인증을 사용하며, 헤더에 Authorization 키에 'KakaoAK {APP_KEY}'를 추가하여 인증합니다.

카카오 광고 캠페인 API를 사용하면, 캠페인 생성, 수정, 삭제, 조회 등의 기능을 수행할 수 있습니다. 자세한 API 문서를 참고하여 사용하시길 권장드립니다.

예를들어, 새로운 캠페인을 생성하는 API를 호출하려면 다음과 같이 할 수 있습니다. 이 코드는 이름이 "Test Campaign" 이고, 일일 예산이 100000원인 캠페인을 생성하는 API 호출 코드입니다. 캠페인 생성에 필요한 파라미터들은 data 변수에 JSON 형식으로 전달하며, 응답은 response.json()으로 확인할 수 있습니다. 카카오 광고 캠페인 API를 사용하면, 일반적인 광고 관리 작업을 프로그램으로 수행할 수 있어 효율적이고 정확한 광고 관리를 할 수 있습니다. 개발자 콘솔에서 API 문서를 참고하여 사용하시길 권장드립니다.

import requests
import json

url = 'https://api.kakao.com/v1/ad/campaign'
headers = {
    'Authorization': 'KakaoAK {APP_KEY}',
    'Content-Type': 'application/json'
}
data = {
    'name': 'Test Campaign',
    'daily_budget': 100000,
    'start_time': '2022-01-01T00:00:00+09:00',
    'end_time': '2022-12-31T23:59:59+09:00',
    'time_zone': 'UTC+09:00'
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

카카오 로그인 활성화

아래의 오류가 있을시 하기 이미지의 설정을 확인해 보시길 바랍니다.

KOE004

카카오 로그인이 비활성화되어 있는 경우

[내 애플리케이션] > [카카오 로그인]에서 카카오 로그인 기능을 활성화시킵니다.

access token 발급받기

카카오 광고 API를 사용하려면 access token이 필요합니다. access token은 아래 이미지를 참고하여 애플리케이션 키를 이용하여 발급받을 수 있습니다.

https://developers.kakao.com/tool/rest-api/open/get/v2-user-me

카카오계정

accounts.kakao.com

파이썬 다음 카카오 광고 캠페인 광고 데이터 추출

아래 파이썬 코드는 카카오 광고계정에 대한 리포트를 가져오는 코드입니다. 요청 URL, 헤더, 파라미터를 설정해 요청을 보냅니다.

- access_token 변수는 사용자가 카카오 개발자 콘솔에서 발급받은 access token 값을 입력해야 합니다.
- adAccountId 헤더는 조회하고자 하는 광고계정의 ID 값을 입력해야 합니다.
- params 변수는 조회하고자 하는 리포트의 날짜범위, 지표그룹, 시간단위를 설정할 수 있습니다.
- 요청을 보낸 후, 응답을 JSON 형식으로 변환해 response 변수에 저장합니다.
응답 데이터는 response['data']로 접근할 수 있습니다. 해당 파이썬 코드는 키워드 광고 관련 API를 사용하기 위해 필요한 정보만 포함되어 있으며, 일부 설명이 누락되어 있을 수 있습니다. 광고 관련 API를 사용하기 전에 카카오 개발자 콘솔에서 필요한 정보를 얻고, API 문서를 참고하시길 권장드립니다.

import requests
import json


#1. 카카오 로그인 활성화

#아래의 오류가 있을시 하기 이미지의 설정을 확인 한다.
#KOE004 코드 오류의 문제는 카카오 로그인이 비활성화되어 있는 경우로, 이는 [내 애플리케이션] > [카카오 로그인]에서 카카오 로그인 기능을 활성화시키면 해결된다.

#https://developers.kakao.com/console/app/833965/product/login

#https://developers.kakao.com/tool/rest-api/open/get/v2-user-me 사용자 정보 내에서 액세스 토큰 발급 (access token)


url ='https://api.keywordad.kakao.com/openapi/v1/adAccounts/report'  #광고계정기준 리포트

access_token = ''  #카카오 키워드광고 access token 발급키

headers = {
    'Authorization': 'Bearer ' + access_token,  #엑세스 토큰
    'adAccountId': '' #광고계정ID
}

params = {
    'metricsGroups' : 'BASIC',  #기본
    'start' : '20230109', #보고서 조회 시작일 (yyyyMMdd)
    'end' : '20230114', #보고서 조회 종료일 (yyyyMMdd)
    'timeUnit' : 'DAY'  #일간
}


#지표관련 내용
#https://developers.kakao.com/docs/latest/ko/keyword-ad/reference#MetricsGroups

# 응답 JSON 형식으로 변환
r = requests.get(url, headers=headers, params = params)

response = json.loads(r.content)

response['data']

퍼포먼스 마케팅 데이터 분석

[파이썬] 다음 카카오 광고 캠페인 API 발급 및 광고 데이터 추출