AppLovin'i uyumlulaştırma ile entegre etme

Bu kılavuzda, uyumlulaştırma 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 yöntem hem teklifli sistem hem de şelale entegrasyonlarını kapsamaktadır. AppLovin'in reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve AppLovin SDK'sı ile bağdaştırıcısının bir uygulamaya nasıl entegre Flutter olacağı açıklanmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

AppLovin için AdMob uyumlulaştırma bağdaştırıcısı 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 sonraki sürümler
• Android'de dağıtım yapmak için
  • Android API düzeyi 21 veya sonraki sürümler
• iOS'te dağıtım yapmak için
  • 12.0 veya sonraki bir 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ı 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 giriş yapın.

AdMob reklam biriminizi oluşturmak için AppLovin SDK Anahtarınıza ve Rapor Anahtarınıza ihtiyacınız olacaktır. 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 devam edebilirsiniz.

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

Teklif verme

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

Şelale

Kayıtlı uygulamalarınıza ulaşmak için AppLovin kullanıcı arayüzünde Para Kazanma bölümünden Uygulamalar'ı seçin. Kullanılabilir uygulamalar listesinden uyumlulaştırma ile 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

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

Zone ID (Bölge Kimliği) adını girin, Platform olarak Android'i ve Reklam Türü'nü seçin.

Fiyatlandırma'yı Sabit BGBM veya AppLovin tarafından optimize edildi'yi seçerek yapılandırın. BGBM'ler, Sabit BGBM seçeneği için ü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ırmada reklam kaynaklarını daha etkili şekilde optimize edebilmesi için her AdMob reklam birimine karşılık gelen bir AppLovin alt 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: Kullanıcı arayüzünde AppLovin talebini 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.

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

Önemli: AB Kullanıcı Rızası, GDPR, CPRA ve Kullanıcı Mesajlaşma Platformu'nun yapılandırmasını tamamlamak için Hesap Yönetimi izniniz olduğunu doğrulayın. Ayrıntılar için Kullanıcıların hesabınıza erişimini yönetme başlıklı makaleyi inceleyin.

Applovin Corp.'u AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için GDPR ayarları ve ABD eyalet düzenlemeleri ayarlarında belirtilen 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 aracılığıyla entegrasyon

Aşağıdaki bağımlılığı AppLovin Paketinizdeki SDK ve bağdaştırıcı pubspec.yaml dosyası:

dependencies:
  gma_mediation_applovin: ^1.0.0

Manuel Entegrasyon

Şu hesap için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin: AppLovin, indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü ekleyin. (ve içeriklerini) 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: Gizlilik ayarlarını AppLovin SDK'sında uygulayın

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı (AEA)'daki kullanıcılara 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) gereksinimlerini 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 aktaramamaktadır.

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 doğru ş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ına göz atın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerinin" "satılmasını" (yasaların bu terimlerin tanımladığı şekilde) devre dışı bırakma seçeneği sunmasını gerektirir. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına 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 tüm reklam ağlarına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına katılabilecek her bir reklam ağını belirlemeli ve uygunluğu sağlamak için bu ağların her birinin talimatlarını takip etmelisiniz.

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önlendirilmelerini sağlamak için Google Mobile Ads SDK'sını başlatmadan önce bu seçeneklerin 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

Yapay Zeka

AppLovin entegrasyonu için ek koda gerek yoktur.

iOS

SKAdNetwork entegrasyonu

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

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

Test reklamlarını etkinleştir

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

AppLovinreklam kaynağından test reklamları aldığınızı doğrulamak için AppLovin (Bidding) and AppLovin (Waterfall) 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 kod, isMuted parametresi kullanılarak video reklamlarda sesin nasıl devre dışı bırakılacağını göstermektedir:

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ı

Bağdaştırıcı AppLovin'den reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtından temel alınan 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 - -1, 204	AppLovin SDK'sı hata döndürdü. Daha fazla bilgi için AppLovin'in belgelerine göz atı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örüntülenmeye hazır değil.
108	AppLovin Adapter, istenen reklam biçimini desteklemiyor.

iOS

Hata kodu	Neden
-1009 - -1, 204	AppLovin SDK'sı bir hata döndürdü. Daha fazla bilgi için AppLovin'in belgelerine göz atın.
101	İstenen reklam boyutu, AppLovin tarafından desteklenen bir banner boyutuyla eşleşmiyor.
102	Kullanıcı arayüzünde yapılandırılan AppLovin sunucu parametreleri AdMob 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ğırması gönderdi ancak hiç reklam yüklemedi.
111	AppLovin SDK'sının örneği alınamıyor.
112	Kullanıcı çocuksa

AppLovin Flutter Uyumlulaştırma Bağdaştırıcısı 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 bağdaştırıcının 12.6.1.0 sürümüyle uyumlu olduğ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üyle geliştirilip test edilmiştir.

1.1.0

• GmaMediationApplovin için API artık statik değildir.
• AppLovin Android bağdaştırıcının 12.4.3.0 sürümüyle uyumlu olduğu doğrulandı.
• AppLovin iOS bağdaştırıcının 12.4.2.0 sürümüyle uyumlu olduğu doğrulandı.
• Google Mobile Ads Flutter Eklentisi sürüm 5.1.0 ile geliştirilmiş ve test edilmiştir.

1.0.0

• İlk sürüm.
• AppLovin Android bağdaştırıcı sürüm 12.3.0.0 ile uyumluluk 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 geliştirilmiş ve test edilmiştir.