LY Ads Network'ü AdMob Uyumlulaştırması ile entegre etme

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

Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma özelliğini kullanarak LY Reklam Ağı'ndan reklam yüklemek ve göstermek için Google Mobile Ads SDK for React Native ürününün nasıl kullanılacağı gösterilmektedir. Bu açıklamalar, LY Reklam Ağı'nın bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve LY Reklam Ağı SDK'sının ve bağdaştırıcısının bir React Native yerel uygulamasına nasıl entegre edileceğini kapsar.

Desteklenen entegrasyonlar ve reklam biçimleri

LY Ads Network için AdMob uyumlulaştırma bağdaştırıcısının özellikleri şöyledir:

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

Ön koşullar

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

• En yeni Google Mobile Ads SDK for React Native sürümü.
• React Native çerçevesinin 0.85.0 veya sonraki sürümleri
• Android'de dağıtmak için
  • Android API düzeyi 24 veya sonraki sürümler
• iOS'te dağıtmak için
  • iOS 13.0 veya sonraki sürüm dağıtım hedefi
• Google Mobile Ads SDK for React Native ile yapılandırılmış çalışan bir React Native projesi. Ayrıntılar için Google Mobile Ads SDK for React Native hizmetini kurma başlıklı makaleyi inceleyin.
  • adapters klasörünü indirip gma-sdk-react-native klasöründen çıkardığınızdan emin olun. adapters klasörünüz yoksa Google Mobile Ads SDK for React Native uygulamasını yükleme bölümündeki bir, iki ve üçüncü adımları uygulayın.
• 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.

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

Not: Desteklemek istediğiniz her platform için ayrı bir uygulama oluşturmanız gerekir.

Uygulama kimliğini not edin.

Android

iOS

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.

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.

Not: Alan kaydedildikten sonra Reklam biçimi ve Teklif Türü değiştirilemez. LY Ads Network kullanıcı arayüzünde doğal reklam yerleşimleri oluşturma erişimi elde etmek için LY Ads Network hesap yöneticinizle iletişime geçin.

Alan kimliğini not edin.

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

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.

Formu doldurup Kaydet'i tıklayın.

API Anahtarı Kimliğinizi ve API Anahtarı Gizli Anahtarınızı 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. 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

Android

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

Talimatlar için iOS kılavuzundaki 2. adıma bakın.

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

Not: Uyumlu LY Ads Network ve Google Mobile Ads SDK'sı sürümlerinin entegre edilmemesi derleme sorunlarına yol açabilir.

Projenizin kök dizinine LY Ads Network için Google Mobile Ads SDK for React Native uyumlulaştırma bağdaştırıcısını yükleyin. Aşağıdakileri tamamlayın:

1. gma-sdk-react-native/adapters/line/ dizinindeki Google Mobile Ads SDK for React Native bağdaştırıcı tar dosyasını projenizin local_packages/ dizinine kopyalayın. adapters klasörünüz yoksa Ön koşullar bölümüne bakın.

   mkdir -p local_packages
   cp EXTRACT_DIR/gma-sdk-react-native/adapters/line/gma-mediation-line-0.1.0.tgz local_packages/
   

   EXTRACT_DIR ifadesini, arşivi çıkardığınız dizinin yoluyla değiştirin.

2. Tercih ettiğiniz paket yöneticisini kullanarak bağdaştırıcı paketini yükleyin:

   npm

   npm install ./local_packages/gma-mediation-line-0.1.0.tgz
   

   yumak

   yarn add ./local_packages/gma-mediation-line-0.1.0.tgz
   

4. adım: Gerekli kodu ekleyin

Android

LY Reklam Ağı entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için LY reklam ağını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.

Önemli: Uygulamanızı yayınlamadan önce AdMob ve LY Reklam Ağı için test modunu devre dışı bırakın.

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 React Native uyumlulaştırma eklentisi, LineMediationExtras sınıfı aracılığıyla bağdaştırıcıya iletilebilen aşağıdaki ek istek parametresini destekler:

• enableAdSound : 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:

import { LineMediationExtras } from '@google/gma-mediation-line';

const request = {
  // ...
  mediationExtras: [
    new LineMediationExtras({
      enableAdSound: true,
    }),
  ],
};

Hata kodları

Adaptör, LY Reklam Ağı'ndan reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

Bir reklam yüklenemediğinde LY Reklam Ağı bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

Android

Hata kodu	Alan adı	Neden
1-10	com.five_corp.ad	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	Uygulama kimliği eksik veya geçersiz.
102	com.google.ads.mediation.line	Alan kimliği eksik veya geçersiz.
103	com.google.ads.mediation.line	İstenen reklam boyutu, LY Ads Network tarafından desteklenen bir banner reklam boyutuyla eşleşmiyor.
104	com.google.ads.mediation.line	Eksik etkinlik bağlamı nedeniyle geçiş reklamı veya ödüllü reklam yüklenemedi.
105	com.google.ads.mediation.line	LY Ads Network SDK'sı, geçiş reklamı veya ödüllü reklam gösteremedi.
106	com.google.ads.mediation.line	Eksik öğeler nedeniyle doğal reklam yüklenemedi.
107	com.google.ads.mediation.line	FiveAd SDK'sı boş bir reklam yükleyici döndürdü.

iOS

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

Sürüm 0.1.0

• İlk sürüm.

• LINE Android bağdaştırıcısı 3.1.1.2 sürümünü destekler.
• LINE iOS bağdaştırıcısı 3.1.1.0 sürümünü destekler.
• Google Mobile Ads React Native eklentisi 0.1.0 sürümüyle oluşturulmuş ve test edilmiştir.