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

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

Bu kılavuzda, hem teklifli sistem hem de şelale entegrasyonlarını kapsayan uyumlulaştırma yöntemini kullanarak Liftoff Monetize'dan reklamları yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, Liftoff Monetize'ın reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Vungle SDK ile bağdaştırıcısının bir uygulamaya nasıl entegre edileceğiiOS açıklanmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Liftoff Monetize için AdMob 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
Ödüllü Geçiş Reklamı	^{1, 2}
Yerel biçim	¹

¹ Bu biçim için teklif entegrasyonu açık beta sürümündedir.

² Ödüllü geçiş reklamı kurulum için yardım gerektirir. Liftoff Monetize'dan veya monetize@liftoff.io adresinden hesap yöneticinizle iletişime geçebilirsiniz.

Koşullar

12.0 veya üstü iOS dağıtım hedefi
[Teklifli sistem için]: Liftoff Monetize adaptörü 6.11.0.1 veya sonraki sürümleri (en son sürüm önerilir)

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu

1. Adım: Liftoff Para Kazanma 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:

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.

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 Reporting API Anahtarı düğmesini tıklayarak Raporlama API'sı Anahtarınızı görüntüleyin.

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 Para Kazanma talebi özelliğini AdMob ayarlayın

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 ekle

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 kullanma (önerilir)

Projenizin Podfile dosyasına aşağıdaki satırı ekleyin:
```
pod 'GoogleMobileAdsMediationVungle'
```
Komut satırından ş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 projenizde VungleSDK.framework bağlantısını bağlayın.
Changelog'daki indirme bağlantısından Liftoff Monetize adaptörünün en son sürümünü indirip projenize LiftoffMonetizeAdapter.framework 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'sında gizlilik ayarlarını uygulayın

AB kullanıcı rızası alma ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken, uyumlulaştırma zincirinizde kişisel verileri toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

Liftoff Monetize, SDK 6.3.2 sürümünde Vungle SDK'sına izin vermenizi sağlayan bir API ekledi. Aşağıdaki örnek kod, bu izin bilgilerinin Vungle SDK'sına nasıl iletileceğini göstermektedir. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce yapmanız önerilir.

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"];

Daha fazla ayrıntı ve yöntemde sağlanabilen değerler için GDPR önerilen uygulama talimatlarına bakı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.

Liftoff Monetize, SDK 6.7.0 sürümünde Vungle SDK'sına izin vermenizi sağlayan bir API ekledi. Aşağıdaki örnek kod, bu izin bilgilerinin Vungle SDK'sına nasıl iletileceğini göstermektedir. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce yapmanız önerilir.

Swift

import VungleAdsSDK
// ...

VunglePrivacySettings.setCCPAStatus(true)

Objective-C

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

[VunglePrivacySettings setCCPAStatus:YES];

Daha fazla ayrıntı ve yöntemde sağlanabilecek değerler için CCPA önerilen uygulama talimatlarını inceleyin.

5. Adım: Gerekli kodu ekleyin

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Liftoff Monetize'ın belgelerindeki talimatları uygulayın.

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

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 özgü parametreler

Liftoff Monetize adaptörü, VungleAdNetworkExtras sınıfı kullanılarak bağdaştırıcıya aktarılabilen ek bir istek parametresini destekler. 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: Yerel reklamların gizlilik simgesi konumunu belirten tam sayı.

Aşağıda, bu parametreleri ayarlayan bir reklam isteğini nasıl oluşturacağınıza dair bir kod örneği verilmiştir:

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 adaptörü, yerel reklamlarını GADNativeAd nesne olarak döndürüyor. Bir GADNativeAd

Alan	Öğeler her zaman Liftoff Monetize adaptörü tarafından 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

¹ Liftoff Monetize adaptörü, yerel reklamların ana resim öğesine doğrudan erişim sağlamaz. Bağdaştırıcı, GADMediaView alanını bir video veya resimle doldurur.

Hata kodları

Bağdaştırıcı, Liftoff Monetize'dan reklam alamazsa yayıncılar aşağıdaki sınıfların altında GADResponseInfo.adNetworkInfoArray öğesini kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

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

Bir reklam yüklenemediğinde Liftoff Monetize bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajlar aşağıda verilmiştir:

Hata kodu	Alan	Neden
0-100	com.vungle.warren	Vungle SDK'sı bir hata döndürdü. Daha fazla bilgi için belgeye bakın.
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 boyutuyla eşleşmiyor.
103	com.google.ads.mediation.vungle	Liftoff Monetize'ın reklam isteği gönderebilmesi için `Activity` bağlam bilgisi gerekir.
104	com.google.ads.mediation.vungle	Vungle SDK'sı, aynı yerleşim kimliği için birden fazla reklam yükleyemez.
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() boş değer 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ı bir hata döndürdü. Daha fazla bilgi için kodu inceleyin.
101	com.google.mediation.vungle	AdMob Kullanıcı arayüzünde yapılandırılan Liftoff Para Kazanma sunucu parametreleri eksik/geçersiz.
102	com.google.mediation.vungle	Bu ağ yapılandırması için zaten bir reklam yüklendi. Vungle SDK'sı, aynı yerleşim kimliği için ikinci bir reklam yükleyemez.
103	com.google.mediation.vungle	İstenen reklam boyutu, Liftoff Monetize'ın desteklediği banner boyutuyla eşleşmiyor.
104	com.google.mediation.vungle	Vungle SDK'sı banner reklamı oluşturamadı.
105	com.google.mediation.vungle	Vungle SDK'sı, yerleşim kimliğinden bağımsız olarak tek seferde yalnızca 1 banner reklam yüklemeyi destekler.
106	com.google.mediation.vungle	Vungle SDK'sı, reklamın oynatılamadığını söyleyen bir geri çağırma gönderdi.

Liftoff Para Kazanma iOS Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü