Bu kılavuz, AdMob uyumlulaştırması kullanarak LINE Ads Network'ten reklam yüklemek ve göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağını şelale entegrasyonlarını kapsayarak açıklar. Bu açıklamalar, LINE Ads Network'ün bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve LINE Ads Network SDK'sının ve bağdaştırıcısının bir iOS uygulamasına nasıl entegre edileceğini kapsar.
LINE Ads Network'ün kontrol paneli arayüzünde etiketler, düğmeler ve açıklamalar için Japonca metin kullanılır. Bu kılavuzdaki ekran görüntüleri çevrilmemiştir. Ancak bu kılavuzdaki açıklamalarda ve talimatlarda etiketler ve düğmeler, İngilizce dilindeki karşılıklarıyla birlikte parantez içinde çevrilmiştir.
Desteklenen entegrasyonlar ve reklam biçimleri
LINE Ads Network için uyumlaştırma adaptörünün özellikleri şöyledir:
Entegrasyon | |
---|---|
Teklifli sistem | |
Şelale | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Yerel biçim | 1 |
1 Yerel reklamlar (teklif verme için) kapalı beta sürümündedir. Erişimi talep etmek için hesap yöneticinizle iletişime geçin.
Şartlar
iOS 12.0 veya üzeri sürüm dağıtım hedefi
[Teklif verme için]: Teklif vermeye desteklenen tüm reklam biçimlerini entegre etmek için LINE Ads Network bağdaştırıcısı 2.8.20240827.0 veya daha yeni bir sürüm kullanın (en son sürüm önerilir).
En son Google Mobile Ads SDK'sı
Uyumlulaştırma Başlangıç Kılavuzunu tamamlama
1. adım: LINE Ads Network kullanıcı arayüzünde yapılandırmaları ayarlayın
LINE Ads Network hesabınıza kaydolun ve giriş yapın.
Yeni uygulama ekleme
広告枠管理 (Ad Slot Management) > メディア (Media)'yı tıklayın. Ardından 新規作成 (Yeni Oluştur)'u tıklayın.
Formu doldurun ve 登録 (Kaydol)'u 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.
スロット 追加 (Add Slot) (Yuva Ekle) seçeneğini tıklayın.
Slotla ilgili ayrıntılar için formu doldurun. Teklif Türü için bu alanı şelale uyumlulaştırması için yapılandırmak üzere Standart'ı veya bu alanı teklifli sistem için yapılandırmak üzere Google SDK Teklif Sistemi'ni seçin. Form doldurulduktan sonra 登録 (Register) seçeneğini tıklayın.
Yuva kimliğini not edin.
app-ads.txt dosyanızı güncelleme
Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt
dosyası uygulamanız gerekir.
Bunu henüz yapmadıysanız
uygulamanız için bir app-ads.txt dosyası oluşturun.
LINE Ads Network için app-ads.txt
uygulamak üzere app-ads.txt hakkında başlıklı makaleyi inceleyin.
2. adım: AdMob kullanıcı arayüzünde LINE Ads Network talebini ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
LINE Ads Network'ü reklam biriminizin aracılık yapılandırmasına eklemeniz gerekir.
Öncelikle 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 grubunun adını tıklayarak düzenleyin ve LINE Ads Network'ü reklam kaynağı olarak ekleme bölümüne geçin.
Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.
Reklam biçiminizi ve platformunuzu girip Devam'a 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'ye tıklayın.
Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizden biri veya daha fazlasıyla ilişkilendirin. Ardından Bitti'ye tıklayın.
Artık seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını göreceksiniz:
LINE Ads Network'ü reklam kaynağı olarak ekleme
Teklif verme
Reklam Kaynakları bölümündeki Teklifli Sistem kartında Reklam kaynağı ekle'yi seçin. Ardından LINE Ads Network'ü seçin .İş ortaklığı sözleşmesi nasıl imzalanır? düğmesini tıklayın ve LINE Ads Network ile teklifli sistem iş ortaklığını ayarlayın.

Onayla ve kabul et'e, ardından Devam'a tıklayın.

LINE Ads Network için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde, Eşleme ekle'ye tıklayın.

Ardından, önceki bölümde alınan Uygulama Kimliği ve Slot Kimliği'ni girin. Ardından Bitti'yi tıklayın.

Şelale
Reklam Kaynakları bölümündeki Şelale kartında Reklam Kaynağı Ekle'yi seçin.
LINE Ads Network'ü seçin ve Optimize anahtarını etkinleştirin. LINE Ads Network için reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde aldığınız Giriş adı ve Şifre'yi girin. Ardından, LINE Ads Network için bir eBGBM değeri girin ve Devam'ı tıklayın.

LINE Ads Network için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde alınan Uygulama Kimliği ve Slot Kimliği'ni girin. Ardından Bitti'yi tıklayın.

