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 Ad Manager uyumlulaştırıcı adaptör aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif verme
Şelale
Formatlar
Banner	^1
Geçiş reklamı
Ödüllü

¹ 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.

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

Teklif verme

Bu adım, teklifli sistem entegrasyonları için gerekli değildir.

Şelale

AppLovin kullanıcı arayüzünde, kayıtlı uygulamalarınıza gitmek için Para kazanma bölümündeki Uygulamalar'ı seçin. Mevcut uygulamalar listesinden uyumlulaştırmayla kullanmak istediğiniz uygulamayı seçin.

Alt bölge oluştur

Teklif verme

Bu adım, teklifli sistem entegrasyonları için gerekli değildir.

Şelale

Kayıtlı bölge kimliklerinize ulaşmak için AppLovin kullanıcı arayüzünde Para kazanma bölümünün altında Bölgeler'i seçin. Uygulamanız için gerekli bölgeleri zaten oluşturduysanız 2. Adım'a geçin. Yeni bir bölge kimliği oluşturmak için Bölge Oluştur'u tıklayın.

Zone ID adını girin, Platform olarak Android'i seçin ve Reklam Türü'nü belirleyin.

Fiyatlandırma'yı Sabit BGBM veya AppLovin tarafından optimize edildi'yi seçerek yapılandırın. Sabit BGBM seçeneği için BGBM'ler ülke bazında yapılandırılabilir. Ardından Kaydet'i tıklayın.

Yapay Zeka

iOS

Bölge oluşturulduktan sonra bölge kimliğini Bölge Kimliği sütununda bulabilirsiniz.

Yapay Zeka

iOS

Not: AdMob'un uyumlulaştırmadaki reklam kaynaklarını daha etkili bir şekilde optimize edebilmesi için her AdMob reklam birimine karşılık gelen bir AppLovin bölgesi oluşturmanızı önemle tavsiye ederiz.

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 Ad Manager kullanıcı arayüzünde ayarlayın

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

Yapay Zeka

Talimatlar için Android.

iOS

Talimatlar için iOS.

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

Not: Uyumlu AppLovin ve Google Mobile Ads SDK sürümlerinin entegre edilmemesi derleme sorunlarına neden olabilir.

pub.dev üzerinden entegrasyon

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

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.

AppLovin, paylaşılan tercihlerden izin dizesinin okunmasını ve izin durumunun buna göre ayarlanmasını destekler.

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 düzgün ş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ımına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılar. 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 belgelerine göz atın.

5. adım: Gerekli kodu ekleyin

Yapay Zeka

AppLovin entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için AppLovin'in dokümanlarını inceleyin.

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.

Önemli: Uygulamanızı yayınlamadan önce AdMob ve Applovin için test modunu devre dışı bırakın.

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:

Yapay Zeka

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

iOS

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:

Yapay Zeka

Hata kodu	Neden
-1009 ila -1, 204	AppLovin SDK'sı bir hata döndürdü. Daha fazla ayrıntı için AppLovin'in belgelerine bakın.
101	İstenen reklam boyutu, AppLovin tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103	Bağlam boş.
104	AppLovin teklif jetonu boş.
105	Aynı bölge için birden fazla reklam istendi. AppLovin, her bölge için aynı anda yalnızca 1 reklam yükleyebilir.
106	Reklam gösterilmeye hazır değil.
108	AppLovin bağdaştırıcısı, istenen reklam biçimini desteklemiyor.

iOS

Hata kodu	Neden
-1009 ila -1, 204	AppLovin SDK'sı bir hata döndürdü. Daha fazla ayrıntı için AppLovin'in belgelerine bakın.
101	İstenen reklam boyutu, AppLovin tarafından desteklenen bir banner boyutuyla eşleşmiyor.
102	Ad Manager kullanıcı arayüzünde yapılandırılan AppLovin sunucu parametreleri eksik/geçersiz.
103	AppLovin reklamı gösterilemedi.
104	Aynı bölge için birden fazla reklam istendi. AppLovin, her bölge için aynı anda yalnızca 1 reklam yükleyebilir.
105	AppLovin SDK anahtarı bulunamadı.
107	Teklif jetonu boş.
108	AppLovin bağdaştırıcısı, istenen reklam biçimini desteklemiyor.
110	AppLovin, başarılı bir yükleme geri çağırma gönderdi ancak sıfır reklam yükledi.
111	AppLovin SDK'sının örneği alınamadı.
112	Kullanıcı çocuksa

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ü ile 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üyle 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.