마케팅 대시보드 자동화 프로그램
일식일식 ·
개요
제작 목적
회사 마케팅 분석 간편화 및 퍼포먼스 마케팅 비용 집행 자동화를 위해 제작
현재 메타에서 제공하는 광고관리자는 느리고 회사에 핏하지 않아 불편함
그리고 여러가지 광고 플랫폼 데이터를 합산해서 확인하기 위해 제작
추가적으로 이를 이용해 cs 및 재고 관리 시스템까지 맞물려 돌아가게 진행할 예정
제작 도구
파이썬, flet 라이브러리
개발기
초반 작업들
파이썬, flet을 이용해 facebook api와 엑셀 출력 라이브러리 등을 넣어 메타에서 데이터를 얻어와 출력하는 기능까진 완성했다. 얻어오는 데이터엔 roas, ctr, lp_cost, spend 가 중점적이었음.
- 어려웠던 부분들
페이스북 api 권한을 얻기 위해 키를 발급하는 과정이 있는데 구글링을 해봐도 초반 앱 세팅에 대한 자료가 버전 차이 때문에 적용이 안되는 일이 있었다. 많이 찾아보고 다양하게 시도해서 결국 발급 받았고 이 과정에서 회사에선 아예 모르는 영역이다보니까 권한 요청하면 다 해주셔서 다행히 끝냈다.
플랫 라이브러리를 처음 써보는데 제미나이한테 도움 받아서 만들었지만 제미나이는 계속 예전 버전의 호출 방식으로 함수를 만들어줘서 결국 플랫 공식 문서를 확인해서 코드를 거의 다 수정해야 했었다.
26년 5월 2주차
영상 광고의 구간 별 조회 비율 기능을 추가한다. 컨텐츠 팀에서 영상 성과 분석을 할 때 초반 이미지 후킹이 됐는지를 확인하기 위함. facebook api에서 지원하는 기능인데 컨텐츠 마케팅 영역에서 초반 3초 후킹과 액션 포인트 이 두가지를 중점적으로 타겟팅을 하는데, 이를 효율적으로 분석하기 위함. 현재 엑셀 파일로 출력해서 분석을 하고 있는데 이 방식에서는 이게 조금 불편할 수 있겠다는 생각이 든다.
카페24 api 연동하기
1. 카페24 개발자센터 등록 및 앱 생성
API를 사용하기 위한 자격 증명(Credentials)을 확보하는 단계입니다.
개발자 등록: 카페24 개발자센터에 가입 후 로그인합니다.
앱 생성: [앱 관리] > [앱 등록] 메뉴에서 'Cafe24 Analytics' 관련 권한을 가진 앱을 신규 생성합니다.
키 저장: 앱 생성이 완료되면 고유의 Client ID와 Client Secret Key가 발급됩니다. 프로그램 환경변수(.env) 등에 안전하게 보관하세요.
2. OAuth 2.0 인증 및 토큰 발급
카페24 API는 보안을 위해 OAuth 2.0 프로토콜을 사용하므로, 데이터 접근 권한을 얻는 인증 로직을 구현해야 합니다.
Scope 설정: 앱 설정에서 대시보드에 표현할 데이터(방문자수, 유입 경로, 상품 매출, 주문 통계 등)의 접근 권한(Scope)을 체크합니다.
인증코드(Authorization Code) 획득: 쇼핑몰 관리자 권한으로 로그인 동의 팝업을 거쳐 인증코드를 최초 1회 발급받습니다.
토큰(Token) 발급: 발급받은 인증코드를 사용해 카페24 토큰 발급 엔드포인트로 POST 요청을 보내 Access Token(데이터 호출용)과 Refresh Token(토큰 갱신용)을 획득하고 DB에 저장합니다.
3. API 엔드포인트 연동 (데이터 수집)
개발하시는 언어(Python, C# 등)의 HTTP 클라이언트 라이브러리를 사용해 필요한 데이터를 주기적으로 호출합니다. 마케팅 대시보드용 핵심 엔드포인트는 아래와 같습니다.
방문자 및 PV: GET [https://ca-api.cafe24data.com/visitors/pageview](https://ca-api.cafe24data.com/visitors/pageview) (트래픽 추이 분석)
마케팅 유입 경로: GET [https://ca-api.cafe24data.com/visitpaths/domains](https://ca-api.cafe24data.com/visitpaths/domains) (UTM 파라미터 및 검색어, 외부 유입 도메인 분석)
상품별 매출: GET [https://ca-api.cafe24data.com/products/sales](https://ca-api.cafe24data.com/products/sales) (기여 상품 및 판매 건수)
시간대별 매출: GET [https://ca-api.cafe24data.com/sales/times](https://ca-api.cafe24data.com/sales/times) (전환 피크 타임 파악)
4. 자동화 파이프라인 및 백엔드 로직 구축 (중요)
호출 스크립트가 에러 없이 안정적으로 돌기 위해 백엔드에서 반드시 처리해야 하는 필수 예외 로직입니다.
토큰 자동 갱신 (Refresh Token): Access Token은 보통 유효기간이 짧습니다. API 호출 시 만료 에러(401 Unauthorized)가 나거나 만료 시간에 임박했을 때, 저장해 둔 Refresh Token을 사용하여 자동으로 토큰을 재발급받는 인터셉터(Interceptor)나 예외 처리 로직을 짜야 합니다.
페이징(Pagination) 처리: 카페24 API는 한 번에 최대 100개의 데이터만 반환하므로, 누적 데이터가 많을 경우 offset 혹은 page 파라미터를 활용해 반복문(Loop)을 돌며 전체 데이터를 수집해야 합니다.
Rate Limit(요청 제한) 대응: 카페24는 초당 요청 제한이 엄격합니다. 사용자가 대시보드를 열 때마다 실시간으로 카페24 API를 때리면 차단될 위험이 큽니다. 따라서 매일 새벽 크론탭(Crontab)이나 스케줄러를 돌려 하루치 데이터를 사내 자체 데이터베이스(MySQL, PostgreSQL 등)에 배치(Batch) 적재해 두는 아키텍처를 추천합니다.
5. 매체 데이터 결합 및 시각화
수집한 쇼핑몰 데이터와 매체 광고비를 매칭하고 화면에 뿌려주는 단계입니다.
광고비 데이터 결합: 메타(Meta), 구글(Google) 광고 API 등을 통해 가져온 일별 광고비 데이터를 카페24의 매출 데이터와 UTM 파라미터 기준으로 조인(Join)하여 실시간 매체별 ROAS를 계산합니다.
대시보드 표현:
공수를 줄이려면 수집된 DB 데이터를 구글 루커 스튜디오(Looker Studio)나 태블로에 연결하여 시각화합니다.
커스텀 사내 어드민이 필요하다면 자체 웹 프레임워크 백엔드 API를 파서 Chart.js나 D3.js 같은 라이브러리로 대시보드 UI를 직접 빌드합니다.
🛠️ 어드민 계정이 없는 사원의 실무 연동 절차
부운영자 계정도 없는 상황이라면, 앞서 말씀드린 '방법 B(인증 링크 전달)'를 조금 더 디테일하게 활용하시면 됩니다. 로컬 개발 환경에서 테스트할 때 가장 많이 쓰는 방식입니다.
1. 개발자센터 설정 (사원 본인)
카페24 개발자센터에 개인 계정으로 가입하고 앱을 만듭니다.
앱 설정 메뉴 중에 'Redirect URI'라는 항목이 있습니다. 인증이 성공하면 코드를 넘겨받을 주소인데, 지금은 서버가 없거나 개발 중일 테니 일단 아무 주소(예: http://localhost:3000 또는 회사 홈페이지 주소 등)나 입력해 둡니다.
2. 인증 요청 주소(URL) 생성 (사원 본인)
개발자 가이드를 참고하여 브라우저 주소창에 넣을 인증 URL을 조합합니다. 대략 이런 형태가 됩니다.
https://{회사쇼핑몰ID}[.cafe24api.com/api/v2/oauth/authorize?client_id=](https://.cafe24api.com/api/v2/oauth/authorize?client_id=){내앱의ClientID}&redirect_uri={내가적은RedirectURI}&scope=malloc_api_scope
3. 마스터에게 링크 토스 (대표님 또는 총괄 관리자)
위에서 만든 긴 URL 주소를 복사해서 마스터 권한을 가진 분(대표님이나 팀장님)에게 메신저로 보냅니다.
"대표님, 저희 마케팅 대시보드 자동화 때문에 카페24 권한 승인이 딱 한 번 필요합니다. 이 링크 들어가셔서 로그인하시고 승인 버튼 하나만 눌러주세요!" 라고 요청합니다.
4. 주소창에 찍힌 '코드' 회수
대표님이 로그인 후 [동의함/앱 설치]를 누르면, 대표님의 브라우저 화면이 사원님이 아까 적어둔 Redirect URI 주소로 자동 이동(리다이렉트)됩니다.
이때 이동된 주소창 맨 뒤를 보면 ?code=abc123xyz... 같은 형태로 Authorization Code(인증 코드)가 붙어 있습니다.
대표님께 "화면은 안 나와도 되니, 바뀐 주소창의 주소 전체를 그대로 복사해서 저에게 보내달라"고 요청하여 그 코드를 전달받습니다.
5. 최종 토큰 발급 (대시보드 프로그램 완성)
전달받은 code 값과 사원님 앱의 Client Secret Key를 가지고 프로그램(Postman이나 Python 스크립트 등)에서 카페24로 토큰 발급 요청(POST)을 보냅니다.
여기서 나오는 Access Token과 Refresh Token을 확보하면 끝입니다!
💡 한 줄 요약
사원님은 쇼핑몰 계정이 없어도 되며, 개발자센터 계정만 있으면 됩니다. 로그인과 승인은 링크를 통해 마스터 계정을 가진 사람에게 대행시키고, 승인 결과물(코드)만 쏙 가로채서 프로그램에 넣으면 권한 연동이 완료됩니다.
5월 4주차
- 웹페이지로의 변동을 진행하고 있다. 웹 서버 형식으로 되어서 특정 시간에 일별 데이터를 얻어오고 내가 수집을 누르면 들고 있는 데이터를 보여주는 방식으로 진행하려 한다.
- db는 postgreSQL을 사용할 예정이다. 서버 컴퓨터에 설치가 필요하다.
->완료함..
6월 1주차
추가로 할 작업 : cafe24 데이터 연동
이를 위해 일단 https 접속이 가능하도록 ssl인증서 연결을 해줬다.
먼저 카페24데이터를 얻어오려면 카페24 개발자 센터에 대표 계정으로 로그인을 한다.
앱 등록 -> 앱 생성 과정을 거치면서 등록해야되는 정보들이 있음