PubMatic'i uyumlulaştırmayla entegre etme

Bu kılavuzda, teklif entegrasyonlarını kapsayan AdMob uyumlulaştırması kullanılarak PubMatic'ten 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, PubMatic'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve PubMatic ile bağdaştırıcının bir iOS uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Şartlar

• 12.0 veya sonraki bir iOS dağıtım hedefi

• 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ın Platform'unu, Uygulama Mağazası URL'sini ve Uygulama Adı'nı seçin.

Entegrasyon yolu bölümünde iOS (Objective-C / Swift)'i seçin 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. Henüz yapmadıysanız uygulamanız için bir app-ads.txt dosyası oluşturun.

Uygulamanız tamamlanmadan önce, app-ads.txt'ünüze eklenecek uygun girişler gösterilir.

PubMatic için app-ads.txt'ün nasıl uygulanacağı hakkında daha fazla bilgi için app-ads.txt'i uygulama 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.

Reklam biriminizin ayrıntılarını girerek formu doldurun ve Kaydet'i tıklayın.

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

Yayıncı kimliğinizi alma

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

PubMatic OpenWrap SDK'sını 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 PubMatic OpenWrap SDK'sını 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:

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

PubMatic'i GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

PubMatic'i AdMob kullanıcı arayüzündeki AB ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için AB tüzüğü ayarlarında ve ABD eyalet düzenlemeleri ayarlarında yer alan adımları uygulayın.

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

CocoaPods (önerilen)

• Projenizin Podfile dosyasına aşağıdaki satırı ekleyin:

  pod 'GoogleMobileAdsMediationPubMatic'
  

• Komut satırından şunu çalıştırın:

  pod install --repo-update

Manuel entegrasyon

1. iOS için PubMatic OpenWrap SDK'sının en son sürümünü indirin ve projenizdeki tüm .xcframework dosyalarını ve paketlerini bağlayın.

2. PubMatic bağdaştırıcının en son sürümünü Değişiklikler Günlüğü'ndeki indirme bağlantısından indirip projenize bağlayınPubMaticAdapter.xcframework.

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

Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.

PubMatic, UMP SDK'sı da dahil olmak üzere Google'ın Ek İzin spesifikasyonunu destekleyen izin yönetim platformları tarafından belirlenen GDPR iznini otomatik olarak okur. Daha fazla bilgi için GDPR ve GDPR iznini geçme başlıklı makaleyi inceleyin.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları, kullanıcılara "kişisel bilgilerinin" "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılar. Bu kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. ABD eyalet gizlilik yasaları uygunluk kılavuzu, Google reklam sunumu 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, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

PubMatic, UMP SDK'sı da dahil olmak üzere Google'ın Ek İzin spesifikasyonunu destekleyen kullanıcı rızası yönetim platformları tarafından belirlenen GPP iznini otomatik olarak okur. Daha fazla bilgi için GPP iznini iletme başlıklı makaleyi inceleyin.

5. adım: Gerekli kodu ekleyin

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için PubMatic'in dokümanlarını inceleyin.

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

Test reklamlarını etkinleştirme

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

Test reklamlarını doğrulama

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

İsteğe bağlı adımlar

Yerel reklamlar

Reklam oluşturma

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

Hata kodları

Bağdaştırıcının PubMatic'ten reklam almaması durumunda aşağıdaki sınıflar altında GADResponseInfo.adNetworkInfoArray kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

GADMediationAdapterPubMatic

Bir reklam yüklenemezse PubMatic bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

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