adstage
데이터 허브

커넥터

데이터 허브 > 커넥터 는 데이터 허브가 읽을 수 있는 소스의 카탈로그입니다. 카테고리(광고, 모바일·게임 UA, 분석, 소셜, 이커머스, CRM 등 19종)와 상태로 거르고, 한글 이름(예: 네이버, 당근)으로도 검색할 수 있습니다.

1. 상태 배지

배지뜻할 일
기본 제공all·adstage — 연결이 필요 없습니다바로 데이터 조회
연결됨비용 수집이 정상으로 도는 계정이 하나 이상 있습니다데이터 조회
수집 확인 필요계정은 연결됐지만 비용 수집이 실패하고 있습니다관리로 연동 화면을 열어 토큰·권한 확인
연결 가능지금 붙일 수 있는 매체인데 아직 연결하지 않았습니다연결
준비 중수집기가 아직 없습니다. 조회되지 않습니다연결 요청

카드에는 연결된 계정 수와 마지막 수집 시각이 함께 표시됩니다.

2. 광고 매체 연결하기

광고 매체 커넥터는 기존 광고 채널 연동 화면에서 연결합니다(같은 자격증명을 두 곳에서 관리하지 않도록 하나로 둡니다).

  1. 커넥터 카드에서 연결(또는 관리)을 누릅니다. 해당 매체의 연동 화면이 열립니다.
  2. OAuth 매체는 매체 계정으로 로그인해 광고 계정을 고르고, 키 기반 매체는 매체에서 발급한 API 키를 붙여 넣습니다. 매체별 절차는 트래킹 > 연동하기 의 매체별 가이드를 참고하세요.
  3. 첫 비용 수집은 보통 몇 시간 안에 끝나며, 이후 4시간마다 최근 30일을 다시 수집합니다.
  4. 커넥터 화면에서 상태가 연결됨 으로 바뀌면 탐색기·API·AI 에서 조회됩니다.

아직 연결하지 않은 매체도 조회는 됩니다. 이 경우 비용 필드(spend·impressions·clicks)는 비어 있고, 그 채널로 귀속된 AdStage 이벤트(설치·구매)만 나옵니다.

3. 준비 중 커넥터 요청

GA4, Search Console, Shopify, HubSpot, Klaviyo, Amazon Ads, AppsFlyer 등 준비 중 커넥터는 카드의 연결 요청을 누르면 조직 단위로 요청이 기록됩니다. 같은 조직에서 여러 번 눌러도 한 번으로 셉니다. 요청이 많은 커넥터부터 실제 수집기를 붙이고, 붙으면 상태가 연결 가능으로 바뀝니다.

4. 커넥터 id

API·AI·예약 내보내기는 커넥터를 id 로 지정합니다.

id이름id이름
all전체 통합adstageAdStage 어트리뷰션
google_adsGoogle AdsfacebookFacebook Ads (Meta)
tiktokTikTok Adsapple_search_adsApple Search Ads
bingMicrosoft AdssnapchatSnapchat Ads
twitterX AdslinkedinLinkedIn Ads
redditReddit AdspinterestPinterest Ads
criteoCriteotaboolaTaboola
rtb_houseRTB Houseopenai_adsOpenAI Ads
naver_searchad네이버 검색광고kakao_moment카카오모먼트
kakao_keyword카카오 키워드광고daangn_ads당근 광고
toss_ads토스 애즈mobon모비온
impactImpactapplovinAppLovin (Axon)
unity_adsUnity AdsmolocoMoloco
mintegralMintegralliftoffLiftoff
remergeRemergeinmobiInMobi
appierAppierironsourceironSource
tapjoyTapjoykayzenKayzen
digital_turbineDigital TurbinetnkTNK Factory
adpopcorn애드팝콘

전체 목록(준비 중 포함)은 GET https://api.adstage.app/datahub/v1/list_connectors 로 받을 수 있습니다(키 불필요).

목차