Bu kılavuzda, AdMob aracılığı ile şelale entegrasyonlarını kapsayacak şekilde LINE Ads Network'ten reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sını nasıl kullanacağınız gösterilmektedir. Bu dokümanda, LINE Ads Network'ün bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve LINE Ads Network SDK'sının ve bağdaştırıcısının bir Android uygulamasına nasıl entegre edileceği açıklanmaktadır.
LINE Ads Network'ün kontrol paneli arayüzünde etiketler, düğmeler ve açıklamalar için Japonca metin kullanılır. Bu kılavuzdaki ekran görüntüleri çevrilmemiştir. Ancak bu kılavuzdaki açıklamalarda ve talimatlarda etiketler ve düğmeler, İngilizce dilindeki karşılıklarıyla birlikte parantez içinde ç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 | 1 |
Şelale | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Yerel biçim |
1 Teklif verme entegrasyonu Kapalı Beta sürümündedir. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.
Şartlar
- Android API düzeyi 23 veya üstü
En yeni Google Mobile Ads SDK'sı
Uyumlulaştırma Başlangıç Kılavuzu'nu tamamlayın.
1. adım: LINE Ads Network kullanıcı arayüzünde yapılandırmaları ayarlayın
LINE Ads Network hesabınıza kaydolun ve giriş yapın.
Yeni uygulama ekleme
広告枠管理 (Ad Slot Management) > メディア (Media)'yı tıklayın. Ardından 新規作成 (Yeni Oluştur)'u tıklayın.
Formu doldurun ve 登録 (Kaydol)'u 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.
スロット 追加 (Add Slot) (Alan Ekle) seçeneğini 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 登録 (Register) seçeneğini tıklayın.
Yuva kimliğini 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.
Henüz yapmadıysanız
uygulamanız için bir app-ads.txt dosyası oluşturun.
LINE 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 LINE Ads Network talebini ayarlayın
Reklam biriminiz için aracılık ayarlarını yapılandırma
LINE Ads Network'ü reklam biriminizin aracılık yapılandırmasına eklemeniz gerekir.
Öncelikle AdMob hesabınızda oturum açın. Ardından Aracılık 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 LINE 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, aracılık 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örmelisiniz:
LINE 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 LINE Ads Network'ü seçin .İş ortaklığı sözleşmesi nasıl imzalanır?'ı tıklayın ve LINE Ads Network ile teklifli sistem iş ortaklığı kurun.

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

LINE 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 aldığınız 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.
LINE Ads Network'ü seçin ve Optimize anahtarını etkinleştirin. LINE Ads Network için reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde aldığınız Giriş adı ve Şifre'yi girin. 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 bu eşlemeyi seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde uygulama kimliğini ve yuva 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
Android Studio entegrasyonu (önerilir)
Uygulama düzeyindeki build.gradle.kts
dosyanıza aşağıdaki uygulama bağımlılıklarını ve yapılandırmalarını ekleyin. LINE Ads Network SDK'sının ve bağdaştırıcısının en yeni sürümlerini kullanın:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.google.ads.mediation:line:2.9.20250718.0")
}
Manuel entegrasyon
LINE Ads Network SDK's
.aar
dosyasının en son sürümünü indirip projenize ekleyin.Google'ın Maven deposunda LINE Ads Network bağdaştırıcı yapılarına gidin. En son sürümü seçin, LINE Ads Network bağdaştırıcısının
.aar
dosyasını indirip 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 reklam inceleyicide LINE Ads Network (Şelale) reklam kaynaklarını kullanarak tek reklam kaynağı testini etkinleştirin.
İsteğe bağlı adımlar
Ağa özel parametreler
LINE 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:
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ı, aşağıdaki
yerel reklamlar gelişmiş alan açıklamalarını
bir
NativeAd
için 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 Yerel reklamlar için LINE Ads Network SDK, 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üklenemediğinde LINE Ads Network bağdaştırıcısı tarafından oluşturulan kodlar ve ilgili mesajlar aşağıda verilmiştir:
Hata kodu | Alan | Neden |
---|---|---|
1-10 | com.five_corp.ad | LINE Ads Network SDK, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için LINE Ads Network'ün belgelerini inceleyin. |
101 | com.google.ads.mediation.line | Uygulama kimliği eksik veya geçersiz. |
102 | com.google.ads.mediation.line | Yuva kimliği eksik veya geçersiz. |
103 | com.google.ads.mediation.line | İstenen reklam boyutu, LINE Ads Network'ün desteklediği bir banner reklam boyutuyla eşleşmiyor. |
104 | com.google.ads.mediation.line | Eksik etkinlik bağlamı nedeniyle bir geçiş reklamı veya ödüllü reklam yüklenemedi. |
105 | com.google.ads.mediation.line | LINE Ads Network SDK, 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 Aracılık Adaptörü Değişiklik Günlüğü
Sürüm 2.9.20250718.0
- FiveAd SDK sürümü 2.9.20250718 ile uyumluluğu doğrulandı.
Aşağıdakilerle tasarlanıp 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ürümü 2.9.20250519 ile uyumluluğu doğrulandı.
Aşağıdakilerle tasarlanıp 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 tasarlanıp 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ürüm 2.9.20250317 ile uyumluluğu doğrulandı.
Aşağıdakilerle tasarlanıp 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ı sürümü 24.0.0 olarak güncellendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 24.0.0 sürümü.
- FiveAd SDK sürümü 2.9.20250110.0
Sürüm 2.9.20250110.0
- Kullanımdan kaldı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ürümü 2.9.20250110 ile uyumluluk doğrulandı.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 23.6.0 sürümü.
- FiveAd SDK sürümü 2.9.20250110.0
Sürüm 2.9.20241129.0
- Banner, geçiş reklamı, ödüllü reklam ve doğal reklam biçimleri için teklif desteği eklendi.
- FiveAd SDK'nın 2.9.20241129 sürümüyle 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'nın 2.8.20240827 sürümüyle uyumluluğu 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 2.8.20240808 sürümüyle 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 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.20240722.0
Sürüm 2.7.20240515.0
- FiveAd SDK sürüm 2.7.20240515 ile uyumluluk 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 olan minimum Google Mobile Ads SDK'sı sürümü 23.0.0 olarak güncellendi.
- FiveAd SDK sürümü 2.7.20240214 ile uyumluluk 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ürümü 2.7.20240214 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'nın 2.7.20240126 sürümüyle 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.20240126.0.
Sürüm 2.7.20240112.0
FiveAdCustomLayoutEventListener
,FiveAdVideoRewardEventListener
,FiveAdInterstitialEventListener
veFiveAdNativeEventListener
lehine, desteği sonlandırılanFiveAdViewEventListener
kaldırıldı.- FiveAd SDK sürüm 2.7.20240112 ile uyumluluğu doğrulandı.
- Zorunlu olan minimum Google Mobile Ads SDK'sı 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ımlayabileceği
LineExtras
sınıfı eklendi. - Zorunlu olan minimum Google Mobile Ads SDK'sı 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.
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ürüm 2.6.20230607 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.