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 ile bağdaştırıcısının Flutter uygulamaya nasıl entegre edileceği ele alınmaktadır.
Desteklenen entegrasyonlar ve reklam biçimleri
ironSource için AdMob 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ı
- 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 üstü iOS dağıtım hedefi
- Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Flutter 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.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. 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 olarakAdMob 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 AdMob ayarlayın
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 ekle
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 SDK'sını ve bağdaştırıcıyı içe aktarın
pub.dev üzerinden entegrasyon
(Yalnızca Android) Aşağıdaki kod depolarını projenizin android dizinindeki build.gradle dosyasına ekleyin:
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
Aşağıdaki bağımlılığı paketinizin pubspec.yaml dosyasınaironSource SDK ve bağdaştırıcının en son sürümleriyle ekleyin:
dependencies:
gma_mediation_ironsource: ^1.0.0
Manuel Entegrasyon
ironSource için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü (ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızdaki eklentiye başvurun:
dependencies:
gma_mediation_ironsource:
path: path/to/local/package
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
için
GmaMediationIronsource().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.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().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
GmaMediationIronsource().setDoNotSell
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.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(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.
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.
Uygulama yaşam döngüsü
İlgili ironSource yöntemlerini aşağıdaki şekilde çağırmak için etkinliklerinizin her birinde onPause() ve onResume() yöntemlerini geçersiz kılın:
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ı 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
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
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 AdMob 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 AdMob 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 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ü 8.0.0.0 sürümüyle uyumlu olduğu doğrulandı
- ironSource iOS bağdaştırıcısının 8.0.0.0.0 sürümüyle uyumlu olduğu doğrulandı
- Google Mobile Ads Flutter Eklentisi sürüm 5.1.0 ile geliştirildi ve test edilmiştir.