Uyumlulaştırmayı ayarlama

Platform seçin: Android iOS Unity Flutter Android (Eski)

Bu kılavuzda, uyumlulaştırma bağdaştırıcısını Flutter uygulamanıza nasıl entegre edeceğiniz gösterilmektedir.

Ön koşullar

Bir reklam biçimi için arabuluculuğu entegre etmeden önce söz konusu reklam biçimini uygulamanıza entegre etmeniz gerekir:

Uyumlulaştırmayı ilk kez mi kullanıyorsunuz? Uyumlulaştırmaya giriş başlıklı makaleyi okuyun.

Başlat Google Mobile Ads Flutter Plugin

Hızlı başlangıç kılavuzunda, Google Mobile Ads Flutter Plugin'i nasıl başlatacağınız gösterilmektedir. Bu başlatma çağrısı sırasında uyumlulaştırma bağdaştırıcıları da başlatılır. İlk reklam isteğinde her reklam ağının tam katılımını doğrulamak için reklamları yüklemeden önce başlatma işleminin tamamlanmasını beklemeniz önemlidir.

Aşağıdaki örnek kodda, reklam isteği göndermeden önce her bir bağdaştırıcının başlatma durumunu nasıl kontrol edebileceğiniz gösterilmektedir.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

Gradle ayarlarınızı güncelleyin (yalnızca Android)

Eklentinin Android API'lerini kullanabilmek için settings.gradle dosyanıza aşağıdaki satırları ekleyin:

def flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

İş ortağı ağları için bağımlılık ekleme

Uyumlulaştırma bağdaştırıcılarının ve bağımlılıklarının Android ve iOS projelerinize eklenmesi gerekir. Bu izinler, Android'de uygulama düzeyindeki build.gradle dosyanız ve iOS'te Podfile dosyası güncellenerek eklenebilir. Google'ın GitHub'da hem Android hem de iOS için açık kaynak bağdaştırıcıları vardır.

İş ortağı ağlarının bağdaştırıcılarını uygulamanıza nasıl ekleyeceğinizle ilgili ayrıntılı bilgi için her bir iş ortağı ağının Android ve iOS dokümanlarına bakın.

Reklamı hangi reklam ağı bağdaştırıcı sınıfının yüklediğini kontrol etme

Aşağıdaki örnek kodda, bir banner reklam için reklam ağı sınıf adının nasıl günlüğe kaydedileceği gösterilmektedir:

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

Uyumlulaştırmada kullanılan banner reklam birimleri için tüm üçüncü taraf reklam kaynağı kullanıcı arayüzlerinde yenilemeyi devre dışı bıraktığınızdan emin olun. Bu, Ad Manager da banner reklam biriminizin yenileme hızına göre yenilemeyi tetiklediğinden çift yenilemeyi önler.

Uyumlulaştırma ile doğal reklamları kullanma

Doğal uyumlulaştırmayı uygularken göz önünde bulundurmanız gereken bazı en iyi uygulamalar aşağıda verilmiştir.

Doğal reklam sunumu politikası
Her reklam ağının kendi politikaları vardır. Uyumlulaştırma kullanırken uygulamanızın, reklamı sağlayan uyumlulaştırılmış ağın politikalarına uyması gerektiğini unutmayın.

ABD eyalet gizlilik yasaları ve GDPR

ABD eyalet gizlilik yasalarına veya Genel Veri Koruma Yönetmeliği'ne (GDPR) uymanız gerekiyorsa uyumlulaştırma iş ortaklarınızı Ad Manager Gizlilik ve Mesajlaşma'nın ABD eyaletleri veya GDPR reklam iş ortakları listesine eklemek için ABD eyalet tüzükleri ayarları ya da GDPR ayarları bölümündeki adımları uygulayın. Bunu yapmamanız, iş ortaklarının uygulamanızda reklam yayınlayamamasına neden olabilir.

Google Kullanıcı Mesajlaşma Platformu (UMP) SDK'sı ile kısıtlanmış veri işlemeyi (KVİ) etkinleştirme ve GDPR izni alma hakkında daha fazla bilgi edinin.

Sonraki
Reklam kaynaklarını seçme