Bu kılavuzda, teklifli sistem entegrasyonlarını kapsayan AdMob Uyumlulaştırması'nı kullanarak Verve HyBid SDK'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK ürününün nasıl kullanılacağı açıklanmaktadır. Bu açıklamalar, Verve HyBid SDK'nın bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve Verve HyBid SDK'sının ve bağdaştırıcısının bir iOS uygulamasına nasıl entegre edileceğini kapsar.
Desteklenen entegrasyonlar ve reklam biçimleri
Verve HyBid SDK için uyumlulaştırma bağdaştırıcısının özellikleri şöyledir:
| Entegrasyon | |
|---|---|
| Teklif verme | 1 |
| Şelale | |
| Formatlar | |
| Banner | |
| Geçiş reklamı | |
| Ödüllü geçiş reklamı | |
| Ödüllü | |
| Yerel biçim | |
1 Teklifli sistem entegrasyonu alfa aşamasındadır. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.
Ön koşullar
Devam etmeden önce aşağıdakileri doğrulayın:
- iOS 13.0 veya sonraki sürüm dağıtım hedefi
En yeni Google Mobile Ads SDK sürümü.
1. adım: Verve HyBid SDK kullanıcı arayüzünde yapılandırmaları ayarlayın
Yapılandırma ayarları için Verve ile iletişime geçin.
2. adım: AdMob kullanıcı arayüzünde Verve HyBid SDK talebini ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Reklam biriminizin uyumlulaştırma yapılandırmasına Verve HyBid SDK'yı 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 Verve HyBid 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'ı 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'yi tıklayın.

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

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

