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 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
En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlama Başlangıç kılavuzu
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 新規作成 (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 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 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 bu uyumlulaştırma grubunun adını tıklayın ve Line'ı 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:
Satır'ı 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 Çizgi'yi seçin.
İş ortaklığı sözleşmesi imzalama'yı tıklayın ve Line ile teklifli sistem iş ortaklığı kurun.
Kabul ediyorum'u, ardından Devam'ı tıklayın.
Satır 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 Çizgi'yi seçin.
Satır'ı seçin. Ardından, satır için bir eBGBM değeri girin ve Devam'ı tıklayın.
Satır 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 elde edilen uygulama kimliğini ve slot kimliğini girin. Ardından Bitti'yi tıklayın.
3. Adım: Line SDK'sını ve bağdaştırıcısını içe aktarın
Android Studio entegrasyonu (önerilen)
Uygulama düzeyindeki build.gradle.kts
dosyanıza aşağıdaki uygulama bağımlılıkları ve yapılandırmaları ekleyin. Line 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.8.20240827.0")
}
Manuel entegrasyon
Line SDK'nın
.aar
dosyasının en son sürümünü indirip projenize ekleyin.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 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ğ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ı, 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ı
Adaptör, Line'dan 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 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 RTB'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ürümü 2.8.20240827.0 ile 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 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 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 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
veFiveAdNativeEventListener
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. - 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.