AppLovin'i uyumlulaştırma ile entegre etme

Bu kılavuz, uyumlaştırma kullanarak AppLovin'den reklam yüklemek ve göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağını teklif ve şelale entegrasyonlarını kapsayarak açıklar. Bu açıklamalar, AppLovin'in bir reklam biriminin uyumlaştırma yapılandırmasına nasıl ekleneceğini ve AppLovin SDK'sının ve bağdaştırıcısının bir Flutter uygulamasına nasıl entegre edileceğini kapsar.

Desteklenen entegrasyonlar ve reklam biçimleri

AppLovin için Ad Manager uyumlaştırma adaptörünün özellikleri şöyledir:

¹ Şelale yalnızca 320x50 ve 728x90 banner boyutlarını destekler. Teklifli sistem, banner reklamları desteklemez.

Şartlar

• En son Google Mobile Ads SDK'sı
• Flutter 3.7.0 veya sonraki sürümler
• Android'de dağıtmak için
  • Android API düzeyi 23 veya üstü
• iOS'te dağıtmak için
  • iOS 12.0 veya üzeri sürüm dağıtım hedefi
• Google Mobile Ads SDK'sı ile yapılandırılmış çalışan bir Flutter projesi. Ayrıntılar için Başlangıç başlıklı makaleyi inceleyin.
• Uyumlulaştırma Başlangıç Kılavuzu'nu tamamlama

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

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

Ad Manager 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 giderek her iki değeri de görebilirsiniz.

Yalnızca teklif vermeyi entegre etmeyi planlıyorsanız aracılık ayarlarınızı yapılandırmaya geçebilirsiniz.

Uyumlulaştırma için uygulamayı seçin

Alt bölge oluştur

app-ads.txt dosyanızı güncelleme

Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt dosyası uygulamanız gerekir. Henüz yapmadıysanız Ad Manager için bir app-ads.txt dosyası oluşturun.

AppLovin için app-ads.txt uygulamak istiyorsanız: AppLovin'i app-ads.txt dosyanıza ekleyin.

Test modunu etkinleştirme

AppLovin test reklamlarını etkinleştirme hakkında AppLovin'in MAX Test Modu rehberindeki talimatları uygulayın.

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

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

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

Ad Manager kullanıcı arayüzünde Applovin Corp. şirketini AB ve ABD eyalet tüzükleri reklam iş ortakları listesine eklemek için AB tüzükleri ayarları ve ABD eyalet tüzükleri ayarları bölümlerindeki 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ısının en son sürümleriyle birlikte aşağıdaki bağımlılığı ekleyin:

dependencies:
  gma_mediation_applovin: ^

Manuel Entegrasyon

