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

Mintegral'ı teklifli sistemle entegre etme (Beta)

Bu kılavuzda, uyumlulaştırma ile Mintegral'dan reklam yüklemek ve görüntülü reklam yüklemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Mintegral'ın bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Mintegral SDK ile bağdaştırıcının birAndroid uygulamaya nasıl entegre edileceği konuları ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

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

¹ Teklif entegrasyonu kapalı beta sürümündedir.

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

Koşullar

Android API düzeyi 21 veya üstü

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu

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ı Bulun

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

Yeni bir uygulama ekle

APP Ayarı sekmesinden UYGULAMA ekle düğmesini tıklayın.

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

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

Reklam yerleşimi oluşturma

Uygulamanız oluşturulduktan sonra Yerleşimler ve Birimler sekmesine gidin ve aşağıda gösterilen Yerleşim Ekle düğmesini tıklayarak reklam yerleşiminizi oluşturun.

Bir Yerleşim Adı ve Reklam Biçimi girin.

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

Reklam yerleşiminiz oluşturulduktan sonra, Yerleşim Kimliğini not edin.

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

Mintegral Reporting API Anahtarınızı Bulma

Teklif

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

Şelale

Ad Manager Reklam birimi kimliğinizi oluşturmak için Mintegral Reporting API Anahtarınıza ihtiyacınız olacak. Account (Hesap) > API Tools'a (API Araçları) gidin. Skey ve Secret'ı not edin.

2. Adım: Kullanıcı arayüzünde Mintegral talebini Ad Manager ayarlayın

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

Şirketlere Mintegral Ekle

Teklif

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

Şelale

Yönetici > Şirketler'e gidin ve ardından Tüm şirketler sekmesinde 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 girmenize gerek yoktur. İşlem tamamlandığında Kaydet'i tıklayın.

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

Teklif

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

Şelale

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

Teklifli sistemi Mintegral yapılandırın

Teklif

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

Teklif veren olarak Mintegral simgesini 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 açık duruma getirin. Ardından Devam'ı tıklayın.

Devam'ı tıklayın.

Done'ı (Bitti) tıklayın.

Şelale

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

Reklam birimi eşlemesini yapılandır

Teklif

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Verme sekmesi altındaMintegral şirketini seçin.

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

Belirli reklam birimi'ni seçin. Bir reklam birimi ve biçim seçin, Envanter türü olarak Mobil uygulamayı ve Mobil uygulamanızı seçin. Ardından, bir önceki bölümde aldığınızApp Key, App ID, Placement ID, and Ad Unit ID kodunu 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 şirket için oluşturduğunuzu seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin.

Önceki bölümde belirtilen App Key, App ID, Placement ID, and Ad Unit ID değerini ve Varsayılan BGBM değerini girin. Kaydet'i tıklayın.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Mintegral ekleyin

GDPR ayarları ve ABD eyalet yönetmelikleri ayarları bölümündeki adımları uygulayarak Ad Manager kullanıcı arayüzünde GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Mintegral ekleyin.

3. Adım: Mintegral SDK'sını ve bağdaştırıcıyı içe aktarın

Android Studio entegrasyonu (önerilir)

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ını ve yapılandırmalarını ekleyin. Mintegral SDK ve bağdaştırıcının en yeni sürümlerini kullanın:

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

Manuel entegrasyon

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

4. adım: Gizlilik ayarlarını Mintegral SDK'da uygulayın

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcıların ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara belirli açıklamaların yapıldığından ve bu kullanıcılardan alınan izinlerin alındığından emin olmanız gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken uyumlulaştırma zincirinizde kişisel verileri toplayabilecek, alabilecek veya kullanabilecek tüm reklam ağlarını tanımlamalı ve her ağın kullanımı hakkında bilgi sağlamalısınız. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

Mintegral SDK, kullanıcı rızası bilgilerini Mintegral SDK'ya iletmek için setConsentStatus yöntemini içerir.

Aşağıdaki örnek kodda, izin bilgilerinin Mintegral SDK'sına nasıl aktarılacağı gösterilmektedir. Bu seçeneklerin Mintegral SDK'ya düzgün bir şekilde yönlendirilmelerini sağlamak için Google Mobile Ads SDK'sını başlatmadan önce bu seçeneklerin 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'ın gizlilik belgelerine bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerinin" "satılmasını" (yasaların bu terimlerin tanımladığı şekilde) devre dışı bırakma seçeneği sunmasını gerektirir. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına 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 tüm reklam ağlarına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına katılabilecek her bir reklam ağını belirlemeli ve uygunluğu sağlamak için bu ağların her birinin talimatlarını takip etmelisiniz.

Mintegral SDK'da, izin bilgilerini Mintegral SDK'ya iletmek için setDoNotTrackStatus yöntemi bulunur.

Aşağıdaki örnek kodda, izin bilgilerinin Mintegral SDK'sına nasıl aktarılacağı gösterilmektedir. Bu yöntemi çağırmanız gerekiyorsa sonrasında Google Mobile Ads SDK'sını başlatmadan ve Google Mobile Ads SDK'sı üzerinden reklam isteğinde bulunmadan ö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'ın 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ştir

Ad Manager.

Mintegral; banner'lar, geçiş reklamları, ödüllü ve yerel reklam biçimlerinde Mintegral test reklamları almak için Mintegral Test Kimliği sayfasında verilen Uygulama Anahtarları, Uygulama Kimlikleri, Yerleşim Kimlikleri ve Reklam Birimi Kimliklerini kullanmanızı önerir.

Test reklamlarını doğrulama

Mintegralreklam kaynağından test reklamları aldığınızı doğrulamak için Mintegral (Bidding) and Mintegral (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

CCPA reklam iş ortakları listesine Mintegral'ı ekleyin

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

Yerel reklamlar

Reklam oluşturma

Mintegral bağdaştırıcısı, yerel reklamlarını NativeAd nesneleri olarak döndürür. Aşağıdaki alanları ( NativeAd) doldurur.

Alan	Öğeler her zaman Mintegral adaptörü tarafından dahil edilir
Başlık
Resim	1
Metin
Simge
Harekete geçirici mesaj
Yıldız puanı
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 öğesini bir video veya resimle doldurur.

Hata kodları

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

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

Bir reklam yüklenemediğinde Mintegral bağdaştırıcısı tarafından gönderilen kodlar ve beraberindeki mesajlar şunlardır:

Hata kodu	Alan	Neden
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	Eksik veya geçersiz teklif yanıtı.
104	com.google.ads.mediation.mintegral	Mintegral SDK'sı, dolgu yok hatası döndürdü.
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ı, dolgu yok 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 bir banner boyutuyla eşleşmiyor.