Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma aracılığıyla maio'dan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bir reklam biriminin uyumlulaştırma yapılandırmasına maio ekleme ve maio SDK ile bağdaştırıcıyı bir Unity uygulamasına entegre etme konuları ele alınmaktadır.
maio'nun kontrol paneli arayüzündeki etiketler, düğmeler ve açıklamalar için Japonca metin kullanılmaktadır. Bu kılavuzdaki ekran görüntüleri çevrilmemiştir. Bununla birlikte, buradaki açıklama ve talimatlarda etiketler ve düğmeler İngilizce eşdeğerleri ile anılır. Örneğin, "URL グーム", "URL Şeması"dır.
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 | |
Şelale | |
Formatlar | |
Banner | |
Geçiş Reklamları | |
Ödül olarak verildi |
Koşullar
- Unity 4 veya sonraki sürümler
- En son Google Mobile Ads SDK'sı
- Android'de dağıtım yapmak için
- Android API düzeyi 21 veya üstü
- iOS'te dağıtım yapmak 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şlarken bölümüne bakın.
- Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu
1. adım: maio kullanıcı arayüzünde yapılandırmaları ayarlayın
Önce maio hesabınıza kaydolun veya giriş yapın. Sol kenar çubuğunda 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şli
Uygulamanızın adını girin, platformu seçin ve uygulama URL'nizi girin. Reklam Türü olarak Video geçiş reklamı'nı seçin ve ardından Güncelle'yi tıklayın.
Android
iOS
Ödül olarak verildi
Uygulamanızın adını girin, platformu seçin ve uygulama URL'nizi girin. 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. Sonraki bölümde AdMob reklam biriminizi ayarlamanız gerekir.
Android
iOS
Zone Management (Bölge Yönetimi) sayfasında Zone ID (Bölge Kimliği) değerini not edin. Sonraki bölümde reklam biriminizi AdMob oluşturmanız da gerekecektir.
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
maio için Changelog'daki indirme bağlantısından maio için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin ve GoogleMobileAdsMaioMediation.unitypackage
dosyasını ZIP dosyasından çıkarın.
Unity proje düzenleyicinizde Assets > Import Package > Custom
Package'ı (Öğeler > Paketi İçe Aktar > Özel) 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.
Sonra, Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici >
Zorla Çöz'ü seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android
dizinine kopyalar.
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ındaki talimatları uygulayın.
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 aşağıdaki sınıflarda ResponseInfo
kullanarak reklam yanıtında temel alınan hatayı kontrol edebilir:
Android
Biçim | Sınıf adı |
---|---|
Geçişli | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
Ödül olarak verildi | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
Biçim | Sınıf adı |
---|---|
Geçişli | GADMMaioInterstitialAdapter |
Ödül olarak verildi | GADMMaioRewardedAdapter |
Bir reklam yüklenemediğinde maio bağdaştırıcısı tarafından gönderilen kodlar ve beraberindeki mesajlar aşağıda verilmiştir:
Android
Hata kodu | Neden |
---|---|
0-10 | maio, SDK'ya özel bir hata döndürdü. Ayrıntılı bilgi için code'a ve maio'nun belgelerine göz atın. |
101 | Maio'nun kullanabileceği bir reklam yok. |
102 | Geçersiz sunucu parametreleri (ör. eksik Yerleşim Kimliği). |
103 | Bir reklamı yüklemek için kullanılan bağlam "Etkinlik" örneği değildi. |
iOS
Hata kodu | Neden |
---|---|
0-10 | maio, SDK'ya özel bir hata döndürdü. Daha fazla bilgi için maio'nun kodunu inceleyin. |
101 | maio'nun henüz bir reklamı yok. |
102 | Geçersiz sunucu parametreleri (ör. eksik Yerleşim Kimliği). |
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 Uyumlulaştırma Eklentisi Değişiklik Günlüğü
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 bağdaştırıcısının 2.1.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.0.2
- 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.
Sürüm 2.0.1
- maio Android bağdaştırıcısı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.
Sürüm 2.0.0
- maio Android bağdaştırıcısının 1.1.16.2 sürümünü destekler.
- maio iOS bağdaştırıcısının 2.1.1.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 8.6.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 1.4.3
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/Maio/
hedefine taşındı. - maio Android bağdaştırıcısının 1.1.16.2 sürümünü destekler.
- maio iOS bağdaştırıcısının 1.6.3.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 1.4.2
- maio Android bağdaştırıcısının 1.1.16.1 sürümünü destekler.
- maio iOS bağdaştırıcısı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 bağdaştırıcısının 1.6.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 1.4.0
- maio Android bağdaştırıcısı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 bağdaştırıcısı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 bağdaştırıcısının 1.5.6.1 sürümünü destekler.
Sürüm 1.3.4
- 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 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.3.1 sürümünü destekler.
Sürüm 1.3.2
- maio Android bağdaştırıcısının 1.1.11.0 sürümünü destekler.
- maio iOS bağdaştırıcısının 1.5.2.1 sürümünü destekler.
Sürüm 1.3.1
- maio Android bağdaştırıcısının 1.1.10.0 sürümünü destekler.
- maio iOS bağdaştırıcısının 1.5.1.0 sürümünü destekler.
Sürüm 1.3.0
- maio Android bağdaştırıcısının 1.1.10.0 sürümünü destekler.
- maio iOS bağdaştırıcısının 1.5.0.0 sürümünü destekler.
Sürüm 1.2.3
- Eklenti, yeni Ödüllü 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 bağdaştırıcısının 1.4.6.0 sürümünü destekler.
Sürüm 1.2.2
- maio Android bağdaştırıcısının 1.1.6.0 sürümünü destekler.
- maio iOS bağdaştırıcısı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 bağdaştırıcısı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 bağdaştırıcısı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 bağdaştırıcısının 1.3.2.0 sürümünü destekler.
Sürüm 1.1.1
- 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 bağdaştırıcısının 1.1.0.0 sürümünü destekler.
- maio iOS bağdaştırıcısının 1.3.0.0 sürümünü destekler.
Sürüm 1.0.2
- maio Android SDK'sının 1.0.8 sürümünü 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ının 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 çıkış tarihi!
- 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.