Pangle'ı uyumlulaştırma ile entegre etme

Bu kılavuzda, hem şelale hem de teklif entegrasyonlarını kapsayan arabuluculuk kullanarak Pangle'deki reklamları yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. 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 Unity uygulamasına nasıl entegre edileceği açıklanmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Pangle için AdMob uyumlulaştırıcı bağdaştırıcısı aşağıdaki özelliklere sahiptir:

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

Şartlar

  • En son Google Mobile Ads SDK'sı
  • Unity 5.6 veya sonraki sürümler
  • [Teklif verme için]: Teklif vermeye desteklenen tüm reklam biçimlerini entegre etmek üzere 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ış çalışan bir Unity 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: 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.

AndroidiOS

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

AndroidiOS

Reklam yerleşimi oluşturma

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

AndroidiOS

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.

AndroidiOS

Reklam biçiminizi ve Reklam yerleşimi 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.

AndroidiOS

Pangle Reporting API anahtarını bulma

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

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 KİMLİĞİ 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: AdMob kullanıcı arayüzünde Pangle talebini ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

AndroidiOS

Talimatlar için Android kılavuzundaki 2. adıma bakın.

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

OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak Unity için Google Mobil Reklamlar Pangle Uyumlulaştırma Eklentisi'ni projenize yükleyebilirsiniz:

openupm add com.google.ads.mobile.mediation.pangle

Unity Paket Yöneticisi Ayarlarını açmak için Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçin.

Kapsamlı Kayıt Daireleri sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı bir kayıt dairesi olarak ekleyin:

  • Ad: OpenUPM
  • URL: https://package.openupm.com
  • Kapsamlar: com.google

OpenUPM Ayrıntıları

Ardından, Unity Paket Yöneticisi'ni açmak için pencere > Paket Yöneticisi'ne gidin ve açılır menüden Kayıt Dairelerim'i seçin.

Unity Kayıt Daireleri

Google Mobil Reklamlar Pangle Uyumlulaştırması paketini seçin ve Yükle'yi tıklayın.

OpenUPM'den yükleme

Değişiklikler Günlüğü'ndeki indirme bağlantısından Pangle için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin ve GoogleMobileAdsPangleMediation.unitypackage dosyasını zip dosyasından çıkarın.

Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsPangleMediation.unitypackage dosyayı bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Unity'den içe aktarma

Ardından Öğeler > Harici Bağımlılık Yöneticisi > Android Çözücü > Çözümü Zorla'yı seçin. Harici Bağımlılık Yöneticisi kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

Çözümü Zorla Uygula

4. adım: Gerekli kodu ekleyin

AndroidiOS

Pangle entegrasyonu için ek kod gerekmez.

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Pangle'ın dokümanlarını 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:

AndroidiOS
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
GADMediationAdapterPangle

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

AndroidiOS
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.
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 Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

4.5.4 sürümü

4.5.3 sürümü

4.5.2 sürümü

4.5.1 sürümü

4.5.0 sürümü

4.4.2 sürümü

4.4.1 sürümü

Sürüm 4.4.0

4.3.3 sürümü

4.3.2 sürümü

4.3.1 sürümü

4.3.0 sürümü

4.2.1 sürümü

4.2.0 sürümü

Sürüm 4.1.0

Sürüm 4.0.1

Sürüm 4.0.0

3.0.0 sürümü

2.8.1 sürümü

2.8.0 sürümü

2.7.0 sürümü

2.6.0 sürümü

2.5.0 sürümü

2.4.0 sürümü

2.3.0 sürümü

2.2.0 sürümü

2.1.0 sürümü

2.0.0 sürümü

1.5.1 sürümü

Sürüm 1.5.0

Sürüm 1.4.0

1.3.1 sürümü

Sürüm 1.3.0

Sürüm 1.2.0

Sürüm 1.1.0

Sürüm 1.0.0