Bu kılavuzda, şelale entegrasyonlarını kapsayan AdMob Uyumlulaştırması, kullanılarak 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 uygulamaya nasıl entegre edileceği ele alınmaktadır. iOS
Line kontrol paneli arayüzünde etiketler, düğmeler ve açıklamalar için Japonca metin kullanılır. Bu kılavuzda yer alan ekran görüntüleri çevrilmemiştir. Ancak bu kılavuzun açıklamalarında ve talimatlarında etiketler ile düğmeler, parantez içinde İngilizce karşılıklarıyla birlikte çevrilmiştir.
Desteklenen entegrasyonlar ve reklam biçimleri
Line için uyumlulaştırıcı bağdaştırıcının özellikleri şunlardır:
Entegrasyon | |
---|---|
Teklif verme | 1 |
Şelale | 2 |
Formatlar | |
Banner | 3 |
Geçiş reklamı | 3 |
Ödüllü | |
Yerel biçim |
2 Şelale entegrasyonu açık beta sürümündedir.
3 Bu biçim yalnızca şelale entegrasyonunda desteklenir.
Şartlar
- 12.0 veya sonraki bir iOS dağıtım hedefi
En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlama Başlangıç kılavuzu
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, DELETE規工成 (Yeni Oluştur) seçeneğini tıklayın.
Formu doldurun ve グ (Register) (Kaydol) seçeneğini tıklayın.
Uygulama kimliğini not edin.
Reklam yerleşimi oluşturma
Hem teklifli sistem hem de şelale entegrasyonları için reklam yerleşimleri oluşturmak üzere aynı adımları uygulayın. Her reklam yerleşimi her ikisi için de kullanılabilir.Reklam yerleşimi eklemek istediğiniz uygulamanın kimliğini tıklayın. Ardından, 詳細 (Ayrıntı) seçeneğini belirleyin.
スロット 追加 (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
Reklam biriminizin uyumlulaştırma yapılandırmasına Line 'ı eklemeniz gerekiyor.
İlk olarak, AdMob hesabınızda oturum açın. Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa bu uyumlulaştırma grubunu düzenlemek için grubun adını tıklayın ve Reklam kaynağı olarak Line ekle bölümüne atlayın.
Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.
Reklam biçimini ve platformunuzu girip Devam'ı tıklayın.
Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın ve Reklam Birimleri Ekle'yi tıklayın.
Bu uyumlulaştırma grubunu mevcut bir veya daha fazla AdMob reklam biriminizle ilişkilendirin. Ardından Bitti'yi tıklayın.
Şimdi, seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını görmeniz gerekir:
Reklam kaynağı olarak Line ekleyin
Teklif
Reklam Kaynakları bölümündeki Teklif verme kartında Ekle'yi seçin Reklam Kaynağı. Ardından Line simgesini seçin.
İş ortaklığı sözleşmesi nasıl imzalanır? seçeneğini tıklayın ve teklifli sistem ayarlama iş ortaklığı Line.
Onayla ve kabul edin ve Devam'ı tıklayın.
Lineiçin zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.
Daha sonra, Application ID and Slot ID önceki bölümde bulabilirsiniz. Ardından Bitti'yi tıklayın.
Şelale
Reklam Kaynakları bölümündeki Şelale kartının altından Reklam Kaynağı Ekle'yi seçin. Ardından Line simgesini seçin.
Line'i seçin. ArdındanLine için bir eBGBM değeri girip Devam'ı tıklayın.Lineiçin zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.
Sonra, önceki bölümde aldığınız Application ID and Slot ID kodunu girin. Ardından Bitti'yi tıklayın.
3. Adım: Line SDK'sını ve bağdaştırıcısını içe aktarın
CocoaPods'u kullanma (önerilir)
Projenizin Podfile'ına aşağıdaki satırı ekleyin:
pod 'GoogleMobileAdsMediationLine'
Komut satırından şunu çalıştırın:
pod install --repo-update
Manuel entegrasyon
- Line SDK'nın en son sürümünü indirin ve projenize
FiveAd.framework
bağlantısını ekleyin. - Changelog'daki indirme bağlantısından Line bağdaştırıcısının en son sürümünü indirin ve projenizde
LineAdapter.framework
bağlantısını bağlayın.
4. adım: Gerekli kodu ekleyin
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
Test cihazınızı AdMob'a kaydettiğinizden emin olun.
Line test reklamlarını etkinleştirmeyle ilgili Line 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
Satır bağdaştırıcısı, GADMediationAdapterLineExtras
sınıfı kullanılarak bağdaştırıcının aktarabileceği ek bir istek parametresini destekler. Bu sınıf aşağıdaki özellikleri içerir:
adAudio
- 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:
Swift
import LineAdapter
// ...
let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)
Objective-C
#import <LineAdapter/LineAdapter.h>
// ...
GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];
Doğal reklamları kullanma
Reklam oluşturma
Satır bağdaştırıcısı, bir
GADNativeAd
.
Alan | Satır bağdaştırıcısı tarafından her zaman dahil edilen öğeler |
---|---|
Başlık | |
Resim | |
Metin | |
Uygulama simgesi | 1 |
Harekete geçirici mesaj | |
Yıldızlı değerlendirme | |
Depolama | |
Fiyat |
1 Line SDK, doğal reklamlar için uygulama simgesi öğesi sağlamaz. Bunun yerine, Çizgi bağdaştırıcısı uygulama simgesini şeffaf bir resimle doldurur.
Hata kodları
Bağdaştırıcı, Line'dan reklam alamazsa aşağıdaki sınıfların altında
GADResponseInfo.adNetworkInfoArray
aşağıdaki sınıflar altında:
GADMediationAdapterLine
Bir reklam yüklenemezse satır bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:
Hata kodu | Alan | Neden |
---|---|---|
1-10 | Satır 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 iOS Uyumlulaştırma Adaptörü Değişiklik Günlüğü
Sürüm 2.8.20240827.1
CFBundleShortVersionString
, dört yerine üç bileşen içerecek şekilde güncellendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 11.10.0.
- FiveAd SDK'sı 2.8.20240827 sürümü.
Sürüm 2.8.20240827.0
- FiveAd SDK 2.8.20240827 sürümü ile uyumluluğu doğrulandı.
- Banner, geçiş reklamı, ödüllü ve yerel reklam biçimleri için teklif verme desteği eklendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 11.8.0 sürümü.
- FiveAd SDK sürümü 2.8.20240827.
Sürüm 2.8.20240612.0
- GADVideoOptions aracılığıyla doğal reklam için ses kontrolü eklendi.
- FiveAd SDK'sının 2.8.20240612 sürümü ile uyumluluk doğrulandı.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 11.5.0 sürümü.
- FiveAd SDK sürümü 2.8.20240612.
Sürüm 2.7.20240411.0
- FiveAd SDK'sının 2.7.20240411 sürümü ile uyumluluk doğrulandı.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 11.3.0 sürümü.
- FiveAd SDK sürümü 2.7.20240411.
Sürüm 2.7.20240318.0
- FiveAd SDK'sının 2.7.20240318 sürümü ile uyumlu olduğu doğrulandı.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 11.2.0 sürümü.
- FiveAd SDK sürümü 2.7.20240318.
Sürüm 2.7.20240214.1
- Artık minimum iOS sürümü 12.0'dir.
- Artık Google Mobile Ads SDK'sının 11.0 veya üzeri bir sürümünü gerektirmektedir.
LineAdapter.xcframework
içindeki çerçevelereInfo.plist
dahil edildi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 11.0.1 sürümü.
- FiveAd SDK sürümü 2.7.20240214.
Sürüm 2.7.20240214.0
- FiveAd SDK 2.7.20240214 sürümü ile uyumluluğu doğrulandı.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 11.0.1 sürümü.
- FiveAd SDK sürümü 2.7.20240214.
Sürüm 2.7.20240126.0
- FiveAd SDK sürümü 2.7.20240126 ile uyumluluğu doğrulandı.
- Bağdaştırıcı uygulaması, FiveAd SDK'sı yeni yetki protokolleriyle güncellendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 10.14.0 sürümü.
- FiveAd SDK sürümü 2.7.20240126.
Sürüm 2.7.20231115.0
- FiveAd SDK 2.7.20231115 sürümü ile uyumluluğu doğrulandı.
- modulemap dosyasına
GADMediationAdapterLineExtras
başlığı eklendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 10.14.0 sürümü.
- FiveAd SDK sürümü 2.7.20231115.
Sürüm 2.6.20230609.1
- Banner, geçiş reklamı ve ödüllü reklamın ilk kez gösterildiğindeki ilk ses durumunu yönetmek için
GADMediationAdapterLineAudioState
eklendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 10.14.0.
- FiveAd SDK'sı 2.6.20230609 sürümü.
Sürüm 2.6.20230609.0
- İlk sürüm!
- Banner, geçiş reklamı, ödüllü ve yerel reklam biçimleri için şelale desteği eklendi.
- FiveAd SDK'sının 2.6.20230609 sürümü ile uyumluluk doğrulandı.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 10.9.0 sürümü.
- FiveAd SDK sürümü 2.6.20230609.