PNG'i teklif verme ile entegre etme

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Bu kılavuzda, uyumlulaştırma kullanarak Pangle'dan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağını ve teklif entegrasyonlarını nasıl yapabileceğinizi görebilirsiniz. Pangle'ı bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleyeceğinizi ve Pangle SDK ile bağdaştırıcıyı birAndroid uygulamaya nasıl entegre edeceğinizi ele alır.

Desteklenen entegrasyonlar ve reklam biçimleri

Pangle için AdMob uyumlulaştırma adaptörü aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif
Şelale
Biçimler
Banner
Geçişli
Ödül olarak verildi
Ödüllü geçiş reklamı
Yerel biçim 1

1 Yerel reklamlar, Pangle adaptörü sürümü 4.5.0.6.1 veya üzeri bir sürüm gerektirir.

Koşullar

  • Android API düzeyi 19 veya üstü
  • En son Google Mobile Ads SDK'sı

1. Adım: Pangle'ı kurun

Pangle hesabınıza kaydolun veya giriş yapın.

Yeni uygulama ekle

Uygulamalar sekmesine gidin ve Uygulama Ekle düğmesini tıklayın.

İşletim Sistemi olarak Android seçeneğini belirleyin 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

Başvurunuz oluşturulduktan sonra, reklam yerleşiminizi oluşturmak için aşağıda gösterildiği gibi Ekle düğmesini tıklayın.

İstediğiniz Reklam Biçimi'ni, Reklam Yerleşimi Adı'nı ve Teklif Türü olarak Uygulama İçi Teklif Verme'yi seçin. Formun geri kalanını doldurun ve Gönder'i tıklayın.

Reklam yerleşiminizi oluşturduktan sonra Reklam Yerleşimi Kimliği'ni not edin.

2. Adım: AdMob reklam biriminiz için uyumlulaştırma ayarlarını yapılandırın

Pangle'ı reklam biriminizin uyumlulaştırma yapılandırmasına eklemeniz gerekir. İlk olarak AdMob hesabınızda oturum açın.

Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa düzenlemek için bu uyumlulaştırma grubunun adını tıklayın ve Pangle'ı 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.

Uyumlulaştırma ayrıntıları

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. Ardından Reklam Birimleri Ekle'yi tıklayarak reklam birimi seçimi yer paylaşımını açın.

Uyumlulaştırma grubu 2

Bu uyumlulaştırma grubunu mevcut AdMob reklam biriminizle ilişkilendirin. Ardından Bitti'yi tıklayın.

Reklam birimi seçin

Reklam birimlerinin kartını, seçtiğiniz reklam birimleriyle doldurduğunuzu göreceksiniz.

Reklam birimlerini gruplama

Pangle'ı reklam kaynağı olarak ekleyin

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

Ardından Uygulama Kimliği'nin yanı sıra önceki bölümde aldığınız Reklam Yerleşimi Kimliği'ni girin ve Bitti'yi tıklayın.

Son olarak, Kaydet'i tıklayın.

Ödüllü reklamları kullanma

Ödüllü reklam biriminizin ayarlarında ödül tutarı ve ödül türü için değerler sağlayın. Ardından, hangi reklam ağının yayınlandığına bakılmaksızın kullanıcıya aynı ödülü verdiğinizden emin olmak için Uyumlulaştırma gruplarındaki tüm ağlara uygulayın kutusunu işaretleyin.

Bu ayarı uygulamazsanız Pangle adaptörü varsayılan olarak "" (boş dize) değerini 1 değerine sahip bir ödül olarak ayarlar. Pangle SDK, ödüllü reklamları için belirli ödül değerleri sağlamaz.

AdMob reklam birimlerinin ödül değerlerini ayarlama hakkında daha fazla bilgi için Reklam birimi oluşturma bölümüne bakın.

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

Uygulama düzeyindeki build.gradle dosyasına Pangle SDK'nın ve bağdaştırıcının en son sürümleriyle aşağıdaki uygulama bağımlılıklarını ekleyin:

