Uyumlulaştırma

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

Ön koşullar

Bir reklam biçimi için arabuluculuğu entegre edebilmek üzere önce bu reklam biçimini uygulamanıza entegre etmeniz gerekir:

• Banner Reklamlar
• Geçiş reklamları
• Yerel Reklamlar
• Ödüllü Reklamlar
• Ödüllü Geçiş Reklamları

Uyumlulaştırma konusunda yeni misiniz? Uyumlulaştırmayla ilgili giriş bölümünü okuyun.

Mobile Ads SDK'sını ilk kullanıma hazırlayın

Hızlı başlangıç kılavuzunda, Mobile Ads SDK'sını nasıl ilk kullanıma hazırlayacağınız gösterilmektedir. Bu ilk kullanıma hazırlama ç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ı sağlamak için reklamları yüklemeden önce ilklendirmenin tamamlanmasını beklemek önemlidir.

Aşağıdaki örnek kodda, reklam isteği göndermeden önce her adaptörü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üncelleme (yalnızca Android)

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

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

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

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

Uyumlulaştırma aracını uygulamanıza nasıl ekleyeceğinizle ilgili ayrıntılı bilgi için her iş ortağı ağının Androidve iOS dokümanlarına bakın.

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

Aşağıdaki örnek kodda, bir banner reklamın reklam ağı sınıf adının nasıl 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(),
    );

Uyumlaştırma ile banner reklamları kullanma

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. Ad Manager, banner reklam biriminizin yenileme hızına göre de yenileme tetikler. Bu nedenle, iki kez yenileme yapılmasını önler.

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

Yerel uyumlulaştırmayı uygularken göz önünde bulundurabileceğiniz bazı en iyi uygulamalar aşağıda verilmiştir.

Yerel reklam sunumu politikası

Her reklam ağının kendi politikaları vardır. Uyumlulaştırma kullanılırken uygulamanızın, reklamı sağlayan uyumlulaştırılmış ağın politikalarına uymaya devam etmesi 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 Ad Manager Gizlilik ve Mesajlaşma'nın ABD eyaletleri veya GDPR reklam iş ortakları listesine uyumlulaştırma iş ortaklarınızı eklemek için ABD eyalet yönetmelikleri ayarlarındaki veya GDPR ayarlarındaki adımları uygulayın. Aksi takdirde iş ortaklarınız uygulamanızda reklam yayınlayamayabilir.