maio'yu uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını kapsayacak şekilde aracılık kullanarak maio'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK'sını nasıl kullanacağınız gösterilmektedir. Bu dokümanda, maio'nun bir reklam biriminin arabuluculuk yapılandırmasına nasıl ekleneceği ve maio SDK'sının ve bağdaştırıcısının bir Unity uygulamasına nasıl entegre edileceği açıklanmaktadır.

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 arabuluculuk bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif verme
Şelale
Formatlar
Banner
Geçiş Reklamları
Ödüllü

Şartlar

  • En yeni 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 sonraki bir sürümün 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ırmayı tamamlama Başlangıç kılavuzu

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 Video Ödülleri'ni 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 AdMob 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 AdMob 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: AdMob kullanıcı arayüzünde maio talebini ayarlayın

Reklam biriminiz için aracılık 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 projenize Google Mobile Ads maio Mediation Plugin for Unity'yi 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

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

Unity proje düzenleyicinizde Assets (Öğeler) > Import Package (Paket İç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 (Öğeler) > External Dependency Manager (Harici Bağımlılık Yöneticisi) > Android Resolver (Android Çözücü) > Force Resolve'u (Çö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

AdMob için test cihazınızı kaydettiğinizden emin olun.

Google Mobile Ads SDK'sının 7.26.0 veya daha yeni 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 reklam inceleyicide maio (Şelale) reklam kaynaklarını kullanarak tek reklam kaynağı testini etkinleştirin.

Hata kodları

Adaptör, maio'dan reklam alamazsa yayıncılar aşağıdaki sınıflar altında 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 şunlardır:

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 belgelerini 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 Mediation Plugin 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 ödüllü 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ı sürüm 1.3.2.0'ı destekler.

Sürüm 1.1.2

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

Sürüm 1.1.1

  • maio Android bağdaştırıcı 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.