Mintegral 연동

adstage에서는 Mintegral(AppGrowth) 광고의 비용·노출·클릭·전환을 Mintegral 콘솔에서 확인한 API 키로 수집하고, 트래킹 링크로 유입된 클릭·설치·이벤트를 mintegral.ads 채널로 집계할 수 있습니다. 설치·이벤트를 Mintegral로 돌려보내는 S2S 포스트백은 링크 단위로 설정합니다.

베타

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

1. 연동 개요

Mintegral은 OAuth 로그인이나 담당자 승인 없이, 광고주가 콘솔에서 직접 확인한 Access Key와 API Key만으로 연동됩니다.

2. Access Key·API Key 확인하기

1. Mintegral 광고주 대시보드에 로그인합니다. 광고주 계정이 없다면 먼저 가입합니다.

2. Account(Account Management) > Basic Information으로 이동합니다.

3. 표시된 API Key와 Access Key를 복사합니다. 두 값은 서로 다르며, adstage에 둘 다 입력해야 합니다.

adstage 대시보드의 비용 연동 탭과 계정 추가 창에도 같은 안내(Mintegral 키 발급 방법)와 Mintegral 키 발급 페이지 열기 버튼이 있습니다.

3. 비용 연동하기

1. adstage 대시보드 연동 > 광고 채널 연동 > Mintegral에서 비용 연동 탭을 엽니다.

2. Mintegral 비용 연동 스위치를 켭니다. 스위치가 꺼져 있으면 연동 계정 추가 버튼을 누를 수 없습니다.

3. 연동 계정 추가를 클릭하고 다음을 입력합니다.

4. 연동을 클릭합니다. adstage가 저장 전에 Mintegral API를 한 번 호출해 키가 유효한지 확인하며(인증 중...), 두 키는 암호화되어 저장됩니다.

5. 계정이 목록에 준비 중 상태로 추가되고 첫 수집(최근 30일)이 바로 시작됩니다. Mintegral 리포트는 비동기로 생성되므로 성공으로 바뀌기까지 몇 분 걸릴 수 있습니다.

주의하세요

• "Mintegral 에서 키를 거부했습니다"가 표시되면 Access Key와 API Key가 서로 바뀌지 않았는지, 복사할 때 공백이 섞이지 않았는지 확인하세요.
• "키 확인을 위해 Mintegral 에 연결하지 못했습니다"는 Mintegral 쪽 일시 장애입니다. 잠시 후 다시 시도하세요.
• 같은 Access Key는 한 조직에 한 번만 등록할 수 있습니다. 다시 등록하면 "이미 등록된 계정입니다"가 표시됩니다.

연동 계정 관리하기

계정 목록에는 계정명, 상태, 데이터가 업데이트된 최근 일시, 관리(삭제) 열이 표시됩니다.

• 준비 중: 계정 추가 직후 첫 수집이 진행 중입니다.
• 성공: Mintegral API 호출이 정상입니다. 광고를 집행하지 않아 수집된 행이 0건이어도 성공으로 표시됩니다.
• 실패: 키가 바뀌었거나 권한이 없어 Mintegral이 요청을 거부했습니다. 배지에 마우스를 올리면 원인을 볼 수 있습니다. 업데이트 때마다 다시 시도하므로 원인이 해결되면 자동으로 성공으로 돌아옵니다.

상태가 성공이어도 3일 넘게 비용 데이터가 저장되지 않으면 상태 옆에 ⚠️ 경고와 조치 필요 안내가 나타납니다. 광고 미집행이 아니라면 연동을 확인해 주세요.

계정을 삭제하면 그 계정의 수집이 중단됩니다. 이미 수집된 데이터는 adstage에 남습니다. 키가 바뀌었다면 계정을 삭제하고 새 키로 다시 추가하세요.

4. 트래킹 링크 만들기

1. 딥링크 > 생성에서 트래킹 링크를 선택하고 광고 채널 선택에서 Mintegral을 고릅니다.

2. 광고그룹 칸에 {offer_name}, 광고소재 칸에 {creative_name}이 프리셋으로 채워집니다. 그대로 두면 Mintegral이 클릭 순간 실제 값으로 바꿔 줍니다.

3. 캠페인 칸은 매크로가 없어 직접 입력합니다. 비용이 오퍼 단위로 수집되어 리포트의 캠페인 자리에 오퍼 이름이 들어가므로, 캠페인 칸에도 {offer_name}을 넣는 것을 권장합니다. 그러면 링크 하나로 모든 오퍼의 비용과 전환이 같은 이름으로 합쳐집니다. 캠페인별 구분이 필요 없다면 비워 두고 리포트를 채널(mintegral.ads) 단위로 봐도 됩니다.

