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.
Banner
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
- nend Android adaptör sürümü 10.0.0.0'ı destekler.
- nend iOS bağdaştırıcısı 8.2.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.6.0 ile geliştirilip test edilmiştir.
Sürüm 7.0.0
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/Nend/
klasörüne taşındı. - Bağdaştırıcı ad alanı,
GoogleMobileAds.Mediation.Nend
kullanılacak şekilde yeniden düzenlendi. - Yeni Android adaptörü 9.0.1.0 sürümünü destekler.
- Yeni sürüm iOS bağdaştırıcısı 8.0.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.1.0 ile geliştirilip test edilmiştir.
Sürüm 6.0.1
- Yeni Android adaptörü 9.0.0.0 sürümünü destekler.
- Yeni iOS bağdaştırıcısı 7.4.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.4.1 ile geliştirilip test edilmiştir.
Sürüm 6.0.0
- Yeni Android adaptörü 9.0.0.0 sürümünü destekler.
- nend iOS bağdaştırıcısı 7.4.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.2.0 ile geliştirilip test edilmiştir.
Sürüm 5.2.0
- Yeni Android adaptörü 8.1.0.1 sürümünü destekler.
- nend iOS bağdaştırıcısı 7.3.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.2 ile geliştirilip test edilmiştir.
Sürüm 5.1.0
- Yeni Android adaptörü 8.1.0.0 sürümünü destekler.
- nend iOS bağdaştırıcısı 7.2.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.0 ile geliştirilip test edilmiştir.
Sürüm 5.0.0
- Yeni Android adaptörü 8.0.1.0 sürümünü destekler.
- nend iOS bağdaştırıcısı 7.1.0.0 sürümünü destekler.
Sürüm 4.0.1
- Yeni Android adaptörü 7.0.3.0 sürümünü destekler.
- Yeni iOS bağdaştırıcısı 7.0.5.0 sürümünü destekler.
Sürüm 4.0.0
- Yeni Android adaptörü 7.0.0.0 sürümünü destekler.
- nend iOS bağdaştırıcısı 7.0.0.0 sürümünü destekler.
Sürüm 3.0.0
- Yeni Android adaptörü 6.0.1.0 sürümünü destekler.
- Yeni sürüm iOS bağdaştırıcısı 6.0.1.0 sürümünü destekler.
Sürüm 2.3.0
- Yeni Android adaptörü 5.4.2.0 sürümünü destekler.
- Yeni iOS bağdaştırıcısı 5.4.1.0 sürümünü destekler.
Sürüm 2.2.0
- Yeni Android adaptörü 5.3.0.0 sürümünü destekler.
- nend iOS bağdaştırıcısı 5.3.0.0 sürümünü destekler.
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.