maio'yu uyumlulaştırma ile entegre etme

Bu kılavuz, uyumlaştırma kullanarak maio'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağını şelale entegrasyonlarını kapsayarak açıklar. Bu açıklamalar, maio'nun bir reklam biriminin uyumlaştırma yapılandırmasına nasıl ekleneceğini ve maio SDK'sının ve bağdaştırıcısının bir Unity uygulamasına nasıl entegre edileceğini kapsar.

maio'nun kontrol paneli arayüzünde etiketler, düğmeler ve açıklamalar için Japonca metinler kullanılıyor. Bu kılavuzdaki ekran görüntüleri çevrilmedi. Ancak buradaki açıklamalarda ve talimatlarda etiketler ve düğmeler, İngilizce dilindeki karşılıklarıyla ifade edilir. Örneğin, "URL スキーム" ifadesi "URL Scheme" (URL Şeması) anlamına gelir.

Desteklenen entegrasyonlar ve reklam biçimleri

maio için uyumlaştırma adaptörünün özellikleri şöyledir:

Entegrasyon
Teklifli sistem
Şelale
Formatlar
Banner
Geçiş Reklamları
Ödüllü

Şartlar

  • En son Google Mobile Ads SDK'sı
  • Unity 4 veya daha yeni bir sürüm
  • Android'de dağıtmak için
    • Android API düzeyi 23 veya üstü
  • iOS'te dağıtmak için
    • iOS 12.0 veya üzeri sürüm 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şlangıç başlıklı makaleyi inceleyin.
  • Uyumlulaştırma Başlangıç Kılavuzu'nu tamamlama

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

Öncelikle maio hesabınıza kaydolun veya giriş yapın. Sol kenar çubuğunda Uygulama yönetimi düğmesini ve Yeni uygulama'yı tıklayın.

Tercih ettiğiniz reklam türüne karşılık gelen sekmeyi seçin.

Geçiş reklamı

Uygulamanızın Adı'nı girin, platformu seçin ve Uygulama URL'nizi sağlayın. Reklam Türü olarak Video geçiş reklamı'nı seçin ve Güncelle'yi tıklayın.

Android

iOS

Ödüllü

Uygulamanızın Adı'nı girin, platformu seçin ve Uygulama URL'nizi sağlayın. Reklam Türü olarak Ödüllü Video'yu seçin ve Güncelle'yi tıklayın.

Android

iOS

Uygulama Yönetimi sayfasında Medya Kimliği'ni not edin. Bir sonraki bölümde Ad Manager reklam biriminizi ayarlamak için gereklidir.

Android

iOS

Zone Management (Bölge Yönetimi) sayfasında Zone ID'yi (Bölge Kimliği) not edin. Ayrıca, bir sonraki bölümde Ad Manager reklam biriminizi ayarlamak için de gereklidir.

Android

iOS

(Yalnızca şelale) Uyumlulaştırma için reklam birimi kimliğinizi ayarlamak üzere Medya Kimliği ve Bölge Kimliği'ne ek olarak API Kimliği ve API ANAHTARI'na da ihtiyacınız olacaktır. Reporting API sayfasında API ID ve API KEY değerlerini not edin.

2. adım: Ad Manager kullanıcı arayüzünde maio 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: maio SDK'sını ve bağdaştırıcısını içe aktarın

OpenUPM-CLI

OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak Google Mobile Ads maio Mediation Plugin for Unity'yi projenize yükleyebilirsiniz:

openupm add com.google.ads.mobile.mediation.maio

OpenUPM

Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçerek Unity Paket Yöneticisi Ayarları'nı açın.

Scoped Registries (Kapsamlı Kayıtlar) sekmesinde, aşağıdaki ayrıntıları kullanarak OpenUPM'yi kapsamlı kayıt olarak ekleyin:

  • Ad: OpenUPM
  • URL: https://package.openupm.com
  • Kapsamlar: com.google

OpenUPM Ayrıntıları

Ardından, Pencere > Paket Yöneticisi'ne giderek Unity Paket Yöneticisi'ni açın ve açılır menüden Kayıtlarım'ı seçin.

Unity Registries

Google Mobile Ads Maio Mediation paketini seçin ve Yükle'yi tıklayın.

OpenUPM'den yükleme

Unity paketi

maio için Google Mobil Reklamlar aracılık eklentisinin en son sürümünü Değişiklik Günlüğü'ndeki indirme bağlantısından indirin ve zip dosyasından GoogleMobileAdsMaioMediation.unitypackage dosyasını çıkarın.

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

Unity'den içe aktarma

