Mintegral'ı uyumlulaştırma ile entegre etme

Bu kılavuzda, hem şelale hem de teklif entegrasyonlarını kapsayan arabuluculuk 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. Mintegral'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve Mintegral SDK'sının ve bağdaştırıcının bir uygulamaya nasıl entegre edileceğini kapsar. Unity

Desteklenen entegrasyonlar ve reklam biçimleri

Mintegral için AdMob uyumlulaştırıcı adaptör aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif verme
Şelale
Formatlar
Uygulama Açma	^1
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı

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

Şartlar

• En son Google Mobile Ads SDK'sı
  • Unity 5.6 veya üzeri
  • Android'de dağıtmak için
    • Android API düzeyi 21 veya sonraki sürümler
  • iOS'te dağıtmak için
    • 12.0 veya sonraki bir iOS dağıtım hedefi
  • Google Mobile Ads SDK'sı ile yapılandırılmış Unity çalışan bir proje. Ayrıntılar için Başlayın bölümüne bakın.
  • 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.

Yapay Zeka

iOS

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

Yapay Zeka

iOS

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.

Yapay Zeka

iOS

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

Önemli: Yerel reklam biçimi için Reklam Biçimi olarak Yerel (Özel Oluşturma)'yı seçin.

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.

Yapay Zeka

iOS

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

Yapay Zeka

iOS

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: Mintegral talebini AdMob kullanıcı arayüzünde ayarlayın

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

Yapay Zeka

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

Talimatlar için iOS kılavuzunun 2. adımına bakın.

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

Önemli: AB Rızası ve GDPR, CPRA ve Kullanıcı Mesajlaşma Platformu yapılandırmasını tamamlamak için Hesap Yönetimi izninizin olduğunu doğrulayın. Ayrıntılar için Kullanıcıların hesabınıza erişimini yönetme başlıklı makaleyi inceleyin.

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

Not: Uyumlu Mintegral ve Google Mobile Ads SDK sürümlerinin entegre edilmemesi derleme sorunlarına neden olabilir.

OpenUPM-CLI

Önemli: .unitypackage'den OpenUPM-CLI'ye geçiş yapıyorsanız Assets/GoogleMobileAds/Mediation/Mintegral klasöründeki tüm dosyaları silerek öğeleri eski konumdan manuel olarak kaldırmanız gerekir.

OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak Unity için Google Mobile Ads Mintegral Uyumlulaştırma Eklentisi'ni projenize yükleyebilirsiniz:

openupm add com.google.ads.mobile.mediation.mintegral

OpenUPM

Önemli: .unitypackage'den OpenUPM'e geçiş yapıyorsanız Assets/GoogleMobileAds/Mediation/Mintegral klasöründeki tüm dosyaları silerek öğeleri eski konumdan manuel olarak kaldırmanız gerekir.

Unity Paket Yöneticisi Ayarlarını açmak için Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçin.

Kapsamlı Kayıt Daireleri sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı bir kayıt dairesi olarak ekleyin:

• Ad: OpenUPM
• URL: https://package.openupm.com
• Kapsamlar: com.google

Ardından, Unity Paket Yöneticisi'ni açmak için pencere > Paket Yöneticisi'ne gidin ve açılır menüden Kayıt Dairelerim'i seçin.

Google Mobile Ads Mintegral Mediation paketini seçin ve Yükle'yi tıklayın.

Unity Paketi

Mintegral için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü değişiklik günlüğündeki indirme bağlantısından indirin ve GoogleMobileAdsMintegralMediation.unitypackage dosyasını zip dosyasından çıkarın.

Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsMintegralMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Ardından Öğeler > Harici Bağımlılık Yöneticisi > Android Çözücü > Çözümü Zorla'yı seçin. Harici Bağımlılık Yöneticisi kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

4. adım: Gerekli kodu ekleyin

Yapay Zeka

Mintegral entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Mintegral'in belgelerini inceleyin.

5. 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.

Önemli: Uygulamanızı yayınlamadan önce AdMob ve Mintegral için test modunu devre dışı bırakın.

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.

Hata kodları

Adaptör Mintegral'den reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Yapay Zeka

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

iOS

GADMediationAdapterMintegral

Bir reklam yüklenemezse Mintegral bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla birlikte gönderilen mesajlar şunlardır:

