Halaman ini diterjemahkan oleh Cloud Translation API.

Banner adaptif anchor

Banner adaptif adalah generasi berikutnya dari iklan responsif, yang memaksimalkan performa iklan dengan mengoptimalkan ukuran iklan untuk setiap perangkat. Meningkatkan kualitas banner cerdas, yang hanya mendukung ketinggian tetap, banner adaptif memungkinkan Anda menentukan lebar iklan dan menggunakan ini untuk menentukan ukuran iklan yang optimal.

Untuk memilih ukuran iklan terbaik, banner adaptif menggunakan rasio aspek tetap, bukan tinggi tetap. Hal ini menghasilkan iklan banner yang mengisi bagian yang lebih konsisten layar di seluruh perangkat dan memberikan peluang untuk peningkatan tingkat tinggi.

Saat menggunakan banner adaptif, perhatikan bahwa banner tersebut akan selalu menampilkan yang konstan untuk perangkat dan lebar tertentu. Setelah Anda menguji tata letak pada perangkat tertentu, Anda dapat yakin bahwa ukuran iklan tidak akan berubah. Namun, ukuran materi iklan banner dapat berubah di berbagai perangkat. Oleh karena itu, sebaiknya tata letak Anda mengakomodasi variasi tinggi iklan. Dalam kasus yang jarang terjadi, ukuran adaptif penuh mungkin tidak terisi dan materi iklan ukuran standar akan di tengah slot ini.

Prasyarat

Ikuti petunjuk dari Panduan memulai tentang cara Mengimpor plugin Flutter Mobile Ads.

Kapan harus menggunakan banner adaptif

Banner adaptif didesain sebagai pengganti langsung untuk kedua industri ukuran banner standar 320x50 dan format banner cerdas yang akan digantikan.

Ukuran banner ini biasa digunakan sebagai banner anchor, yang biasanya terkunci di bagian atas atau bawah layar.

Untuk banner anchor tersebut, rasio aspek saat menggunakan banner adaptif akan menjadi mirip dengan iklan standar berukuran 320x50, seperti yang dapat dilihat di tiga contoh di bawah ini:

Banner 320x50

Banner adaptif

Banner cerdas

Banner adaptif memanfaatkan ukuran layar yang tersedia dengan lebih baik. Selain itu, dibandingkan dengan banner cerdas, banner adaptif adalah pilihan yang lebih baik karena:

Diagram ini menggunakan lebar apa pun yang Anda berikan, bukan memaksa lebar menjadi penuh yang memungkinkan Anda memperhitungkan area aman di iOS, dan menampilkan potongan di Android.
Fitur ini memilih ketinggian optimal untuk perangkat tertentu, alih-alih memiliki tinggi konstan di seluruh perangkat dengan ukuran yang berbeda, mengurangi efek dari fragmentasi perangkat.

Catatan penerapan

Saat menerapkan banner adaptif di aplikasi, perhatikan hal-hal berikut:

Anda harus mengetahui lebar tampilan tempat iklan akan ditempatkan, dan ini harus memperhitungkan lebar perangkat dan area aman atau potongan yang berlaku.
Pastikan latar belakang tampilan iklan Anda buram agar sesuai dengan Kebijakan AdMob ketika ukuran iklan yang lebih kecil ditayangkan tidak mengisi slot iklan.
Pastikan Anda menggunakan Google Mobile Ads Flutter versi terbaru plugin.
Ukuran banner adaptif dirancang agar berfungsi dengan sangat baik saat menggunakan banner lebar yang tersedia. Dalam kebanyakan kasus, ini akan selebar penuh layar perangkat yang digunakan. Pastikan untuk mempertimbangkan area aman yang berlaku.
Google Mobile Ads SDK akan menyesuaikan ukuran banner dengan tinggi iklan yang dioptimalkan untuk lebar tertentu saat menggunakan AdSize API adaptif.
Ada dua metode guna mendapatkan ukuran iklan untuk adaptif: AdSize.getAnchoredAdaptiveBannerAdSize(Orientation orientation, int width) untuk meminta orientasi tertentu, dan AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width) untuk orientasi saat ini pada saat eksekusi.
Ukuran yang dikembalikan untuk lebar tertentu pada perangkat tertentu akan selalu berupa hal yang sama, maka setelah menguji tata letak pada perangkat tertentu, Anda bisa memastikan bahwa ukuran iklan tidak akan berubah.
Tinggi banner anchor tidak pernah lebih besar dari kurang dari 15% tinggi banner tinggi perangkat atau 90 piksel kepadatan mandiri dan tidak pernah lebih kecil dari 50 piksel kepadatan mandiri.

