> For the complete documentation index, see [llms.txt](https://docs.bizspring.co.kr/growth-platform-user-guide/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/growth-platform-user-guide/air-gpts.md).
# AIR GPTs 알파 버전 이용 가이드
## AIR GPTs 알파버전 이용가이드
### 1. 안내문 (Intro)
#### GPTs for Growth Platform v2 란?
GPTs for Growth Platform v2는 비즈니스 데이터 분석을 쉽게 만들어주는 맞춤형 ChatGPT 서비스입니다.\
이 서비스는 GrowthPlatform API와 연결되어 있어, 마케팅·광고·성과 지표 데이터를 대화하듯 질문하고 바로 분석할 수 있습니다.
**예시:**
```plaintext
질문: "지난주 캠페인별 전환 수 보여줘"
결과: 즉시 표 형태로 결과 출력
```
> 👉 **GPTs for Growth Platform을 처음 접하신 경우**,\
> [시작 가이드](/growth-platform-user-guide/gpts-for-growth-platform.md) 를 먼저 확인하시면 AIR GPTs 시험버전 활용에 도움이 됩니다.
***
### 2. 사용방법 및 주요기능
아래 단계별로 상세 기능과 주의사항을 확인하세요.
***
**① API 키 발급**
* GrowthPlatform 관리자 계정으로 로그인합니다.
* **API 확인 경로**: 좌측 메뉴 `[데이터 소스] > [데이터 소스 연결] > [GPT API 키 관리]` 클릭
> ⚠️ **주의:** 발급받은 키는 안전하게 보관하고 외부 공유를 금지하세요.
***
**② 챗 링크 접속 및 API 키 입력**
* GPTs for Growth Platform v2 전용 챗 링크 접속
* [GPTs for Growth Platform v2 바로가기](https://chatgpt.com/g/g-686727a066508191bc753e695fafd779-gpts-for-growth-platform-v2)
* **API 키 입력**: 전용 챗 접속 후 `api_key=발급받은_키` 형식으로 입력
* 입력 후 채팅에서 데이터 질의 가능
***
**③ 리포트 조회**
* `"어떤 리포트 조회할 수 있어?"`라고또는`"리포트 목록 보여줘"`라고 명령어를입력하면면, 연결 가능한 리포트 목록을 확인할 수 있습니다.
* **연결 가능한 리포트 예시**
```plaintext
광고 성과 리포트
전환 리포트
매출 리포트
```
> ⚠️ 리포트 이름은 GrowthPlatform 기준으로 불러오며, 일부 리포트 항목은 알파버전에서 미연동 상태일 수 있습니다.
***
**④ 데이터 질의 및 분석자동화**
* 원하는 질문을 대화하듯 입력합니다.
* **예시**
```plaintext
질문: "지난 7일간 캠페인별 전환 수 보여줘"
결과: 표 형태로 출력
```
> ⚠️ **Tip:** “지난 7일”, “이번 달”처럼 기간을 명확히 지정해야 원하는 결과를 얻을 수 있습니다.
* 질의 결과는 표 형태만 제공
* 시각화(그래프 등)는 정식 버전에서 제공 예정
***
**⑤ 후속 분석 이어가기**
* 결과와 함께 제안되는 추가 질문을 활용해 더 깊이 있는 분석을 진행할 수 있습니다.
* **예시**
```plaintext
질문: "캠페인별 ROAS도 보여줄까?"
질문: "일별 전환율 추이도 같이 볼래?"
```
***
#### **⑥** 초기화 및 재설정
* **세션 초기화**: 새로운 대화를 시작하면 자동으로 초기화되며, 기존 대화 맥락은 유지되지 않음. 새로운 분석 시작 시 API 키를 다시 입력해야 함.
* **API 키 재설정**: 잘못된 API 키 입력 시 다시 입력 가능 (`api_key=새로운_키`)
* **브라우저 캐시/쿠키 문제 해결**: 데이터 조회가 정상 작동하지 않거나 화면이 멈출 경우 캐시/쿠키 삭제 후 재로그인
* **신뢰 사이트 \[허용] 메시지 노출 (참고용)**:
> ⚠️ 참고: 일부 브라우저에서 GPTs 외부 링크 접근 시\
> -“신뢰할 수 없는 사이트입니다. 허용하시겠습니까?” 메시지가 나타날 수 있습니다.\
> -이는 OpenAI 보안상의 정상 동작이며, 기능 사용에는 영향을 주지 않습니다.\
> -필요 시 브라우저 팝업 허용 설정 또는 API 직접 호출로 대체 가능합니다.
* **시스템 초기화 필요 시**:
* 브라우저 완전 종료 후 재시작
* 네트워크 연결 상태 확인
* API 키 유효성 확인
* 문제가 지속되면 고객센터 문의
> ⚠️ **주의:** API 키를 재발급하면 이전 키는 더 이상 사용할 수 없습니다.
***
**⑦ 주의사항 및 제약 (알파 버전)**
* 결과는 표 형태만 제공 (시각화 기능은 정식 버전 예정)
* KPI 비교 분석은 단일 차원까지만 지원 (다축 그래프 미지원)
* 일부 데이터 항목은 제공되지 않을 수 있음
* 개발 중인 기능 포함으로 오류, 지연, 일시적 중단 가능
👉 위 단계를 따라 사용하면, GPTs for Growth Platform v2를 통해 **리포트 조회부터 KPI 분석까지** 대화형으로 손쉽게 진행할 수 있습니다.
***
### 3. 제한 및 주의사항
본 서비스는 **알파 버전**으로, 정식 서비스와 일부 차이가 있습니다. 사용 시 아래 사항을 참고해주시기 바랍니다.
**3-1. 기능 미완성 및 오류 가능성**
* 개발 중인 기능이 포함되어 있어 예상치 못한 오류가 발생할 수 있습니다.
* 데이터 응답 속도 및 안정성이 **정식 서비스보다 다소 낮을 수 있습니다.**
**3-2. 일부 기능 제한**
* 특정 데이터 항목이나 지표는 제공되지 않을 수 있습니다.
* API 연동 범위가 제한적이며, **정식 서비스에서 확장 예정**입니다.
**3-3. 정식 서비스와의 차이점**
* UI/UX가 일부 단순화되어 있으며, 디자인 및 기능은 **정식 서비스에서 변경될 수 있습니다.**
* 데이터 보관·보안 정책이 알파버전에 한정된 방식으로 운영됩니다.
**3-4. 알파 서비스 사용 중 발생할 수 있는 예상 문제**
* 간헐적인 서버 지연 또는 일시적 중단 가능성
* 특정 환경(브라우저/네트워크)에 따라 결과 표시 오류 발생 가능성
* 동일 질의에도 일시적으로 다른 결과가 표시될 수 있음
***
### 4. 피드백 및 고객지원
본 서비스는 알파 버전으로 제공되며, 고객사의 체험 후 피드백이 정식 버전 완성에 큰 도움이 됩니다.\
다음 방법 중 편리한 경로를 통해 의견을 남겨주세요.
#### **4-1. 고객센터 운영 안내**
* 운영시간: 평일 10:00 \~ 17:00
* 점심시간: 12:00 \~ 13:00
* 휴무: 토·일요일 및 공휴일
* 전화: 02-6919-5555
* 이메일:
#### **4-2. 문제 발생 시 대응 방법**
① **오류·버그 발견 시 처리 방법**
* 우선 API 키와 인터넷 연결을 확인하세요.
* 오류가 반복되면 발생 시간, 입력한 질문, 오류 메시지를 기록하세요.
* 고객센터에 제보 시 재현 단계를 함께 전달해주시면 빠른 확인이 가능합니다.
② **간단 문제 해결 (FAQ 형식)**
> **Q. 결과가 나오지 않아요**\
> A. API 키가 올바른지, 기간/조건이 유효한지 확인하세요.
> **Q. 표가 비어 있어요**\
> A. 해당 기간/캠페인에 데이터가 없는 경우일 수 있습니다.
> **Q. 특정 캠페인만 조회가 안 돼요**\
> A. 시험버전에서 지원되지 않는 항목일 수 있습니다.
③ **로그 및 스크린샷 제출 방법**
* 오류 화면을 전체 캡처하여 이메일에 첨부
* 오류 메시지가 있다면 텍스트 그대로 복사
* 가능하다면 발생 시간과 입력한 질문 문구도 함께 전달
#### **4-3. 피드백 제출 채널**
* 이메일:
#### **4-4. 피드백 유형**
* 버그 제보: 오류, 실행 불가, 예상과 다른 결과
* 개선 의견: UI/UX, 사용성, 편의성 관련 제안
* 기능 요청: 추가 기능, 연동, 확장성 관련 아이디어