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
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
AB İzni 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 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.
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
- IronSource Android adaptör 8.0.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 8.0.0.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 9.0.0 ile geliştirilip test edilmiştir.
Sürüm 2.6.1
- IronSource Android bağdaştırıcısının 7.9.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.9.1.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 9.0.0 ile geliştirilip test edilmiştir.
Sürüm 2.6.0
- IronSource Android bağdaştırıcısının 7.9.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.9.0.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 9.0.0 ile geliştirilip test edilmiştir.
Sürüm 2.5.0
- IronSource Android adaptör 7.6.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.6.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.6.0 ile geliştirilip test edilmiştir.
Sürüm 2.4.0
- IronSource Android adaptör 7.5.2.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.5.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.6.0 ile geliştirilip test edilmiştir.
Sürüm 2.3.1
- IronSource Android adaptör 7.3.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.3.1.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.3.0 ile geliştirilip test edilmiştir.
Sürüm 2.3.0
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/IronSource/
klasörüne taşındı. - Bağdaştırıcı ad alanı,
GoogleMobileAds.Mediation.IronSource
kullanılacak şekilde yeniden düzenlendi. - IronSource Android adaptör 7.3.0.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.3.0.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.1.0 ile geliştirilip test edilmiştir.
Sürüm 2.2.7
- IronSource Android adaptör 7.2.7.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.2.7.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.4.1 ile geliştirilip test edilmiştir.
Sürüm 2.2.6
- IronSource Android adaptör 7.2.6.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.2.6.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.3.1 ile geliştirildi ve test edildi.
Sürüm 2.2.5
- IronSource Android adaptör 7.2.5.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.2.5.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.3.0 ile geliştirilip test edilmiştir.
Sürüm 2.2.4
IronSource.SetMetaData(string, string)
yöntemi eklendi.- IronSource Android adaptör 7.2.3.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.2.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.2.0 ile geliştirilip test edilmiştir.
Sürüm 2.2.3
- IronSource Android adaptör 7.2.3.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.2.3.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.1.0 ile geliştirilip test edilmiştir.
Sürüm 2.2.2
- IronSource Android adaptör 7.2.2.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.2.2.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.2 ile geliştirilip test edilmiştir.
Sürüm 2.2.1
- IronSource Android bağdaştırıcısı 7.2.1.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.2.1.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.0 ile geliştirilip test edilmiştir.
Sürüm 2.2.0
- IronSource Android adaptör 7.2.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.2.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.0 ile geliştirilip test edilmiştir.
Sürüm 2.1.5
- IronSource Android adaptör 7.1.14.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.1.14.0 sürümünü destekler.
Sürüm 2.1.4
- IronSource Android adaptör 7.1.13.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.1.13.0 sürümünü destekler.
Sürüm 2.1.3
- IronSource Android adaptör 7.1.12.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.1.12.0 sürümünü destekler.
Sürüm 2.1.2
- IronSource Android adaptör 7.1.11.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.1.11.1.0 sürümünü destekler.
Sürüm 2.1.1
- IronSource Android adaptör 7.1.8.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.1.8.0 sürümünü destekler.
Sürüm 2.1.0
- IronSource Android adaptör 7.1.6.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.1.6.1.0 sürümünü destekler.
Sürüm 2.0.3
- IronSource Android adaptör 7.0.3.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.0.3.0 sürümünü destekler.
Sürüm 2.0.2
- IronSource Android adaptör 7.0.2.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.0.2.0 sürümünü destekler.
Sürüm 2.0.1
- IronSource Android bağdaştırıcısı 7.0.1.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.0.1.0 sürümünü destekler.
Sürüm 2.0.0
- IronSource Android adaptör 7.0.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 7.0.0.0 sürümünü destekler.
Sürüm 1.10.0
- IronSource Android adaptör 6.18.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 6.18.0.0 sürümünü destekler.
Sürüm 1.9.1
- IronSource Android adaptör 6.17.0.1 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 6.17.0.1.0 sürümünü destekler.
Sürüm 1.9.0
- IronSource Android adaptör 6.17.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 6.16.3.0 sürümünü destekler.
Sürüm 1.8.2
- IronSource Android adaptör 6.16.2.0 sürümünü destekler.
- IronSource iOS bağdaştırıcı sürümü 6.16.2.0'ı destekler.
Sürüm 1.8.1
- IronSource Android adaptör 6.16.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 6.16.1.0 sürümünü destekler.
Sürüm 1.8.0
- IronSource Android adaptör 6.16.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 6.16.0.0 sürümünü destekler.
Sürüm 1.7.0
- IronSource Android adaptör 6.15.0.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 6.15.0.1.0 sürümünü destekler.
Sürüm 1.6.0
- IronSource Android adaptör 6.14.0.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısının 6.14.0.0 sürümünü destekler.
Sürüm 1.5.0
- IronSource Android adaptör 6.13.0.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 6.13.1.0.0 sürümünü destekler.
Sürüm 1.4.0
- IronSource Android adaptör 6.12.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcı sürümü 6.12.0.0'ı destekler.
Sürüm 1.3.2
- 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.7.0 sürümünü destekler.
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.