InMobi 연동

베타

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

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

1. 연동 개요

기능	지원 여부	설명
비용 수집	지원	캠페인별 지출·노출·클릭·설치를 4시간마다 자동 수집
클릭 귀속	제휴 후	InMobi는 지정한 측정 업체(MMP)의 트래킹 링크를 담당자가 캠페인에 설정합니다. 광고주가 직접 넣는 클릭 매크로는 공개되어 있지 않습니다
전환 전송	제휴 후	adstage가 측정한 전환을 InMobi로 보내는 기능입니다. InMobi가 측정 업체용 포스트백 규격을 공개하지 않아 제공하지 않습니다

클릭 귀속과 전환 전송은 adstage가 InMobi와 제휴한 뒤에 열립니다. adstage도 InMobi에 커스텀 트래커 허용 여부를 문의해 회신을 기다리고 있으며, 회신이 오는 대로 이 페이지를 갱신합니다. 자세한 내용은 아래 트래킹 링크와 전환 전송 절을 참고하세요.

2. API 유형 고르기

InMobi는 셀프서브 광고주와 담당자 운영 캠페인이 서로 다른 API를 씁니다. 계정을 추가할 때 API 유형에서 하나를 고르면 그에 맞는 입력란만 표시됩니다.

API 유형	이런 경우에 고릅니다	필요한 값	발급처
`InMobi Portal(셀프서브)`	InMobi 광고주 포털에 직접 로그인해 캠페인을 운영	로그인 이메일, API 키	광고주 포털에서 직접 발급
`InMobi DSP(담당자 관리)`	InMobi 담당자가 캠페인을 대신 운영	Client ID, Client Key(Secret)	InMobi 담당자가 발급

어느 쪽인지 모르겠다면, InMobi 광고주 포털에 직접 로그인해 캠페인을 만들고 있으면 InMobi Portal(셀프서브)입니다.

3. 키 발급받기

InMobi Portal(셀프서브)

InMobi 광고주 포털에 로그인합니다. adstage의 InMobi 키 발급 페이지 열기 버튼으로도 열 수 있습니다.
Account Settings 화면에서 API 키를 생성하고 복사합니다.
포털 로그인에 쓰는 이메일 주소가 그대로 로그인 이메일입니다.

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

InMobi DSP(담당자 관리)

InMobi 담당자(account manager)에게 Cost API Client ID와 Client Key(Secret) 발급을 요청하세요. 이 키는 광고주가 직접 발급할 수 없습니다. 셀프서브 포털 키와는 다른 값이므로 서로 섞어 넣으면 연동 단계에서 거부됩니다.

4. 연동하기

연동 > 광고 채널 연동에서 InMobi를 선택하고 비용 연동 탭을 엽니다.
InMobi 비용 연동 스위치를 켭니다. 스위치가 꺼져 있으면 연동 계정 추가 버튼을 누를 수 없습니다.
연동 계정 추가를 클릭하면 InMobi 비용 연동 창이 열립니다.
계정 이름에 adstage에서 이 계정을 구분할 이름을 입력하고, API 유형을 고른 뒤 아래 표시된 입력란을 채웁니다. 비밀값(API 키, Client Key)은 입력 중에도 가려져 표시되며 앞뒤 공백은 자동으로 지워집니다.
연동을 클릭합니다. 저장 전에 adstage가 InMobi에 세션(또는 토큰) 발급을 한 번 요청해 키가 유효한지 확인하고(버튼에 인증 중...이 표시됩니다), 확인이 끝나면 키는 암호화되어 저장되고 최근 30일 데이터의 첫 수집이 바로 시작됩니다.

연동 직후 계정 상태는 준비 중으로 표시되고, 첫 수집이 끝나면 성공으로 바뀝니다. InMobi 리포트는 비동기로 생성되어 첫 수집에 몇 분이 걸릴 수 있습니다.

연동 단계 오류 메시지	원인	조치
이미 등록된 계정입니다	같은 키가 이 조직에 이미 등록되어 있음	기존 계정을 그대로 사용
InMobi 에서 키를 거부했습니다. 키와 권한을 확인해 주세요.	키·이메일이 틀렸거나 API 유형과 키 종류가 맞지 않음	API 유형을 다시 확인하고 키를 새로 복사해 입력
키 확인을 위해 InMobi 에 연결하지 못했습니다. 잠시 후 다시 시도해 주세요.	InMobi API 일시 장애 또는 요청 제한	잠시 후 다시 시도

