Konsep
Iklan
Salin halaman
Iklan layar penuh dalam tiga format, plus banner dan iklan asli yang Lia dock di samping halaman Anda. Semua dimainkan oleh Lia dan diatur sehingga tidak ada yang terlalu banyak. Server Anda dapat memeriksa apakah video yang diberi hadiah benar-benar ditonton sebelum memberikan apa pun.
#Tiga format
| Format | Apa itu | Kapan menggunakannya |
|---|---|---|
rewarded | Sebuah video yang orang pilih untuk ditonton, untuk sesuatu dalam pertukaran. | "Tonton video untuk kesempatan kedua." |
rewardedInterstitial | Lia menawarkannya terlebih dahulu, dengan Watch dan Skip, lalu memainkannya untuk hadiah. | Sebuah hadiah di titik alami, tanpa tombol Anda sendiri. |
interstitial | Iklan layar penuh antara momen, tanpa apa pun dalam pertukaran. | Di antara putaran, Lia menentukan ritmenya. |
Halaman Anda bertanya dengan Lia.showAd({ format }), atau shortcut Lia.showRewardedAd(), Lia.showRewardedInterstitialAd() dan Lia.showInterstitialAd(). Lia memuat dan memainkan iklan di atas aplikasi Anda, dengan pemuatannya sendiri saat memuat, dan menghentikan aplikasi Anda sampai itu'ditutup.
#Apa yang Anda dapatkan kembali
Setiap panggilan iklan menjawab setelah iklan ditutup:
{ "watched": true, "shown": true, "adId": "ad_8e1c4b0f2a9d47c6b3e15a07" }| Bidang | Makna |
|---|---|
watched | Sebuah video berhadiah ditonton hingga selesai. Berikan hadiahnya. Selalu false untuk sebuah interstitial. |
shown | Iklan muncul di layar. |
adId | Iklan'id, untuk servermu memeriksa. Tampilkan saat watched benar, dan ketika interstitial ditampilkan. |
reason | Mengapa ada'tidak ada hadiah, ketika watched adalah false. |
Alasan Anda'Anda akan melihat:
| Alasan | Makna |
|---|---|
cancelled | Mereka menutup video sebelum selesai. |
skipped | Mereka memilih Lewati ketika Lia menawarkan interstitial berhadiah. |
no_ad | Tidak ada iklan yang siap ditampilkan. |
too_soon | Interstisial, dan itu tidak'tidak gilirannya belum. |
failed | Lia tidak bisa'tidak merekam tampilan. |
| Apa pun lainnya | Masalah koneksi atau server, seperti network. |
Jika video yang diberi hadiah berhenti bermain sebagian karena masalah di ponsel, Lia menghitungnya sebagai tayangan penuh sehingga tidak ada yang kehilangan hadiah karena iklan yang rusak.
#Yang mana yang digunakan
- Di antara putaran dan permainan: interstitial. Mereka'pendek dan dapat ditutup, dan tidak ada yang perlu memilih mereka. Panggil
Lia.showInterstitialAd()di setiap titik alami (permainan berakhir, Main lagi) dan biarkan Lia menentukan apakah satu akan ditampilkan. - Hanya video berhadiah ketika pemain meminta untuk sesuatu sebagai imbalan: petunjuk, kesempatan kedua, putaran tambahan, di balik tombol yang mengatakan demikian. Jangan pernah memainkan satu saja di antara putaran: video panjang seseorang tidak'tidak memilih adalah yang membuat orang meninggalkan permainan.
#Pacing
Permainan' interstitial memiliki pengaturan sendiri, terpisah dari Lia'miliknya iklan: secara default paling banyak satu setiap 90 detik, dan hanya setiap 2nd kali aplikasi Anda meminta (setiap 2nd putaran atau permainan). Tim Lia dapat menyesuaikan keduanya. Ketika tidak'giliran mereka, showInterstitialAd() jawaban langsung dengan reason: "too_soon" dan tidak ada yang ditampilkan. Lanjutkan saja.
Video berhadiah tidak'tidak diatur, karena orang memilih mereka, dan menonton satu tidak pernah menggeser interstitial berikutnya.
#Iklan Google Anda sendiri, di halaman Anda
Ingin iklan di dalam konten Anda, menggulir bersamanya, seperti slot di antara baris feed? Gunakan tag iklan Google Anda sendiri (AdSense atau Google Ad Manager) di halaman Anda's HTML, seperti di situs web mana pun. Lia mendaftarkan tampilan webnya ke Google's iklan SDK ( WebView API untuk Iklan), jadi tag Anda disajikan sebagai iklan dalam aplikasi, dan:
- Google's frame iklan dimuat di dalam halaman Anda. Frame dari situs lain masih diblokir, jadi jaringan iklan lain' tag tidak'bekerja.
- Klik iklan akan membuka di Safari, dan aplikasi Anda tetap di tempatnya.
- Uangnya masuk ke akun Google Anda sendiri, di bawah kebijakan Google Anda sendiri. Lia tidak'tidak menghitung atau berbagi iklan ini, dan aturan mode uji di bawah ini tidak'tidak menutupi mereka: gunakan jaringan Anda'iklan uji s saat Anda membangun (di Manajer Iklan, Google'unit contoh
/6355419/Travel/Europe/France/Paris; dalam AdSense,data-adtest="on").
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<div id="feed-ad"></div>
<script>
window.googletag = window.googletag || { cmd: [] };
googletag.cmd.push(function () {
googletag.defineSlot("/6355419/Travel/Europe/France/Paris", [300, 250], "feed-ad").addService(googletag.pubads());
googletag.enableServices();
googletag.display("feed-ad");
});
</script>Membutuhkan Lia'aplikasi mereka dari rilis berikutnya. Yang Demo SDK memiliki "Muat iklan uji di sini" tombol yang melakukan hal ini.
#Kunci uji selalu mendapatkan iklan uji
Sementara aplikasi Anda dijalankan dalam mode uji (pengembang dan penguji Anda, dengan kunci uji Anda), setiap iklan Lia yang ditampilkan di dalamnya adalah salah satu dari Google'iklan uji Lia: layar penuh, banner, dan native, apa pun Lia'pengaturan miliknya. Mereka'tercatat (/ads/verify masih menjawab untuk mereka) tetapi tidak pernah dihitung ke dalam aplikasi Anda'nomor atau pendapatan. Mode live menampilkan iklan nyata.
#Memeriksa di server Anda
Untuk setiap hadiah yang penting, tidak'tidak mengambil halaman's watched: true dengan katanya. Kirim adId ke server kamu, dan biarkan itu bertanya Lia dengan POST /ads/verify:
{ "adId": "ad_8e1c4b0f2a9d47c6b3e15a07", "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "watched": true, "watchedAt": 1761998400000 }Periksa bahwa watched benar dan playerId adalah pemain yang meminta. Lia tidak'tidak menandai iklan sebagai digunakan, jadi bayar setiap adId sekali diri Anda sendiri: menggunakan ad:<adId> sebagai kunci hadiah melakukannya untuk Anda. Iklan berhadiah yang membayar menunjukkan seluruh alur.
#Ikuti terus
Lewati onState untuk mendengar setiap tahap, atau mendengarkan setiap iklan dengan Lia.onAd(fn):
Lia.showRewardedAd({
onState: function (state) { // "loading", "showing", "closed"
if (state === "loading") pauseMusic();
if (state === "closed") resumeMusic();
},
});#Apa yang kami rekomendasikan untuk permainan
Iklan yang berada di samping permainan, tidak pernah di atasnya:
- Sebuah banner yang dipasang untuk seluruh kunjungan. Panggil
Lia.showBanner({ position: "top" })sekali, sebelumLia.ready(), dan tunggu (atau beberapa detik). Lia'loader masih menutupi halaman Anda saat banner terpasang, sehingga pemain tidak pernah melihat tata letak bergerak, dan tetap di tempatnya saat bermain. Lia'permainan sendiri menempelkan di bagian atas: tepi bawah adalah tempat jari dan tombol, dan permainan yang dimainkan dengan menggoyang atau menyeret membutuhkan area bermain yang bebas. - Baris iklan di layar tenang, seperti rumah atau lobby Anda, dengan tag iklan Google Anda sendiri (lihat Iklan Google Anda sendiri). Letakkan setelah layar'konten sendiri, beri ruang di atas tombol Anda, beri label "Iklan", dan tampilkan hanya sekali iklan telah mengisi. Jangan letakkan di bawah papan, jam, atau tombol yang ditekan pemain dengan terburu-buru.
- Interstisial antar putaran (
Lia.showInterstitialAd()) yang Lia atur.
Jaga kartu dan lembar bawaan di bawah ini untuk aplikasi di mana jeda benar-benar jeda. Dalam permainan, mereka muncul di atas tindakan.
Lia.init().then(function () {
var banner = Lia.showBanner({ position: "top" }).catch(function () {});
Promise.race([banner, new Promise(function (r) { setTimeout(r, 2500); })]).then(function () {
Lia.ready(); // the page shows with the banner's room already taken
});
});#Bingkai dan iklan asli
Sejak SDK 1.7 aplikasi Anda juga dapat menampilkan banner, dan iklan native di Lia'tampilan miliknya. AdMob dapat'tidak menampilkan iklan di dalam halaman web, jadi Lia menampilkan iklan ini secara native, di samping halaman Anda daripada di dalamnya. Itu'batas jujur s, dan itu membentuk cara mereka bekerja:
- Mereka tidak pernah menutupi aplikasi Anda. Iklan yang terkunci mengambil ruang dari halaman Anda: tampilan web menjadi lebih pendek, jadi apa pun yang Anda gambar tidak berada di bawahnya. Tata letak Anda hanya perlu sesuai dengan tinggi yang'telah memberikan (
100dvh, flexbox, atau--lia-viewport-heightsemua mengikuti itu). - Mereka bisa'tidak menggulir dengan konten Anda. Sebuah tampilan asli yang dipasang di suatu tempat di halaman yang bergerak akan melambat dan bergeser, yang terlihat rusak. Jadi'tidak "iklan di feed saya" slot: iklan berada di tepi, atau muncul saat jeda.
| Panggil | Apa yang ditampilkan Lia | Baik untuk |
|---|---|---|
Lia.showBanner({ position: "bottom" }) | Banner adaptif di bagian bawah (atau "top") tepi, diperbarui oleh AdMob sementara itu'siap. | Menu, lobi, layar baca panjang. |
Lia.showNativeAd({ placement: "card" }) | Kartu kompak (ikon, judul, satu baris teks, tombolnya) terkunci di tepi bawah, dengan tombol tutup. | Sebuah layar hasil, akhir dari putaran. |
Lia.showNativeAd({ placement: "sheet" }) | Iklan yang lebih besar dengan gambar atau video, dalam lembaran di atas aplikasi Anda, yang dijeda hingga itu'ditutup. | Pembagian alami di mana iklan layar penuh terlalu banyak. |
// A results screen: a sponsored card under it while it's up.
showResults();
Lia.showNativeAd({ placement: "card" }); // { shown: true, placement: "card", height: 118 }, or { shown: false, reason }
// The next round: the card goes, and the page gets its room back.
Lia.hideNativeAd();Apa yang mereka jawab:
| Jawaban | Makna |
|---|---|
{ shown: true, position, height } | Bendera sudah aktif, height tinggi (sekitar 50 hingga 90). |
{ shown: true, placement, height? } | Iklan asli sudah aktif (sebuah kartu, dengan tingginya), atau lembaran ditampilkan dan sekarang ditutup. |
{ shown: false, reason: "no_ad" } | Tidak dimuat dalam waktu. Lanjutkan. |
{ shown: false, reason: "too_soon" } | Iklan asli, dan itu tidak'tidak gilirannya belum. |
{ shown: false, reason: "off" } | The Lia tim mematikan jenis iklan ini, untuk aplikasi Anda atau untuk semua orang. |
Banner dan kartu berbagi tepi bawah. Sementara kartu muncul, banner bawah bergeser (Anda mendengar "hidden") dan kembali ketika kartu ditutup. Banner atas tetap ada.
Area aman berikutnya. Di tepi tempat iklan terdok, Lia memberi ruang di sekitarnya (bar rumah, notch), sehingga mengirim safeAreaChanged dengan sisi itu pada 0 dan --lia-safe-area-inset-* pembaruan. Dalam mode layar penuh, banner atas berada di bawah Lia'tombol Close dan ⋯ yang mengambang, dan halaman Anda mulai di bawahnya (contentSafeArea.top menjadi 0).
Ikuti terus. Lia.banner dan Lia.nativeAd katakan apa'siap sekarang ({ visible, position | placement, height }), --lia-banner-height menyimpan banner'tinggi header, dan Lia.onBanner(fn) dan Lia.onNativeAd(fn) mendengar setiap perubahan ("loading", "shown" / "showing", "failed", "hidden" / "closed").
Pacing. Iklan asli setidaknya satu menit terpisah untuk setiap orang (tim dapat mengubahnya), di semua aplikasi. Banners tidak'tidak diatur, tapi tidak'tidak menyalakan dan mematikan mereka: tunjukkan satu di mana mereka bisa tinggal sejenak. Keduanya tidak dihitung dalam iklan layar penuh' pemrosesan.
#Apa yang Anda peroleh
Anda mendapatkan 50% dari apa yang iklan di aplikasi Anda hasilkan, termasuk banner dan iklan native. Lia menghitung setiap iklan yang ditampilkan aplikasi Anda dan pendapatan yang diperoleh, dan membayar bagian Anda bulanan ke saldo Lia Anda sendiri, dengan bagian Anda dari penjualan. Lihat Mendapatkan pembayaran.
Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris