데이터 허브
커넥터
데이터 허브 > 커넥터 는 데이터 허브가 읽을 수 있는 소스의 카탈로그입니다. 카테고리(광고, 모바일·게임 UA, 분석, 소셜, 이커머스, CRM 등 19종)와 상태로 거르고, 한글 이름(예: 네이버, 당근)으로도 검색할 수 있습니다.
1. 상태 배지
| 배지 | 뜻 | 할 일 |
|---|---|---|
| 기본 제공 | all·adstage — 연결이 필요 없습니다 | 바로 데이터 조회 |
| 연결됨 | 비용 수집이 정상으로 도는 계정이 하나 이상 있습니다 | 데이터 조회 |
| 수집 확인 필요 | 계정은 연결됐지만 비용 수집이 실패하고 있습니다 | 관리로 연동 화면을 열어 토큰·권한 확인 |
| 연결 가능 | 지금 붙일 수 있는 매체인데 아직 연결하지 않았습니다 | 연결 |
| 준비 중 | 수집기가 아직 없습니다. 조회되지 않습니다 | 연결 요청 |
카드에는 연결된 계정 수와 마지막 수집 시각이 함께 표시됩니다.
2. 광고 매체 연결하기
광고 매체 커넥터는 기존 광고 채널 연동 화면에서 연결합니다(같은 자격증명을 두 곳에서 관리하지 않도록 하나로 둡니다).
- 커넥터 카드에서 연결(또는 관리)을 누릅니다. 해당 매체의 연동 화면이 열립니다.
- OAuth 매체는 매체 계정으로 로그인해 광고 계정을 고르고, 키 기반 매체는 매체에서 발급한 API 키를 붙여 넣습니다. 매체별 절차는 트래킹 > 연동하기 의 매체별 가이드를 참고하세요.
- 첫 비용 수집은 보통 몇 시간 안에 끝나며, 이후 4시간마다 최근 30일을 다시 수집합니다.
- 커넥터 화면에서 상태가 연결됨 으로 바뀌면 탐색기·API·AI 에서 조회됩니다.
아직 연결하지 않은 매체도 조회는 됩니다. 이 경우 비용 필드(spend·impressions·clicks)는 비어 있고, 그 채널로 귀속된 AdStage 이벤트(설치·구매)만 나옵니다.
3. 준비 중 커넥터 요청
GA4, Search Console, Shopify, HubSpot, Klaviyo, Amazon Ads, AppsFlyer 등 준비 중 커넥터는 카드의 연결 요청을 누르면 조직 단위로 요청이 기록됩니다. 같은 조직에서 여러 번 눌러도 한 번으로 셉니다. 요청이 많은 커넥터부터 실제 수집기를 붙이고, 붙으면 상태가 연결 가능으로 바뀝니다.
4. 커넥터 id
API·AI·예약 내보내기는 커넥터를 id 로 지정합니다.
| id | 이름 | id | 이름 |
|---|---|---|---|
all | 전체 통합 | adstage | AdStage 어트리뷰션 |
google_ads | Google Ads | facebook | Facebook Ads (Meta) |
tiktok | TikTok Ads | apple_search_ads | Apple Search Ads |
bing | Microsoft Ads | snapchat | Snapchat Ads |
twitter | X Ads | linkedin | LinkedIn Ads |
reddit | Reddit Ads | pinterest | Pinterest Ads |
criteo | Criteo | taboola | Taboola |
rtb_house | RTB House | openai_ads | OpenAI Ads |
naver_searchad | 네이버 검색광고 | kakao_moment | 카카오모먼트 |
kakao_keyword | 카카오 키워드광고 | daangn_ads | 당근 광고 |
toss_ads | 토스 애즈 | mobon | 모비온 |
impact | Impact | applovin | AppLovin (Axon) |
unity_ads | Unity Ads | moloco | Moloco |
mintegral | Mintegral | liftoff | Liftoff |
remerge | Remerge | inmobi | InMobi |
appier | Appier | ironsource | ironSource |
tapjoy | Tapjoy | kayzen | Kayzen |
digital_turbine | Digital Turbine | tnk | TNK Factory |
adpopcorn | 애드팝콘 |
전체 목록(준비 중 포함)은 GET https://api.adstage.app/datahub/v1/list_connectors 로 받을 수 있습니다(키 불필요).

