共计 4069 个字符，预计需要花费 11 分钟才能阅读完成。
移动广告插件使用指南
概述
此插件允许游戏在 Android 和 iOS 导出时使用 Admob 横幅广告、插页式广告、激励广告和激励插页式广告。网页导出使用 Google 的广告展示位置 API 来展示插页式广告和激励广告。Admob 广告只能在 Android 或 iOS 导出中展示。以本地预览、远程预览或带有 Android 或 iOS 以外的任何导出选项展示的广告将使用 Google 的广告展示位置 API。
广告类型
- 横幅广告 ：显示部分覆盖屏幕底部的广告，可以在创建广告时指定广告的大小。（仅限移动导出）
- 插页式广告 ：显示全屏广告，可用于在布局之间转换。（移动和网络导出）
- 激励广告 ：类似于插页式广告，因为它是全屏广告。如果用户在指定的时间内观看此广告，他们将获得奖励有效负载。如果在此之前取消了广告，则不会给予奖励。（移动和网络导出）
- 激励插页式广告 ：与激励广告类似，但用户无需选择加入即可查看激励插页式广告。与激励广告中的选择加入提示不同，激励插页式广告需要一个介绍屏幕来宣布奖励，并让用户有机会选择退出（如果愿意这样做）。（移动和网络导出）
Admob 入门
- 创建 AdMob 帐号 ：访问注册 AdMob。
- 在 Admob 帐号中创建应用 ：访问在 Admob 中设置应用。
- 为您的应用创建广告单元 ：访问广告单元。
- 复制应用程序 ID 并将其粘贴到移动广告 Android 应用程序 ID 和 iOS 应用程序 ID 属性中。查找应用程序 ID。
- 将您的商家和付款详细信息提交到您的 AdMob 帐号，然后等待他们验证（这可能需要 24 小时）。必须先完成此操作，然后才能投放广告。
网络广告入门
- 如果您还没有 Adsense 帐户，请注册一个帐户 。
- 您需要一个被列入白名单的网站来显示这些类型的广告 。
- 填写此表单以表明有兴趣使用 Google 的广告展示位置 API。
- 如何将我的网站列入白名单？：访问 Adsense 帐户左侧菜单中的协作平台选项 -> 找到“添加站点”按钮，然后单击它以开始添加您的网站 -> 按照步骤添加您的网站 -> 您需要通过添加一个小脚本来修改网站的根目录 -> 请求审核。
- 一段时间后，希望您的网站能够获得批准，并且您的游戏将能够展示广告。
网络广告的注意事项
- 你需要让你的网站是真实的，这意味着它应该有真实的内容，一般来说，它看起来像是在服务于一个目的。如果您只是设置一个没有内容的测试网站，则获得批准的可能性较小。
- 由于您的游戏将托管的父网站需要列入白名单，以便游戏可以显示广告，因此理想的用例是您可以控制托管网站。
- 如果游戏在跨域 iframe 中展示，则不允许展示广告。
用户同意（仅限移动设备导出）
要使“显示用户意见征求对话框”操作显示 GDPR 意见征求表单和 IDFA 消息（仅限 iOS），您需要在 Admob 帐号中进行设置。
GDPR 消息
按照本指南创建 GDPR 消息。
IDFA 消息
按照本指南创建 IDFA 消息。
IDFA 消息并非绝对必要，但它们可以通过使对话的目的更明确来帮助获得用户的同意。如果您设置了 IDFA 消息，并且应用程序是由欧洲经济区或英国的设备打开的，则在欧盟同意书之后会立即显示“应用跟踪透明度”对话框。这就是底层 SDK 的工作原理，并在 Google 自己的快速入门指南中提到。但是，如果您禁用了 IDFA 消息或根本没有 IDFA 消息，则“应用跟踪透明度”对话框不会自动显示，您可以使用“请求 IDFA”操作来控制其显示时间。
请注意，当您首次设置帐户并提交商家 / 付款详细信息时，最多可能需要 24 小时才能完成验证。请等待此操作完成后再尝试测试您的广告，因为在验证完成之前，它可能无法正常工作。
移动导出所需属性
如果您打算在移动导出（Android 或 iOS）中展示广告，则需要在移动广告对象上指定应用程序 ID。如果没有这些值，插件将无法启动。
Web 导出所需属性
如果您打算在网页导出中展示广告，则需要在移动广告对象中指定发布商 ID。如果没有该值，插件将无法显示网络广告。
初始化
当应用程序启动时，插件将自动初始化。但是，这可能涉及出于监管原因向用户显示用户同意提示，具体取决于用户所在的区域。因此，在尝试创建或展示任何广告之前，您应该等待“配置完成”触发器。还应该使用“配置失败”触发器（也许是“已配置”条件）来检查配置是否因某种原因而失败，例如在无效的平台上或某个属性不正确。
不想在启动时显示用户同意对话框？
默认情况下，欧洲经济区和英国（欧洲经济区和英国）的用户在第一次启动游戏时，会在游戏屏幕前看到用户同意对话框。如果您不希望这种情况发生，请取消选中“启动时显示”属性。然后，使用“显示用户同意对话框”操作在您选择的时间显示对话框。
在 iOS 上使用 IDFA
从 iOS 14+ 开始，默认情况下，应用不再可以使用广告客户或 IDFA 的标识符。这可能会影响广告的效果。要使用 IDFA，您必须通过“请求 IDFA”操作提示用户授予访问权限。您可能还希望在启动时执行此操作。当用户做出决定时，将触发 On IDFA 请求完成触发器，IDFAStatus 表达式指示结果。
申请 IDFA 需要将 Xcode 12+ 与 iOS 14+ 搭配使用。
目前，Android 上不需要提示，因此请求 IDFA 操作将立即触发 On IDFA 请求，IDFAStatus 为“未确定”。
iOS 上的 App Tracking Transparency 框架
为了支持“请求 IDFA”操作，移动广告插件包含一个名为 App Tracking Transparency 的 iOS 库。为了遵守 Apple 的 App Store 审核流程，您可能需要向审核者说明您的 App 在何处使用了 IDFA 提示。因此，您可能需要在项目的某个位置添加“请求 IDFA”操作。您不必总是在启动时请求它 – 例如，它可以是菜单中的设置，然后您向 App Store 评论者指示在哪里可以找到该选项。
广告加载
广告需要先通过网络加载，然后才能使用。创建广告时，您可以选择在广告加载后立即“展示”广告。但是，如果它更适合您的游戏，您可以选择提前加载广告，方法是创建广告，但不展示广告，然后在需要时展示广告。这样可以防止您的用户在广告加载时遇到延迟。在尝试展示广告之前，请务必检查您的广告是否已实际加载，尤其是激励广告的加载时间可能很长。还值得记住的是，当您提出请求时，您不能保证会收到广告，因此在制作活动时要考虑到这一点。
横幅广告尺寸
要显示横幅广告，您必须为其指定尺寸，通常智能纵向 / 横向适用于大多数情况，但以下是可指定的尺寸。使用大于显示器的尺寸将阻止其加载。智能横幅的高度会根据可用的屏幕高度而有所不同。使用智能横幅时，如果基本图像的宽度不足以填满屏幕，则两侧都会显示黑条。
移动广告属性
- 测试模式 ：将显示的广告单元更改为测试广告。应在开发过程中使用。（移动和网络导出）
- Android 应用程序 ID：您游戏的 Android 版本的 Admob 应用 ID。其格式为“ca-app-pub-0000000000000000~00000000”。在 Android 上，此值是必需的，除非提供且正确，否则应用程序将无法启动。查找您的应用 ID（仅限移动设备导出）
- iOS 应用程序 ID：您游戏的 iOS 版本的 Admob 应用 ID。其格式为“ca-app-pub-0000000000000000~00000000”。在 iOS 上，此值是必需的，除非提供且正确，否则应用程序将无法启动。查找您的应用 ID（仅限移动设备导出）
- 欺骗位置（调试）：伪造设备位置，以便允许在不同方案中测试用户同意对话框。必须启用测试模式才能正常工作。（仅限移动导出）
- 启动时显示 ：选择是否在启动时自动显示同意书。此选项在 Web 导出中不执行任何操作。（仅限移动导出）
- 发布者 ID：Adsense 发布商 ID，可在您的 Adsense 帐号中找到。如果您打算在 Web 导出中展示广告，则需要这样做。查找您的发布者 ID（仅限 Web 导出）
测试广告
在开发和测试应用时，务必使用测试广告。在测试期间查看真实广告可能会导致您的 Admob 帐号被暂停或关闭！可以通过在插件上设置测试模式属性来启用测试模式。测试模式默认处于启用状态，因此请记得在发布游戏时关闭它！
测试模式下的 GDPR 同意书
启用测试模式时，无论之前的选择如何，每次启动应用程序时都会显示 GDPR 同意书。准备好部署时，请禁用测试模式，以便窗体可以正常运行，并且仅在安装应用程序后首次执行应用程序时显示。
欺骗位置中的测试
不幸的是，无法在具有 iOS 版本 14 或更高版本的真实设备上使用此功能。这是因为要启用该功能，必须事先访问 IDFA，如果不首先显示“应用跟踪透明度”对话框，则无法做到这一点。由于对话框只能显示一次，启用该功能后无法测试应用程序在首次运行设备时的行为。尽管如此，该功能仍然可以在模拟器中使用。
预览中的广告
预览项目时，应用程序将表现为 Web 导出，因此它将像 Web 导出一样显示测试广告。它还模拟了频次上限，在有效广告请求和无效广告请求之间交替。
移动广告和网络广告的区别
- 广告单元 ：如果您只想展示网页广告，则无需在操作中提供广告单元，该字段可以留空。但是，如果您打算将相同的项目用于 Web 和移动设备，您仍然需要提供它们。
- 激励广告 ：移动端的激励广告和网络端的激励广告之间略有不同，需要加以考虑。
移动广告条件
- Banner 就绪状态下 ：在加载横幅广告时触发。
- 插页式广告中 ：在加载插页式广告时触发。
- 奖励就绪状态下 ：在激励广告加载时触发。
- 奖励插页式广告中 ：在加载激励插页式广告时触发。
- 横幅上无法加载 ：横幅广告加载失败时触发。
- 插页式广告上无法加载 ：插页式广告加载失败时触发。
- On Rewarded 无法加载 ：当激励广告加载失败时触发。
- 奖励插页式广告上无法加载 ：当激励插页式广告加载失败时触发。
- 在显示的横幅上 ：在显示横幅广告时触发。
- 插页式上完成 ：在插页式广告关闭时触发。
- 奖励完成 ：在激励广告关闭且用户已获得奖励时触发。
- 奖励插页式广告完成 ：在激励插页式广告关闭且用户已获得奖励时触发。
- 在横幅上隐藏 ：在横幅广告被隐藏时触发。
- 插页式广告中取消 ：在插页式广告被取消时触发。
- 奖励取消 ：在激励广告被取消时触发。
关于奖励插页式广告取消
在激励插页式广告被取消时触发。