Bu kılavuzda, şelale entegrasyonlarını ele alan uyumlulaştırma özelliğini kullanarak 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. Bu videoda, reklam biriminin uyumlulaştırma yapılandırmasına nasıl maio ekleneceği ve maio SDK ile bağdaştırıcısının bir Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.
Maio'nun kontrol paneli arayüzü, etiketleri, düğmeleri ve açıklamaları için Japonca metin kullanır ve bu kılavuzdaki ekran görüntüleri çevrilmemiştir. Ancak, buradaki açıklamalar ve talimatlarda, etiketlere ve düğmelere İngilizce karşılıklarıyla atıfta bulunulur. Ö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 ü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: 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 Ad Manager 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 Ad Manager oluşturmanız da gerekecektir.
Android
iOS
2. adım: Kullanıcı arayüzünde maio talebi Ad Manager kurun
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
3. Adım: Maio SDK'sını ve bağdaştırıcıyı 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 Öğeler > Paketi İçe Aktar > Özel
Paket'i 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.
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
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 dokümanlarındaki talimatları uygulayın.
5. Adım: Uygulamanızı test etme
Test reklamlarını etkinleştir
Ad Manager.
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 (Bidding) and 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ındaki temel 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 atılan kodlar ve eşlik eden mesajlar aşağıda verilmiştir:
Android
Hata kodu | Neden |
---|---|
0-10 | maio, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için kod ve maio belgelerine bakın. |
101 | Maio'nun kullanılabilir 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 özgü bir hata döndürdü. Daha fazla bilgi için maio'nun koduna bakın. |
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üklendi. |
maio Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sürüm 2.0.0
- maio Android adaptörü sürüm 1.1.16.2'yi destekler.
- maio iOS bağdaştırıcısı 2.1.1.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 1.4.3
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/Maio/
klasörüne taşındı. - maio Android adaptörü sürüm 1.1.16.2'yi destekler.
- maio iOS bağdaştırıcısı 1.6.3.1 sürümü desteklenir.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.1.0 ile geliştirilip test edilmiştir.
Sürüm 1.4.2
- maio Android adaptörü 1.1.16.1 sürümünü destekler.
- maio iOS bağdaştırıcısı 1.6.3.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.4.0 ile geliştirilip test edilmiştir.
Sürüm 1.4.1
- maio Android adaptörü 1.1.16.1 sürümünü destekler.
- maio iOS bağdaştırıcısı 1.6.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.1.0 ile geliştirilip test edilmiştir.
Sürüm 1.4.0
- maio Android adaptörü sürüm 1.1.16.0'ı destekler.
- maio iOS bağdaştırıcısı 1.6.0.1 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 1.3.6
- maio Android adaptörü sürüm 1.1.16.0'ı destekler.
- maio iOS bağdaştırıcısı 1.5.8.0 sürümünü destekler.
Sürüm 1.3.5
- maio Android adaptörü 1.1.15.0 sürümünü destekler.
- maio iOS bağdaştırıcısı 1.5.6.1 sürümünü destekler.
Sürüm 1.3.4
- maio Android adaptörü 1.1.11.1 sürümünü destekler.
- maio iOS bağdaştırıcısı 1.5.4.0 sürümünü destekler.
Sürüm 1.3.3
- maio Android adaptörü 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.
Sürüm 1.3.2
- maio Android adaptörü 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.
Sürüm 1.3.1
- maio Android adaptörü sürüm 1.1.10.0'ı destekler.
- maio iOS bağdaştırıcısı 1.5.1.0 sürümünü destekler.
Sürüm 1.3.0
- maio Android adaptörü sürüm 1.1.10.0'ı destekler.
- maio iOS bağdaştırıcısı 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 adaptörü 1.1.7.0 sürümünü destekler.
- maio iOS adaptörü 1.4.6.0 sürümünü destekler.
Sürüm 1.2.2
- Maio Android adaptörü 1.1.6.0 sürümünü destekler.
- maio iOS adaptörü 1.4.2.0 sürümünü destekler.
Sürüm 1.2.1
- Maio Android adaptörü 1.1.6.0 sürümünü destekler.
- maio iOS bağdaştırıcısı 1.4.1.0 sürümünü destekler.
Sürüm 1.2.0
- Maio Android adaptörü sürüm 1.1.4.1'i destekler.
- maio iOS adaptörü 1.4.0.0 sürümünü destekler.
Sürüm 1.1.3
- maio Android adaptörü 1.1.3.1 sürümünü destekler.
- maio iOS bağdaştırıcısı 1.3.2.0 sürümünü destekler.
Sürüm 1.1.2
- Maio Android adaptörü 1.1.3.0 sürümünü destekler.
- maio iOS bağdaştırıcısı 1.3.2.0 sürümünü destekler.
Sürüm 1.1.1
- Maio Android adaptörü sürüm 1.1.1.0'ı destekler.
- maio iOS adaptörü 1.3.1.1 sürümünü destekler.
Sürüm 1.1.0
- Maio Android adaptörü 1.1.0.0 sürümünü destekler.
- maio iOS adaptörü 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ı 1.2.19 sürümünü destekler.
Sürüm 1.0.1
- Maio Android SDK'sı 1.0.7 sürümünü destekler.
- maio iOS SDK'sı 1.2.19 sürümünü destekler.
Sürüm 1.0.0
- İlk sürüm!
- Maio Android SDK'sı 1.0.6 sürümünü destekler.
- maio iOS SDK'sı 1.2.18 sürümünü destekler.