DemirKaynak reklamlarını uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını kapsayan arabuluculuk kullanarak ironSource Ads'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu eğitimde, ironSource Reklamların bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve ironSource Ads SDK'sı ile bağdaştırıcısının bir uygulamaya nasıl entegre Flutter edileceği anlatılmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

ironSource Ads için uyumlulaştırma AdMob bağdaştırıcısı şu özelliklere sahiptir:

Entegrasyon
Teklif verme	^1
Şelale
Formatlar
Banner	^2
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı	^2

¹ Teklif entegrasyonu kapalı beta sürümündedir. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.

² Bu biçim yalnızca şelale entegrasyonunda desteklenir.

Şartlar

• En son Google Mobile Ads SDK'sı
• Flutter 3.7.0 veya üzeri
• Android'de dağıtmak için
  • Android API düzeyi 21 veya sonraki sürümler
• iOS'te dağıtım yapmak için
  • 12.0 veya sonraki bir 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şlayın bölümüne bakın.
• Uyumlulaştırmayı tamamlama Başlangıç kılavuzu

1. adım: ironSource Ads kullanıcı arayüzünde yapılandırmaları ayarlayın

ironSource Ads hesabınıza 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 adını girin ve Uygulama Bilgilerini İçe Aktarma'yı tıklayın.

Uygulamanız kullanımda değilse Uygulama Mağazasında Kullanımda Olmayan Uygulama'yı seçin ve uygulamanız için bir Geçici Ad girin. Platformunuzu seçin.

Formun geri kalanını doldurun ve Uygulama Ekle'yi tıklayın.

Uygulama eklendikten sonra görüntülenen yeni Uygulama Anahtarınızı not edin. AdMob reklam birimi kimliğinizi ayarlamak için bu değere ihtiyacınız olacaktır. Uygulamanızın desteklediği reklam biçimlerini seçin. Ardından Devam'ı tıklayın.

Yapay Zeka

iOS

Örnek oluştur

Ardından, eklediğiniz uygulama için bir ağ örneği yapılandırın.

Teklif verme

LevelPlay > Kurulum > SDK ağları'na gidin, ardından uygulamanızı seçin. Teklif verme bölümünde, teklif verme örneği kimliğini görüntülemek için düzenleme simgesini tıklayın.

Yapay Zeka

iOS

Örnek kimliğini not edin.

Yapay Zeka

iOS

Şelale

Reklamlar > Kurulum > Örnekler'e gidin. Uygulamayı seçip Örnek Oluştur'u tıklayın.

Gerekli ayrıntıları girin ve Kaydet ve kapat'ı tıklayın.

Not: IronSource, maksimum sayıda Instance kimliği oluşturmanıza sınırlama getirir. Daha fazla Instance ID oluşturamadığınızı belirten bir hata alırsanız yardım için IronSource destek ekibiyle iletişime geçin.

Önemli Bilgi: Ödüllü geçiş reklamlarını desteklemek istiyorsanız Ödüllü Video biçimini seçin ve 2. adımda reklam kaynağı olarak IronSource reklamlarını eklemek için bu Instance ID'yi kullanın. Ayrıca, ödüllü geçiş reklamı desteği için örnek kimliğinizi ayarlamak amacıyla [e-mail] adresinden ironSource Ads destek ekibiyle iletişime geçmeniz gerekir.

Örnek oluşturulduktan sonra örnek kimliği Örnek Kimliği alanında listelenir.

Reporting API Anahtarınızı bulma

Teklif verme

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

Şelale

AdMob reklam birimi kimliğinizi ayarlamak için Uygulama Anahtarı ve Örnek Kimliği'ne ek olarak ironSource Ads Gizli Anahtarınıza ve Yenileme Jetonunuza da ihtiyacınız olacaktır.

ironSource Ads yayıncı kontrol panelinizde Hesabım'a gidin ve ardından API sekmesini tıklayın. Gizli Anahtarınızı ve Yenileme Jetonunuzu not edin.

Test modunu etkinleştirme

ironSource Ads test reklamlarını etkinleştirmeyle ilgili olarak ironSource Ads'in Entegrasyon testi kılavuzundaki talimatları uygulayı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

Önemli: AB kullanıcı rızası, GDPR, CPRA ve Kullanıcı Mesajlaşma Platformu ile ilgili yapılandırmayı tamamlamak için Hesap Yönetimi izniniz olduğunu doğrulayın. Ayrıntılar için Kullanıcıların hesabınıza erişimini yönetme başlıklı makaleyi inceleyin.

AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ironSource Mobile'ı eklemek için GDPR ayarları ve ABD eyalet düzenlemeleri ayarlarında belirtilen adımları uygulayın.

3. Adım: ironSource Ads SDK'sını ve bağdaştırıcısını içe aktarın

Not: Uyumlu ironSource Ads ve Google Mobile Ads SDK sürümlerinin entegre edilmemesi derleme sorunlarına neden olabilir.

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ı Rızası Politikası uyarınca, cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara belirli açıklamaların yapıldığından ve bu kullanıcılardan alınan izinlerin alındığından emin olmanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin isterken uyumlulaştırma zincirinizde kişisel verileri toplayabilecek, alabilecek veya kullanabilecek tüm reklam ağlarını tanımlamalı ve her bir ağın kullanımı hakkında bilgi sağlamalısınız. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

ironSource Ads için Google Mobile Ads uyumlulaştırma eklentisi GmaMediationIronsource().SetConsent() yöntemini içerir. Aşağıdaki örnek kodda, izin bilgilerinin ironSource Ads SDK'sına nasıl iletileceği gösterilmektedir. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı üzerinden reklam istemeden önce yapmanız önerilir.

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setConsent(true);

Daha fazla bilgi için Regulation Advanced Settings (Gelişmiş Düzenleme Ayarları) bölümündeki ironSource Ads belgelerine bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, kişisel bilgilerinin "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılıyor. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam sunumu için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar. Ancak Google, bu ayarı uyumlulaştırma zincirinizdeki tüm reklam ağlarına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

ironSource Ads için Google Mobile Ads uyumlulaştırma eklentisinin GmaMediationIronsource().setDoNotSell yöntemini içerir. Aşağıdaki örnek kodda, izin bilgilerinin ironSource Ads SDK'sına nasıl iletileceği gösterilmektedir. Bu seçeneklerin ironSource Ads SDK'sına doğru şekilde yönlendirilmesini sağlamak 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 Ads'in hem Android hem de iOS için Düzenleme Gelişmiş Ayarları dokümanlarına bakın.

5. Adım: Gerekli kodu ekleyin

Yapay Zeka

ProGuard Kuralları

Uygulamanızı küçültüyor, kodunu karartıyor ve optimize ediyorsanız IronSource Ads, projeniz için ek ProGuard kuralları gerektirir.

Projeniz için hangi ProGuard kurallarının gerekli olduğu hakkında daha fazla bilgi için IronSource Ads'in Android SDK Entegrasyonu kılavuzuna bakın ve bu kuralları proguard-user.txt dosyanıza ekleyin.

Uygulama yaşam döngüsü

İlgili ironSource Ads yöntemlerini aşağıdaki gibi çağırmak için etkinliklerinizin her birindeki 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 Ads'in belgelerini inceleyin.

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.

Önemli: Uygulamanızı yayınlamadan önce AdMob ve IronSource için test modunu devre dışı bırakın.

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, aşağıdaki sınıfların altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Yapay Zeka

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

Bir reklam yüklenemediğinde ironSource Ads bağdaştırıcısı tarafından gönderilen kodlar ve beraberindeki mesajlar aşağıda verilmiştir:

Yapay Zeka

Hata kodu	Neden
101	AdMob kullanıcı arayüzünde yapılandırılmış ironSource Ads sunucu parametreleri eksik/geçersiz.
102	ironSource Ads, SDK'sını başlatmak için bir etkinlik bağlamı gerektirir.
103	ironSource Ads, ironSource örneği 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ı. Daha fazla ayrıntı için belgeleri inceleyin.

iOS

Hata kodu	Neden
101	AdMob kullanıcı arayüzünde yapılandırılmış ironSource Ads sunucu parametreleri eksik/geçersiz.
102	ironSource Ads Adapter, istenen reklam biçimini desteklemiyor.
103	Bu ağ yapılandırması için zaten bir ironSource reklamı yüklü.
104	İstenen banner reklam boyutu ironSource Ads tarafından desteklenmiyor.
508-1037	ironSource Ads SDK'sı Hataları. Daha fazla ayrıntı için belgeleri inceleyin.

ironSource Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü

Sonraki Sürüm

• Google Mobile Ads Flutter Eklentisi sürüm 5.2.0 ile geliştirilmiş ve test edilmiştir.

1.1.0

• ironSource Android adaptörü sürüm 8.2.1.0 ile uyumluluk doğrulandı
• ironSource iOS adaptörü 8.2.0.0.0 sürümü ile uyumluluğu doğrulandı
• Google Mobile Ads Flutter eklentisi 5.1.0 sürümüyle geliştirilip test edilmiştir.

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ü 8.0.0.0.0 sürümü ile uyumluluğu doğrulandı
• Google Mobile Ads Flutter eklentisi 5.1.0 sürümü ile oluşturulup test edilmiştir.