Bu sayfa, Cloud Translation API ile çevrilmiştir.

Mintegral'i teklifli sistemle entegre etme (Beta)

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. Bu makalede, Mintegral'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Mintegral SDK'sının ve bağdaştırıcının bir Android uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Mintegral için uyumlulaştırıcı bağdaştırıcının özellikleri şunlardır:

Entegrasyon
Teklif verme	¹
Şelale	²
Formatlar
Uygulama Açma
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
Yerel biçim

¹ Teklif entegrasyonu kapalı beta sürümündedir (açık beta sürümündeki yerel reklam biçimi hariç).

² Şelale entegrasyonu kapalı beta sürümündedir.

Şartlar

Android API düzeyi 21 veya sonraki sürümler
[Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek amacıyla 16.5.91.1 veya daha yeni bir Mintegral bağdaştırıcısı kullanın (en son sürüm önerilir).

En son Google Mobile Ads SDK'sı
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.

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

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.

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.

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

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

Ad Manager hesabınızda oturum açın.

Şirketlere Mintegral'ı ekleme

Teklif verme

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

Şelale

Yönetici > Şirketler'e gidin ve ardından Tüm şirketler sekmesindeki Yeni şirket düğmesini tıklayın. Reklam ağı'nı seçin.

Reklam ağı olarak Mintegral'i seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin.

Kullanıcı adı veya Şifre girmeniz gerekmez. İşlemi tamamladığınızda Kaydet'i tıklayın.

Güvenli sinyal paylaşımını etkinleştirme

Teklif verme

Yönetici > Genel ayarlar'a gidin. Ad Exchange hesap ayarları sekmesine gidin, Güvenli sinyal paylaşımı'nı inceleyip etkinleştirin. Kaydet'i tıklayın.

Şelale

Bu adım, şelale entegrasyonları için gerekli değildir.

Mintegral teklifli sistemini yapılandırma

Teklif verme

Yayınlama > Teklif verenler'e gidin ve SDK Teklif Sistemi sekmesinin altında Yeni teklif veren'i tıklayın.

Teklif veren olarak Mintegral'i seçin.

Bu teklif verenin sinyal kitaplığını izin verilen sinyaller listesine ekle ve Sinyallerin bu teklif verenle paylaşılmasına izin ver seçeneklerini etkinleştirin. Ardından Devam'ı tıklayın.

Devam'ı tıklayın.

Bitti'yi tıklayın.

Şelale

Bu adım, şelale entegrasyonları için gerekli değildir.

Reklam birimi eşlemesini yapılandırma

Teklif verme

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi sekmesinin altında Mintegral'i seçin.

Reklam birimi eşleme sekmesine gidip Yeni reklam birimi eşleme'yi tıklayın.

Belirli bir reklam birimi'ni seçin. Bir reklam birimi ve biçimi, Envanter türü olarak Mobil uygulama'yı ve Mobil uygulamanızı seçin. Ardından, önceki bölümde elde edilen uygulama anahtarını, uygulama kimliğini, yerleşim kimliğini ve reklam birimi kimliğini girin. Son olarak Kaydet'i tıklayın.

Şelale

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın. Mobil uygulamanızı seçin.

Aşağı kaydırın ve Getiri iş ortağı ekle'yi tıklayın.

Önceki bölümde Mintegral için oluşturduğunuz şirketi seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak Android'i ve Durum olarak Etkin'i seçin.

Önceki bölümde elde edilen uygulama anahtarını, uygulama kimliğini, yerleşim kimliğini, reklam birimi kimliğini ve varsayılan BGBM değerini girin. Kaydet'i tıklayın.

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

Mobvista/Mintegral'ı Ad Manager kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için GDPR 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

Android Studio entegrasyonu (önerilen)

Proje düzeyindeki settings.gradle.kts dosyanıza aşağıdaki depoları ekleyin:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
  }
}

Ardından, uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıkları ve yapılandırmaları ekleyin. Mintegral SDK'sının ve bağdaştırıcının en son sürümlerini kullanın:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:mintegral:16.8.61.0")
}

Manuel entegrasyon

Mintegral SDK'sını dahil etmek için Android için Mintegral SDK'sı başlıklı makaleyi inceleyin.
Google'ın Maven deposunda Mintegral bağdaştırıcısı yapılarına gidin. En son sürümü seçin, Mintegral bağdaştırıcının .aar dosyasını indirin ve projenize ekleyin.

4. Adım: Mintegral SDK'sında gizlilik ayarlarını uygulayın

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.

Mintegral SDK'sı, izin bilgilerini Mintegral SDK'sına iletmek için setConsentStatus yöntemini içerir.

Aşağıdaki örnek kodda, izin bilgilerinin Mintegral SDK'sına nasıl iletileceği gösterilmektedir. Bu seçeneklerin Mintegral SDK'sına doğru şekilde yönlendirilmesini sağlamak için Google Mobile Ads SDK'sını başlatmadan önce ayarlanması gerekir.

Java

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

Kotlin

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)

Daha fazla bilgi için Mintegral'in gizlilik belgelerine bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları, kullanıcılara "kişisel bilgilerinin" "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma hakkı sunmayı zorunlu kılar. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. ABD eyalet gizlilik yasaları uygunluk kılavuzu, Google reklam sunumu için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar ancak Google bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Mintegral SDK'sı, izin bilgilerini Mintegral SDK'sına iletmek için setDoNotTrackStatus yöntemini içerir.

Aşağıdaki örnek kodda, izin bilgilerinin Mintegral SDK'sına nasıl iletileceği gösterilmektedir. Bu yöntemi çağırmanız gerekirse Google Mobile Ads SDK'sını ilk kullanıma hazırladıktan ancak Google Mobile Ads SDK'sı üzerinden reklam istemeden önce çağırın.

Java

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

Kotlin

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)

Daha fazla bilgi için Mintegral'in gizlilik belgelerine bakın.

5. adım: Gerekli kodu ekleyin

Mintegral entegrasyonu için ek kod gerekmez.

6. 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.

İsteğe bağlı adımlar

Mintegral'i CCPA reklam iş ortakları listesine ekleme

Ad Manager kullanıcı arayüzündeki CCPA reklam iş ortakları listesine Mintegral'ı eklemek için CCPA ayarlarındaki adımları uygulayın.

Yerel reklamlar

Reklam oluşturma

Mintegral bağdaştırıcısı, yerel reklamlarını NativeAd nesneler olarak döndürür. NativeAd için aşağıdaki alanlar doldurulur.

Alan	Mintegral adaptörü tarafından her zaman dahil edilen öğeler
Başlık
Resim	1
Metin
Simge
Harekete geçirici mesaj
Yıldızlı değerlendirme
Depolama
Fiyat
Reklamveren

¹ Mintegral bağdaştırıcısı, yerel reklamları için ana resim öğesine doğrudan erişim sağlamaz. Bunun yerine, adaptör MediaView alanına bir video veya resim doldurur.

Hata kodları

Bağdaştırıcının Mintegral'den reklam almaması durumunda, aşağıdaki sınıflar altında ResponseInfo.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

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

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:

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.

Mintegral Android Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü