퍼포먼스 마케팅 단순 반복 업무 찾기
퍼포먼스 마케터분들은 업무 중에 어떤 게 가장 귀찮으신가요?
저는 리포트 만드는 게 가장 귀찮더라고요.
매일 아침마다 매체 광고 관리자에 접속해서 전일 데이터 다운로드받고,
구글 스프레드 시트에 복붙한 뒤에 리포트 탭에서 데이터 분석을 진행하죠.
단순 반복 작업인데 운영하는 매체가 많을수록 시간도 많이 잡아먹죠.
그래서 이번에 광고 관리자에 접속하지 않고도 스프레드 시트에 자동으로 광고 데이터를 불러오는 방법을 알아봤어요.
API로 광고 데이터 불러오기 자동화
바로 API를 활용한 방법입니다.
구글, 메타, 네이버, 카카오 등 매체별로 개발자 사이트에서 API를 제공하고 있어요.
이 API만 있으면 매일 아침마다 매체 광고 관리자에 접속해서 데이터를 다운받고 스프레드 시트에 복붙하는 일을 직접 하지 않아도 돼요.
메타(Meta) 마케팅 API 발급 방법
그럼 우선 API를 발급받는 과정을 보여드릴게요.
이번 글에서는 메타(Meta)를 기준으로 설명드리겠습니다.
다음과 같은 순서로 진행됩니다.
- 메타 개발자 사이트 접속
- 내 앱 만들기
- 메타 마케팅 API 토큰 발급
- 토큰 유효기간 교체
1. 메타 개발자 사이트 접속
구글에 '메타 개발자'를 검색하면 아래 이미지처럼 검색 결과 페이지 상단에 메타 개발자 사이트가 떠요!
링크도 남겨둘게요!
https://developers.facebook.com/?locale=ko_KR
소셜 테크놀로지 | Meta for Developers
2025년 10월 16일 Ads Insights API Metric Availability Updates We continuously review the metrics we offer advertisers to ensure that they are accurate, intuitive, and valuable. To continue meeting our high standards, we will limit availability for certa
developers.facebook.com
사이트에 들어가시면 아래처럼 메인 페이지가 뜨게 됩니다.
우측 상단에 로그인 버튼을 클릭해서 로그인해주세요.
로그인할 계정은 광고 관리자에 접속할 때 사용하는 계정으로 하시면 됩니다.
*버튼 클릭 후 인증 과정이 있을 수 있습니다.
2. 내 앱 만들기
로그인이 완료되면 우측 상단에 '내 앱' 버튼이 뜹니다.
해당 버튼을 눌러주세요.
*버튼 클릭 후 인증 과정이 있을 수 있습니다.
위와 유사한 '내 앱' 대시보드 화면이 뜰텐데요.
좌측에 '비즈니스 포트폴리오' 영역의 드롭다운을 눌러 운영중인 광고 계정이 속한 비즈니스 포트폴리오를 선택한 뒤,
우측 상단에 '앱 만들기' 초록색 버튼을 눌러주세요.
앱 만들기 과정은 아래와 같이 진행됩니다.
1) 앱 상세 정보
- 앱 이름: 어떤 역할을 하는 앱인지 구분할 수 있도록 이름을 입력해주세요. (예시: ads_report)
- 앱 연락처 이메일: 자동으로 로그인한 계정의 이메일으로 입력되어 있을 거에요.
2) 이용 사례
- 이용 사례는 어떤 기능을 이용할 건지 선택하는 거라고 이해하시면 됩니다.
- 광고 데이터를 불러오기 위해서는 '마케팅 API로 광고 만들기 및 관리'를 필수로 선택해주세요.
3) 비즈니스
- 비즈니스 포트폴리오를 선택하는 단계로, 운영중인 광고 계정이 속한 비즈니스 포트폴리오를 선택해주세요.
4) 요구 사항
- 이 단계는 위 이미지처럼 설정할 게 없어요. 완료된 이후에 설정하면 됩니다.
5) 개요
- 마지막으로 개요 단계에서 설정된 사항을 확인하고 앱 만들기를 클릭하면 비밀번호 입력 창이 뜹니다.
- 비밀번호를 입력해서 앱 만들기를 완료해주세요.
3. 메타 마케팅 API 토큰 발급
앱 만들기가 완료되면 위 이미지와 같은 화면이 뜰거에요.
화면 중앙에 '마케팅 API로 광고 만들기 및 관리 맞춤 설정 이용 사례'를 클릭해주세요.
이 곳에서는 api로 불러올 수 있는 데이터 항목들을 설정할 수 있습니다.
이미 '앱 만들기'과정에서 '마케팅 API로 광고 만들기 및 관리' 이용 사례를 선택했기 때문에 추가로 설정해야 할 부분은 없습니다.
이제 마지막으로 좌측에 있는 '도구'를 클릭하여 API 토큰을 발급받으러 갑시다!
중앙에 '토큰 권한 선택'이 있죠.
필수로 'ads_read', 'ads_management', 'business_management'를 선택해줘야 해요.
5개 모두 선택해도 무방하고요.
각각의 권한을 짧게 설명해드릴게요.
- 광고 데이터 조회: 광고 계정의 성과 보고서나 지표를 읽어올 수 있는 권한입니다.
- 데이터 시각화나 대시보드 제작 시 필수적입니다.
- 광고 계정 관리: 캠페인 생성, 광고 수정, 예산 변경 등 광고를 직접 관리할 수 있는 권한입니다.
- 프로그램으로 광고 운영을 자동화할 때 사용합니다.
- 비즈니스 자산 관리: 비즈니스 관리자 내의 자산(광고 계정, 페이지 등)을 수정하거나 소유권을 관리하는 상위 권한입니다.
- 광고 계정 연결 상태 확인 등에 쓰입니다.
- 페이지 콘텐츠 읽기: 페이지의 포스트, 사진, 동영상 및 팔로워 데이터를 읽을 수 있는 권한입니다.
- 페이지 인사이트 데이터를 가져오기 위해 필요합니다.
- 페이지 목록 확인: 사용자가 관리하는 페이스북 페이지들의 리스트를 확인할 수 있는 권한입니다.
- 특정 페이지를 선택하는 메뉴를 만들 때 기본적으로 필요합니다.
'토큰 받기'를 클릭해주시면 바로 아래 토큰이 나옵니다.
따로 저장이 안되고 동일한 토큰을 재발급할 수 없으니 복사해주세요.
4. 토큰 유효기간 교체
위 방식으로 발급받은 토큰은 유효기간이 정해져 있어요.
보통 60일이 지나면 만료되기 때문에 장기간 사용 시 토큰 만료로 데이터를 불러올 수 없고,
2개월에 한번씩 재발급받아야 하는 번거로움이 생기죠.
그렇지만 유효기간이 만료되지 않는 토큰으로 변경할 수 있습니다.
상단 탭에 '도구'를 클릭하면 '그래프 API 탐색기'가 있습니다. 클릭해주세요.
그래프 API 탐색기 화면입니다.
발급받아 복사해둔 토큰을 우측 '엑세스 토큰' 칸에 붙여넣기 해주세요.
그 아래 'Meta 앱'은 처음에 만들었던 앱을 선택해주세요.
그리고 아래 이미지처럼 주소 창에 me/accounts 를 입력해주세요.
입력 후 우측에 '제출' 버튼을 클릭해주시면 끝입니다!
너무 간단하죠?
진짜 유효기간이 변경되었는지 확인하는 방법도 있습니다.
상단 '도구' 탭에 '엑세스 토큰 디버거'가 있습니다.
여기에서 토큰을 입력한 뒤 디버그 버튼을 클릭하시면 토큰에 대한 정보가 나옵니다.
'만료일'을 확인해보시면 특정 기간이 적혀있지 않고 '받지 않기'로 되어 있다면 유효기간이 만료되지 않도록 변경된 겁니다!
이 과정까지 완료되었다면, 여러분도 메타 광고 리포트 자동화를 바로 시작하실 수 있습니다.
'메타 광고 리포트 자동화 구축기 2편'에서는 구글 앱스 스크립트에서 메타 마케팅 API로 광고 데이터를 불러와 구글 스프레드 시트에 적재하는 과정을 써보도록 하겠습니다.
여기까지 읽어주신 분들에게 감사드리며 2편이 완료되면 아래에 게시물 링크 추가해둘게요!
'퍼포먼스 마케팅' 카테고리의 다른 글
| 마케터가 직접 짜본 GA4 리포트 자동화 구조: 막히는 구간과 돌파구 정리 (0) | 2026.05.19 |
|---|---|
| 퍼포먼스 마케터의 광고 리포트 업무 자동화해봄 (0) | 2026.05.15 |