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ğiFlutter açıklanmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Entegrasyon
Teklif
Şelale
Formatlar
Uygulama Açma	^{1, 3}
Banner	²
Geçişli
Ödül olarak verildi
Ödüllü Geçiş Reklamı	²

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

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

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

Koşullar

En yeni Google Mobile Ads SDK'sı
Flutter 3.7.0 veya sonraki sürümler
Android'de dağıtmak için
- Android API düzeyi 21 veya üstü
iOS'te dağıtmak için
- 12.0 veya üstü iOS dağıtım hedefi
Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Flutter proje. Ayrıntılar için Başlarken bölümüne bakın.
Uyumlulaştırmayı tamamlayın Başlangıç kılavuzunu

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.

Android

iOS

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

Android

iOS

Uygulama kimliğini not edin.

Android

iOS

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.

Android

iOS

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

Android

Talimatlar için Android kılavuzunun 2. adımına bakın.

iOS

Talimatlar için iOS rehberinin 2. adımına göz atı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 Liftoff Monetize bağdaştırıcısını içe aktarın

pub.dev üzerinden entegrasyon

Aşağıdaki bağımlılığı paketinizin pubspec.yaml dosyasınaLiftoff Monetize SDK ve bağdaştırıcının en son sürümleriyle ekleyin:

dependencies:
  gma_mediation_liftoffmonetize: ^1.0.0

Manuel Entegrasyon

Liftoff Monetize için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü (ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızdaki eklentiye başvurun:

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

4. Adım: Liftoff Monetize SDK'sında gizlilik ayarlarını uygulayın

AB İzni 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 için Google Mobile Ads uyumlulaştırma eklentisinde GmaMediationLiftoffmonetize.setGDPRStatus() yöntemi yer alıyor. Aşağıdaki örnek kod, izin bilgilerinin Vungle SDK'sına nasıl iletileceğini gösterir. Bu yöntemi çağırmayı seçerseniz Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce bu yöntemi çağırmanız önerilir.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");

Daha fazla ayrıntı ve yöntemde sağlanabilen değerler için Android ve iOS için GDPR tarafından önerilen uygulama talimatlarını inceleyin.

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 için Google Mobile Ads uyumlulaştırma eklentisinde GmaMediationLiftoffmonetize.setCCPAStatus() yöntemi yer alıyor. Aşağıdaki örnek kod, izin bilgilerinin Vungle SDK'sına nasıl iletileceğini gösterir. Bu yöntemi çağırmayı seçerseniz Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce bu yöntemi çağırmanız önerilir.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setCCPAStatus(true);

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

5. Adım: Gerekli kodu ekleyin

Android

Liftoff Monetize entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Liftoff Monetize'ın belgelerini 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.

Hata kodları

Bağdaştırıcı, Liftoff Monetize'dan reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

iOS

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:

iOS

Hata kodu	Neden
1-100	Vungle SDK'sı bir hata döndürdü. Daha fazla bilgi için kodu inceleyin.
101	AdMob Kullanıcı arayüzünde yapılandırılan Liftoff Para Kazanma sunucu parametreleri eksik/geçersiz.
102	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	İstenen reklam boyutu, Liftoff Monetize'ın desteklediği banner boyutuyla eşleşmiyor.
104	Vungle SDK'sı banner reklamı oluşturamadı.
105	Vungle SDK'sı, yerleşim kimliğinden bağımsız olarak tek seferde yalnızca 1 banner reklam yüklemeyi destekler.
106	Vungle SDK'sı, reklamın oynatılamadığını söyleyen bir geri çağırma gönderdi.

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

Sürüm 1.0.0

İlk sürüm.
Liftoff Monetize Android adaptörünün 7.3.1.0 sürümüyle doğrulanmış uyumluluk
LiftoffMonetize iOS adaptörü sürüm 7.3.2.0 ile doğrulanmış uyumluluk
Google Mobile Ads Flutter Eklentisi sürüm 5.1.0 ile geliştirildi ve test edilmiştir.