LY Ads Network'ü uyumlulaştırma ile entegre etme

Platform seçin: Android Android iOS Unity Flutter

Bu kılavuz, şelale entegrasyonlarını kapsayarak AdMob Uyumlulaştırması'nı kullanarak LY Ads Network'ten reklam yüklemek ve göstermek için Google Mobile Ads SDK nasıl kullanacağınızı gösterir. Bu açıklamalar, LY Ads Network'ün bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve LY Ads Network SDK'sının ve bağdaştırıcısının bir Android uygulamasına nasıl entegre edileceğini kapsar.

Desteklenen entegrasyonlar ve reklam biçimleri

LY Ads Network için uyumlulaştırma adaptörünün özellikleri şöyledir:

Şartlar

• Android API düzeyi 23 veya üstü

• Google Mobile Ads SDK kanalının en yenileri

• Uyumlulaştırma Başlangıç Kılavuzu'nu tamamlayın.

1. adım: LY Ads Network kullanıcı arayüzünde yapılandırmaları ayarlayın

LY Ads Network hesabınıza kaydolun ve giriş yapın.

Yeni uygulama ekleme

Uygulama sekmesine gidin ve Yeni kayıt düğmesini tıklayın.

Formu doldurun ve kayıt'ı tıklayın.

Uygulama kimliğini not edin.

Reklam alanı oluşturma

Uygulama sekmesinde, uygulamanızın ayrıntılarını görüntülemek için uygulamanızı seçin. Slot bölümünde Ekle'yi tıklayın.

Slotla ilgili ayrıntılar için formu doldurun. Teklif Türü için bu alanı şelale uyumlulaştırması için yapılandırmak üzere Standart'ı veya teklifli sistem için yapılandırmak üzere Google SDK Teklif Sistemi'ni seçin. Form doldurulduktan sonra Oluştur'u tıklayın.

Slot kimliğini not edin.

İlk yerinizi oluşturduktan sonra LY Ads Network'ten onay almak için uygulamanızın ayrıntılar sayfasında İncele'yi tıklayın. Bu işlem zaman alabilir. Sorularınız olursa LY Ads Network temsilcinizle iletişime geçin.

Raporlama API'si anahtarı oluşturma

Raporlama API anahtarlarını yönetme sekmesine gidin ve API anahtarı oluştur düğmesini tıklayın.

Formu doldurun ve Kaydet'i tıklayın.

API Anahtarı Kimliğinizi ve API Anahtarı Gizli Anahtarınızı not edin.

app-ads.txt dosyanızı güncelleme

Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt dosyası uygulamanız gerekir. Bunu henüz yapmadıysanız uygulamanız için bir app-ads.txt dosyası oluşturun.

LY Ads Network için app-ads.txt uygulamak üzere app-ads.txt hakkında başlıklı makaleyi inceleyin.

2. adım: AdMob kullanıcı arayüzünde LY Ads Network talebini ayarlayın

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

LY Ads Network'ü reklam biriminizin aracılık yapılandırmasına eklemeniz gerekir.

Öncelikle AdMob hesabınızda oturum açın. Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa bu uyumlulaştırma grubunun adını tıklayarak düzenleyin ve LY Ads Network'ü reklam kaynağı olarak ekleme bölümüne geçin.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.

Reklam biçiminizi ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın ve Reklam Birimleri Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizden biri veya daha fazlasıyla ilişkilendirin. Ardından Bitti'yi tıklayın.

Artık seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını göreceksiniz:

LY Ads Network'ü reklam kaynağı olarak ekleme

Teklif verme

Reklam Kaynakları bölümündeki Teklifli Sistem kartında Reklam kaynağı ekle'yi seçin. Ardından LY Ads Network'ü seçin. .

İş ortaklığı sözleşmesi nasıl imzalanır? düğmesini tıklayın ve LY Ads Network ile teklifli sistem iş ortaklığını ayarlayın.



Onayla ve kabul et'e, ardından Devam'ı tıklayın.



LY Ads Network için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.



Ardından, önceki bölümde alınan Uygulama Kimliği ve Yuva Kimliği'ni girin. Ardından Bitti'yi tıklayın.

Şelale

Reklam Kaynakları bölümündeki Şelale kartında Reklam Kaynağı Ekle'yi seçin.

LY Ads Network'ü seçin ve Optimize et anahtarını etkinleştirin. LY Ads Network için reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde alınan API anahtarı kimliği ve API gizli anahtarı değerlerini girin. Ardından, LY Ads Network için bir eBGBM değeri girin ve Devam'ı tıklayın.




LY Ads Network için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.



Ardından, önceki bölümde alınan Uygulama Kimliği ve Yuva Kimliği'ni girin. Ardından Bitti'yi tıklayın.

