Bu kılavuzda, şelale entegrasyonlarını kapsayan AdMob Uyumlulaştırma'yı 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. Bu makalede, LINE Ads Network'in 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ının bir iOS uygulamasına nasıl entegre edileceği ele alınmaktadır.
LINE Ads Network 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 Ads Network için uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:
Entegrasyon | |
---|---|
Teklif verme | 1 |
Şelale | 2 |
Formatlar | |
Banner | 3 |
Geçiş reklamı | 3 |
Ödüllü | |
Yerel biçim |
1 teklifli sistem entegrasyonu kapalı beta sürümündedir. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.
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
[Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek amacıyla en son sürüm önerilir LINE Ads Network adaptörünün 2.8.20240827.0 veya sonraki bir sürümünü kullanın.
En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlama Başlangıç kılavuzu
1. adım: LINE Ads Network kullanıcı arayüzünde yapılandırmaları ayarlayın
LINE Ads Network 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
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ı)'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 LINE Ads Network 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 Ads Network'i 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 düzenlemek için ilgili uyumlulaştırma grubunun adını tıklayın ve LINE Ads Network'i 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'ı 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 Birimi Ekle'yi tıklayın.
Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizden bir veya daha fazlasıyla ilişkilendirin. Ardından Bitti'yi tıklayın.
Artık reklam birimleri kartının, seçtiğiniz reklam birimleriyle doldurulduğunu göreceksiniz:
LINE Ads Network'i 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 imzalama'yı tıklayın ve LINE Ads Network ile teklifli sistem iş ortaklığı kurun.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/line/bidding-agreement-1.png?authuser=0&hl=tr)
Kabul ediyorum'u, ardından Devam'ı tıklayın.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/line/bidding-agreement-2.png?authuser=0&hl=tr)
LINE Ads Network için zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde Eşleme ekle'yi tıklayın.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/line/bidding-add-mapping-1-iOS.png?authuser=0&hl=tr)
Ardından, önceki bölümde elde edilen uygulama kimliğini ve slot kimliğini girin. Ardından Bitti'yi tıklayın.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/line/bidding-add-mapping-2-iOS.png?authuser=0&hl=tr)
Şelale
Reklam Kaynakları bölümündeki Şelale kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından LINE Ads Network'u seçin.
LINE Ads Ağı'nı seçin. Ardından LINE Ads Network için bir eBGBM değeri girin ve Devam'ı tıklayın.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/line/admob-add-ad-network.png?authuser=0&hl=tr)
LINE Ads Network için zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde Eşleme ekle'yi tıklayın.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/line/waterfall-add-mapping-1-iOS.png?authuser=0&hl=tr)
Ardından, önceki bölümde elde edilen uygulama kimliğini ve slot kimliğini girin. Ardından Bitti'yi tıklayın.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/line/waterfall-add-mapping-2-iOS.png?authuser=0&hl=tr)
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)
Projenizin Podfile dosyası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 Ads Network SDK'sının en son sürümünü indirin ve projenize
FiveAd.framework
bağlama. - Değişiklik Günlüğü'ndeki indirme bağlantısından LINE Ads Network bağdaştırıcının en son sürümünü indirin ve projenize
LineAdapter.framework
bağlantısını ekleyin.
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 özgü parametreler
LINE Ads Network adaptörü, GADMediationAdapterLineExtras
sınıfı kullanılarak adaptöre 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ğ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
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ızlı değerlendirme | |
Depolama | |
Fiyat |
1 LINE Ads Network SDK'sı, yerel reklamlar için 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üklenemezse LINE Ads Network 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 | LINE Ads Network SDK'sı tarafından gönderilir | LINE Ads Network SDK'sı, SDK'ya özgü bir hata döndürmüştür. Daha fazla ayrıntı için LINE Ads Network'in dokümanlarına bakı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, LINE Ads Network 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üğü
Sonraki Sürüm
GADMediationAdapterLine.h
'ün herkese açık bir başlık olmaması sorunu düzeltildi.
Sürüm 2.9.20241106.2
- FiveAd SDK'sı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'sını başlatmadan önce FiveAd SDK'sının başlatma durumunu kontrol etme özelliği kaldırıldı.
- Doğal reklam öğeleri indirilmeden önce desteği sonlandırılan doğal reklam durumu kontrolü kaldırıldı.
- Artık Google Mobile Ads SDK'sı 12.0.0 veya daha yeni bir sürüm gereklidir.
Aşağıdakilerle tasarlanıp 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
- Uyumlatıcı, teklifli sistem banner reklamları için en son reklam yükleme API'sini kullanacak şekilde güncellendi.
- Geçiş reklamları için teklif verme işleminde reklam etkinliklerinin doğru şekilde yönlendirilmesini engelleyen bir sorun düzeltildi.
Aşağıdakilerle tasarlanıp 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ü ile uyumluluk doğrulandı.
Aşağıdakilerle tasarlanıp 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 yerine üç bileşen içerecek şekilde güncellendi.
Aşağıdakilerle tasarlanıp 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 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 2.8.20240612 sürümü ile uyumluluğu 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 2.7.20240411 sürümü ile uyumluluğu 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ürümü 2.7.20240318 ile uyumluluğ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'dır.
- Artık Google Mobile Ads SDK'sının 11.0 veya daha yeni bir sürümü gereklidir.
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 2.7.20240126 sürümü ile uyumluluk doğrulandı.
- Adaptör uygulaması, FiveAd SDK'sının yeni temsilci 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ı 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ü ile uyumluluğu 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.