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 makalede, ironSource Ads'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve ironSource Ads SDK'sının ve bağdaştırıcının bir uygulamaya nasıl entegre edileceği ele alınmaktadır. Flutter

Desteklenen entegrasyonlar ve reklam biçimleri

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

¹ 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
• [Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek üzere IronSource 3.0.0 veya sonraki sürümler için Google Mobile Ads uyumlulaştırma eklentisini kullanın (en son sürüm önerilir)
• Android'de dağıtmak için
  • Android API düzeyi 21 veya sonraki sürümler
• iOS'te dağıtmak için
  • 12.0 veya sonraki bir iOS dağıtım hedefi
• Google Mobile Ads SDK'sı ile yapılandırılmış Flutter çalışan bir 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ı doldurup Uygulama Ekle'yi tıklayın.

Uygulama eklendikten sonra gösterilen 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.

Örnek oluştur

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

Raporlama API'si anahtarınızı bulma

Test modunu etkinleştirme

ironSource Ads test reklamlarını etkinleştirmeyle ilgili ironSource Ads entegrasyon testi kılavuzundaki talimatları uygulayın.

2. Adım: ironSource reklam talebini AdMob kullanıcı arayüzünde ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

ironSource Mobile 'i GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

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

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

pub.dev üzerinden 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/")
      }
  }

Paketinizin pubspec.yaml dosyasına ironSource Ads SDK'sının ve bağdaştırıcının en son sürümleriyle aşağıdaki bağımlılığı ekleyin:

dependencies:
  gma_mediation_ironsource: ^1.0.0

Manuel Entegrasyon

ironSource Ads için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı ayıklayı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 referans verin:

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

4. Adım: ironSource Ads SDK'sında gizlilik ayarlarını uygulayın

AB Kullanıcı Rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.

ironSource Ads için Google Mobile Ads uyumlulaştırması eklentisinin 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 ironSource Ads'in Düzenleme Gelişmiş Ayarları ile ilgili dokümanlarını inceleyin.

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ı 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 her reklam ağı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

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

6. adım: Uygulamanızı test edin

Test reklamlarını etkinleştirme

AdMob için test cihazınızı kaydettiğinizden ve ironSource Ads kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.

Test reklamlarını doğrulama

ironSource Ads'den test reklamları aldığınızı doğrulamak için ironSource Ads (Teklifli Sistem) ve ironSource Ads (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

Hata kodları

Adaptör, ironSource Ads'den reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

Bir reklam yüklenemezse ironSource Ads bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar şunlardır:

ironSource Flutter Uyumlulaştırma Adaptörü Değişiklik Günlüğü

Sonraki Sürüm

• Google Mobile Ads Flutter eklentisi 5.2.0 sürümü ile oluşturulup test edilmiştir.

1.1.0

• ironSource Android adaptörü 8.2.1.0 sürümü ile uyumluluğu 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ü ile oluşturulup test edilmiştir.

1.0.0

• İlk sürüm.
• ironSource Android adaptörü 8.0.0.0 sürümüyle uyumluluğu 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.