Pangle'ı uyumlulaştırma ile entegre etme

Bu kılavuzda, hem şelale hem de teklif entegrasyonlarını kapsayan 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. 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ı adaptörü 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 daha yeni sürümler
  • [Teklif verme için]: Teklif vermeye desteklenen tüm reklam biçimlerini 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 üzeri
  • iOS'e dağıtmak için
    • iOS dağıtım hedefi 12.0 veya daha yeni bir sürüm olmalıdır.
  • 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ı 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.

Android

iOS

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

Android

iOS

Reklam yerleşimi oluşturma

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

Android

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.

Android

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.

Android

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

Android

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

OpenUPM-CLI

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

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

OpenUPM

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

Unity Paketi

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 zip dosyasından GoogleMobileAdsPangleMediation.unitypackage dosyasını çıkarın.

Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsPangleMediation.unitypackage dosyasını 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

Android

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 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:

Android

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:

Android

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 Unity Mediation Plugin Değişiklik Günlüğü

4.5.3 sürümü

4.5.2 sürümü

4.5.1 sürümü

Sürüm 4.5.0

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ü

1.5.0 sürümü

1.4.0 sürümü

1.3.1 sürümü

1.3.0 sürümü

1.2.0 sürümü

1.1.0 sürümü

1.0.0 sürümü