Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

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

Bu kılavuzda, şelale entegrasyonlarını kapsayan AdMob Uyumlulaştırması'nı kullanarak LY Reklam Ağı'ndan reklam yüklemek ve göstermek için Google Mobile Ads SDK ürününü nasıl kullanacağınız gösterilmektedir. 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

Ön koşullar

Devam etmeden önce aşağıdakileri doğrulayın:

iOS 13.0 veya sonraki sürüm dağıtım hedefi
[Teklifli sistem için]: Teklifli sistemde desteklenen tüm reklam biçimlerini entegre etmek için LY Reklam Ağı bağdaştırıcısı 2.8.20240827.0 veya sonraki sürümleri kullanın (en yeni sürüm önerilir).

En yeni Google Mobile Ads SDK sürümü.
AdMob Uyumlulaştırması'nı ayarlayın.

1. adım: LY Reklam Ağı kullanıcı arayüzünde yapılandırmaları ayarlayın

LY Reklam Ağı hesabınıza kaydolun ve giriş yapın.

Yeni uygulama ekleme

App (Uygulama) sekmesine gidin ve New registration (Yeni kayıt) düğmesini tıklayın.

Yeni Kayıt

Formu doldurup Kayıt'ı tıklayın.

Yeni Kayıt Formu

Uygulama kimliğini not edin.

Kayıt Bilgileri

Reklam alanı oluşturma

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

Alan ekle

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

Alan Ekleme Formu

Alan kimliğini not edin.

Alan Ayrıntıları

İlk alanınızı oluşturduktan sonra LY Reklam Ağı'ndan 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 varsa LY Ads Network temsilcinizle iletişime geçin.

İnceleme İsteğinde Bulun

Reporting API anahtarı oluşturma

Managing reporting API keys (Raporlama API anahtarlarını yönetme) sekmesine gidin ve Create API key (API anahtarı oluştur) düğmesini tıklayın.

Reporting API Key Tab

Formu doldurup Kaydet'i tıklayın.

Reporting API Key Form

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

Reporting API Key Form

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.

LY Reklam Ağı için app-ads.txt dosyasını uygulamak üzere app-ads.txt hakkında başlıklı makaleyi inceleyin.

2. adım: AdMob kullanıcı arayüzünde LY Reklam Ağı talebini ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

LY Ads Network'ü reklam biriminizin uyumlulaştırma 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 LY 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'ı 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 AdMob reklam birimlerinizden biri veya daha fazlasıyla ilişkilendirin. Ardından Bitti'yi tıklayın.

Artık seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını göreceksiniz:

LY Ads Network'ü reklam kaynağı olarak ekleme

Teklif verme

Reklam Kaynakları bölümünde Teklifli Sistem kartını bulun ve Reklam kaynağı ekle'yi seçin. Ardından LY Ads Network'ü seçin. .

İş ortaklığı sözleşmesi nasıl imzalanır? düğmesini tıklayın ve LY Ads Network ile teklifli sistem iş ortaklığını ayarlayın.

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

LY Reklam Ağı 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 Alan 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.

LY Reklam Ağı'nı seçin ve Optimize et anahtarını etkinleştirin. LY Ads Network için reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde elde edilen API anahtarı kimliği ve API gizli anahtarı'nı girin. Ardından LY Reklam Ağı için bir eBGBM değeri girin ve Devam'ı tıklayın.

LY Reklam Ağı 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 Alan Kimliği'ni girin. Ardından Bitti'yi tıklayın.

Not: Reklam kaynağı optimizasyonunun bir uyumlulaştırma ağı için eBGBM'yi doğru şekilde hesaplamaya yetecek kadar veri toplaması birkaç gün sürer. Bu süre zarfında reklam kaynağı optimizasyon durumu PENDING olur. Bu nedenle, ağ için manuel olarak bir eBGBM değeri ayarlamanız gerekir. eBGBM hesaplanabildiğinde reklam kaynağı, eBGBM'yi sizin adınıza otomatik olarak güncellemeye başlar.

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

Önerilen: Swift Package Manager'ı kullanma

Devam etmeden önce, desteklenen minimum 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:

Xcode'da File (Dosya) > Add Package Dependencies... (Paket Bağımlılıkları Ekle...) bölümüne gidin.

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

https://github.com/googleads/googleads-mobile-ios-mediation-line.git

Bağımlılık Kuralı'nda Dal'ı seçin.
Metin alanına main yazın.

Manuel entegrasyon

LY Reklam Ağı SDK'sının en yeni sürümünü indirin ve projenize FiveAd.framework bağlayın.
LY Reklam Ağı bağdaştırıcısının en yeni 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.

CocoaPods'u kullanma

Aşağıdaki satırı projenizin Podfile dosyasına ekleyin:

pod 'GoogleMobileAdsMediationLine'

Komut satırından şu komutu çalıştırın:

pod install --repo-update

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

AdMob için test cihazınızı kaydettiğinizden emin olun.

LY Ads Reklam Ağı bağdaştırıcısı, LY Ads Reklam Ağı için test modunu etkinleştiren bir yardımcı yöntem içerir. LY Reklam Ağı SDK'sına düzgün şekilde yönlendirilmelerini sağlamak için Google Mobile Ads SDK ilk kullanıma hazırlamadan önce bu seçeneği 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 Reklam Ağı bağdaştırıcısı, GADMediationAdapterLineExtras sınıfı kullanılarak bağdaştırıcıya iletilebilen 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

LY Ads Network bağdaştırıcısı, GADNativeAd için aşağıdaki gelişmiş doğal reklam alan açıklamalarını doldurur.

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

¹ Doğal reklamlar için LY Ads Network SDK'sı bir uygulama simgesi öğesi sağlamaz. Bunun yerine, LY Ads Network reklam ağı bağdaştırıcısı uygulama simgesini şeffaf bir resimle doldurur.

Hata kodları

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

Hata kodu	Alan adı	Neden
1-10	LY Reklam Ağı SDK'sı tarafından gönderildi	LY Reklam Ağı SDK'sı, SDK'ya özgü bir hata döndürdü. Daha fazla bilgi için LY Ads Network'ün belgelerini inceleyin.
101	com.google.ads.mediation.line	Sunucu parametreleri geçersiz (ör. uygulama kimliği veya alan kimliği eksik).
102	com.google.ads.mediation.line	İstenen reklam boyutu, LY Ads Network tarafından desteklenen bir banner reklam boyutuyla eşleşmiyor.
103	com.google.ads.mediation.line	Doğal reklamda bilgi simgesi resim öğesi yüklenemedi.
104	com.google.ads.mediation.line	Teklifli sistem için sinyaller toplanamadı.
105	com.google.ads.mediation.line	LINE Ads SDK reklam yükleyicisi başlatılamadı.