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 Ad Manager uyumlulaştırıcı adaptör 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ı |
2 Şelale entegrasyonu kapalı beta sürümündedir.
Şartlar
- En son Google Mobile Ads SDK'sı
- Unity 5.6 veya sonraki sürümler
- Android'de dağıtmak için
- Android API düzeyi 21 veya sonraki sürümler
- iOS'te dağıtım yapmak 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 reklam yerleşiminizi oluşturmak için Yerleşimler ve Birimler sekmesine gidin ve aşağıda gösterildiği gibi Yerleşim Ekle düğmesini tıklayın.
Yapay Zeka
iOS
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ı doldurun ve Kaydet'i tıklayın.
Reklam yerleşimi oluşturulduktan sonra Yerleşim Kimliği'ni 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: Kullanıcı arayüzünde Mintegral talebini Ad Manager ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Mintegral 'i 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
OpenUPM-CLI
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 Eklentisini projenize yükleyebilirsiniz:
openupm add com.google.ads.mobile.mediation.mintegral
OpenUPM
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. External Dependency Manager 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 belgelerini uygulayın.
5. Adım: Uygulamanızı test edin
Test reklamlarını etkinleştirme
Test cihazınızı AdMob'a 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'dan test reklamları aldığınızı doğrulamak için Mintegral (Teklifli Sistem) 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. eksik uygulama kimliği veya yerleşim kimliği). |
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 Mobil Reklamlar Unity eklentisi 9.3.0 sürümüyle geliştirilip 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 bağdaştırıcısı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 bağdaştırıcısının 16.8.51.0 sürümünü destekler.
- Mintegral iOS bağdaştırıcısı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 bağdaştırıcısı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 bağdaştırıcısının 16.8.11.0 sürümünü 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.
Sürüm 1.6.5
- Mintegral Android bağdaştırıcısı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üyle geliştirilip 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 bağdaştırıcısı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.
Sürüm 1.6.2
- Mintegral Android bağdaştırıcısı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 bağdaştırıcısı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üyle geliştirilip 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 bağdaştırıcısı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
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/Mintegral/
hedefine taşındı. - Mintegral Android adaptörünün 16.4.41.0 sürümünü destekler.
- Mintegral iOS bağdaştırıcısı 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ının 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üyle geliştirilip 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.