Bu kılavuzda, şelale entegrasyonlarını ele alan ve uyumlulaştırmayı 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:
Entegrasyon | |
---|---|
Teklif verme | |
Şelale | 1 |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü |
1 Şelale entegrasyonu açık beta sürümündedir.
Şartlar
- Unity 4 veya üzeri
- En son Google Mobile Ads SDK'sı
- Android'de dağıtım yapmak 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) (Kaydol) seçeneğini tıklayın.
Uygulama Kimliği'ni 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
Android
Talimatlar için Android kılavuzunun 2. adımına bakın.
iOS
Talimatlar için iOS rehberinin 2. adımına göz atı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ümleyici > Android Çözümleyici > Çö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 dokümanlarını takip edin.
5. Adım: Uygulamanızı test etme
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ş reklamı 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 | Satır SDK'sı, SDK'ya özel bir hata döndürdü. 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 | Alan Kimliği eksik veya geçersiz. |
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 | Satır 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. Eksik Uygulama Kimliği veya Alan Kimliği). |
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 | Doğal reklamda 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.
Sürüm 1.1.2
- 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 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üyle geliştirilip 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 bağdaştırıcısı 2.7.20240318.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip 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.