Moloco 연동

베타

Moloco 연동은 실제 광고주 계정으로 검증 중입니다. adstage 수치가 Moloco 콘솔과 다르면 adstage 고객지원팀에 알려 주세요.

adstage에서는 Moloco Ads 캠페인의 비용·노출·클릭·설치를 자동으로 수집해 리포트에서 확인할 수 있습니다. 로그인 연동이 아니라 Moloco Ads Manager에서 발급한 API 키와 광고 계정 ID를 입력하는 방식이며, 연동 > 광고 채널 연동 > Moloco의 비용 연동 탭 하나로 구성됩니다.

기능	지원 여부	설명
비용 수집	지원	캠페인별 지출·노출·클릭·설치를 4시간마다 자동 수집
클릭 귀속	담당자 확인 필요	Moloco는 지정한 측정 업체(MMP)의 트래킹 링크만 등록하도록 안내합니다. adstage 트래킹 링크를 쓸 수 있는지 Moloco 담당자에게 확인해 주세요. adstage도 2026년 10월 8일 커스텀 트래커 허용 여부를 문의해 회신을 기다리고 있습니다
전환 전송	지원하지 않음	adstage가 측정한 전환을 Moloco로 보내는 기능. Moloco가 측정 업체용 포스트백 규격을 공개하지 않아 제공하지 않습니다

2. Moloco에서 준비할 것

연동에는 광고 계정 ID와 API 키가 필요합니다. 둘 다 Moloco Ads Manager(Moloco 광고 콘솔)에서 확인합니다.

광고 계정 ID 확인하기

Moloco Ads Manager에 로그인한 뒤 프로필 아래 Ad account settings를 열면 Ad Account Info에 광고 계정 ID가 표시됩니다. 같은 화면에서 광고 계정의 시간대와 통화도 확인해 두세요. 두 값은 광고 계정을 만들 때 정해지며 이후 바꿀 수 없고, 연동할 때 시간대를 고르는 데 필요합니다.

API 키 발급받기

Moloco Ads Manager에서 User settings > API Access로 이동합니다.
Create API Key를 클릭하고 만료일을 지정합니다. 만료일 지정은 필수입니다.
생성된 API 키를 복사합니다.

같은 단계가 adstage 대시보드의 Moloco 키 발급 방법 안내에도 표시됩니다.

주의하세요

API 키는 워크플레이스 단위로 발급되며 워크플레이스당 최대 5개까지 만들 수 있습니다. 광고 계정이 여러 개라면 키 하나를 공유하고 adstage에는 광고 계정마다 계정을 추가하면 됩니다. 대행사 워크플레이스라면 워크플레이스가 아니라 광고 계정의 ID를 입력해야 합니다.

키를 만들 때 Create as read-only API key 를 선택하면 조회(Get) 요청만 허용됩니다. adstage는 리포트 생성 요청을 보내므로 읽기 전용 키로는 거부될 수 있습니다. 거부되면 일반 키로 다시 발급해 주세요. 읽기 전용 키로도 되는지는 아직 실제 계정으로 확인되지 않았습니다.

만료일이 지나거나 Moloco에서 키를 Deactivate 하면 수집이 멈추고 상태가 실패로 바뀝니다. adstage는 Moloco 키의 만료일을 미리 알려 주지 않으므로, 만료일을 기록해 두고 만료 전에 새 키로 교체하세요.

3. 연동하기

adstage 대시보드 연동 > 광고 채널 연동에서 Moloco를 선택하고 비용 연동 탭을 엽니다.
Moloco 비용 연동 스위치를 켭니다. 스위치가 꺼져 있으면 연동 계정 추가 버튼을 누를 수 없습니다.
연동 계정 추가를 클릭하면 Moloco 비용 연동 창이 열립니다. 연동 정보 등록에 다음 항목을 입력합니다.

항목	필수	설명
계정 이름	필수	adstage에서 이 계정을 구분할 이름. 자유롭게 입력합니다
광고 계정 ID	필수	Moloco Ad Account Info에서 확인한 광고 계정 ID
API 키	필수	API Access에서 발급한 키. 입력 중에도 가려져 표시되며 암호화되어 저장됩니다
광고 계정 시간대 (선택)	선택	Moloco 광고 계정에 설정된 시간대. UTC, Asia/Seoul (KST), Asia/Tokyo (JST), Asia/Shanghai (UTC+8), America/Los_Angeles, America/New_York, Europe/London 중에서 고릅니다