Yapay Zeka

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.

iOS

Hata kodu	Alan	Neden
101	com.google.mediation.mintegral	Geçersiz sunucu parametreleri (ör. uygulama kimliği veya yerleşim kimliği eksik).
102	com.google.mediation.mintegral	Mintegral SDK'sı doldurma yok hatası döndürmüştür.
103	com.google.mediation.mintegral	Mintegral SDK'sı reklam gösteremedi.
104	com.google.mediation.mintegral	İstenen reklam boyutu, Mintegral tarafından desteklenen bir banner boyutuyla eşleşmiyor.

Mintegral Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

1.8.3 sürümü

• Mintegral Android adaptörünün 16.8.61.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.7.3.0 sürümünü destekler.
• Google Mobile Ads Unity eklentisi 9.3.0 sürümü ile derlenmiş ve test edilmiştir.

1.8.2 sürümü

• Mintegral Android adaptörünün 16.8.61.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.7.2.1 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.2.1 sürümü ile oluşturulup test edilmiştir.

Sürüm 1.8.1

• Mintegral Android adaptörünün 16.8.51.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.7.2.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümü ile derlenmiş ve test edilmiştir.

Sürüm 1.8.0

• Mintegral Android adaptörünün 16.8.31.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.7.0.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümü ile derlenmiş ve test edilmiştir.

Sürüm 1.7.0

• DummyClient, PlaceholderClient olarak yeniden adlandırıldı.
• Mintegral Android adaptör sürümü 16.8.11.0'u destekler.
• Mintegral iOS adaptörünün 7.6.9.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümü ile derlenmiş ve test edilmiştir.

1.6.5 sürümü

• Mintegral Android adaptörünün 16.7.81.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.6.8.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümü ile derlenmiş ve test edilmiştir.

1.6.4 sürümü

• Mintegral Android bağdaştırıcısı 16.7.61.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.6.7.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.

1.6.3 sürümü

• Mintegral Android adaptörünün 16.7.41.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.6.6.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.

1.6.2 sürümü

• Mintegral Android adaptörünün 16.7.41.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.6.4.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.

Sürüm 1.6.1

• Mintegral Android adaptörünün 16.7.21.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.6.3.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.

Sürüm 1.6.0

• Mintegral Android adaptörünün 16.7.11.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.6.2.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümü ile derlenmiş ve test edilmiştir.

Sürüm 1.5.0

• Mintegral Android adaptörünün 16.6.71.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.6.0.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümü ile derlenmiş ve test edilmiştir.

Sürüm 1.4.0

• Mintegral Android adaptörünün 16.6.34.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.5.6.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 8.7.0 sürümü ile oluşturulup test edilmiştir.

Sürüm 1.3.0

• Mintegral Android adaptörünün 16.5.91.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.5.3.0 sürümünü destekler.
• Mintegral sınıfına aşağıdaki yöntemler eklendi:
  • SetConsentStatus(bool)
  • SetDoNotTrackStatus(bool)
• Google Mobil Reklamlar Unity eklentisi 8.6.0 sürümü ile oluşturulup test edilmiştir.

Sürüm 1.2.1

• Mintegral Android bağdaştırıcısı 16.4.61.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.3.8.0 sürümünü destekler.
• Google Mobile Ads Unity eklentisi 8.3.0 sürümü ile derlenmiş ve test edilmiştir.

Sürüm 1.2.0

• Adaptör içeriği GoogleMobileAds/Mediation/Mintegral/ konumuna taşındı.
• Mintegral Android adaptörünün 16.4.41.0 sürümünü destekler.
• Mintegral iOS adaptörünün 7.3.6.0 sürümünü destekler.
• Google Mobile Ads Unity eklentisi 8.3.0 sürümü ile derlenmiş ve test edilmiştir.

Sürüm 1.1.0

• Mintegral Android bağdaştırıcısı 16.3.61.0 sürümünü destekler.
• Mintegral iOS bağdaştırıcısı 7.2.9.1 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 7.4.1 sürümü ile oluşturulup test edilmiştir.

Sürüm 1.0.0

• İlk Sürüm!
• Mintegral Android adaptörünün 16.2.61.0 sürümünü destekler.
• Mintegral iOS adaptörü 7.2.6.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 7.3.1 sürümü ile oluşturulup test edilmiştir.