Bu sayfa, Cloud Translation API ile çevrilmiştir.

Ara mülkü Uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını ele alan uyumlulaştırma özelliğini kullanarak nend'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu kılavuzda, bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl nend ekleneceğini ve nend SDK ile bağdaştırıcının bir uygulamaya nasıl entegre edileceğiAndroid ele alınır.

Nend'in kontrol paneli arayüzü, etiketleri, düğmeleri ve açıklamaları için Japonca metin kullanır ve aşağıda görüntülenen ekran görüntüleri çevrilmemiştir. Bu kılavuzda, etiketlere ve düğmelere İngilizce eşdeğerleri referans verilmiştir. Örneğin, "URL ーム", "URL Şeması"dır ve bu şekilde devam eder.

Desteklenen entegrasyonlar ve reklam biçimleri

Nend için Ad Manager uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif
Şelale
Formatlar
Banner
Geçişli
Ödül olarak verildi
Yerel biçim

Koşullar

Android API düzeyi 19 veya üstü

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu

1. Adım: Nend kullanıcı arayüzünde yapılandırmaları ayarlayın

Nend hesabınıza kaydolun veya oturum açın.

Uygulamanızı yeni oluşturma kontrol paneline eklemek için ilk olarak Yerleşim Yönetimi sekmesini tıklayın ve ardından Site/Uygulama'yı seçin. Uygulamanızı eklemek için Uygulama ekle düğmesini tıklayın.

Uygulama oluşturma

Uygulamanızın adını girin ve uygulama türü olarak uygulama platformunuzu seçin. URL'yi girin ve uygulamanızın uygun uygulama mağazasında listelenip listelenmediğini kontrol edin

(Uygulamanız henüz yayınlanmamışsa nend'in yayınlanmamış uygulamalarla ilgili SSS bölümüne bakın). Uygulamanız için bir kategori seçin ve işiniz bittiğinde Oluştur'u tıklayın.

Uygulamanız oluşturulduktan sonra kontrol panelinde gösterilir.

Yerleşim oluşturma

Uygulama kaydedildikten sonra yerleşim oluşturmaya geçebilirsiniz. Banner reklamlar için bir yerleşim oluşturmak üzere Yerleşim Yönetimi sekmesine gidin ve Yerleşim'i tıklayın. Ardından, Yeni yerleşim oluştur düğmesini tıklayın.

Açılır menüden uygulamanızı seçin. Ardından, tercih ettiğiniz reklam biçimine uygun aşağıdaki talimatları izleyin.

Reklam türü olarak Sabit resim'i ve Envanter türü için Banner'ı seçin. Bu işlemden sonra Yerleşim Adı girin, Envantere giriş bölümünü doldurun, Envanter biçimi ve son olarak Envanter boyutu seçin. İşlemi tamamladığınızda, yerleşiminizi oluşturmak için Oluştur düğmesini tıklayın.

Geçişli

Reklam türü olarak Sabit resim'i ve Envanter türü için Geçiş reklamı'nı seçin. Ardından bir Yerleşim Adı girin, Envantere giriş bölümünü doldurun ve açılır listeden bir Reklam görüntüleme sıklığı seçin. İşlemi tamamladığınızda, yerleşiminizi oluşturmak için Oluştur düğmesini tıklayın.

Geçiş video reklamları söz konusu olduğunda Reklam türü olarak Video'yu ve Envanter türü olarak Geçiş reklamı'nı seçin. Bu işlem tamamlandıktan sonra bir Yerleşim Adı girin, Envantere giriş alanını doldurun ve açılır listeden uygun bir Kategori seçin. İşlemi tamamladığınızda, yerleşiminizi oluşturmak için Oluştur düğmesini tıklayın.

Ödül olarak verildi

Reklam türü olarak Video'yu ve Envanter türü için Ödül'ü seçin. Bunu yaptıktan sonra bir Yerleşim Adı girin, Envantere giriş bölümünü doldurun ve açılır listeden uygun bir Kategori'yi seçin.

Ödül ayarları altında açılır listeyi kullanarak Ödül içeriği'ni seçin ve tercih ettiğiniz Sanal para birimi adını girin. İşlemi tamamladığınızda, yerleşiminizi oluşturmak için Oluştur düğmesini tıklayın.

Yerel biçim

Reklam türü olarak Sabit resim'i ve Envanter türü için Yerel'i seçin. Bu işlemden sonra Yerleşim Adı girin, Envantere giriş bölümünü doldurun ve Reklam resmi seçimi seçin. İşlemi tamamladığınızda, yerleşiminizi oluşturmak için Oluştur düğmesini tıklayın.

Yerel video reklamlar için Reklam türü olarak Video'yu ve Envanter türü olarak Yerel (özel) seçeneğini belirleyin. Bu işlem tamamlandıktan sonra bir Yerleşim Adı girin, Envantere giriş alanını doldurun ve açılır listeden uygun bir Kategori seçin.

Yerel ayarlar'ın altındaki listeden Video reklam yönü ve Yerel reklam türü seçin. İşlemi tamamladığınızda, yerleşiminizi oluşturmak için Oluştur düğmesini tıklayın.

Sonraki bölümde Ad Manager reklam biriminizi ayarlamak için her yerleşimin apiKey ve spotID'lerine ihtiyacınız olacak. Yerleşimleri bulmak için Yerleşim Yönetimi sekmesine gidin ve uygulama adının altındaki SDK düğmesini seçin.

apiKey ve spotID değerlerini not edin.

Ayrıca, nend'in Kazıma İçin API Anahtarı adını verdiği raporlama API'si için API Anahtarınıza da ihtiyacınız olacaktır. Bu aracı Araçlar sekmesinde bulabilirsiniz.

2. Adım: Kullanıcı arayüzünde Ad Manager nend talebi oluşturun

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

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

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın.

Getiri grubunuz için benzersiz bir Ad girin, Durum'u Etkin olarak ayarlayın, Reklam Biçimi'ni seçin ve Envanter türü'nü Mobil Uygulama olarak ayarlayın. Hedefleme > Envanter bölümünün altında Envanter ve Mobil uygulama altında uyumlulaştırma eklemek istediğiniz reklam birimini seçin.

Ardından, Getiri iş ortağı ekle düğmesini tıklayın.

nendiçin zaten bir Getiri iş ortağınız varsa bunu seçebilirsiniz. Aksi takdirde, Yeni bir getiri iş ortağı oluştur'u seçin.

Reklam ağı olarak nend'i seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin.

Otomatik veri toplama'yı açın ve önceki bölümde belirtilen Reporting API Key from the API Key for Scraping değerini girin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK Uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin. Bir önceki bölümde verilenSlot ID and API Key kodunu girin. Ardından, Varsayılan BGBM değerini girin.

İşiniz bittiğinde sayfanın alt kısmındaki Kaydet'i tıklayın.

3. Adım: Nend SDK'sını ve bağdaştırıcıyı içe aktarın

Android Studio entegrasyonu (önerilir)

Proje düzeyindeki settings.gradle.kts dosyanıza aşağıdaki depoları ekleyin:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://fan-adn.github.io/nendSDK-Android-lib/library")
    }
  }
}

