Bu sayfa, Cloud Translation API ile çevrilmiştir.

Pangle'ı uyumlulaştırma ile entegre etme

Bu kılavuzda, hem şelale hem de teklif entegrasyonlarını kapsayan AdMob Uyumlulaştırma'yı 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'in 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 Android uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

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

¹ Bu biçim için teklif entegrasyonu açık beta sürümündedir.

Şartlar

Android API düzeyi 21 veya sonraki sürümler
[Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek amacıyla 5.5.0.4.0 veya daha yeni bir Pangle bağdaştırıcısı kullanın (en son sürüm önerilir).

En son Google Mobile Ads SDK'sı
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.

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

Reklam yerleşimi oluşturma

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

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.

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

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

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

Pangle'i reklam biriminizin uyumlulaştırma yapılandırmasına eklemeniz gerekir.

Öncelikle AdMob hesabınızda oturum açın. Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa düzenlemek için ilgili uyumlulaştırma grubunun adını tıklayın ve Pangle'i reklam kaynağı olarak ekleme bölümüne geçin.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.

Reklam biçiminizi ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın ve Reklam Birimi Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizden bir veya daha fazlasıyla ilişkilendirin. Ardından Bitti'yi tıklayın.

Artık reklam birimleri kartının, seçtiğiniz reklam birimleriyle doldurulduğunu göreceksiniz:

Pangle'ı reklam kaynağı olarak ekleme

Teklif verme

Reklam Kaynakları bölümündeki Teklifli Sistem kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından Pangle'yi seçin.
İş ortaklığı sözleşmesi imzalama'yı tıklayın ve Pangle ile teklifli sistem iş ortaklığı kurun.

Kabul ediyorum'u, ardından Devam'ı tıklayın.

Pangle için zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde elde edilen uygulama kimliğini ve reklam yerleşimi kimliğini girin. Ardından Bitti'yi tıklayın.

Şelale

Reklam Kaynakları bölümündeki Şelale kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından Pangle'i seçin.

Pangle'ı seçin. Ardından Pangle için bir eBGBM değeri girin ve Devam'ı tıklayın.

Pangle için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde elde edilen uygulama kimliğini ve reklam yerleşimi kimliğini girin. Ardından Bitti'yi tıklayın.

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

Android Studio entegrasyonu (önerilen)

Proje düzeyindeki settings.gradle.kts dosyanıza aşağıdaki depoları ekleyin:

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

Ardından, uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıkları ve yapılandırmaları ekleyin. Pangle SDK'sının ve bağdaştırıcının en son sürümlerini kullanın:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:pangle:6.3.0.4.0")
}

Manuel entegrasyon

Android için Pangle SDK'sının en son sürümünü indirin ve indirilen arşiv klasöründen open_ad_sdk.aar dosyasını çıkarıp projenize ekleyin.
Google'ın Maven deposunda Pangle bağdaştırıcısı yapılarına gidin. En son sürümü seçin, Pangle bağdaştırıcının .aar dosyasını indirin ve projenize ekleyin.

4. adım: Gerekli kodu ekleyin

ProGuard kod karartma

Android kodunu karartmak için ProGuard kullanıyorsanız Pangle SDK kodunun karartılmadığından emin olmak için Pangle'ın dokümanlarında yer alan talimatları uygulayın.

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.

İsteğe bağlı adımlar

Yerel reklamlar

Reklam oluşturma

Pangle bağdaştırıcısı, yerel reklamlarını NativeAd nesneler olarak döndürür. NativeAd için aşağıdaki alanlar doldurulur.

Alan	Pangle adaptörü tarafından her zaman dahil edilen öğeler
Başlık
Resim	1
Metin
Simge
Harekete geçirici mesaj
Yıldızlı değerlendirme
Depolama
Fiyat
Reklamveren

¹ Pangle bağdaştırıcısı, doğal reklamları için ana resim öğesine doğrudan erişim sağlamaz. Bunun yerine, adaptör MediaView alanına bir video veya resim doldurur.

Hata kodları

Adaptör Pangle'den reklam alamıyorsa aşağıdaki sınıflar altında ResponseInfo.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

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

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

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ını inceleyin.