연동을 클릭합니다. 버튼에 인증 중...이 표시되는 동안 adstage가 입력한 키로 Moloco 토큰을 발급받고 리포트 생성을 한 번 요청해 키가 유효한지 확인합니다.

연동 직후 계정 상태는 준비 중으로 표시되고, 최근 30일 데이터의 첫 수집이 바로 시작됩니다. Moloco 리포트는 비동기로 생성되므로 성공으로 바뀌기까지 보통 몇 분이 걸립니다.

광고 계정 시간대를 선택하세요

Moloco 광고 계정에 설정한 시간대가 예산 집행·리포트·청구의 기준이 됩니다. adstage에서 시간대를 비워 두면 수집한 일자를 UTC 기준으로 기록하므로, 광고 계정이 KST인데 비워 두면 하루 단위 비교에서 어긋남이 생길 수 있습니다. 목록에 없는 시간대라면 adstage 고객지원팀에 문의해 주세요.

연동 단계에서 표시되는 오류 메시지

메시지	원인	조치
필수 항목을 모두 입력해 주세요.	계정 이름·광고 계정 ID·API 키 중 빈 항목이 있음	빈 항목을 채웁니다
Moloco 에서 키를 거부했습니다. 키와 권한을 확인해 주세요.	키 오타, 만료·비활성화된 키, 키가 접근할 수 없는 광고 계정 ID, 읽기 전용 키 제한	키와 광고 계정 ID를 다시 확인하고 필요하면 새 키를 발급합니다
키 확인을 위해 Moloco 에 연결하지 못했습니다. 잠시 후 다시 시도해 주세요.	Moloco API 일시 장애 또는 요청 제한	잠시 후 다시 시도합니다
이미 등록된 계정입니다	같은 광고 계정 ID가 이 조직에 이미 등록되어 있음	기존 계정을 그대로 사용하거나, 삭제한 뒤 다시 추가합니다

4. 연동 계정 관리하기

연동된 계정은 비용 연동 탭의 계정 목록에서 확인할 수 있습니다.

열	설명
계정명	계정을 추가할 때 입력한 이름
상태	준비 중(첫 수집 진행 중), 성공(마지막 수집 정상), 실패(Moloco가 키를 거부함 등)
데이터가 업데이트된 최근 일시	비용 데이터가 마지막으로 저장된 시각
관리	계정 삭제

실패 표시에 마우스를 올리면 요약과 세부정보로 오류 내용을 볼 수 있습니다. 실패 상태여도 수집 주기마다 다시 시도하며, 원인이 해결되면 자동으로 성공으로 돌아옵니다. 일시적인 요청 제한이나 Moloco 장애로는 상태가 바뀌지 않습니다.
광고를 집행하지 않아 데이터가 0건이어도 연동 자체가 정상이면 상태는 성공입니다. 비용 데이터가 3일 넘게 저장되지 않으면 상태 옆에 경고 표시가 나타나고, 마우스를 올리면 조치 필요 안내와 함께 "N일째 광고비 데이터가 수집되지 않았습니다" 메시지가 표시됩니다.
API 키를 바꾸려면 관리 열의 삭제 아이콘으로 계정을 삭제한 뒤 새 키로 다시 추가합니다. 등록한 키를 화면에서 수정하는 기능은 없습니다.
Moloco 비용 연동 스위치를 끄면 이 조직의 모든 Moloco 계정 수집이 중단됩니다. 계정 정보는 남아 있으므로 스위치를 다시 켜면 수집이 재개됩니다.

주의하세요

계정을 삭제하면 해당 계정의 데이터 수집이 중단됩니다. 이미 수집된 과거 데이터는 adstage에 보관되지만, 새로운 데이터는 수집되지 않습니다.

5. 수집되는 데이터

항목	설명
수집 주기	4시간마다 (KST 1시, 5시, 9시, 13시, 17시, 21시)
업데이트 범위	최근 30일 (D-30 ~ D-1, 업데이트 당일 제외). 업데이트할 때마다 이 기간을 다시 가져와 최신 값으로 갱신
데이터 계층	캠페인 레벨 (일자 × 캠페인)
수집 지표	지출, 노출수, 클릭수, 설치수
통화	광고 계정의 계약 통화(USD·KRW·JPY·GBP·EUR 중 하나). 조직 기준 통화로 환산해 함께 저장합니다
시간대	연동할 때 고른 광고 계정 시간대. 고르지 않으면 UTC로 기록
채널명	`moloco.ads`