repositories {
    google()
    mavenCentral()
    maven {
        url 'https://artifact.bytedance.com/repository/pangle/'
    }
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:21.3.0'
    implementation 'com.google.ads.mediation:pangle:4.8.0.8.0'
}
...

Manuel entegrasyon

  1. Pangle SDK for Android'in en son sürümünü indirin ve indirilen arşiv klasöründen open_ad_sdk.aar dosyasını çıkarıp projenize ekleyin.

  2. Google'ın Maven deposundaki Pangle adaptör yapılarına gidin. En son sürümü seçin, Pangle adaptörünün .aar dosyasını indirin ve projenize ekleyin.

4. Adım: Ek kod gerekir

Pangle entegrasyonu için ek kod gerekmez.

5. Adım: Uygulamanızı test edin

Pangle test reklamlarının nasıl etkinleştirileceğiyle ilgili ayrıntılı talimatlar için Test Reklamı ekleme kılavuzuna bakın. Uygulamanızın doğru olup olmadığını doğrulamak için Reklam İnceleyici'yi kullanabilirsiniz.

İşte bu kadar. Artık Pangle ile çalışan bir uyumlulaştırma entegrasyonunuz var.

İsteğe Bağlı Adımlar

Yerel reklamlar

Reklam oluşturma

Pangle adaptörü yerel reklamlarını NativeAd nesne olarak döndürür. Aşağıdaki alanları doldurur: NativeAd.

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

1 Pangle adaptörü, yerel reklamları için ana resim öğesine doğrudan erişim sağlamaz. Bunun yerine adaptör, MediaView adını bir video veya resimle doldurur.

Hata kodları

Bağdaştırıcı Pangle'dan bir reklam alamazsa ResponseInfo.getAdapterResponse() kullanarak reklam sınıfının temel hatasını aşağıdaki sınıflarda kontrol edebilirsiniz:

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

Pangle adaptörü tarafından yayınlanan reklamlar ve bir reklam yüklenemediğinde şunlar gösterilir:

Hata kodu Alan Neden
101 com.google.ads.uyumlulaştırması.pangle Geçersiz sunucu parametreleri (ör. eksik uygulama kimliği veya yerleşim kimliği).
102 com.google.ads.uyumlulaştırması.pangle İstenen reklam boyutu, Pangle tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103 com.google.ads.uyumlulaştırması.pangle Eksik veya geçersiz teklif yanıtı.
-1-60000 com.pangle.ads Pangle SDK bir hata döndürdü. Daha fazla ayrıntı için Pangle'ın dokümanlarına bakın.
101 com.google.ads.uyumlulaştırması.pangle Geçersiz sunucu parametreleri (ör. eksik uygulama kimliği veya yerleşim kimliği).
102 com.google.ads.uyumlulaştırması.pangle İstenen reklam boyutu, Pangle tarafından desteklenen bir banner boyutuyla eşleşmiyor.
-1-60000 Pangle SDK tarafından gönderildi Pangle SDK bir hata döndürdü. Daha fazla ayrıntı için Pangle'ın dokümanlarına bakın.

Pangle Android Uyumlulaştırma Adaptör Değişiklik Günlüğü

Sürüm 4.8.0.9.0 (Devam ediyor)

  • Pangle SDK 4.8.0.9 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.3.0 sürümü.
  • Pangle SDK 4.8.0.9 sürümü.

Sürüm 4.8.0.8.0

  • Pangle SDK 4.8.0.8 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.3.0 sürümü.
  • Pangle SDK sürümü 4.8.0.8.

Sürüm 4.8.0.7.0

  • Pangle SDK'nın 4.8.0.7 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.3.0 sürümü.
  • Pangle SDK 4.8.0.7 sürümü.

