Satırı uyumlulaştırmayla entegre etme (Beta)

Bu kılavuzda, Satır'dan reklamları yüklemek ve görüntülemek için AdMob Uyumlulaştırması, şelale entegrasyonlarını kapsayan Google Mobile Ads SDK'sını nasıl kullanacağınız gösterilmektedir. Bu kılavuzda, reklam biriminin uyumlulaştırma yapılandırmasına satır ekleme ve Line SDK ile bağdaştırıcının bir uygulamaya Android entegre edilmesi ele alınmaktadır.

Line kontrol paneli arayüzünde etiketler, düğmeler ve açıklamalar için Japonca metin kullanılır. Bu kılavuzda yer alan ekran görüntüleri çevrilmemiştir. Ancak bu kılavuzun açıklamalarında ve talimatlarında etiketler ile düğmeler, parantez içinde İngilizce karşılıklarıyla birlikte çevrilmiştir.

Desteklenen entegrasyonlar ve reklam biçimleri

Line için uyumlulaştırıcı bağdaştırıcının özellikleri şunlardır:

Entegrasyon
Teklif verme
Şelale  1
Formatlar
Banner
Geçiş reklamı
Ödüllü
Yerel biçim

1 Şelale entegrasyonu açık beta sürümündedir.

Şartlar

  • Android API düzeyi 21 veya sonraki sürümler

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

Line hesabınıza giriş yapın.

Yeni uygulama ekleme

広告枠管理 (Reklam Alanı Yönetimi) > メディア (Medya)'yı tıklayın. Ardından, DELETE規工成 (Yeni Oluştur) seçeneğini tıklayın.

Formu doldurun ve グ (Register) (Kaydol) seçeneğini tıklayın.

Uygulama kimliğini not edin.

Reklam yerleşimi oluşturma

Reklam yerleşimi eklemek istediğiniz uygulamanın kimliğini tıklayın. Ardından, 詳細 (Ayrıntı) seçeneğini belirleyin.

Trackingロット 追加 (Slot Ekle) seçeneğini tıklayın.

Formu doldurun ve doldurduktan sonra (登録) Kaydol'u tıklayın.

Slot kimliğini not edin.

2. adım: AdMob kullanıcı arayüzünde satır talebini ayarlayın

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

Reklam biriminizin uyumlulaştırma yapılandırmasına Line 'ı eklemeniz gerekiyor.

İlk olarak, 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 grubunu düzenlemek için grubun adını tıklayın ve Reklam kaynağı olarak Line ekle bölümüne atlayın.

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

Reklam biçimini 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 bir veya daha fazla AdMob reklam biriminizle ilişkilendirin. Ardından Bitti'yi tıklayın.

Şimdi, seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını görmeniz gerekir:

Reklam kaynağı olarak Line ekleyin

Reklam Kaynakları bölümündeki Şelale kartının altından Reklam Kaynağı Ekle'yi seçin. Ardından Line simgesini seçin.

Line'i seçin. ArdındanLine için bir eBGBM değeri girip Devam'ı tıklayın.

Lineiçin zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.

Sonra, önceki bölümde aldığınız Application ID and Slot ID kodunu girin. Ardından Bitti'yi tıklayın.

3. Adım: Line SDK'sını ve Bağdaştırıcıyı içe aktarın

Uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıkları ve yapılandırmaları ekleyin. Line SDK ve bağdaştırıcının en son sürümlerini kullanın:

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

Manuel entegrasyon

  1. Line SDK'nın .aar dosyasının en son sürümünü indirip projenize ekleyin.

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

4. adım: Gerekli kodu ekleyin

Line 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.

Line test reklamlarını etkinleştirmeyle ilgili Line dokümanlarındaki talimatları uygulayın.

Test reklamlarını doğrulama

Line'dan test reklamları aldığınızı doğrulamak için Line (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özgü parametreler

Satır bağdaştırıcısı, LineExtras sınıfı kullanılarak bağdaştırıcının aktarabileceği 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 bir boolean.

