RTB House 연동

베타

RTB House 연동은 실제 광고주 계정으로 검증 중입니다(연동 카드에 베타 표시). adstage 수치가 RTB House 패널과 다르면 adstage 고객지원팀에 알려 주세요.

adstage에서는 RTB House 리타게팅 캠페인의 광고비·노출·클릭을 자동으로 수집해 다른 매체와 한 리포트에서 비교할 수 있습니다. RTB House 연동은 adstage 대시보드 연동 > 광고 채널 연동 > RTB House의 비용 연동 탭에서 진행하며, 별도의 API 키 대신 RTB House 패널(Clients Panel) 로그인 정보를 사용합니다.

1. 연동 개요

기능	지원 여부	설명
비용 수집	지원	서브캠페인별 지출·노출·클릭을 4시간마다 자동 수집
전환 전송	담당자 요청	RTB House가 포스트백 규격을 공개하지 않습니다. 비용 연동을 마친 뒤 RTB House 담당자에게 요청하세요
트래킹 링크 템플릿	미제공	RTB House가 클릭 매크로를 공개하지 않습니다. 커스텀 딥링크로 `rtbhouse.ads` 채널 집계는 가능합니다
채널명	`rtbhouse.ads`	리포트의 채널 필터에는 `RTB House`로 표시

2. 준비하기

연동에는 아래 세 가지가 필요합니다. 모두 RTB House 패널 계정과 관련된 값이며, adstage에서 발급하는 것은 없습니다.

입력 항목	설명
광고주 해시 (Advertiser Hash)	RTB House가 광고주마다 부여하는 식별값입니다. 패널 화면에서 확인하는 경로는 RTB House 공개 문서에 없으므로 RTB House 담당자에게 문의해 확인하세요
패널 로그인 ID	RTB House 패널에 로그인하는 사용자 ID
비밀번호	그 사용자의 비밀번호

주의하세요

RTB House API 접근은 담당 AM(계정 매니저)이 열어줘야 합니다. 먼저 RTB House 담당자에게 패널 사용자의 API 접근 활성화를 요청한 뒤, 그 사용자의 로그인 ID·비밀번호와 광고주 해시를 adstage에 입력합니다.

운영 담당자의 개인 계정 대신 AdStage 전용 읽기 권한 패널 사용자를 만들어 쓰는 것을 권장합니다. 그 사용자가 연동할 광고주에 접근할 수 있어야 합니다.

RTB House 패널의 사용자 > API tokens에서 직접 발급하는 API 토큰은 현재 adstage에서 지원하지 않습니다. 이 토큰은 수명이 정해져 있어 주기적으로 교체(rotate)해야 하고, 교체된 새 토큰을 다시 저장해야 하기 때문입니다. 로그인 ID·비밀번호 방식으로 연동해 주세요.

3. 연동하기

adstage 대시보드 연동 > 광고 채널 연동 > RTB House에서 비용 연동 탭을 엽니다.
RTB House 비용 연동 스위치를 켠 뒤 연동 계정 추가를 클릭합니다. 스위치가 꺼져 있으면 버튼을 누를 수 없습니다.
연동 정보 등록 창에 다음을 입력합니다.
- 계정 이름: adstage에서 이 계정을 구분할 이름 (예: RTB House - 브랜드A)
- 광고주 해시 (Advertiser Hash)
- 패널 로그인 ID
- 비밀번호
연동을 클릭합니다. adstage가 저장하기 전에 입력한 정보로 RTB House에 접속해 광고주 접근 권한을 확인하며(버튼에 인증 중... 표시), 확인되면 "RTB House 계정이 성공적으로 추가되었습니다" 메시지가 표시됩니다. 비밀번호는 암호화되어 저장됩니다.
추가 직후 첫 수집이 자동으로 시작됩니다. 계정 목록의 상태가 준비 중에서 성공으로 바뀌면 리포트에서 비용을 볼 수 있습니다. 보통 몇 분 안에 끝납니다.

입력값에 문제가 있으면 다음 메시지가 표시됩니다.

메시지	원인
RTB House 에서 키를 거부했습니다. 키와 권한을 확인해 주세요.	로그인 ID·비밀번호가 틀렸거나, 그 사용자의 API 접근이 열리지 않았거나, 입력한 광고주 해시에 접근 권한이 없는 경우
키 확인을 위해 RTB House 에 연결하지 못했습니다. 잠시 후 다시 시도해 주세요.	RTB House 측 일시 장애 또는 요청 한도. 잠시 후 다시 시도하세요
이미 등록된 계정입니다	같은 광고주 해시가 이 조직에 이미 연동된 경우

