LINE Ads Network'i uyumlulaştırma ile entegre etme

Bu kılavuzda, uyumlulaştırma kullanarak LINE Ads Network'ten reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı açıklanmaktadır. Kılavuzda, şelale entegrasyonları ele alınmaktadır. Bu dokümanda, LINE Ads Network'ün bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve LINE Ads Network SDK'sının ve bağdaştırıcısının Unity uygulamasına nasıl entegre edileceği açıklanmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

LINE Ads Network için AdMob uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif verme  1
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü

1 Teklif verme entegrasyonu Kapalı Beta sürümündedir. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.

Şartlar

  • En yeni Google Mobile Ads SDK'sı
  • Unity 4 veya daha yeni bir sürüm
  • [Teklif verme için]: Teklif verme işlemine desteklenen tüm reklam biçimlerini entegre etmek için LINE Ads SDK'sı 1.5.0 veya daha yeni bir sürüm için Google Mobile Ads uyumlulaştırma eklentisini kullanın (en yeni sürüm önerilir).
  • Android'de dağıtmak için
    • Android API düzeyi 23 veya üstü
  • iOS'te dağıtmak için
    • iOS 12.0 veya sonraki bir sürümün dağıtım hedefi
  • Google Mobile Ads SDK'sı ile yapılandırılmış çalışan bir Unity projesi. Ayrıntılar için Başlangıç bölümüne bakın.
  • Uyumlulaştırma Başlangıç Kılavuzu'nu tamamlayın.

1. adım: LINE Ads Network kullanıcı arayüzünde yapılandırmaları ayarlayın

LINE Ads Network hesabınıza kaydolun ve giriş yapın.

Yeni uygulama ekleme

広告枠管理 (Ad Slot Management) > メディア (Media)'yı tıklayın. Ardından 新規作成 (Yeni Oluştur)'u tıklayın.

Formu doldurun ve 登録 (Kaydol)'u 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.

スロット 追加 (Add Slot) (Alan Ekle) seçeneğini tıklayın.

Slotla ilgili ayrıntılar için formu doldurun. Teklif Türü için bu alanı şelale uyumlulaştırması için yapılandırmak üzere Standart'ı veya teklifli sistem için yapılandırmak üzere Google SDK Teklif Sistemi'ni seçin. Form doldurulduktan sonra 登録 (Register) seçeneğini tıklayın.

Yuva kimliğini not edin.

app-ads.txt dosyanızı güncelleme

Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt dosyası uygulamanız gerekir. Henüz yapmadıysanız uygulamanız için bir app-ads.txt dosyası oluşturun.

LINE Ads Network için app-ads.txt uygulamak üzere app-ads.txt hakkında başlıklı makaleyi inceleyin.

2. adım: AdMob kullanıcı arayüzünde LINE Ads Network talebini ayarlayın

Reklam biriminiz için aracılık ayarlarını yapılandırma

Android

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

Talimatlar için iOS kılavuzundaki 2. adıma bakın.

3. adım: LINE Ads Network SDK'sını ve bağdaştırıcısını içe aktarın

OpenUPM-CLI

OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak projenize Unity için Google Mobil Reklamlar LINE Ads Network Aracılık Eklentisi'ni yükleyebilirsiniz:

openupm add com.google.ads.mobile.mediation.line

OpenUPM

Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçerek Unity Paket Yöneticisi Ayarları'nı açın.

Scoped Registries (Kapsamlı Kayıtlar) sekmesinde, aşağıdaki ayrıntıları kullanarak OpenUPM'yi kapsamlı kayıt olarak ekleyin:

  • Ad: OpenUPM
  • URL: https://package.openupm.com
  • Kapsamlar: com.google

OpenUPM Ayrıntıları

Ardından, Pencere > Paket Yöneticisi'ne giderek Unity Paket Yöneticisi'ni açın ve açılır menüden Kayıtlarım'ı seçin.

Unity Registries