Ardından Assets > External Dependency Manager > Android Resolver > Force Resolve'u (Öğeler > Harici Bağımlılık Yöneticisi > Android Çözümleyici > Çözümü Zorla) seçin. External Dependency Manager kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

Çözüme Zorla

4. adım: Gerekli kodu ekleyin

Android

maio entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için maio'nun 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.

Google Mobile Ads SDK'sının 7.26.0 veya daha sonraki bir sürümünü kullanan yayıncılar, istekte bulunduklarında test cihazları olarak kaydedilen telefon ve tabletlerde maio'dan otomatik olarak test reklamları alır.

Test reklamlarını doğrulama

maio'dan test reklamları aldığınızı doğrulamak için maio (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

Hata kodları

Adaptör maio'dan reklam alamıyorsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

Biçim Sınıf adı
Geçiş reklamı jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Ödüllü jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

Biçim Sınıf adı
Geçiş reklamı GADMMaioInterstitialAdapter
Ödüllü GADMMaioRewardedAdapter

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

Android

Hata kodu Neden
0-10 maio, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için kodu ve maio'nun dokümanlarını inceleyin.
101 Maio'da reklam bulunmuyor.
102 Geçersiz sunucu parametreleri (ör. yerleşim kimliği eksik).
103 Bir reklamı yüklemek için kullanılan bağlam bir "Etkinlik" örneği değildi.

iOS

Hata kodu Neden
0-10 maio, SDK'ya özgü bir hata döndürdü. Daha fazla bilgi için maio'nun koduna bakın.
101 maio'da henüz reklam yok.
102 Geçersiz sunucu parametreleri (ör. yerleşim kimliği eksik).
103 maio bağdaştırıcısı, istenen reklam biçimini desteklemiyor.
104 Bu ağ yapılandırması için bir reklam zaten yüklenmiş.

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

Sürüm 3.0.2

Sürüm 3.0.1

Sürüm 3.0.0

Sürüm 2.0.4

Sürüm 2.0.3

Sürüm 2.0.2

Sürüm 2.0.1

Sürüm 2.0.0

Sürüm 1.4.3

Sürüm 1.4.2

Sürüm 1.4.1

Sürüm 1.4.0

Sürüm 1.3.6

Sürüm 1.3.5

1.3.4 sürümü

Sürüm 1.3.3

Sürüm 1.3.2

Sürüm 1.3.1

Sürüm 1.3.0

Sürüm 1.2.3

  • Yeni Rewarded API'yi desteklemek için eklenti güncellendi.
  • maio Android bağdaştırıcısı 1.1.7.0 sürümünü destekler.
  • maio iOS bağdaştırıcısı 1.4.6.0 sürümünü destekler.

Sürüm 1.2.2

  • maio Android bağdaştırıcısı 1.1.6.0 sürümünü destekler.
  • maio iOS bağdaştırıcı sürümü 1.4.2.0'ı destekler.

Sürüm 1.2.1

  • maio Android bağdaştırıcısı 1.1.6.0 sürümünü destekler.
  • maio iOS bağdaştırıcısı sürüm 1.4.1.0'ı destekler.

Sürüm 1.2.0

  • maio Android bağdaştırıcısı 1.1.4.1 sürümünü destekler.
  • maio iOS bağdaştırıcısı sürüm 1.4.0.0'ı destekler.

Sürüm 1.1.3

  • maio Android bağdaştırıcısı sürüm 1.1.3.1'i destekler.
  • maio iOS bağdaştırıcı sürümü 1.3.2.0'ı destekler.

Sürüm 1.1.2

  • maio Android bağdaştırıcısının 1.1.3.0 sürümünü destekler.
  • maio iOS bağdaştırıcı sürümü 1.3.2.0'ı destekler.

Sürüm 1.1.1

  • maio Android bağdaştırıcısı sürüm 1.1.1.0'ı destekler.
  • maio iOS bağdaştırıcısı 1.3.1.1 sürümünü destekler.

Sürüm 1.1.0

  • maio Android bağdaştırıcısı sürüm 1.1.0.0'ı destekler.
  • maio iOS bağdaştırıcısı sürüm 1.3.0.0'ı destekler.

Sürüm 1.0.2

  • maio Android SDK sürüm 1.0.8'i destekler.
  • maio iOS SDK'sının 1.2.19 sürümünü destekler.

Sürüm 1.0.1

  • maio Android SDK sürüm 1.0.7'yi destekler.
  • maio iOS SDK'sının 1.2.19 sürümünü destekler.

Sürüm 1.0.0

  • İlk sürüm!
  • maio Android SDK sürüm 1.0.6'yı destekler.
  • maio iOS SDK'sının 1.2.18 sürümünü destekler.