Bu sayfa, Cloud Translation API ile çevrilmiştir.

Satırı Uyumlulaştırma ile Entegre Etme (Beta)

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 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	¹
Formatlar
Banner
Geçiş reklamı
Ödüllü
Yerel biçim

¹ Şelale 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 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: Ad Manager kullanıcı arayüzünde satır talebini ayarlayın

Ad Manager hesabınızda oturum açın.

Şirketlere satır 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 Satır'ı 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.

Satır 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 Satır'ı 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ındaki Satır için şirketi 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 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 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

Ad Manager 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();

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

Satır bağdaştırıcısı, NativeAd için aşağıdaki alanları doldurur.

Alan	Satır bağdaştırıcısı tarafından her zaman dahil edilen öğeler
Başlık
Resim
Metin
Uygulama simgesi	¹
Harekete geçirici mesaj
Yıldızlı değerlendirme
Depolama
Fiyat

¹ 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üğü