Bu kılavuz, uyumlulaştırma kullanarak LINE Ads Network'ten reklam yüklemek ve göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağını şelale entegrasyonlarını kapsayarak açıklar. Bu açıklamalar, LINE Ads Network'ün bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini 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ğini kapsar.
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 uyumlaştırma adaptörünün özellikleri şöyledir:
Entegrasyon | |
---|---|
Teklifli sistem | |
Şelale | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Yerel biçim | 1 |
1 Yerel reklamlar (teklif verme için) kapalı beta sürümündedir. Erişimi talep etmek için hesap yöneticinizle iletişime geçin.
Şartlar
- Android API düzeyi 23 veya üstü
En son Google Mobile Ads SDK'sı
Uyumlulaştırma Başlangıç Kılavuzunu tamamlama
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) (Yuva 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 bu alanı 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
Ad Manager 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: Ad Manager kullanıcı arayüzünde LINE Ads Network talebini ayarlayın
Ad Manager hesabınızda oturum açın.
Şirketlere LINE Ads Network'ü ekleme
Teklif verme
Bu adım, teklif entegrasyonları için gerekli değildir.
Şelale
Yönetici > Şirketler'e gidin ve Tüm şirketler sekmesinde Yeni şirket düğmesini tıklayın. Reklam ağı'nı seçin.
Reklam ağı olarak LINE Ads Network'ü seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin. Otomatik veri toplama'yı etkinleştirin ve önceki bölümde alınan Giriş adı ile Şifre'yi girin.
Kullanıcı adı veya şifre girmeniz gerekmez. İşlemi tamamladığınızda Kaydet'i tıklayın.
Güvenli sinyal paylaşımını etkinleştirme
Teklif verme
Yönetici > Genel ayarlar'a gidin. Ad Exchange hesap ayarları sekmesine gidip Güvenli sinyal paylaşımı'nı inceleyin ve etkinleştirin. Kaydet'i tıklayın.
Şelale
Bu adım, şelale entegrasyonları için gerekli değildir.
Teklif isteklerinde güvenli sinyal paylaşma
Teklif verme
Envanter > Güvenli Sinyaller'e gidin. Güvenli sinyaller bölümünde LINE'ı arayın ve Uygulama entegrasyonunu etkinleştir'i açın.
Kaydet'i tıklayın.
Şelale
Bu adım, şelale entegrasyonları için gerekli değildir.
SDK teklifli sistemi için güvenli sinyal paylaşımına izin verme
Teklif verme
Yayınlama > Talep kanalı ayarları'na gidin. Varsayılan ayarlar sekmesinde, SDK Bidding için Güvenli sinyal paylaşımına izin ver'i etkinleştirin.
Kaydet'i tıklayın.
Şelale
Bu adım, şelale entegrasyonları için gerekli değildir.
LINE Ads Network teklifini yapılandırma
Teklif verme
Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi'ne Git'i tıklayın.
Yeni teklif veren'i tıklayın.
Teklif veren olarak LINE Ads Network'ü seçin.
Bu teklif veren için SDK teklif verme özelliğini etkinleştirmek üzere Devam'ı tıklayın.
Bitti'yi tıklayın.
Şelale
Bu adım, şelale entegrasyonları için gerekli değildir.
Reklam birimi eşlemesini yapılandırma
Teklif verme
Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi'ne Git'i tıklayın.
LINE Ads Network için şirketi seçin.
Reklam birimi eşleme sekmesine gidin ve Yeni reklam birimi eşleme'yi tıklayın.
Belirli reklam birimi'ni seçin. Bir reklam birimi ve biçimi, Envanter türü olarak Mobil uygulama'yı ve Mobil uygulamanızı seçin. Ardından, önceki bölümde alınan Uygulama Kimliği ve Yuva Kimliği'ni girin. Son olarak Kaydet'i tıklayın.
Şelale
Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın. Mobil uygulamanızı seçin.
Aşağı kaydırıp Getiri iş ortağı ekle'yi tıklayın.
Önceki bölümde LINE Ads Network için oluşturduğunuz şirketi seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak Android'i ve Durum olarak Etkin'i seçin.
Önceki bölümde alınan Uygulama Kimliği ve Yuva Kimliği ile Varsayılan BGBM değerini girin. Kaydet'i tıklayın.
Not: Otomatik veri toplama özelliğinin bir uyumlulaştırma ağı için dinamik BGBM'yi doğru şekilde hesaplamadan önce veri toplaması birkaç gün sürebilir. eBGBM hesaplandığında sizin adınıza otomatik olarak güncellenir.
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ısı 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
Ad Manager 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 ö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();
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
Kotlin
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdManagerAdRequest.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
alanları
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ız puanı | |
Mağaza | |
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ı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 LINE Ads Network 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 | 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, bir geçiş reklamı veya ödüllü reklam gösteremedi. |
106 | com.google.ads.mediation.line | Eksik öğeler nedeniyle bir doğal reklam yüklenemedi. |
LINE Android Uyumlulaştırma Adaptörü Değişiklik Günlüğü
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ı sürüm 24.1.0.
- 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ı sürüm 24.1.0.
- 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 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
- 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ı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 doğal 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ı 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
FiveAdCustomLayoutEventListener
,FiveAdVideoRewardEventListener
,FiveAdInterstitialEventListener
veFiveAdNativeEventListener
lehine, desteği sonlandırılanFiveAdViewEventListener
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ı 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ı 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.