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

Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma özelliğini 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 Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Line için Ad Manager uyumlulaştırıcı adaptör aşağıdaki özelliklere sahiptir:

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

¹ Şelale entegrasyonu kapalı beta sürümündedir. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.

Şartlar

• Unity 4 veya üzeri
• En son Google Mobile Ads SDK'sı
• Android'de dağıtmak için
  • Android API düzeyi 21 veya sonraki sürümler
• iOS'te dağıtmak için
  • iOS dağıtım hedefi 12.0 veya daha yeni bir sürüm olmalıdır.
• Google Mobile Ads SDK'sı ile yapılandırılmış çalışan bir Unity projesi. Ayrıntılar için Başlayın bölümüne bakın.
• Uyumlulaştırma Başlangıç kılavuzunu tamamlayın.

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.

Not: Line kullanıcı arayüzünde doğal reklam yerleşimleri oluşturmak için Line Ads Network hesap yöneticinizle iletişime geçin.

Slot kimliğini not edin.

2. adım: Ad Manager kullanıcı arayüzünde satır talebini ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

Yapay Zeka

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

iOS

Talimatlar için iOS kılavuzunun 2. adımına bakın.

3. Adım: Line SDK'sını ve bağdaştırıcısını içe aktarın

OpenUPM-CLI

Önemli: .unitypackage'den OpenUPM-CLI'ye geçiş yapıyorsanız Assets/GoogleMobileAds/Mediation/Line klasöründeki tüm dosyaları silerek öğeleri eski konumdan manuel olarak kaldırmanız gerekir.

OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak Unity için Google Mobil Reklamlar Satır Uyumlulaştırma Eklentisi'ni projenize yükleyebilirsiniz:

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

OpenUPM

Önemli: .unitypackage'den OpenUPM'e geçiş yapıyorsanız Assets/GoogleMobileAds/Mediation/Line klasöründeki tüm dosyaları silerek öğeleri eski konumdan manuel olarak kaldırmanız gerekir.

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

Kapsamlı Kayıt Daireleri sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı bir kayıt dairesi olarak ekleyin:

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

Ardından, Unity Paket Yöneticisi'ni açmak için pencere > Paket Yöneticisi'ne gidin ve açılır menüden Kayıt Dairelerim'i seçin.

Google Mobil Reklamlar Satır Uyumlulaştırması paketini seçin ve Yükle'yi tıklayın.

Unity Paketi

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

Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i 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.

Ardından Öğeler > Harici Bağımlılık Yöneticisi > Android Çözücü > Çözümü Zorla'yı seçin. Harici Bağımlılık Yöneticisi 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.

4. adım: Gerekli kodu ekleyin

Yapay Zeka

Line entegrasyonu için ek kod gerekmez.

iOS

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 olarak Line'ın Android ve iOS dokümanlarındaki talimatları uygulayın.

Önemli: Uygulamanızı yayınlamadan önce AdMob ve Line için test modunu devre dışı bırakı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

Line Unity uyumlulaştırma eklentisi, LineMediationExtras sınıfı aracılığıyla bağdaştırıcının aktarılabileceği 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ği oluşturmaya 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'dan reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Yapay Zeka

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

iOS

GADMediationAdapterLine

Bir reklam yüklenemezse satır adaptörü tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

Yapay Zeka

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.

iOS

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 Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

Sürüm 1.4.0

• Line Android adaptörü 2.8.20240827.0 sürümünü destekler.
• Line iOS bağdaştırıcısı 2.9.20241106.1 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.4.0 sürümü ile oluşturulup test edilmiştir.

1.3.1 sürümü

• Line Android bağdaştırıcısı 2.8.20240808.0 sürümünü destekler.
• Line iOS adaptörü 2.8.20240612.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümü ile derlenmiş ve test edilmiştir.

Sürüm 1.3.0

• Line Android adaptörü 2.8.20240722.0 sürümünü destekler.
• Line iOS adaptörü 2.8.20240612.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümü ile derlenmiş ve test edilmiştir.

Sürüm 1.2.0

• Line Android adaptörü 2.7.20240515.0 sürümünü destekler.
• Line iOS adaptörü 2.8.20240612.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.1.1 sürümü ile oluşturulup test edilmiştir.

1.1.2 sürümü

• Line Android adaptörü 2.7.20240515.0 sürümünü destekler.
• Line iOS adaptörünün 2.7.20240411.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.

1.1.1 sürümü

• Line Android adaptörünün 2.7.20240214.1 sürümünü destekler.
• Line iOS adaptörünün 2.7.20240411.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.

Sürüm 1.1.0

• Uyumlulaştırma ekstralarının iletilmesini desteklemek için aşağıdaki yöntemlerle LineMediationExtras sınıfı eklendi.
  • SetEnabledAdSound(bool)
• Line Android adaptörünün 2.7.20240214.1 sürümünü destekler.
• Line iOS adaptörünün 2.7.20240318.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümü ile derlenmiş ve test edilmiştir.

Sürüm 1.0.0

• İlk sürüm.
• Line Android bağdaştırıcısı 2.6.20230607.0 sürümünü destekler.
• Line iOS adaptörünün 2.6.20230609.0 sürümünü destekler.
• Google Mobil Reklamlar Unity eklentisi 8.5.1 sürümü ile oluşturulup test edilmiştir.