Applovin için Google Mobil Reklamlar aracılık eklentisinin en son sürümünü indirin, indirilen dosyayı çıkarın ve çıkarılan eklenti klasörünü (ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızda eklentiye referans verin:

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

4. adım: AppLovin SDK'sındaki gizlilik ayarlarını uygulayın

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı Rızası Politikası'na uymak için Avrupa Ekonomik Alanı (AEA), Birleşik Krallık ve İsviçre'deki kullanıcılarınıza belirli açıklamalar yapmanız, yasal olarak gerekli olduğunda çerezlerin veya diğer yerel depolama alanlarının kullanımı ve reklam kişiselleştirme için kişisel verilerin toplanması, paylaşılması ve kullanılması konusunda kullanıcıların rızasını almanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. Uyumlulaştırma zincirinizdeki her reklam kaynağına rıza bilgisinin iletildiğini doğrulamak sizin sorumluluğunuzdadır. Google, kullanıcının rıza seçimini bu tür ağlara otomatik olarak iletemez.

İzin 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 düzgün şekilde yönlendirilmelerini 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ı başlıklı makaleyi inceleyin.

ABD eyalet gizlilik yasaları

ABD eyaletlerindeki gizlilik yasaları, kullanıcılara "kişisel bilgilerinin" "satışının" (yasaların bu terimleri tanımladığı biçimiyle) kapsamı dışında kalma hakkı tanınmasını zorunlu kılar. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde gösterilen "Kişisel Bilgilerimi Satma" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına uygunluk rehberi, Google reklamları sunmak 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, uyumluluğu sağlamak için, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilecek tüm reklam ağlarını belirlemeli ve bu ağların her birinden gelen yönergeleri uygulamanız gerekir.

AppLovin için Google Mobil Reklamlar uyumlulaştırma eklentisi, 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çenekler, AppLovin SDK'sına düzgün şekilde yönlendirilmelerini sağlamak için Google Mobile Ads SDK'sını başlatmadan önce ayarlanmalıdır.

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

GmaMediationApplovin.setDoNotSell(true);

Daha fazla bilgi için AppLovin'in Gizlilik belgelerine göz atın.

5. adım: Gerekli kodu ekleyin

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

Test reklamlarını etkinleştirme

Ad Manager 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'den 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 özel parametreler

AppLovin bağdaştırıcısı, ağa özgü parametreleri ayarlamak için reklam isteğine 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 harekete geçirici mesaj eklemek, AppLovin'e uygulama başlar başlamaz etkinlikleri izleme olanağı sağlar.GmaMediationApplovin.initializeSdk('sdkKey')

Hata kodları

Adaptör AppLovin'den reklam alamıyorsa yayıncılar aşağıdaki sınıflarda 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üklenemediğinde AppLovin bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

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

Sürüm 2.3.2

• AppLovin Android bağdaştırıcısı 13.3.1.1 sürümünü destekler.
• AppLovin iOS adaptörünün 13.3.1.0 sürümünü destekler.

• Google Mobile Ads Flutter eklentisi 6.0.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 2.3.1

• AppLovin Android bağdaştırıcısı sürüm 13.3.1.0'ı destekler.
• AppLovin iOS adaptörünün 13.3.1.0 sürümünü destekler.

• Google Mobile Ads Flutter eklentisi 6.0.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 2.3.0

• AppLovin Android bağdaştırıcısı sürüm 13.3.0.0'ı destekler.
• AppLovin iOS adaptörünün 13.3.0.0 sürümünü destekler.

• Google Mobile Ads Flutter eklentisi 6.0.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 2.2.1

• AppLovin Android bağdaştırıcı sürümü 13.2.0.1'i destekler.
• AppLovin iOS adaptörünün 13.2.0.0 sürümünü destekler.

• Google Mobile Ads Flutter eklentisi 6.0.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 2.2.0

• AppLovin Android bağdaştırıcısı sürüm 13.2.0.0'ı destekler.
• AppLovin iOS adaptörünün 13.2.0.0 sürümünü destekler.

• Google Mobile Ads Flutter eklentisi 6.0.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 2.1.0

• AppLovin Android bağdaştırıcısı sürüm 13.1.0.0'ı destekler.
• AppLovin iOS adaptörünün 13.1.0.0 sürümünü destekler.

• Google Mobile Ads Flutter eklentisi 5.3.1 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 2.0.0

• AppLovin Android bağdaştırıcısı sürüm 13.0.1.0 desteklenir.
• AppLovin iOS adaptörünün 13.0.1.0 sürümünü destekler.

• Google Mobile Ads Flutter eklentisi 5.3.1 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 1.2.0

• AppLovin Android bağdaştırıcı sürümü 12.6.1.0'ı destekler.
• AppLovin iOS bağdaştırıcısı 12.6.1.0 sürümünü destekler.

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

Sürüm 1.1.0

• GmaMediationApplovin için API artık statik değil.
• AppLovin Android bağdaştırıcısı sürüm 12.4.3.0'ı destekler.
• AppLovin iOS adaptörünün 12.4.2.0 sürümünü destekler.

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

Sürüm 1.0.0

• İlk sürüm.

• AppLovin Android bağdaştırıcı sürümü 12.3.0.0'ı destekler.
• AppLovin iOS bağdaştırıcısı 12.2.1.0 sürümünü destekler.

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