Понятия
Реклама
Копировать страницу
Полноэкранные объявления в трех форматах, плюс баннеры и нативные объявления, которые Lia доки рядом с вашей страницей. Все воспроизводятся Lia и регулируются так, чтобы никто не был затоплен. Ваш сервер может проверить, действительно ли было просмотрено вознагражденное видео, прежде чем он что-либо даст.
#Три формата
| Формат | Что это | Когда использовать |
|---|---|---|
rewarded | Видео, которое человек выбирает посмотреть, за что-то в обмен. | "Посмотрите видео, чтобы получить второй шанс." |
rewardedInterstitial | Lia предлагает его сначала, с Watch и Skip, а затем играет за награду. | Награда в естественном перерыве, без вашей собственной кнопки. |
interstitial | Полноэкранная реклама между моментами, без чего-либо взамен. | Между раундами или уровнями. Lia устанавливает темп. |
Ваша страница спрашивает с помощью Lia.showAd({ format }), или сокращения Lia.showRewardedAd(), Lia.showRewardedInterstitialAd() и Lia.showInterstitialAd(). Lia загружает и воспроизводит рекламу поверх вашего приложения, с собственным загрузчиком во время загрузки, и приостанавливает ваше приложение, пока оно'закрыто.
#Что вы получаете обратно
Каждый вызов рекламы отвечает, когда реклама закрывается:
{ "watched": true, "shown": true, "adId": "ad_8e1c4b0f2a9d47c6b3e15a07" }| Поле | Значение |
|---|---|
watched | Награждающее видео было просмотрено до конца. Выдайте награду. Всегда false для интерстициала. |
shown | Реклама появилась на экране. |
adId | Реклама'id, для вашего сервера для проверки. Присутствует, когда watched истинно, и когда был показан интерстициал. |
reason | Почему там'нет вознаграждения, когда watched ложно. |
Причины, по которым'вы увидите:
| Причина | Значение |
|---|---|
cancelled | Они закрыли видео до конца. |
skipped | Они выбрали Пропустить, когда Lia предложил вознагражденную интерстициальную рекламу. |
no_ad | Реклама не была готова к показу. |
too_soon | Межигровое окно, и это не'не наступило его время еще. |
failed | Lia не может'не записывать просмотр. |
| Любое другое | Проблема подключения или сервера, например network. |
Если вознаграждающее видео останавливается посередине из-за проблемы на телефоне, Lia считает его просмотренным, чтобы никто не потерял вознаграждение из-за сломанного объявления.
#Какой использовать
- Между раундами и играми: промежуточные экраны. Они'короткие и закрываемые, и никому не нужно выбирать их. Звоните
Lia.showInterstitialAd()в конце каждого естественного перерыва (круг завершен, Играйте снова) и позволяют Lia решить, показывать ли его. - Награждающие видео только тогда, когда игрок просит за что-то в обмен: подсказка, второй шанс, дополнительный поворот, за кнопкой, которая так и говорит. Никогда не запускайте их по отдельности между раундами: длинное видео, которое кто-то не't выбрать — то, что заставляет людей покидать игру.
#Темп
Игры' интерстициалы имеют свою собственную ритмику, отдельную от Lia'свои объявления: по умолчанию максимум одно каждые 90 секунд, и только каждые 2nd раз, когда ваше приложение запрашивает (каждый 2nd раунд или игра). Команда Lia может настроить оба. Когда это не'не их очередь, showInterstitialAd() отвечает сразу с reason: "too_soon" и ничего не отображается. Просто продолжайте.
Награждающие видео не'не ускоряются, потому что люди выбирают их, и просмотр одного никогда не откладывает следующую интерстициальную рекламу.
#Ваши собственные объявления Google на вашей странице
Хотите рекламу внутри вашего контента, прокручивающуюся вместе с ним, как слот между строками ленты? Используйте свои собственные теги Google-рекламы (AdSense или Google Ad Manager) на вашей странице's HTML, как на любом сайте. Lia регистрирует свой веб-просмотр в Google's реклама SDK (the WebView API для рекламы), поэтому ваши теги предоставляются как встроенные рекламы, и:
- Google's рекламные фреймы загружаются внутри вашей страницы. Фреймы с других сайтов все еще блокируются, поэтому другие рекламные сети' теги не'не работает.
- Нажатие на объявление открывает его в Safari, и ваше приложение остается на месте.
- Деньги идут в ваш собственный аккаунт Google, в соответствии с вашими собственными политиками Google. Lia не'не учитываются при подсчете этих объявлений, и правило тестового режима ниже не'не покрывают их: используйте свою сеть'тестовые объявления, пока вы строите (в Ad Manager, Google'ваша образец единица
/6355419/Travel/Europe/France/Paris; в 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>Нужно Lia's приложение из следующего выпуска. The SDK демо имеет "Загрузите тестовую рекламу здесь" кнопка, которая делает именно это.
#Тестовые ключи всегда получают тестовые объявления
Пока ваше приложение открыто в тестовом режиме (разработчик и тестировщики, с вашим тестовым ключом), каждая реклама Lia, которая отображается в нем, является одной из Google'тестовые объявления: полноэкранные, баннеры и нативные, какие бы Lia ни были'свое настройка. Они'записано (/ads/verify по-прежнему отвечает за них), но никогда не учитывается в вашем приложении'номера или заработок. Режим в реальном времени показывает настоящие объявления.
#Проверка на вашем сервере
Для любого вознаграждения, которое имеет значение, не'не брать страницу's watched: true на его слово. Посылайте adId на ваш сервер, и он спрашивает Lia с POST /ads/verify:
{ "adId": "ad_8e1c4b0f2a9d47c6b3e15a07", "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "watched": true, "watchedAt": 1761998400000 }Проверьте, что watched истинно и playerId является игроком, который спрашивает. Lia не'не отметить рекламу как использованную, поэтому платите за каждую adId когда вы сами: используя ad:<adId> как ваш ключ вознаграждения делает это за вас. Награждающие видео, которые платят отображает весь поток.
#Следите за процессом
Пропустить onState чтобы услышать каждый этап, или слушать каждую рекламу с Lia.onAd(fn):
Lia.showRewardedAd({
onState: function (state) { // "loading", "showing", "closed"
if (state === "loading") pauseMusic();
if (state === "closed") resumeMusic();
},
});#Что мы рекомендуем для игр
Реклама, которая находится рядом с игрой, никогда не над ней:
- Баннер, прикрепленный на весь визит. Вызов
Lia.showBanner({ position: "top" })один раз, доLia.ready(), и ждите (или несколько секунд). Lia'загрузчик все еще покрывает вашу страницу, пока баннер прикрепляется, поэтому игрок никогда не видит, как меняется макет, и он остается на месте, пока играет. Lia'свои игры фиксируют его наверху: нижний край — это место для пальцев и кнопок, и игра, played by tilting или dragging, нуждается в свободной зоне для игры. - Рекламная строка внутри спокойного экрана, например, ваш дом или лобби, с вашим собственным тегом Google-рекламы (см. Ваши собственные объявления Google. Поместите его после экрана'свое содержимое, дайте ему место над вашими кнопками, пометьте его "Реклама", и показывает его только один раз, когда объявление заполнено. Никогда не помещайте его под доску, часы или кнопку, которую игроки нажимают спеша.
- Межигровое окно (
Lia.showInterstitialAd()), который Lia регулирует.
Оставьте нативную карту и лист ниже для приложений, где пауза действительно является паузой. В игре они появляются поверх действия.
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
});
});#Баннеры и нативная реклама
Поскольку SDK 1.7 ваше приложение также может показывать баннер и нативную рекламу в Lia'свой вид. AdMob может'не отображать объявление внутри веб-страницы, поэтому Lia отображает их нативно, рядом вашу страницу вместо того, чтобы быть внутри нее. Это'честный лимит, и он определяет, как они работают:
- Они никогда не покрывают ваше приложение. Прикрепленная реклама занимает место на вашей странице: веб-просмотр становится короче, поэтому ничего, что вы нарисовали, не находится под ней. Вашему макету нужно просто соответствовать высоте, которую она'даны (
100dvh, flexbox, или--lia-viewport-heightвсе следуют за ним). - Они могут'не прокручивать с вашим содержимым. Нативное представление, прикрепленное к месту в прокручиваемой странице, будет подтормаживать и смещаться, что выглядит сломанным. Поэтому'нет "реклама в моей ленте" слот: реклама находится на краю или появляется во время паузы.
| Вызов | Что Lia показывает | Хорошо для |
|---|---|---|
Lia.showBanner({ position: "bottom" }) | Адаптивная баннер внизу (или "top") край, обновляемый AdMob пока он'вверх. | Меню, лобби, длинные экраны для чтения. |
Lia.showNativeAd({ placement: "card" }) | Компактная карточка (иконка, заголовок, строка текста, кнопка) прикреплена к нижнему краю, с кнопкой закрытия. | Экран результатов, конец раунда. |
Lia.showNativeAd({ placement: "sheet" }) | Большая реклама с изображением или видео, в листе поверх вашего приложения, которое приостанавливается до тех пор, пока оно'закрыто. | Естественный промежуток, где полноэкранная реклама будет слишком много. |
// 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();Что они отвечают:
| Ответ | Значение |
|---|---|
{ shown: true, position, height } | Баннер активен, height высотой в пиксель (примерно 50 до 90). |
{ shown: true, placement, height? } | Нативная реклама активна (карточка с высотой), или лист был показан и теперь закрыт. |
{ shown: false, reason: "no_ad" } | Ничего не загружено вовремя. Продолжайте. |
{ shown: false, reason: "too_soon" } | Нативная реклама, и она не'не наступило его время еще. |
{ shown: false, reason: "off" } | The Lia команда выключила этот тип объявлений, для вашего приложения или для всех. |
Баннер и карточка делят нижний край. Пока карточка открыта, нижняя панель смещается (вы слышите "hidden") и возвращается, когда карточка закрывается. Верхний баннер остается.
Безопасные зоны следуют. На краю, где реклама прикреплена, Lia добавляет отступ вокруг нее (панель домой, вырез), поэтому она отправляет safeAreaChanged с той стороной на 0 и --lia-safe-area-inset-* обновление. В полноэкранном режиме верхняя панель находится под Lia'плавающие кнопки Закрыть и ⋯, и ваша страница начинается ниже (contentSafeArea.top становится 0).
Следите за процессом. Lia.banner и Lia.nativeAd сказать, что'вверх сейчас ({ visible, position | placement, height }), --lia-banner-height удерживает баннер'высота, и Lia.onBanner(fn) и Lia.onNativeAd(fn) слышит каждое изменение ("loading", "shown" / "showing", "failed", "hidden" / "closed").
Темп. Нативная реклама по крайней мере на минуту между каждым человеком (команда может изменить это), во всех приложениях. Баннеры не'не ускоряются, но не'не мигать ими включая и выключая: покажите один, где он может оставаться некоторое время. Ни один из них не учитывается в полноэкранной рекламе' темп.
#Что вы зарабатываете
Вы получаете 50% от того, что зарабатывают баннеры и нативные объявления в вашем приложении. Lia считает каждый объявление, которое показывает ваше приложение, и то, сколько оно зарабатывает, и ежемесячно зачисляет вашу долю на ваш собственный Lia баланс, с вашей долей продаж. См. Получение оплаты.
Автоматически переведено. Английский — источник истины. Читать на английском