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. 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 Unity olacağı açıklanmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

AppLovin için Ad Manager uyumlulaştırıcı adaptör 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ı
  • Unity 5.6 veya sonraki sürümler
  • [Teklif verme için]: AppLovin 4.2.0 veya sonraki sürümler için Google Mobile Ads uyumlulaştırma eklentisi (en son sürüm önerilir)
  • 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ış Unity çalışan bir proje. 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. 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 verme

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

Şelale

Kayıtlı uygulamalarınıza ulaşmak için AppLovin kullanıcı arayüzünde Para Kazanma bölümünden 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

AppLovin kullanıcı arayüzünde, kayıtlı alt bölge kimliklerinize ulaşmak için Para kazanma bölümünden 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.

Fiyatlandırma'yı Sabit BGBM veya AppLovin tarafından optimize edildi'yi seçerek 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: AppLovin talebini Ad Manager kullanıcı arayüzünde 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 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

OpenUPM-CLI

OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak Unity için Google Mobile Ads AppLovin Uyumlulaştırma Eklentisi'ni projenize yükleyebilirsiniz:

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

OpenUPM

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

Kapsamlı Kayıt Daireleri sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı bir kayıt dairesi olarak ekleyin:

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

OpenUPM Ayrıntıları

Ardından, Unity Paket Yöneticisi'ni açmak için pencere > Paket Yöneticisi'ne gidin ve açılır menüden Kayıt Dairelerim'i seçin.

Unity Kayıt Defterleri

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

OpenUPM'den yükle

Unity Paketi

Değişiklik günlüğündeki indirme bağlantısını kullanarak AppLovin için Google Mobile Ads uyumlulaştırma eklentisinin son sürümünü indirin ve zip dosyasından GoogleMobileAdsAppLovinMediation.unitypackage öğesini çıkarın.

Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsAppLovinMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe Aktar'ı tıklayın.

Unity'den içe aktar

Ardından, Öğeler > Harici Bağımlılık Yöneticisi > Android Çözümleyici > Zorla Çöz'ü seçin. Harici Bağımlılık Yöneticisi kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

Çözümü Zorla Uygula

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

Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı (AEA)'daki kullanıcılara 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) gereksinimlerini 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.

Google Mobile Ads uyumlulaştırma eklentisinin 7.0.0 sürümünden itibaren AppLovin, paylaşılan tercihlerden izin dizesinin okunmasını ve izin durumunu buna göre ayarlamayı destekliyor.

Applovin 7.0.0 ve sonraki sürümler için Google Mobil Reklamlar uyumlulaştırması eklentisini kullanmıyorsanız veya izin dizesini paylaşılan tercihlere yazan bir CMP kullanmıyorsanız AppLovin.SetHasUserConsent() ve AppLovin.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.

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

AppLovin.SetHasUserConsent(true);

Ayrıca, kullanıcının yaş kısıtlaması olan bir kategoride yer aldığı biliniyorsa aşağıdaki işareti true olarak da ayarlayabilirsiniz.

AppLovin.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ımlarına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılıyor. 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 Mobile Ads uyumlulaştırıcı eklentisinin 6.3.1 sürümü AppLovin.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önlendirilmelerini sağlamak için Google Mobile Ads SDK'sını başlatmadan önce bu seçeneklerin ayarlanması gerekir.

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

AppLovin.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 koda gerek yoktur.

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ştir

Test cihazınızı AdMob'a 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

Optimizasyonlar

Lansman etkinliğinize bir harekete geçirici mesaj AppLovin.Initialize() 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 bakı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 Ad Manager 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 Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

Sürüm 8.0.2

7.4.1 sürümü

7.4.0 sürümü

Sürüm 7.3.1

7.3.0 sürümü

Sürüm 7.2.2

7.2.1 sürümü

7.2.0 sürümü

Sürüm 7.1.0

Sürüm 7.0.1

7.0.0 sürümü

6.9.1 sürümü

Sürüm 6.9.0

Sürüm 6.8.0

6.7.0 sürümü

Sürüm 6.6.0

6.5.1 sürümü

Sürüm 6.5.0

Sürüm 6.4.3

6.4.2 sürümü

Sürüm 6.4.1

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ü

Sürüm 6.1.0

Sürüm 6.0.0

Sürüm 5.1.3

Sürüm 5.1.2

5.1.1 sürümü

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

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ü

Sürüm 4.5.6

4.5.5 sürümü

Sürüm 4.5.4

4.5.3 sürümü

Sürüm 4.5.2

Sürüm 4.5.1

Sürüm 4.5.0

4.4.1 sürümü

Sürüm 4.4.0

4.3.0 sürümü

4.2.0 sürümü

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

4.1.0 sürümü

  • 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ısı 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.

3.1.2 sürümü

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

3.1.1 sürümü

  • AppLovin Android adaptörü 8.1.0.0 sürümünü destekler.
  • AppLovin iOS adaptörü 5.1.1.0 sürümünü destekler.

3.1.0 sürümü

  • AppLovin Android adaptörü 8.1.0.0 sürümünü destekler.
  • AppLovin iOS adaptörü 5.1.0.0 sürümünü destekler.

Sürüm 3.0.3

  • AppLovin Android adaptörü 8.0.2.1 sürümünü destekler.
  • AppLovin iOS bağdaştırıcısı 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ı 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 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 iletmek için AppLovin.SetHasUserConsent() yöntemi eklendi.

Sürüm 2.0.0

  • AppLovin Android SDK'sı 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ı 7.8.6 sürümünü destekler.
  • AppLovin iOS SDK'sı 4.8.3 sürümünü destekler.

Sürüm 1.2.0

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

1.1.0 sürümü

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

Sürüm 1.0.0

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