Bu kılavuzda, şelale entegrasyonlarını kapsayan arabuluculuk 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 |
Ş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 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: 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, teklifli sistem entegrasyonları için gerekli değildir.
Şelale
Yönetici > Şirketler'e gidin ve ardından Tüm şirketler sekmesindeki Yeni şirket düğmesini tıklayın. Reklam ağı'nı seçin.
Reklam ağı olarak LINE Ads Network'i seçin, benzersiz bir ad girin ve Uyumlulaştırma'yı etkinleştirin.
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 gidin, Güvenli sinyal paylaşımı'nı inceleyip etkinleştirin. Kaydet'i tıklayın.
Şelale
Bu adım, şelale entegrasyonları için gerekli değildir.
LINE Ads Ağı teklifli sistemini yapılandırma
Teklif verme
Yayınlama > Teklif verenler'e gidin ve SDK Teklif Sistemi sekmesinin altında Yeni teklif veren'i tıklayın.
Teklif veren olarak LINE Ads Network'u seçin.
Bu teklif verenin sinyal kitaplığını izin verilen sinyaller listesine ekle ve Sinyallerin bu teklif verenle paylaşılmasına izin ver seçeneklerini etkinleştirin. Ardından Devam'ı tıklayın.
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 sekmesinin altında LINE Ads Network'ün şirketini seçin.
Reklam birimi eşleme sekmesine gidip Yeni reklam birimi eşleme'yi tıklayın.
Belirli bir 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 elde edilen uygulama kimliğini ve slot kimliğini 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ın ve 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 elde edilen uygulama kimliğini ve slot kimliğini, ayrıca varsayılan BGBM değerini girin. Kaydet'i 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 (önerilen)
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
LINE Ads Network SDK'sının
.aar
dosyasının en son sürümünü indirip projenize ekleyin.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
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 ö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();
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ı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 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ı 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.
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.