LY Ads Network'ü uyumlulaştırma ile entegre etme

Bu kılavuz, şelale entegrasyonlarını kapsayarak uyumlulaştırma kullanarak LY Ads Network'ten reklam yüklemek ve göstermek için Google Mobile Ads SDK nasıl kullanacağınızı gösterir. Bu açıklamalar, LY Ads Network'ün bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve LY 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.

Desteklenen entegrasyonlar ve reklam biçimleri

LY Ads Network için uyumlulaştırma adaptörünün özellikleri şöyledir:

Entegrasyon
Teklifli sistem
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü
Yerel biçim

Şartlar

  • iOS 13.3 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 LY Ads Network bağdaştırıcısı 2.8.20240827.0 veya daha yeni bir sürüm kullanın (en yeni sürüm önerilir).

1. adım: LY Ads Network kullanıcı arayüzünde yapılandırmaları ayarlayın

LY Ads Network hesabınıza kaydolun ve giriş yapın.

Yeni uygulama ekleme

Uygulama sekmesine gidin ve Yeni kayıt düğmesini tıklayın.

Yeni Kayıt

Formu doldurun ve kayıt'ı tıklayın.

Yeni Kayıt Formu

Uygulama kimliğini not edin.

Kayıt Bilgileri

Reklam alanı oluşturma

Uygulama sekmesinde, uygulamanızın ayrıntılarını görüntülemek için uygulamanızı seçin. Slot bölümünde Ekle'yi tıklayın.

Alan Ekle

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 Oluştur'u tıklayın.

Alan formu ekleme

Slot kimliğini not edin.

Slot Ayrıntıları

İlk yerinizi oluşturduktan sonra LY Ads Network'ten onay almak için uygulamanızın ayrıntılar sayfasında İncele'yi tıklayın. Bu işlem zaman alabilir. Sorularınız olursa LY Ads Network temsilcinizle iletişime geçin.

İnceleme İsteğinde Bulun

Raporlama API'si anahtarı oluşturma

Raporlama API anahtarlarını yönetme sekmesine gidin ve API anahtarı oluştur düğmesini tıklayın.

Raporlama API'si Anahtarı Sekmesi

Formu doldurun ve Kaydet'i tıklayın.

Raporlama API'si Anahtarı Formu

API Anahtarı Kimliğinizi ve API Anahtarı Gizli Anahtarınızı not edin.

Raporlama API'si Anahtarı Formu

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.

LY 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 LY Ads Network talebini ayarlayın

Ad Manager hesabınızda oturum açın.

Şirketler bölümüne LY 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 LY 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 API Anahtarı Kimliği ile API Anahtarı Sırrı'nı girin.

Kullanıcı adı veya şifre girmeniz gerekmez. İşiniz bittiğinde 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 gidin, 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, LY Ads Network'ü bulun 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.

LY Ads Network teklifli sistemini 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 LY Ads Network'ü seçin.

Bu teklif veren için SDK Teklif Sistemi'ni 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.

LY 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 alınan Uygulama Kimliği ve Alan 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. Envanterinizi ve Uygulamanızı seçin.

Aşağı kaydırıp Aracılık iş ortağı ekle'yi tıklayın.

Önceki bölümde LY 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 alınan Uygulama Kimliği ve Alan Kimliği ile Varsayılan BGBM değerini girin. Kaydet'i tıklayın.

3. adım: LY Ads Network SDK'sını ve bağdaştırıcısını içe aktarın

Swift Package Manager'ı kullanma

Devam etmeden önce, desteklenen en eski bağdaştırıcı sürümü olan 2.9.20251119'a sahip olmanız gerekir.

Projenize paket bağımlılığı eklemek için aşağıdaki adımları uygulayın:

  1. Xcode'da File > Add Package Dependencies... (Dosya > Paket Bağımlılıkları Ekle...) seçeneğine gidin.

  2. Görüntülenen istemde aşağıdaki paket URL'sini arayın:

    https://github.com/googleads/googleads-mobile-ios-mediation-line.git
    
  3. Bağımlılık Kuralı'nda Şube'yi seçin.

  4. Metin alanına main girin.

CocoaPods'u kullanma

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

  • LY Ads Network SDK'sının en son sürümünü indirin ve projenizdeki FiveAd.framework dosyasını bağlayın.
  • LY 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'ü uygulama

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için LY Ads Network'ün dokümanlarını 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.

