LiaРазработчики

Понятия

Полноэкранные объявления в трех форматах, плюс баннеры и нативные объявления, которые Lia доки рядом с вашей страницей. Все воспроизводятся Lia и регулируются так, чтобы никто не был затоплен. Ваш сервер может проверить, действительно ли было просмотрено вознагражденное видео, прежде чем он что-либо даст.

#Три формата

ФорматЧто этоКогда использовать
rewardedВидео, которое человек выбирает посмотреть, за что-то в обмен."Посмотрите видео, чтобы получить второй шанс."
rewardedInterstitialLia предлагает его сначала, с 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Межигровое окно, и это не'не наступило его время еще.
failedLia не может'не записывать просмотр.
Любое другоеПроблема подключения или сервера, например 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();
  },
});

#Что мы рекомендуем для игр

Реклама, которая находится рядом с игрой, никогда не над ней:

  1. Баннер, прикрепленный на весь визит. Вызов Lia.showBanner({ position: "top" }) один раз, до Lia.ready(), и ждите (или несколько секунд). Lia'загрузчик все еще покрывает вашу страницу, пока баннер прикрепляется, поэтому игрок никогда не видит, как меняется макет, и он остается на месте, пока играет. Lia'свои игры фиксируют его наверху: нижний край — это место для пальцев и кнопок, и игра, played by tilting или dragging, нуждается в свободной зоне для игры.
  2. Рекламная строка внутри спокойного экрана, например, ваш дом или лобби, с вашим собственным тегом Google-рекламы (см. Ваши собственные объявления Google. Поместите его после экрана'свое содержимое, дайте ему место над вашими кнопками, пометьте его "Реклама", и показывает его только один раз, когда объявление заполнено. Никогда не помещайте его под доску, часы или кнопку, которую игроки нажимают спеша.
  3. Межигровое окно (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 баланс, с вашей долей продаж. См. Получение оплаты.

Автоматически переведено. Английский — источник истины. Читать на английском

Введите, чтобы искать по каждой странице, методу и точке окончания.