Ardından, uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıklarını ve yapılandırmaları ekleyin. Nend SDK ve bağdaştırıcısının en son sürümlerini kullanın:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:nend:10.0.0.0")
}

Manuel entegrasyon

nend Android SDK'nın en son sürümünü indirin ve projenize ekleyin.
Google'ın Maven deposunda nend bağdaştırıcı yapılarına gidin. En son sürümü seçin, nend adaptörünün .aar dosyasını indirin ve projenize ekleyin.

5. Adım: Gerekli kodu ekleyin

Nend entegrasyonu için ek kod gerekmez.

6. Adım: Uygulamanızı test etme

Test reklamlarını etkinleştir

Ad Manager. Banner'lar, geçiş reklamları ve ödüllü reklamlar için test reklamları almak üzere nend, nend test reklam birimlerinde sayfasında sağlanan API anahtarlarını ve Spot kimliklerini kullanmanızı önerir. Bunlar test sırasında AdMob reklam birimleriniz için API Anahtarları ve Spot Kimlikleri olarak girilebilir, ardından uygulamanız üretime hazır olduğunda gerçek bir API Anahtarı ve Spot Kimliği ile değiştirilebilir.

Test reklamlarını doğrulama

nendreklam kaynağından test reklamları aldığınızı doğrulamak için nend (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özgü parametreler

Nend bağdaştırıcısı, NendExtrasBundleBuilder sınıfı kullanılarak bağdaştırıcıya geçirilebilecek ek istek parametrelerini destekler. Bu sınıf aşağıdaki yöntemleri içerir:

setInterstitialType(InterstitialType): Nend, normal geçiş reklamları için TYPE_NORMAL veya geçiş video reklamları için TYPE_VIDEO seçeneğini belirleme olanağı sunar. Nend, bu fazladan parametre eklenmezse geçiş reklamı türü olarak varsayılan olarak TYPE_NORMAL kullanır.
setNativeAdsType(nativeAdsType): Nend, normal yerel reklamlar için TYPE_NORMAL veya yerel video reklamlar için TYPE_VIDEO seçeneğini belirleme seçeneği sunar. Bu ek parametre eklenmediği takdirde Nend varsayılan olarak yerel reklam türü olarak TYPE_NORMAL kullanır.

Java

Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
                        .setInterstitialType(InterstitialType.TYPE_NORMAL)
                        .setNativeAdsType(FormatType.TYPE_NORMAL)
                        .build();

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build();

adLoader.loadAd(adRequest);

Kotlin

val bundle = NendAdapter.NendExtrasBundleBuilder()
                     .setInterstitialType(InterstitialType.TYPE_NORMAL)
                     .setNativeAdsType(FormatType.TYPE_NORMAL)
                     .build()

val adRequest = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build()

adLoader.loadAd(adRequest)

Yerel reklamları kullanma

Reklam oluşturma

Nend bağdaştırıcısı, yerel reklamlarını NativeAd nesne olarak döndürür. Aşağıdaki alanlarını bir NativeAd için doldurur.

Alan	Nend bağdaştırıcısı tarafından doldurulur
Başlık
Resim	1
Metin
Uygulama simgesi	2
Harekete geçirici mesaj
Reklamveren Adı
Yıldızlı değerlendirme
Depolama
Fiyat

¹ Nend yalnızca, Reklam resmi seçimi Yatay (5: 3) büyük reklam resmi olarak ayarlanmış yapılandırılmış yerel yerleşimler için bir Resim öğesi sağlar.

² Nend, Reklam resmi seçimi Resim yok (yalnızca metin) olarak ayarlanmış yapılandırılmış yerel yerleşimler için bir simge öğesi sağlamaz.

Hata kodları

Bağdaştırıcı nend'den reklam alamazsa yayıncılar aşağıdaki sınıfların altında ResponseInfo.getAdapterResponse() kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Biçim	Sınıf adı
Banner	com.google.ads.mediation.nend.NendAdapter
Geçişli	com.google.ads.mediation.nend.NendAdapter
Ödül olarak verildi	com.google.ads.mediation.nend.NendRewardedAdapter
Yerel biçim	com.google.ads.mediation.nend.NendMediationAdapter

Bir reklam yüklenemediğinde nend bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajlar aşağıda verilmiştir:

Hata kodu	Alan	Neden
101	com.google.ads.mediation.nend	nend, reklamların yüklenmesi ve gösterilmesi için bir etkinlik bağlamı gerektirir.
102	com.google.ads.mediation.nend	Kullanıcı arayüzünde yapılandırılan nend sunucusu parametreleri Ad Manager eksik/geçersiz.
103	com.google.ads.mediation.nend	nend reklamı henüz gösterilmeye hazır değil.
104	com.google.ads.mediation.nend	reklamı oynatamadı.
105	com.google.ads.mediation.nend	İstenen reklam boyutu, desteklenen bir banner boyutuyla eşleşmiyor.
106	com.google.ads.mediation.nend	Bağlam nesnesi referansı `null` ve/veya yakın zamanda bellekten serbest bırakıldı.
200-299	net.nend.android	nend SDK'sı bir geçiş reklamı yükleme hatası döndürdü. Daha fazla bilgi için kodu inceleyin.
300-399	net.nend.android	nend SDK'sı bir geçiş reklamı gösterme hatası döndürdü. Daha fazla bilgi için kodu inceleyin.
400-499	net.nend.android	nend SDK'sı bir reklam hatası döndürdü. Daha fazla bilgi için kodu inceleyin.
101	com.google.mediation.nend	nend SDK, ek hata bilgisi olmadan bir yükleme hatası geri çağırma döndürdü.
102	com.google.mediation.nend	nend SDK'sı, ek hata bilgisi olmadan bir hata gösterme geri çağırması döndürdü.
103	com.google.mediation.nend	Kullanıcı arayüzünde yapılandırılan nend sunucusu parametreleri Ad Manager eksik/geçersiz.
104	com.google.mediation.nend	Yerel reklam resim öğeleri yüklenemedi.
105	com.google.mediation.nend	Reklam hazır olmadığı için satır reklamları gösterilemedi.
106	com.google.mediation.nend	İstenen banner reklam boyutu, desteklenen bir banner boyutuyla eşleşmiyor.
200-699	nend SDK tarafından gönderildi.	nend SDK'sı bir hata döndürdü. Daha fazla bilgi için nend'in belgesine bakın.