Verve HyBid SDK'sını teklifli sistemle entegre edin

Platform seçin: Android iOS Android (Eski)

Bu kılavuz, teklif entegrasyonlarını kapsayan uyumlulaştırma kullanarak Verve HyBid SDK'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK nasıl kullanacağınızı gösterir. Bu açıklamalar, Verve HyBid SDK'sı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 adaptörü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ümlerin dağıtım hedefi

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

Yapılandırma kurulumu için Verve ile iletişime geçin.

2. adım: Ad Manager kullanıcı arayüzünde Verve HyBid SDK talebini ayarlayın

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

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

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

Teklif isteklerinde güvenli sinyal paylaşma

Envanter > Güvenli Sinyaller'e gidin. Güvenli sinyaller bölümünde Verve HyBid SDK'yı arayın ve Uygulama entegrasyonunu etkinleştir'i açın.

Kaydet'i tıklayın.

SDK teklifli sistemi için güvenli sinyal paylaşımına izin verme

Yayınlama > Talep kanalı ayarları'na gidin. Varsayılan ayarlar sekmesinde, SDK Bidding için Güvenli sinyal paylaşımına izin ver'i etkinleştirin.

Kaydet'i tıklayın.

Verve HyBid SDK teklif sistemini yapılandırma

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi'ne Git'i tıklayın.

Yeni teklif veren'i tıklayın.

Teklif veren olarak Verve Group'u seçin.

Bu teklif veren için SDK Teklif Sistemi özelliğini etkinleştirmek üzere Devam'ı tıklayın.

Bitti'yi tıklayın.

Reklam birimi eşlemesini yapılandırma

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi'ne Git'i tıklayın.

Verve HyBid SDK'sı için şirketi seçin.

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

Belirli 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 alınan Zone ID (Bölge Kimliği) ve AppToken'ı (Uygulama Jetonu) girin.

Ad Manager kullanıcı arayüzünde ödüllü geçiş reklamı için reklam birimi eşlemesini yapılandırıyorsanız Ödüllü biçimini seçin ve ödüllü geçiş reklamı yerleşimi kimliğini kullanın.

Son olarak Kaydet'i tıklayın.

Verve Group'u GDPR ve ABD eyalet tüzükleri reklam iş ortakları listesine ekleme

Ad Manager kullanıcı arayüzünde Verve Group'u 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: Verve HyBid SDK'sını ve bağdaştırıcısını içe aktarın

Swift Package Manager'ı kullanma

Devam etmeden önce desteklenen minimum bağdaştırıcı sürümü olan 3.8.0.0'ı kullanmanız gerekir.

Projenize paket bağımlılığı eklemek için aşağıdaki adımları uygulayın:

  1. Xcode'da File > Add Package Dependencies... (Dosya > Paket Bağımlılıkları Ekle...) seçeneğine gidin.

  2. Görüntülenen istemde aşağıdaki paket URL'sini arayın:

    https://github.com/googleads/googleads-mobile-ios-mediation-verve.git

  3. Bağımlılık Kuralı'nda Şube'yi seçin.

  4. Metin alanına main girin.

CocoaPods'u kullanma

  • Aşağıdaki satırı projenizin Podfile'ına ekleyin:

    pod 'GoogleMobileAdsMediationVerve'

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

    pod install --repo-update

Manuel entegrasyon

  • Verve iOS SDK'sının en son sürümünü indirin ve projenizdeki VerveSDK.framework dosyasını bağlayın.

  • Verve bağdaştırıcısının en son sürümünü Değişiklik Günlüğü'ndeki indirme bağlantısından indirin ve projenizdeki VerveAdapter.framework dosyasını bağlayın.

  • Projenize aşağıdaki çerçeveleri ekleyin:

    • AdSupport
    • AVFoundation
    • CoreGraphics
    • CoreMedia
    • CoreTelephony
    • StoreKit
    • SystemConfiguration
    • UIKit
    • WebKit
    • libz.tbd

4. adım: Verve 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. Google, kullanıcının rıza seçimini bu tür ağlara otomatik olarak iletemez.

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, bir yöntem aracılığıyla gizlilik ayarlarını destekler. Aşağıdaki örnek kod, bu izin bilgilerini Verve HyBid SDK'sına iletir. Verve HyBid SDK'sına izin bilgilerini manuel olarak iletiyorsanız Google Mobile Ads SDK üzerinden reklam isteğinde bulunmadan önce örneği çağırmanız önerilir.

Swift

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)

usPrivacyString yerine ABD gizlilik dizenizi girin.

Objective-C

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];

kUSPrivacyString yerine ABD gizlilik dizenizi girin.

Ayrıntılar için Verve HyBid SDK'sının CCPA Uyumluluğu ile ilgili gizlilik belgelerine bakın.

5. adım: Gerekli kodu ekleyin

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

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

Test reklamlarını doğrulama

Verve HyBid SDK'sından 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'sının belgelerini inceleyin.

Hata kodları

Adaptör Verve HyBid SDK'dan reklam alamıyorsa 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 Neden
100 ila 106 Verve HyBid SDK bir hata döndürdü.
101 Uygulama jetonu eksik.
102 Kullanıcı çocuktur.
103 Verve HyBid SDK başlatılamıyor.
104 Geçersiz reklam yapılandırması.
105 Desteklenmeyen banner boyutu.
106 Tam ekran reklam sunuma hazır değil.
115 Reklam birimi kimliği eksik. Reklam yüklenemiyor.
116 Reklam hazır değil. Reklam görüntülenemiyor.

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

Sürüm 3.9.0.0

  • Minimum Google Mobile Ads iOS SDK sürümü, alt sürümlere izin verecek şekilde 13.3 olarak 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 değeri GADAgeRestrictedTreatmentChild olarak 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ı gidermek için banner boyutu kontrolü adaptörden 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ü.

Sürüm 3.7.1.3

  • 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.0 olarak 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!
  • Teklif banner, geçiş reklamı, ödüllü, ö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ü.