Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl ironSource'taki reklamlar için kullanan uyumlulaştırma: şelaleyi kapsar inceleyebilirsiniz. ironSource Reklamları'nın bir reklam biriminin uyumlulaştırma yapılandırması ve ironSource Ads SDK'sı ile bağdaştırıcısının nasıl entegre edileceği bir uygulamaya Unity dönüştürün.
Desteklenen entegrasyonlar ve reklam biçimleri
ironSource Ads için uyumlulaştırma adaptöründe AdMob şu özellikleri sunar:
Entegrasyon | |
---|---|
Teklif verme | 1 |
Şelale | |
Formatlar | |
Banner | 2 |
Geçiş reklamı | |
Ödüllü | |
Ödüllü geçiş reklamı | 2 |
1 Teklif entegrasyonu şurada: beta aşamasındaysanız erişim istemek için hesap yöneticinizle iletişime geçin.
2 Bu biçim yalnızca desteklenir.
Şartlar
- En son Google Mobile Ads SDK'sı .
- Unity 4 veya sonraki sürümler .
- Android'de dağıtmak için
- Android API düzeyi 21 veya üstü
- iOS'te dağıtmak için
- 12.0 veya sonraki bir iOS dağıtım hedefi
- Google ile yapılandırılmış, çalışan bir Unity proje Mobile Ads SDK'sı. Görüntüleyin Ayrıntılı bilgi için Başlarken.
- Arabuluculuğu tamamlama Başlangıç kılavuzu
1. Adım: ironSource Ads kullanıcı arayüzünde yapılandırmaları ayarlayın
2. Adım: Kullanıcı arayüzünde ironSource Reklam talebini ayarlayın AdMob
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Android
Talimatlar için Android kılavuzunun 2. adımına bakın.
iOS
Talimatlar için iOS rehberinin 2. adımına göz atın.
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
ironSource için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin
Şuradaki indirme bağlantısından reklamlar:
Değişiklik günlüğü'nü açın ve
GoogleMobileAdsIronSourceMediation.unitypackage
.
Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel
Paketleyin'i tıklayın ve GoogleMobileAdsIronSourceMediation.unitypackage
dosyasını bulun
indirgeyin. 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 > Kuvvet
Çöz'e dokunun. Unity Play Hizmetleri Çözümleyici kitaplığı bağımlılık gerçekleştirir
ve beyan edilen bağımlılıkları
Unity uygulamanızın Assets/Plugins/Android
dizini.
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 Reklamları için Google Mobil Reklamlar uyumlulaştırma eklentisi
.
sürüm 1.0.0
içerir
IronSource.SetConsent()
yöntemidir. Aşağıdaki örnek kod,
ironSource Ads SDK'sı için kullanıcı rızası alma bilgileri sağlanmalıdır. Bu
yöntemini kullanıyorsanız, bu işlemi
Google Mobile Ads SDK'sı.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetConsent(true);
ironSource Ads'in dokümanlarına göz atın: Yönetmelik Gelişmiş Ayarları inceleyebilirsiniz.
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 Reklamları için Google Mobil Reklamlar uyumlulaştırma eklentisi
.
sürüm 2.2.4
içerir
IronSource.SetMetaData()
yöntemidir. Aşağıdaki örnek kod,
ironSource Ads SDK'sı için kullanıcı rızası alma bilgileri sağlanmalıdır. Bu seçenekler,
Google Mobil Reklamları'nı ilk kullanıma
SDK
ironSource Ads SDK'sına doğru şekilde yönlendirilmelerini sağlayın.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetMetaData("do_not_sell", "true");
Her ikisi için de Gelişmiş Düzenleme Ayarları ile ilgili ironSource Ads belgelerine bakın Android ve iOS 'na bakın.
5. Adım: Gerekli kodu ekleyin
Android
ProGuard Kuralları
Uygulamanızı küçültür, gizler ve optimize ederseniz IronSource Ads, projeniz için ek ProGuard kuralları gerektiriyor.
.
Projenizi oluştururken Platform olarak Android'i seçin. Ardından,
Player Settings'i açın ve aşağıda yer alan User ProGuard File (Kullanıcı ProGuard Dosyası) seçeneğini belirleyin.
Yayınlama Ayarları sekmesi. Unity, özel bir kullanıcının
Değiştirebileceğiniz proguard-user.txt
dosya oluşturuldu.
Danışma
IronSource Ads'in Android SDK Entegrasyonu kılavuzu
daha fazla bilgi edinmek için
bu belgeyi inceleyebilirsiniz.
ve bu kuralları proguard-user.txt
dosyanıza ekleyin.
iOS
SKAdNetwork entegrasyonu
SKAdNetwork tanımlayıcılarını kampanyanıza eklemek için ironSource Ads'in dokümanlarındaki
projenin Info.plist
dosyasına ekleyin.
6. Adım: Uygulamanızı test edin
Test reklamlarını etkinleştir
AdMob 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 (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
Hata kodları
Bağdaştırıcı, ironSource Ads'den reklam alamazsa yayıncılar,
kullanarak reklam yanıtından gelen temel hatayı
ResponseInfo
şu sınıflarda:
Android
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
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:
Android
Hata kodu | Neden |
---|---|
101 | Kullanıcı arayüzünde yapılandırılan ironSource Ads sunucu parametreleri AdMob eksik/geçersiz. |
102 | ironSource Ads, SDK'sını başlatmak için bir Etkinlik bağlamına ihtiyaç duyar. |
103 | ironSource Ads, ironSource örnek 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. |
iOS
Hata kodu | Neden |
---|---|
101 | Kullanıcı arayüzünde yapılandırılan ironSource Ads sunucu parametreleri AdMob 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. |
IronSource Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sürüm 3.2.1
DummyClient
adlı dosyaPlaceholderClient
olarak yeniden adlandırıldı.- IronSource Android bağdaştırıcısı 8.2.1.0 sürümünü destekler.
- IronSource iOS adaptörü 8.2.0.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.2.0
- IronSource Android bağdaştırıcısı 8.2.0.0 sürümünü destekler.
- IronSource iOS adaptörü 8.2.0.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.1
- IronSource Android bağdaştırıcısı 8.1.0.0 sürümünü destekler.
- IronSource iOS adaptörü 8.1.1.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.0
- IronSource Android bağdaştırıcısı 8.1.0.0 sürümünü destekler.
- IronSource iOS adaptörü 8.1.0.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.0.1
- IronSource Android bağdaştırıcısı 8.0.0.1 sürümünü destekler.
- IronSource iOS adaptörü 8.0.0.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.0.0
- IronSource Android bağdaştırıcısı 8.0.0.0 sürümünü destekler.
- IronSource iOS adaptörü 8.0.0.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.6.1
- IronSource Android bağdaştırıcısı 7.9.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.9.1.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.6.0
- IronSource Android bağdaştırıcısı 7.9.0.0 sürümünü destekler.
- IronSource iOS adaptörü 7.9.0.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.5.0
- IronSource Android bağdaştırıcısı 7.6.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.6.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 8.6.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.4.0
- IronSource Android bağdaştırıcısı 7.5.2.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.5.1.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 8.6.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.3.1
- IronSource Android bağdaştırıcısı 7.3.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.3.1.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.3.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.3.0
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/IronSource/
hedefine taşındı. - Bağdaştırıcı ad alanı,
GoogleMobileAds.Mediation.IronSource
kullanılacak şekilde yeniden düzenlendi. - IronSource Android bağdaştırıcısı 7.3.0.1.0 sürümünü destekler.
- IronSource iOS adaptörü 7.3.0.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.2.7
- IronSource Android bağdaştırıcısı 7.2.7.0 sürümünü destekler.
- IronSource iOS adaptörü 7.2.7.0.1 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 7.4.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.2.6
- IronSource Android bağdaştırıcısı 7.2.6.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.2.6.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 7.3.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.2.5
- IronSource Android bağdaştırıcısı 7.2.5.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.2.5.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.3.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.2.4
IronSource.SetMetaData(string, string)
yöntemi eklendi.- IronSource Android bağdaştırıcısı 7.2.3.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.2.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.2.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.2.3
- IronSource Android bağdaştırıcısı 7.2.3.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.2.3.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.2.2
- IronSource Android bağdaştırıcısı 7.2.2.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.2.2.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.2 sürümüyle 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ı 7.2.1.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.2.0
- IronSource Android bağdaştırıcısı 7.2.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.2.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.1.5
- IronSource Android bağdaştırıcısı 7.1.14.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.1.14.0 sürümünü destekler.
Sürüm 2.1.4
- IronSource Android bağdaştırıcısı 7.1.13.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.1.13.0 sürümünü destekler.
Sürüm 2.1.3
- IronSource Android bağdaştırıcısı 7.1.12.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.1.12.0 sürümünü destekler.
Sürüm 2.1.2
- IronSource Android bağdaştırıcısı 7.1.11.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.1.11.1.0 sürümünü destekler.
Sürüm 2.1.1
- IronSource Android bağdaştırıcısı 7.1.8.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.1.8.0 sürümünü destekler.
Sürüm 2.1.0
- IronSource Android bağdaştırıcısı 7.1.6.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.1.6.1.0 sürümünü destekler.
Sürüm 2.0.3
- IronSource Android bağdaştırıcısı 7.0.3.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.0.3.0 sürümünü destekler.
Sürüm 2.0.2
- IronSource Android bağdaştırıcısı 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ı 7.0.1.0 sürümünü destekler.
Sürüm 2.0.0
- IronSource Android bağdaştırıcısı 7.0.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 7.0.0.0 sürümünü destekler.
Sürüm 1.10.0
- IronSource Android bağdaştırıcısı 6.18.0.0 sürümünü destekler.
- IronSource iOS adaptörü 6.18.0.0 sürümünü destekler.
Sürüm 1.9.1
- IronSource Android bağdaştırıcısı 6.17.0.1 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 6.17.0.1.0 sürümünü destekler.
Sürüm 1.9.0
- IronSource Android bağdaştırıcısı 6.17.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 6.16.3.0 sürümünü destekler.
Sürüm 1.8.2
- IronSource Android bağdaştırıcısı 6.16.2.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 6.16.2.0 sürümünü destekler.
Sürüm 1.8.1
- IronSource Android bağdaştırıcısı 6.16.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 6.16.1.0 sürümünü destekler.
Sürüm 1.8.0
- IronSource Android bağdaştırıcısı 6.16.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 6.16.0.0 sürümünü destekler.
Sürüm 1.7.0
- IronSource Android bağdaştırıcısı 6.15.0.1.0 sürümünü destekler.
- IronSource iOS adaptörü 6.15.0.1.0 sürümünü destekler.
Sürüm 1.6.0
- IronSource Android bağdaştırıcısı 6.14.0.1.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 6.14.0.0 sürümünü destekler.
Sürüm 1.5.0
- IronSource Android bağdaştırıcısı 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 bağdaştırıcısı 6.12.0.0 sürümünü destekler.
- IronSource iOS bağdaştırıcısı 6.12.0.0 sürümünü destekler.
Sürüm 1.3.2
- IronSource Android bağdaştırıcısı 6.10.0.0 sürümünü destekler.
- IronSource iOS adaptörü 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 adaptörü 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 adaptör 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 adaptör 6.8.4.1.0 sürümünü destekler
Sürüm 1.1.2
- IronSource Android adaptörü 6.8.4.1 sürümünü destekler
- IronSource iOS adaptörü 6.8.4.1 sürümünü destekler
Sürüm 1.1.1
- IronSource Android adaptörü 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 Ödüllü API'yi destekleyecek şekilde güncellendi.
- IronSource Android adaptörü 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 adaptör 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 adaptör 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 adaptör 6.7.10.0 sürümünü destekler
- Chartboost Unity uyumlulaştırma eklentisiyle çakışma sorunu düzeltildi.
Sürüm 1.0.1
- IronSource Android bağdaştırıcının 6.7.9.0 sürümünü destekler.
- IronSource iOS adaptör 6.7.9.2.0 sürümünü destekler.
Sürüm 1.0.0
- İlk çıkış tarihi!
- IronSource Android bağdaştırıcının 6.7.9.0 sürümünü destekler.
- IronSource iOS adaptör 6.7.9.1.0 sürümünü destekler.