3. adım: LY Ads Network SDK'sını ve bağdaştırıcısını içe aktarın

Android Studio entegrasyonu (önerilir)

Uygulama düzeyindeki Gradle dosyanıza aşağıdaki uygulama bağımlılıklarını ekleyin:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:line:3.1.0.0")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'com.google.ads.mediation:line:3.1.0.0'
}

Manuel entegrasyon

1. .aar LY Ads Network SDK'sının en son sürümünü indirin ve projenize ekleyin.

2. Google'ın Maven deposunda LY Ads Network bağdaştırıcı yapılarına gidin. En son sürümü seçin, LY Ads Network bağdaştırıcısının .aar dosyasını indirip projenize ekleyin.

4. adım: Gerekli kodu ekleyin

LY Ads Network entegrasyonu için ek kod gerekmez.

5. adım: Uygulamanızı test edin

Test reklamlarını etkinleştirme

AdMob için test cihazınızı kaydettiğinizden emin olun.

LY Ads Network bağdaştırıcısı, LY Ads Network için test modunu etkinleştirmeye yardımcı olan bir yöntem içerir. Bu seçeneği, LY Ads Network SDK'ya düzgün şekilde yönlendirilmelerini sağlamak için başlatmadanGoogle Mobile Ads SDK önce ayarlamanız gerekir.

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

Test reklamlarını doğrulama

LY Ads Network'ten test reklamları aldığınızı doğrulamak için LY Ads Network reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özel parametreler

LY Ads Network bağdaştırıcısı, LineExtras sınıfı kullanılarak bağdaştırıcıya aktarılabilen ek bir istek parametresini destekler. Bu sınıf oluşturucu aşağıdaki parametreleri içerir:

enableAdSound

Banner, geçiş reklamı ve ödüllü reklamların varsayılan ses başlangıç durumunu belirtmek için

boolean.

Aşağıda, bu parametreleri ayarlayan bir reklam isteğinin nasıl oluşturulacağına dair bir kod örneği verilmiştir:

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

Doğal reklamları kullanma

Reklam oluşturma

LY Ads Network bağdaştırıcısı, NativeAd için aşağıdaki yerel reklamlar gelişmiş alan açıklamalarını doldurur.

¹ Yerel reklamlarda LY Ads Network SDK, uygulama simgesi öğesi sağlamaz. Bunun yerine, LY Ads Network bağdaştırıcısı, uygulama simgesini şeffaf bir resimle doldurur.

Hata kodları

Adaptör LY Ads Network'ten reklam alamıyorsa aşağıdaki sınıflarda ResponseInfo.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

Bir reklam yüklenemediğinde LY Ads Network bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

LINE Android Uyumlulaştırma Adaptörü Değişiklik Günlüğü

Sonraki sürüm

• Maps AgeRestrictedTreatment, Line'ın ChildDirectedTreatment API'siyle eşlenir.

Sürüm 3.1.1.0 (Devam ediyor)

Sürüm 3.1.0.0

• GMA Yeni Nesil SDK bağımlılığıyla bağdaştırıcıyı oluşturmak için özellik eklendi.
• FiveAd SDK'sının 3.1.0.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı sürüm 25.1.0.
• Google Mobil Reklamlar Yeni Nesil SDK'sı 0.25.0-beta01 sürümü.
• FiveAd SDK'sı 3.1.0.0 sürümü.

Sürüm 3.0.1.2

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı sürüm 25.1.0.
• FiveAd SDK'sı 3.0.1.2 sürümü.

Sürüm 3.0.1.1

• Google Mobile Ads SDK'sı v24.4.0 veya üstü kullanılırken artık doğal reklam gösterimleri FiveAd SDK tarafından geçersiz kılınıyor.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.9.0 sürümü.
• FiveAd SDK sürümü 3.0.1.1.

Sürüm 3.0.1.0

• tagForUnderAgeOfConsent Google Mobile Ads SDK parametresinin FiveAd SDK'sına yönlendirilmesi için destek eklendi.
• FiveAd SDK'sının 3.0.1.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.9.0 sürümü.
• FiveAd SDK'sı 3.0.1.0 sürümü.

Sürüm 3.0.0.0

• FiveAd SDK'sının 3.0.0.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.9.0 sürümü.
• FiveAd SDK'sı 3.0.0.0 sürümü.

Sürüm 2.9.20251028.0

• FiveAd SDK'sının 2.9.20251028 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.7.0 sürümü.
• FiveAd SDK sürümü 2.9.20251028.0

Sürüm 2.9.20250924.1

• Bağlam ile ilgili sınıf düzeyindeki referanslar kaldırıldı. Bellek sızıntısı sorunlarının azaltılmasına yardımcı olabilir.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.7.0 sürümü.
• FiveAd SDK sürümü 2.9.20250924.1.

