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 açıklanmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

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

Ş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
  • 12.0 veya sonraki bir iOS 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ş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.

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

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

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 zip dosyasından GoogleMobileAdsLineMediation.unitypackage dosyasını çı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 > Play Hizmetleri Çözümleyicisi > Android Çözümleyicisi > Çözümü Zorla'yı seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve belirtilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

4. adım: Gerekli kodu ekleyin

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.

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:

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

GADMediationAdapterLine

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

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

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ünün 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ünün 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ünün 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.