# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bizspring.co.kr/bizspring-air-tm-api/introduction/bizspring-air-tm-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.