Sürüm 2.9.20250924.0

• FiveAd SDK'sının 2.9.20250924 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.6.0 sürümü.
• FiveAd SDK sürümü 2.9.20250924.0

Sürüm 2.9.20250718.0

• FiveAd SDK'sının 2.9.20250718 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.3.0 sürümü.
• FiveAd SDK sürümü 2.9.20250718.0.

Sürüm 2.9.20250519.0

• FiveAd SDK'sının 2.9.20250519 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.3.0 sürümü.
• FiveAd SDK sürümü 2.9.20250519.0.

Sürüm 2.9.20250317.1

• Yeni FiveAd API ile teklifli reklamlar için banner yükleme boyutlarını düzeltir.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.1.0 sürümü.
• FiveAd SDK sürümü 2.9.20250317.0

Sürüm 2.9.20250317.0

• FiveAd SDK'sının 2.9.20250317 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.1.0 sürümü.
• FiveAd SDK sürümü 2.9.20250317.0

Sürüm 2.9.20250110.1

• Gerekli minimum Android API düzeyi 23 olarak güncellendi.
• Zorunlu olan minimum Google Mobile Ads SDK sürümü 24.0.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 24.0.0 sürümü.
• FiveAd SDK'sı 2.9.20250110.0 sürümü

Sürüm 2.9.20250110.0

• Desteği sonlandırılan UnifiedNativeAdMapper sınıfı, NativeAdMapper sınıfı lehine kaldırıldı.
• Sinyal toplama süreci düzeltildi.
• Şelale geçiş reklamı ve ödüllü reklam biçimleri için sabit başlatma süreci.
• FiveAd SDK'sının 2.9.20250110 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 23.6.0 sürümü.
• FiveAd SDK'sı 2.9.20250110.0 sürümü

Sürüm 2.9.20241129.0

• Banner, geçiş reklamı, ödüllü reklam ve yerel reklam biçimleri için teklif desteği eklendi.
• FiveAd SDK'sının 2.9.20241129 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 23.5.0 sürümü.
• FiveAd SDK sürümü 2.9.20241129.0

Sürüm 2.8.20240827.0

• FiveAd SDK'sının 2.8.20240827 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 23.3.0 sürümü.
• FiveAd SDK'sı 2.8.20240827.0 sürümü

Sürüm 2.8.20240808.0

• FiveAd SDK'sının 2.8.20240808 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 23.2.0 sürümü.
• FiveAd SDK'sı 2.8.20240808.0 sürümü

Sürüm 2.8.20240722.0

• FiveAd SDK'sının 2.8.20240722 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 23.2.0 sürümü.
• FiveAd SDK sürümü 2.8.20240722.0

Sürüm 2.7.20240515.0

• FiveAd SDK'sının 2.7.20240515 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 23.1.0 sürümü.
• FiveAd SDK sürümü 2.7.20240515.0

Sürüm 2.7.20240214.1

• Zorunlu olan minimum Google Mobile Ads SDK sürümü 23.0.0 olarak güncellendi.
• FiveAd SDK'sının 2.7.20240214 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 23.0.0 sürümü.
• FiveAd SDK sürümü 2.7.20240214.0.

Sürüm 2.7.20240214.0

• FiveAd SDK'sının 2.7.20240214 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 22.6.0 sürümü.
• FiveAd SDK sürümü 2.7.20240214.0.

Sürüm 2.7.20240126.0

• FiveAd SDK'sının 2.7.20240126 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 22.6.0 sürümü.
• FiveAd SDK sürümü 2.7.20240126.0.

Sürüm 2.7.20240112.0

• FiveAdViewEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener ve FiveAdNativeEventListener lehine, desteği sonlandırılan FiveAdCustomLayoutEventListener kaldırıldı.
• FiveAd SDK'sının 2.7.20240112 sürümüyle uyumluluğu doğrulandı.
• Zorunlu olan minimum Google Mobile Ads SDK sürümü 22.6.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 22.6.0 sürümü.
• FiveAd SDK sürümü 2.7.20240112.

Sürüm 2.6.20230607.1

• Yayıncıların banner, geçiş ve ödüllü reklam biçimleri için varsayılan ses ayarlarını tanımlayabileceği LineExtras sınıfı eklendi.
• Zorunlu olan minimum Google Mobile Ads SDK sürümü 22.4.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 22.4.0 sürümü.
• FiveAd SDK sürümü 2.6.20230607.

Sürüm 2.6.20230607.0

• İlk sürüm.
• Banner, geçiş reklamı, ödüllü reklam ve yerel reklam biçimleri için destek ekler.
• FiveAd SDK'sının 2.6.20230607 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

• Google Mobile Ads SDK'sı 22.1.0 sürümü.
• FiveAd SDK sürümü 2.6.20230607.