Bu sayfa, Cloud Translation API ile çevrilmiştir.

Mintegral'ı uyumlulaştırma ile entegre etme

Bu kılavuzda, hem şelale hem de teklif entegrasyonlarını kapsayan AdMob Uyumlulaştırma'yı kullanarak Mintegral'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, Mintegral'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Mintegral SDK'sının ve bağdaştırıcının bir Android uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Mintegral için uyumlulaştırıcı bağdaştırıcının özellikleri şunlardır:

Entegrasyon
Teklif verme
Şelale
Formatlar
Uygulama Açma	¹
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
Yerel biçim	²

¹ Uygulama açılış reklamı biçimi için teklifli sistem ve şelale entegrasyonları kapalı beta sürümündedir.

² Yerel reklam biçimi için teklifli sistem ve şelale entegrasyonları açık beta sürümündedir.

Şartlar

Android API düzeyi 21 veya sonraki sürümler
[Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek amacıyla 16.5.91.1 veya daha yeni bir Mintegral bağdaştırıcısı kullanın (en son sürüm önerilir).

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlama Başlangıç kılavuzu

1. adım: Mintegral kullanıcı arayüzünde yapılandırmaları ayarlayın

Mintegral hesabınıza kaydolun veya oturum açın.

Uygulama anahtarını bulma

UYGULAMA Ayarı sekmesine gidin ve UYGULAMA Anahtarı'nı not edin.

Yeni uygulama ekleme

UYGULAMA Ayarı sekmesinde UYGULAMA Ekle düğmesini tıklayın.

Platform'u seçin ve formun geri kalanını doldurun. Ardından Kaydet'i tıklayın.

Uygulamanızın UYGULAMASINI KİMLİĞİNİ not edin.

Reklam yerleşimi oluşturma

Uygulamanız oluşturulduktan sonra Yerleşimler ve Birimler sekmesine gidin ve reklam yerleşiminizi oluşturmak için aşağıda gösterildiği gibi Yerleşim Ekle düğmesini tıklayın.

Bir yerleşim adı ve reklam biçimi girin.

Teklif verme

Teklifli Sistem Türü olarak Başlıktan Teklif Alma'yı seçin. Formun geri kalanını doldurup Kaydet'i tıklayın.

Şelale

Teklifli Sistem Türü olarak Geleneksel'i seçin. Formun geri kalanını doldurup Kaydet'i tıklayın.

Reklam yerleşiminiz oluşturulduktan sonra yerleşim kimliğini not edin.

1 Reklam Birimi açılır menüsünü tıklayın ve Reklam Birimi Kimliği'ni not edin.

Mintegral Reporting API anahtarınızı bulma

Teklif verme

Bu adım, teklifli sistem entegrasyonları için gerekli değildir.

Şelale

AdMob reklam birimi kimliğinizi ayarlamak için Mintegral Reporting API anahtarınız gerekir. Hesap > API Araçları'na gidin. Skey ve Secret değerlerini not edin.

2. adım: AdMob kullanıcı arayüzünde Mintegral talebini ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

Reklam biriminizin uyumlulaştırma yapılandırmasına Mintegral'ı eklemeniz gerekir.

Öncelikle AdMob hesabınızda oturum açın. Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa düzenlemek için ilgili uyumlulaştırma grubunun adını tıklayın ve Mintegral'ı reklam kaynağı olarak ekleme bölümüne geçin.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.

Reklam biçiminizi ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın ve Reklam Birimi Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizden bir veya daha fazlasıyla ilişkilendirin. Ardından Bitti'yi tıklayın.

Artık reklam birimleri kartının, seçtiğiniz reklam birimleriyle doldurulduğunu göreceksiniz:

Mintegral'ı reklam kaynağı olarak ekleme

Teklif verme

Reklam Kaynakları bölümündeki Teklifli Sistem kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından Mintegral'i seçin.
İş ortaklığı sözleşmesi imzalama'yı tıklayın ve Mintegral ile teklifli sistem iş ortaklığı kurun.

Kabul ediyorum'u, ardından Devam'ı tıklayın.

Mintegral için zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde elde edilen uygulama anahtarını, uygulama kimliğini, yerleşim kimliğini ve reklam birimi kimliğini girin. Ardından Bitti'yi tıklayın.

Şelale

Reklam Kaynakları bölümündeki Şelale kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından Mintegral'i seçin.

Mintegral'i seçin. Ardından Mintegral için bir eBGBM değeri girin ve Devam'ı tıklayın.

Mintegral için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde elde edilen uygulama anahtarını, uygulama kimliğini, yerleşim kimliğini ve reklam birimi kimliğini girin. Ardından Bitti'yi tıklayın.

Mobvista/Mintegral'ı GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

Mobvista/Mintegral'ı AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki adımları uygulayın.

3. Adım: Mintegral SDK'sını ve bağdaştırıcısını içe aktarın

Android Studio entegrasyonu (önerilen)

Proje düzeyindeki settings.gradle.kts dosyanıza aşağıdaki depoları ekleyin:

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ğıdaki uygulama bağımlılıkları ve yapılandırmaları ekleyin. Mintegral SDK'sının ve bağdaştırıcının en son sürümlerini kullanın:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:mintegral:16.8.61.0")
}