Panduan memulai

Ikuti langkah-langkah di bawah untuk menerapkan banner adaptif anchor sederhana.

Dapatkan ukuran iklan banner adaptif. Ukuran yang Anda dapatkan akan digunakan untuk meminta banner adaptif. Untuk mendapatkan ukuran iklan adaptif, pastikan Anda:
1. Dapatkan lebar perangkat yang digunakan dalam piksel kepadatan mandiri, atau setel lebar Anda sendiri jika Anda tidak ingin menggunakan lebar penuh layar. Anda dapat menggunakan MediaQuery.of(context) untuk mendapatkan lebar layar.
2. Gunakan metode statis yang sesuai pada kelas ukuran iklan, seperti AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width) guna mendapatkan objek AdSize adaptif untuk orientasi saat ini.
Buat objek BannerAd dengan ID unit iklan, ukuran iklan adaptif, dan objek permintaan iklan.
Muat iklan seperti iklan banner standar dan tampilkan dari AdWidget seperti halnya tampilan iklan biasa.

Contoh kode

Berikut ini contoh widget yang memuat banner adaptif anchor agar sesuai dengan lebar layar:

import 'dart:io';

import 'package:flutter/material.dart';
import 'package:google_mobile_ads/google_mobile_ads.dart';

/// This example demonstrates anchored adaptive banner ads.
class AnchoredAdaptiveExample extends StatefulWidget {
  @override
  _AnchoredAdaptiveExampleState createState() =>
      _AnchoredAdaptiveExampleState();
}

class _AnchoredAdaptiveExampleState extends State<AnchoredAdaptiveExample> {
  BannerAd? _anchoredAdaptiveAd;
  bool _isLoaded = false;

  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    _loadAd();
  }

  Future<void> _loadAd() async {
    // Get an AnchoredAdaptiveBannerAdSize before loading the ad.
    final AnchoredAdaptiveBannerAdSize? size =
        await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
            MediaQuery.of(context).size.width.truncate());

    if (size == null) {
      print('Unable to get height of anchored banner.');
      return;
    }

    _anchoredAdaptiveAd = BannerAd(
      // TODO: replace these test ad units with your own ad unit.
      adUnitId: Platform.isAndroid
          ? 'ca-app-pub-3940256099942544/6300978111'
          : 'ca-app-pub-3940256099942544/2934735716',
      size: size,
      request: AdRequest(),
      listener: BannerAdListener(
        onAdLoaded: (Ad ad) {
          print('$ad loaded: ${ad.responseInfo}');
          setState(() {
            // When the ad is loaded, get the ad size and use it to set
            // the height of the ad container.
            _anchoredAdaptiveAd = ad as BannerAd;
            _isLoaded = true;
          });
        },
        onAdFailedToLoad: (Ad ad, LoadAdError error) {
          print('Anchored adaptive banner failedToLoad: $error');
          ad.dispose();
        },
      ),
    );
    return _anchoredAdaptiveAd!.load();
  }

  @override
  Widget build(BuildContext context) => Scaffold(
        appBar: AppBar(
          title: Text('Anchored adaptive banner example'),
        ),
        body: Center(
          child: Stack(
            alignment: AlignmentDirectional.bottomCenter,
            children: <Widget>[
              ListView.separated(
                  padding: const EdgeInsets.symmetric(horizontal: 16.0),
                  itemBuilder: (context, index) {
                    return Text(
                      'Placeholder text',
                      style: TextStyle(fontSize: 24),
                    );
                  },
                  separatorBuilder: (context, index) {
                    return Container(height: 40);
                  },
                  itemCount: 20),
              if (_anchoredAdaptiveAd != null && _isLoaded)
                Container(
                  color: Colors.green,
                  width: _anchoredAdaptiveAd!.size.width.toDouble(),
                  height: _anchoredAdaptiveAd!.size.height.toDouble(),
                  child: AdWidget(ad: _anchoredAdaptiveAd!),
                )
            ],
          ),
        ),
      );

  @override
  void dispose() {
    super.dispose();
    _anchoredAdaptiveAd?.dispose();
  }
}

Di sini, fungsi AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize digunakan untuk mendapatkan ukuran banner di posisi anchor untuk antarmuka saat ini orientasi. Untuk melakukan pramuat banner anchor dalam orientasi tertentu, gunakan AdSize.getAnchoredAdaptiveBannerAdSize(Orientation orientation, int width) dan meneruskan orientasi yang diinginkan.

Contoh lengkap di GitHub

Untuk melihat contoh lengkap, lihat repositori GitHub Contoh Banner kami.