Yahoo ile Uyumlulaştırma'yı entegre etme

Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma yöntemini kullanarak Yahoo'dan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu kılavuzda, reklam biriminin uyumlulaştırma yapılandırmasına nasıl Yahoo'nun ekleneceği ve Yahoo Mobile SDK'sı ile bağdaştırıcının bir uygulamaya nasıl entegre edileceğiAndroid ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Entegrasyon
Teklif
Şelale
Formatlar
Banner
Geçişli
Ödül olarak verildi
Yerel biçim

Koşullar

  • Android API düzeyi 19 veya üstü

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

Yahoo'nun STP'sine giriş yapın. Uygulamalar ve Siteler altında + düğmesini, ardından Uygulama'yı tıklayın.

Formu doldurun ve uygulamanızı oluşturmak için Yerleşim Ekle ve Kaydet'i tıklayın.

Bir uygulama oluşturduktan sonra, bir Yerleşim oluşturmanız gerekir. Bir Yerleşim Türü seçin, formu doldurun ve Kaydet ve Para Kazan'ı tıklayın.

Yerleşim Kimliğinizi not edin.

Yerleşiminize bir Reklam Kaynağı eklemeniz gerekir. Bir sonraki formda Reklam Kaynağı olarak Yahoo STP'yi seçin ve formu gerekli bilgilerle doldurun. Formu doldurduktan sonra Kaydet'i tıklayın.

Son olarak, Şelale Reklam Kaynakları tablosunun altında oluşturduğunuz Reklam Kaynağı'nı sürükleyerek yerleşiminize ekleyin.

Site Kimliğini not edin.

Test modunu aç

Yahoo reklamları, bir Test Reklam Kaynağı oluşturup bunu yerleşiminizin Şelale Reklam Kaynaklarına ekleyerek test edilebilir. Yerleşim Kimliği ayarlarınıza gidin, Ekle düğmesini tıklayın ve Reklam Kaynağını Test Et'i seçin.

Reklam Kaynağı'nı oluşturduktan sonra, bunu yerleşiminizin Şelale Reklam Kaynakları'na sürükleyin.

İşte bu kadar. Artık Yahoo ile çalışan bir uyumlulaştırma entegrasyonuna sahipsiniz.

2. Adım: Kullanıcı arayüzünde Yahoo talebini Ad Manager oluşturun

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

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

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın.

Getiri grubunuz için benzersiz bir Ad girin, Durum'u Etkin olarak ayarlayın, Reklam Biçimi'ni seçin ve Envanter türü'nü Mobil Uygulama olarak ayarlayın. Hedefleme > Envanter bölümünün altında Envanter ve Mobil uygulama altında uyumlulaştırma eklemek istediğiniz reklam birimini seçin.

Ardından, Getiri iş ortağı ekle düğmesini tıklayın.

Yahoo - App & Display için zaten bir Getiri iş ortağınız varsa bunu seçebilirsiniz. Aksi takdirde, Yeni bir getiri iş ortağı oluştur'u seçin.

Reklam ağı olarak Yahoo - App & Display 'i seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK Uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin. Bir önceki bölümde verilenPlacement ID and Site ID kodunu girin. Ardından, Varsayılan BGBM değerini girin.

İşiniz bittiğinde sayfanın alt kısmındaki Kaydet'i tıklayın.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Yahoo ekle

GDPR ayarları ve ABD eyalet yönetmelikleri ayarları bölümündeki adımları uygulayarak Ad Manager kullanıcı arayüzünde GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Yahoo ekleyin.

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

Aşağıdaki uygulama bağımlılıklarını, Yahoo Ads SDK'sının ve bağdaştırıcının en son sürümleriyle uygulama düzeyindeki build.gradle dosyasına ekleyin:

repositories {
    google()
    mavenCentral()
    maven {
      url 'https://artifactory.yahooinc.com/artifactory/maven/'
    }
}

...
dependencies {
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.gms:play-services-ads:22.6.0'
    implementation 'com.google.ads.mediation:yahoo:1.4.1.1'
}
...

Manuel Entegrasyon

4. Adım: Yahoo SDK'sında gizlilik ayarlarını uygulayın

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını 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 bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Aşağıdaki örnek kod, izin bilgilerinin Yahoo Mobile SDK'ya nasıl iletileceğini gösterir. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce yapmanız önerilir.

Java

import com.yahoo.ads.YASAds;
import com.yahoo.ads.CcpaConsent;

// ...
CcpaConsent ccpaConsent = new CcpaConsent("<CCPA CONSENT>");
YASAds.addConsent(ccpaConsent);

Kotlin

import com.yahoo.ads.YASAds
import com.yahoo.ads.CcpaConsent

// ...
val ccpaConsent = CcpaConsent("<CCPA CONSENT>")
YASAds.addConsent(ccpaConsent)

Daha fazla ayrıntı ve yöntemde sağlanabilecek değerler için Yayıncı Gizlilik Ayarları bölümüne bakın.

5. Adım: Gerekli kodu ekleyin

Yahoo entegrasyonu için ek kod gerekmez.

6. Adım: Uygulamanızı test etme

Test reklamlarını etkinleştir

Ad Manager için test cihazınızı kaydettiğinizden ve Yahoo - App & Display kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.

Test reklamlarını doğrulama

Yahoo - App & Display reklam kaynağından test reklamları aldığınızı doğrulamak için Yahoo (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Yerel reklamları kullanma

Reklam oluşturma

Yahoo bağdaştırıcısı, yerel reklamlarını NativeAd nesne olarak döndürür. Aşağıdaki alanlarını bir NativeAd için doldurur.

Alan Yahoo bağdaştırıcısı tarafından doldurulur
Başlık
Resim
Metin
Uygulama simgesi
Harekete geçirici mesaj
Reklamveren Adı
Yıldızlı değerlendirme
Depolama
Fiyat

Yahoo Android Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü

Sonraki Sürüm

  • Gereken minimum Google Mobile Ads SDK'sı sürümü, 22.4.0 olarak güncellendi.

Sürüm 1.4.1.1

  • Bağdaştırıcı yeni VersionInfo sınıfını kullanacak şekilde güncellendi.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü, 22.0.0 olarak güncellendi.

Aşağıdakilerle geliştirildi ve test edildi:

  • Google Mobile Ads SDK'sı sürüm 22.0.0.
  • Yahoo Mobile SDK'sı 1.4.1.

Sürüm 1.4.1.0

  • Verizon Media bağdaştırıcısının adı "Yahoo" olarak değiştirildi.
  • Bağdaştırıcı yükü ve gösterim hatalarının açıklayıcı hata kodları ve nedenleri eklendi.
  • Yahoo Mobile SDK'sı 1.4.1 sürümü ile doğrulanmış uyumluluk.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü, 21.5.0 olarak güncellendi.

Aşağıdakilerle geliştirildi ve test edildi:

  • Google Mobile Ads SDK'sı sürüm 21.5.0.
  • Yahoo Mobile SDK'sı 1.4.1.