Bu kılavuzda, uyumlulaştırma ile AppLovin'den reklam yükleyip görüntülemek için Google Mobile Ads SDK'sını nasıl kullanacağınız gösterilmektedir. Bu yöntem, hem teklifli sistem hem de şelale entegrasyonlarını kapsar. Bu makalede, 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 edileceği Flutter 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 | |
Şelale | |
Formatlar | |
Banner | 1 |
Geçişli | |
Ödül olarak verildi |
Banner reklamlar (MREC banner'ları hariç) yalnızca uyumlulaştırmada desteklenir. Teklifli sistem, hiçbir banner reklam türünü desteklemez.
Koşullar
- En yeni 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 üstü 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ı tamamlayın 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.
Reklam biriminizi AdMob ayarlamak için AppLovin SDK Anahtarınız ve Rapor Anahtarınız gereklidir. Bunları bulmak için AppLovin kullanıcı arayüzü > Hesap > Anahtarlar'a giderek her iki değeri de görebilirsiniz.
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çin
Teklif
Bu adım, teklif entegrasyonları için gerekli değildir.
Şelale
AppLovin kullanıcı arayüzünde, kayıtlı uygulamalarınıza erişmek için 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şturma
Teklif
Bu adım, teklif 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 Alt Bölgeler'i seçin. Uygulamanız için gerekli alt bölgeleri zaten oluşturduysanız 2. adıma geçin. Yeni bir alt 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 (Platform) olarak Android'i seçin ve Reklam Türü'nü seçin.
Sabit BGBM veya AppLovin tarafından optimize edildi'yi seçerek alt bölge için Fiyatlandırmayı 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.
Android
iOS
Alt bölge oluşturulduktan sonra alt bölge kimliği, Zone ID (Bölge Kimliği) sütununun altında bulunabilir.
Android
iOS
Test modunu aç
AppLovin'in talimatlarını uygulayın MAX Test Mode AppLovin test reklamlarını etkinleştirme rehberi
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.
GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine AppLovin Corp.'u ekleyin
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ıyı içe aktarın
pub.dev üzerinden entegrasyon
Aşağıdaki bağımlılığı paketinizin pubspec.yaml
dosyasınaAppLovin SDK ve bağdaştırıcının en son sürümleriyle ekleyin:
dependencies:
gma_mediation_applovin: ^1.0.0
Manuel Entegrasyon
AppLovin için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı çıkarı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 başvurun:
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ı alma ve GDPR
Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken, uyumlulaştırma zincirinizde kişisel verileri toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız 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 durumunu buna göre ayarlamayı destekliyor.Applovin 7.0.0 ve sonraki sürümleri için
izin dizesini paylaşılan tercihlere yazan bir CMP kullanmıyorsanız
GmaMediationApplovin.setHasUserConsent()
ve
GmaMediationApplovin.setIsAgeRestrictedUser()
yöntemlerini kullanabilirsiniz. Aşağıdaki örnek kod, izin bilgilerinin AppLovin SDK'sına nasıl iletileceğini göstermektedir. Bu seçeneklerin, AppLovin SDK'sına doğru şekilde yönlendirildiğinden emin olmak için Google Mobile Ads SDK'sını başlatmadan önce ayarlanmalıdır.
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 bakın.
ABD eyalet gizlilik yasaları
ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını 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 bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz 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ırma eklentisi
GmaMediationApplovin.setDoNotSell()
yöntemini içerir. Aşağıdaki örnek kod, izin bilgilerinin AppLovin SDK'sına nasıl aktarılacağını gösterir. Bu seçeneklerin, AppLovin SDK'sına doğru şekilde yönlendirildiğinden emin olmak 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 bakın.
5. Adım: Gerekli kodu ekleyin
Android
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 dokümanlarındaki talimatları uygulayın.
6. Adım: Uygulamanızı test etme
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 özgü parametreler
AppLovin bağdaştırıcısı, ağa özel parametreleri ayarlamak için reklam isteğine bir AppLovinMediationExtras
nesnesinin iletilmesini destekler. Aşağıdaki örnek kod, isMuted
parametresini kullanarak video reklamlarda sesin nasıl devre dışı bırakılacağını gösterir:
AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [applovinExtras],
);
Optimizasyonlar
Lansman etkinliğinize
GmaMediationApplovin.initializeSdk('sdkKey')
yerine çağrı eklemek,
AppLovin'in uygulama başlar başlamaz etkinlikleri izlemesine olanak tanır.
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ındaki temel hatayı kontrol edebilir:
Android
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
iOS
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
Aşağıda, bir reklam yüklenemediğinde AppLovin bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajlar verilmiştir:
Android
Hata kodu | Neden |
---|---|
-1009 ila -1, 204 | AppLovin SDK'sı bir hata döndürdü. Daha fazla bilgi için AppLovin'in dokümanlarına göz atın. |
101 | İstenen reklam boyutu, AppLovin tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
103 | Bağlam değeri null. |
104 | AppLovin teklif jetonu boş. |
105 | Aynı alt bölge için birden fazla reklam istendi. AppLovin, bölge başına aynı anda yalnızca 1 reklam yükleyebilir. |
106 | Reklam görüntülenmeye 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 ayrıntılı bilgi için AppLovin'in dokümanlarına bakı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ı alt bölge için birden fazla reklam istendi. AppLovin, bölge başına 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, yükleme için başarılı bir geri çağırma gönderdi ancak hiç reklam yüklemedi. |
AppLovin Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü
1.1.0
- GmaMediationApplovin API'si artık sabit değil.
- AppLovin Android adaptörü sürüm 12.4.3.0 ile doğrulanmış uyumluluk.
- AppLovin iOS bağdaştırıcısı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ştirildi ve test edilmiştir.
1.0.0
- İlk sürüm.
- AppLovin Android adaptörü sürüm 12.3.0.0 ile doğrulanmış uyumluluk
- AppLovin iOS bağdaştırıcısı 12.2.1.0 sürümüyle doğrulanmış uyumluluk
- Google Mobile Ads Flutter Eklentisi sürüm 5.0.0 ile geliştirildi ve test edilmiştir.