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

Sign up and sign in to your ironSource Ads account.

To add your application to the ironSource Ads dashboard, click the New App button.

Enter app details

Select Live App, enter the URL of your app, and click Import App Info.

If your app is not available, select App Not Live in the Application Store and provide a Temporary Name for your app. Select your platform.

Fill out the rest of the form and click Add App.

Take note of your new App Key, which is displayed after the app has been added. You will need this value for setting up your AdMob ad unit ID. Select the ad formats your app supports. Then click Continue.

Android

iOS

Create instance

Next, configure a network instance for the app you added.

Bidding

Navigate to LevelPlay > Setup > SDK networks, then select your app. Under Bidding, click the edit icon to view the bidding instance ID.

Android

iOS

Take note of the Instance ID.

Android

iOS

Waterfall

Navigate to Ads > Setup > Instances. Select the app and click Create Instance.

Enter the necessary details and click Save and close.

Once the instance is created, the Instance ID is listed in the Instance ID field.

Locate your Reporting API Key

Bidding

This step isn't required for bidding integrations.

Waterfall

In addition to the App Key and Instance ID, you'll also need your ironSource Ads Secret Key and Refresh Token to set up your AdMob ad unit ID.

Navigate to My Account in your ironSource Ads publisher dashboard then click the API tab. Take note of your Secret Key and Refresh Token.

Turn on test mode

Follow the instructions in ironSource Ads's Integration testing guide on how to enable ironSource Ads test ads.

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

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

Sürüm 3.2.0

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.