Bu kılavuzda, arabuluculuk kullanarak Pangle'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Hem şelale hem de teklif entegrasyonları ele alınmaktadı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
- [Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek amacıyla Pangle 2.4.0 veya sonraki sürümler 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ış 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 işletim sistemini 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çiminizi ve Reklam yerleşimi adınızı seçin, ardından Fiyatlandırma Türü olarak Uygulama İçi Teklif'i seçin. Formun geri kalanını doldurup Gönder'i tıklayın.
Reklam yerleşiminiz oluşturulduktan sonra reklam yerleşimi kimliğini not edin.
Yapay Zeka
iOS
Şelale
Reklam biçiminizi ve Reklam Yerleşim Adınızı seçin. Fiyatlandırma Türü olarak Küresel BGBM'yi seçin. Formun geri kalanını doldurun ve Gönder'i tıklayın.
Reklam yerleşiminiz oluşturulduktan sonra reklam yerleşimi kimliğini not edin.
Yapay Zeka
iOS
Pangle Reporting API anahtarını bulma
Teklif verme
Bu adım, teklifli sistem entegrasyonları için gerekli değildir.
Şelale
Sayfanın sol alt köşesindeki Kullanıcı Kimliği'ni not edin.
Entegrasyonlar > SDK ve API > Pangle Reporting API 2.0'ı tıklayın. Roll kimliğini ve Güvenlik Anahtarı'nı not edin.
Test modunu etkinleştirme
Pangle test reklamlarını etkinleştirmeyle ilgili Pangle'ın Test reklamı ekleme kılavuzundaki talimatları uygulayın.
2. adım: Pangle talebini AdMob kullanıcı arayüzünde ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Yapay Zeka
Talimatlar için Android kılavuzundaki 2. adıma bakın.
iOS
Talimatlar için iOS kılavuzunun 2. adımına bakın.
3. Adım: Pangle SDK'sını ve bağdaştırıcısını içe aktarın
pub.dev üzerinden 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/")
}
}
Paketinizin pubspec.yaml
dosyasına Pangle 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_pangle: ^1.0.0
Manuel Entegrasyon
Pangle 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_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ştirme
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
Pangle'dan test reklamları aldığınızı doğrulamak için Pangle (Teklifli Sistem) ve Pangle (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
Hata kodları
Adaptör Pangle'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:
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ürmüştür. Daha fazla ayrıntı için Pangle'in dokümanlarını inceleyin. |
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ürmüştür. Daha fazla ayrıntı için Pangle'in dokümanlarını inceleyin. |
Pangle 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.
2.0.0
- Pangle Android adaptörü 6.1.0.9.0 sürümü ile uyumluluğu doğrulandı.
- Pangle iOS adaptörü 6.2.0.5.0 sürümü ile uyumluluğ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ü 5.9.0.7.0 sürümü ile 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.
- 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 oluşturulup test edilmiştir.