3. adım: LINE Ads Network SDK'sını ve bağdaştırıcısını içe aktarın
CocoaPods'u kullanma (önerilir)
Aşağıdaki satırı projenizin Podfile'ına ekleyin:
pod 'GoogleMobileAdsMediationLine'
Komut satırından şunu çalıştırın:
pod install --repo-update
Manuel entegrasyon
- LINE Ads Network SDK'sının en son sürümünü indirin ve projenizdeki
FiveAd.framework
dosyasını bağlayın. - LINE Ads Network bağdaştırıcısının en son sürümünü Değişiklik Günlüğü'ndeki indirme bağlantısından indirin ve projenizdeki
LineAdapter.framework
dosyası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 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 özel parametreler
LINE Ads Network bağdaştırıcısı, GADMediationAdapterLineExtras
sınıfı kullanılarak bağdaştırıcıya aktarılabilen 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ğinin nasıl oluşturulacağına 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
LINE Ads Network bağdaştırıcısı, GADNativeAd
için aşağıdaki
yerel reklamlar gelişmiş alan açıklamalarını
doldurur.
Alan | LINE Ads Network 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ız puanı | |
Mağaza | |
Fiyat |
1 Yerel reklamlar için LINE Ads Network SDK, uygulama simgesi öğesi sağlamaz. Bunun yerine, LINE Ads Network bağdaştırıcısı, uygulama simgesini şeffaf bir resimle doldurur.
Hata kodları
Adaptör LINE Ads Network'ten reklam alamıyorsa aşağıdaki sınıflarda
GADResponseInfo.adNetworkInfoArray
kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:
GADMediationAdapterLine
Bir reklam yüklenemediğinde LINE Ads Network bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:
Hata kodu | Alan adı | Neden |
---|---|---|
1-10 | LINE Ads Network SDK'sı tarafından gönderilir. | LINE Ads Network SDK, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için LINE Ads Network'ün belgelerini inceleyin. |
101 | com.google.ads.mediation.line | Geçersiz sunucu parametreleri (ör. uygulama kimliği veya alan kimliği eksik). |
102 | com.google.ads.mediation.line | İstenen reklam boyutu, LINE Ads Network'ün desteklediği bir banner reklam boyutuyla eşleşmiyor. |
103 | com.google.ads.mediation.line | Yerel reklamda bilgi simgesi resim öğesi yüklenemedi. |
LINE iOS Uyumlulaştırma Adaptörü Değişiklik Günlüğü
Sürüm 2.9.20250825.0 (Devam ediyor)
Sürüm 2.9.20250805.0 (Devam ediyor)
- Artık her reklam isteğinden önce FiveAd SDK'sını kaydetmeye çalışıyor.
Sürüm 2.9.20250512.0
- Artık minimum iOS sürümü 13.0 gerektiriyor.
- FiveAd SDK'sının 2.9.20250512 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.14.0 sürümü.
- FiveAd SDK sürümü 2.9.20250512.
Sürüm 2.9.20241106.3
GADMediationAdapterLine.h
öğesinin herkese açık bir başlık olmamasına neden olan sorun düzeltildi.-fobjc-arc
ve-fstack-protector-all
işaretlerini etkinleştirin.- Başarılı yüklemenin ardından teklif verme için banner reklam boyutu doğrulaması kaldırıldı.
- Şelale banner reklamları, başarıyla yüklendikten sonra banner reklam boyutlarını kontrol etmeye devam eder.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.2.0 sürümü.
- FiveAd SDK sürümü 2.9.20241106.
Sürüm 2.9.20241106.2
- FiveAd SDK'nın test modunda başlatılıp başlatılmayacağını belirtmek için
GADMediationAdapterLine.testMode
özelliği eklendi. Bu işaret, Google Mobile Ads SDK'sı başlatılmadan önce ayarlanmalıdır. - FiveAd SDK'yı başlatmadan önce FiveAd SDK başlatma durumu kontrolü kaldırıldı.
- Doğal reklam öğeleri indirilmeden önce kullanımdan kaldırılan doğal reklam durumu kontrolü kaldırıldı.
- Artık Google Mobile Ads SDK'sının 12.0.0 veya daha sonraki bir sürümü gereklidir.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.0.0 sürümü.
- FiveAd SDK sürümü 2.9.20241106.
Sürüm 2.9.20241106.1
- Adaptör, teklif verme banner reklamları için en son reklam yükleme API'sini kullanacak şekilde güncellendi.
- Teklif verme için geçiş reklamlarında reklam etkinliklerinin doğru şekilde yönlendirilmesini engelleyen sorun düzeltildi.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 11.12.0 sürümü.
- FiveAd SDK sürümü 2.9.20241106.
Sürüm 2.9.20241106.0
- FiveAd SDK'sının 2.9.20241106 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 11.12.0 sürümü.
- FiveAd SDK sürümü 2.9.20241106.
Sürüm 2.8.20240827.1
CFBundleShortVersionString
, dört bileşen yerine üç bileşen içerecek şekilde güncellendi.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 11.10.0 sürümü.
- FiveAd SDK sürümü 2.8.20240827.
Sürüm 2.8.20240827.0
- FiveAd SDK'sının 2.8.20240827 sürümüyle uyumluluğu doğrulandı.
- Banner, geçiş reklamı, ödüllü reklam ve yerel reklam biçimleri için teklif desteği eklendi.
Aşağıdakilerle geliştirilip 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üyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip 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üyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip 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üyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip 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 gerektiriyor.
- Artık Google Mobile Ads SDK'sının 11.0 veya daha sonraki bir sürümü gereklidir.
LineAdapter.xcframework
içindeki çerçevelereInfo.plist
dahil edildi.
Aşağıdakilerle geliştirilip 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'sının 2.7.20240214 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip 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ının 2.7.20240126 sürümüyle uyumluluğu doğrulandı.
- Adaptör uygulaması, FiveAd SDK'nın yeni temsilci protokolleriyle güncellendi.
Aşağıdakilerle geliştirilip 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'sının 2.7.20231115 sürümüyle uyumluluğu doğrulandı.
- modulemap'e
GADMediationAdapterLineExtras
üstbilgisi eklendi.
Aşağıdakilerle geliştirilip 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ş ve ödüllü reklam ilk kez gösterildiğinde başlangıçtaki ses durumunu yönetmek için
GADMediationAdapterLineAudioState
eklendi.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 10.14.0 sürümü.
- FiveAd SDK sürümü 2.6.20230609.
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üyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 10.9.0 sürümü.
- FiveAd SDK sürümü 2.6.20230609.