PubMatic'i uyumlulaştırmayla entegre etme

Bu kılavuz, teklif entegrasyonlarını kapsayarak AdMob uyumlulaştırması'nı kullanarak PubMatic'ten reklam yüklemek ve göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağını gösterir. Bu açıklamalar, PubMatic'in bir reklam biriminin uyumlaştırma yapılandırmasına nasıl ekleneceğini ve PubMatic'in ve bağdaştırıcısının bir Android uygulamasına nasıl entegre edileceğini kapsar.

Desteklenen entegrasyonlar ve reklam biçimleri

PubMatic için uyumlaştırma adaptörünün özellikleri şöyledir:

Entegrasyon
Teklifli sistem
Şelale
Formatlar
Uygulama açılışı
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
Doğal

Şartlar

• Android API düzeyi 23 veya üstü

• En son Google Mobile Ads SDK'sı.

• Uyumlulaştırma Başlangıç Kılavuzunu tamamlayın.

1. adım: PubMatic kullanıcı arayüzünde yapılandırmaları ayarlayın

PubMatic hesabınıza giriş yapın ve OpenWrap SDK kartını seçin.

Yeni uygulama ekleme

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

Uygulamanız için Platform'un yanı sıra App Store URL'si ve Uygulama Adı'nı seçin.

Entegrasyon Yolu bölümünde Android (Java / Kotlin)'i ve Alt Entegrasyon Yolu olarak AdMob - SDK Teklifli Sistemi'ni seçin. Ardından Uygulama Ekle düğmesini tıklayın.

app-ads.txt dosyanızı güncelleme

Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt dosyası uygulamanız gerekir. Bunu henüz yapmadıysanız uygulamanız için bir app-ads.txt dosyası oluşturun.

Uygulamanız tamamlanmadan önce, app-ads.txt bölümüne eklemeniz için uygun girişler gösterilir.

PubMatic için app-ads.txt nasıl uygulanacağı hakkında daha fazla bilgi edinmek istiyorsanız app-ads.txt Nasıl Uygulanır? başlıklı makaleyi inceleyin.

Profil Kimliği

Uygulamanız oluşturulduktan sonra Uygulamalar sekmesine gidin ve yeni oluşturulan uygulamanızın Profil Kimliği'ni not edin.

Reklam birimi oluşturun

Reklam Birimleri sekmesinde, önceki bölümde oluşturduğunuz uygulamayı seçin ve Reklam Birimi Oluştur düğmesini tıklayın.

Formu reklam biriminizin ayrıntılarıyla doldurun ve Kaydet'i tıklayın.

Yeni oluşturduğunuz OpenWrap reklam birimi kimliğinizi not edin.

Yayıncı kimliğinizi edinme

Analytics kontrol paneline gidin. Fareyle profil simgesinin üzerine gelip kimliğinizi not edin.

2. adım: AdMob kullanıcı arayüzünde PubMatic talebini ayarlayın

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

Reklam biriminizin uyumlulaştırma yapılandırmasına PubMatic OpenWrap SDK'sını 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 bu uyumlulaştırma grubunun adını tıklayarak düzenleyin ve PubMatic OpenWrap SDK'yı 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'a 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 Birimleri Ekle'ye tıklayın.

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

Artık seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını göreceksiniz:

PubMatic OpenWrap SDK'sını reklam kaynağı olarak ekleme

Reklam Kaynakları bölümündeki Teklifli Sistem kartında Reklam kaynağı ekle'yi seçin. Ardından PubMatic OpenWrap SDK'yı seçin. .

İş ortaklığı sözleşmesi nasıl imzalanır? düğmesini tıklayın ve PubMatic OpenWrap SDK ile teklifli sistem iş ortaklığını ayarlayın.



Onayla ve kabul et'e, ardından Devam'a tıklayın.



PubMatic OpenWrap SDK için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde, Eşleme ekle'ye tıklayın.



Ardından, önceki bölümde alınan OpenWrap Reklam Birimi Kimliği'ni girin. Ardından Bitti'ye tıklayın.

Önemli: OpenWrap Yayıncı Kimliği ve OpenWrap Profil Kimliği, PubMatic OpenWrap SDK kullanıcı arayüzünde olduğu gibi hedeflenen uygulamayla ilişkilendirilmelidir.

PubMatic'i GDPR ve ABD eyalet yönetmelikleri reklam iş ortakları listesine ekleme

Önemli: AB Kullanıcı Rızası ve GDPR, ABD Eyalet yönetmelikleri ve Kullanıcı Mesajlaşma Platformu'nun yapılandırmasını tamamlamak için Hesap Yönetimi izninizin olduğunu doğrulayın. Ayrıntılar için Hesabınıza kullanıcı erişimini yönetme bölümünü inceleyin.

AdMob kullanıcı arayüzünde PubMatic'i AB ve ABD eyalet tüzükleri reklam iş ortakları listesine eklemek için AB tüzükleri ayarları ve ABD eyalet tüzükleri ayarları bölümlerindeki adımları uygulayın.

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

Not: Uyumlu PubMatic ve Google Mobile Ads SDK'sı sürümlerinin entegre edilmemesi derleme sorunlarına yol açabilir.

Android Studio entegrasyonu (önerilir)

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://repo.pubmatic.com/artifactory/public-repos")
    }
  }
}

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.7.0")
    implementation("com.google.ads.mediation:pubmatic:4.9.1.0")
}

