연동은 어떻게 동작하나

## 이 문서에서 얻는 것 채널마다 요구하는 것이 왜 다른지, 내가 준비해야 할 것이 무엇인지 판단하는 기준입니다. 이걸 먼저 이해하면 채널별 문서를 훨씬 빨리 따라갈 수 있습니다. ## 연동은 두 가지 방식뿐입니다 ### 방식 A — 키 입력 (API Key / Token) 플랫폼 콘솔에서 발급받은 문자열을 모닝인사이트에 붙여 넣는 방식입니다. ``` [플랫폼 콘솔] 키 발급 → 복사 → [설정 → 데이터 연동] 붙여넣기 → 저장 → 연결 테스트 ``` **이 방식인 채널:** 네이버 검색광고 · Meta Ads · Google Ads · 쿠팡 Wing · 아임웹 · Toss Place · Jira · Confluence · AI 제공자(Claude·GPT·Gemini) - 준비물: 그 플랫폼의 **관리자 계정**과 API 사용 권한 - 특징: 발급받으면 바로 됩니다. 다만 키를 잘못 복사하면 조용히 실패합니다 - 주의: 키에 **읽기 권한 범위(scope)** 가 빠지면 연결은 되는데 데이터가 0 으로 나옵니다 ### 방식 B — 계정 연결 (OAuth) 키를 붙여 넣는 대신, **본인이 그 플랫폼에 로그인해 승인**하는 방식입니다. ``` [설정] 계정 연결 클릭 → 플랫폼 로그인 팝업 → 권한 동의 → 자동으로 토큰 발급·저장 ``` **이 방식인 채널:** YouTube · Instagram · Facebook 페이지 · Cafe24 · 네이버 스마트스토어 · 오픈뱅킹 계좌 · Gmail · Outlook - 준비물: 그 플랫폼 계정 로그인 정보 (모닝인사이트는 비밀번호를 저장하지 않습니다) - 특징: 비밀번호를 넘기지 않아 더 안전하고, **토큰이 자동 갱신**됩니다 - 주의: 승인 화면에서 요청한 권한을 **하나라도 해제하면** 그 데이터는 수집되지 않습니다 ### 예외 — 인증서 방식 (법인 계좌·법인카드) 법인 은행 계좌와 법인 신용카드는 **공동인증서** 또는 **카드사 홈페이지 로그인 정보**가 필요합니다. 가장 준비물이 많은 연동이므로 [금융 연동](/news/guide/integration-checklist) 절차를 별도로 확인하세요. ## 두 단계로 나뉜다는 점이 중요합니다 OAuth 방식(방식 B)은 실제로는 **두 번의 등록**이 필요합니다. | 단계 | 누가 | 언제 | 무엇을 | |---|---|---|---| | **1단계 — 앱 등록** | 서비스 운영자 | 플랫폼당 **한 번만** | 플랫폼 개발자 콘솔에 앱을 만들고 Client ID/Secret 을 모닝인사이트에 등록 | | **2단계 — 계정 연결** | 고객(사용자) | 워크스페이스마다 | 설정에서 **계정 연결** 을 눌러 본인 계정으로 승인 | **고객이 하는 일은 2단계뿐입니다.** 1단계는 이미 되어 있거나, 안 되어 있으면 계정 연결 버튼을 눌렀을 때 오류가 납니다. 그 경우 직접 해결할 수 없으니 운영 담당자에게 알려 주세요. > 자체 구축·온프레미스로 운영하는 경우에는 1단계도 직접 해야 합니다. > 플랫폼별 앱 등록 절차는 **운영자 가이드** 카테고리에 있습니다. ## 연동 후 데이터가 언제 오나 연동을 끝내면 바로 화면이 채워지는 것은 아닙니다. 1. **연결 테스트 통과** — 자격증명이 유효하다는 확인까지 2. **첫 수집** — 화면 진입 시 조회 또는 다음 정기 수집(매일 06:00) 때 3. **비교 지표** — 7일 평균 대비 증감은 데이터가 7일 이상 쌓인 뒤부터 자세한 동작은 [데이터가 모이는 구조](/news/guide/data-flow)를 보세요. ## 자격증명은 어떻게 보관되나 - 저장 시 **암호화**되며, 화면에는 앞뒤 일부만 보이는 마스킹 형태로 표시됩니다 - 워크스페이스별로 분리 저장되어 다른 회사가 접근할 수 없습니다 - 등록·변경·삭제는 모두 **감사 로그**에 남습니다 자세한 내용은 [자격증명 보관과 보안](/news/guide/integration-security)에 있습니다. ## 관련 문서 - [플랫폼별 사전 준비물](/news/guide/integration-checklist) — 내 채널에 무엇이 필요한지 표로 확인 - [연동 화면 사용법](/news/guide/integration-howto) — 어느 화면에서 어떻게 넣는지