연동된 계정은 계정 목록에서 계정 이름, 상태, 데이터가 업데이트된 최근 일시, 관리(계정 삭제) 열로 확인할 수 있습니다. 키를 바꾸려면 관리 열의 삭제 아이콘으로 계정을 지운 뒤 새 키로 다시 추가합니다. 등록한 키를 화면에서 수정하는 기능은 없습니다.

5. 수집되는 데이터

항목	설명
수집 주기	4시간마다 (KST 1시, 5시, 9시, 13시, 17시, 21시)
업데이트 범위	최근 30일 (D-30 ~ D-1, 업데이트 당일 제외). 업데이트할 때마다 이 기간을 다시 가져와 최신 값으로 갱신
데이터 계층	캠페인 레벨 (일자 × 캠페인)
수집 지표	지출, 노출수, 클릭수, 설치수
통화	USD. InMobi 광고주 리포팅 API 문서가 지출을 미국 달러로 명시합니다. 조직 기준 통화로 환산해 저장합니다
시간대	UTC
채널명	`inmobi.ads` (리포트 채널 필터에서는 `InMobi`)

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

리포트 지표	InMobi 값
광고비 (Channel)	Portal은 지출(`spend`), DSP는 청구 예상액(`media_cost`)
노출수 (Channel)	노출(`impressions`)
클릭수 (Channel)	클릭(`clicks`)
전환수 (Channel)	Portal은 앱 설치(`downloads`), DSP는 설치(`installs`)와 SKAN 설치(`skan_installs`)
전환 금액 (Channel)	수집하지 않음. 구매 매출은 adstage SDK로 측정한 값을 사용하세요

참고하세요

전일 데이터는 UTC 06:00(KST 15:00) 이후에 확정됩니다. 그 전에 업데이트가 돌면 전전일까지만 수집되고, 다음 업데이트에서 전일이 채워집니다.

InMobi는 최근 90일만 조회할 수 있어, 그보다 오래된 데이터는 가져올 수 없습니다.

InMobi DSP(담당자 관리)는 Network·Programmatic·SKAN 세 리포트를 모두 조회해 합산합니다. 같은 날짜·캠페인·OS가 여러 리포트에 겹쳐 나오면 한 번만 반영하므로 중복 집계되지 않습니다.

InMobi DSP Cost API 문서는 통화와 시간대를 명시하지 않습니다. adstage는 Portal과 같은 USD·UTC로 가정해 저장하므로, 광고 계정의 과금 통화가 USD가 아니라면 InMobi 담당자에게 확인하고 adstage 고객지원팀에 알려 주세요.

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

InMobi는 캠페인의 트래킹 링크를 지정한 측정 업체(MMP) 목록 안에서 InMobi 담당자가 설정합니다. 광고주가 랜딩 URL에 직접 넣을 수 있는 클릭 매크로나, 측정 업체가 전환을 되돌려 보내는 포스트백 규격은 공개되어 있지 않습니다.

그래서 adstage는 InMobi용 트래킹 링크 템플릿을 제공하지 않으며, 딥링크 > 생성의 광고 채널 목록에도 InMobi는 없습니다. 링크 단위로 설정하는 매체사 포스트백에도 InMobi 프리셋이 없습니다. 두 기능 모두 adstage가 InMobi와 제휴해 규격을 받은 뒤에 열립니다.

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

커스텀 링크의 채널 이름에 inmobi를 넣어 만든 링크로 들어온 클릭·전환은 비용과 같은 inmobi.ads 채널로 집계됩니다. InMobi 담당자가 adstage 링크 사용을 허용한다면 이 방법을 쓸 수 있습니다.

7. 주의사항

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

