GMA Yeni Nesil SDK hakkındaki geri bildiriminizi Google Advertising and Measurement Community sunucusunun #gma-next-gen-sdk Discord kanalında paylaşın.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Verve HyBid SDK'yı arabuluculukla entegre etme

Platform seçin: Android iOS Android (Eski)

Bu kılavuz, teklif entegrasyonlarını kapsayarak AdMob Uyumlulaştırması kullanarak Verve HyBid SDK'sından reklam yüklemek ve göstermek için GMA Next-Gen 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 Android 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	¹
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü geçiş reklamı
Ödüllü
Yerel biçim

¹ 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:

Android API düzeyi 24 veya sonraki sürümler

En yeni GMA Next-Gen SDK sürümü.
AdMob Uyumlulaştırması'nı ayarlayın.

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: AdMob kullanıcı arayüzünde Verve HyBid SDK talebini ayarlayın

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

Verve HyBid 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 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ündeki Teklifli Sistem kartında 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 Zone ID (Bölge Kimliği) ve AppToken'ı (Uygulama Jetonu) girin. Ardından Bitti'yi tıklayın.

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

AdMob kullanıcı arayüzündeki AB ve ABD eyalet tüzükleri reklam iş ortakları listesine Verve Group'u 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

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://verve.jfrog.io/artifactory/verve-gradle-release")
    }
  }
}

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. Verve HyBid 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.3.1")
    implementation("com.google.ads.mediation:verve:3.9.1.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

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, 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 GMA Next-Gen SDK üzerinden reklam isteğinde bulunmadan önce örneği çağırmanız önerilir.

Java

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);VerveMediationSnippets.java

Kotlin

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)VerveMediationSnippets.kt

US_PRIVACY_STRING 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

Verve HyBid SDK 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.

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 ResponseInfo.getAdSourceResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

net.pubnative.lite.sdk
com.google.ads.mediation.verve

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 103	Verve HyBid SDK bir hata döndürdü.
101	İstenen reklam boyutu, Verve HyBid SDK'nın desteklediği bir banner boyutuyla eşleşmiyor.
102	Eksik veya boş uygulama jetonu.
103	Bağlam boş.