Bu kılavuzda, Google Mobile Ads SDK'sını kullanarak uyumlulaştırma, Hem şelale hem de teklif entegrasyonlarını kapsar. Şunları kapsar: Bir reklam biriminin uyumlulaştırma yapılandırmasına Mintegral ekleme ve Mintegral SDK ve bağdaştırıcısını Android uygulamasını kullanın.
Desteklenen entegrasyonlar ve reklam biçimleri
Mintegral için uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:
Entegrasyon | |
---|---|
Teklif verme | 1 |
Şelale | 2 |
Formatlar | |
Uygulama Açma | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Ödüllü geçiş reklamı | |
Yerel biçim |
2 Şelale entegrasyonu kullanımda kapalı beta sürümü.
Şartlar
- Android API düzeyi 21 veya üstü
En son Google Mobile Ads SDK'sı
Arabuluculuğu tamamlama Başlangıç kılavuzu
1. Adım: Mintegral kullanıcı arayüzünde yapılandırmaları ayarlayın
2. Adım: Kullanıcı arayüzünde Mintegral talebini Ad Manager ayarlayın
GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Mintegral ekleyin
3. Adım: Mintegral SDK'sını ve bağdaştırıcıyı içe aktarın
Android Studio entegrasyonu (önerilir)
Proje düzeyindeki settings.gradle.kts
dosyanıza aşağıdakini ekleyin:
depolar:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
}
}
}
Ardından, uygulama düzeyindeki build.gradle.kts
dosyanıza aşağıdakileri ekleyin:
ve yapılandırmalarına değineceğiz. Chrome Web Mağazası'ndaki
Mintegral SDK ve bağdaştırıcısı:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:mintegral:16.8.31.0")
}
Manuel entegrasyon
Mintegral SDK'sını dahil etmek üzere Android için Mintegral SDK'ya gidin.
Şuraya gidin: Mintegral bağdaştırıcı yapıları Google'ın Maven deposunda. En son sürümü seçin ve Mintegral'ı indirin. bağdaştırıcının
.aar
dosyasını seçin ve bu dosyayı projenize ekleyin.
4. adım: Gizlilik ayarlarını Mintegral SDK'da uygulayın
AB kullanıcı rızası ve GDPR
Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.
Mintegral SDK'sı, izin iletmek için setConsentStatus
yöntemini içerir
Mintegral SDK'ya yükleyin.
Aşağıdaki örnek kodda, izin bilgilerinin Mintegral'a nasıl iletileceği gösterilmektedir SDK'dır. Bu seçenekleri ayarlamadan önce yapmanız gerekir Google Mobile Ads SDK'sını başlatma .
Java
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'ın gizlilik dokümanlarını inceleyin konulu videomuzu izleyin.
ABD eyalet gizlilik yasaları
ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.
Mintegral SDK'sı, izin iletmek için setDoNotTrackStatus
yöntemi içerir
Mintegral SDK'ya yükleyin.
Aşağıdaki örnek kodda, izin bilgilerinin Mintegral'a nasıl iletileceği gösterilmektedir SDK'dır. Bu yöntemi çağırmanız gerekiyorsa . sonrasında Google Mobile Ads SDK'sını başlatma ancak Google Mobile Ads SDK'sı üzerinden reklam isteğinde bulunmadan önce kullanabilirsiniz.
Java
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'ın gizlilik dokümanlarını inceleyin konulu videomuzu izleyin.
5. Adım: Gerekli kodu ekleyin
Mintegral entegrasyonu için ek kod gerekmez.
6. Adım: Uygulamanızı test edin
Test reklamlarını etkinleştir
Ad Manager.
Mintegral; banner'lar, geçiş reklamları, ödüllü ve yerel reklam biçimlerinde Mintegral test reklamları almak için Mintegral Test Kimliği sayfasında verilen Uygulama Anahtarları, Uygulama Kimlikleri, Yerleşim Kimlikleri ve Reklam Birimi Kimliklerini kullanmanızı önerir.
Test reklamlarını doğrulama
Mintegralreklam kaynağından test reklamları aldığınızı doğrulamak için Mintegral (Bidding) and Mintegral (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
İsteğe bağlı adımlar
CCPA reklam iş ortakları listesine Mintegral'ı ekleyin
Şuradaki adımları uygulayın: CCPA ayarları Mintegral'ı CCPA reklam iş ortakları listesine eklemek için Ad Manager Kullanıcı arayüzü.
Yerel reklamlar
Reklam oluşturma
Mintegral bağdaştırıcısı, doğal reklamlarını
.
NativeAd
nesneler'i tıklayın. Aşağıdakileri doldurur
alanlar
-
NativeAd
.
Alan | Öğeler her zaman Mintegral adaptörü tarafından dahil edilir |
---|---|
Başlık | |
Resim | 1 |
Metin | |
Simge | |
Harekete geçirici mesaj | |
Yıldızlı değerlendirme | |
Depolama | |
Fiyat | |
Reklamveren |
1 Mintegral bağdaştırıcısı
yerel reklamları için ana resim öğesine doğrudan erişim sağlar. Bunun yerine
adaptör tarafından
.
MediaView
bunu kolayca yapabilirsiniz.
Hata kodları
Bağdaştırıcı Mintegral'dan reklam alamazsa
kullanarak reklam yanıtından gelen temel hata
.
ResponseInfo.getAdapterResponses()
şu sınıflarda:
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
.
Mintegral bağdaştırıcısı tarafından gönderilen kodlar ve beraberindeki iletiler aşağıda verilmiştir Reklam yüklenemedi:
Hata kodu | Alan | Neden |
---|---|---|
101 | com.google.ads.mediation.mintegral | Geçersiz sunucu parametreleri (ör. eksik uygulama kimliği veya yerleşim kimliği). |
102 | com.google.ads.mediation.mintegral | İstenen reklam boyutu, Mintegral tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
103 | com.google.ads.mediation.mintegral | Eksik veya geçersiz teklif yanıtı. |
104 | com.google.ads.mediation.mintegral | Mintegral SDK'sı, dolgu yok hatası döndürdü. |
Mintegral Android Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü
Sürüm 16.8.31.0
- Mintegral SDK 16.8.31 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.2.0.
- Mintegral SDK'sı 16.8.31 sürümü.
Sürüm 16.8.11.0
- Mintegral SDK 16.8.11 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.2.0.
- Mintegral SDK 16.8.11 sürümü
Sürüm 16.7.91.0
- Mintegral SDK 16.7.91 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.2.0.
- Mintegral SDK'sı 16.7.91 sürümü.
Sürüm 16.7.81.0
- Mintegral SDK 16.7.81 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.2.0.
- Mintegral SDK'sı 16.7.81 sürümü.
Sürüm 16.7.71.0
- Mintegral SDK 16.7.71 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.1.0.
- Mintegral SDK'sı 16.7.71 sürümü.
Sürüm 16.7.61.0
- Mintegral SDK 16.7.61 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.1.0.
- Mintegral SDK'sı 16.7.61 sürümü.
Sürüm 16.7.51.0
- Mintegral SDK 16.7.51 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.1.0.
- Mintegral SDK'sı 16.7.51 sürümü.
Sürüm 16.7.41.0
- Mintegral SDK 16.7.41 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.1.0.
- Mintegral SDK'sı 16.7.41 sürümü.
Sürüm 16.7.31.0
- Mintegral SDK 16.7.31 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.1.0.
- Mintegral SDK'sı 16.7.31 sürümü.
Sürüm 16.7.21.0
- Mintegral SDK 16.7.21 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.0.0.
- Mintegral SDK'sı 16.7.21 sürümü.
Sürüm 16.7.11.0
- Mintegral SDK 16.7.11 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.0.0.
- Mintegral SDK 16.7.11 sürümü
Sürüm 16.6.71.0
- Mintegral SDK 16.6.71 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.0.0.
- Mintegral SDK'sı 16.6.71 sürümü.
Sürüm 16.6.61.0
- Gereken minimum Google Mobile Ads SDK'sı sürümü 23.0.0 olarak güncellendi.
- Mintegral SDK 16.6.61 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.0.0.
- Mintegral SDK 16.6.61 sürümü
Sürüm 16.6.51.0
- Mintegral SDK 16.6.51 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.6.0.
- Mintegral SDK 16.6.51 sürümü
Sürüm 16.6.41.0
- Mintegral SDK 16.6.41 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.6.0.
- Mintegral SDK 16.6.41 sürümü
Sürüm 16.6.34.0
- Mintegral SDK 16.6.34 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.6.0.
- Mintegral SDK 16.6.34 sürümü
Sürüm 16.6.21.0
- Mintegral SDK 16.6.21 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.6.0.
- Mintegral SDK'sı 16.6.21 sürümü.
Sürüm 16.5.91.1
- Uygulama açılış reklamı biçimi için teklifli sistem desteği eklendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.6.0.
- Mintegral SDK'sı 16.5.91 sürümü.
Sürüm 16.5.91.0
- Mintegral SDK 16.5.91 ile uyumluluk doğrulandı.
- Gereken minimum Google Mobile Ads SDK'sı sürümü 22.6.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.6.0.
- Mintegral SDK'sı 16.5.91 sürümü.
Sürüm 16.5.51.0
- Mintegral SDK 16.5.51 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.3.0.
- Mintegral SDK 16.5.51 sürümü
Sürüm 16.5.41.0
- Mintegral SDK 16.5.41 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.3.0.
- Mintegral SDK 16.5.41 sürümü
Sürüm 16.5.31.0
- Mintegral SDK 16.5.31 ile uyumluluk doğrulandı.
- Bağdaştırıcıyı, Google Mobile Ads SDK'sı 22.3.0 sürümüne bağlı olacak şekilde geri döndürdü.
- Uygulama açılış reklamı biçimi için şelale desteği eklendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.3.0.
- Mintegral SDK 16.5.31 sürümü
Sürüm 16.5.21.0
- Mintegral SDK 16.5.21 ile uyumluluk doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 22.4.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.4.0.
- Mintegral SDK'sı 16.5.21 sürümü.
Sürüm 16.5.11.0
- Teklifli sistem reklamları için filigran desteği eklendi.
- Mintegral SDK 16.5.11 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.2.0.
- Mintegral SDK 16.5.11 sürümü
Sürüm 16.4.91.0
- Mintegral SDK 16.4.91 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.2.0.
- Mintegral SDK 16.4.91 sürümü
Sürüm 16.4.81.0
- Mintegral SDK 16.4.81 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.2.0.
- Mintegral SDK 16.4.81 sürümü
Sürüm 16.4.71.0
- Mintegral SDK 16.4.71 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.2.0.
- Mintegral SDK 16.4.71 sürümü
Sürüm 16.4.61.0
- Mintegral SDK 16.4.61 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.1.0.
- Mintegral SDK 16.4.61 sürümü
Sürüm 16.4.51.0
- Mintegral SDK 16.4.51 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.1.0.
- Mintegral SDK 16.4.51 sürümü
Sürüm 16.4.41.0
- Banner reklamların yanlış boyutlarla oluşturulmasına neden olan sorun düzeltildi.
- Mintegral SDK 16.4.41 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.0.0.
- Mintegral SDK 16.4.41 sürümü
Sürüm 16.4.31.0
- Mintegral SDK 16.4.31 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.0.0.
- Mintegral SDK 16.4.31 sürümü
Sürüm 16.4.21.0
- Bağdaştırıcı, yeni
VersionInfo
sınıfını kullanacak şekilde güncellendi. - Google Mobile Ads SDK'sı için gereken minimum sürüm 22.0.0 olarak güncellendi.
- Mintegral SDK 16.4.21 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.0.0.
- Mintegral SDK 16.4.21 sürümü
Sürüm 16.3.91.0
- Mintegral SDK 16.3.91 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.5.0.
- Mintegral SDK'sı 16.3.91 sürümü.
Sürüm 16.3.81.0
- Mintegral SDK 16.3.81 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.5.0.
- Mintegral SDK'sı 16.3.81 sürümü.
Sürüm 16.3.71.0
- Mintegral SDK 16.3.71 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.5.0.
- Mintegral SDK'sı 16.3.71 sürümü.
Sürüm 16.3.61.0
- Mintegral SDK 16.3.61 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.5.0.
- Mintegral SDK 16.3.61 sürümü
Sürüm 16.3.51.1
- Banner (MREC dahil), geçiş reklamı, ödüllü ve doğal reklam biçimleri için şelale desteği eklendi.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 21.5.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.5.0.
- Mintegral SDK 16.3.51 sürümü
Sürüm 16.3.51.0
- Mintegral SDK 16.3.51 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.4.0.
- Mintegral SDK 16.3.51 sürümü
Sürüm 16.3.41.0
- Mintegral SDK 16.3.41 ile uyumluluk doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 21.4.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.4.0.
- Mintegral SDK'sı 16.3.41 sürümü.
Sürüm 16.3.11.0
- Mintegral SDK 16.3.11 ile uyumluluk doğrulandı.
- Ödüllü reklamlar gösterirken adaptör,
onAdClosed()
tarihinden önceonUserEarnedReward()
öğesini yönlendirecek şekilde güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.3.0.
- Mintegral SDK 16.3.11 sürümü
Sürüm 16.2.61.0
- İlk sürüm!
- Banner (MREC dahil), geçiş reklamı, ödüllü ve yerel reklam biçimleri için teklif verme desteği eklendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.3.0.
- Mintegral SDK 16.2.61 sürümü