InMobi와 adstage 간에 수치 차이가 발생할 수 있습니다. InMobi 리포트는 UTC 기준이고, 집계 시점과 통화 환산 기준도 다르기 때문입니다.
포털에서 API 키를 재발급하거나 담당자가 Client Key를 교체하면 기존 키로는 수집이 중단되고 상태가 실패로 바뀝니다. 계정을 삭제한 뒤 새 키로 다시 등록해 주세요.
InMobi 비용 연동 스위치를 끄면 이 조직의 모든 InMobi 계정 수집이 중단됩니다. 계정 정보는 남아 있어 스위치를 다시 켜면 수집이 재개됩니다.
adstage는 InMobi 리포트를 읽기만 하며 캠페인 설정을 변경하지 않습니다.

8. 문제 해결

계정 추가가 안 될 때

API 유형 확인: 셀프서브 포털 키를 InMobi DSP에, 담당자 발급 키를 InMobi Portal에 넣지 않았는지 확인
이메일 확인: 포털 모드에서는 포털 로그인에 쓰는 이메일 주소를 그대로 입력해야 합니다
복사 누락 확인: 키가 중간에 끊겨 복사되지 않았는지 확인 (앞뒤 공백은 자동으로 지워집니다)
스위치 확인: InMobi 비용 연동 스위치가 켜져 있어야 연동 계정 추가 버튼이 활성화됩니다

상태가 실패일 때

오류 내용 확인: 상태 표시에 마우스를 올려 오류 확인
키 폐기 확인: 키를 거부한다는 오류라면 키가 폐기·재발급된 것이므로 계정을 삭제하고 새 키로 다시 등록
요청 제한·일시 오류: 자동으로 다시 시도하므로 다음 업데이트를 기다리면 됩니다

데이터가 수집되지 않을 때

연동 활성화 확인: InMobi 비용 연동 스위치가 켜져 있는지 확인
광고 집행 확인: 지출·노출·클릭·설치가 모두 0인 날은 저장되지 않으므로, InMobi에서 실제로 광고가 집행되었는지 확인
업데이트 주기 확인: 당일 데이터는 수집하지 않으므로 오늘 수치는 내일부터 보입니다. 전일 수치는 KST 15시 이후 업데이트부터 들어옵니다
경고 표시 확인: 비용 데이터가 3일 넘게 저장되지 않으면 상태 옆에 경고 표시가 나타나고, 마우스를 올리면 며칠째 수집되지 않았는지 안내가 보입니다

수치가 InMobi 콘솔과 다를 때

시간대: InMobi 콘솔을 UTC 기준으로 두고 같은 날짜를 비교
통화: adstage 값은 조직 기준 통화로 환산된 금액입니다
집계 시점: InMobi 값은 사후에 바뀔 수 있으며, 최근 30일을 다시 가져올 때 반영됩니다
합산 단위: adstage는 캠페인 합계만 저장하므로 InMobi에서 국가·OS로 나눈 보기와는 직접 비교하지 않습니다

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

9. 자주 묻는 질문

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

없습니다. InMobi 리포팅 API는 발급받은 키로 호출되므로 로그인이나 권한 승인 절차가 없습니다.

Portal과 DSP를 둘 다 등록할 수 있나요?

네. API 유형을 달리해 계정을 각각 추가하면 둘 다 수집됩니다. 다만 같은 캠페인이 두 상품에 걸쳐 있으면 비용이 두 번 더해질 수 있으니, 담당자에게 어느 쪽이 실제 과금 기준인지 확인한 뒤 하나만 등록하는 것을 권장합니다.

전환수 (Channel)과 adstage 설치 수가 왜 다른가요?

전환수 (Channel)은 InMobi가 자체 기준으로 집계한 설치이고, adstage 설치는 adstage SDK와 트래킹 링크로 측정한 값입니다. InMobi 트래킹 링크를 쓰지 못하는 동안에는 InMobi 유입 설치가 adstage에서 inmobi.ads 채널로 귀속되지 않으므로 두 값은 다를 수밖에 없습니다.

10. 참고 문서

InMobi Advertiser Reporting API Guide — Account Settings의 API 키 위치, 세션 24시간 유효, 90일 조회 범위, UTC·USD 기준, 컬럼 정의 (주소에 /ja/가 들어 있지만 본문은 영어입니다)
Cost API Integration for InMobi DSP — Client ID·Key 발급 문의 경로, 토큰 8시간 유효, 90일 조회 범위, Network·Programmatic·SKAN 리포트 지표 정의

InMobi 연동

목차