Bu kılavuzda, hem şelale hem de teklif entegrasyonlarını kapsayan uyumlulaştırma özelliğini kullanarak Mintegral'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sını nasıl kullanacağınız gösterilmektedir. Bu videoda, reklam biriminin uyumlulaştırma yapılandırmasına Mintegral'ın nasıl ekleneceği ve Mintegral SDK ile bağdaştırıcının bir Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.
Desteklenen entegrasyonlar ve reklam biçimleri
Mintegral için AdMob uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:
Entegrasyon | ||
---|---|---|
Teklif | 1 | |
Şelale | 2 | |
Formatlar | ||
Uygulama Açma | 1 2 | |
Banner | ||
Geçişli | ||
Ödül olarak verildi | ||
Ödüllü Geçiş Reklamı |
2 Bu biçim için teklif verme entegrasyonu kapalı beta sürümündedir.
Koşullar
- Unity 5.6 veya sonraki sürümler
- En son Google Mobile Ads SDK'sı
- Android'de dağıtmak için
- Android API düzeyi 19 veya üstü
- iOS'te dağıtmak için
- 12.0 veya üstü iOS dağıtım hedefi
- Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Unity projesi. Ayrıntılar için Başlarken bölümüne bakın.
- Uyumlulaştırmayı tamamlayın Başlangıç kılavuzunu
1. Adım: Mintegral kullanıcı arayüzünde yapılandırmaları ayarlayın
Mintegral hesabınıza kaydolun veya giriş yapın.
Uygulama Anahtarını Bulun
APP Ayarı sekmesine gidin ve APP Anahtarı'nı not edin.
Yeni bir uygulama ekle
APP Ayarı sekmesinden UYGULAMA ekle düğmesini tıklayın.
Platformu seçin ve formun geri kalanını doldurun. Ardından Kaydet'i tıklayın.
Android
iOS
Uygulamanızın UYGULAMA KİMLİĞİNİ not edin.
Android
iOS
Reklam yerleşimi oluşturma
Uygulamanız oluşturulduktan sonra Yerleşimler ve Birimler sekmesine gidin ve aşağıda gösterilen Yerleşim Ekle düğmesini tıklayarak reklam yerleşiminizi oluşturun.
Android
iOS
Bir Yerleşim Adı ve Reklam Biçimi girin.
Teklif
Teklif Türü olarak Başlıktan Teklif Alma (Header Bidding)'i seçin. Formun geri kalanını doldurun ve Kaydet'i tıklayın.
Şelale
Teklif Türü olarak Geleneksel'i seçin. Formun geri kalanını doldurun ve Kaydet'i tıklayın.
Reklam yerleşiminiz oluşturulduktan sonra, Yerleşim Kimliğini not edin.
Android
iOS
1 AD Units (1 Reklam Birimi) açılır menüsünü tıklayın ve AD Unit ID'yi (Reklam Birimi Kimliğini) not edin.
Android
iOS
Mintegral Reporting API Anahtarınızı Bulma
Teklif
Bu adım, teklif entegrasyonları için gerekli değildir.
Şelale
AdMob Reklam birimi kimliğinizi oluşturmak için Mintegral Reporting API Anahtarınıza ihtiyacınız olacak. Account (Hesap) > API Tools'a (API Araçları) gidin. Skey ve Secret'ı not edin.
2. Adım: Kullanıcı arayüzünde Mintegral talebini AdMob ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Android
Talimatlar için Android kılavuzunun 2. adımına bakın.
iOS
Talimatlar için iOS rehberinin 2. adımına göz atın.
GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Mintegral ekle
GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob kullanıcı arayüzünde 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
Changelog'daki indirme bağlantısından Mintegral için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsMintegralMediation.unitypackage
dosyasını çıkarın.
Unity proje düzenleyicinizde Öğeler > Paketi İç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 > Play Hizmetleri Çözümleyici > Android Çözümleyici > Çözmeye Zorla'yı seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemeyi sıfırdan gerçekleştirecek ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android
dizinine kopyalayacaktır.
4. Adım: Gerekli kodu ekleyin
Android
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 inceleyin.
5. Adım: Uygulamanızı test etme
Test reklamlarını etkinleştir
AdMob.
Mintegral; banner'lar, geçiş reklamları, ödüllü ve yerel reklam biçimlerinde Mintegral test reklamları almak için Mintegral Test ID sayfası.
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.
Hata kodları
Bağdaştırıcı Mintegral'dan reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo
kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Bir reklam yüklenemediğinde Mintegral bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajlar aşağıda verilmiştir:
Android
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ü. |
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ı dolgu yok hatası döndürdü. |
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üğü
Sürüm 1.4.0
- Mintegral Android adaptörü 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 sürüm 8.7.0 ile geliştirilip test edilmiştir.
Sürüm 1.3.0
- Mintegral Android bağdaştırıcısının 16.5.91.0 sürümünü destekler.
- Mintegral iOS bağdaştırıcısının 7.5.3.0 sürümünü destekler.
- Aşağıdaki yöntemler
Mintegral
sınıfına eklendi:SetConsentStatus(bool)
SetDoNotTrackStatus(bool)
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.6.0 ile geliştirilip test edilmiştir.
Sürüm 1.2.1
- Mintegral Android bağdaştırıcısının 16.4.61.0 sürümünü destekler.
- Mintegral iOS bağdaştırıcısının 7.3.8.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.3.0 ile geliştirilip test edilmiştir.
Sürüm 1.2.0
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/Mintegral/
klasörüne taşındı. - Mintegral Android bağdaştırıcısının 16.4.41.0 sürümünü destekler.
- Mintegral iOS bağdaştırıcısının 7.3.6.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.3.0 ile geliştirilip test edilmiştir.
Sürüm 1.1.0
- Mintegral Android adaptörü 16.3.61.0 sürümünü destekler.
- Mintegral iOS bağdaştırıcısının 7.2.9.1 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.4.1 ile geliştirilip test edilmiştir.
Sürüm 1.0.0
- İlk Lansman!
- Mintegral Android adaptörü sürüm 16.2.61.0'ı destekler.
- Mintegral iOS bağdaştırıcısının 7.2.6.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.3.1 ile geliştirildi ve test edildi.