Bu sayfa, Cloud Translation API ile çevrilmiştir.

Artışla Para Kazanmayı Uyumlulaştırma ile Entegrasyon

Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl Liftoff Monetize'daki reklamları kullanarak uyumlulaştırma, hem teklifli sistem hem de şelale entegrasyonlarını kapsar. Liftoff'un nasıl ekleneceği ve Bir reklam biriminin uyumlulaştırma yapılandırmasından para kazanma ve Vungle SDK'sı ve bağdaştırıcısını bir uygulamaya Android dönüştürün.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Entegrasyon
Teklif verme	¹
Şelale
Formatlar
Uygulama Açma
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı	³
Yerel biçim	²

¹ Teklif entegrasyonu açık beta sürümündedir.

² Teklifli sistem bu biçim için entegrasyonu kapalı beta sürümündedir.

³ Ödüllü Geçiş reklamı, kurulum için yardım gerektirir. Hesabınıza ulaşın Liftoff Monetize'da yöneticiyim.monetize@liftoff.io

Şartlar

Android API düzeyi 21 veya üstü

En son Google Mobile Ads SDK'sı
Arabuluculuğu tamamlama Başlangıç kılavuzu

1. adım: Liftoff Monetize kullanıcı arayüzünde yapılandırmaları ayarlayın

2. adım: Kullanıcı arayüzünde Liftoff Monetize talebini ayarlayın Ad Manager

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Liftoff ekleyin

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 Liftoff ekleyin.

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

Android Studio entegrasyonu (önerilir)

Uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulamayı ekleyin ve yapılandırmaları içerir. Vungle SDK'sının en son sürümlerini kullanın ve adaptör:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:vungle:7.4.0.1")
}

Manuel entegrasyon

Vungle Android SDK'nın en son sürümünü indirin ve libs klasörünün altındaki .jar dosyalarını çıkartıp belirler.
Liftoff Monetize bağdaştırıcı yapıları'na gidin Google'ın Maven deposunda. En son sürümü seçin, Vungle'ı indirin bağdaştırıcının .aar dosyasını seçin ve bu dosyayı projenize ekleyin.

4. adım: Liftoff Monetize SDK'da gizlilik ayarlarını uygulayın

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.

Liftoff Monetize'da, Vungle SDK'ya izni iletmenizi sağlayan bir API var. Aşağıdaki örnek kod, bu izin bilgilerinin Vungle SDK'sı. Bu yöntemi çağırmayı seçerseniz bunu yapmanız önerilir Google Mobile Ads SDK'sı üzerinden reklam isteğinde bulunmadan önce.

Java

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

GDPR tarafından önerilen uygulama talimatlarını inceleyin 'na bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.

Java

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setCCPAStatus(true)

CCPA uygulama bölümünü inceleyin 'na bakın.

5. Adım: Gerekli kodu ekleyin

Liftoff Monetize entegrasyonu için ek koda gerek yoktur.

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

Test reklamlarını etkinleştir

Ad Manager için test cihazınızı kaydettiğinizden ve Liftoff Monetize kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.

Test reklamlarını doğrulama

Liftoff Monetizereklam kaynağından test reklamları aldığınızı doğrulamak için Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özel parametreler

Liftoff Monetize bağdaştırıcısı aşağıdaki ek isteği destekler bağdaştırıcıya geçirilebilecek parametreler:

userId: Liftoff Monetize'ın Teşvik Edilmiş Kullanıcı Kimliğini temsil eden bir dize.
adOrientation: Tam ekran reklamların sunu yönünü belirten bir tam sayı.

Bu parametreleri ayarlayan bir reklam isteğinin nasıl oluşturulacağına ilişkin kod örneğini aşağıda bulabilirsiniz:

Java

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build();

Kotlin

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build()

Yerel reklam oluşturma

Liftoff Monetize bağdaştırıcısı, yerel reklamlarını . NativeAd nesneler'i tıklayın. Aşağıdakileri doldurur alanlar - NativeAd.

Alan	Öğeler her zaman Liftoff Monetize bağdaştırıcısına dahil edilir
Başlık
Resim	1
Medya görüntüleme
Metin
Uygulama simgesi
Harekete geçirici mesaj
Yıldızlı değerlendirme
Depolama
Fiyat

¹ The Liftoff Monetize bağdaştırıcısı, yerel için ana resim öğesine doğrudan erişim sağlamaz reklam. Bunun yerine, bağdaştırıcı, . MediaView bunu kolayca yapabilirsiniz.

Hata kodları

Bağdaştırıcı, Liftoff Monetize'dan reklam alamazsa yayıncılar reklam yanıtındaki temel hatayı kontrol etmek için ResponseInfo.getAdapterResponses() şu sınıflarda:

Biçim	Sınıf adı
Uygulama Açılışı (Teklifli Sistem)	com.google.ads.mediation.vungle.VungleMediationAdapter
Uygulama Açılışı (Şelale)	com.google.ads.mediation.vungle.VungleMediationAdapter
Banner (Teklifli Sistem)	com.google.ads.mediation.vungle.VungleMediationAdapter
Banner (Şelale)	com.vungle.mediation.VungleInterstitialAdapter
Geçiş reklamı (Teklifli sistem)	com.google.ads.mediation.vungle.VungleMediationAdapter
Geçiş Reklamı (Şelale)	com.vungle.mediation.VungleInterstitialAdapter
Ödüllü (Teklifli Sistem)	com.google.ads.mediation.vungle.VungleMediationAdapter
Ödüllü (Şelale)	com.vungle.mediation.VungleAdapter
Ödüllü Geçiş Reklamı (Teklifli Sistem)	com.google.ads.mediation.vungle.VungleMediationAdapter
Ödüllü Geçiş Reklamı (Şelale)	com.google.ads.mediation.vungle.VungleMediationAdapter
Yerel (Teklifli sistem)	com.google.ads.mediation.vungle.VungleMediationAdapter
Yerel (Şelale)	com.google.ads.mediation.vungle.VungleMediationAdapter

Liftoff Monetize tarafından oluşturulan kodlar ve beraberindeki mesajlar bağdaştırıcısını kontrol etmek için aşağıdaki adımları uygulayın:

Hata kodu	Alan	Neden
101	com.google.ads.mediation.vungle	Geçersiz sunucu parametreleri (ör. uygulama kimliği veya yerleşim kimliği).
102	com.google.ads.mediation.vungle	İstenen banner boyutu geçerli bir Liftoff Monetize reklamıyla eşleşmiyor seçin.
103	com.google.ads.mediation.vungle	Liftoff Monetize'da istekte bulunmak için `Activity`bağlam gerekir reklam.
104	com.google.ads.mediation.vungle	Vungle SDK'sı aynı yerleşim için birden fazla reklam yükleyemez Kimlik.
105	com.google.ads.mediation.vungle	Vungle SDK'sı başlatılamadı.
106	com.google.ads.mediation.vungle	Vungle SDK'sı başarılı bir yükleme geri çağırması döndürdü, ancak Banners.getBanner() veya Vungle.getNativeAd() null döndürdü.
107	com.google.ads.mediation.vungle	Vungle SDK'sı reklamı oynatmaya hazır değil.
108	com.google.ads.mediation.vungle	Vungle SDK'sı geçersiz teklif jetonu döndürdü.

Vungle SDK'sından gelen hatalar için Hata Kodları: iOS ve Android için Vungle SDK bölümüne bakın.