Bu kılavuzda, şelale entegrasyonlarını kapsayan arabuluculuk kullanarak Google Mobile Ads SDK'sını kullanarak maio'dan reklam yükleme ve görüntüleme hakkında bilgi verilmektedir. Bu makalede, maio'nun bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve maio SDK'sının ve bağdaştırıcının bir Unity uygulamasına nasıl entegre edileceği açıklanmaktadır.
maio'nun kontrol paneli arayüzündeki etiketler, düğmeler ve etiketler için Japonca metin kullanılır. ve bu kılavuzdaki ekran görüntüleri çevrilmemiştir. Ancak buradaki açıklamalarda ve talimatlarda etiketler ile düğmeler İngilizce dilindeki eşdeğerleriyle belirtilmiştir. "URL ホテーム," örneğin, "URL Şeması" olup olmadığı vb.
Desteklenen entegrasyonlar ve reklam biçimleri
Maio için uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:
Entegrasyon | |
---|---|
Teklif verme | |
Şelale | |
Formatlar | |
Banner | |
Geçiş Reklamları | |
Ödüllü |
Şartlar
- Unity 4 veya üzeri
- En son Google Mobile Ads SDK'sı
- Android'de dağıtmak için
- Android API düzeyi 21 veya üstü
- iOS'te dağıtmak için
- 12.0 veya sonraki bir 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şlayın bölümüne bakın.
- Arabuluculuğu 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 oturum açın. Sol kenar çubuğundaki Uygulama yönetimi düğmesini ve ardından 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, ardından Güncelle'yi tıklayın.
Android
iOS
Ödüllü
Uygulamanızın adını girin, platformu seçin ve Uygulama URL'si. Reklam Türü olarak Video Ödülleri'ni seçin ve ardından 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 oluşturmanız gerekir.
Android
iOS
Zone Management (Bölge Yönetimi) sayfasındaki Zone ID (Bölge Kimliği) değerini not edin. Ayrıca, sonraki adımlarda AdMob reklam biriminizi ayarlamanız bölümüne bakın.
Android
iOS
2. Adım: Kullanıcı arayüzünde maio talebini ayarlayın AdMob
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: 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 Unity için Google Mobil Reklamlar uyumlulaştırma eklentisini projenize yükleyebilirsiniz:
openupm add com.google.ads.mobile.mediation.maio
OpenUPM
Unity Paket Yöneticisi Ayarlarını açmak için Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçin.
Kapsamlı Kayıt Daireleri sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı bir kayıt dairesi olarak ekleyin:
- Ad:
OpenUPM
- URL:
https://package.openupm.com
- Kapsamlar:
com.google
Ardından Pencere'ye gidin > Paket Yöneticisi'ni açın ve Unity Paket Yöneticisi ve açılır menüden Kayıt Defterlerim'i seçin.
Google Mobile Ads maio Mediation paketini seçin ve Yükle'yi tıklayın.
Unity Paketi
maio için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü değişiklik günlüğündeki indirme bağlantısından indirin ve GoogleMobileAdsMaioMediation.unitypackage
dosyasını zip dosyasından çıkarın.
Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar >
Özel Paket'e göz atın ve
GoogleMobileAdsMaioMediation.unitypackage
dosyanız olabilir. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.
Ardından Öğeler > Harici Bağımlılık Yöneticisi > Android Çözücü > Çözümü Zorla'yı seçin. Harici Bağımlılık Yöneticisi
bağımlılık çözümünü sıfırdan çözer ve
sitenizin Assets/Plugins/Android
dizinine bağımlıları bildirdiğinizden emin olun.
Unity uygulaması.
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ştir
AdMob.
Google Mobile Ads SDK'sının 7.26.0 veya sonraki bir sürümünü kullanan yayıncılar, istekte bulunurken test cihazı olarak kaydedilmiş telefon ve tabletlerdeki maio'dan otomatik test reklamlarını alır.
Test reklamlarını doğrulama
maioreklam kaynağından test reklamları aldığınızı doğrulamak için maio (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
Hata kodları
Bağdaştırıcı maio'dan bir reklam alamazsa yayıncılar
kullanarak reklam yanıtından gelen temel hata
ResponseInfo
şu sınıflarda:
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üklenemezse maio bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:
Android
Hata kodu | Neden |
---|---|
0-10 | maio, SDK'ya özel bir hata döndürdü. Daha fazla ayrıntı için kodu ve maio'nun dokümanlarını inceleyin. |
101 | Maio'nun kullanabileceği bir reklam yok. |
102 | Geçersiz sunucu parametreleri (ör. yerleşim kimliği eksik). |
103 | 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ürmüştür. Görüntüleyin maio'nun kodu inceleyebilirsiniz. |
101 | maio henüz reklam yayınlamıyor. |
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 zaten bir reklam yüklü. |
maio Unity Mediation Plugin Changelog
Sürüm 2.0.3
- maio Android bağdaştırıcısının 1.1.16.3 sürümünü destekler.
- maio iOS adaptörünün 2.1.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.
2.0.2 sürümü
- maio Android bağdaştırıcısının 1.1.16.3 sürümünü destekler.
- maio iOS bağdaştırıcısının 2.1.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip test edilmiştir.
2.0.1 sürümü
- maio Android adaptörünün 1.1.16.2 sürümünü destekler.
- maio iOS bağdaştırıcısının 2.1.3.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip test edilmiştir.
2.0.0 sürümü
- maio Android bağdaştırıcısının 1.1.16.2 sürümünü destekler.
- maio iOS adaptörünün 2.1.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.6.0 sürümü ile oluşturulup test edilmiştir.
1.4.3 sürümü
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/Maio/
hedefine taşındı. - maio Android adaptörünün 1.1.16.2 sürümünü destekler.
- maio iOS adaptörünün 1.6.3.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.1.0 sürümü ile oluşturulup test edilmiştir.
1.4.2 sürümü
- maio Android adaptörünün 1.1.16.1 sürümünü destekler.
- maio iOS adaptörünün 1.6.3.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.4.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 1.4.1
- maio Android bağdaştırıcısının 1.1.16.1 sürümünü destekler.
- maio iOS adaptörünün 1.6.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.1.0 sürümü ile derlenmiş ve test edilmiştir.
Sürüm 1.4.0
- maio Android adaptörünün 1.1.16.0 sürümünü destekler.
- maio iOS bağdaştırıcısının 1.6.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 1.3.6
- maio Android bağdaştırıcısının 1.1.16.0 sürümünü destekler.
- maio iOS adaptörünün 1.5.8.0 sürümünü destekler.
Sürüm 1.3.5
- maio Android bağdaştırıcısının 1.1.15.0 sürümünü destekler.
- maio iOS adaptörünün 1.5.6.1 sürümünü destekler.
1.3.4 sürümü
- maio Android bağdaştırıcısının 1.1.11.1 sürümünü destekler.
- maio iOS bağdaştırıcısının 1.5.4.0 sürümünü destekler.
Sürüm 1.3.3
- maio Android adaptörünün 1.1.11.1 sürümünü destekler.
- maio iOS bağdaştırıcısı 1.5.3.1 sürümünü destekler.
1.3.2 sürümü
- maio Android adaptörünün 1.1.11.0 sürümünü destekler.
- maio iOS bağdaştırıcısı 1.5.2.1 sürümünü destekler.
1.3.1 sürümü
- maio Android adaptör sürümü 1.1.10.0'u destekler.
- maio iOS bağdaştırıcısının 1.5.1.0 sürümünü destekler.
1.3.0 sürümü
- maio Android adaptör sürümü 1.1.10.0'u destekler.
- maio iOS adaptörünün 1.5.0.0 sürümünü destekler.
Sürüm 1.2.3
- Eklenti, yeni Rewarded API'yi destekleyecek şekilde güncellendi.
- maio Android bağdaştırıcısının 1.1.7.0 sürümünü destekler.
- maio iOS adaptörünün 1.4.6.0 sürümünü destekler.
1.2.2 sürümü
- maio Android bağdaştırıcısının 1.1.6.0 sürümünü destekler.
- maio iOS adaptörünün 1.4.2.0 sürümünü destekler.
Sürüm 1.2.1
- maio Android bağdaştırıcısının 1.1.6.0 sürümünü destekler.
- maio iOS adaptörünün 1.4.1.0 sürümünü destekler.
Sürüm 1.2.0
- maio Android bağdaştırıcısının 1.1.4.1 sürümünü destekler.
- maio iOS bağdaştırıcısının 1.4.0.0 sürümünü destekler.
Sürüm 1.1.3
- maio Android bağdaştırıcısının 1.1.3.1 sürümünü destekler.
- maio iOS adaptörünün 1.3.2.0 sürümünü 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 adaptörünün 1.3.2.0 sürümünü destekler.
1.1.1 sürümü
- maio Android bağdaştırıcısının 1.1.1.0 sürümünü destekler.
- maio iOS bağdaştırıcısının 1.3.1.1 sürümünü destekler.
Sürüm 1.1.0
- maio Android adaptörünün 1.1.0.0 sürümünü destekler.
- maio iOS adaptörünün 1.3.0.0 sürümünü destekler.
Sürüm 1.0.2
- maio Android SDK'sı 1.0.8 sürümünü destekler.
- maio iOS SDK'sının 1.2.19 sürümünü destekler.
1.0.1 sürümü
- maio Android SDK'sı 1.0.7 sürümünü 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ının 1.0.6 sürümünü destekler.
- maio iOS SDK'sının 1.2.18 sürümünü destekler.