Mintegral'ı uyumlulaştırma ile entegre etme

Bu kılavuzda, hem şelale hem de teklif entegrasyonlarını kapsayan arabuluculuk kullanarak Mintegral'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Mintegral'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve Mintegral SDK'sının ve bağdaştırıcının bir Unity uygulamasına nasıl entegre edileceğini kapsar.

Desteklenen entegrasyonlar ve reklam biçimleri

Mintegral için Ad Manager uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif verme  1
Şelale  2
Formatlar
Uygulama Açma
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
1 Teklif entegrasyonu kapalı beta sürümündedir (açık beta sürümündeki yerel reklam biçimi hariç).

2 Şelale entegrasyonu açık beta sürümündedir.

Şartlar

  • En son Google Mobile Ads SDK'sı
    • Unity 5.6 veya sonraki sürümler
    • [Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek üzere Mintegral 1.4.0 veya daha yeni bir sürüm için Google Mobile Ads uyumlulaştırma eklentisini kullanın (en son sürüm önerilir)
    • Android'de dağıtmak için
      • Android API düzeyi 21 veya sonraki sürümler
    • 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.
    • Uyumlulaştırmayı tamamlama Başlangıç kılavuzu

1. adım: Mintegral kullanıcı arayüzünde yapılandırmaları ayarlayın

Mintegral hesabınıza kaydolun veya oturum açın.

Uygulama anahtarını bulma

UYGULAMA Ayarı sekmesine gidin ve UYGULAMA Anahtarı'nı not edin.

Yeni uygulama ekleme

UYGULAMA Ayarı sekmesinde UYGULAMA Ekle düğmesini tıklayın.

Platform'u seçin ve formun geri kalanını doldurun. Ardından Kaydet'i tıklayın.

Android

iOS

Uygulamanızın UYGULAMASINI KİMLİĞİNİ not edin.

Android

iOS

Reklam yerleşimi oluşturma

Uygulamanız oluşturulduktan sonra, reklam yerleşiminizi oluşturmak için Yerleşimler ve Birimler sekmesine gidin ve aşağıda gösterildiği gibi Yerleşim Ekle düğmesini tıklayın.

Android

iOS

Bir yerleşim adı ve reklam biçimi girin.

Teklifli Sistem Türü olarak Başlıktan Teklif Alma'yı seçin. Formun geri kalanını doldurup Kaydet'i tıklayın.

Reklam yerleşiminiz oluşturulduktan sonra yerleşim kimliğini not edin.

Android

iOS

1 Reklam Birimi açılır menüsünü tıklayın ve Reklam Birimi Kimliği'ni not edin.

Android

iOS

Mintegral Reporting API anahtarınızı bulma

Teklif verme

Bu adım, teklifli sistem entegrasyonları için gerekli değildir.

Şelale

Ad Manager reklam birimi kimliğinizi ayarlamak için Mintegral Reporting API anahtarınız gerekir. Hesap > API Araçları'na gidin. Skey ve Secret değerlerini not edin.

2. Adım: Ad Manager kullanıcı arayüzünde Mintegral 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ılavuzunun 2. adımına bakın.

Mobvista/Mintegral'ı GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

Mobvista/Mintegral'ı Ad Manager kullanıcı arayüzündeki Avrupa ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için Avrupa düzenlemeleri ayarlarında ve ABD eyalet düzenlemeleri ayarlarında yer alan adımları uygulayın.

3. Adım: Mintegral 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 Mintegral Uyumlulaştırma Eklentisi'ni projenize yükleyebilirsiniz:

openupm add com.google.ads.mobile.mediation.mintegral

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

OpenUPM Ayrıntıları

Ardından, Unity Paket Yöneticisi'ni açmak için pencere > Paket Yöneticisi'ne gidin ve açılır menüden Kayıt Dairelerim'i seçin.

Unity Kayıt Daireleri

Google Mobil Reklamlar Mintegral Uyumlulaştırma paketini seçin ve Yükle'yi tıklayın.

OpenUPM'den yükleme

Unity Paketi

Değişiklikler Günlüğü'ndeki indirme bağlantısından Mintegral için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsMintegralMediation.unitypackage dosyasını çıkarın.

Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsMintegralMediation.unitypackage dosyayı bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Unity'den içe aktarma

Ardından Öğeler > Harici Bağımlılık Yöneticisi > Android Çözümleyici > Çözümü Zorla'yı seçin. Harici Bağımlılık Yöneticisi 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ümü Zorla Uygula

4. adım: Gerekli kodu ekleyin

Android

Mintegral entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Mintegral'in belgelerini inceleyin.

5. Adım: Uygulamanızı test edin

Test reklamlarını etkinleştirme

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

Banner, geçiş reklamı, ödüllü ve yerel reklam biçimleri için Mintegral test reklamları almak amacıyla Mintegral, Mintegral Test Kimliği sayfasında sağlanan uygulama anahtarlarını, uygulama kimliklerini, yerleşim kimliklerini ve reklam birimi kimliklerini kullanmanızı önerir.

Test reklamlarını doğrulama

Mintegral'den test reklamları aldığınızı doğrulamak için Mintegral (Teklif Verme) ve Mintegral (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

Hata kodları

Adaptör Mintegral'den reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

iOS

GADMediationAdapterMintegral

Bir reklam yüklenemezse Mintegral bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

Android

Hata kodu Alan Neden
101 com.google.ads.mediation.mintegral Geçersiz sunucu parametreleri (ör. uygulama kimliği veya yerleşim kimliği eksik).
102 com.google.ads.mediation.mintegral İstenen reklam boyutu, Mintegral tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103 com.google.ads.mediation.mintegral Teklif yanıtı eksik veya geçersiz.
104 com.google.ads.mediation.mintegral Mintegral SDK'sı doldurma yok hatası döndürmüştür.

iOS

Hata kodu Alan Neden
101 com.google.mediation.mintegral Geçersiz sunucu parametreleri (ör. uygulama kimliği veya yerleşim kimliği eksik).
102 com.google.mediation.mintegral Mintegral SDK'sı doldurma yok hatası döndürmüştür.
103 com.google.mediation.mintegral Mintegral SDK'sı reklam gösteremedi.
104 com.google.mediation.mintegral İstenen reklam boyutu, Mintegral tarafından desteklenen bir banner boyutuyla eşleşmiyor.

Mintegral Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

1.8.3 sürümü

1.8.2 sürümü

1.8.1 sürümü

1.8.0 sürümü

Sürüm 1.7.0

1.6.5 sürümü

1.6.4 sürümü

1.6.3 sürümü

1.6.2 sürümü

Sürüm 1.6.1

Sürüm 1.6.0

1.5.0 sürümü

Sürüm 1.4.0

Sürüm 1.3.0

Sürüm 1.2.1

1.2.0 sürümü

Sürüm 1.1.0

Sürüm 1.0.0