BizSpring AIR™ API 소개 — BizSpring AIR™ API
핵심 요약
---
description: >-
BizSpring AIR™ 광고 데이터 API와 리포팅 API 시작 가이드입니다. REST API 인증, JSON 요청 방식, 주요 사용
흐름을 안내합니다.
---
# BizSpring AIR™ API 소개
BizSpring AIR™ API 시작 가이드
BizSpring AIR™ 란?
BizSpring AIR™ (Ad Intelligence Report)는 비즈스프링이 제공하는 광고 매체 통합 리포팅 솔루션입니다.
네이버, 카카오, 구글, 메타(Facebook/Instagram), 크리테오, 틱톡 등 국내외 주요 광고 플랫폼의 성과 데이터를 단 1회 계정 연동만으로 매일 자동으로 수집·통합하여, 하나의 통합 리포트로 제공합니다.
> 💡 한 줄 요약: 여러 광고 매체를 일일이 접속하지 않아도, AIR™ 하나로 전체 광고 성과를 한눈에 파악할 수 있습니다.
AIR™ 의 핵심 가치
① 멀티 매체 통합
광고주나 에이전시가 관리하는 모든 광고 매체의 성과 데이터를 통합합니다.
- 키워드 검색광고: 네이버 SA, 카카오 키워드, 구글 Ads
- 디스플레이/SNS: 메타, 카카오모먼트, 네이버 GFA, 크리테오, 틱톡, 데이블 등
② 자동 리포팅
매일 아침, 전일자 광고 성과 데이터가 자동으로 취합·가공되어 제공됩니다.
- 일·주·월 단위 정기 리포트 스케줄링
- 이메일 / 슬랙 등 자동 발송
③ 데이터 결합 분석
광고 매체 성과 데이터 + 비즈스프링 LOGGER™ 행동 데이터를 결합하여 더욱 정밀한 성과 분석이 가능합니다.
④ Growth Platform™ 연계
AIR™ 는 비즈스프링 Growth Platform™ (오픈형 CDP)의 핵심 모듈로:
- 고객 여정 전체 분석
- 타겟 오디언스 세그먼트 생성
- AI 기반 캠페인 최적화 와 연계할 수 있습니다.
AIR™ API 란?
AIR™ API는 플랫폼에서 수집·가공된 통합 광고 성과 데이터를 외부 시스템에서 직접 조회할 수 있도록 제공되는 RESTful API입니다.
| 기존 방식 | AIR™ API 활용 |
|---|---|
| 각 매체별 API 토큰 발행 필요 | ✅ AIR™ 토큰 하나로 모든 매체 데이터 조회 |
| 매체마다 다른 데이터 구조 파악 필요 | ✅ 통합된 공통 지표와 차원 체계 |
| 개발자 인력 투입 및 유지보수 부담 | ✅ 비즈스프링이 매체 API 변경사항 관리 |
| 매체별 데이터를 직접 가공·병합 | ✅ 가공·병합 완료된 데이터를 바로 수신 |
주요 활용 사례
- 맞춤형 광고 성과 대시보드 구축 (Looker Studio, Tableau, Power BI 등)
- 사내 보고서 자동화 (Google Sheets, Slack 봇 등)
- AI/ML 모델 입력 데이터 파이프라인
- 내부 데이터(매출, 주문)와의 결합 분석
지원 광고 매체
| 구분 | 지원 매체 |
|---|---|
| 검색광고 (SA) | 네이버 검색광고, 카카오 키워드광고, 구글 Ads |
| 디스플레이 (DA) | 네이버 GFA, 카카오모먼트, 메타, 크리테오, 틱톡, 데이블, 모비온 |
비즈스프링 솔루션 생태계에서의 위치
Growth Platform™ (오픈형 CDP)
├── AIR™ ← 광고 매체 성과 통합 리포팅 (이 문서)
├── LOGGER™ ← 웹/앱 사용자 행동 분석
├── TAM™ ← 타겟 오디언스 세그먼트 추출
├── CXM™ ← 마케팅 캠페인 자동화
└── ADMonster™ ← 키워드 자동입찰 관리
기술 구성
API는 REST 방식으로 동작합니다. 응답 데이터는 JSON 형식으로 제공합니다.
다음과 같은 용도에 적합합니다.
- 광고 매체별 리포팅 데이터 자동 수집
- 사내 대시보드 및 데이터 파이프라인 연동
- 통합 광고 성과 리포트 생성
<div data-full-width="false"><figure><img src="https://3087586734-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUJ9uzvHT9r6QImnjP8p4%2Fuploads%2Fl5ZB54iXRruZRqcwl2c2%2FAIR-Architecture.png?alt=media&token=26c98ff6-ee23-4c99-ac6b-175c22425c21" alt="BizSpring AIR™"><figcaption><p>BizSpring AIR™</p></figcaption></figure></div>
{% hint style="info" %}
웹사이트에서 BizSpring AIR™ 서비스의 전반적 기능을 확인할 수 있습니다.
{% endhint %}
API 사용 준비하기
BizSpring AIR™ API를 처음 사용하는 경우 아래 순서로 진행합니다.
{% content-ref url="../getting-started/api" %}
[api](../getting-started/api)
{% endcontent-ref %}
{% content-ref url="../getting-started/growth-platform-tm" %}
[growth-platform-tm](../getting-started/growth-platform-tm)
{% endcontent-ref %}
이미 API 사용 권한이 있는 경우
이미 BizSpring AIR™ API 계정을 보유한 경우 아래 문서에서 인증 토큰 발급, 리포팅 API 요청, 메타데이터와 코드값을 확인합니다.
{% content-ref url="../bizspring-air-tm-api-spec./auth-token" %}
[auth-token](../bizspring-air-tm-api-spec./auth-token)
{% endcontent-ref %}
{% content-ref url="../bizspring-air-tm-api-spec./air-tm-reporting-api" %}
[air-tm-reporting-api](../bizspring-air-tm-api-spec./air-tm-reporting-api)
{% endcontent-ref %}
{% content-ref url="../bizspring-air-tm-api-spec./metadata-code" %}
[metadata-code](../bizspring-air-tm-api-spec./metadata-code)
{% endcontent-ref %}