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ü
En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu
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
Android Studio entegrasyonu (önerilir)
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
Yahoo Mobile SDK'sını eklemek için Yahoo Android SDK'sı dokümanlarına bakın.
Google'ın Maven deposunda Yahoo bağdaştırıcısı yapıları'na gidin. En son sürümü seçin, Yahoo bağdaştırıcısının
.aar
dosyasını indirin ve projenize ekleyin.
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.