LY Ads Network'ü uyumlulaştırma ile entegre etme

Platform seçin: Android Yeni Android iOS Unity Flutter

Bu kılavuz, şelale entegrasyonlarını kapsayarak uyumlulaştırma kullanarak LY Ads Network'ten reklam yüklemek ve göstermek için Google Mobile Ads Unity Plugin nasıl kullanacağınızı gösterir. Bu açıklamalar, LY Ads Network'ün bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve LY Ads Network SDK'sının ve bağdaştırıcısının bir Unity uygulamasına nasıl entegre edileceğini kapsar.

Desteklenen entegrasyonlar ve reklam biçimleri

LY Ads Network için Ad Manager uyumlulaştırma adaptörünün özellikleri şöyledir:

Entegrasyon
Teklifli sistem
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü

Şartlar

  • Google Mobile Ads Unity Plugin kanalının en yenileri
  • 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 LY Ads Network SDK 1.5.0 veya daha yeni bir sürüm için Google Mobile Ads aracılık 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 13.3 veya üzeri sürüm dağıtım hedefi
  • Google Mobile Ads Unity Plugin ile yapılandırılmış çalışan bir Unity projesi. Ayrıntılar için Google Mobile Ads Unity Plugin'ı kurma başlıklı makaleyi inceleyin.
  • Uyumlulaştırmayı ayarlayın.

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

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

Yeni uygulama ekleme

Uygulama sekmesine gidin ve Yeni kayıt düğmesini tıklayın.

Yeni Kayıt

Formu doldurun ve kayıt'ı tıklayın.

Yeni Kayıt Formu

Uygulama kimliğini not edin.

Android

Kayıt Bilgileri

iOS

Kayıt Bilgileri

Reklam alanı oluşturma

Uygulama sekmesinde, uygulamanızın ayrıntılarını görüntülemek için uygulamanızı seçin. Slot bölümünde Ekle'yi tıklayın.

Alan Ekle

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 Oluştur'u tıklayın.

Alan formu ekleme

Slot kimliğini not edin.

Slot Ayrıntıları

İlk yerinizi oluşturduktan sonra LY Ads Network'ten onay almak için uygulamanızın ayrıntılar sayfasında İncele'yi tıklayın. Bu işlem zaman alabilir. Sorularınız olursa LY Ads Network temsilcinizle iletişime geçin.

İnceleme İsteğinde Bulun

Raporlama API'si anahtarı oluşturma

Raporlama API anahtarlarını yönetme sekmesine gidin ve API anahtarı oluştur düğmesini tıklayın.

Raporlama API'si Anahtarı Sekmesi

Formu doldurun ve Kaydet'i tıklayın.

Raporlama API'si Anahtarı Formu

API Anahtarı Kimliğinizi ve API Anahtarı Gizli Anahtarınızı not edin.

Raporlama API'si Anahtarı Formu

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 Ad Manager için bir app-ads.txt dosyası oluşturun.

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

2. adım: Ad Manager kullanıcı arayüzünde LY Ads Network talebini ayarlayın

Reklam biriminiz için uyumlulaştırma 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: LY 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 Mobile Ads LY Ads Network Mediation Plugin'i 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ıt Otoriteleri) sekmesinde, aşağıdaki ayrıntıları kullanarak OpenUPM'yi kapsamlı kayıt otoritesi 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çin ve Yükle'yi tıklayın.

OpenUPM'den yükleme

Unity paketi

LY 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 (Paketi İçe Aktar) > Custom Package (Özel Paket) seçeneğini belirleyin 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 > External Dependency Manager > Android Resolver > Force Resolve'u (Öğeler > Harici Bağımlılık Yöneticisi > Android Çözücü > Çö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

LY 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 LY 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

LY Ads Network'ten test reklamları aldığınızı doğrulamak için LY Ads Network reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özel parametreler

LY 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 LY Ads Network'ten reklam alamıyorsa yayıncılar aşağıdaki sınıflarda 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 LY Ads Network bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

Android

Hata kodu Alan adı Neden
1-10 com.five_corp.ad LY Ads Network SDK, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için LY Ads Network'ün dokümanlarını 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, LY Ads Network'ün desteklediği bir banner reklam boyutuyla eşleşmiyor.
104 com.google.ads.mediation.line Eksik etkinlik bağlamı nedeniyle geçiş reklamı veya ödüllü reklam yüklenemedi.
105 com.google.ads.mediation.line LY Ads Network SDK, bir geçiş reklamı veya ödüllü reklam gösteremedi.
106 com.google.ads.mediation.line Eksik öğeler nedeniyle bir doğal reklam yüklenemedi.

iOS

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

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

Sürüm 2.1.0

Sürüm 2.0.2

Sürüm 2.0.1

Sürüm 2.0.0

Sürüm 1.5.10

Sürüm 1.5.9

Sürüm 1.5.8

Sürüm 1.5.7

Sürüm 1.5.6

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