Nend'i 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 bölümde, 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 Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.

Nend'in kontrol paneli arayüzü, etiketleri, düğmeleri ve açıklamaları için Japonca metin kullanır ve aşağıda gösterilen ekran görüntüleri çevrilmemiştir. Ancak, bu kılavuzun metninde etiketlere ve düğmelere İngilizce adlarıyla atıfta bulunulmuştur. Örneğin, "URL ーム", "URL Şeması"dır ve bu şekilde devam eder.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Koşullar

  • Unity 4 veya üzeri
  • En son Google Mobile Ads SDK'sı
  • Android'de dağıtmak için
    • Android API düzeyi 19 veya üstü
  • iOS'te dağıtmak için
    • 12.0 veya üstü iOS dağıtım hedefi
  • Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Unity projesi. Ayrıntılar için Başlarken bölümüne bakın.
  • Uyumlulaştırmayı tamamlayın Başlangıç kılavuzunu

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.

Android

iOS

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

Android

iOS

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 AdMob 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 AdMob nend talebi oluşturun

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

Android

Talimatlar için Android kılavuzunun 2. adımına bakın.

iOS

Talimatlar için iOS rehberinin 2. adımına göz atın.

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

Changelog'daki indirme bağlantısından nend için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsNendMediation.unitypackage paketini çıkarın.

Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsNendMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Ardından, Öğeler > Play Hizmetleri Çözümleyicisi > Android Çözümleyici > Çözücüye Zorla'yı seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemeyi sıfırdan gerçekleştirecek ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalayacaktır.

4. Adım: Gerekli kodu ekleyin

Android

Nend entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için nend dokümanlarını uygulayın.

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

Test reklamlarını etkinleştir

AdMob. Banner'lar, geçiş reklamları ve ödüllü reklamlar için test reklamları almak üzere nend, test reklam birimlerini sunma 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.

Hata kodları

Bağdaştırıcı nend'den bir reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter

iOS

GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend

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:

Android

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

iOS

Hata kodu Alan Neden
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 AdMob 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.

nend Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

Sürüm 8.0.0

Sürüm 7.0.0

Sürüm 6.0.1

Sürüm 6.0.0

Sürüm 5.2.0

Sürüm 5.1.0

Sürüm 5.0.0

Sürüm 4.0.1

Sürüm 4.0.0

Sürüm 3.0.0

Sürüm 2.3.0

Sürüm 2.2.0

Sürüm 2.1.0

  • Eklenti, yeni Ödüllü API'yi destekleyecek şekilde güncellendi.
  • Yeni Android adaptörü 5.1.0.2 sürümünü destekler.
  • Yeni iOS bağdaştırıcısı 5.1.1.0 sürümünü destekler.

Sürüm 2.0.3

  • Yeni Android adaptörü sürüm 5.0.2.1'i destekler.
  • Yeni iOS bağdaştırıcısı 5.0.2.0 sürümünü destekler.

Sürüm 2.0.2

  • Yeni Android adaptörü sürüm 5.0.2.0'ı destekler.
  • Yeni iOS bağdaştırıcısı 5.0.2.0 sürümünü destekler.

Sürüm 2.0.1

  • Yeni Android adaptörü sürüm 5.0.2.0'ı destekler.
  • Yeni iOS bağdaştırıcısı 5.0.1.0 sürümünü destekler.

Sürüm 2.0.0

  • Yeni Android adaptörü 5.0.0.0 sürümünü destekler.
  • Yeni iOS bağdaştırıcısı 5.0.0.0 sürümünü destekler.

Sürüm 1.0.2

  • Yeni Android adaptörü 4.0.5.0 sürümünü destekler.
  • Yeni iOS bağdaştırıcısı 4.0.6.0 sürümünü destekler.

Sürüm 1.0.1

  • Yeni Android SDK 4.0.4 sürümünü destekler.
  • Yeni iOS SDK'sı 4.0.4 sürümünü destekler.

Sürüm 1.0.0

  • İlk sürüm!
  • Yeni Android SDK 4.0.2 sürümünü destekler.
  • Yeni iOS SDK'sı 4.0.2 sürümünü destekler.