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 Unity 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ı .
  • Unity 5.6 veya sonraki sürümler
  • [Teklif verme için]: AppLovin 4.2.0 veya daha yüksek (en son sürüm önerilir) .
  • 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 Unity 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

OpenUPM-CLI

OpenUPM-CLI kullanıyorsanız Google Mobile Ads AppLovin'i Aşağıdaki komutu çalıştırarak Unity için Uyumlulaştırma Eklentisi şu dosyayı projenizin kök dizininden kaldırın:

openupm add com.google.ads.mobile.mediation.applovin

OpenUPM

Unity proje düzenleyicinizde Düzenle'yi seçin > Proje Ayarları > Paket Yöneticisi'ni açın ve Unity Paket Yöneticisi Ayarları.

Kapsamlı Kayıtlar sekmesinde OpenUPM'yi kapsamlı bir kayıt defteri olarak ekleyin ve şu ayrıntıları bulabilirsiniz:

  • Ad: OpenUPM
  • URL: https://package.openupm.com
  • Kapsamlar: com.google

OpenUPM Ayrıntıları

Ardından Pencere'ye gidin > Paket Yöneticisi'ni açın ve Unity Paket Yöneticisi ve açılır menüden Kayıt Defterlerim'i seçin.

Unity Kayıt Defterleri

Google Mobile Ads AppLovin Uyumlulaştırması paketini seçin ve Yükle'yi tıklayın.

OpenUPM'den yükle

Unity Paketi

Şu hesap için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin: İndirme bağlantısından AppLovin "the" Değişiklik günlüğü ve Posta kodundan GoogleMobileAdsAppLovinMediation.unitypackage uzaklıkta dosyası olarak kaydedebilirsiniz.

Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel Paket'e göz atın ve GoogleMobileAdsAppLovinMediation.unitypackage dosyanız olabilir. Tüm dosyaların seçildiğinden emin olun ve İçe aktar.

Unity'den içe aktar

Ardından Öğeler > Play Hizmetleri Çözücü > Android Çözücü > Zorla Çöz'e dokunun. Unity Play Hizmetleri Çözümleyici bağımlılık çözümünü sıfırdan çözer ve sitenizin Assets/Plugins/Android dizinine bağımlıları bildirdiğinizden emin olun. Unity uygulaması.

Çözmeye Zorla

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.

. Google Mobile Ads uyumlulaştırma eklentisinden beri sürüm 7.0.0, AppLovin, paylaşılan tercihlerden ve ayardan izin dizesinin okunmasını destekliyor ve izin durumunu buna göre değiştirmeniz gerekir.

Şu durumda: . Applovin için Google Mobil Reklamlar uyumlulaştırma eklentisi kullanılmıyor 7.0.0+ veya izin dizesini paylaşılan iletişim bilgilerini AppLovin.SetHasUserConsent() ve AppLovin.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 .

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

Ayrıca, kullanıcının yaş kısıtlamalı bir kategoride yer aldığı biliniyorsa aşağıdaki işareti de true olarak ayarla.

AppLovin.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 . sürüm 6.3.1 içerir AppLovin.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 .

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

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

Optimizasyonlar

Arama ekleniyor: . AppLovin.Initialize() 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 Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

Sürüm 7.4.0

Sürüm 7.3.1

Sürüm 7.3.0

Sürüm 7.2.2

Sürüm 7.2.1

Sürüm 7.2.0

Sürüm 7.1.0

Sürüm 7.0.1

Sürüm 7.0.0

Sürüm 6.9.1

Sürüm 6.9.0

Sürüm 6.8.0

Sürüm 6.7.0

Sürüm 6.6.0

Sürüm 6.5.1

Sürüm 6.5.0

Sürüm 6.4.3

Sürüm 6.4.2

Sürüm 6.4.1

Sürüm 6.4.0

Sürüm 6.3.1

Sürüm 6.3.0

Sürüm 6.2.1

Sürüm 6.2.0

Sürüm 6.1.0

Sürüm 6.0.0

Sürüm 5.1.3

Sürüm 5.1.2

Sürüm 5.1.1

Sürüm 5.1.0