리포트에서는 매체 보고 값이라는 뜻으로 지표 이름에 **(Channel)**이 붙습니다.

리포트 지표	Moloco 값
광고비 (Channel)	지출(spend)
노출수 (Channel)	노출(impressions)
클릭수 (Channel)	클릭(clicks)
전환수 (Channel)	Moloco가 집계한 설치(installs)
전환 금액 (Channel)	수집하지 않음. 구매 매출은 adstage SDK로 측정한 값을 사용하세요

참고하세요

**전환수 (Channel)**은 Moloco가 자체 기준으로 집계한 설치입니다. adstage가 트래킹 링크로 귀속한 설치와는 다른 값입니다.

Moloco는 전일 데이터를 현지 시간 오전 3시 이후에 조회할 것을 권장합니다. 그 전에 수집된 전일 수치는 다음 주기에 다시 가져와 갱신됩니다.

같은 날짜·캠페인이 여러 행으로 나뉘어 오면 합산해 저장합니다.

지출·노출·클릭·설치가 모두 0인 행은 저장하지 않습니다.

Moloco는 캠페인을 집행하려면 MMP(측정 업체)로 어트리뷰션을 설정하도록 요구하며, 공식 문서가 안내하는 MMP는 AppsFlyer, Adjust, Singular, Branch, Kochava, Airbridge, Adbrix Remastered, Tenjin, Justtrack, Gamesight입니다. Moloco 콘솔 Assets > Tracking Links에서 트래킹 링크를 등록할 때 Tracking Company 칸이 앱에 연결된 MMP로 자동 지정되기 때문에, adstage 트래킹 링크(adg.im)를 등록할 수 있는지는 Moloco 담당자 확인이 필요합니다. adstage도 2026년 10월 8일 Moloco에 문의해 회신을 기다리고 있으며, 허용이 확인되면 이 페이지를 갱신합니다.

그래서 adstage는 Moloco용 트래킹 링크 템플릿을 제공하지 않으며, 딥링크 > 생성의 광고 채널 목록에도 Moloco는 없습니다.

담당자가 허용한다면 딥링크 > 생성의 커스텀 딥링크 탭에서 채널에 moloco를 입력해 링크를 만들 수 있습니다. 이 링크로 들어온 클릭·설치·이벤트는 비용과 같은 moloco.ads 채널로 집계됩니다. 캠페인 이름은 Moloco 캠페인 이름과 똑같이 직접 입력하세요.

전환 전송

adstage가 측정한 설치·구매를 Moloco로 보내는 기능은 제공하지 않습니다. Moloco가 측정 업체용 포스트백 규격을 공개하지 않아, 링크 단위로 설정하는 매체사 포스트백에도 Moloco 프리셋이 없습니다. 담당자에게 포스트백 URL 규격을 받으면 직접 입력할 수는 있지만, Moloco는 Moloco 귀속 여부와 관계없이 전체 포스트백을 받기를 권장하는 반면 매체사 포스트백은 해당 링크로 귀속된 전환만 보냅니다.

비용 수집은 트래킹 링크나 전환 전송 없이도 동작합니다. Moloco 쪽 설치·전환 측정은 기존 MMP 설정을 그대로 두고, adstage는 비용 수집용으로 함께 쓰는 구성을 권장합니다.

7. 주의사항

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

Moloco 콘솔과 adstage 간에 수치 차이가 발생할 수 있습니다. 집계 시점, 시간대, 통화 환산 기준이 다르기 때문입니다.
API 키가 만료되거나 비활성화되면 수집이 중단됩니다. 새 키를 발급해 계정을 다시 추가해 주세요.
연동 시점 기준 30일보다 오래된 데이터는 가져오지 않습니다.
Moloco API 요청 제한이나 장애가 있으면 수집이 일시적으로 지연될 수 있으며, 다음 주기에 자동으로 다시 시도합니다.
adstage는 Moloco 리포트를 읽기만 하며 캠페인 설정을 변경하지 않습니다.

8. 문제 해결

연동 과정에서 문제가 발생하면 다음 사항을 확인해 주세요.

계정 추가가 안 될 때

스위치 확인: Moloco 비용 연동 스위치가 켜져 있어야 연동 계정 추가 버튼이 활성화됩니다
필수 항목 확인: 계정 이름·광고 계정 ID·API 키를 모두 채워야 연동 버튼이 활성화됩니다
키 확인: API 키가 중간에 끊겨 복사되지 않았는지, 만료되거나 Deactivate되지 않았는지 확인
광고 계정 ID 확인: Ad Account Info의 값과 같은지, 키를 발급한 워크플레이스에 속한 광고 계정인지 확인
키 종류 확인: 읽기 전용 키라면 일반 키로 다시 발급

상태가 준비 중에서 오래 머물 때

Moloco 리포트 생성에는 몇 분이 걸릴 수 있으며 adstage는 최대 5분가량 기다립니다. 그 뒤에도 바뀌지 않으면 다음 수집 주기(최대 4시간)를 기다리고, 실패로 바뀌면 마우스를 올려 원인을 확인하세요.

데이터가 수집되지 않을 때

광고 집행 확인: 해당 기간에 Moloco 광고가 실제로 집행되었는지 확인. 지출·노출·클릭·설치가 모두 0인 날은 저장되지 않습니다
업데이트 주기 확인: 첫 수집은 연동 직후 시작되며, 이후 4시간마다 최근 30일(당일 제외) 데이터가 갱신됩니다. 오늘 데이터는 내일 업데이트부터 들어옵니다
경고 표시 확인: 계정 상태 옆에 경고 표시가 있는지 확인
시간대 확인: 광고 계정 시간대를 고르지 않아 UTC 기준으로 기록된 것은 아닌지 확인

수치가 Moloco 콘솔과 다를 때

시간대: Moloco 콘솔과 adstage 리포트가 같은 시간대 기준인지 확인
통화: 조직 기준 통화로 환산된 값을 보고 있는지 확인
집계 시점: Moloco 값은 사후에 바뀔 수 있으며, 최근 30일을 다시 가져올 때 반영됩니다
지표 정의: 전환수 (Channel)은 Moloco가 집계한 설치이며, adstage가 트래킹 링크로 귀속한 설치와는 별개입니다

추가 지원이 필요한 경우 adstage 고객지원팀에 문의해 주세요.

9. 자주 묻는 질문

Moloco 로그인(OAuth) 연동은 없나요?

없습니다. Moloco 리포팅 API는 API 키로 토큰을 발급받아 호출하므로 로그인이나 권한 승인 절차가 없습니다.

읽기 전용 API 키로 연동할 수 있나요?

아직 실제 계정으로 확인하지 못했습니다. 읽기 전용 키는 조회 요청만 허용하는데 adstage는 리포트 생성 요청을 보내므로, 거부되면 일반 키를 사용해 주세요.

광고 계정이 여러 개입니다. 어떻게 등록하나요?

광고 계정마다 연동 계정 추가로 계정을 하나씩 추가합니다. API 키는 워크플레이스 단위라 같은 키를 재사용할 수 있고, 광고 계정 ID만 다르게 입력하면 됩니다.

키가 만료되면 어떻게 하나요?

Moloco에서 새 키를 발급한 뒤 adstage에서 기존 계정을 삭제하고 새 키로 다시 추가합니다. 이미 수집된 데이터는 그대로 유지됩니다.

Moloco 광고로 들어온 설치를 adstage 리포트에서 캠페인별로 볼 수 있나요?

비용과 Moloco가 집계한 설치는 캠페인별로 수집됩니다. adstage 자체 귀속은 트래킹 링크가 있어야 하므로, Moloco의 커스텀 트래커 허용 여부가 확인된 뒤 템플릿과 함께 안내할 예정입니다.

10. 참고 문서

Get started with Moloco Ads API — API 키로 토큰 발급, 토큰 유효 기간 16시간
Generate campaign data reports (Report API) — adstage가 사용하는 리포트 API, 전일 데이터 조회 권장 시점
Create and manage API key — User settings > API Access에서 키 발급, 만료일·읽기 전용 옵션·워크플레이스당 5개 제한
Create ad accounts — 광고 계정 ID 확인 위치, 시간대·통화 설정
How to integrate with a mobile measurement partner (MMP) — Moloco가 연동하는 MMP 목록
Register tracking links — 트래킹 링크 등록 절차와 Tracking Company 칸