Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

LY'yi uyumlulaştırma ile entegre etme

Platform seçin: Android iOS Unity Flutter Android (Eski)

Bu kılavuzda, şelale entegrasyonlarını kapsayan AdMob Uyumlulaştırması'nı kullanarak LY Reklam Ağı'ndan reklam yüklemek ve göstermek için GMA Next-Gen SDK ürününü nasıl kullanacağınız gösterilmektedir. 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 reklam ağı için uyumlulaştırma bağdaştırıcısının özellikleri şöyledir:

Entegrasyon
Teklifli sistem
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü
Yerel biçim

Ön koşullar

Devam etmeden önce aşağıdakileri doğrulayın:

Android API düzeyi 24 veya sonraki sürümler
[Teklifli sistem için]: Teklifli sistemde desteklenen tüm reklam biçimlerini entegre etmek için LY Reklam Ağı bağdaştırıcısı 2.9.20241129.0 veya sonraki sürümleri kullanın (en yeni sürüm önerilir).

En yeni GMA Next-Gen SDK sürümü.
AdMob Uyumlulaştırması'nı ayarlayın.

1. adım: LY Reklam Ağı kullanıcı arayüzünde yapılandırmaları ayarlayın

LY Reklam Ağı hesabınıza kaydolun ve giriş yapın.

Yeni uygulama ekleme

App (Uygulama) sekmesine gidin ve New registration (Yeni kayıt) düğmesini tıklayın.

Yeni Kayıt

Formu doldurup Kayıt'ı tıklayın.

Yeni Kayıt Formu

Uygulama kimliğini not edin.

Kayıt Bilgileri

Reklam alanı oluşturma

Uygulama sekmesinde uygulamanızı seçerek ayrıntılarını görüntüleyin. Alan bölümünde Ekle'yi tıklayın.

Alan ekle

Saat dilimiyle 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 bu alanı teklifli sistem için yapılandırmak üzere Google SDK Teklif Sistemi'ni seçin. Form doldurulduktan sonra Oluştur'u tıklayın.

Alan Ekleme Formu

Alan kimliğini not edin.

Alan Ayrıntıları

İlk alanınızı oluşturduktan sonra LY Reklam Ağı'ndan 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 Reklam Ağı temsilcinizle iletişime geçin.

İnceleme İsteğinde Bulun

Reporting API anahtarı oluşturma

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

Reporting API Key Tab

Formu doldurup Kaydet'i tıklayın.

Reporting API Key Form

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

Reporting API Key Form

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 Reklam Ağı için app-ads.txt dosyasını uygulamak üzere app-ads.txt hakkında başlıklı makaleyi inceleyin.

2. adım: AdMob kullanıcı arayüzünde LY Reklam Ağı talebini ayarlayın

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

LY Ads Network'ü reklam biriminizin uyumlulaştırma 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ünde Teklifli Sistem kartını bulun ve 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 Reklam Ağı ile teklifli sistem iş ortaklığını ayarlayın.

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

LY Reklam Ağı 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 Alan 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 Reklam Ağı'nı seçin ve Optimize et anahtarını etkinleştirin. LY Ads Network için reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde elde edilen API anahtarı kimliği ve API gizli anahtarı'nı girin. Ardından LY Reklam Ağı için bir eBGBM değeri girin ve Devam'ı tıklayın.

LY Reklam Ağı 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 Alan Kimliği'ni girin. Ardından Bitti'yi tıklayın.

Not: Reklam kaynağı optimizasyonunun bir uyumlulaştırma ağı için eBGBM'yi doğru şekilde hesaplamaya yetecek kadar veri toplaması birkaç gün sürer. Bu süre zarfında reklam kaynağı optimizasyon durumu PENDING olur. Bu nedenle, ağ için manuel olarak bir eBGBM değeri ayarlamanız gerekir. eBGBM hesaplanabildiğinde reklam kaynağı, eBGBM'yi sizin adınıza otomatik olarak güncellemeye başlar.

3. adım: LY Reklam Ağı 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ı ve yapılandırmaları ekleyin:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Modern

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Manuel entegrasyon

LY Reklam Ağı SDK'sının en yeni sürümünün .aar dosyasını indirip projenize ekleyin.
Google'ın Maven deposunda LY Ads Network bağdaştırıcı yapılarına gidin. En yeni sürümü seçin, LY Reklam Ağı bağdaştırıcısının .aar dosyasını indirin ve projenize ekleyin.

4. adım: Gerekli kodu ekleyin

LY Reklam Ağı 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 Reklam Ağı bağdaştırıcısı, LY Ads Reklam Ağı için test modunu etkinleştiren bir yardımcı yöntem içerir. LY Reklam Ağı SDK'sına düzgün şekilde yönlendirilmelerini sağlamak için GMA Next-Gen SDK ilk kullanıma hazırlamadan önce bu seçeneği ayarlamanız gerekir.

Java

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

Kotlin

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 Reklam Ağı bağdaştırıcısı, LineExtras sınıfı kullanılarak bağdaştırıcıya iletilebilen ek bir istek parametresini destekler. Bu sınıf oluşturucu, aşağıdaki parametreleri içerir:

enableAdSound: Banner, geçiş ve ödüllü reklamların varsayılan ses başlangıç durumunu belirtmek için kullanılan boolean.

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

Java

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

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

Kotlin

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 gelişmiş doğal reklam alan açıklamalarını doldurur.

Alan	LY Reklam Ağı bağdaştırıcısı tarafından her zaman dahil edilen öğeler
Başlık
Resim
Body
Uygulama simgesi	¹
Harekete geçirici mesaj
Yıldız puanı
Mağaza
Fiyat

¹ Doğal reklamlar için LY Ads Network SDK'sı, uygulama simgesi öğesi sağlamaz. Bunun yerine, LY Ads Network reklam ağı bağdaştırıcısı uygulama simgesini şeffaf bir resimle doldurur.

Hata kodları

Adaptör LY Reklam Ağı'ndan reklam alamıyorsa aşağıdaki sınıflarda ResponseInfo.getAdSourceResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

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

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

Hata kodu	Alan adı	Neden
1-10	com.five_corp.ad	LY Reklam Ağı SDK'sı, SDK'ya özgü bir hata döndürdü. Daha fazla bilgi için LY Ads Network'ün belgelerini inceleyin.
101	com.google.ads.mediation.line	Uygulama kimliği eksik veya geçersiz.
102	com.google.ads.mediation.line	Alan kimliği eksik veya geçersiz.
103	com.google.ads.mediation.line	İstenen reklam boyutu, LY Ads Network tarafından desteklenen bir banner reklam boyutuyla eşleşmiyor.
104	com.google.ads.mediation.line	Eksik etkinlik bağlamı nedeniyle geçiş reklamı veya ödüllü reklam yüklenemedi.
105	com.google.ads.mediation.line	LY Reklam Ağı SDK'sı, geçiş reklamı veya ödüllü reklam gösteremedi.
106	com.google.ads.mediation.line	Eksik öğeler nedeniyle doğal reklam yüklenemedi.
107	com.google.ads.mediation.line	FiveAd SDK'sı boş bir reklam yükleyici döndürdü.