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

Pangle'ı teklifli sisteme entegre edin

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'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 açıklanmaktadı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

¹ Şelale entegrasyonu kapalı beta sürümündedir.

² 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]: Teklif verme işlemine desteklenen tüm reklam biçimlerini entegre etmek için 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.

Test modunu etkinleştirme

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

2. Adım: Ad Manager kullanıcı arayüzünde Pangle talebini ayarlayın

Ad Manager hesabınızda oturum açın.

Şirketlere Pangle'i ekleme

Teklif verme

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

Şelale

Yönetici > Şirketler'e gidin ve ardından Tüm şirketler sekmesindeki Yeni şirket düğmesini tıklayın. Reklam ağı'nı seçin.

Reklam ağı olarak Pangle'i seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin.

Kullanıcı adı veya Şifre girmeniz gerekmez. İşlemi tamamladığınızda Kaydet'i tıklayın.

Güvenli sinyal paylaşımını etkinleştirme

Teklif verme

Yönetici > Genel ayarlar'a gidin. Ad Exchange hesap ayarları sekmesine gidin, Güvenli sinyal paylaşımı'nı inceleyip etkinleştirin. Kaydet'i tıklayın.

Şelale

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

Pangle teklifli sistemini yapılandırma

Teklif verme

Yayınlama > Teklif verenler'e gidin ve SDK Teklif Sistemi sekmesinin altında Yeni teklif veren'i tıklayın.

Teklif veren olarak Pangle'i seçin.

Bu teklif verenin sinyal kitaplığını izin verilen sinyaller listesine ekle ve Sinyallerin bu teklif verenle paylaşılmasına izin ver seçeneklerini etkinleştirin. Ardından Devam'ı tıklayın.

Devam'ı tıklayın.

Bitti'yi tıklayın.

Şelale

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

Reklam birimi eşlemesini yapılandırma

Teklif verme

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi sekmesinin altında Pangle'yi seçin.

Reklam birimi eşleme sekmesine gidip Yeni reklam birimi eşleme'yi tıklayın.

Belirli bir reklam birimi'ni seçin. Bir reklam birimi ve biçimi, Envanter türü olarak Mobil uygulama'yı ve Mobil uygulamanızı seçin. Ardından, önceki bölümde elde edilen uygulama kimliğini ve reklam yerleşimi kimliğini girin. Son olarak Kaydet'i tıklayın.

Şelale

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın. Mobil uygulamanızı seçin.

Aşağı kaydırın ve Getiri iş ortağı ekle'yi tıklayın.

Önceki bölümde Pangle için oluşturduğunuz şirketi seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak Android'i ve Durum olarak Etkin'i seçin.

Önceki bölümde elde edilen uygulama kimliğini ve reklam yerleşimi kimliğini, ayrıca varsayılan BGBM değerini girin. Kaydet'i 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

Ad Manager 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.