DemirKaynak reklamlarını 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 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

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 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.AdMob 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.

Teklif

LevelPlay > Kurulum > SDK ağları'na gidin ve uygulamanızı seçin. Teklif verme altında, teklif örneği kimliğini görüntülemek için düzenle simgesini tıklayın.

Android

iOS

Örnek kimliğini not edin.

Android

iOS

Şelale

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

Teklif

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

Şelale

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.AdMob

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 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

.

GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob 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

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 indiremezsiniz. 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

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.

Unity Kullanıcı ProGuard Dosyası

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.1.1

Sürüm 3.1.0

Sürüm 3.0.1

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 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.