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 Flutter 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ı .
- Flutter 3.7.0 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 Flutter 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
pub.dev aracılığıyla entegrasyon
(Yalnızca Android) Projenizin android
dizininde bulunan build.gradle
dosyasına aşağıdaki depoları ekleyin:
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
Aşağıdaki bağımlılığı
IronSource
Paketinizdeki SDK ve bağdaştırıcı
pubspec.yaml
dosyası:
dependencies:
gma_mediation_ironsource: ^1.0.0
Manuel Entegrasyon
Şu hesap için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin:
IronSource
,
indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü ekleyin.
(ve içeriklerini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml
dosyanızdaki eklentiye referans verin:
dependencies:
gma_mediation_ironsource:
path: path/to/local/package
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
içerir
GmaMediationIronsource().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ı.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().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
içerir
GmaMediationIronsource().setDoNotSell
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.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(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.
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.
Uygulama yaşam döngüsü
Şu öğelerin her birinde onPause()
ve onResume()
yöntemlerini geçersiz kıl:
ilgili ironSource Ads yöntemlerini şu şekilde çağırmak için etkinliklerinizi
Java
@Override
public void onResume() {
super.onResume();
IronSource.onResume(this);
}
@Override
public void onPause() {
super.onPause();
IronSource.onPause(this);
}
Kotlin
public override fun onResume() {
super.onResume()
IronSource.onResume(this)
}
public override fun onPause() {
super.onPause()
IronSource.onPause(this)
}
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 Ads (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 Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü
1.0.0
- İlk sürüm.
- ironSource Android adaptörü sürüm 8.0.0.0 ile uyumluluk doğrulandı
- ironSource iOS adaptörü sürüm 8.0.0.0.0 ile uyumluluk doğrulandı
- Google Mobile Ads Flutter Plugin sürüm 5.1.0 ile geliştirilmiş ve test edilmiştir.