Mintegral'ı uyumlulaştırma ile entegre etme

Platform seçin: Android iOS Unity Flutter Android (Eski)

Bu kılavuzda, hem şelale hem de teklifli sistem entegrasyonlarını kapsayan uyumlulaştırma kullanarak Mintegral'den reklam yüklemek ve göstermek için Google Mobile Ads Unity Plugin ürününün nasıl kullanılacağı gösterilmektedir. Bu açıklamalar, 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ısı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ının özellikleri şöyledir:

Entegrasyon
Teklif verme  1
Şelale
Formatlar
Uygulama Açma
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
Yerel biçim
1 Teklifli sistem entegrasyonu açık beta sürümündedir.

Ön koşullar

Devam etmeden önce aşağıdakileri doğrulayın:

  • En yeni Google Mobile Ads Unity Plugin sürümü.
  • Unity Editor 5.6 veya sonraki sürümler
  • [Teklifli sistem için]: Teklifli sistemde desteklenen tüm reklam biçimlerini entegre etmek için Mintegral 1.4.0 veya sonraki sürümlerine yönelik Google Mobile Ads uyumlulaştırma eklentisini kullanın (en yeni sürüm önerilir).
  • Android'de dağıtmak için
    • Android API düzeyi 24 veya sonraki sürümler.
  • iOS'te dağıtmak için
    • iOS 13.0 veya sonraki sürümlerin dağıtım hedefi
  • Google Mobile Ads Unity Plugin ile yapılandırılmış çalışan bir Unity projesi. Ayrıntılar için Google Mobile Ads Unity Plugin hizmetini kurma başlıklı makaleyi inceleyin.
  • Uyumlulaştırmayı ayarlayın.

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

    Mintegral hesabınıza kaydolun veya giriş yapın.

    Uygulama anahtarını bulma

    APP Setting (UYGULAMA Ayarı) sekmesine gidin ve APP Key'i (UYGULAMA Anahtarı) not edin.

    Yeni uygulama ekleme

    APP Setting (Uygulama Ayarı) sekmesinde Add APP (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 UYGULAMA KİMLİĞİNİ not edin.

    Android

    iOS

    Reklam yerleşimi oluşturma

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

    Android

    iOS

    Yerleşim adı ve Reklam biçimi girin.

    Teklif Türü olarak Başlıktan Teklif Alma (Header Bidding)'yı seçin. Formun geri kalanını doldurun ve Kaydet'i tıklayın.

    Reklam yerleşiminiz oluşturulduktan sonra Yerleşim Kimliği'ni not edin.

    Android

    iOS

    1 AD Units (1 Reklam Birimi) açılır menüsünü tıklayın ve AD Unit ID'yi (Reklam Birimi Kimliği) not edin.

    Android

    iOS

    Mintegral Reporting API anahtarınızı bulun

    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 (Gizli anahtar) değerlerinizi not edin.

    app-ads.txt dosyanızı güncelleme

    Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt dosyası uygulamanız gerekir. Henüz yapmadıysanız Ad Manager için bir app-ads.txt dosyası oluşturun.

    Mintegral için app-ads.txt dosyasını uygulamak istiyorsanız App-ads.txt Reklam Sahtekarlığıyla Mücadeleye Nasıl Yardımcı Olabilir? başlıklı makaleyi inceleyin.

    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ılavuzundaki 2. adıma bakın.

    Mobvista/Mintegral'ı GDPR ve ABD eyalet tüzükleri reklam iş ortakları listesine ekleyin

    Ad Manager kullanıcı arayüzünde Mobvista/Mintegral'i AB ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için AB tüzükleri ayarları ve ABD eyalet düzenlemeleri ayarları bölümlerindeki 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 aşağıdaki komutu projenizin kök dizininden çalıştırarak Google Mobile Ads Mintegral Mediation Plugin for Unity'yi projenize yükleyebilirsiniz:

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

    OpenUPM

    Unity proje düzenleyicinizde Edit (Düzenle) > Project Settings (Proje Ayarları) > Package Manager'ı (Paket Yöneticisi) seçerek Unity Package Manager Settings'i (Unity Paket Yöneticisi Ayarları) 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

    OpenUPM Ayrıntıları

    Ardından, Window > Package Manager'a giderek Unity Package Manager'ı açın ve açılır menüden My Registries'i seçin.

    Unity Kayıtları

    Google Mobile Ads Mintegral Mediation paketini seçip Yükle'yi tıklayın.

    OpenUPM'den yükleme

    Unity Paketi

    Mintegral için Google Mobil Reklamlar Uyumlulaştırma Eklentisi'nin en yeni sürümünü Değişiklik günlüğü'ndeki indirme bağlantısından indirin ve GoogleMobileAdsMintegralMediation.unitypackage dosyasını zip dosyasından çıkarın.

    Unity proje düzenleyicinizde Assets > Import Package > Custom Package'ı seçin ve indirdiğiniz GoogleMobileAdsMintegralMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

    Unity'den içe aktarma

    Ardından Assets (Öğeler) > External Dependency Manager (Harici Bağımlılık Yöneticisi) > Android Resolver (Android Çözümleyici) > Force Resolve'u (Zorla Çözümle) seçin. External Dependency Manager kitaplığı, bağımlılık çözümlemeyi sıfırdan gerçekleştirir ve tanımlanan bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

    Çözüme Zorla

    4. adım: Mintegral SDK'sındaki gizlilik ayarlarını uygulayın

    Google AB Kullanıcı Rızası Politikası'na uymak için Avrupa Ekonomik Alanı (AEA), Birleşik Krallık ve İsviçre'deki kullanıcılarınıza belirli açıklamalar yapmanız ve yasal olarak gerekli olduğu durumlarda çerez veya başka yerel depolama bilgilerinin kullanılmasının yanı sıra, kişisel verilerin reklam kişiselleştirme amacıyla toplanması, paylaşılması ve kullanılması için kullanıcıların iznini almanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. Uyumlulaştırma zincirinizdeki her reklam kaynağına rıza bilgisinin iletildiğini doğrulamak sizin sorumluluğunuzdadır.

    Mintegral Unity bağdaştırıcısı 2.2.3 sürümü ve sonraki sürümler, IAB'nin Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) ile entegre olan Kullanıcı Rızası Yönetim Platformlarından GDPR izin sinyallerinin Mintegral SDK'sına iletilmesini destekler. Daha fazla bilgi için Mintegral'in Android ve iOS SDK Gizlilik Uygunluk Beyanı belgelerini inceleyin.

    5. 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'ın dokümanlarını inceleyin.

    6. adım: Uygulamanızı test edin

    Test reklamlarını etkinleştirme

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

    Mintegral, banner, geçiş, ödüllü ve doğal reklam biçimleri için Mintegral test reklamları almak üzere 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 (Teklifli Sistem) ve Mintegral (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

    Hata kodları

    Adaptör Mintegral'den reklam alamıyorsa aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

    Android

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

    iOS

    GADMediationAdapterMintegral

    Bir reklam yüklenemediğinde Mintegral bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

    Android

    Hata kodu Alan adı Neden
    100 com.mbridge.msdk Mintegral SDK'sı bir hata geri çağırma işlevi döndürdü.
    101 com.google.ads.mediation.mintegral Geçersiz sunucu parametreleri (ör. eksik uygulama kimliği veya yerleşim kimliği).
    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ı, boş alan hatası döndürdü.
    105 com.mbridge.msdk Mintegral SDK'sı başlatılamadı.
    106 com.google.ads.mediation.mintegral Mintegral alanı için bir reklam zaten yüklendi ve henüz gösterilmedi.

    iOS

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

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

    2.2.6 sürümü

    2.2.5 sürümü

    Sürüm 2.2.4

    2.2.3 sürümü

    2.2.2 sürümü

    2.2.1 sürümü

    Sürüm 2.2.0

    Sürüm 2.1.0

    Sürüm 2.0.6

    2.0.5 sürümü

    Sürüm 2.0.4

    2.0.3 sürümü

    Sürüm 2.0.2

    Sürüm 2.0.1

    Sürüm 2.0.0

    Sürüm 1.9.8

    Sürüm 1.9.7

    Sürüm 1.9.6

    Sürüm 1.9.5

    Sürüm 1.9.4

    Sürüm 1.9.3

    Sürüm 1.9.2

    Sürüm 1.9.1

    Sürüm 1.9.0

    Sürüm 1.8.4

    Sürüm 1.8.3

    Sürüm 1.8.2

    Sürüm 1.8.1

    Sürüm 1.8.0

    Sürüm 1.7.0

    Sürüm 1.6.5

    Sürüm 1.6.4

    Sürüm 1.6.3

    Sürüm 1.6.2

    Sürüm 1.6.1

    Sürüm 1.6.0

    Sürüm 1.5.0

    Sürüm 1.4.0

    Sürüm 1.3.0

    Sürüm 1.2.1

    Sürüm 1.2.0

    Sürüm 1.1.0

    Sürüm 1.0.0