LINE Ads Network'i 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 iOS 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  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

  • 12.0 veya sonraki bir iOS dağıtım hedefi

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

Hem teklifli sistem hem de şelale entegrasyonları için reklam yerleşimleri oluşturmak üzere aynı adımları uygulayın. Her reklam yerleşimi her ikisi için de kullanılabilir.

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.

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 teklifli sistemi için Güvenli sinyal paylaşımına izin ver seçeneğini 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'ne Git'i tıklayın.

Yeni teklif veren'i tıklayın.

Teklif veren olarak LINE Ads Network'u seçin.

Bu teklif veren için SDK Teklif Verme'yi 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 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 iOS'u 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

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 Ads Network SDK'sının en son sürümünü indirin ve projenize FiveAd.framework bağlama.
  • Değişiklik Günlüğü'ndeki indirme bağlantısından LINE Ads Network bağdaştırıcının en son sürümünü indirin ve projenize LineAdapter.framework bağlantısını ekleyin.

4. adım: Gerekli kodu ekleyin

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için LINE Ads Network'ün dokümanlarını inceleyin.

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ü, GADMediationAdapterLineExtras sınıfı kullanılarak adaptöre aktarılabilen 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 = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

Objective-C

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

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

Doğal reklamları kullanma

Reklam oluşturma

LINE Ads Network bağdaştırıcısı, GADNativeAd için aşağıdaki alanları doldurur.

Alan LINE Ads Ağı 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 GADResponseInfo.adNetworkInfoArray kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

GADMediationAdapterLine

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 LINE Ads Network SDK'sı tarafından gönderilir LINE Ads Network SDK'sı, SDK'ya özgü bir hata döndürmüştür. Daha fazla bilgi için LINE Ads Network'in dokümanlarına bakı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, LINE Ads Network 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üğü

Sonraki sürüm

  • FAD SDK'sının bağdaştırıcının kurulumuna kaydedilip kaydedilmediğini kontrol eden mantık kaldırıldı.
  • Geçiş reklamları ve ödüllü reklamların "show" API'si yeni "showWithViewController:" API ile güncellendi.
  • Desteği sonlandırıldığı ve yerine başka bir yöntem olmadığı için doğal reklam öğelerini indirmeden önce doğal reklam durumu kontrolü kaldırıldı.

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.
  • Reklam etkinliklerinin, geçiş reklamları için teklif verme işleminde 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 2.9.20241106 sürümü ile uyumluluk 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ı 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 2.7.20240126 sürümü ile uyumluluk 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 üstbilgisi 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.