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 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ü |
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
- 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: 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
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
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.
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 dokümanlarına 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 dokümanlarına 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üğü
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.