Google Mobile Ads Line Mediation paketini seçip Yükle'yi tıklayın.

OpenUPM'den yükleme

Unity paketi

LINE Ads Network için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü Değişiklik Günlüğü'ndeki indirme bağlantısından indirin ve zip dosyasından GoogleMobileAdsLineMediation.unitypackage dosyasını çıkarın.

Unity proje düzenleyicinizde Assets (Öğeler) > Import Package (Paket İçe Aktar) > Custom Package'ı (Özel Paket) seçin ve indirdiğiniz GoogleMobileAdsLineMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Unity'den içe aktarma

Ardından Assets (Öğeler) > External Dependency Manager (Harici Bağımlılık Yöneticisi) > Android Resolver (Android Çözücü) > Force Resolve'u (Çözümü Zorla) seçin. External Dependency Manager kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

Çözüme Zorla

4. adım: Gerekli kodu ekleyin

Android

LINE Ads Network entegrasyonu için ek kod gerekmez.

iOS

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

AdMob 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 reklam inceleyicide LINE Ads Network (Şelale) reklam kaynaklarını kullanarak tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özel parametreler

LINE Ads Network Unity uyumlulaştırma eklentisi, LineMediationExtras sınıfı aracılığıyla bağdaştırıcıya iletilebilen aşağıdaki ek istek parametresini destekler:

  • SetEnableAdSound(boolean) : Banner, geçiş ve ödüllü reklamların varsayılan ses başlangıç durumunu belirtir.

Aşağıda, bu parametreleri ayarlayan bir reklam isteğinin nasıl oluşturulacağına dair bir kod örneği verilmiştir:

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);

Hata kodları

Adaptör, LINE Ads Network'ten reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

Bir reklam yüklenemediğinde LINE Ads Network bağdaştırıcısı tarafından oluşturulan kodlar ve ilgili mesajlar aşağıda verilmiştir:

Android

Hata kodu Alan Neden
1-10 com.five_corp.ad LINE Ads Network SDK, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için LINE Ads Network'ün belgelerini inceleyin.
101 com.google.ads.mediation.line Uygulama kimliği eksik veya geçersiz.
102 com.google.ads.mediation.line Yuva kimliği eksik veya geçersiz.
103 com.google.ads.mediation.line İstenen reklam boyutu, LINE Ads Network'ün desteklediği bir banner reklam boyutuyla eşleşmiyor.
104 com.google.ads.mediation.line Eksik etkinlik bağlamı nedeniyle bir geçiş reklamı veya ödüllü reklam yüklenemedi.
105 com.google.ads.mediation.line LINE Ads Network SDK, geçiş reklamı veya ödüllü reklam gösteremedi.
106 com.google.ads.mediation.line Eksik öğeler nedeniyle doğal reklam yüklenemedi.

iOS

Hata kodu Alan Neden
1-10 LINE Ads Network SDK'sı tarafından gönderilir. LINE Ads Network SDK, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için LINE Ads Network'ün belgelerini inceleyin.
101 com.google.ads.mediation.line Geçersiz sunucu parametreleri (ör. uygulama kimliği veya alan kimliği eksik).
102 com.google.ads.mediation.line İstenen reklam boyutu, LINE Ads Network'ün desteklediği bir banner reklam boyutuyla eşleşmiyor.
103 com.google.ads.mediation.line Yerel reklamda bilgi simgesi resim öğesi yüklenemedi.

Line Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

Sürüm 1.5.5

  • OpenUPM üzerinden yükleme yapıldığında eklentinin paketleri düzgün şekilde içe aktarmamasına neden olan sorun düzeltildi.

Sürüm 1.5.4

Sürüm 1.5.3

Sürüm 1.5.2

Sürüm 1.5.1

Sürüm 1.5.0

Sürüm 1.4.0

Sürüm 1.3.1

Sürüm 1.3.0

Sürüm 1.2.0

Sürüm 1.1.2

Sürüm 1.1.1

Sürüm 1.1.0

Sürüm 1.0.0