이 가이드에서는 Google 모바일 광고 SDK를 사용하여 광고를 로드하고 게재하는 방법을 설명합니다. 을(를) 사용하여 Mintegral의 디스플레이 광고 AdMob 미디에이션 폭포식 구조 및 입찰 통합을 모두 다룹니다. 다음을 포함합니다. 광고 단위의 미디에이션 구성에 Mintegral을 추가하는 방법 및 Mintegral SDK와 어댑터를 Android 앱.
지원되는 통합 및 광고 형식
Mintegral용 미디에이션 어댑터의 기능은 다음과 같습니다.
통합 | |
---|---|
입찰 | |
폭포 | |
형식 | |
앱 열기 | 를 탭합니다. <ph type="x-smartling-placeholder"> </ph> 1 |
배너 | |
전면 광고 | |
리워드 제공됨 | |
보상형 전면 광고 | |
네이티브 | 를 탭합니다. <ph type="x-smartling-placeholder"> </ph> 2 |
2 입찰 및 폭포식 구조 네이티브 광고 형식 통합은 오픈 베타 버전입니다.
요구사항
- Android API 수준 21 이상
최신 Google 모바일 광고 SDK
중재 완료 시작 가이드
1단계: Mintegral UI에서 구성 설정
앱 키 찾기
앱 설정 탭으로 이동하여 앱 키를 기록해 둡니다.
새 애플리케이션 추가
앱 설정 탭에서 앱 추가 버튼을 클릭합니다.
Platform을 선택하고 양식의 나머지 부분을 작성합니다. 그런 다음 저장을 클릭합니다.
![](https://google-developers.gonglchuangl.net/admob/images/mediation/mintegral/new_application_Android.png?authuser=0&hl=ko)
애플리케이션의 앱 ID를 기록해 둡니다.
![](https://google-developers.gonglchuangl.net/admob/images/mediation/mintegral/app_id_Android.png?authuser=0&hl=ko)
광고 게재위치 만들기
애플리케이션이 생성되면 게재위치 및 단위 탭으로 이동하고 아래와 같이 게재위치 추가 버튼을 클릭하여 광고 게재위치를 만듭니다.
![](https://google-developers.gonglchuangl.net/admob/images/mediation/mintegral/create_placement_Android.png?authuser=0&hl=ko)
게재위치 이름 및 광고 형식을 입력합니다.
입찰
입찰 유형으로 헤더 입찰을 선택합니다. 양식의 나머지 부분을 작성하고 저장을 클릭합니다.
폭포
입찰 유형으로 기존을 선택합니다. 양식의 나머지 부분을 작성하고 저장을 클릭합니다.
광고 게재위치가 생성되면 게재위치 ID를 기록해 둡니다.
![](https://google-developers.gonglchuangl.net/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=0&hl=ko)
광고 단위 1개 드롭다운을 클릭하고 광고 단위 ID를 기록해 둡니다.
![](https://google-developers.gonglchuangl.net/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=0&hl=ko)
Mintegral Reporting API 키 찾기
입찰
이 단계는 입찰 통합에는 필요하지 않습니다.
폭포
AdMob 광고 단위 ID를 설정하려면 Mintegral Reporting API 키가 필요합니다. 계정 > API 도구로 이동합니다. Skey 및 Secret을 기록해 둡니다.
2단계: UI에서 AdMob Mintegral 수요 설정
광고 단위에 대한 미디에이션 설정 구성
Mintegral 를 광고 단위의 미디에이션 구성에 추가해야 합니다.
먼저 AdMob 계정에 로그인합니다. 그런 다음 미디에이션 탭으로 이동합니다. 수정할 기존 미디에이션 그룹이 있는 경우 해당 미디에이션 그룹의 이름을 클릭하여 수정한 후 Mintegral 광고 소스로 추가로 건너뜁니다.
새 미디에이션 그룹을 만들려면 미디에이션 그룹 만들기를 선택합니다.
광고 형식과 플랫폼을 입력하고 계속을 클릭합니다.
미디에이션 그룹에 이름을 지정하고 타겟팅할 위치를 선택합니다. 미디에이션 그룹 상태를 사용으로 설정한 다음 광고 단위 추가를 클릭합니다.
이 미디에이션 그룹을 하나 이상의 기존AdMob 광고 단위와 연결합니다. 그런 다음 완료를 클릭합니다.
이제 광고 단위 카드가 선택한 광고 단위로 채워진 것을 볼 수 있습니다.
광고 소스로 Mintegral 추가
입찰
광고 소스 섹션의 입찰 카드에서 광고 소스 추가를 선택합니다. 그런 다음 Mintegral을 선택합니다.
파트너십 계약을 체결하는 방법을 클릭하고Mintegral과(와) 입찰 파트너십을 설정합니다.
확인 및 동의를 클릭한 다음 계속을 클릭합니다.
이미 Mintegral에 대한 매핑이 있는 경우 해당 매핑을 선택할 수 있습니다. 그렇지 않으면 매핑 추가를 클릭합니다.
그런 다음 이전 섹션에서 얻은 App Key, App ID, Placement ID, and Ad Unit ID를 입력합니다. 그런 다음 완료를 클릭합니다.
중요: App ID and App Key 는Mintegral UI에서와 같이 타겟팅된 앱과 연결되어야 합니다.폭포
광고 소스 섹션의 폭포식 구조 카드에서 광고 소스 추가를 선택합니다. 그런 다음 Mintegral을 선택합니다.
Mintegral를 선택합니다. 그런 다음Mintegral 에 eCPM 값을 입력하고 계속을 클릭합니다.이미 Mintegral에 대한 매핑이 있는 경우 해당 매핑을 선택할 수 있습니다. 그렇지 않으면 매핑 추가를 클릭합니다.
그런 다음 이전 섹션에서 얻은 App Key, App ID, Placement ID, and Ad Unit ID를 입력합니다. 그런 다음 완료를 클릭합니다.
GDPR 및 미국 주 규정 광고 파트너 목록에 Mintegral 추가
GDPR 설정 및 미국 주 규정 설정 Mintegral 를 AdMob 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단계: 구현 테스트
테스트 광고 사용 설정
AdMob
배너, 전면 광고, 보상형 광고, 네이티브 광고 형식용 Mintegral 테스트 광고를 가져오려면 Mintegral 테스트 ID 페이지에 제공된 앱 키, 앱 ID, 게재위치 ID, 광고 단위 ID를 사용하는 것이 좋습니다.
테스트 광고 확인
Mintegral에서 테스트 광고를 수신하고 있는지 확인하려면 광고 검사기에서 Mintegral (Bidding) and Mintegral (Waterfall) 광고 소스를 사용하여 단일 광고 소스 테스트를 사용 설정하세요.
선택 단계
CCPA 광고 파트너 목록에 Mintegral 추가
다음의 단계를 따르세요. CCPA 설정 를 클릭하여 CCPA 광고 파트너 목록에 Mintegral을 추가합니다. AdMob 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.