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

.

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

pub.dev aracılığıyla entegrasyon

(Yalnızca Android) Aşağıdaki depoları içindeki build.gradle dosyasına ekleyin projenizin android dizini:

  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, pubspec.yaml dosyasını yüklemek için şu bağımlılığı ekleyin:

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

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