Bu kılavuz, teklif entegrasyonlarını kapsayarak uyumlaştırma kullanarak Moloco'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağını açıklar. Bu açıklamalar, Moloco'nun bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve Moloco SDK'sının ve bağdaştırıcısının bir Unity uygulamasına nasıl entegre edileceğini kapsar.
Desteklenen entegrasyonlar ve reklam biçimleri
Moloco için Ad Manager uyumlaştırma adaptörünün özellikleri şöyledir:
| Entegrasyon | |
|---|---|
| Teklifli sistem | |
| Şelale | |
| Formatlar | |
| Uygulama Açma | |
| Banner | |
| Geçiş reklamı | |
| Ödüllü | |
| Ödüllü geçiş reklamı | |
Şartlar
- En son Google Mobile Ads SDK'sı
- Unity 5.6 veya daha yeni bir sürüm
- Moloco Unity eklentisi 1.2.0 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: Moloco kullanıcı arayüzünde yapılandırmaları ayarlayın
Moloco Yayıncı Portalı'na giriş yapın.
Genel Bakış > Uygulamalar sekmesine gidin ve yeni bir uygulama oluşturmak için Uygulama Ekle düğmesini tıklayın.
Uygulamanız için İşletim Sistemi ve Gizlilik Ayarları'nı seçin, formun geri kalanını doldurun ve Oluştur'u tıklayın.
Android
iOS
Uygulamanız oluşturulduktan sonra, ayrıntıları görüntülemek için Uygulamalar sekmesinden uygulamayı seçin ve Uygulama Anahtarı'nı not alın.
Android
iOS
Genel Bakış > Reklam Birimleri sekmesine gidin, açılır menüden uygulamayı seçin ve Yeni Reklam Birimi'ni tıklayın.
Açık artırma yöntemi olarak Uygulama içi teklif verme'yi seçin ve formun geri kalanını doldurun. Ardından Oluştur'u tıklayın.
Ayrıntılarını görüntülemek için Reklam Birimleri sekmesinde yeni oluşturduğunuz reklam birimine gidin. Reklam birimi kimliğini not edin.
2. adım: Ad Manager kullanıcı arayüzünde Moloco 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.
Moloco Ads'i GDPR ve ABD eyalet yönetmelikleri reklam iş ortakları listesine ekleme
Ad Manager kullanıcı arayüzünde Moloco Ads'i AB ve ABD eyalet yönetmelikleri reklam iş ortakları listesine eklemek için AB tüzükleri ayarları ve ABD eyalet yönetmelikleri ayarları bölümlerindeki adımları uygulayın.
3. adım: Moloco 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 dizininde aşağıdaki komutu çalıştırarak Google Mobile Ads Moloco Ads SDK Aracılık Eklentisi'ni Unity projenize yükleyebilirsiniz:
openupm add com.google.ads.mobile.mediation.molocoOpenUPM
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
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.
Google Mobile Ads Moloco Mediation paketini seçin ve Yükle'yi tıklayın.
Unity paketi
Değişiklik günlüğündeki indirme bağlantısından Moloco Ads SDK için Google Mobile Ads aracılık eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsMolocoMediation.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 GoogleMobileAdsMolocoMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.
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.
4. adım: Gerekli kodu ekleyin
Moloco entegrasyonu için ek kod gerekmez.
5. adım: Uygulamanızı test edin
Test reklamlarını etkinleştirme
Ad Manager için test cihazınızı kaydettiğinizden emin olun.
Test reklamlarını doğrulama
Moloco Ads SDK'sından test reklamları aldığınızı doğrulamak için Moloco (Teklifli Sistem) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
Hata kodları
Adaptör Moloco'dan reklam alamıyorsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
Bir reklam yüklenemediğinde Moloco bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:
Android
| Hata kodu | Alan adı | Neden |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Eksik veya geçersiz Moloco uygulama anahtarı. |
| 102 | com.google.ads.mediation.moloco | Eksik veya geçersiz Moloco reklam birimi kimliği. |
| 103 | com.google.ads.mediation.moloco | Döndürülen Moloco reklam nesnesi boştu. |
| -1 ila 5000 | com.moloco.sdk | Moloco SDK bir hata döndürdü. Daha fazla ayrıntı için Moloco'nun belgelerini inceleyin. |
iOS
| Hata kodu | Alan adı | Neden |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Moloco SDK, iOS 12 ve önceki sürümlerde reklam yayınlamayı desteklemez. |
| 102 | com.google.ads.mediation.moloco | Eksik veya geçersiz Moloco uygulama anahtarı. |
| 103 | com.google.ads.mediation.moloco | Eksik veya geçersiz Moloco reklam birimi kimliği. |
| 104 | com.google.ads.mediation.moloco | Reklam gösterilmeye hazır değil. |
| 105 | com.google.ads.mediation.moloco | Reklam gösterilemedi. |
| 106 | com.google.ads.mediation.moloco | Reklamın oluşturulması için oluşturma verileri kullanılamıyor. |
| -1 ila 5000 | Moloco SDK tarafından gönderildi | Moloco SDK bir hata döndürdü. Daha fazla ayrıntı için Moloco'nun belgelerini inceleyin. |
Ödüllü sunucu tarafı doğrulama
Sunucu tarafı doğrulama (SSV) geri çağırmalarını doğruluyorsanız Moloco'nun reklam kaynağı tanımlayıcısı 8267622065755668722 olur.
Moloco Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sürüm 1.6.1
- Moloco Android bağdaştırıcı sürümü 3.12.1.0'ı destekler.
- Moloco iOS bağdaştırıcısı 3.12.1.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 10.4.1 sürümüyle oluşturulup test edilmiştir.
Sürüm 1.6.0
- Moloco Android bağdaştırıcı sürümü 3.12.0.0'ı destekler.
- Moloco iOS bağdaştırıcısı 3.12.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 10.3.0 sürümüyle oluşturulup test edilmiştir.
Sürüm 1.5.0
- Moloco Android bağdaştırıcı sürümü 3.11.0.0'ı destekler.
- Moloco iOS bağdaştırıcısı 3.11.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 10.3.0 sürümüyle oluşturulup test edilmiştir.
Sürüm 1.4.0
- Moloco Android bağdaştırıcı sürümü 3.10.0.0 desteklenir.
- Moloco iOS bağdaştırıcısı 3.10.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 10.2.0 sürümüyle oluşturulmuş ve test edilmiştir.
Sürüm 1.3.1
- Moloco Android bağdaştırıcı sürümü 3.9.0.0'ı destekler.
- Moloco iOS bağdaştırıcısı 3.9.1.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisinin 10.1.0 sürümüyle oluşturulmuş ve test edilmiştir.
Sürüm 1.3.0
- Moloco Android bağdaştırıcı sürümü 3.9.0.0'ı destekler.
- Moloco iOS bağdaştırıcısı 3.9.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisinin 10.1.0 sürümüyle oluşturulmuş ve test edilmiştir.
Sürüm 1.2.1
- Moloco Android bağdaştırıcı sürümü 3.8.0.1'i destekler.
- Moloco iOS adaptörünün 3.8.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisinin 10.0.0 sürümüyle oluşturulmuş ve test edilmiştir.
Sürüm 1.2.0
- Moloco Android bağdaştırıcı sürümü 3.8.0.0'ı destekler.
- Moloco iOS adaptörünün 3.8.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisinin 10.0.0 sürümüyle oluşturulmuş ve test edilmiştir.
Sürüm 1.1.0
- Moloco Android adaptör sürümü 3.7.2.0'ı destekler.
- Moloco iOS adaptör sürümü 3.7.2.0'ı destekler.
- Google Mobile Ads Unity eklentisinin 10.0.0 sürümüyle oluşturulmuş ve test edilmiştir.
Sürüm 1.0.0
- İlk sürüm!
- Moloco Android adaptör sürümü 3.7.0.0'ı destekler.
- Moloco iOS adaptörünün 3.6.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisinin 9.6.0 sürümüyle oluşturulup test edilmiştir.