> For the complete documentation index, see [llms.txt](https://docs.bizspring.co.kr/bizspring-air-tm-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bizspring.co.kr/bizspring-air-tm-api/introduction/bizspring-air-tm-api.md).

# 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](https://ko.wikipedia.org/wiki/REST) 방식으로 동작합니다. 응답 데이터는 [JSON](https://ko.wikipedia.org/wiki/JSON) 형식으로 제공합니다.

다음과 같은 용도에 적합합니다.

* 광고 매체별 리포팅 데이터 자동 수집
* 사내 대시보드 및 데이터 파이프라인 연동
* 통합 광고 성과 리포트 생성

<div data-full-width="false"><figure><img src="/files/stQHQ5kE0DvIM9YhO9rz" alt="BizSpring AIR™"><figcaption><p>BizSpring AIR™</p></figcaption></figure></div>

{% hint style="info" %}
웹사이트에서 BizSpring AIR™ 서비스의 전반적 기능을 확인할 수 있습니다.

[BizSpring AIR™ 웹사이트 바로가기](< https://growthplatform.ai/gmp/prd_air.php>)
{% endhint %}

### API 사용 준비하기

BizSpring AIR™ API를 처음 사용하는 경우 아래 순서로 진행합니다.

{% content-ref url="/pages/xf2yvQ9S7RdeytFmOEHR" %}
[API 사용을 위한 순서](/bizspring-air-tm-api/getting-started/api.md)
{% endcontent-ref %}

{% content-ref url="/pages/8UxO0aiZz6wZurSQDPd5" %}
[Growth Platform™ 계정 생성](/bizspring-air-tm-api/getting-started/growth-platform-tm.md)
{% endcontent-ref %}

### 이미 API 사용 권한이 있는 경우

이미 BizSpring AIR™ API 계정을 보유한 경우 아래 문서에서 **인증 토큰 발급**, **리포팅 API 요청**, **메타데이터와 코드값**을 확인합니다.

{% content-ref url="/pages/UStLvmGyPcHeKP8Ts6zB" %}
[Auth Token(인증 토큰) 발행](/bizspring-air-tm-api/bizspring-air-tm-api-spec./auth-token.md)
{% endcontent-ref %}

{% content-ref url="/pages/xAP2LIyeqYh2gVPsMNz0" %}
[AIR™ Reporting API](/bizspring-air-tm-api/bizspring-air-tm-api-spec./air-tm-reporting-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/3ZyB9vdEZBEWnbvBXPKY" %}
[MetaData/Code](/bizspring-air-tm-api/bizspring-air-tm-api-spec./metadata-code.md)
{% endcontent-ref %}