이 가이드에서는 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에서 구성 설정
2단계: UI에서 Ad Manager Mintegral 수요 설정
GDPR 및 미국 주 규정 광고 파트너 목록에 Mintegral 추가
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.31.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.31.0
- Mintegral SDK 16.8.31과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 23.2.0.
- Mintegral SDK 버전 16.8.31.
버전 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.