Aşağıda, bu parametreleri ayarlayan bir reklam isteği oluşturmaya dair bir kod örneği verilmiştir:

Java

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

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

Kotlin

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

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

Doğal reklamları kullanma

Reklam oluşturma

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

Alan Satır bağdaştırıcısı tarafından her zaman dahil edilen öğeler
Başlık
Resim
Metin
Uygulama simgesi 1
Harekete geçirici mesaj
Yıldızlı değerlendirme
Depolama
Fiyat

1 Yerel reklamlar için Line SDK'sı uygulama simgesi öğesi sağlamaz. Bunun yerine, Line bağdaştırıcısı uygulama simgesini şeffaf bir resimle doldurur.

Hata kodları

Bağdaştırıcı, Line'dan reklam alamazsa aşağıdaki sınıfların altında ResponseInfo.getAdapterResponses() kodunu kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

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

Bir reklam yüklenemezse satır bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

Hata kodu Alan Neden
1-10 com.five_corp.ad Line SDK'sı, SDK'ya özgü bir hata döndürmüştür. Daha fazla ayrıntı için Line'ın belgelerine göz atın.
101 com.google.ads.mediation.line Uygulama kimliği eksik veya geçersiz.
102 com.google.ads.mediation.line Eksik veya geçersiz Slot kimliği.
103 com.google.ads.mediation.line İstenen reklam boyutu, satır tarafından desteklenen bir banner reklam boyutuyla eşleşmiyor.
104 com.google.ads.mediation.line Etkinlik bağlamı eksik olduğundan geçiş reklamı veya ödüllü reklam yüklenemedi.
105 com.google.ads.mediation.line Line 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.

LINE Android Uyumlulaştırıcı Bağdaştırıcısı Değişiklik Günlüğü

Sonraki Sürüm

  • Banner reklamlar için GZT'yi etkinleştirmek üzere AdLoader uygulandı.
  • Geçiş reklamları için GZT'yi etkinleştirmek üzere AdLoader uygulandı.
  • Ödüllü reklamlar için GZT'yi etkinleştirmek üzere AdLoader uygulandı.
  • Doğal reklamlar için GZT'yi etkinleştirmek üzere AdLoader uygulandı.

Sürüm 2.8.20240827.0

  • FiveAd SDK'sının 2.8.20240827.0 sürümü ile uyumluluk doğrulandı

Aşağıdakilerle derlenip test edildi:

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

Sürüm 2.8.20240808.0

  • FiveAd SDK sürümü 2.8.20240808.0 ile uyumluluğu doğrulandı

Aşağıdakilerle tasarlanıp test edilmiştir:

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

Sürüm 2.8.20240722.0

  • FiveAd SDK'sının 2.8.20240722.0 sürümü ile uyumluluk doğrulandı

Aşağıdakilerle tasarlanıp test edilmiştir:

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

Sürüm 2.7.20240515.0

  • FiveAd SDK sürümü 2.7.20240515.0 ile uyumluluğu doğrulandı

Aşağıdakilerle derlenip test edildi:

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

Sürüm 2.7.20240214.1

  • Zorunlu minimum Google Mobile Ads SDK sürümü 23.0.0 olarak güncellendi.
  • FiveAd SDK 2.7.20240214.0 sürümü ile uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp 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.0 sürümü ile uyumluluk doğrulandı.

Aşağıdakilerle tasarlanıp 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.0 sürümü ile uyumluluk doğrulandı.

Aşağıdakilerle derlenip test edildi:

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

Sürüm 2.7.20240112.0

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

Aşağıdakilerle tasarlanıp 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ımlayabilmesi amacıyla LineExtras sınıfı eklendi.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 22.4.0 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı sürüm 22.4.0.
  • 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ü ve yerel reklam biçimleri için destek ekler.
  • FiveAd SDK 2.6.20230607 sürümü ile uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

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