BizSpring.ai

지식센터 / 레퍼런스

BizSpring AIR™ API 소개 — BizSpring AIR™ API

description: BizSpring AIR™ 광고 데이터 API와 리포팅 API 시작 가이드입니다. REST API 인증, JSON 요청 방식, 주요 사용 흐름을 안내합니다. BizSpring AIR™ API 소개 BizSpring AIR™ API 시작 가이드 BizSpring

핵심 요약

    ---

    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™ 의 핵심 가치

    ① 멀티 매체 통합

    광고주나 에이전시가 관리하는 모든 광고 매체의 성과 데이터를 통합합니다.

    ② 자동 리포팅

    매일 아침, 전일자 광고 성과 데이터가 자동으로 취합·가공되어 제공됩니다.

    ③ 데이터 결합 분석

    광고 매체 성과 데이터 + 비즈스프링 LOGGER™ 행동 데이터를 결합하여 더욱 정밀한 성과 분석이 가능합니다.

    ④ Growth Platform™ 연계

    AIR™ 는 비즈스프링 Growth Platform™ (오픈형 CDP)의 핵심 모듈로:

    AIR™ API 란?

    AIR™ API는 플랫폼에서 수집·가공된 통합 광고 성과 데이터를 외부 시스템에서 직접 조회할 수 있도록 제공되는 RESTful API입니다.

    기존 방식AIR™ API 활용
    각 매체별 API 토큰 발행 필요✅ AIR™ 토큰 하나로 모든 매체 데이터 조회
    매체마다 다른 데이터 구조 파악 필요✅ 통합된 공통 지표와 차원 체계
    개발자 인력 투입 및 유지보수 부담✅ 비즈스프링이 매체 API 변경사항 관리
    매체별 데이터를 직접 가공·병합✅ 가공·병합 완료된 데이터를 바로 수신

    주요 활용 사례

    지원 광고 매체

    구분지원 매체
    검색광고 (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&#x26;token=26c98ff6-ee23-4c99-ac6b-175c22425c21" alt="BizSpring AIR™"><figcaption><p>BizSpring AIR™</p></figcaption></figure></div>

    {% hint style="info" %}

    웹사이트에서 BizSpring AIR™ 서비스의 전반적 기능을 확인할 수 있습니다.

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

    다른 표현: Markdown · JSON · 최종 갱신 2026-08-23