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 Flutter uygulamasına nasıl entegre edileceği ele alınmaktadı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ğı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ış çalışan bir Flutter projesi. 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

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.

Sabit BGBM veya AppLovin tarafından optimize edildi'yi seçerek bölge için Fiyatlandırma'yı 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

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: AdMob kullanıcı arayüzünde AppLovin talebini ayarlayın

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

Yapay Zeka

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

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

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

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 dizesini okumayı ve izin durumunu buna göre ayarlamayı destekler.

İ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 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ımına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılar. Bu 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 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ç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

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.

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 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ö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 AdMob 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ınamıyor.
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ğrulanmıştır.
  • 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.