Verve HyBid SDK'yı reklam kaynağı olarak ekleme
Reklam Kaynakları bölümünde Teklifli Sistem kartını bulun ve Reklam kaynağı ekle'yi seçin. Ardından Verve HyBid SDK'yı seçin. .
İş ortaklığı sözleşmesi nasıl imzalanır? düğmesini tıklayın ve Verve HyBid SDK ile teklifli sistem iş ortaklığını ayarlayın.
Onayla ve kabul et'e, ardından Devam'ı tıklayın.
Verve HyBid SDK 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 alınan Bölge Kimliği ve AppToken'ı girin. Ardından Bitti'yi tıklayın.
Verve Group'u GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme
Verve Group'u AdMob kullanıcı arayüzündeki 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ümündeki adımları uygulayın.
3. adım: Verve HyBid SDK'sını ve bağdaştırıcısını içe aktarma
Swift Package Manager'ı kullanma
Devam etmeden önce, desteklenen minimum bağdaştırıcı sürümü olan 3.8.0.0'a sahip olmanız gerekir.
Projenize paket bağımlılığı eklemek için aşağıdaki adımları uygulayın:
Xcode'da File (Dosya) > Add Package Dependencies... (Paket Bağımlılıkları Ekle...) bölümüne gidin.
Görüntülenen istemde aşağıdaki paket URL'sini arayın:
https://github.com/googleads/googleads-mobile-ios-mediation-verve.gitBağımlılık Kuralı'nda Dal'ı seçin.
Metin alanına
mainyazın.
CocoaPods'u kullanma
Aşağıdaki satırı projenizin Podfile dosyasına ekleyin:
pod 'GoogleMobileAdsMediationVerve'Komut satırından şu komutu çalıştırın:
pod install --repo-update
Manuel entegrasyon
Verve iOS SDK'sının en yeni sürümünü indirin ve projenizdeki
VerveSDK.frameworkdosyasını bağlayın.Verve bağdaştırıcısının en yeni sürümünü Değişiklik Günlüğü'ndeki indirme bağlantısından indirin ve projenizdeki
VerveAdapter.frameworkdosyasını bağlayın.Projenize aşağıdaki çerçeveleri ekleyin:
AdSupportAVFoundationCoreGraphicsCoreMediaCoreTelephonyStoreKitSystemConfigurationUIKitWebKitlibz.tbd
4. adım: Verve SDK'sındaki gizlilik ayarlarını uygulayın
AB Kullanıcı Rızası ve GDPR
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 ve yasal olarak gerekli olduğu durumlarda çerez veya başka yerel depolama bilgilerinin kullanılmasının yanı sıra, kişisel verilerin reklam kişiselleştirme amacıyla toplanması, paylaşılması ve kullanılması için kullanıcıların iznini 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.
Verve HyBid SDK, UMP SDK dahil olmak üzere kullanıcı rızası yönetim platformları tarafından ayarlanan GDPR iznini otomatik olarak okur. Daha fazla bilgi için GDPR TCF Uyumluluğu 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.
Verve HyBid SDK'sı, bir yöntem aracılığıyla gizlilik ayarlarını destekler. Aşağıdaki örnek kod, bu izin bilgilerini Verve HyBid SDK'ya iletir. İzin bilgilerini Verve HyBid SDK'ya manuel olarak iletiyorsanız Google Mobile Ads SDK üzerinden reklam istemeden önce örneği çağırmanızı öneririz.
Swift
usPrivacyString yerine ABD gizlilik dizesini girin.
Objective-C
kUSPrivacyString yerine ABD gizlilik dizesini girin.
Ayrıntılar için CCPA Uygunluğu ile ilgili Verve HyBid SDK gizlilik belgelerine bakın.
5. adım: Gerekli kodu ekleme
SKAdNetwork'ü uygulama
SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Verve HyBid SDK'nın 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
Verve HyBid SDK'dan test reklamları aldığınızı doğrulamak için Verve (Teklifli Sistem) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
Ek yapılandırma için Verve HyBid SDK'nın belgelerini inceleyin.
Hata kodları
Adaptör Verve HyBid SDK'dan reklam alamazsa yayıncılar aşağıdaki sınıflarda
GADResponseInfo.adNetworkInfoArray
kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:
GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve
Bir reklam yüklenemediğinde Verve HyBid SDK bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:
| Hata kodu | Alan adı | Neden |
|---|---|---|
| 100-106 | Verve HyBid SDK'sı bir hata döndürdü. | |
| 101 | com.google.mediation.verve | Sunucu yapılandırmasında gerekli bir uygulama jetonu eksik. |
| 102 | Kullanıcı bir çocuk. | |
| 103 | com.google.mediation.verve | Verve HyBid SDK'sı başlatılamıyor. |
| 104 | com.google.mediation.verve | Reklam yüklemek için geçersiz reklam yapılandırması. |
| 105 | com.google.mediation.verve | Desteklenmeyen banner boyutu. |
| 106 | com.google.mediation.verve | Tam ekran reklam, sunuma hazır değil. |
| 115 | com.google.mediation.verve | Reklam birimi kimliği eksik. Reklam yüklenemiyor. |
Verve iOS Uyumlulaştırma Adaptörü Değişiklik Günlüğü
Sürüm 3.9.3.0
- HyBid SDK'sının 3.9.3 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 13.11.0 sürümü.
- HyBid SDK'sı 3.9.3 sürümü.
Sürüm 3.9.2.0
- HyBid SDK'sının 3.9.2 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 13.9.0 sürümü.
- HyBid SDK'sı 3.9.2 sürümü.
Sürüm 3.9.1.0
- HyBid SDK'sının 3.9.1 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 13.8.0 sürümü.
- HyBid SDK'sı 3.9.1 sürümü.
Sürüm 3.9.0.0
- Minimum Google Mobile Ads iOS SDK'sı sürümü, alt sürümlere izin vermek için
13.3olarak güncellendi. - HyBid SDK'sının 3.9.0 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 13.6.0 sürümü.
- HyBid SDK'sı 3.9.0 sürümü.
Sürüm 3.8.1.1
- Yeni
ageRestrictedTreatment,GADAgeRestrictedTreatmentChildolarak ayarlandığında Verve SDK için yaş kısıtlamalı istekleri filtreleyin.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 13.4.0 sürümü.
- HyBid SDK'sı 3.8.1 sürümü.
Sürüm 3.8.1.0
- HyBid SDK'sının 3.8.1 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 13.4.0 sürümü.
- HyBid SDK'sı 3.8.1 sürümü.
Sürüm 3.8.0.0
- Sinyal toplama hatalarını ve reklam yükleme hatalarını çözmek için bağdaştırıcıdan banner boyutu kontrolü kaldırıldı.
- HyBid SDK'sının 3.8.0 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 13.2.0 sürümü.
- HyBid SDK'sı 3.8.0 sürümü.
3.7.1.3 sürümü
- Google Mobile Ads SDK'sı bağımlılığı 13.0.0 sürümüne güncellendi.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 13.0.0 sürümü.
- HyBid SDK'sı 3.7.1 sürümü.
Sürüm 3.7.1.2
- CocoaPods minimum iOS sürümü
13.0olarak güncellendi.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 13.0.0 sürümü.
- HyBid SDK'sı 3.7.1 sürümü.
Sürüm 3.7.1.1
- İlk sürüm
- Teklifli sistem banner'ı, geçiş reklamı, ödüllü reklam, ödüllü geçiş reklamı ve doğal reklam biçimlerini destekler.
- HyBid SDK'sının 3.7.1 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.13.0 sürümü.
- HyBid SDK'sı 3.7.1 sürümü.