Mintegral'ı uyumlulaştırma ile entegre etme

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.