Manuel entegrasyon

Mintegral SDK'sını dahil etmek için Android için Mintegral SDK'sı başlıklı makaleyi inceleyin.
Google'ın Maven deposunda Mintegral bağdaştırıcısı yapılarına gidin. En son sürümü seçin, Mintegral bağdaştırıcının .aar dosyasını indirin ve projenize ekleyin.

4. Adım: Mintegral SDK'sında gizlilik ayarlarını uygulayın

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.

Mintegral SDK'sı, izin bilgilerini Mintegral SDK'sına iletmek için setConsentStatus yöntemini içerir.

Aşağıdaki örnek kodda, izin bilgilerinin Mintegral SDK'sına nasıl iletileceği gösterilmektedir. Bu seçeneklerin Mintegral SDK'sına doğru şekilde yönlendirilmesini sağlamak için Google Mobile Ads SDK'sını başlatmadan önce ayarlanması gerekir.

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)

Daha fazla bilgi için Mintegral'in gizlilik belgelerine bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, kişisel bilgilerinin "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılıyor. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. ABD eyalet gizlilik yasaları uygunluk kılavuzu, Google reklam sunumu için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar ancak Google bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Mintegral SDK'sı, izin bilgilerini Mintegral SDK'sına iletmek için setDoNotTrackStatus yöntemini içerir.

Aşağıdaki örnek kodda, izin bilgilerinin Mintegral SDK'sına nasıl iletileceği gösterilmektedir. Bu yöntemi çağırmanız gerekirse Google Mobile Ads SDK'sını ilk kullanıma hazırladıktan ancak Google Mobile Ads SDK'sı üzerinden reklam istemeden önce çağırın.

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)

Daha fazla bilgi için Mintegral'in gizlilik belgelerine bakın.

5. adım: Gerekli kodu ekleyin

Mintegral entegrasyonu için ek kod gerekmez.

6. adım: Uygulamanızı test edin

Test reklamlarını etkinleştirme

AdMob için test cihazınızı kaydettiğinizden emin olun.

Banner, geçiş reklamı, ödüllü ve yerel reklam biçimleri için Mintegral test reklamları almak amacıyla Mintegral, Mintegral Test Kimliği sayfasında sağlanan uygulama anahtarlarını, uygulama kimliklerini, yerleşim kimliklerini ve reklam birimi kimliklerini kullanmanızı önerir.

Test reklamlarını doğrulama

Mintegral'den test reklamları aldığınızı doğrulamak için Mintegral (Teklif Verme) ve Mintegral (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Mintegral'i CCPA reklam iş ortakları listesine ekleme

Mintegral'ı AdMob kullanıcı arayüzündeki CCPA reklam iş ortakları listesine eklemek için CCPA ayarlarındaki adımları uygulayın.

Yerel reklamlar

Reklam oluşturma

Mintegral bağdaştırıcısı, yerel reklamlarını NativeAd nesneler olarak döndürür. NativeAd için aşağıdaki alanlar doldurulur.

Alan	Mintegral adaptörü tarafından her zaman dahil edilen öğeler
Başlık
Resim	1
Metin
Simge
Harekete geçirici mesaj
Yıldızlı değerlendirme
Depolama
Fiyat
Reklamveren

¹ Mintegral bağdaştırıcısı, yerel reklamları için ana resim öğesine doğrudan erişim sağlamaz. Bunun yerine, adaptör MediaView alanına bir video veya resim doldurur.

Hata kodları

Bağdaştırıcının Mintegral'den reklam almaması durumunda, aşağıdaki sınıflar altında ResponseInfo.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

Bir reklam yüklenemezse Mintegral bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

Hata kodu	Alan	Neden
101	com.google.ads.mediation.mintegral	Geçersiz sunucu parametreleri (ör. uygulama kimliği veya yerleşim kimliği eksik).
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	Teklif yanıtı eksik veya geçersiz.
104	com.google.ads.mediation.mintegral	Mintegral SDK'sı doldurma yok hatası döndürmüştür.

Mintegral Android Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü