모비온 (MOBON) 연동

베타

모비온 연동은 실제 광고주 계정으로 검증 중입니다(연동 카드에 베타 표시). adstage 수치가 모비온 리포트와 다르면 adstage 고객지원팀에 알려 주세요.

adstage에서는 모비온(인라이플) 캠페인의 광고비·노출·클릭을 자동으로 수집해 다른 매체와 한 리포트에서 비교할 수 있습니다. 모비온 연동은 adstage 대시보드 연동 > 광고 채널 연동 > MOBON의 비용 연동 탭에서 진행하며, 별도의 API 키 없이 모비온 광고주(또는 대행사) 로그인 정보를 사용합니다.

1. 연동 개요

기능	지원 여부	설명
비용 수집	지원	캠페인별 지출·노출·클릭을 4시간마다 자동 수집
트래킹 링크 템플릿	미제공	모비온이 클릭 매크로를 공개하지 않습니다. 커스텀 딥링크로 `mobon.ads` 채널 집계는 가능합니다
전환 전송	지원하지 않음	모비온이 측정 업체용 앱 포스트백 규격을 공개하지 않습니다
채널명	`mobon.ads`	리포트의 채널 필터에는 `MOBON`으로 표시

2. 준비하기

모비온은 API 전용 키를 따로 발급하지 않습니다. 평소 모비온에 로그인할 때 쓰는 정보를 그대로 입력합니다.

입력 항목	설명
계정 이름	adstage에서 이 계정을 구분할 이름 (예: `모비온 - 브랜드A`)
로그인 ID	모비온 광고주 또는 대행사 로그인 ID
비밀번호	그 계정의 비밀번호

화면의 MOBON 키 발급 방법 안내에도 "모비온은 별도 키 없이 기존 광고주(또는 대행사) 로그인 아이디와 비밀번호를 씁니다"라고 같은 내용이 표시됩니다.

주의하세요 — 발신 IP 등록

모비온 API는 최초로 호출이 발생한 IP를 자동으로 화이트리스트에 등록하고, 그 밖의 IP는 차단합니다. 추가 서버나 IP는 모비온에 별도 등록을 요청해야 합니다.

그래서 계정 추가는 adstage 대시보드에서만 진행해 주세요. 같은 ID로 다른 서버나 PC에서 먼저 API를 테스트하면 그 IP가 등록되어 adstage 수집이 막힐 수 있습니다. 이미 막혔다면 모비온 담당자에게 adstage 서버 IP 추가 등록을 요청하세요.

3. 연동하기

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

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

메시지	원인
MOBON 에서 키를 거부했습니다. 키와 권한을 확인해 주세요.	로그인 ID·비밀번호가 틀렸거나, 발신 IP가 모비온 화이트리스트에 없는 경우
키 확인을 위해 MOBON 에 연결하지 못했습니다. 잠시 후 다시 시도해 주세요.	모비온 측 일시 장애 또는 요청 한도(분당 120건) 초과. 잠시 후 다시 시도하세요
이미 등록된 계정입니다	같은 로그인 ID가 이 조직에 이미 연동된 경우

광고주 계정이 여럿이면 로그인 ID마다 계정을 하나씩 추가합니다.

4. 연동 계정 관리하기

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

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

참고하세요

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

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

연동 정보는 수정할 수 없습니다. 모비온 비밀번호를 바꿨다면 계정을 삭제한 뒤 다시 추가하세요.

MOBON 비용 연동 스위치를 끄면 이 조직의 모든 모비온 계정 수집이 중단됩니다. 계정 정보는 남아 있어 다시 켜면 수집이 재개됩니다.

5. 수집되는 데이터

항목	설명
수집 주기	4시간마다 (KST 1시, 5시, 9시, 13시, 17시, 21시)
수집 범위	최근 30일 (D-30 ~ D-1, 수집 당일 제외). 매번 30일을 다시 가져와 나중에 정정된 수치를 갱신합니다
첫 수집	계정 추가 직후 바로 시작하며 보통 몇 분 안에 끝납니다. 당일 데이터는 수집하지 않으므로 오늘 수치는 내일부터 보입니다
데이터 계층	캠페인 단위(일자 × 캠페인). 광고그룹·소재 데이터는 수집하지 않습니다
리포트 지표	광고비 (Channel), 노출수 (Channel), 클릭수 (Channel)
통화	모비온 문서에 통화가 명시되어 있지 않아 국내 매체 기준인 KRW로 받고, 조직 기준 통화로 환산해 저장합니다
시간대	모비온 문서에 시간대가 명시되어 있지 않아 KST(Asia/Seoul) 기준으로 기록합니다. 대시보드에도 `리포트 기준 시간대: KST`로 표시됩니다
채널명	`mobon.ads`

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

