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

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 verme
Şelale
Formatlar
Uygulama Açma	^1
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
Yerel biçim	^2

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

² Yerel reklam biçimi için teklifli sistem ve şelale entegrasyonları açık beta sürümündedir.

Şartlar

• En son Google Mobile Ads SDK'sı
• Flutter 3.7.0 veya sonraki sürümler
• Android'de dağıtım yapmak için
  • Android API düzeyi 21 veya üstü
• 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ış, çalışan bir Flutter proje. Ayrıntılar için Başlayın 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ı 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ı 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ş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, teklif entegrasyonları için gerekli değildir.

Şelale

AdMob reklam birimi kimliğinizi ayarlamak için Mintegral Reporting API Anahtarınıza ihtiyacınız olacak. Hesap > API Araçları'na gidin. Skey'inizi ve Secret'ınızı (Gizli Anahtarınızı) 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

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 ekleyin

Önemli: AB kullanıcı rızası, GDPR, CPRA ve Kullanıcı Mesajlaşma Platformu ile ilgili yapılandırmayı tamamlamak için Hesap Yönetimi izniniz olduğunu doğrulayın. Ayrıntılar için Kullanıcıların hesabınıza erişimini yönetme sayfasına göz atın.

AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Mobvista/Mintegral'i eklemek için GDPR ayarları ve ABD eyalet düzenlemeleri ayarlarında belirtilen 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ı sürümlerinin entegre edilmemesi, derleme sorunlarına neden olabilir.

pub.dev aracılığıyla entegrasyon

Aşağıdaki bağımlılığı Mintegral Paketinizdeki SDK ve bağdaştırıcı pubspec.yaml dosyası:

dependencies:
  gma_mediation_mintegral: ^1.0.0

Manuel Entegrasyon

Şu hesap için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin: Mintegral, indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü ekleyin. (ve içeriklerini) 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

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ş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ı.

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

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ında altta yatan hatayı kontrol edebilir:

Yapay Zeka

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 gönderilen kodlar ve beraberindeki 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ı, dolgu yok hatası döndürdü.

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 sürüm 5.2.0 ile geliştirilmiş ve test edilmiştir.

1.1.0

• Mintegral Android bağdaştırıcının 16.8.31.0 sürümüyle uyumlu olduğu doğrulandı.
• Mintegral iOS adaptörü 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 bağdaştırıcının 16.7.21.0 sürümüyle uyumlu olduğu doğrulandı.
• Mintegral iOS bağdaştırıcısı sürüm 7.6.3.0 ile uyumluluk doğrulandı.
• Google Mobile Ads Flutter eklentisi 5.1.0 sürümüyle geliştirilip test edilmiştir.