Satırı uyumlulaştırmayla entegre etme (Beta)

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 iOS uygulamasına nasıl entegre edileceği ele alınmaktadı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  1
Şelale  2
Formatlar
Banner  3
Geçiş reklamı  3
Ödüllü
Yerel biçim
1 teklifli sistem entegrasyonu kapalı beta sürümündedir. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.

2 Şelale entegrasyonu açık beta sürümündedir.

3 Bu biçim yalnızca şelale entegrasyonunda desteklenir.

Şartlar

  • iOS dağıtım hedefi 12.0 veya daha yeni bir sürüm olmalıdır.

  • [Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek üzere şu sürümleri kullanın: Satır bağdaştırıcısı 2.8.20240827.0 veya daha yeni sürümler (en son sürüm önerilir)

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

Projenizin Podfile dosyasına aşağıdaki satırı ekleyin:

pod 'GoogleMobileAdsMediationLine'

Komut satırından şunu çalıştırın:

pod install --repo-update

Manuel entegrasyon

  • Line SDK'sının en son sürümünü indirip projenize FiveAd.framework bağlayın.
  • Değişiklik günlüğündeki indirme bağlantısından satır bağdaştırıcının en son sürümünü indirin ve LineAdapter.framework dosyasını projenize bağlayın.

4. adım: Gerekli kodu ekleyin

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Line'ın belgelerini inceleyin.

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ı, GADMediationAdapterLineExtras sınıfı kullanılarak bağdaştırıcının aktarabileceği ek bir istek parametresini destekler. Bu sınıf aşağıdaki özellikleri içerir:

adAudio
Banner, geçiş ve ödüllü reklamların varsayılan ses başlangıç durumunu belirtir.

Aşağıda, bu parametreleri ayarlayan bir reklam isteği oluşturmaya dair bir kod örneği verilmiştir:

Swift

import LineAdapter
// ...

let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

Objective-C

#import <LineAdapter/LineAdapter.h>
// ...

GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

Doğal reklamları kullanma

Reklam oluşturma

Satır bağdaştırıcısı, GADNativeAd 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 GADResponseInfo.adNetworkInfoArray kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

GADMediationAdapterLine

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 Line SDK'sı tarafından gönderildi 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 Geçersiz sunucu parametreleri (ör. Uygulama Kimliği veya Slot Kimliği eksik).
102 com.google.ads.mediation.line İstenen reklam boyutu, satır tarafından desteklenen bir banner reklam boyutuyla eşleşmiyor.
103 com.google.ads.mediation.line Yerel reklama bilgi simgesi resim öğesi yüklenemedi.

LINE iOS Uyumlulaştırma Adaptörü Değişiklik Günlüğü

Sürüm 2.9.20241106.1

  • Uyumlatıcı, teklifli sistem banner reklamları için en son reklam yükleme API'sini kullanacak şekilde güncellendi.
  • Geçiş reklamları için teklif verme işleminde reklam etkinliklerinin doğru şekilde yönlendirilmesini engelleyen bir sorun düzeltildi.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 11.12.0 sürümü.
  • FiveAd SDK sürümü 2.9.20241106.

Sürüm 2.9.20241106.0

  • FiveAd SDK sürümü 2.9.20241106 ile uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 11.12.0 sürümü.
  • FiveAd SDK sürümü 2.9.20241106.

Sürüm 2.8.20240827.1

  • CFBundleShortVersionString, dört yerine üç bileşen içerecek şekilde güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 11.10.0 sürümü.
  • FiveAd SDK sürümü 2.8.20240827.

Sürüm 2.8.20240827.0

  • FiveAd SDK 2.8.20240827 sürümü ile uyumluluğu doğrulandı.
  • Banner, geçiş reklamı, ödüllü ve yerel reklam biçimleri için teklif verme desteği eklendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 11.8.0 sürümü.
  • FiveAd SDK sürümü 2.8.20240827.

Sürüm 2.8.20240612.0

  • GADVideoOptions aracılığıyla doğal reklam için ses kontrolü eklendi.
  • FiveAd SDK 2.8.20240612 sürümü ile uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 11.5.0 sürümü.
  • FiveAd SDK sürümü 2.8.20240612.

Sürüm 2.7.20240411.0

  • FiveAd SDK 2.7.20240411 sürümü ile uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 11.3.0 sürümü.
  • FiveAd SDK sürümü 2.7.20240411.

Sürüm 2.7.20240318.0

  • FiveAd SDK 2.7.20240318 sürümü ile uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 11.2.0 sürümü.
  • FiveAd SDK sürümü 2.7.20240318.

Sürüm 2.7.20240214.1

  • Artık minimum iOS sürümü 12.0'dir.
  • Artık Google Mobile Ads SDK'sının 11.0 veya daha yeni bir sürümü gereklidir.
  • LineAdapter.xcframework içindeki çerçevelere Info.plist dahil edildi.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 11.0.1 sürümü.
  • FiveAd SDK sürümü 2.7.20240214.

Sürüm 2.7.20240214.0

  • FiveAd SDK 2.7.20240214 sürümü ile uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 11.0.1 sürümü.
  • FiveAd SDK sürümü 2.7.20240214.

Sürüm 2.7.20240126.0

  • FiveAd SDK sürümü 2.7.20240126 ile uyumluluğu doğrulandı.
  • Adaptör uygulaması, FiveAd SDK'sının yeni temsilci protokolleriyle güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 10.14.0 sürümü.
  • FiveAd SDK sürümü 2.7.20240126.

Sürüm 2.7.20231115.0

  • FiveAd SDK 2.7.20231115 sürümü ile uyumluluğu doğrulandı.
  • modulemap dosyasına GADMediationAdapterLineExtras başlığı eklendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 10.14.0 sürümü.
  • FiveAd SDK sürümü 2.7.20231115.

Sürüm 2.6.20230609.1

  • Banner, geçiş reklamı ve ödüllü reklamın ilk kez gösterildiğindeki ilk ses durumunu yönetmek için GADMediationAdapterLineAudioState eklendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 10.14.0 sürümü.
  • FiveAd SDK sürümü 2.6.20230609.

Sürüm 2.6.20230609.0

  • İlk sürüm!
  • Banner, geçiş reklamı, ödüllü ve yerel reklam biçimleri için şelale desteği eklendi.
  • FiveAd SDK 2.6.20230609 sürümü ile uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı 10.9.0 sürümü.
  • FiveAd SDK sürümü 2.6.20230609.