ironSource'u uyumlulaştırmayla 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, ironSource'un reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve ironSource SDK'sı ile bağdaştırıcısının Unity uygulamasına nasıl entegre edileceği 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ı

Koşullar

  • En yeni Google Mobile Ads SDK'sı
  • Unity 4 veya sonraki sürümleri
  • Android'de dağıtmak için
    • Android API düzeyi 21 veya üstü
  • iOS'te dağıtmak için
    • 12.0 veya üstü iOS dağıtım hedefi
  • Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Unity proje. Ayrıntılar için Başlarken bölümüne bakın.
  • 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 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.

Android

iOS

Ö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

Android

Talimatlar için Android Android.

iOS

Talimatlar için iOS rehberinin 2. adımına göz atın. iOS.

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

Changelog'daki indirme bağlantısından ironSource için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin ve ZIP dosyasından GoogleMobileAdsIronSourceMediation.unitypackage dosyasını çıkarın.

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

Ardından, Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Çözmeye Zorla'yı seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemeyi sıfırdan gerçekleştirecek ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalayacaktır.

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

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 için Google Mobile Ads uyumlulaştırma eklentisi sürüm 1.0.0 için IronSource.SetConsent() yöntemi bulunur. Aşağıdaki örnek kod, izin bilgilerinin ironSource SDK'sına nasıl iletileceğini göstermektedir. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce yapmanız önerilir.

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

IronSource.SetConsent(true);

Daha fazla bilgi 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 sürüm 2.2.4 için Google Mobile Ads uyumlulaştırma eklentisi IronSource.SetMetaData() yöntemini içerir. Aşağıdaki örnek kod, izin bilgilerinin ironSource SDK'sına nasıl iletileceğini göstermektedir. 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.

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'un hem Android hem de iOS için Gelişmiş Ayarları Düzenleme belgelerine bakın.

5. Adım: Gerekli kodu ekleyin

Android

ProGuard Kuralları

Uygulamanızı küçültür, kod karartır ve optimize ederseniz IronSource, projeniz için ek ProGuard kurallarına ihtiyaç duyar.

Projenizi oluştururken Platform olarak Android'i seçin. Ardından Oynatıcı Ayarları'nı açıp Yayınlama Ayarları sekmesinin altındaki Kullanıcı ProGuard Dosyası'nı işaretleyin. Unity, değişiklik yapabilmeniz için özel proguard-user.txt dosyasının nerede oluşturulduğunu göstermelidir.

Unity Kullanıcı ProGuard Dosyası

Projenizde gerekli olan ProGuard kuralları hakkında daha fazla bilgi için IronSource'un Android SDK Entegrasyon 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 belgelerindeki adımları uygulayı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 yayıncılar aşağıdaki sınıflarda 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üklenemediğinde ironSource bağdaştırıcısı tarafından atılan kodlar ve ilgili mesajları burada bulabilirsiniz:

Android

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.

iOS

Hata kodu Neden
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.

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

Sürüm 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 1.10.0

Sürüm 1.9.1

Sürüm 1.9.0

Sürüm 1.8.2

Sürüm 1.8.1

Sürüm 1.8.0

Sürüm 1.7.0

Sürüm 1.6.0

Sürüm 1.5.0

Sürüm 1.4.0

Sürüm 1.3.2

Sürüm 1.3.1

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

Sürüm 1.3.0

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

Sürüm 1.2.0

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

Sürüm 1.1.2

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

Sürüm 1.1.1

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

Sürüm 1.1.0

  • Eklenti, yeni açık beta Ödüllü API'yi destekleyecek şekilde güncellendi.
  • IronSource Android adaptörü sürüm 6.8.1.2'yi destekler
  • IronSource iOS bağdaştırıcısının 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ının 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ının 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ının 6.7.10.0 sürümünü destekler
  • Chartboost Unity uyumlulaştırma eklentisiyle ilgili bir çakışma düzeltildi.

Sürüm 1.0.1

  • IronSource Android adaptör 6.7.9.0 sürümünü destekler.
  • IronSource iOS bağdaştırıcısının 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ının 6.7.9.1.0 sürümünü destekler.