4. adım: PubMatic SDK'sındaki gizlilik ayarlarını uygulayın

Google AB Kullanıcı Rızası Politikası'na uymak için Avrupa Ekonomik Alanı (AEA), Birleşik Krallık ve İsviçre'deki kullanıcılarınıza belirli açıklamalar yapmanız, yasal olarak gerekli olduğunda çerezlerin veya diğer yerel depolama alanlarının kullanımı ve reklam kişiselleştirme için kişisel verilerin toplanması, paylaşılması ve kullanılması konusunda kullanıcıların rızasını almanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. Uyumlulaştırma zincirinizdeki her reklam kaynağına rıza bilgisinin iletildiğini doğrulamak sizin sorumluluğunuzdadır.

PubMatic, Google'ın Ek İzin spesifikasyonunu destekleyen kullanıcı rızası yönetim platformları tarafından ayarlanan GDPR iznini otomatik olarak okur. Bu platformlar arasında UMP SDK da yer alır. Daha fazla bilgi için GDPR ve GDPR izni bölümünü inceleyin.

ABD eyalet gizlilik yasaları

ABD eyaletlerindeki gizlilik yasaları, kullanıcılara "kişisel bilgilerinin" "satışının" (yasaların bu terimleri tanımladığı biçimiyle) kapsamı dışında kalma hakkı tanınmasını zorunlu kılar. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde gösterilen "Kişisel Bilgilerimi Satma" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına uygunluk rehberi, Google reklamları sunmak için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar ancak Google bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, uyumluluğu sağlamak için, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilecek tüm reklam ağlarını belirlemeli ve bu ağların her birinden gelen yönergeleri uygulamanız gerekir.

PubMatic, UMP SDK dahil olmak üzere Google'ın Ek İzin spesifikasyonunu destekleyen izin yönetimi platformları tarafından ayarlanan GPP iznini otomatik olarak okur. Daha fazla bilgi için GPP iznini iletme başlıklı makaleyi inceleyin.

5. adım: Gerekli kodu ekleyin

PubMatic entegrasyonu için ek kod gerekmez.

6. adım: Uygulamanızı test edin

Test reklamlarını etkinleştirme

AdMob için test cihazınızı kaydettiğinizden emin olun.

Önemli: Uygulamanızı yayınlamadan önce AdMob ve PubMatic OpenWrap SDK'da test modunu devre dışı bırakın.

Test reklamlarını doğrulama

PubMatic OpenWrap SDK'sından test reklamları aldığınızı doğrulamak için PubMatic (Teklifli Sistem) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe Bağlı Adımlar

Doğal reklamlar

Reklam oluşturma

PubMatic bağdaştırıcısı, doğal reklamlarını NativeAd nesneleri olarak döndürür. NativeAd için aşağıdaki alanları doldurur.

Alan	PubMatic adaptörü tarafından her zaman dahil edilen öğeler
Başlık
Resim
Metin
Simge
Harekete geçirici mesaj
Yıldız puanı
Mağaza
Fiyat
Reklamveren

Hata kodları

Adaptör PubMatic'ten reklam alamıyorsa aşağıdaki sınıflarda ResponseInfo.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

Bir reklam yüklenemediğinde PubMatic bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

Hata kodu	Alan adı	Neden
101	com.google.ads.mediation.pubmatic	Sunucu yapılandırmasında gerekli bir yayıncı kimliği eksik.
102	com.google.ads.mediation.pubmatic	Reklam yüklemek için geçersiz reklam yapılandırması.
103	com.google.ads.mediation.pubmatic	Reklam hazır olmadığı için reklam sunulamadı.
1001-5002	PubMatic SDK'sı tarafından gönderildi	PubMatic SDK bir hata döndürdü. Daha fazla ayrıntı için PubMatic'in belgelerini inceleyin.

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

Sürüm 4.9.1.0

• Pubmatic SDK 4.9.1 ile uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.6.0 sürümü.
• Pubmatic SDK sürümü 4.9.1

Sürüm 4.8.0.1

• Şelale geçiş reklamları için destek ekler.
• Şelale ödüllü reklamları için destek ekler.
• Şelale banner reklamları için destek eklenir.
• Şelale yerel reklamları için destek eklenir.
• Pubmatic SDK'sının 4.8.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.6.0 sürümü.
• Pubmatic SDK'sı 4.8.0 sürümü

Sürüm 4.8.0.0

• Pubmatic SDK'sının 4.8.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.4.0 sürümü.
• Pubmatic SDK'sı 4.8.0 sürümü.

Sürüm 4.7.1.1

• Reklam Seçenekleri simgesinin sabit boyutu

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.4.0 sürümü.
• Pubmatic SDK sürümü 4.7.1.

Sürüm 4.7.1.0

• Pubmatic SDK 4.7.1 ile uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.4.0 sürümü.
• Pubmatic SDK sürümü 4.7.1.

Sürüm 4.7.0.1

• İç bağımlılıklar düzeltildi.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.4.0 sürümü.
• Pubmatic SDK'sı 4.7.0 sürümü.

Sürüm 4.7.0.0

• İlk sürüm.
• Banner, geçiş reklamı, ödüllü reklam ve doğal reklam biçimleri için teklif desteği eklendi.
• Pubmatic SDK 4.7.0 ile uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.4.0 sürümü.
• Pubmatic SDK'sı 4.7.0 sürümü.