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 Ad Manager 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

2. Adım: Kullanıcı arayüzünde AppLovin talebini Ad Manager ayarlayın

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

Android

Talimatlar için Android Android.

iOS

Talimatlar için iOS rehberinin 2. adımına göz atın. iOS.

AppLovin Corp.'u GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

GDPR ayarları ve ABD eyalet yönetmelikleri ayarları bölümündeki adımları uygulayarak Ad Manager 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 komutunu çalıştı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ı Unity 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'in Changelog ve GoogleMobileAdsAppLovinMediation.unitypackage öğesini çıkar .

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

Ad Manager 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 Ad Manager 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ısı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.