Pangle'ı uyumlulaştırma ile entegre etme

Bu kılavuzda, uyumlulaştırma aracılığıyla Pangle'dan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu sayede hem şelale hem de teklif verme entegrasyonları kapsamaktadır. Bu makalede, Pangle'ın bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Pangle SDK'sının ve bağdaştırıcının bir uygulamaya nasıl entegre edileceği ele alınmaktadır. Flutter

Desteklenen entegrasyonlar ve reklam biçimleri

Pangle için AdMob uyumlulaştırma adaptörü aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif verme
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
Yerel biçim

Şartlar

  • En son Google Mobile Ads SDK'sı
  • Flutter 3.7.0 veya üzeri
  • Android'de dağıtım yapmak için
    • Android API düzeyi 21 veya sonraki sürümler
  • 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ış Flutter çalışan bir 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: Pangle kullanıcı arayüzünde yapılandırmaları ayarlayın

Pangle hesabınıza kaydolun veya oturum açın.

Yeni uygulama ekleme

Uygulamalar sekmesine gidin ve Uygulama Ekle düğmesini tıklayın.

Uygulama oluşturmak istediğiniz İşletim Sistemi'ni seçin ve formun geri kalanını doldurun. Ardından Gönder'i tıklayın.

Yapay Zeka

iOS

Uygulamanızın uygulama kimliğini not edin.

Yapay Zeka

iOS

Reklam yerleşimi oluşturma

Uygulamanız oluşturulduktan sonra, reklam yerleşiminizi oluşturmak için Ekle düğmesini tıklayın.

Yapay Zeka

iOS

Teklif verme

Reklam Biçimi ile Reklam Yerleşimi Adı'nı, ardından Fiyatlandırma Türü olarak Uygulama İçi Teklif Verme'yi seçin. Formun geri kalanını doldurun ve Gönder'i tıklayın.

Reklam yerleşimi oluşturulduktan sonra Reklam Yerleşimi Kimliği'ni not edin.

Yapay Zeka

iOS

Şelale

Fiyatlandırma Türü olarak Reklam Biçimi ile Reklam Yerleşimi Adı ve Genel BGBM'yi seçin. Formun geri kalanını doldurun ve Gönder'i tıklayın.

Reklam yerleşimi oluşturulduktan sonra Reklam Yerleşimi Kimliği'ni not edin.

Yapay Zeka

iOS

Pangle Reporting API anahtarını bulma

Teklif verme

Bu adım, teklif entegrasyonları için gerekli değildir.

Şelale

Sayfanın sol alt köşesindeki User ID'yi not edin.

Entegrasyonlar > SDK ve API > Pangle Reporting API 2.0'ı tıklayın. Rol Kimliği ve Güvenlik Anahtarı'na dikkat edin.

Test modunu aç

Pangle test reklamlarını etkinleştirmeyle ilgili Pangle'ın Test reklamı ekleme kılavuzundaki talimatları uygulayın.

2. Adım: Kullanıcı arayüzünde Pangle 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.

3. Adım: Pangle SDK'sını ve bağdaştırıcısını içe aktarın

pub.dev aracılığıyla entegrasyon

(Yalnızca Android) Projenizin android dizininde bulunan build.gradle dosyasına aşağıdaki depoları ekleyin:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifact.bytedance.com/repository/pangle/")
      }
  }

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

dependencies:
  gma_mediation_pangle: ^1.0.0

Manuel Entegrasyon

Şu hesap için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin: Pangle, 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_pangle:
    path: path/to/local/package

4. adım: Gerekli kodu ekleyin

Yapay Zeka

Pangle entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Pangle'ın belgelerini inceleyin.

5. Adım: Uygulamanızı test edin

Test reklamlarını etkinleştir

AdMob için test cihazınızı kaydettiğinizden ve Pangle kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.

Test reklamlarını doğrulama

Panglereklam kaynağından test reklamları aldığınızı doğrulamak için Pangle (Bidding) and Pangle (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

Hata kodları

Bağdaştırıcı Pangle'dan bir reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtında temel alınan hatayı kontrol edebilir:

Yapay Zeka

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

iOS

GADMediationAdapterPangle

Bir reklam yüklenemezse Pangle adaptörü tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

Yapay Zeka

Hata kodu Alan Neden
101 com.google.ads.mediation.pangle Geçersiz sunucu parametreleri (ör. uygulama kimliği veya yerleşim kimliği eksik).
102 com.google.ads.mediation.pangle İstenen reklam boyutu, Pangle tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103 com.google.ads.mediation.pangle Teklif yanıtı eksik veya geçersiz.
-1-60000 com.pangle.ads Pangle SDK'sı hata döndürdü. Daha fazla ayrıntı için Pangle'in dokümanlarına bakın.

iOS

Hata kodu Alan Neden
101 com.google.ads.mediation.pangle Geçersiz sunucu parametreleri (ör. uygulama kimliği veya yerleşim kimliği eksik).
102 com.google.ads.mediation.pangle İstenen reklam boyutu, Pangle tarafından desteklenen bir banner boyutuyla eşleşmiyor.
-1-60000 Pangle SDK'sı tarafından gönderildi Pangle SDK'sı hata döndürdü. Daha fazla ayrıntı için Pangle'ın belgelerine bakın.

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

2.0.0

  • Pangle Android adaptörü 6.1.0.9.0 sürümü ile uyumluluğu doğrulandı.
  • Pangle iOS adaptörünün 6.2.0.5.0 sürümüyle uyumlu olduğu doğrulandı.
  • Google Mobile Ads Flutter eklentisi 5.1.0 sürümü ile oluşturulup test edilmiştir.

1.1.0

  • Pangle Android adaptörü 5.9.0.4.0 sürümü ile uyumluluğu doğrulanmıştır.
  • Pangle iOS adaptörünün 5.9.0.7.0 sürümüyle uyumlu olduğ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.
  • Pangle Android adaptörü 5.8.0.9.0 sürümü ile uyumluluğu doğrulandı
  • Pangle iOS adaptörü 5.8.0.8.0 sürümü ile uyumluluğu doğrulandı
  • Google Mobile Ads Flutter eklentisi 5.0.0 sürümü ile geliştirilmiş ve test edilmiştir.