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'ın 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 Flutter uygulamasına nasıl entegre edileceğini kapsar.
Desteklenen entegrasyonlar ve reklam biçimleri
Mintegral için Ad Manager uyumlulaştırma bağdaştırıcısı 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ı | |
| Yerel biçim | |
2 Şelale entegrasyonu açık beta sürümündedir.
Şartlar
- En son Google Mobile Ads SDK'sı
- Flutter 3.7.0 veya sonraki sürümler
- [Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek üzere Mintegral 1.4.0 veya daha yeni bir sürüm için Google Mobile Ads uyumlulaştırma eklentisini kullanın (en son sürüm önerilir)
- 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ış çalışan bir Flutter projesi. 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.
Android
iOS
Uygulamanızın UYGULAMASINI KİMLİĞİNİ not edin.
Android
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.
Android
iOS
Bir yerleşim adı ve reklam biçimi girin.
Teklifli Sistem Türü olarak Başlıktan Teklif Alma'yı seçin. Formun geri kalanını doldurup Kaydet'i tıklayın.
Reklam yerleşiminiz oluşturulduktan sonra yerleşim kimliğini not edin.
Android
iOS
1 Reklam Birimi açılır menüsünü tıklayın ve Reklam Birimi Kimliği'ni not edin.
Android
iOS
Mintegral Reporting API anahtarınızı bulma
Teklif verme
Bu adım, teklifli sistem entegrasyonları için gerekli değildir.
Şelale
Ad Manager 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: Ad Manager kullanıcı arayüzünde Mintegral talebini ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Android
Talimatlar için Android kılavuzundaki 2. adıma bakın.
iOS
Talimatlar için iOS kılavuzunun 2. adımına bakın.
Mobvista/Mintegral'ı GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme
Mobvista/Mintegral'ı Ad Manager kullanıcı arayüzündeki Avrupa ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için Avrupa düzenlemeleri ayarlarında ve ABD eyalet düzenlemeleri ayarlarında yer alan adımları uygulayın.
3. Adım: Mintegral SDK'sını ve bağdaştırıcısını içe aktarın
pub.dev üzerinden entegrasyon
Paketinizin pubspec.yaml dosyasına Mintegral SDK'sının ve bağdaştırıcının en son sürümleriyle birlikte aşağıdaki bağımlılığı ekleyin:
dependencies:
gma_mediation_mintegral: ^1.0.0
Manuel Entegrasyon
Mintegral için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı ayıklayı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 referans verin:
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'in belgelerini inceleyin.
5. Adım: Uygulamanızı test edin
Test reklamlarını etkinleştirme
Ad Manager 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.
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:
Android
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 ilişkili mesajlar aşağıda verilmiştir:
Android
| 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 Flutter Uyumlulaştırma Adaptörü Değişiklik Günlüğü
Sonraki Sürüm
- Google Mobile Ads Flutter eklentisi 5.2.0 sürümü ile oluşturulup test edilmiştir.
1.1.0
- Mintegral Android adaptörü 16.8.31.0 sürümüyle uyumluluğu doğrulandı.
- Mintegral iOS adaptörünün 7.7.1.0 sürümüyle uyumluluğu doğrulandı.
- Google Mobile Ads Flutter eklentisi 5.1.0 sürümü ile oluşturulup test edilmiştir.
1.0.0
- İlk sürüm.
- Mintegral Android adaptörünün 16.7.21.0 sürümüyle uyumluluğu doğrulandı.
- Mintegral iOS adaptörünün 7.6.3.0 sürümüyle uyumluluğu doğrulandı.
- Google Mobile Ads Flutter eklentisi 5.1.0 sürümü ile oluşturulup test edilmiştir.