Bu kılavuzda, uyumlulaştırma 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. Şelale entegrasyonları ele alınmaktadır. Bu dokümanda, LINE Ads Network'ün 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ısının bir iOS uygulamasına nasıl entegre edileceği açıklanmaktadır.
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 uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:
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 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.
Henüz yapmadıysanız
Ad Manager 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: Ad Manager kullanıcı arayüzünde LINE Ads Network talebini ayarlayın
Ad Manager hesabınızda oturum açın.
Şirketlere LINE Ads Network'ü ekleme
Teklif verme
Bu adım, teklif entegrasyonları için gerekli değildir.
Şelale
Yönetici > Şirketler'e gidin ve Tüm şirketler sekmesinde Yeni şirket düğmesini tıklayın. Reklam ağı'nı seçin.
Reklam ağı olarak LINE Ads Network'ü seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin. Otomatik veri toplama'yı etkinleştirin ve önceki bölümde elde edilen Giriş adı ile Şifre'yi girin.
Kullanıcı adı veya şifre girmeniz gerekmez. İşlemi tamamladığınızda Kaydet'i tıklayın.
Güvenli sinyal paylaşımını etkinleştirme
Teklif verme
Yönetici > Genel ayarlar'a gidin. Ad Exchange hesap ayarları sekmesine gidip Güvenli sinyal paylaşımı'nı inceleyin ve etkinleştirin. Kaydet'i tıklayın.
Şelale
Bu adım, şelale entegrasyonları için gerekli değildir.
Teklif isteklerinde güvenli sinyal paylaşma
Teklif verme
Envanter > Güvenli Sinyaller'e gidin. Güvenli sinyaller bölümünde LINE'ı arayın ve Uygulama entegrasyonunu etkinleştir'i açın.
Kaydet'i tıklayın.
Şelale
Bu adım, şelale entegrasyonları için gerekli değildir.
SDK teklifli sistemi için güvenli sinyal paylaşımına izin verme
Teklif verme
Yayınlama > Talep kanalı ayarları'na gidin. Varsayılan ayarlar sekmesinde, SDK Bidding için Güvenli sinyal paylaşımına izin ver'i etkinleştirin.
Kaydet'i tıklayın.
Şelale
Bu adım, şelale entegrasyonları için gerekli değildir.
LINE Ads Network teklifini yapılandırma
Teklif verme
Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi'ne Git'i tıklayın.
Yeni teklif veren'i tıklayın.
Teklif veren olarak LINE Ads Network'ü seçin.
Bu teklif veren için SDK teklif verme özelliğini etkinleştirmek üzere Devam'ı tıklayın.
Bitti'yi tıklayın.
Şelale
Bu adım, şelale entegrasyonları için gerekli değildir.
Reklam birimi eşlemesini yapılandırma
Teklif verme
Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi'ne Git'i tıklayın.
LINE Ads Network için şirketi seçin.
Reklam birimi eşleme sekmesine gidin ve Yeni reklam birimi eşleme'yi tıklayın.
Belirli reklam birimi'ni seçin. Bir reklam birimi ve biçimi, Envanter türü olarak Mobil uygulama'yı ve Mobil uygulamanızı seçin. Ardından, önceki bölümde aldığınız Uygulama Kimliği ve Slot Kimliği'ni girin. Son olarak Kaydet'i tıklayın.
Şelale
Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın. Mobil uygulamanızı seçin.
Aşağı kaydırıp Getiri iş ortağı ekle'yi tıklayın.
Önceki bölümde LINE Ads Network için oluşturduğunuz şirketi seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması, Platform olarak iOS ve Durum olarak Etkin'i seçin.
Önceki bölümde aldığınız Uygulama Kimliği ve Alan Kimliği ile Varsayılan BGBM değerini girin. Kaydet'i tıklayın.
Not: Otomatik veri toplama özelliğinin bir uyumlulaştırma ağı için dinamik BGBM'yi doğru şekilde hesaplamadan önce veri toplaması birkaç gün sürebilir. eBGBM hesaplandığında sizin adınıza otomatik olarak güncellenir.
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 projenizde
FiveAd.framework
bağlantısını oluşturun. - Değişiklik günlüğündeki indirme bağlantısından LINE Ads Network bağdaştırıcısının en son sürümünü indirin ve projenizde
LineAdapter.framework
bağlantısını oluşturun.
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
belgelerini inceleyin.
5. adım: Uygulamanızı test edin
Test reklamlarını etkinleştirme
Ad Manager 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 reklam inceleyicide LINE Ads Network (Şelale) reklam kaynaklarını kullanarak 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 = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)
Objective-C
#import <LineAdapter/LineAdapter.h>
// ...
GAMRequest *request = [GAMRequest 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 alanları 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ıflar altında 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 oluşturulan kodlar ve ilgili mesajlar aşağıda verilmiştir:
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 Aracılık 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ürüm 2.9.20250512 ile uyumluluk 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 2.9.20241106 sürümüyle uyumluluk 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'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ürümü 2.8.20240612 ile 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ürümü 2.7.20240411 ile uyumluluk 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ürüm 2.7.20240318 ile uyumluluk 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ürümü 2.7.20240214 ile uyumluluk 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'nın 2.7.20240126 sürümüyle uyumluluk 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'nın 2.7.20231115 sürümüyle uyumluluk 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 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.