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'u nasıl ekleyeceğinize 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

LiftoffMonetize hesabınıza kaydolun veya giriş yapın.

Uygulama Ekle düğmesini tıklayarak uygulamanızı Liftoff Monetize hesap özetine ekleyin.

Gerekli tüm ayrıntıları girerek formu doldurun.

Uygulamanız oluşturulduktan sonra Liftoff Monetize Applications gösterge tablosundan uygulamanızı seçin.

Uygulama kimliğini not edin.

Yeni yerleşimler ekleme

Uyumlulaştırma Ad Manager ile kullanılacak yeni bir yerleşim oluşturmak için, Liftoff Monetize Placements kontrol paneline gidin, Yerleşim Ekle düğmesini tıklayın ve açılır listeden uygulamanızı seçin.

Yeni yerleşim eklemeyle ilgili ayrıntılar aşağıda verilmiştir:

Banner

Banner'ı seçin, bir Yerleşim Adı girin ve formun geri kalanını doldurun. [Yalnızca teklif verme] Para kazanma altında Uygulama İçi Teklif Verme anahtarını Etkin durumuna getirin. Yerleşimi oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

300x250 Şerit

MREC'i seçin, bir Yerleşim Adı girin ve formun geri kalanını doldurun. [Yalnızca teklif verme] Para kazanma altında Uygulama İçi Teklif Verme anahtarını Etkin durumuna getirin. Yerleşimi oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

Geçişli

Geçiş reklamı'nı seçin, bir Yerleşim Adı girin ve formun geri kalanını doldurun. [Yalnızca teklif verme] Para kazanma altında Uygulama İçi Teklif Verme anahtarını Etkin durumuna getirin. Yerleşimi oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

Ödül olarak verildi

Ödüllü'yü seçin, bir Yerleşim Adı girin ve formun geri kalanını doldurun. [Yalnızca teklif verme] Para kazanma altında Uygulama İçi Teklif Verme anahtarını Etkin durumuna getirin. Yerleşimi oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

Ödüllü Geçiş Reklamı

Ödüllü'yü seçin. Bir Yerleşim Adı girin, Atlanabilir'i etkinleştirin ve formun geri kalanını doldurun. [Yalnızca teklif verme] Para kazanma altında Uygulama İçi Teklif Verme anahtarını Etkin durumuna getirin. Yerleşimi oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

Yerel biçim

Yerel'i seçin, bir Yerleşim Adı girin ve formun geri kalanını doldurun. [Yalnızca teklif verme] Para kazanma altında Uygulama İçi Teklif Verme anahtarını Etkin durumuna getirin. Yerleşimi oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

Referans Kimliği'ni not edin ve Sounds Good'u tıklayın.

Banner

300x250 Şerit

Geçişli

Ödül olarak verildi

Ödüllü Geçiş Reklamı

Yerel biçim

Raporlama API'sı Anahtarınızı Bulma

Teklif

Bu adım, teklif entegrasyonları için gerekli değildir.

Şelale

Ad Manager reklam birimi kimliğinizi oluşturmak için Uygulama Kimliği ve Referans Kimliği'ne ek olarak Liftoff Monetize Reporting API Key'inize ihtiyacınız olacaktır. Liftoff Monetize Reports kontrol paneline gidin ve Raporlama API'sı Anahtarınızı görüntülemek için Reporting API Anahtarı düğmesini tıklayın.

Test modunu aç

Test reklamlarını etkinleştirmek için Liftoff Monetize kontrol panelinize ve Uygulamalar'a gidin.

Uygulamanızın Yerleşim Referans Kimliği bölümünde test reklamlarını etkinleştirmek istediğiniz uygulamanızı seçin. Test reklamları, Durum bölümünün altında Test Modu'nu Yalnızca test reklamlarını göster'i seçtikten sonra etkinleştirilebilir.

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

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

Şirketlere Liftoff Monetize Ekle

Teklif

Bu adım, teklif entegrasyonları için gerekli değildir.

Şelale

