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

ironSource'u Uyumlulaştırma ile entegre etme

Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl uyumlulaştırma, kapsayıcı şelale inceleyebilirsiniz. ironSource Reklamların bir reklam biriminin uyumlulaştırmasına nasıl ekleneceği ele alınmaktadır. reklam kaynağı optimizasyonunun nasıl ayarlanacağı ve reklam kaynağınızın ironSource Ads SDK'sını ve bağdaştırıcısını Androidcihazınıza bağlayın uygulamasını indirin.

Desteklenen entegrasyonlar ve reklam biçimleri

ironSource Ads için uyumlulaştırma adaptöründe Ad Manager şu özellikleri sunar:

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

Şartlar

Android API düzeyi 21 veya üstü

En son Google Mobile Ads SDK'sı
Arabuluculuğu tamamlama Başlangıç kılavuzu

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

ironSource Ads hesabınızda 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ı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ünen yeni Uygulama Anahtarınızı 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.

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.

Raporlama API'sı Anahtarınızı Bulma

Reklam birimi kimliğinizi oluşturmak için Uygulama Anahtarı ve Örnek Kimliği'ne ek olarak, ironSource Ads Gizli Anahtarı ve Yenileme Jetonu da gerekir.Ad Manager

ironSource Ads 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 Ads'in Entegrasyon testi kılavuzundaki talimatları uygulayarak ironSource Ads test reklamlarını etkinleştirin.

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

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.

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

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

Android Studio Entegrasyonu (önerilir)

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://android-sdk.is.com/")
    }
  }
}

Ardından, uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdakileri ekleyin: ve yapılandırmalarına değineceğiz. Chrome Web Mağazası'ndaki ironSource Ads SDK'sı ve bağdaştırıcısı:

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

Manuel Entegrasyon

Son sürümünü indirin ironSource Ads Android SDK'sı ve projenize ekleyin.
Şuraya gidin: ironSource Ads bağdaştırıcı yapıları Google'ın Maven deposunda. En son sürümü seçin ve IronSource bağdaştırıcısının .aar dosyasını indirin ve bu dosyayı projenize ekleyin.

4. adım: Gizlilik ayarlarını ironSource Ads SDK'sında uygulayın

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.

ironSource Ads, SDK'nın 6.7.9 sürümünde izin API'si ekledi. Aşağıdaki örnek kodu, bu izin bilgilerinin ironSource Ads SDK'sına nasıl iletileceğini gösterir. Eğer bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunur.

Java

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

IronSource.setConsent(true);

Kotlin

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

IronSource.setConsent(true)

ironSource Ads'in dokümanlarına göz atın: Yönetmelik Gelişmiş Ayarları 'na bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.

ironSource Ads, SDK'nın 6.14.0 sürümünde CCPA düzenlemelerini desteklemek için bir API ekledi. Aşağıdaki örnek kod, bu izin bilgilerinin ironSource Ads SDK'sı. Bu seçenekleri ayarlamadan önce yapmanız gerekir Google Mobile Ads SDK'sını başlatma ironSource Ads SDK'sına doğru şekilde yönlendirilmelerini sağlayın.

Java

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

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

Kotlin

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

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

Regulation Advanced (Gelişmiş Yönetmelik) sayfasında ironSource Ads'in dokümanlarına bakın Ayarlar 'na bakın.

5. Adım: Gerekli kodu ekleyin

Uygulama yaşam döngüsü

Etkinliklerinizin her birinde onPause() ve onResume() yöntemlerini geçersiz kılarak ilgili ironSource Ads yöntemlerini aşağıdaki gibi çağırı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ı

Şu durumda: uygulamanızı küçültme, gizleme ve optimize etme , ironSource Ads için projenize ek ProGuard kuralları gerektirir. Danışma ironSource Ads'in Android SDK Entegrasyonu kılavuzu konulu videomuzu izleyin.

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

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

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

Hata kodları

Adaptör, ironSource Ads'den reklam alamazsa kullanarak reklam yanıtından gelen temel hata . ResponseInfo.getAdapterResponses() şu sınıflarda:

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

ironSource Ads tarafından gönderilen kodlar ve ilgili mesajlar bağdaştırıcısını kontrol etmek için aşağıdaki adımları uygulayın:

Hata kodu	Neden
101	Ad Manager Kullanıcı arayüzü eksik/geçersiz.
102	ironSource Ads, SDK'sını başlatmak için bir etkinlik bağlamına ihtiyaç duyar.
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'sı Hataları. Belgelere göz atın inceleyebilirsiniz.
101	Kullanıcı arayüzünde yapılandırılan ironSource Ads sunucu parametreleri Ad Manager eksik/geçersiz.
102	ironSource Reklam Bağdaştırıcısı, istenen reklam biçimini desteklemiyor.
103	Bu ağ yapılandırması için bir ironSource reklamı zaten yüklenmiş.
104	İstenen banner reklam boyutu ironSource Ads tarafından desteklenmiyor.
508-1037	ironSource Ads SDK'sı Hataları. Belgelere göz atın inceleyebilirsiniz.