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. Bu makalede, AppLovin'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve AppLovin SDK'sının ve bağdaştırıcının bir Unity uygulamasına nasıl entegre edileceği 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 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]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek amacıyla AppLovin 4.2.0 veya sonraki sürümler için Google Mobile Ads uyumlulaştırma eklentisini kullanın (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ış çalışan bir Unity projesi. 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. Bu değerleri bulmak için AppLovin kullanıcı arayüzü > Hesap > Anahtarlar'a gidin ve her iki değeri de görün.

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çme

Teklif verme

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

Şelale

AppLovin kullanıcı arayüzünde, kayıtlı uygulamalarınıza gitmek için Para kazanma bölümündeki 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

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

Sabit BGBM veya AppLovin tarafından optimize edildi'yi seçerek bölge için Fiyatlandırma'yı 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: AdMob kullanıcı arayüzünde AppLovin talebini ayarlayın

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

Yapay Zeka

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

Talimatlar için iOS kılavuzunun 2. adımına bakın.

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 Mobil Reklamlar 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 Daireleri

Google Mobil Reklamlar Applovin Uyumlulaştırması paketini seçin ve Yükle'yi tıklayın.

OpenUPM'den yükleme

Unity Paketi

Değişiklikler Günlüğü'ndeki indirme bağlantısından Applovin için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin ve GoogleMobileAdsApplovinMediation.unitypackage dosyasını zip dosyasından çı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 aktarma

Ardından Öğeler > Harici Bağımlılık Yöneticisi > Android Çözücü > Çözümü Zorla'yı 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: AppLovin SDK'sında gizlilik ayarlarını uygulayın

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili 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) şartlarını 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 Mobil Reklamlar uyumlulaştırma eklentisinin 7.0.0 sürümünden beri AppLovin, paylaşılan tercihlerden izin dizesini okumayı ve izin durumunu buna göre ayarlamayı destekler.

Applovin 7.0.0 ve sonraki sürümler için Google Mobil Reklamlar uyumlulaştırma 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 olduğu 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ımına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılar. Bu 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 6.3.1 sürümü için Google Mobile Ads uyumlulaştırma eklentisi, 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önlendirilmesini sağlamak için Google Mobile Ads SDK'sını başlatmadan önce 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 kod gerekmez.

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

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

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ı hata döndürmüştür. Daha fazla ayrıntı için AppLovin'in belgelerine göz atı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ı hata döndürmüştür. 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 AdMob 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ınamadı.
112 Kullanıcı çocuksa

AppLovin Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

8.0.3 sürümü

8.0.2 sürümü

7.4.1 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ü

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

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ü

Sürüm 6.1.0

Sürüm 6.0.0

Sürüm 5.1.3

5.1.2 sürümü

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ü

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ü

Sürüm 4.5.0

4.4.1 sürümü

4.4.0 sürümü

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 Rewarded API'yi destekleyecek şekilde güncellendi.
  • AppLovin Android adaptörü 9.2.1.1 sürümünü destekler.
  • AppLovin iOS bağdaştırıcısı 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ısı 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.

Sürüm 3.1.0

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

Sürüm 3.0.1

  • AppLovin Android SDK 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 olup olmadığı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ı 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ı 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.

Sürüm 1.1.0

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