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

Platform seçin: Android iOS Unity Flutter Android (Eski)

Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma özelliğini kullanarak LY Reklam Ağı'ndan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK ürününün nasıl kullanılacağı 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 Reklam Ağı 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ü.
Aracılığı 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

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

Alan ekle

Saat dilimiyle 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 formu ekleme

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 olursa LY Reklam Ağı temsilcinizle iletişime geçin.

İnceleme İsteğinde Bulun

Reporting API anahtarı oluşturma

Raporlama API anahtarlarını yönetme sekmesine gidin ve 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 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 Reklam Ağı 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 reklam ağı talebini ayarlayın

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

Şirketler'e LY Reklam Ağı'nı ekleme

Teklif verme

Bu adım, teklifli sistem entegrasyonları için gerekli değildir.

Şelale

Yönetici > Şirketler'e gidin, ardından 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ı Gizli'yi 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 ve Güvenli sinyal paylaşımı'nı inceleyip 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 Reklam Ağı'nı 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 Teklif 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 Teklif Sistemi 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 Reklam Ağı 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 Reklam Ağı'nı 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 Reklam Ağı 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. Envanter ve Uygulama'yı seçin.

Getiri iş ortakları'na gidin ve Uyumlulaştırma iş ortağı ekle'yi tıklayın.

Önceki bölümde LY Reklam Ağı için oluşturduğunuz şirketi seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak iOS'i ve Durum olarak Etkin'i seçin.

Önceki bölümde alınan Uygulama Kimliği ve Alan Kimliği'ni ve Varsayılan BGBM değerini girin. Kaydet'i tıklayın.

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

Swift Package Manager'ı kullanma

Devam etmeden önce, desteklenen minimum adaptör 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ünen 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.

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

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.

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 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 = 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 Reklam Ağı bağdaştırıcısı tarafından her zaman dahil edilen öğeler
Başlık
Resim
Body
Uygulama simgesi	¹
Harekete geçirici mesaj
Yıldız puanı
Mağaza
Fiyat

¹ Doğal reklamlar için LY Ads Network SDK'sı, 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	Geçersiz sunucu parametreleri (ör. eksik uygulama kimliği veya alan kimliği).
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.
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ı.