LINE Ads Network'i uyumlulaştırarak entegre etme (Beta)

Bu kılavuzda, şelale entegrasyonlarını kapsayan AdMob Uyumlulaştırma'yı kullanarak Line'dan 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, Line'ın bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Line SDK'sının ve bağdaştırıcının bir Android uygulamasına nasıl entegre edileceği açıklanmaktadır.

LINE Ads Network 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 Ads Network için uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

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 Ads Network kullanıcı arayüzünde yapılandırmaları ayarlayın

LINE Ads Network hesabınıza giriş yapın.

Yeni uygulama ekleme

広告枠管理 (Reklam Alanı Yönetimi) > メディア (Medya)'yı tıklayın. Ardından 新規作成 (Yeni Oluştur)'u tıklayın.

Formu doldurun ve 登録 (Register)'ı 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ı)'yı seçin.

スロット 追加 (Alan Ekle)'yi 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 LINE Ads Network 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 Ads Network'i 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 düzenlemek için ilgili uyumlulaştırma grubunun adını tıklayın ve LINE Ads Network'i 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 Birimi Ekle'yi tıklayın.

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

Artık reklam birimleri kartının, seçtiğiniz reklam birimleriyle doldurulduğunu göreceksiniz:

LINE Ads Network'i reklam kaynağı olarak ekleme

Teklif verme


Reklam Kaynakları bölümündeki Teklifli Sistem kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından LINE Ads Network'ü seçin.
İş ortaklığı sözleşmesi imzalama'yı tıklayın ve LINE Ads Network ile teklifli sistem iş ortaklığı kurun.
Kabul ediyorum'u, ardından Devam'ı tıklayın.
LINE Ads Network için zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde Eşleme ekle'yi tıklayın.
Ardından, önceki bölümde elde edilen uygulama kimliğini ve slot kimliğini girin. Ardından Bitti'yi tıklayın.

Şelale


Reklam Kaynakları bölümündeki Şelale kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından LINE Ads Network'u seçin.

LINE Ads Ağı'nı seçin. Ardından LINE Ads Network için bir eBGBM değeri girin ve Devam'ı tıklayın.



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

Ardından, önceki bölümde elde edilen uygulama kimliğini ve slot kimliğini girin. Ardından Bitti'yi tıklayın.


3. Adım: LINE Ads Network SDK'sını ve bağdaştırıcısını 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 Ads Network SDK'sının 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.6.0")
    implementation("com.google.ads.mediation:line:2.9.20241129.0")
}

Manuel entegrasyon

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

  2. Google'ın Maven deposunda LINE Ads Network adaptör yapılarına gidin. En son sürümü seçin, LINE Ads Network adaptörünün .aar dosyasını indirin ve projenize ekleyin.

4. adım: Gerekli kodu ekleyin

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

Test reklamlarını doğrulama

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

İsteğe bağlı adımlar

Ağa özgü parametreler

LINE Ads Network adaptörü, LineExtras sınıfı kullanılarak adaptöre aktarılabilen ek bir istek parametresini destekler. Bu sınıf kurucusu 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ğinin nasıl oluşturulacağına 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

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

Alan LINE Ads Network 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 LINE Ads Network SDK'sı, yerel reklamlar için uygulama simgesi öğesi sağlamaz. Bunun yerine LINE Ads Network bağdaştırıcısı, uygulama simgesini şeffaf bir resimle doldurur.

Hata kodları

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

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

Bir reklam yüklenemezse LINE Ads Network 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 Ads Network SDK'sı, SDK'ya özgü bir hata döndürmüştür. Daha fazla ayrıntı için LINE Ads Network'in dokümanlarına bakı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, LINE Ads Network 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 Ads Network 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

  • Sinyal toplama işlemi düzeltildi.

Sürüm 2.9.20241129.0

  • Banner, geçiş reklamı, ödüllü ve yerel reklam biçimleri için teklif verme desteği eklendi.
  • FiveAd SDK sürümü 2.9.20241129.0 ile uyumluluk doğrulandı

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

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

  • Google Mobile Ads SDK'sı 23.3.0 sürümü.
  • FiveAd SDK 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ürümü 2.8.20240722.0 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ü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 tasarlanıp 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 minimum Google Mobile Ads SDK sürümü 23.0.0 olarak güncellendi.
  • FiveAd SDK sürümü 2.7.20240214.0 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 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ı 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ürümü 2.7.20240126.0 ile uyumluluğu 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.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.

2.6.20230607.1 sürümü

  • 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.
  • Zorunlu minimum Google Mobile Ads SDK sürümü 22.4.0 olarak güncellendi.

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

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

2.6.20230607.0 sürümü

  • İ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.