Sürüm 5.0.0

Sürüm 4.8.1

Sürüm 4.8.0

Sürüm 4.7.0

Sürüm 4.6.2

Sürüm 4.6.1

Sürüm 4.6.0

Sürüm 4.5.8

Sürüm 4.5.7

Sürüm 4.5.6

Sürüm 4.5.5

Sürüm 4.5.4

Sürüm 4.5.3

Sürüm 4.5.2

Sürüm 4.5.1

Sürüm 4.5.0

Sürüm 4.4.1

Sürüm 4.4.0

Sürüm 4.3.0

Sürüm 4.2.0

  • AppLovin Android bağdaştırıcının 9.4.2.0 sürümünü destekler.
  • AppLovin iOS bağdaştırıcının 6.6.1.0 sürümünü destekler.

Sürüm 4.1.0

  • Eklenti, yeni açık beta Ödüllü API'yi destekleyecek şekilde güncellendi.
  • AppLovin Android bağdaştırıcının 9.2.1.1 sürümünü destekler.
  • AppLovin iOS bağdaştırıcının 6.3.0.0 sürümünü destekler.

Sürüm 4.0.0

  • AppLovin Android bağdaştırıcının 9.2.1.0 sürümünü destekler.
  • AppLovin iOS bağdaştırıcının 6.2.0.0 sürümünü destekler.

Sürüm 3.1.2

  • AppLovin Android bağdaştırıcının 8.1.4.0 sürümünü destekler.
  • AppLovin iOS bağdaştırıcının 5.1.2.0 sürümünü destekler.

Sürüm 3.1.1

  • AppLovin Android bağdaştırıcının 8.1.0.0 sürümünü destekler.
  • AppLovin iOS bağdaştırıcının 5.1.1.0 sürümünü destekler.

Sürüm 3.1.0

  • AppLovin Android bağdaştırıcının 8.1.0.0 sürümünü destekler.
  • AppLovin iOS bağdaştırıcının 5.1.0.0 sürümünü destekler.

Sürüm 3.0.3

  • AppLovin Android bağdaştırıcının 8.0.2.1 sürümünü destekler.
  • AppLovin iOS bağdaştırıcının 5.0.2.0 sürümünü destekler.

Sürüm 3.0.2

  • AppLovin Android SDK'sının 8.0.1 sürümünü destekler.
  • AppLovin iOS SDK'sının 5.0.1 sürümünü destekler.

Sürüm 3.0.1

  • AppLovin Android SDK'sının 8.0.0 sürümünü destekler.
  • AppLovin iOS SDK'sının 5.0.1 sürümünü destekler.
  • Kullanıcının yaş kısıtlamalı bir kategoride yer alıp almadığını belirtmek için AppLovin.SetIsAgeRestrictedUser() yöntemi eklendi.

Sürüm 3.0.0

  • AppLovin Android SDK'sının 8.0.0 sürümünü destekler.
  • AppLovin iOS SDK'sının 5.0.1 sürümünü destekler.
  • Kullanıcı izni işaretini AppLovin SDK'sına yönlendirmek için AppLovin.SetHasUserConsent() yöntemi eklendi.

Sürüm 2.0.0

  • AppLovin Android SDK'sının 7.8.6 sürümünü destekler.
  • AppLovin iOS SDK'sının 5.0.1 sürümünü destekler.

Sürüm 1.2.1

  • AppLovin Android SDK'sının 7.8.6 sürümünü destekler.
  • AppLovin iOS SDK'sının 4.8.3 sürümünü destekler.

Sürüm 1.2.0

  • AppLovin Android SDK'sının 7.8.5 sürümünü destekler.
  • AppLovin iOS SDK'sının 4.8.3 sürümünü destekler.

Sürüm 1.1.0

  • AppLovin Android SDK'sının 7.7.0 sürümünü destekler.
  • AppLovin iOS SDK'sının 4.7.0 sürümünü destekler.

Sürüm 1.0.0

  • İlk çıkış tarihi!
  • AppLovin Android SDK'sının 7.4.1 sürümünü destekler.
  • AppLovin iOS SDK'sının 4.4.1 sürümünü destekler.