Arabuluculuk

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:

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 bunların 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.

Her iş ortağı ağının adaptörünü uygulamanıza nasıl ekleyeceğinizle ilgili ayrıntılı bilgi için Android ve iOS bu ağların dokümanlarına bakın.

Reklamı hangi reklam ağı adaptör sınıfının yüklediğini kontrol etme

Aşağıdaki örnek kodda, 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, bu işlem iki kez yenilemeyi önler.

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

Yerel uyumlulaştırmayı uygularken göz önünde bulundurulması gereken 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.

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