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 rehberde, 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 uygulamaya nasıl Flutter 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ı | ||
Yerel biçim | 1 3 |
1 Bu biçim için teklif entegrasyonu kapalı beta sürümündedir.
2 Bu biçim için Şelale entegrasyonu kapalı beta sürümündedir.
3 Bu biçim için Şelale entegrasyonu açık beta sürümündedir.
Koşullar
- En yeni Google Mobile Ads SDK'sı
- Flutter 3.7.0 veya sonraki sürümler
- Android'de dağıtmak için
- Android API düzeyi 21 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 Flutter proje. Ayrıntılar için Başlarken bölümüne bakın.
- Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu
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
pub.dev üzerinden entegrasyon
Aşağıdaki bağımlılığı paketinizin pubspec.yaml
dosyasınaMintegral SDK ve bağdaştırıcının en son sürümleriyle ekleyin:
dependencies:
gma_mediation_mintegral: ^1.0.0
Manuel Entegrasyon
Mintegral için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü (ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml
dosyanızdaki eklentiye başvurun:
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
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 Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü
1.0.0
- İlk sürüm.
- Mintegral Android adaptörü sürüm 16.7.21.0 ile doğrulanmış uyumluluk.
- Mintegral iOS adaptörü sürüm 7.6.3.0 ile doğrulanmış uyumluluk.
- Google Mobile Ads Flutter Eklentisi sürüm 5.1.0 ile geliştirildi ve test edilmiştir.