리포트 지표	모비온 값
광고비 (Channel)	소진 금액(`advrtsAmt`)
노출수 (Channel)	노출(`viewCnt`)
클릭수 (Channel)	클릭(`clickCnt`)
전환수 (Channel)	비어 있음. 모비온 전환(`convCnt`)은 쇼핑 전환이지 앱 설치가 아니므로 설치·전환 지표로 집계하지 않고 원본 데이터에만 보관합니다
전환 금액 (Channel)	비어 있음. 모비온 총매출(`totalSales`)도 원본 데이터에만 보관합니다. 매출은 adstage SDK로 측정한 값을 사용하세요

참고하세요

캠페인은 모비온 캠페인 번호(kpiNo)로 구분하고, 리포트의 캠페인 이름에는 캠페인명(kpiNm)이 표시됩니다.

지출·노출·클릭이 모두 0인 날은 저장하지 않습니다.

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

모비온은 클릭 ID 매크로와 앱 포스트백(전환 전송) 규격을 공개 문서로 제공하지 않습니다. 그래서 딥링크 > 생성의 광고 채널 목록과 매체사 포스트백의 매체 프리셋에는 모비온이 없습니다.

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

7. 주의사항

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

모비온 리포트와 adstage 간에 수치 차이가 발생할 수 있습니다. 집계 시점과 통화·시간대 기준이 다르기 때문입니다.
수집 당일 데이터는 수집하지 않습니다. 어제까지의 데이터만 리포트에 표시됩니다.
모비온 비밀번호를 바꾸거나 계정 권한이 회수되면 수집이 중단되고 상태가 실패로 바뀝니다.
모비온 API는 분당 120건으로 제한됩니다. adstage는 하루씩 나눠 간격을 두고 호출하므로 평소에는 문제가 없지만, 같은 계정을 다른 도구에서 동시에 호출하면 제한에 걸릴 수 있습니다.
adstage는 모비온 리포트를 읽기만 하며 캠페인 설정을 변경하지 않습니다.

8. 문제 해결

계정을 추가할 수 없을 때

로그인 확인: 입력한 ID·비밀번호로 모비온에 직접 로그인되는지 확인
IP 등록 확인: 같은 ID로 다른 서버·PC에서 API를 먼저 호출한 적이 있는지 확인하고, 있다면 모비온에 adstage 서버 IP 추가 등록을 요청
스위치 확인: MOBON 비용 연동 스위치가 켜져 있어야 연동 계정 추가 버튼이 활성화됩니다
중복 확인: 같은 로그인 ID가 이미 계정 목록에 있는지 확인

데이터가 수집되지 않을 때

연동 활성화 확인: MOBON 비용 연동 스위치가 켜져 있는지 확인
집행 여부 확인: 모비온에서 해당 기간에 실제 지출이 있는지 확인 (지출·노출·클릭이 모두 0인 날은 저장하지 않습니다)
수집 범위 확인: 당일 데이터는 수집하지 않으며, 연동 시점 기준 최근 30일만 가져옵니다
경고 표시 확인: 계정 상태 옆에 경고가 있는지 확인

수치가 모비온 리포트와 다를 때

기간: 모비온 리포트를 같은 날짜(KST 기준)로 맞춰 비교
통화: adstage 값은 조직 기준 통화로 환산된 금액입니다
집계 단위: adstage는 캠페인 합계만 저장하므로, 모비온에서 광고그룹·소재나 웹·모바일로 나눈 보기와는 직접 비교하지 않습니다

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

9. 자주 묻는 질문

API 키를 따로 발급받아야 하나요?

아니요. 모비온은 광고주(또는 대행사) 로그인 ID와 비밀번호로 인증합니다. adstage가 내부적으로 토큰을 발급받아 사용하므로 별도 발급 절차는 없습니다.

대행사 계정으로 연동해도 되나요?

됩니다. 모비온 통계 API는 광고주와 대행사 ID 모두를 지원합니다. 다만 그 계정으로 조회되는 캠페인만 수집됩니다.

리포트의 전환수 (Channel)·전환 금액 (Channel)이 비어 있습니다.

의도된 동작입니다. 모비온 전환은 쇼핑 전환이라 앱 설치·전환 지표로 집계하지 않습니다. 성과는 광고비 (Channel)·노출수 (Channel)·클릭수 (Channel)와 adstage가 직접 측정한 이벤트 지표로 보세요.

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

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

10. 참고 문서

모비온 API 문서 — adstage가 비용 수집에 사용하는 API입니다. 토큰 발급(POST /api/token), 광고주·대행사 기준 캠페인별 통계(POST /api/report/ad/stats), 최초 호출 IP 자동 화이트리스트 등록과 추가 IP 별도 등록 요청, 분당 120건 제한이 안내되어 있습니다.
모비온 API 센터 — 위 문서로 연결됩니다.
모비온 광고주 로그인 — adstage에 입력할 로그인 ID·비밀번호를 쓰는 곳입니다.

모비온 (MOBON) 연동

目录