Yönetici > Şirketler'e gidin ve ardından Tüm şirketler sekmesinde Yeni şirket düğmesini tıklayın. Reklam ağı'nı seçin.

Reklam ağı olarak Liftoff Monetize'i seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin. Otomatik veri toplama'yı açın ve önceki bölümde belirtilen Reporting API Key değerini girin.

Kullanıcı adı veya şifre girmenize gerek yoktur. İşlem tamamlandığında Kaydet'i tıklayın.

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

Teklif

Yönetici > Genel ayarlar'a gidin. Ad Exchange hesap ayarları sekmesine gidip Güvenli sinyal paylaşımı'nı inceleyip etkinleştirin. Save'i (Kaydet) tıklayın.

Şelale

Bu adım, şelale entegrasyonları için gerekli değildir.

Teklifli sistemi Liftoff Monetize yapılandırın

Teklif

Yayınlama > Teklif Verenler'e gidin ve SDK Teklifi sekmesinin altında Yeni teklif veren'i tıklayın.

Teklif veren olarak Liftoff Monetize simgesini seçin.

Bu teklif verenin sinyal kitaplığını izin verilen sinyaller listesine ekle ve Sinyallerin bu teklif verenle paylaşılmasına izin ver seçeneklerini açık duruma getirin. Ardından Devam'ı tıklayın.

Devam'ı tıklayın.

Done'ı (Bitti) tıklayın.

Şelale

Bu adım, şelale entegrasyonları için gerekli değildir.

Reklam birimi eşlemesini yapılandır

Teklif

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Verme sekmesi altındaLiftoff Monetize şirketini 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çim seçin, Envanter türü olarak Mobil uygulamayı ve Mobil uygulamanızı seçin. Ardından, bir önceki bölümde aldığınızApplication ID and Placement Reference ID kodunu girin. Son olarak Kaydet'i tıklayın.

Şelale

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın. Mobil uygulamanızı seçin.

Aşağı kaydırın ve Getiri iş ortağı ekle'yi tıklayın.

Önceki bölümde Liftoff Monetize şirket için oluşturduğunuzu seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin.

Önceki bölümde belirtilen Application ID and Placement Reference ID değerini ve Varsayılan BGBM değerini girin. Kaydet'i tıklayın.

Not: Otomatik veri toplama özelliğinin bir uyumlulaştırma ağı için Dinamik BGBM değerini doğru şekilde hesaplayabilmesi için verileri toplaması birkaç gün sürer. eBGBM hesaplandığında sizin adınıza otomatik olarak güncellenir.

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ı
Banner	com.vungle.mediation.VungleInterstitialAdapter
Geçiş reklamı	com.vungle.mediation.VungleInterstitialAdapter
Ödüllü	com.vungle.mediation.VungleAdapter

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
0-100	com.vungle.warren	Vungle SDK'sı hata döndürdü. Dokümana göz atın inceleyebilirsiniz.
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 reklam isteğinde bulunmak için `Activity` bağlamı gerekir.
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.
1-100	Vungle SDK tarafından gönderildi	Vungle SDK'sı hata döndürdü. Kodu inceleyin inceleyebilirsiniz.
101	com.google.mediation.vungle	Kullanıcı arayüzünde yapılandırılan Liftoff Monetize sunucu parametreleri Ad Manager eksik/geçersiz.
102	com.google.mediation.vungle	Bu ağ yapılandırması için zaten bir reklam yüklü. Vungle SDK'sı şunları yapamaz: Aynı yerleşim kimliği için ikinci bir reklam yüklemek.
103	com.google.mediation.vungle	İstenen reklam boyutu, Liftoff Monetize desteklenen banner'ıyla eşleşmiyor seçin.
104	com.google.mediation.vungle	Vungle SDK'sı banner reklamı oluşturamadı.
105	com.google.mediation.vungle	Vungle SDK'sı tek seferde yalnızca 1 banner reklam yüklemeyi destekler. yerleşim kimliğinden bağımsız olarak değiştirilir.
106	com.google.mediation.vungle	Vungle SDK'sı, reklamın oynatılamayacağını belirten bir geri çağırma gönderdi.