LY Ads Network bağdaştırıcısı, LY Ads Network için test modunu etkinleştirmeye yardımcı olan bir yöntem içerir. Bu seçeneği, LY Ads Network SDK'ya düzgün şekilde yönlendirilmelerini sağlamak için başlatmadanGoogle Mobile Ads SDK önce ayarlamanız gerekir.

Swift

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

Objective-C

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

Test reklamlarını doğrulama

LY Ads Network'ten test reklamları aldığınızı doğrulamak için LY Ads Network reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özel parametreler

LY 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ş reklamı 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

LY Ads Network bağdaştırıcısı, GADNativeAd için aşağıdaki alanları doldurur.

Alan LY Ads Network bağdaştırıcısı tarafından her zaman dahil edilen öğeler
Başlık
Resim
Gövde
Uygulama simgesi 1
Harekete geçirici mesaj
Yıldız puanı
Mağaza
Fiyat

1 Yerel reklamlarda LY Ads Network SDK, uygulama simgesi öğesi sağlamaz. Bunun yerine, LY Ads Network bağdaştırıcısı, uygulama simgesini şeffaf bir resimle doldurur.

Hata kodları

Adaptör LY 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 LY Ads Network bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

Hata kodu Alan adı Neden
1-10 LY Ads Network SDK'sı tarafından gönderilir. LY Ads Network SDK, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için LY Ads Network'ün dokümanlarını inceleyin.
101 com.google.ads.mediation.line Geçersiz sunucu parametreleri (ör. uygulama kimliği veya yuva kimliği eksik).
102 com.google.ads.mediation.line İstenen reklam boyutu, LY Ads Network'ün desteklediği bir banner reklam boyutuyla eşleşmiyor.
103 com.google.ads.mediation.line Doğal reklamda bilgi simgesi resim öğesi yüklenemedi.

LINE iOS Uyumlulaştırma Adaptörü Değişiklik Günlüğü

Sürüm 3.0.1.2

  • Google Mobile Ads SDK'sı bağımlılığını gevşetmek için minimum iOS sürümünü güncelleyerek alt sürümlere izin verin.
  • Doğal reklamlar için Reklam Seçenekleri simgesinin çok büyük olması sorunu düzeltildi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.4.0 sürümü.
  • FiveAd SDK'sı 3.0.1 sürümü.

Sürüm 3.0.1.1

  • Adaptör artık ageRestrictedTreatment Google Mobile Ads SDK işaretini FiveAd SDK'nın COPPA API'sine yönlendiriyor.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.3.0 sürümü.
  • FiveAd SDK'sı 3.0.1 sürümü.

Sürüm 3.0.1.0

  • FiveAd SDK'sının 3.0.1 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.1.0 sürümü.
  • FiveAd SDK'sı 3.0.1 sürümü.

Sürüm 3.0.0.1

  • Google Mobile Ads SDK'sı bağımlılığı 13.0.0 sürümüne güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.0.0 sürümü.
  • FiveAd SDK'sı 3.0.0 sürümü.

Sürüm 3.0.0.0

  • FiveAd SDK'sının 3.0.0.0 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ı 3.0.0 sürümü.

Sürüm 2.9.20251119.1

  • Google Mobile Ads SDK'sının tagForUnderAgeOfConsent parametrelerinin FiveAd SDK'sına yönlendirilmesi için destek eklendi.

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.20251119.

Sürüm 2.9.20251119.0

  • FiveAd SDK'sının 2.9.20251119 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.20251119.

Sürüm 2.9.20250930.0

  • FiveAd SDK'sının 2.9.20250930 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 12.12.0 sürümü.
  • FiveAd SDK sürümü 2.9.20250930.

Sürüm 2.9.20250912.0

  • Bağdaştırıcı artık her reklam isteğinden önce FiveAd SDK'sını başlatıyor.
  • FiveAd SDK'sının 2.9.20250912 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 12.11.0 sürümü.
  • FiveAd SDK sürümü 2.9.20250912.

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.4.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ükleme işleminden sonra 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, teklifli sistem banner reklamları için en son reklam sayısı API'sini kullanacak şekilde güncellendi.
  • Teklifli sistem 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çevelere Info.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ı.
  • Bağdaştırıcı uygulaması, FiveAd SDK'sı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ş reklamı 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.