연동 화면 사용법

## 이 문서에서 얻는 것 준비물을 다 모았다면, 이제 넣는 곳과 확인하는 방법입니다. **연동 현황을 보는 화면**과 **실제로 입력하는 화면**이 나뉘어 있는 점만 기억하면 됩니다. ## 화면 두 개의 역할 | 화면 | 역할 | |---|---| | **데이터 연동** (사이드바 Overview) | 연동 **현황 확인** + 채널별 준비물·절차 안내 | | **설정 → 데이터 연동** 탭 | 실제 **값 입력 · 저장 · 연결 테스트** | 현황 화면의 카드를 클릭하면 그 채널에 필요한 값과 발급 절차가 나오고, 아래 버튼으로 설정 화면의 해당 위치로 이동합니다. ## 방식 A — 키를 직접 넣는 채널 대상: 네이버 검색광고 · Meta Ads · Google Ads · 쿠팡 Wing · 아임웹 · Toss Place · Jira 1. **설정 → 데이터 연동** 탭으로 이동 2. 해당 채널 카드를 클릭해 입력 창을 엽니다 3. 발급받은 값을 붙여 넣습니다 - **앞뒤 공백이 붙지 않도록** 주의하세요. 복사 과정에서 가장 자주 생기는 오류입니다 - 줄바꿈이 섞이면 인증이 실패합니다 4. **저장** 5. **연결 테스트** 를 눌러 결과를 확인합니다 성공하면 카드 상태가 `연동됨` 으로 바뀝니다. ### 저장 후 값은 다시 보이지 않습니다 보안상 저장된 키는 **마스킹**되어 앞뒤 일부만 표시됩니다. 값을 확인할 수는 없고, 바꾸려면 새로 붙여 넣어야 합니다. 따라서 발급받은 원본 키는 **비밀번호 관리자 등에 따로 보관**하세요. ## 방식 B — 계정으로 승인하는 채널 (OAuth) 대상: YouTube · Instagram · Facebook 페이지 · Cafe24 · 스마트스토어 · 오픈뱅킹 · Gmail · Outlook 1. 채널에 따라 먼저 **Client ID / Secret 등 기본 값을 저장**합니다 (이미 서비스 차원에서 등록돼 있으면 이 단계가 없습니다) 2. **계정 연결** 버튼을 누릅니다 3. 새 창에서 그 플랫폼 로그인 화면이 열립니다 → 로그인 4. 권한 요청 목록이 나오면 **모두 허용**합니다 5. 창이 닫히고 카드 상태가 `연동됨` 으로 바뀝니다 ### 권한을 하나라도 해제하면 안 됩니다 승인 화면에서 항목별로 해제할 수 있게 되어 있는 경우가 있습니다. 해제하면 **연결은 성공하지만 그 데이터만 계속 비어** 있습니다. "연동됨인데 특정 지표만 0" 이면 이 경우를 먼저 의심하세요. 다시 **계정 연결** 을 눌러 재승인하면 해결됩니다. ### 팝업이 차단되면 브라우저가 새 창을 막으면 로그인 화면이 뜨지 않습니다. 주소창의 팝업 차단 아이콘에서 이 사이트를 허용하고 다시 시도하세요. ## 방식 C — 인증서·로그인 정보가 필요한 채널 대상: 법인 은행 계좌 · 법인 신용카드 **설정 → 데이터 연동 → Codef 연동** 에서 진행합니다. 먼저 연동 기본 정보(Client ID · Client Secret · 공개키)를 등록한 뒤, 기관별로 계좌·카드를 하나씩 추가하는 2단 구조입니다. - **법인 은행 계좌** — 기관 선택 · 라벨 · 공동인증서 파일(.cer/.der) · 개인키(.key) · 인증서 비밀번호 - **법인 신용카드** — 카드사 선택 · 홈페이지 로그인 ID · 비밀번호 · (사업자등록번호) 여러 계좌·카드를 등록할 수 있고, 라벨을 붙여 두면 화면에서 구분하기 쉽습니다. ## 연동 성공 확인 순서 연동을 마쳤다면 아래 순서로 확인하세요. 위에서부터 하나씩 통과해야 합니다. 1. **카드 상태** — `연동됨` 인가 2. **연결 테스트** — 통과했는가 (키 방식 채널) 3. **해당 영역 화면** — 광고를 연동했다면 광고 분석 화면에 값이 있는가 4. **모닝 대시보드** — 종합 화면에 반영됐는가 3번까지 되는데 4번이 안 되면 집계 반영을 기다리면 됩니다 ([데이터가 모이는 구조](/news/guide/data-flow) 참고). 2번이 안 되면 자격증명 문제입니다 ([연동이 실패할 때](/news/guide/trouble-integration)). ## 연동을 해제하려면 같은 화면에서 해제할 수 있습니다. 해제하면, - 저장된 자격증명이 삭제됩니다 - 이미 수집된 과거 데이터는 남습니다 (화면에서 계속 보입니다) - 이후 수집이 중단됩니다 해제도 감사 로그에 기록됩니다. ## 자주 하는 실수 | 실수 | 결과 | 예방 | |---|---|---| | 키를 복사할 때 공백·줄바꿈 포함 | 인증 실패 | 붙여넣은 뒤 앞뒤 확인 | | 계정 ID 를 다른 계정으로 연결 | 다른 회사 데이터가 붙음 | 승인 화면의 계정명 확인 | | OAuth 권한 일부 해제 | 특정 지표만 계속 0 | 전체 허용 후 재연결 | | 테스트 계정으로 연동 | 실데이터가 안 나옴 | 운영 계정으로 재연결 | | 담당자 퇴사 계정으로 연동 | 계정 정지 시 연동 끊김 | 공용/관리자 계정 사용 | ## 관련 문서 - [연동 상태 · 재인증 · 토큰 만료](/news/guide/integration-refresh) - [자격증명 보관과 보안](/news/guide/integration-security)