AppLovin'i uyumlulaştırma ile entegre etme

Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl uyumlulaştırma kullanarak AppLovin'den gelen reklamlar hem teklifli sistem hem de şelale entegrasyonlarını kapsar. AppLovin'in nasıl ekleneceği açıklanmaktadır reklam biriminin uyumlulaştırma yapılandırmasına ve AppLovin SDK'sının nasıl entegre edileceğine ve adaptörü bir uygulamaya Flutter dönüştürün.

Desteklenen entegrasyonlar ve reklam biçimleri

AppLovin için AdMob uyumlulaştırma adaptöründe şu özelliklerden yararlanabilirsiniz:

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

Banner reklamlar (MREC hariç) banner'lar) yalnızca uyumlulaştırmada desteklenir. Teklifli sistem hiçbir türü desteklemiyor seçenekleri var.

Ş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 üstü
  • iOS'te dağıtmak için
    • 12.0 veya sonraki bir iOS dağıtım hedefi
  • Google ile yapılandırılmış, çalışan bir Flutter proje Mobile Ads SDK'sı. Görüntüleyin Ayrıntılı bilgi için Başlarken.
  • Arabuluculuğu tamamlama Başlangıç kılavuzu

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

Kaydolun veya giriş yapın AppLovin hesabınıza ekleyin.

AdMob reklam biriminizi oluşturmak için AppLovin SDK Anahtarı ve Rapor Anahtarı. Bunları bulmak için şuraya gidin: AppLovin kullanıcı arayüzü > Hesap > Görülebilecek tuşlar iki değerden birini kullanın.

Yalnızca teklifli sistemi entegre etmeyi planlıyorsanız, uyumlulaştırma ayarlarınızı yapılandırın.

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

Teklif verme

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

Şelale

AppLovin kullanıcı arayüzünde, Para kazanma bölümünden kayıtlı uygulamalarınıza erişebilirsiniz. Uygulamayı seçin kullanılabilir uygulamalar listesinden uyumlulaştırma ile birlikte kullanmak istediğiniz seçeneği belirleyin.

Alt bölge oluştur

Teklif verme

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

Şelale

AppLovin kullanıcı arayüzünde, Para kazanma bölümünün altından Bölgeler'i seçin. bölümünü kullanarak kayıtlı alt bölge kimliklerinize gidin. Daha önce uygulamanız için gereken bölgeler varsa 2. Adım'a atlayın. Yeni bir bölge kimliği oluşturmak için Create Zone'u (Bölge Oluştur) tıklayın.

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

Sabit BGBM'yi veya Sabit BGBM'yi seçerek alt bölge için Fiyatlandırma'yı yapılandırın. AppLovin tarafından optimize edildi. BGBM'ler aşağıdakiler için ülke bazında yapılandırılabilir: Sabit BGBM seçeneğini belirleyin. Ardından Kaydet'i tıklayın.

Android

iOS

Alt bölge oluşturulduktan sonra bölge kimliği Zone ID (Alt Bölge Kimliği) bölümünde bulunabilir. sütununa girin.

Android

iOS

Test modunu aç

AppLovin'in web sitesindeki talimatları uygulayın MAX Test Modu AppLovin test reklamlarını etkinleştirmeyle ilgili kılavuza ulaşabilirsiniz.

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 düzenlemeleri reklam iş ortakları listesine ekleme

.

GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob kullanıcı arayüzünde GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine AppLovin Corp. ekleyin.

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

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, pubspec.yaml dosyasını yüklemek için şu bağımlılığı ekleyin:

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

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

Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.

AppLovin, paylaşılan tercihlerden ve ayardan izin dizesinin okunmasını destekliyor ve izin durumunu buna göre değiştirmeniz gerekir.

Şu durumda: izin dizesini paylaşılan iletişim bilgilerini GmaMediationApplovin.setHasUserConsent() ve GmaMediationApplovin.setIsAgeRestrictedUser() yöntemlerine göz atın. Aşağıdaki örnek kod, izin bilgilerini AppLovin SDK'sına iletin. Bu seçenekler ayarlanmalıdır Google Mobile Ads SDK'sını başlatmadan önce .

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

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

AppLovin'in gizlilik ayarlarına göz atın konulu videomuzu izleyin.

ABD eyalet gizlilik yasaları

. ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.

AppLovin için Google Mobil Reklamlar uyumlulaştırma eklentisi içerir GmaMediationApplovin.setDoNotSell() yöntemidir. Aşağıdaki örnek kod, AppLovin SDK'sı için kullanıcı rızası alma bilgileri sağlayın. Bu seçenekleri ayarlamadan önce yapmanız gerekir Google Mobil Reklamları'nı kullanmaya başlayın SDK .

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

GmaMediationApplovin.setDoNotSell(true);

AppLovin'in Gizlilik Politikası'na göz atın belgeleri konulu videomuzu izleyin.

5. Adım: Gerekli kodu ekleyin

Android

AppLovin entegrasyonu için ek koda gerek yoktur.

iOS

SKAdNetwork entegrasyonu

AppLovin'in belgelerini inceleyin kullanarak SKAdNetwork tanımlayıcılarını projenizin Info.plist" dosyasına ekleyebilirsiniz.

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.

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 özel parametreler

AppLovin adaptörü, AppLovinMediationExtras nesnesinin reklam isteğini kullanın. Aşağıdaki örnek kodda isMuted parametresi kullanılarak video reklamlarda ses nasıl devre dışı bırakılır?

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

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

Optimizasyonlar

Arama ekleniyor: GmaMediationApplovin.initializeSdk('sdkKey') projenizin farklı yönlerine AppLovin, uygulama başlar başlamaz etkinlikleri izleyebilme olanağı sunuyor.

Hata kodları

Bağdaştırıcı AppLovin'den reklam alamazsa yayıncılar reklam yanıtındaki temel hatayı ResponseInfo şu sınıflarda:

Android

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

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

AppLovin bağdaştırıcısı tarafından oluşturulan kodlar ve beraberindeki mesajlar Reklam yüklenemedi:

Android

Hata kodu Neden
-1009 - -1, 204 AppLovin SDK'sı hata döndürdü. Görüntüleyin AppLovin'in belgeleri inceleyebilirsiniz.
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ı alt bölge için birden fazla reklam istendi. AppLovin, alt bölge başına 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ı hata döndürdü. AppLovin'in belgelerini inceleyin inceleyebilirsiniz.
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ı alt bölge için birden fazla reklam istendi. AppLovin, alt bölge başına aynı anda yalnızca 1 reklam yükleyebilir.
105 AppLovin SDK anahtarı bulunamadı.
107 Teklif jetonu boş.
108 AppLovin Adapter, istenen reklam biçimini desteklemiyor.
110 AppLovin başarılı bir yükleme geri çağırması gönderdi ancak hiç reklam yüklemedi.

AppLovin Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü

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 bağdaştırıcının 12.6.1.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.1.0

  • GmaUyumlulaştırmaApplovin 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 bağdaştırıcı sürüm 12.2.1.0 ile uyumluluk doğrulandı
  • Google Mobile Ads Flutter eklentisi 5.0.0 sürümü ile geliştirilmiş ve test edilmiştir.