Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma özelliğini 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ğı gösterilmektedir. Bu makalede, LINE Ads Network'in 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ının bir Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.
Desteklenen entegrasyonlar ve reklam biçimleri
Ad Manager LINE Ads Network için uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:
Entegrasyon | |
---|---|
Teklif verme | |
Şelale | 1 |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü |
1 Ş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 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
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: LINE Ads Network talebini Ad Manager kullanıcı arayüzünde 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 Ads Network SDK'sını ve bağdaştırıcısını içe aktarın
OpenUPM-CLI
OpenUPM-CLI yüklüyse Unity için Google Mobil Reklamlar LINE Reklam Ağı Uyumlulaştırma Eklentisi'ni projenizin kök dizininden aşağıdaki komutu çalıştırarak projenize yükleyebilirsiniz:
openupm add com.google.ads.mobile.mediation.line
OpenUPM
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 LINE Reklam Ağı 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 Ads Network 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 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 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 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 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:
Yapay Zeka
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
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:
Yapay Zeka
Hata kodu | Alan | Neden |
---|---|---|
1-10 | com.five_corp.ad | LINE Ads Network SDK'sı, SDK'ya özgü bir hata döndürmüştür. Daha fazla ayrıntı için LINE Ads Network'in dokümanlarına bakı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, LINE Ads Network 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 Ads Network 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 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 ayrıntı 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 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.