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

Liftoff Monetize'ı Uyumlulaştırma ile Entegre Etme

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 AdMob Uyumlulaştırması, 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 iOS 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	. ^{1, 3}
Banner	²
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı	²
Yerel biçim	²

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

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

³ Şelale bu biçim için entegrasyonu kapalı beta sürümündedir.

Şartlar

12.0 veya sonraki bir iOS dağıtım hedefi
[Teklif verme için]: Liftoff Monetize adaptör 6.11.0.1 veya sonraki sürümler (en son sürüm önerilir)

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

Uygulama Açma

Geçiş Reklamı'nı seçin ve bir Yerleşim Adı girin. Ardından, Atlanabilir için Evet'i seçin 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.

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.

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.

Uygulama Açma

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

AdMob 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 AdMob

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

Reklam biriminizin uyumlulaştırma yapılandırmasına Liftoff Monetize 'ı eklemeniz gerekiyor.

İlk olarak, 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 grubunu düzenlemek için grubun adını tıklayın ve Reklam kaynağı olarak Liftoff Monetize ekle bölümüne atlayın.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.

Reklam biçimini 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 bir veya daha fazla AdMob reklam biriminizle ilişkilendirin. Ardından Bitti'yi tıklayın.

Şimdi, seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını görmeniz gerekir:

Reklam kaynağı olarak Liftoff Monetize ekleyin

Teklif

Reklam Kaynakları bölümündeki Teklif Verme kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından Liftoff Monetize simgesini seçin.

İş ortaklığı sözleşmesi imzalama'yı tıklayın veLiftoff Monetizeile teklifli sistem iş ortaklığı kurun.

Onayla ve kabul et'i, ardından Devam'ı tıklayın.

Liftoff Monetizeiçin zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.

Sonra, önceki bölümde aldığınız Application ID and Placement Reference ID kodunu girin. Ardından Bitti'yi tıklayın.

Önemli: Application ID , kullanıcı arayüzünde olduğu gibi hedeflenen uygulamayla ilişkilendirilmelidir.Liftoff Monetize

Şelale

Reklam Kaynakları bölümündeki Şelale kartının altından Reklam Kaynağı Ekle'yi seçin. Ardından Liftoff Monetize simgesini seçin.

Liftoff Monetize'i seçin ve Optimize et anahtarını etkinleştirin.Liftoff Monetizeiçin reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde belirtilen Reporting API Keydeğerini girin. ArdındanLiftoff Monetize için bir eBGBM değeri girip Devam'ı tıklayın.

Liftoff Monetizeiçin zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.

Sonra, önceki bölümde aldığınız Application ID and Placement Reference ID kodunu girin. Ardından Bitti'yi tıklayın.

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

GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob 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

CocoaPods'u kullanma (önerilir)

Projenizin Podfile'ına aşağıdaki satırı ekleyin:
```
pod 'GoogleMobileAdsMediationVungle'
```
Komut satırında şu komutu çalıştırın:
```
pod install --repo-update
```

Manuel entegrasyon

Vungle SDK'sının en son sürümünü indirin ve VungleSDK.framework adlı projeyi projenize bağlayın.
Liftoff Monetize bağdaştırıcısının en son sürümünü şuradan indirin: Değişiklik günlüğündeki indirme bağlantısı ve LiftoffMonetizeAdapter.framework adlı projeyi projenize bağlayın.
Projenize aşağıdaki Çerçeveleri ekleyin:
- AdSupport
- AudioToolbox
- AVFoundation
- CFNetwork
- CoreGraphics
- CoreMedia
- libz.tbd
- MediaPlayer
- QuartzCore
- StoreKit
- SystemConfiguration

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.

Swift

import VungleAdsSDK
// ...

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

Objective-C

#import <VungleAdsSDK/VungleAdsSDK.h>
// ...

[VunglePrivacySettings setGDPRStatus:YES];
[VunglePrivacySettings setGDPRMessageVersion:@"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.

Swift

import VungleAdsSDK
// ...

VunglePrivacySettings.setCCPAStatus(true)

Objective-C

#import <VungleAdsSDK/VungleAdsSDK.h>
// ...

[VunglePrivacySettings setCCPAStatus:YES];

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

5. Adım: Gerekli kodu ekleyin

SKAdNetwork entegrasyonu

Liftoff Monetize'ın belgelerindeki talimatları uygulayın. kullanarak projenizin Info.plist dosyasına SKAdNetwork tanımlayıcılarını ekleyin.

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

Test reklamlarını etkinleştir

AdMob 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ı, bunu yapabilmek için ek bir istek parametresini destekler. VungleAdNetworkExtras sınıfı kullanılarak bağdaştırıcıya geçirilir. Bu sınıf aşağıdaki özellikleri içerir:

userId: Liftoff Monetize'ın Teşvik Edilmiş Kullanıcı Kimliğini temsil eden bir dize.
nativeAdOptionPosition: Doğal reklamlar için gizlilik simgesi konumunu 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:

Swift

#import "VungleAdapter.h"
// ...

let request = GADRequest()
let extras = VungleAdNetworkExtras()
extras.userId = "myUserID"
extras.nativeAdOptionPosition = 1
// ...
request.register(extras)

Objective-C

#import <LiftoffMonetizeAdapter/VungleAdapter.h>
// ...

GADRequest *request = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.userId = @"myUserID";
extras.nativeAdOptionPosition = 1;
// ...
[request registerAdNetworkExtras:extras];

Yerel reklam oluşturma

Liftoff Monetize bağdaştırıcısı, yerel reklamlarını GADNativeAd nesneler'i tıklayın. Aşağıdakileri doldurur . doğal reklamlar alanı açıklamaları - . GADNativeAd.

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ı, GADMediaView 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 GADResponseInfo.adNetworkInfoArray şu sınıflarda:

Biçim	Sınıf adı
Banner	GADMAdapterVungleInterstitial
Geçiş reklamı	GADMAdapterVungleInterstitial
Ödüllü	GADMAdapterVungleÖdül Tabanlı VideoReklam

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 AdMob 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, 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.