광고주가 여럿이면 광고주 해시마다 계정을 하나씩 추가합니다.

4. 연동 계정 관리하기

연동된 계정은 비용 연동 탭의 목록에서 확인합니다.

열	설명
계정명	추가할 때 입력한 계정 이름
상태	준비 중(첫 수집 진행 중), 성공(RTB House API 연결 정상), 실패(데이터를 가져오지 못함). 실패에 마우스를 올리면 원인 요약이, `세부정보`를 누르면 오류 원문이 보입니다
데이터가 업데이트된 최근 일시	비용 데이터가 마지막으로 저장된 시각
관리	삭제 아이콘. 계정 삭제 확인 창에서 `삭제`를 누르면 연동이 해제됩니다

참고하세요

상태가 실패여도 다음 수집 때 자동으로 다시 시도하며, 원인이 해결되면 성공으로 돌아옵니다. 다만 인증 오류(비밀번호 변경, 권한 회수)는 사람이 고쳐야 합니다.

상태가 성공이어도 광고 미집행 등으로 데이터가 들어오지 않을 수 있습니다. 비용 데이터가 3일 넘게 저장되지 않으면 상태 옆에 경고가 나타나고, 마우스를 올리면 "N일째 광고비 데이터가 수집되지 않았습니다. 연동 상태를 확인해 주세요." 메시지가 표시됩니다.

연동 정보는 수정할 수 없습니다. 패널 비밀번호를 바꿨거나 다른 사용자로 바꾸려면 계정을 삭제한 뒤 다시 추가하세요.

계정을 삭제하면 그 계정의 수집이 중단됩니다. 이미 수집된 과거 데이터는 adstage에 남습니다.

5. 수집되는 데이터

항목	설명
수집 주기	4시간마다 (KST 1시, 5시, 9시, 13시, 17시, 21시)
수집 범위	최근 30일 (D-30 ~ D-1, 수집 당일 제외). 매번 30일을 다시 가져와 RTB House에서 나중에 정정된 수치를 갱신합니다
데이터 계층	서브캠페인(Subcampaign) 단위. 리포트의 캠페인 자리에 RTB House 서브캠페인 이름이 표시되며, 광고그룹·소재 데이터는 없습니다
리포트 지표	비용(Channel), 노출(Channel), 클릭(Channel)
매체 전환 수	RTB House의 귀속 전환(`ATTRIBUTED`) 수도 함께 가져와 원본 데이터에 보관합니다. 다만 리타게팅 전환은 앱 설치가 아니므로 리포트의 전환(Channel)·설치(Channel) 지표로는 집계하지 않습니다
통화	RTB House 광고주 계정의 통화. 조직 기준 통화와 다르면 환율을 적용한 금액을 함께 저장합니다
시간대	UTC (일자 경계가 UTC 0시 기준)
채널명	`rtbhouse.ads`

6. 트래킹 링크와 전환 전송

RTB House는 클릭 ID 매크로와 포스트백(전환 전송) 규격을 공개 문서로 제공하지 않습니다. 그래서 adstage의 트래킹 딥링크 채널 목록과 매체사 포스트백의 매체 프리셋에는 RTB House가 없습니다.

지금 가능한 것: 커스텀 딥링크를 만들고 채널에 rtbhouse(또는 rtb house)를 입력하면, 그 링크로 들어온 유입이 리포트에서 rtbhouse.ads로 집계되어 비용과 같은 채널에 붙습니다. 랜딩 URL에 rtbclid 파라미터가 있으면 adstage가 RTB House 클릭 ID로 저장합니다.
담당자에게 요청할 것: 비용 연동을 마친 뒤 RTB House 담당자에게 클릭 ID 매크로와 전환 포스트백 규격을 요청하세요. 규격(호출 URL과 파라미터)을 받으면 링크의 매체사 포스트백 URL 템플릿에 입력해 전환을 보낼 수 있습니다. 설정이 어려우면 받은 규격을 adstage 고객지원팀에 전달해 주세요.

7. 주의사항

아래 사항을 주의해 주세요.

