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

ironSource'u Uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını ele alan uyumlulaştırma özelliğini kullanarak ironSource'taki reklamları yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, reklam biriminin uyumlulaştırma yapılandırmasına ironSource'un nasıl ekleneceği, reklam kaynağı optimizasyonunun nasıl ayarlanacağı ve ironSource SDK ile bağdaştırıcısının uygulamanıza nasıl entegre edileceğiAndroid ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Entegrasyon
Teklif
Şelale
Formatlar
Banner
Geçişli
Ödül olarak verildi
Ödüllü Geçiş Reklamı
Yerel biçim

Koşullar

Android API düzeyi 19 veya üstü

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

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

ironSource hesabınızda kaydolun ve oturum açın.

Uygulamanızı ironSource kontrol paneline eklemek için New App (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ılamıyorsa Uygulama Mağazası'nda Yayınlanmayan Uygulama'yı seçin ve uygulamanız için bir Geçici Ad girin. Platformunuzu seçin.

Formun geri kalanını doldurun ve Add App'i (Uygulama Ekle) tıklayın.

Uygulama eklendikten sonra görüntülenen yeni UYGULAMA ANAHTARI'nı not edin.Ad Manager reklam birimi kimliğinizi ayarlamak için bu değere ihtiyacınız olacak. Uygulamanızın desteklediği reklam biçimlerini seçin. Ardından Devam et'i tıklayın.

Örnek oluştur

Ardından, eklediğiniz uygulama için bir ağ örneği yapılandırın. ironSource, ödüllü reklamlar ve geçiş reklamları için birden fazla ağ örneğini destekler.

Reklamlar > Kurulum > Örnekler'e gidin. Uygulamayı seçin ve Ö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.

Reklam birimi kimliğinizi oluşturmak için UYGULAMA ANAHTARI ve Örnek Kimliği'ne ek olarakAd Manager ironSource Gizli Anahtar ve Yenileme Jetonunuza da ihtiyacınız olacaktır.

ironSource yayıncı kontrol panelinizde Hesabım'a gidin ve ardından API sekmesini tıklayın. Gizli Anahtarınızı ve Yenileme Jetonunu not edin.

Test modunu aç

ironSource test reklamlarının nasıl etkinleştirileceğiyle ilgili olarak ironSource'un Entegrasyon testi kılavuzundaki talimatları uygulayın.

2. Adım: Kullanıcı arayüzünde ironSource talebi Ad Manager 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ünün altında Envanter ve Mobil uygulama altında uyumlulaştırma eklemek istediğiniz reklam birimini seçin.

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

ironSourceiçin zaten bir Getiri iş ortağınız varsa bunu seçebilirsiniz. Aksi takdirde, Yeni bir getiri iş ortağı oluştur'u seçin.

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

Otomatik veri toplama'yı açın ve önceki bölümde belirtilen Secret Key and Refresh Token değerini girin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK Uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin. Bir önceki bölümde verilenApp Key and Instance ID kodunu girin. Ardından, Varsayılan BGBM değerini girin.

olduğu gibi, hedeflenen uygulamayla ilişkilendirilmelidir.

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

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

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 ironSource Mobile ekleyin.

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:ironsource:7.8.1.1")
}

Manuel Entegrasyon

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

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

AB kullanıcı rızası alma ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması 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 toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

ironSource, SDK 6.7.9 sürümünde bir izin API'si ekledi. Aşağıdaki örnek kod, bu izin bilgilerinin ironSource SDK'sına nasıl iletileceğini gösterir. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce yapmanız önerilir.

Java

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

IronSource.setConsent(true);

Kotlin

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

IronSource.setConsent(true)

Daha fazla ayrıntı ve yöntemde sağlanabilecek değerler için ironSource'un Düzenlemeyle İlgili Gelişmiş Ayarları belgelerine bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını 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 bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

ironSource, SDK 6.14.0 sürümünde CCPA düzenlemelerini desteklemek üzere bir API ekledi. Aşağıdaki örnek kod, bu izin bilgilerinin ironSource SDK'sına nasıl iletileceğini gösterir. Bu seçeneklerin, ironSource SDK'sına doğru şekilde yönlendirildiğinden emin olmak için Google Mobile Ads SDK'sını başlatmadan ö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 ayrıntı ve yöntemde sağlanabilecek değerler için ironSource'un Düzenlemeyle İlgili Gelişmiş Ayarları belgelerine bakın.

5. Adım: Gerekli kodu ekleyin

Uygulama yaşam döngüsü

İlgili ironSource yöntemlerini aşağıdaki gibi çağırmak için etkinliklerinizin her birinde 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ür, kod karartır ve optimize ederseniz IronSource, projenizde ek ProGuard kurallarına ihtiyaç duyar. Daha fazla bilgi için IronSource'un Android SDK Entegrasyonu kılavuzuna bakın.

6. Adım: Uygulamanızı test etme

Test reklamlarını etkinleştir

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

Test reklamlarını doğrulama

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

Hata kodları

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

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

Bir reklam yüklenemediğinde ironSource bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajlar aşağıda verilmiştir:

Hata kodu	Neden
101	Kullanıcı arayüzünde yapılandırılan ironSource sunucu parametreleri Ad Manager eksik/geçersiz.
102	ironSource, SDK'sını başlatmak için Etkinlik bağlamı gerektiriyor.
103	ironSource, ironSource örnek kimliği başına yalnızca 1 reklam yükleyebilir.
105	İstenen banner reklam boyutu ironSource tarafından desteklenmiyor.
106	ironSource SDK başlatılmadı.
501-1056	ironSource SDK Hataları. Daha fazla ayrıntı için belgelere bakın.
101	Kullanıcı arayüzünde yapılandırılan ironSource sunucu parametreleri Ad Manager eksik/geçersiz.
102	ironSource Bağdaştırıcısı, istenen reklam biçimini desteklemiyor.
103	Bu ağ yapılandırması için zaten bir ironSource reklamı yüklenmiş.
104	İstenen banner reklam boyutu ironSource tarafından desteklenmiyor.
508-1037	ironSource SDK Hataları. Daha fazla ayrıntı için belgelere bakın.