이 가이드에서는 Google 모바일 광고 SDK를 사용하여 광고를 로드하고 게재하는 방법을 설명합니다. 미디에이션, 폭포식 구조 및 입찰 통합을 모두 다룹니다. 다음을 포함합니다. 광고 단위의 미디에이션 구성에 Mintegral을 추가하는 방법 및 Mintegral SDK와 어댑터를 Android 앱.
지원되는 통합 및 광고 형식
Mintegral용 미디에이션 어댑터의 기능은 다음과 같습니다.
통합 | |
---|---|
입찰 | 를 탭합니다. 1 |
폭포 | 를 탭합니다. 2 |
형식 | |
앱 열기 | 를 탭합니다. <ph type="x-smartling-placeholder"> |
배너 | |
전면 광고 | |
리워드 제공됨 | |
보상형 전면 광고 | |
네이티브 | 를 탭합니다. <ph type="x-smartling-placeholder"> |
2 폭포식 구조 통합이 사용되었습니다. 있습니다.
요구사항
- Android API 수준 21 이상
최신 Google 모바일 광고 SDK
중재 완료 시작 가이드
1단계: Mintegral UI에서 구성 설정
앱 키 찾기
앱 설정 탭으로 이동하여 앱 키를 기록해 둡니다.
새 애플리케이션 추가
앱 설정 탭에서 앱 추가 버튼을 클릭합니다.
Platform을 선택하고 양식의 나머지 부분을 작성합니다. 그런 다음 저장을 클릭합니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/new_application_Android.png?authuser=2&hl=ko)
애플리케이션의 앱 ID를 기록해 둡니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/app_id_Android.png?authuser=2&hl=ko)
광고 게재위치 만들기
애플리케이션이 생성되면 게재위치 및 단위 탭으로 이동하고 아래와 같이 게재위치 추가 버튼을 클릭하여 광고 게재위치를 만듭니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/create_placement_Android.png?authuser=2&hl=ko)
게재위치 이름 및 광고 형식을 입력합니다.
입찰 유형으로 헤더 입찰을 선택합니다. 양식의 나머지 부분을 작성하고 저장을 클릭합니다.
광고 게재위치가 생성되면 게재위치 ID를 기록해 둡니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=2&hl=ko)
광고 단위 1개 드롭다운을 클릭하고 광고 단위 ID를 기록해 둡니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=2&hl=ko)
Mintegral Reporting API 키 찾기
입찰
이 단계는 입찰 통합에는 필요하지 않습니다.
폭포
Ad Manager 광고 단위 ID를 설정하려면 Mintegral Reporting API 키가 필요합니다. 계정 > API 도구로 이동합니다. Skey 및 Secret을 기록해 둡니다.
2단계: UI에서 Ad Manager Mintegral 수요 설정
Ad Manager 계정에 로그인합니다.
회사에 Mintegral 추가
입찰
이 단계는 입찰 통합에는 필요하지 않습니다.
폭포
관리 > 회사로 이동한 다음 모든 회사 탭에서 새 회사 버튼을 클릭합니다. 광고 네트워크를 선택합니다.
Mintegral을 광고 네트워크로 선택하고 고유한 이름을 입력한 다음 미디에이션을 사용 설정합니다.
사용자 이름 또는 비밀번호는 입력하지 않아도 됩니다. 완료되면 저장을 클릭합니다.
보안 처리된 신호 공유 사용 설정
입찰
관리 > 전체 설정으로 이동합니다. Ad Exchange 계정 설정 탭으로 이동하여 검토하고 보안 처리된 신호 공유를 사용 설정합니다. 저장을 클릭합니다.
폭포
이 단계는 폭포식 구조 통합에는 필요하지 않습니다.
입찰 Mintegral 구성
입찰
게재 > 입찰자로 이동하고 SDK 입찰 탭에서 새 입찰자를 클릭합니다.
Mintegral를 입찰자로 선택합니다.
이 입찰자의 신호 라이브러리를 허용된 신호 목록에 추가 및 신호가 이 입찰자와 공유되도록 허용을 사용 설정합니다. 그런 다음 계속을 클릭합니다.
계속을 클릭합니다.
완료를 클릭합니다.
폭포
이 단계는 폭포식 구조 통합에는 필요하지 않습니다.
광고 단위 매핑 구성
입찰
게재 > 입찰자로 이동하고 SDK 입찰 탭에서Mintegral 의 회사를 선택합니다.
광고 단위 매핑 탭으로 이동하여 새 광고 단위 매핑을 클릭합니다.
특정 광고 단위를 선택합니다. 광고 단위와 형식, 모바일 앱을 인벤토리 유형으로, 모바일 애플리케이션을 선택합니다. 그런 다음 이전 섹션에서 가져온App Key, App ID, Placement ID, and Ad Unit ID 을 입력합니다. 마지막으로 저장을 클릭합니다.
폭포
게재 > 수익 그룹으로 이동하여 새 수익 그룹 버튼을 클릭합니다. 모바일 애플리케이션을 선택합니다.
아래로 스크롤하여 수익 파트너 추가를 클릭합니다.
이전 섹션에서 만든 Mintegral 회사를 선택합니다. 통합 유형으로 모바일 SDK 미디에이션을, 플랫폼으로 Android, 상태로 활성을 선택합니다.
이전 섹션에서 가져온 App Key, App ID, Placement ID, and Ad Unit ID와 기본 CPM 값을 입력합니다. Save를 클릭합니다.
GDPR 및 미국 주 규정 광고 파트너 목록에 Mintegral 추가
GDPR 설정 및 미국 주 규정 설정 Mintegral 를 Ad Manager UI의 GDPR 및 미국 주 규정 광고 파트너 목록에 추가합니다.
3단계: Mintegral SDK 및 어댑터 가져오기
Android 스튜디오 통합 (권장)
프로젝트 수준 settings.gradle.kts
파일에 다음을 추가합니다.
저장소:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
}
}
}
그런 다음 앱 수준 build.gradle.kts
파일에 다음을 추가합니다.
구현 종속 항목 및 구성이 포함됩니다. 최신 버전의
Mintegral SDK 및 어댑터:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:mintegral:16.8.11.0")
}
수동 통합
Mintegral SDK를 포함하려면 Android용 Mintegral SDK로 이동하세요.
다음으로 이동합니다. Mintegral 어댑터 아티팩트 확인할 수 있습니다. 최신 버전을 선택하고 Mintegral을 다운로드합니다. 어댑터의
.aar
파일을 가져와서 프로젝트에 추가합니다.
4단계: Mintegral SDK에서 개인 정보 보호 설정 구현
EU 동의 및 GDPR
Google EU 사용자 동의에 따름 정책에 따라 특정 정보 공개가 이루어지도록 해야 합니다. 다음과 관련하여 유럽 경제 지역 (EEA) 사용자의 동의를 얻은 기기 식별자 및 개인 정보의 사용 이 정책에는 EU 온라인 개인 정보 보호 지침 및 일반 데이터 보호 요구사항 규정 (GDPR). 동의를 받을 때 각 광고 네트워크를 명시해야 합니다. 개인 정보를 수집, 수신 또는 사용할 수 있는 미디에이션 체인에서 각 네트워크의 사용에 대한 정보를 제공합니다. Google에서는 현재 사용자의 동의 여부를 이러한 네트워크에 자동으로 전달합니다.
Mintegral SDK에는 동의를 전달하는 setConsentStatus
메서드가 포함되어 있습니다.
Mintegral SDK에 정보를 보냅니다.
다음 샘플 코드는 동의 정보를 Mintegral에 전달하는 방법을 보여줍니다. 사용할 수 있습니다. 이 옵션은 Google 모바일 광고 SDK를 초기화하고 Mintegral SDK에 제대로 전달되는지 확인합니다.
자바
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)
Mintegral의 개인 정보 보호 문서를 참조하세요. 를 참조하세요.
미국 주 개인 정보 보호법
미국 주 개인 정보 보호법 사용자는 '할인' 기능을 '개인 정보' (법에서 'Do Not Sell My Personal(내 개인 판매 거부)' 문구 Information' '판매' 링크를 클릭하면 확인할 수 있습니다. 이 미국 주 개인 정보 보호 법률 준수 가이드를 사용하면 제한적인 데이터 처리 각 광고에 이 설정을 적용할 수는 없습니다. 네트워크를 설정할 수 있습니다 따라서 각 광고 네트워크를 개인 정보 보호 판매에 참여할 수 있는 미디에이션 체인에 해당 네트워크의 가이드라인을 준수하여 규정 준수를 지원합니다
Mintegral SDK에는 동의를 전달하는 setDoNotTrackStatus
메서드가 포함되어 있습니다.
Mintegral SDK에 정보를 보냅니다.
다음 샘플 코드는 동의 정보를 Mintegral에 전달하는 방법을 보여줍니다. 사용할 수 있습니다. 이 메서드를 호출해야 하면 호출합니다. 이후 </ph> Google 모바일 광고 SDK 초기화 Google 모바일 광고 SDK를 통해 광고를 요청하기 전에 해야 합니다
자바
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)
Mintegral의 개인 정보 보호 문서를 참조하세요. 를 참조하세요.
5단계: 필수 코드 추가하기
Mintegral 통합에는 추가 코드가 필요하지 않습니다.
6단계: 구현 테스트
테스트 광고 사용 설정
Ad Manager
배너, 전면 광고, 보상형 광고, 네이티브 광고 형식용 Mintegral 테스트 광고를 가져오려면 Mintegral 테스트 ID 페이지에 제공된 앱 키, 앱 ID, 게재위치 ID, 광고 단위 ID를 사용하는 것이 좋습니다.
테스트 광고 확인
Mintegral에서 테스트 광고를 수신하고 있는지 확인하려면 광고 검사기에서 Mintegral (Bidding) and Mintegral (Waterfall) 광고 소스를 사용하여 단일 광고 소스 테스트를 사용 설정하세요.
선택 단계
CCPA 광고 파트너 목록에 Mintegral 추가
다음의 단계를 따르세요. CCPA 설정 를 클릭하여 CCPA 광고 파트너 목록에 Mintegral을 추가합니다. Ad Manager UI
네이티브 광고
광고 렌더링
Mintegral 어댑터는 네이티브 광고를
NativeAd
<ph type="x-smartling-placeholder">
객체입니다. 이는 다음을 채웁니다.
필드
NativeAd
를 탭합니다.
필드 | 애셋은 항상 Mintegral 어댑터에 의해 포함됨 |
---|---|
광고 제목 | |
이미지 | 1 |
본문 | |
아이콘 | |
클릭 유도 문구 | |
별표 평점 | |
스토어 | |
가격 | |
광고주 |
1 Mintegral 어댑터는
네이티브 광고의 기본 이미지 애셋에 직접 액세스할 수 있어야 합니다. 대신
어댑터는
MediaView
동영상 또는 이미지로
검색할 수 있습니다
오류 코드
어댑터가 Mintegral에서 광고를 수신하지 못하면
광고 응답의 근본적인 오류를
ResponseInfo.getAdapterResponses()
다음 클래스에 포함됩니다.
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
다음은 Mintegral 어댑터에서 발생하는 코드와 관련 메시지입니다. 광고가 로드되지 못할 때:
오류 코드 | 도메인 | 이유 |
---|---|---|
101 | com.google.ads.mediation.mintegral | 서버 매개변수가 잘못되었습니다 (예: 앱 ID 또는 게재위치 ID 누락). |
102 | com.google.ads.mediation.mintegral | 요청된 광고 크기가 Mintegral 지원 배너 크기와 일치하지 않습니다. |
103 | com.google.ads.mediation.mintegral | 입찰 응답이 없거나 잘못되었습니다. |
104 | com.google.ads.mediation.mintegral | Mintegral SDK에서 '게재 불가' 오류를 반환했습니다. |
Mintegral Android 미디에이션 어댑터 변경 로그
버전 16.8.11.0
- Mintegral SDK 16.8.11과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.2.0.
- Mintegral SDK 버전 16.8.11.
버전 16.7.91.0
- Mintegral SDK 16.7.91과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.2.0.
- Mintegral SDK 버전 16.7.91.
버전 16.7.81.0
- Mintegral SDK 16.7.81과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.2.0.
- Mintegral SDK 버전 16.7.81.
버전 16.7.71.0
- Mintegral SDK 16.7.71과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.1.0.
- Mintegral SDK 버전 16.7.71.
버전 16.7.61.0
- Mintegral SDK 16.7.61과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.1.0.
- Mintegral SDK 버전 16.7.61.
버전 16.7.51.0
- Mintegral SDK 16.7.51과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.1.0.
- Mintegral SDK 버전 16.7.51.
버전 16.7.41.0
- Mintegral SDK 16.7.41과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.1.0.
- Mintegral SDK 버전 16.7.41.
버전 16.7.31.0
- Mintegral SDK 16.7.31과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.1.0.
- Mintegral SDK 버전 16.7.31.
버전 16.7.21.0
- Mintegral SDK 16.7.21과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.0.0.
- Mintegral SDK 버전 16.7.21.
버전 16.7.11.0
- Mintegral SDK 16.7.11과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.0.0.
- Mintegral SDK 버전 16.7.11.
버전 16.6.71.0
- Mintegral SDK 16.6.71과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.0.0.
- Mintegral SDK 버전 16.6.71.
버전 16.6.61.0
- 필요한 최소 Google 모바일 광고 SDK 버전이 23.0.0으로 업데이트되었습니다.
- Mintegral SDK 16.6.61과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.0.0.
- Mintegral SDK 버전 16.6.61.
버전 16.6.51.0
- Mintegral SDK 16.6.51과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.6.0.
- Mintegral SDK 버전 16.6.51.
버전 16.6.41.0
- Mintegral SDK 16.6.41과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.6.0.
- Mintegral SDK 버전 16.6.41.
버전 16.6.34.0
- Mintegral SDK 16.6.34와의 호환성 확인됨
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.6.0.
- Mintegral SDK 버전 16.6.34
버전 16.6.21.0
- Mintegral SDK 16.6.21과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.6.0.
- Mintegral SDK 버전 16.6.21.
버전 16.5.91.1
- 앱 오프닝 광고 형식에 대한 입찰 지원이 추가되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.6.0.
- Mintegral SDK 버전 16.5.91.
버전 16.5.91.0
- Mintegral SDK 16.5.91과의 호환성 확인
- 필요한 최소 Google 모바일 광고 SDK 버전이 22.6.0으로 업데이트되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.6.0.
- Mintegral SDK 버전 16.5.91.
버전 16.5.51.0
- Mintegral SDK 16.5.51과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.3.0.
- Mintegral SDK 버전 16.5.51.
버전 16.5.41.0
- Mintegral SDK 16.5.41과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.3.0.
- Mintegral SDK 버전 16.5.41.
버전 16.5.31.0
- Mintegral SDK 16.5.31과의 호환성 확인
- 어댑터가 Google 모바일 광고 SDK 버전 22.3.0에 종속되도록 되돌렸습니다.
- 앱 오프닝 광고 형식에 대한 폭포식 구조 지원이 추가되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.3.0.
- Mintegral SDK 버전 16.5.31
버전 16.5.21.0
- Mintegral SDK 16.5.21과의 호환성 확인
- 필요한 최소 Google 모바일 광고 SDK 버전이 22.4.0으로 업데이트되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.4.0.
- Mintegral SDK 버전 16.5.21.
버전 16.5.11.0
- 입찰 광고에 워터마크 지원이 추가되었습니다.
- Mintegral SDK 16.5.11과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.2.0.
- Mintegral SDK 버전 16.5.11.
버전 16.4.91.0
- Mintegral SDK 16.4.91과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.2.0.
- Mintegral SDK 버전 16.4.91.
버전 16.4.81.0
- Mintegral SDK 16.4.81과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.2.0.
- Mintegral SDK 버전 16.4.81.
버전 16.4.71.0
- Mintegral SDK 16.4.71과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.2.0.
- Mintegral SDK 버전 16.4.71.
버전 16.4.61.0
- Mintegral SDK 16.4.61과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.1.0.
- Mintegral SDK 버전 16.4.61.
버전 16.4.51.0
- Mintegral SDK 16.4.51과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.1.0.
- Mintegral SDK 버전 16.4.51.
버전 16.4.41.0
- 배너 광고가 잘못된 크기로 렌더링되는 문제가 해결되었습니다.
- Mintegral SDK 16.4.41과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.0.0.
- Mintegral SDK 버전 16.4.41.
버전 16.4.31.0
- Mintegral SDK 16.4.31과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.0.0.
- Mintegral SDK 버전 16.4.31.
버전 16.4.21.0
- 새
VersionInfo
클래스를 사용하도록 어댑터를 업데이트했습니다. - 필요한 최소 Google 모바일 광고 SDK 버전이 22.0.0으로 업데이트되었습니다.
- Mintegral SDK 16.4.21과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 22.0.0.
- Mintegral SDK 버전 16.4.21.
버전 16.3.91.0
- Mintegral SDK 16.3.91과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 21.5.0.
- Mintegral SDK 버전 16.3.91.
버전 16.3.81.0
- Mintegral SDK 16.3.81과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 21.5.0.
- Mintegral SDK 버전 16.3.81.
버전 16.3.71.0
- Mintegral SDK 16.3.71과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 21.5.0.
- Mintegral SDK 버전 16.3.71.
버전 16.3.61.0
- Mintegral SDK 16.3.61과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 21.5.0.
- Mintegral SDK 버전 16.3.61.
버전 16.3.51.1
- 배너 (MREC 포함), 전면 광고, 보상형 광고, 네이티브 광고 형식에 대한 폭포식 구조 지원이 추가되었습니다.
- 필요한 최소 Google 모바일 광고 SDK 버전이 21.5.0으로 업데이트되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 21.5.0.
- Mintegral SDK 버전 16.3.51.
버전 16.3.51.0
- Mintegral SDK 16.3.51과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 21.4.0.
- Mintegral SDK 버전 16.3.51.
버전 16.3.41.0
- Mintegral SDK 16.3.41과의 호환성 확인
- 필요한 최소 Google 모바일 광고 SDK 버전이 21.4.0으로 업데이트되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 21.4.0.
- Mintegral SDK 버전 16.3.41.
버전 16.3.11.0
- Mintegral SDK 16.3.11과의 호환성 확인
- 보상형 광고를 표시할 때
onAdClosed()
전에onUserEarnedReward()
을 전달하도록 어댑터가 업데이트되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 21.3.0.
- Mintegral SDK 버전 16.3.11.
버전 16.2.61.0
- 첫 출시
- 배너 (MREC 포함), 전면 광고, 보상형 광고, 네이티브 광고 형식에 대한 입찰 지원이 추가되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 21.3.0.
- Mintegral SDK 버전 16.2.61.