概念

格式	它是什么	何时使用
`rewarded`	一个人选择观看的视频，作为回报。	"观看视频以获得第二次机会。"
`rewardedInterstitial`	Lia首先提供它，有观看和跳过，然后播放它以获得奖励。	在自然暂停时获得的奖励，无需您自己的按钮。
`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（WebView API 的广告），所以你的标签作为应用内广告提供，并且：

谷歌's 广告框架加载在你的页面内。 来自其他网站的框架仍然被阻止，因此其他广告网络' 标签赢了'工作。
点击广告会在 Safari 中打开，并且你的应用保持在原位。
钱会进入你自己的谷歌账户，在您自己的Google政策下。Lia 不't 计数或分享这些广告，以及下面的测试模式规则不't 覆盖它们：使用你的网络'的测试广告，你在构建时（在广告管理器中，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 应用从下一个版本开始。那 SDK 示例有一个 "在此处加载测试广告" 执行此操作的按钮。

#测试密钥总是获得测试广告

当你的应用处于测试模式（其开发者和测试人员，使用你的测试密钥），每个广告Lia显示的都是谷歌'的测试广告：全屏、横幅和原生广告，无论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'自己的游戏将其固定在顶部：底部边缘是手指和按钮所在的位置，而通过倾斜或拖动进行的游戏需要其游戏区域保持自由。
一个广告行在平静的屏幕上，例如您的家庭或大厅，使用您自己的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 在它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` px 高（约 50 到 90）。
`{ shown: true, placement, height? }`	原生广告已上线（一张卡片，带有其高度），或者表单已显示并现在关闭。
`{ shown: false, reason: "no_ad" }`	未及时加载。继续吧。
`{ shown: false, reason: "too_soon" }`	一个原生广告，而且它不'不要轮到它了。
`{ shown: false, reason: "off" }`	的 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 余额中，包括您的销售分成。参见获得报酬.

自动翻译。英语是真实来源。阅读英文

广告

#三种格式