RTB House 패널과 adstage 간에 수치 차이가 발생할 수 있습니다. adstage는 UTC 일자와 귀속 전환(ATTRIBUTED) 기준으로 수집하므로, 패널에서 다른 시간대나 다른 전환 집계 기준으로 보면 일별 수치가 다르게 보입니다.
수집 당일 데이터는 수집하지 않습니다. 어제까지의 데이터만 리포트에 표시됩니다.
패널 비밀번호를 바꾸거나, 사용자를 삭제하거나, API 접근을 해제하면 수집이 중단되고 상태가 실패로 바뀝니다.
광고를 집행하지 않은 날은 저장되는 데이터가 없습니다. 지출·노출·클릭이 모두 0인 행은 저장하지 않습니다.

8. 문제 해결

계정을 추가할 수 없을 때

로그인 확인: 입력한 ID·비밀번호로 RTB House 패널에 직접 로그인되는지 확인
API 접근 확인: RTB House 담당자에게 그 사용자의 API 접근이 열려 있는지 확인
광고주 해시 확인: 앞뒤 공백 없이 정확히 입력했는지, 그 사용자가 해당 광고주에 접근할 수 있는지 확인
중복 확인: 같은 광고주 해시가 이미 계정 목록에 있는지 확인

상태가 실패일 때

원인 요약 확인: 상태에 마우스를 올려 요약을 확인합니다. "인증 실패 — 다시 연결하거나 키를 확인해 주세요"면 비밀번호 변경이나 권한 회수가 원인이므로 계정을 삭제하고 다시 추가합니다.
자동 재시도 대기: "매체가 요청을 제한했습니다" 또는 "매체 측 일시적 오류입니다"면 다음 수집 때 자동으로 다시 시도합니다.
고객지원 문의: 계속 실패하면 세부정보의 오류 원문과 함께 adstage 고객지원팀에 문의합니다.

데이터가 수집되지 않을 때

연동 활성화 확인: RTB House 비용 연동 스위치가 켜져 있는지 확인
집행 여부 확인: RTB House 패널에서 해당 기간에 실제 지출이 있는지 확인
수집 범위 확인: 당일 데이터는 수집하지 않으며, 연동 시점 기준 최근 30일만 가져옴
경고 표시 확인: 계정 상태 옆에 경고가 있는지 확인

9. 자주 묻는 질문

RTB House 패널에서 발급한 API 토큰으로 연동할 수 있나요?

아니요. 현재 adstage는 패널 로그인 ID·비밀번호 방식만 지원합니다. API 토큰은 입력란이 없습니다.

리포트의 캠페인 이름이 RTB House 패널의 캠페인 이름과 다릅니다.

adstage는 RTB House 서브캠페인 단위로 수집하고 그 이름을 캠페인 자리에 표시합니다. 패널에서 서브캠페인 이름을 확인하세요.

리포트의 전환(Channel)·설치(Channel)이 비어 있습니다.

의도된 동작입니다. RTB House 전환은 리타게팅 전환이라 앱 설치로 집계하지 않습니다. 성과는 비용(Channel)·노출(Channel)·클릭(Channel)과 adstage가 직접 측정한 이벤트 지표로 보세요.

adstage가 측정한 구매 같은 전환을 RTB House로 보낼 수 있나요?

자동 전송은 아직 제공하지 않습니다. RTB House 담당자에게 포스트백 규격을 요청한 뒤 매체사 포스트백의 URL 템플릿에 입력하거나, 받은 규격을 adstage 고객지원팀에 전달해 주세요.

연동 전의 과거 데이터도 가져오나요?

연동 시점 기준 최근 30일까지 가져옵니다. 그 이전 데이터는 수집하지 않습니다.

참고 문서

RTB House Client's panel API 문서 (Swagger) — adstage가 비용 수집에 사용하는 API입니다. 인증 방식으로 Basic(로그인 ID·비밀번호)과 Bearer(API 토큰)를 지원한다고 안내합니다.
RTB House 공식 Python SDK README — 로그인 ID·비밀번호 인증과 API 토큰 인증, 통계 조회 예시가 설명되어 있습니다. API 토큰은 수명이 있어 주기적으로 교체해야 한다는 설명도 여기에 있습니다.
RTB House 패널 API 토큰 페이지 — 패널에서 API 토큰을 직접 발급하는 화면입니다. 현재 adstage 연동에는 사용하지 않습니다.

RTB House 연동

目次