AppLovin'i uyumlulaştırma ile entegre etme

Bu kılavuzda, hem teklifli sistem hem de şelale entegrasyonlarını kapsayan arabuluculuk kullanarak AppLovin'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, AppLovin'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve AppLovin SDK'sının ve bağdaştırıcının bir uygulamaya nasıl entegre edileceği ele alınmaktadır. Flutter

Desteklenen entegrasyonlar ve reklam biçimleri

AppLovin için AdMob uyumlulaştırıcı adaptör aşağıdaki özelliklere sahiptir:

¹ Banner reklamlar (MREC banner'ları hariç) yalnızca uyumlulaştırmada desteklenir. Teklifli sistem, hiçbir banner reklam türünü desteklemez.

Şartlar

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

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

AppLovin hesabınıza kaydolun veya oturum açın.

AdMob reklam biriminizi ayarlamak için AppLovin SDK Anahtarınız ve Rapor Anahtarınız gerekir. Bu değerleri bulmak için AppLovin kullanıcı arayüzü > Hesap > Anahtarlar'a gidin ve her iki değeri de görün.

Yalnızca teklifli sistemi entegre etmeyi planlıyorsanız uyumlulaştırma ayarlarınızı yapılandırmaya geçebilirsiniz.

Uyumlulaştırma için uygulama seçme

Alt bölge oluştur

Test modunu etkinleştirme

AppLovin test reklamlarını etkinleştirmeyle ilgili olarak AppLovin'in MAX Test Modu kılavuzundaki talimatları uygulayın.

2. Adım: AppLovin talebini AdMob kullanıcı arayüzünde ayarlayın

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

AppLovin Corp.'u GDPR ve ABD eyalet yönetmelikleri reklam iş ortakları listesine ekleme

AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Applovin Corp.'u eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki adımları uygulayın.

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

pub.dev üzerinden entegrasyon

Paketinizin pubspec.yaml dosyasına Applovin SDK'sının ve bağdaştırıcının en son sürümleriyle aşağıdaki bağımlılığı ekleyin:

dependencies:
  gma_mediation_applovin: ^1.0.0

Manuel Entegrasyon

Applovin için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı ayıklayı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 referans verin:

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

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

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.

izin dizesini paylaşılan tercihlere yazan bir CMP kullanmıyorsanız GmaMediationApplovin.setHasUserConsent() ve GmaMediationApplovin.setIsAgeRestrictedUser() yöntemlerini kullanabilirsiniz. Aşağıdaki örnek kodda, izin bilgilerinin AppLovin SDK'sına nasıl iletileceği gösterilmektedir. Bu seçeneklerin AppLovin SDK'sına doğru şekilde yönlendirilmesini sağlamak için Google Mobile Ads SDK'sını başlatmadan önce ayarlanması gerekir.

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

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);

Daha fazla bilgi için AppLovin'in gizlilik ayarlarına göz atın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, kişisel bilgilerinin "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılıyor. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. ABD eyalet gizlilik yasaları uygunluk kılavuzu, Google reklam sunumu 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 bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

AppLovin için Google Mobile Ads uyumlulaştırıcı eklentisinin GmaMediationApplovin.setDoNotSell() yöntemini içerir. Aşağıdaki örnek kodda, izin bilgilerinin AppLovin SDK'sına nasıl iletileceği gösterilmektedir. Bu seçeneklerin AppLovin SDK'sına doğru şekilde yönlendirilmesini sağlamak için Google Mobile Ads SDK'sını başlatmadan önce ayarlanması gerekir.

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

GmaMediationApplovin.setDoNotSell(true);

Daha fazla bilgi için AppLovin'in Gizlilik dokümanlarına göz atın.

5. adım: Gerekli kodu ekleyin

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

Test reklamlarını etkinleştirme

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

Test reklamlarını doğrulama

Applovin'dan test reklamları aldığınızı doğrulamak için Applovin (Teklifli Sistem) ve Applovin (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özgü parametreler

AppLovin bağdaştırıcısı, ağa özgü parametreleri ayarlamak için reklam isteğine bir AppLovinMediationExtras nesnesi iletilmesini destekler. Aşağıdaki örnek kodda, isMuted parametresi kullanılarak video reklamlarda sesin nasıl devre dışı bırakılacağı gösterilmektedir:

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

Optimizasyonlar

Lansman etkinliğinize bir harekete geçirici mesaj GmaMediationApplovin.initializeSdk('sdkKey') eklemek, AppLovin'in uygulama başlatılır başlatılmaz etkinlikleri izlemesini sağlar.

Hata kodları

Adaptör AppLovin'den reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Bir reklam yüklenemezse AppLovin bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

AppLovin Flutter Uyumlulaştırıcı Adaptörü Değişiklik Günlüğü

Sonraki Sürüm

• Google Mobile Ads Flutter eklentisi 5.2.0 sürümü ile oluşturulup test edilmiştir.

1.2.0

• AppLovin Android adaptörünün 12.6.1.0 sürümüyle uyumluluğu doğrulandı.
• AppLovin iOS adaptörü 12.6.1.0 sürümüyle uyumluluğu doğrulandı.
• Google Mobile Ads Flutter eklentisi 5.1.0 sürümü ile oluşturulup test edilmiştir.

1.1.0

• GmaMediationApplovin API'si artık statik değildir.
• AppLovin Android adaptörü 12.4.3.0 sürümü ile uyumluluğu doğrulanmıştır.
• AppLovin iOS adaptörü 12.4.2.0 sürümü ile uyumluluğu doğrulandı.
• Google Mobile Ads Flutter eklentisi 5.1.0 sürümü ile oluşturulup test edilmiştir.

1.0.0

• İlk sürüm.
• AppLovin Android adaptörü 12.3.0.0 sürümü ile uyumluluğu doğrulandı
• AppLovin iOS adaptörü 12.2.1.0 sürümü ile uyumluluğu doğrulandı
• Google Mobile Ads Flutter eklentisi 5.0.0 sürümü ile oluşturulup test edilmiştir.