4. 광고가 노출된 하위 매체까지 구분하려면 채널 상세정보 추가를 누릅니다. 매체 칸에 {affiliate_id}가 채워집니다.

5. 리다이렉트 설정을 지정하고 저장한 뒤 생성된 트래킹 링크를 복사합니다.

링크에는 다음 매크로가 들어갑니다. 클릭 ID·프로모션 ID와 캠페인·오퍼·소재 ID는 입력 여부와 관계없이 항상 붙습니다.

예시:

https://adg.im/@{조직}/track/mintegral.ads?short_path={링크경로}&campaign={offer_name}&campaign_id={adv_campaign_id}&ad_group={offer_name}&ad_group_id={adv_offer_id}&ad_creative={creative_name}&ad_creative_id={creative_id}&sub_channel={affiliate_id}&click_id={click_id}&campuuid={uuid}

Mintegral에 링크 넣기

Mintegral 콘솔에서 오퍼를 만들 때 Tracking URL 화면의 클릭 URL 칸에 위 링크를 넣고, 검증 후 저장합니다. 이어서 테스트 기기의 광고 ID(iOS는 IDFA, 중국 외 Android는 GAID)를 입력하고 Test를 누르면 QR 코드가 생성되며, 이를 스캔하면 adstage로 테스트 클릭이 전송됩니다. 정확한 메뉴 위치는 아래 참고 문서를 확인하거나 Mintegral 담당자에게 문의하세요.

주의하세요

• adg.im/{링크경로} 형태의 짧은 주소가 아니라 매크로가 들어간 트래킹 링크 원본을 넣으세요.
• 링크의 매크로를 지우거나 바꾸지 마세요. 특히 campuuid={uuid}가 빠지면 Mintegral로 보내는 포스트백에 필수값이 비어 전환을 인정받지 못합니다.
• 비용은 오퍼(리포트의 캠페인) 단위까지만 수집됩니다. 리포트를 광고그룹·소재 단위로 나누면 전환만 잘게 나뉘고 비용은 캠페인 행에 남습니다.

5. Mintegral로 전환 보내기

Mintegral은 광고주 서버가 직접 보내는 S2S 포스트백 규격을 공개합니다. 설정은 연동 화면이 아니라 트래킹 링크의 매체사 포스트백에서 링크 단위로 합니다. 공통 동작(중복 방지, 재시도)은 매체사 포스트백을 참고하세요.

1. Mintegral 트래킹 링크의 생성 또는 상세 화면에서 매체사로 설치 포스트백 전송 스위치를 켭니다. 광고 채널이 Mintegral인 링크는 켜는 순간 Mintegral 프리셋이 자동으로 채워집니다. 비어 있으면 매체 프리셋에서 Mintegral — Install & events (S2S)를 고르세요.

2. 채워진 값을 확인합니다. 설치와 이벤트의 주소가 달라 설치 포스트백 URL 템플릿과 이벤트 포스트백 URL 템플릿이 모두 채워지고, 클릭 ID 파라미터는 click_id, 전송 대상 이벤트는 install로 설정됩니다.

설치:   https://postback.mintegral.net/install?campuuid={campuuid}&clickid={click_id}&idfa={idfa}&gaid={gaid}&type=s2s&install_time={timestamp}
이벤트: https://postback.mintegral.net/event?campuuid={campuuid}&clickid={click_id}&idfa={idfa}&gaid={gaid}&type=s2s&event_time={timestamp}&event_name={event}&event_value={revenue}&currency={currency}

3. 전송 대상 이벤트를 정합니다. 기본값은 install뿐입니다. 구매 등 설치 후 이벤트도 보내려면 이벤트를 추가하고, Mintegral과 합의한 이름이 adstage 이벤트명과 다르면(예: purchase를 Purchase로) 이벤트명 매핑에 넣습니다.

참고하세요

• adstage는 그 링크로 귀속된 설치·이벤트만 보내며, 같은 클릭의 같은 이벤트는 한 번만 전송됩니다. install과 first_open은 하나로 묶입니다.
• Mintegral 문서의 파라미터 표에는 attribu_type·app_id가 필수로 표시되어 있지만, 문서의 예시 템플릿과 adstage 프리셋에는 없습니다. 집행 전 테스트 클릭·설치로 Mintegral 콘솔에 전환이 들어오는지 확인하고, 들어오지 않으면 Mintegral 담당자에게 두 값이 필요한지 확인하세요.
• Mintegral 공식 목록에 없는 측정 도구(adstage 포함)의 링크를 받으려면 화이트리스트 등록이 필요한지는 확인되지 않았습니다. 첫 집행 전에 Mintegral 담당자에게 확인하는 것을 권장합니다.

6. 수집되는 데이터

비용 연동으로 수집되는 데이터는 Mintegral이 보고한 값이며, 일별·오퍼 단위로 저장됩니다. 리포트에서는 매체 보고 값이라는 뜻으로 지표 이름에 **(Channel)**이 붙습니다.

7. 주의사항

• 비용·노출·클릭·전환이 모두 0인 행은 저장되지 않습니다. 광고를 집행하지 않은 기간이 비어 보이는 것은 정상입니다.
• Mintegral과 adstage 간에 수치 차이가 있을 수 있습니다. UTC+8 기준 집계, 환율 환산, Mintegral 전환 정의의 차이 때문입니다.
• 당일 데이터는 수집하지 않습니다. 어제까지의 데이터만 조회됩니다.
• 커스텀 링크의 채널에 mintegral이라고만 써도 리포트에서는 mintegral.ads로 집계됩니다.

8. 문제 해결

계정이 추가되지 않을 때

1. 키 확인: Access Key와 API Key를 Basic Information에서 다시 복사해 각각 맞는 칸에 넣었는지 확인
2. 스위치 확인: Mintegral 비용 연동 스위치가 켜져 있는지 확인
3. 중복 확인: 같은 Access Key가 이미 목록에 있는지 확인

데이터가 수집되지 않을 때

1. 상태 확인: 상태가 실패면 마우스를 올려 원인을 확인. 인증 오류면 계정을 삭제하고 새 키로 다시 등록
2. 확정 시간 확인: 전일 데이터는 한국 시간 새벽 이후 반영됨. 당일 데이터는 수집하지 않음
3. 기간 확인: 180일 이전, 계정 가입일 이전 데이터는 가져올 수 없음
4. 경고 확인: 상태 옆에 ⚠️가 있으면 며칠째 데이터가 없는지 확인

Mintegral에 전환이 보이지 않을 때

1. 링크 확인: Mintegral에 넣은 클릭 URL에 click_id={click_id}와 campuuid={uuid}가 남아 있는지 확인
2. 포스트백 설정 확인: 해당 링크에 매체사로 설치 포스트백 전송이 켜져 있고 프리셋 주소가 들어 있는지, 보내려는 이벤트가 전송 대상 이벤트에 있는지 확인
3. 귀속 확인: adstage 리포트에서 해당 설치가 mintegral.ads로 귀속됐는지 확인. 귀속되지 않은 이벤트는 보내지 않음
4. 지연 확인: Mintegral은 측정 도구에서 받은 포스트백 반영이 보통 1시간을 넘지 않는다고 안내합니다

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

9. 자주 묻는 질문

Mintegral 담당자 없이도 연동할 수 있나요? 비용 연동은 가능합니다. 광고주 대시보드에서 직접 확인한 Access Key와 API Key만 있으면 됩니다. 포스트백도 공개 규격이라 별도 발급이 없습니다. 다만 오퍼의 Tracking URL 등록과 테스트는 Mintegral 콘솔에서 진행합니다.

전환 전송 탭이 없는데 어디서 켜나요? Mintegral은 연동 화면에 전환 전송 탭이 없습니다. 트래킹 링크의 매체사 포스트백에서 프리셋을 골라 켭니다.

리포트의 캠페인에 Mintegral 캠페인이 아니라 오퍼가 보입니다. 의도된 동작입니다. Mintegral의 "캠페인"은 앱(패키지) 단위이고 실제 운영 단위는 오퍼라서, 비용을 오퍼 단위로 저장합니다. 앱 단위 캠페인 ID는 링크의 campaign_id로 함께 기록됩니다.

연동 전 데이터도 가져올 수 있나요? 연동 직후 최근 30일을 자동으로 가져옵니다. Mintegral API가 제공하는 최근 180일 범위에서 그 이전 데이터가 필요하면 adstage 고객지원팀에 문의해 주세요.

10. 참고 문서

• Mintegral Open API 시작하기
• 광고주 등록 및 API Key 확인
• 토큰 인증(Access Key·API Key)
• Advanced Performance Report
• 트래킹 URL 매크로
• 트래킹 설정 절차
• 포스트백 규격
• 서드파티 트래킹 벤더(MMP) 목록
• 연동 문제 해결 FAQ