Sürüm 4.8.0.6.0

  • Pangle SDK'nın 4.8.0.6 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.3.0 sürümü.
  • Pangle SDK 4.8.0.6 sürümü.

Sürüm 4.7.0.7.0

  • Pangle SDK'nın 4.7.0.7 sürümüyle doğrulanmış uyumluluk.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü 21.3.0 olarak güncellendi.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.3.0 sürümü.
  • Pangle SDK sürümü 4.7.0.7.

Sürüm 4.7.0.6.0

  • Pangle SDK 4.7.0.6 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.2.0 sürümü.
  • Pangle SDK 4.7.0.6 sürümü.

Sürüm 4.7.0.5.0

  • Pangle SDK'nın 4.7.0.5 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.2.0 sürümü.
  • Pangle SDK sürümü 4.7.0.5.

Sürüm 4.7.0.3.0

  • Pangle SDK'nın 4.7.0.3 sürümüyle doğrulanmış uyumluluk.
  • Bağdaştırıcı şimdi reklamları yüklemeden önce Pangle SDK'sını ilk kullanıma hazırlamaya çalışıyor.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.2.0 sürümü.
  • Pangle SDK 4.7.0.3 sürümü.

Sürüm 4.6.0.9.0

  • Pangle SDK'nın 4.6.0.9 sürümüyle doğrulanmış uyumluluk.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü 21.2.0 olarak güncellendi.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.2.0 sürümü.
  • Pangle SDK 4.6.0.9 sürümü.

Sürüm 4.5.0.6.1

  • Yerel reklam biçimi için teklif desteği eklendi.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü 21.1.0 olarak güncellendi.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.1.0 sürümü.
  • Pangle SDK 4.5.0.6 sürümü.

Sürüm 4.5.0.6.0

  • Pangle SDK'nın 4.5.0.6 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.0.0 sürümü.
  • Pangle SDK 4.5.0.6 sürümü.

Sürüm 4.5.0.5.0

  • Pangle SDK'nın 4.5.0.5 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.0.0 sürümü.
  • Pangle SDK sürümü 4.5.0.5.

Sürüm 4.5.0.4.0

  • Pangle SDK'nın 4.5.0.4 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.0.0 sürümü.
  • Pangle SDK 4.5.0.4 sürümü.

Sürüm 4.5.0.3.0

  • Pangle SDK'nın 4.5.0.3 sürümüyle doğrulanmış uyumluluk.
  • compileSdkVersion ve targetSdkVersion, API 31 olarak güncellendi.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü 21.0.0 olarak güncellendi.
  • Gereken minimum Android API düzeyi 19 olarak güncellendi.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.0.0 sürümü.
  • Pangle SDK 4.5.0.3 sürümü.

Sürüm 4.3.0.9.0

  • Pangle SDK 4.3.0.9 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 20.6.0 sürümü.
  • Pangle SDK 4.3.0.9 sürümü.

Sürüm 4.3.0.8.0

  • Pangle SDK 4.3.0.8 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 20.6.0 sürümü.
  • Pangle SDK 4.3.0.8 sürümü.

Sürüm 4.3.0.7.0

  • Pangle SDK 4.3.0.7 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 20.6.0 sürümü.
  • Pangle SDK 4.3.0.7 sürümü.

Sürüm 4.3.0.6.0

  • Pangle SDK'nın 4.3.0.6 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 20.6.0 sürümü.
  • Pangle SDK 4.3.0.6 sürümü.

Sürüm 4.3.0.4.0

  • Pangle SDK'nın 4.3.0.4 sürümüyle doğrulanmış uyumluluk.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 20.6.0 sürümü.
  • Pangle SDK 4.3.0.4 sürümü.

Sürüm 4.2.5.3.0

  • İlk sürüm!
  • Banner (MREC dahil), geçiş reklamı ve ödüllü reklam biçimleri için teklifli sistem desteği eklendi.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 20.6.0 sürümü.
  • Pangle SDK 4.2.5.3 sürümü.