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

ironSource'u Uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını kapsayan arabuluculuk kullanarak ironSource Ads'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, ironSource Ads'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği, reklam kaynağı optimizasyonunun nasıl ayarlanacağı ve ironSource Ads SDK'sının ve bağdaştırıcının Android uygulamanıza nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

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

¹ Teklif entegrasyonu kapalı beta sürümündedir. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.

² Bu biçim yalnızca şelale entegrasyonunda desteklenir.

Ş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 üzere IronSource adaptörü 8.0.0.0 veya sonraki bir sürümü 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: ironSource Ads kullanıcı arayüzünde yapılandırmaları ayarlayın

ironSource Ads hesabınıza kaydolun ve oturum açın.

Uygulamanızı ironSource Ads kontrol paneline eklemek için Yeni Uygulama düğmesini tıklayın.

Uygulama ayrıntılarını girin

Canlı Uygulama'yı seçin, uygulamanızın Google Play URL'sini girin ve Uygulama Bilgilerini İçe Aktar'ı tıklayın.

Uygulamanız kullanımda değilse Uygulama Mağazasında Kullanımda Olmayan Uygulama'yı seçin ve uygulamanız için bir Geçici Ad girin. Platformunuzu seçin.

Formun geri kalanını doldurup Uygulama Ekle'yi tıklayın.

Uygulama eklendikten sonra gösterilen yeni uygulama anahtarınızı not edin. Ad Manager reklam birimi kimliğinizi ayarlamak için bu değere ihtiyacınız olacaktır. Uygulamanızın desteklediği reklam biçimlerini seçin. Ardından Devam'ı tıklayın.

Örnek oluştur

Ardından, eklediğiniz uygulama için bir ağ örneği yapılandırın.

Reklamlar > Kurulum > Örnekler'e gidin. Uygulamayı seçip Örnek Oluştur'u tıklayın.

Gerekli ayrıntıları girin ve Kaydet ve kapat'ı tıklayın.

Örnek oluşturulduktan sonra örnek kimliği Örnek Kimliği alanında listelenir.

Raporlama API'si anahtarınızı bulma

Ad Manager reklam birimi kimliğinizi ayarlamak için uygulama anahtarına ve örnek kimliğine ek olarak ironSource Ads gizli anahtarına ve yeniden yenileme jetonuna da ihtiyacınız vardır.

ironSource Ads yayıncı kontrol panelinizdeki Hesabım'a gidin ve API sekmesini tıklayın. Gizli Anahtar ve Yenileme Jetonu'nu not edin.

Test modunu etkinleştirme

ironSource Ads test reklamlarını etkinleştirmeyle ilgili olarak ironSource Ads'in Entegrasyon testi kılavuzundaki talimatları uygulayın.

2. Adım: Ad Manager kullanıcı arayüzünde ironSource reklam talebini ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

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

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın.

Getiri grubunuz için benzersiz bir ad girin, Durum'u Etkin olarak ayarlayın, Reklam biçimi'ni seçin ve Envanter türü'nü Mobil uygulama olarak ayarlayın. Hedefleme > Envanter bölümünde, Envanter ve Mobil uygulama altında uyumlulaştırmayı eklemek istediğiniz reklam birimini seçin.

Ardından Getiri iş ortağı ekle düğmesini tıklayın.

ironSource reklamları için zaten bir getiri iş ortağınız varsa bu iş ortağını seçebilirsiniz. Aksi takdirde Yeni bir gelir iş ortağı oluştur'u seçin.

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

Otomatik veri toplama'yı etkinleştirin ve önceki bölümde elde edilen Gizli Anahtar ile Yenileme Jetonu'nu girin.

Getiri iş ortağı seçildikten sonra 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ı ve örnek kimliğini girin. Ardından, bir Varsayılan BGBM değeri girin.

İşleminiz bittiğinde sayfanın alt kısmındaki Kaydet'i tıklayın.

ironSource Mobile'ı GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

Ad Manager kullanıcı arayüzünde ironSource Mobile'ı GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki adımları uygulayın.

3. Adım: ironSource Ads 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://android-sdk.is.com/")
    }
  }
}

Ardından, uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıkları ve yapılandırmaları ekleyin. ironSource Ads 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:ironsource:8.5.0.0")
}

Manuel Entegrasyon

ironSource Ads Android SDK'sının en son sürümünü indirip projenize ekleyin.
Google'ın Maven deposunda ironSource Ads bağdaştırıcısı yapılarına gidin. En son sürümü seçin, IronSource bağdaştırıcının .aar dosyasını indirin ve projenize ekleyin.

4. Adım: ironSource Ads 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.

ironSource Ads, 6.7.9 SDK sürümünde bir izin API'si ekledi. Aşağıdaki örnek kodda, bu izin bilgilerinin ironSource Ads SDK'sına nasıl iletileceği gösterilmektedir. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı üzerinden reklam istemeden önce yapmanız önerilir.

Java

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setConsent(true);

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setConsent(true)

Daha fazla bilgi ve yöntemde sağlanabilecek değerler için ironSource Ads'in Düzenleme Gelişmiş Ayarları dokümanlarına 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.

ironSource Ads, 6.14.0 SDK sürümünde CCPA yönetmeliklerini desteklemek için bir API ekledi. Aşağıdaki örnek kodda, bu izin bilgilerinin ironSource Ads SDK'sına nasıl iletileceği gösterilmektedir. Bu seçeneklerin ironSource Ads SDK'sına doğru şekilde yönlendirilmesini sağlamak için Google Mobile Ads SDK'sını ilk kez çalıştırmadan önce ayarlanması gerekir.

Java

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setMetaData("do_not_sell", "true");

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setMetaData("do_not_sell", "true")

Daha fazla bilgi ve yöntemde sağlanabilecek değerler için ironSource Ads'in Düzenleme Gelişmiş Ayarları ile ilgili dokümanlarına bakın.

5. adım: Gerekli kodu ekleyin

Uygulama yaşam döngüsü

İlgili ironSource Ads yöntemlerini aşağıdaki gibi çağırmak için etkinliklerinizin her birindeki onPause() ve onResume() yöntemlerini geçersiz kılın:

Java

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

Kotlin

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

Proguard Kuralları

Uygulamanızı küçültüyor, kodunu karartıyor ve optimize ediyorsanız ironSource Ads, projenizde ek ProGuard kuralları kullanılmasını gerektirir. Daha fazla bilgi için ironSource Ads'in Android SDK Entegrasyonu kılavuzunu inceleyin.

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

Test reklamlarını etkinleştirme

Ad Manager için test cihazınızı kaydettiğinizden ve ironSource Ads kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.

Test reklamlarını doğrulama

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

Hata kodları

Adaptör, ironSource Ads'den reklam alamıyorsa aşağıdaki sınıflar altında ResponseInfo.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

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

Hata kodu	Neden
101	Ad Manager kullanıcı arayüzünde yapılandırılan ironSource Ads sunucu parametreleri eksik/geçersiz.
102	ironSource Ads, SDK'sını başlatmak için bir etkinlik bağlamı gerektirir.
103	ironSource Ads, ironSource Ads örneği kimliği başına yalnızca 1 reklam yükleyebilir.
105	İstenen banner reklam boyutu ironSource Ads tarafından desteklenmiyor.
106	ironSource Ads SDK'sı başlatılmadı.
501-1056	ironSource Ads SDK Hataları. Daha fazla ayrıntı için dokümanları inceleyin.