Iklan banner yang dapat diciutkan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Iklan banner yang dapat diciutkan adalah iklan banner yang awalnya ditampilkan sebagai overlay yang lebih besar, dengan tombol untuk menciutkannya ke ukuran banner yang diminta semula.
Iklan banner yang dapat diciutkan dimaksudkan untuk meningkatkan performa iklan anchor yang berukuran lebih kecil. Panduan ini menunjukkan cara mengaktifkan iklan banner yang dapat diciutkan untuk penempatan banner yang ada.
Prasyarat
Penerapan
Pastikan tampilan banner Anda ditentukan dengan ukuran yang Anda inginkan agar pengguna melihatnya
dalam keadaan banner biasa (diciutkan). Sertakan parameter tambahan dalam permintaan iklan dengan collapsible sebagai kunci dan penempatan iklan sebagai nilai.
Penempatan yang dapat diciutkan menentukan cara wilayah yang diluaskan ditambatkan ke iklan banner.
Nilai Placement
|
Perilaku |
Kasus penggunaan yang dimaksudkan |
top |
Bagian atas iklan yang diluaskan sejajar dengan bagian atas iklan yang diciutkan. |
Iklan ditempatkan di bagian atas layar. |
bottom |
Bagian bawah iklan yang diperluas sejajar dengan bagian bawah iklan yang diciutkan. |
Iklan ditempatkan di bagian bawah layar. |
Jika iklan yang dimuat adalah banner yang dapat diciutkan, banner akan menampilkan overlay yang dapat diciutkan segera setelah ditempatkan dalam hierarki tampilan.
private void LoadBannerAd()
{
var bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Bottom);
var adRequest = new AdRequest();
// Create an extra parameter that aligns the bottom of
// the expanded ad to the bottom of the bannerView.
adRequest.Extras.Add("collapsible", "bottom");
bannerView.LoadAd(adRequest);
}
Perilaku pembaruan iklan
Untuk aplikasi yang mengonfigurasi pemuatan ulang otomatis untuk iklan banner di antarmuka web Ad Manager, saat iklan banner yang dapat diciutkan diminta untuk slot banner, pemuatan ulang iklan berikutnya tidak akan meminta iklan banner yang dapat diciutkan. Hal ini karena menampilkan banner yang dapat diciutkan pada setiap pemuatan ulang dapat berdampak negatif pada pengalaman pengguna.
Jika ingin memuat iklan banner lain yang dapat diciutkan nanti di sesi yang sama, Anda dapat
memuat iklan secara manual menggunakan permintaan yang berisi parameter "collapsible".
Memeriksa apakah iklan yang dimuat dapat diciutkan
Iklan banner yang tidak dapat diciutkan memenuhi syarat untuk ditampilkan sebagai respons terhadap permintaan iklan banner yang dapat diciutkan guna memaksimalkan performa. Panggil isCollapsible untuk memeriksa apakah banner terakhir yang dimuat dapat diciutkan. Jika permintaan gagal dimuat dan banner sebelumnya dapat diciutkan, API akan menampilkan nilai benar (true).
_bannerView.OnBannerAdLoaded += () =>
{
Debug.Log(_bannerView.IsCollapsible()
? "Banner is collapsible."
: "Banner is not collapsible.");
};
Iklan banner yang dapat diciutkan hanya tersedia untuk permintaan Google. Iklan yang ditayangkan melalui mediasi ditampilkan sebagai iklan banner normal yang tidak dapat diciutkan.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-09-02 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-02 UTC."],[[["\u003cp\u003eCollapsible banner ads, initially larger overlays, collapse to the requested banner size, enhancing smaller anchored ad performance.\u003c/p\u003e\n"],["\u003cp\u003eTo implement, define your banner view's collapsed size and include an extra parameter in the ad request, specifying placement (\u003ccode\u003etop\u003c/code\u003e or \u003ccode\u003ebottom\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eWhile auto-refresh is configured, subsequent refreshes won't request collapsible banners to maintain user experience; manual loading is needed.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003eisCollapsible\u003c/code\u003e to verify if the loaded banner is indeed collapsible, helpful when requests fail.\u003c/p\u003e\n"],["\u003cp\u003eDuring the beta period, collapsible banners are exclusive to Google demand, with mediated ads appearing as standard banners.\u003c/p\u003e\n"]]],["Collapsible banner ads display as a large overlay initially, then collapse to the standard banner size. To enable this, include an \"extras\" parameter with \"collapsible\" as the key and the placement (\"top\" or \"bottom\") as the value in the ad request. Refreshed ads in automated cases will not be collapsible. To load a new collapsible banner, make a manual request with the \"collapsible\" parameter. To confirm if a loaded banner is collapsible, check using `isCollapsible`. Collapsible ads are only supported for Google demand.\n"],null,["Select platform: [Android](/ad-manager/mobile-ads-sdk/android/banner/collapsible \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/banner/collapsible \"View this page for the iOS platform docs.\") [Unity](/ad-manager/mobile-ads-sdk/unity/banner/collapsible \"View this page for the Unity platform docs.\") [Flutter](/ad-manager/mobile-ads-sdk/flutter/banner/collapsible \"View this page for the Flutter platform docs.\")\n\n\u003cbr /\u003e\n\nCollapsible banner ads are banner ads that are initially presented as a larger\noverlay, with a button to collapse them to the originally requested banner size.\nCollapsible banner ads are intended to improve performance of anchored ads that\nare otherwise a smaller size. This guide shows how to turn on collapsible banner\nads for existing banner placements.\n\nPrerequisites\n\n- Complete the [banner ads get started guide](/ad-manager/mobile-ads-sdk/unity/banner).\n\nImplementation\n\nMake sure your banner view is defined with the size you would like users to see\nin the regular (collapsed) banner state. Include an extras parameter in the ad\nrequest with `collapsible` as the key and the placement of the ad as the value.\n\nThe collapsible placement defines how the expanded region anchors to the banner\nad.\n\n| `Placement` value | Behavior | Intended use case |\n|-------------------|-------------------------------------------------------------------------|-----------------------------------------------|\n| `top` | The top of the expanded ad aligns to the top of the collapsed ad. | The ad is placed at the top of the screen. |\n| `bottom` | The bottom of the expanded ad aligns to the bottom of the collapsed ad. | The ad is placed at the bottom of the screen. |\n\nIf the loaded ad is a collapsible banner, the banner shows the collapsible\noverlay immediately once it's placed in the view hierarchy.\n\n private void LoadBannerAd()\n {\n var bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Bottom);\n\n var adRequest = new AdRequest();\n\n // Create an extra parameter that aligns the bottom of\n // the expanded ad to the bottom of the bannerView.\n adRequest.Extras.Add(\"collapsible\", \"bottom\");\n\n bannerView.LoadAd(adRequest);\n }\n\n\u003cbr /\u003e\n\nAds refreshing behavior\n\nFor apps that configure auto-refresh for banner ads in the\nAd Manager web interface, when a collapsible banner ad\nis requested for a banner slot, subsequent ad refreshes won't request\ncollapsible banner ads. This is because showing a collapsible banner on every\nrefresh could have a negative impact on user experience.\n\nIf you want to load another collapsible banner ad later in the session, you can\nload an ad manually with a request containing the collapsible parameter.\n\nCheck if a loaded ad is collapsible\n\nNon-collapsible banner ads are eligible to return for collapsible banner\nrequests to maximize performance. Call `isCollapsible` to check if the last\nbanner loaded is collapsible. If the request fails to load and the previous\nbanner is collapsible, the API returns true. \n\n _bannerView.OnBannerAdLoaded += () =\u003e\n {\n Debug.Log(_bannerView.IsCollapsible()\n ? \"Banner is collapsible.\"\n : \"Banner is not collapsible.\");\n };\n\n\nMediation\n\nCollapsible banner ads are only available for Google demand. Ads served through\nmediation show as normal, non-collapsible banner ads."]]
