DemirKaynak reklamlarını 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 ve ironSource Ads SDK'sının ve bağdaştırıcının bir Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Entegrasyon
Teklif verme  1
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı  2
1 Teklif entegrasyonu açık beta sürümündedir.

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

Şartlar

  • En son Google Mobile Ads SDK'sı
  • Unity 4 veya üzeri
  • [Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek üzere IronSource 3.5.1 veya sonraki sürümler için Google Mobile Ads uyumlulaştırma eklentisini kullanın (en son sürüm önerilir)
  • Android'de dağıtmak için
    • Android API düzeyi 21 veya sonraki sürümler
  • iOS'te dağıtmak için
    • 12.0 veya sonraki bir iOS dağıtım hedefi
  • Google Mobile Ads SDK'sı ile yapılandırılmış çalışan bir Unity projesi. Ayrıntılar için Başlayın bölümüne bakın.
  • 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.

Yeni uygulama ekle

Yeni bir uygulama eklemek için Reklamlar > Uygulamalar'a gidin ve Uygulama ekle'yi tıklayın.

Formu doldurun ve Uygulama ekle'yi tıklayın.

Uygulama Anahtarı'nı not edin, ardından uygulamanızın desteklediği reklam biçimlerini seçin ve Devam'ı tıklayın.

Android

iOS

Örnek oluşturma

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

Teklif verme

LevelPlay > Kurulum > Örnekler'e gidin ve uygulamanızı seçin. Teklif verme bölümünde ironSource'u tıklayın.

Örnek kimliğini not edin.

Android

iOS

Şelale

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

Formu doldurun ve Kaydet ve kapat'ı tıklayın.

Örnek kimliğini not edin.

Raporlama API'si anahtarınızı bulma

Teklif verme

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

Şelale

Hesabım sayfasında API sekmesini tıklayın ve Gizli Anahtarınızı ve Yenileme Jetonunuzu not edin.

Test modunu etkinleştirme

ironSource Ads test reklamlarını etkinleştirmeyle ilgili ironSource Ads entegrasyon testi kılavuzundaki talimatları uygulayın.

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

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

Android

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

Talimatlar için iOS kılavuzunun 2. adımına bakın.

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

ironSource Mobile'ı AdMob kullanıcı arayüzündeki AB ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için AB tüzükleri ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayın.

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

OpenUPM-CLI

OpenUPM-CLI yüklüyse Unity için Google Mobil Reklamlar ironSource Ads Uyumlulaştırma Eklentisi'ni projenizin kök dizininden aşağıdaki komutu çalıştırarak projenize yükleyebilirsiniz:

openupm add com.google.ads.mobile.mediation.ironsource

OpenUPM

Unity Paket Yöneticisi Ayarlarını açmak için Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçin.

Kapsamlı Kayıt Daireleri sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı bir kayıt dairesi olarak ekleyin:

  • Ad: OpenUPM
  • URL: https://package.openupm.com
  • Kapsamlar: com.google

OpenUPM Ayrıntıları

Ardından, Unity Paket Yöneticisi'ni açmak için pencere > Paket Yöneticisi'ne gidin ve açılır menüden Kayıt Dairelerim'i seçin.

Unity Kayıt Daireleri

Google Mobil Reklamlar ironSource Reklam Uyumlulaştırması paketini seçin ve Yükle'yi tıklayın.

OpenUPM'den yükleme

Unity Paketi

ironSource reklamları için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü değişiklik günlüğündeki indirme bağlantısından indirin ve GoogleMobileAdsIronSourceMediation.unitypackage dosyasını zip dosyasından çıkarın.

Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsIronSourceMediation.unitypackage dosyayı bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Unity'den içe aktarma

Ardından Öğeler > Harici Bağımlılık Yöneticisi > Android Çözücü > Çözümü Zorla'yı seçin. Harici Bağımlılık Yöneticisi kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

Çözümü Zorla Uygula

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

Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı (AEA)'daki kullanıcılara 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 1.0.0 sürümü için Google Mobile Ads uyumlulaştırma eklentisi, IronSource.SetConsent() yöntemini içerir. Aşağıdaki örnek kodda, 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.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetConsent(true);

Daha fazla bilgi için ironSource Ads'in Düzenleme Gelişmiş Ayarları ile ilgili dokümanlarını inceleyin.

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 seçeneği sunmayı zorunlu kılıyor. 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 2.2.4 sürümü için Google Mobile Ads uyumlulaştırma eklentisi, IronSource.SetMetaData() yöntemini içerir. Aşağıdaki örnek kodda, 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ı başlatmadan önce ayarlanması gerekir.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

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

Daha fazla ayrıntı ve yöntemde sağlanabilecek değerler için ironSource Ads'in hem Android hem de iOS için Düzenleme Gelişmiş Ayarları dokümanlarına bakın.

5. adım: Gerekli kodu ekleyin

Android

Proguard Kuralları

Uygulamanızı küçültüyor, kodunu karartıyor ve optimize ediyorsanız IronSource Ads, projeniz için ek ProGuard kuralları gerektirir.

Projenizi oluştururken Platform olarak Android'i seçin. Ardından Oynatıcı Ayarları'nı açın ve Yayınlama Ayarları sekmesinin altında Kullanıcı Proguard Dosyası'nı işaretleyin. Unity, özel bir proguard-user.txt dosyasının değiştirilmeniz için oluşturulduğu yeri gösterir.

Unity Kullanıcı Proguard Dosyası

Projeniz için hangi ProGuard kurallarının gerekli olduğu hakkında daha fazla bilgi edinmek üzere IronSource Ads'in Android SDK Entegrasyonu kılavuzuna bakın ve bu kuralları proguard-user.txt dosyanıza ekleyin.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için ironSource Ads'in belgelerini inceleyin.

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

Test reklamlarını etkinleştirme

AdMob 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 yayıncılar aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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:

Android

Hata kodu Neden
101 AdMob kullanıcı arayüzünde yapılandırılan ironSource Ads sunucu parametreleri eksik/geçersiz.
102 ironSource Ads'in SDK'sını başlatması için bir etkinlik bağlamı gerekir.
103 ironSource Ads, ironSource ö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.

iOS

Hata kodu Neden
101 AdMob kullanıcı arayüzünde yapılandırılan ironSource Ads sunucu parametreleri eksik/geçersiz.
102 ironSource Ads Adapter, istenen reklam biçimini desteklemiyor.
103 Bu ağ yapılandırması için zaten bir ironSource reklamı yüklü.
104 İstenen banner reklam boyutu ironSource Ads tarafından desteklenmiyor.
508-1037 ironSource Ads SDK Hataları. Daha fazla ayrıntı için dokümanları inceleyin.

IronSource Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

3.6.1 sürümü

3.6.0 sürümü

3.5.2 sürümü

3.5.1 sürümü

3.5.0 sürümü

3.4.0 sürümü

3.3.1 sürümü

3.3.0 sürümü

3.2.1 sürümü

3.2.0 sürümü

3.1.1 sürümü

3.1.0 sürümü

Sürüm 3.0.1

3.0.0 sürümü

2.6.1 sürümü

2.6.0 sürümü

2.5.0 sürümü

2.4.0 sürümü

2.3.1 sürümü

2.3.0 sürümü

2.2.7 sürümü

2.2.6 sürümü

2.2.5 sürümü

2.2.4 sürümü

2.2.3 sürümü

2.2.2 sürümü

2.2.1 sürümü

2.2.0 sürümü

2.1.5 sürümü

2.1.4 sürümü

2.1.3 sürümü

2.1.2 sürümü

2.1.1 sürümü

2.1.0 sürümü

2.0.3 sürümü

2.0.2 sürümü

2.0.1 sürümü

2.0.0 sürümü

Sürüm 1.10.0

1.9.1 sürümü

1.9.0 sürümü

1.8.2 sürümü

Sürüm 1.8.1

Sürüm 1.8.0

Sürüm 1.7.0

Sürüm 1.6.0

1.5.0 sürümü

1.4.0 sürümü

1.3.2 sürümü

1.3.1 sürümü

  • IronSource Android adaptörü 6.10.0.0 sürümünü destekler
  • IronSource iOS adaptörü 6.8.6.0 sürümünü destekler

1.3.0 sürümü

  • IronSource Android adaptörü 6.10.0.0 sürümünü destekler
  • IronSource iOS bağdaştırıcısı 6.8.4.1.0 sürümünü destekler

Sürüm 1.2.0

  • IronSource Android adaptörü 6.9.0.1 sürümünü destekler
  • IronSource iOS bağdaştırıcısı 6.8.4.1.0 sürümünü destekler

Sürüm 1.1.2

  • IronSource Android bağdaştırıcısı 6.8.4.1 sürümünü destekler
  • IronSource iOS adaptörü 6.8.4.1 sürümünü destekler

1.1.1 sürümü

  • IronSource Android bağdaştırıcısı 6.8.4.1 sürümünü destekler
  • IronSource iOS adaptörü 6.8.3.0 sürümünü destekler

Sürüm 1.1.0

  • Eklenti, yeni açık beta Rewarded API'yi destekleyecek şekilde güncellendi.
  • IronSource Android bağdaştırıcısı 6.8.1.2 sürümünü destekler
  • IronSource iOS adaptörü 6.8.0.1 sürümünü destekler

Sürüm 1.0.4

  • IronSource Android adaptörü 6.7.11.0 sürümünü destekler
  • IronSource iOS bağdaştırıcısı 6.7.11.0 sürümünü destekler

Sürüm 1.0.3

  • IronSource Android adaptörü 6.7.10.0 sürümünü destekler
  • IronSource iOS bağdaştırıcısı 6.7.10.0 sürümünü destekler

Sürüm 1.0.2

  • IronSource Android adaptörü 6.7.9.1.1 sürümünü destekler
  • IronSource iOS bağdaştırıcısı 6.7.10.0 sürümünü destekler
  • Chartboost Unity uyumlulaştırma eklentisi ile ilgili bir çakışma düzeltildi.

1.0.1 sürümü

  • IronSource Android adaptörü 6.7.9.0 sürümünü destekler.
  • IronSource iOS bağdaştırıcısı 6.7.9.2.0 sürümünü destekler.

Sürüm 1.0.0

  • İlk sürüm!
  • IronSource Android adaptörü 6.7.9.0 sürümünü destekler.
  • IronSource iOS bağdaştırıcısı 6.7.9.1.0 sürümünü destekler.