Unity 之 最新Ads原生广告接入流程详解和工具类分享

news2024/12/24 8:47:35

Unity 之 Ads接入流程详解

  • 一，注册 Unity Ads 广告 SDK
  • 二，下载 Unity Ads 广告 SDK
  • 三，配置 Unity Ads 广告 SDK
    • 3.1 广告位展示流程
    • 3.2 代码初始化
  • 四，集成 Unity Ads 广告 SDK
    • 4.1 相关介绍
    • 4.2 代码分享
  • 五，测试 Unity Ads 广告 SDK
    • 5.1 搭建场景
    • 5.2 后台数据

Unity Ads 是由 Unity Technologies 开发的广告平台，可以用于在移动应用程序中显示广告。它提供了多种广告类型，包括插屏广告、横幅广告、视频广告等。

在本文中，我们将详细介绍如何接入 Unity Ads 广告 SDK。

一，注册 Unity Ads 广告 SDK

在使用 Unity Ads 广告 SDK 之前，需要先登录Unity Ads后台。地址: https://dashboard.unity3d.com/gaming/organizations

  1. 登录在Unity账号，注意要和本地Hub使用同一账号。

  2. 登录成功后，在“项目管理” 可进入到这个界面，然后在“Projects” 面板中创建一个项目即可：

  3. 创建项目之后，返回到上一层，找到广告配置界面：

其他的数据看吧想不用管，广告位置ID也不用改，先按照默认操作集成即可。其他面板也可以等集成成功后慢慢看。

二，下载 Unity Ads 广告 SDK

Unity Ads 广告 SDK 可以从 Unity Asset Store 中下载，并导入到您的 Unity 项目中。在 Unity 中，选择菜单栏的“Window”>“Package Manager”，然后在“Packages”选项卡中搜索“Advertisement Legacy”，点击“Install”按钮即可下载和安装:

  1. 安装

  2. 安装完成后，在Project Setting中找到Services --> Ads，点击OFF 打开

  3. 打开后选择1步骤中后台创建的项目，完成后即可入到如下界面

可以看到 GameId 中的 Android和iOS 都已经有了和后台项目创建的一致。

注意：TestMode是测试模式，正式发布前需要取消：Enable test mode 选项。

三，配置 Unity Ads 广告 SDK

3.1 广告位展示流程

  1. 广告初始化
  • 成功 --> 加载广告位
  • 失败 --> 设定几秒后重新加载
  1. 广告位加载广告
  • 成功 --> 可展示广告
  • 失败 --> 设定几秒后重新加载
  1. 在指定位置展示广告
  • 成功 --> 监听展示结果，比如：激励广告完成发放奖励
  • 失败 --> 加载成功后几乎不会有展示失败的情况

3.2 代码初始化

注意配置的广告ID换成自己的，测试模式是否开启手动控制。初始化代码如下：

    [SerializeField] string _androidGameId = "5309904";
    [SerializeField] string _iOSGameId = "5309905";
    [SerializeField] bool _testMode = true;
    private string _gameId;
 
    void Awake()
    {
        InitializeAds();
    }

    public void InitializeAds()
    {
#if UNITY_IOS
        _gameId = _iOSGameId;
#elif UNITY_ANDROID
        _gameId = _androidGameId;
#elif UNITY_EDITOR
        _gameId = _androidGameId;
#endif
        if (!Advertisement.isInitialized && Advertisement.isSupported)
        {
            Advertisement.Initialize(_gameId, _testMode, this);
        }
    }

四，集成 Unity Ads 广告 SDK

4.1 相关介绍

  1. 设置Banner位置：
    在代码中，使用 Unity Ads SDK 的 Banner API 来显示横幅广告。使用 Advertisement.Banner.SetPosition(_bannerPosition) 方法设置广告位置，然后使用 Show() 方法显示广告。

  2. 插屏和激励视频
    对于插屏广告和奖励视频广告，可以使用 Unity Ads SDK 的 Interstitial API 和 Rewarded Video API 来显示广告。

在显示广告时，可以通过监听广告事件来处理广告的状态。例如，在插屏广告显示完成后，可以使用以下代码来处理广告事件：

在此示例中，我们通过实现 IUnityAdsListener 接口来监听广告事件。在 Start() 方法中，我们添加了一个监听器，并使用 Initialize() 方法初始化广告 SDK。然后，我们使用 Show() 方法显示插屏广告。当广告状态发生变化时，Unity Ads SDK 将调用相应的事件方法。

4.2 代码分享

测试代码如下：注意更换自己的项目id

using System;
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.Advertisements;

public class UnityAdsManager : MonoBehaviour, IUnityAdsInitializationListener, IUnityAdsLoadListener, IUnityAdsShowListener
{
    public static UnityAdsManager Ins;
    
    [SerializeField] string _androidGameId = "5309985";
    [SerializeField] string _iOSGameId = "5309984";
    [SerializeField] bool _testMode = true;
    private string _gameId;
 
    void Awake()
    {
        Ins = this;
        InitializeAds();
    }

    public void InitializeAds()
    {
#if UNITY_IOS
            _gameId = _iOSGameId;
#elif UNITY_ANDROID
            _gameId = _androidGameId;
#elif UNITY_EDITOR
            _gameId = _androidGameId;
#endif
        if (!Advertisement.isInitialized && Advertisement.isSupported)
        {
            Advertisement.Initialize(_gameId, _testMode, this);
        }
    }
 
    public void OnInitializationComplete()
    {
        Debug.Log("Unity Ads 广告初始化完成.");
        InitAdUnit();
        InitRewardAD();
        InitBanner();
    }
 
    public void OnInitializationFailed(UnityAdsInitializationError error, string message)
    {
        Debug.Log($"Unity Ads 广告初始化失败: {error.ToString()} - {message}");
    }

    #region 插屏广告
    
    // 插屏广告ID
    string _androidAdUnitId = "Interstitial_Android";
    string _iOsAdUnitId = "Interstitial_iOS";
    string _adInterstitialId;
    private bool _InterstitialLoaded = false;

    void InitAdUnit()
    {
        _adInterstitialId = (Application.platform == RuntimePlatform.IPhonePlayer)
            ? _iOsAdUnitId
            : _androidAdUnitId;
        LoadInterstitialAd();
    }
    
    /// <summary>
    /// 加载插屏
    /// </summary>
    public void LoadInterstitialAd()
    {
        if (_InterstitialLoaded) return;
        Debug.Log("Loading Ads 加载插屏广告ID: " + _adInterstitialId);
        Advertisement.Load(_adInterstitialId, this);
    }
 
    /// <summary>
    /// 展示插屏
    /// </summary>
    public void ShowInterstitialAd()
    {
        if (_InterstitialLoaded)
        {
            Debug.Log("Showing Ads 显示广告ID: " + _adInterstitialId);
            Advertisement.Show(_adInterstitialId, this);
        }
        else
        {
            LoadInterstitialAd();
        }
    }
    #endregion 插屏

    #region 激励视频
    string _androidRewardedUnitId = "Rewarded_Android";
    string _iOSRewardedId = "Rewarded_iOS";
    string _adRewardedId = null;

    private bool _RewardLoaded = false;
    void InitRewardAD()
    {
#if UNITY_IOS
        _adRewardedId = _iOSRewardedId;
#elif UNITY_ANDROID
        _adRewardedId = _androidRewardedUnitId;
#endif
        LoadRewardedAd();
    }
    
    /// <summary>
    /// 加载激励视频
    /// </summary>
    public void LoadRewardedAd()
    {
        if (_RewardLoaded) return;
        Debug.Log("Loading Ad: " + _adRewardedId);
        Advertisement.Load(_adRewardedId, this);
    }

    private Action<bool> RewardedAdClose;
    /// <summary>
    /// 展示激励视频
    /// </summary>
    public void ShowRewardedAd(Action<bool> OnClose)
    {
        RewardedAdClose = OnClose;
        Advertisement.Show(_adRewardedId, this);
    }
 
    #endregion

    #region Banner

    [SerializeField] BannerPosition _bannerPosition = BannerPosition.BOTTOM_CENTER;
 
    string _androidBannerId = "TpxxlLobbyPopBanner";
    string _iOSBannerId = "Banner_iOS";
    string _adBannerId = null;

    private bool _adBannerLoaded = false;
    void InitBanner()
    {
        // Get the Ad Unit ID for the current platform:
#if UNITY_IOS
        _adBannerId = _iOSBannerId;
#elif UNITY_ANDROID
        _adBannerId = _androidBannerId;
#endif
        // 设置Banner显示位置
        Advertisement.Banner.SetPosition(_bannerPosition);
    }

    public void LoadBanner()
    {
        if (_adBannerLoaded) return;
        // Set up options to notify the SDK of load events:
        BannerLoadOptions options = new BannerLoadOptions
        {
            loadCallback = OnBannerLoaded,
            errorCallback = OnBannerError
        };
 
        // Load the Ad Unit with banner content:
        Advertisement.Banner.Load(_adBannerId, options);
    }
 
    void OnBannerLoaded()
    {
        _adBannerLoaded = true;
        Debug.Log("Banner Ads 加载完成");  
    }
    
    void OnBannerError(string message)
    {
        _adBannerLoaded = false;
        Debug.Log($"Banner Ads 加载失败 Error: {message}");
        // 可选地执行附加代码，例如尝试加载另一个广告。
    }
    
    /// <summary>
    /// 展示Banner
    /// </summary>
    public void ShowBannerAd()
    {
        if (!_adBannerLoaded)
        {
            LoadBanner();
        }
        else
        {
            BannerOptions options = new BannerOptions
            {
                clickCallback = OnBannerClicked,
                hideCallback = OnBannerHidden,
                showCallback = OnBannerShown
            };
 
            // Show the loaded Banner Ad Unit:
            Advertisement.Banner.Show(_adBannerId, options);
        }
    }
 
    /// <summary>
    /// 隐藏Banner
    /// </summary>
    public void HideBannerAd()
    {
        Advertisement.Banner.Hide();
    }
    
        
    void OnBannerClicked() { }
    void OnBannerShown() { }

    void OnBannerHidden()
    {
        LoadBanner();
    }
    
    #endregion
    
    public void OnUnityAdsAdLoaded(string adUnitId)
    {
        // 如果广告单元成功加载内容，则可选择执行代码。
        Debug.Log("Showing Ads 加载广告完成ID: " + adUnitId);
        if (adUnitId == _androidAdUnitId || adUnitId == _iOsAdUnitId)
        {
            _InterstitialLoaded = true;
        }
        else if (adUnitId == _androidRewardedUnitId || adUnitId == _iOSRewardedId)
        {
            _RewardLoaded = true;
        }

    }
 
    public void OnUnityAdsFailedToLoad(string _adUnitId, UnityAdsLoadError error, string message)
    {
        Debug.Log($"Error Ads 加载广告失败 Unit: {_adUnitId} - {error.ToString()} - {message}");
        if (_adUnitId == _androidAdUnitId || _adUnitId == _iOsAdUnitId)
        {
            _InterstitialLoaded = false;
        }
        else if (_adUnitId == _androidRewardedUnitId || _adUnitId == _iOSRewardedId)
        {
            _RewardLoaded = false;
        }
    }
 
    public void OnUnityAdsShowFailure(string _adUnitId, UnityAdsShowError error, string message)
    {
        Debug.Log($"Error Ads 展示广告失败 Unit {_adUnitId}: {error.ToString()} - {message}");
        // 如果广告单元无法显示，可以选择执行代码，例如加载另一个广告
        if (_adUnitId == _androidAdUnitId || _adUnitId == _iOsAdUnitId)
        {
            _InterstitialLoaded = false;
        }
        else if (_adUnitId == _androidRewardedUnitId || _adUnitId == _iOSRewardedId)
        {
            _RewardLoaded = false;
        }
    }

    public void OnUnityAdsShowStart(string _adUnitId) { }
    public void OnUnityAdsShowClick(string _adUnitId) { } 
    
    // 视频展示完成发放奖励:
    public void OnUnityAdsShowComplete(string adUnitId, UnityAdsShowCompletionState showCompletionState)
    {
        if (adUnitId.Equals(adUnitId) && showCompletionState.Equals(UnityAdsShowCompletionState.COMPLETED))
        {
            Debug.Log("Unity Ads 激励视频播放完成");
            // 发放奖励
            RewardedAdClose(true);
        }
        
        // 加载新的激励视频
        if (adUnitId == _androidRewardedUnitId || adUnitId == _iOSRewardedId)
        {
            _RewardLoaded = false;
            LoadRewardedAd();
        }
        else if (adUnitId == _androidAdUnitId || adUnitId == _iOsAdUnitId)
        {
            _InterstitialLoaded = false;
            LoadInterstitialAd();
        }
    }
}

五，测试 Unity Ads 广告 SDK

5.1 搭建场景

搭建测试场景如下：

注意：红框中的广告位ID要和后台创建的对应上，测试时要先等加载完成再执行展示即可。

5.2 后台数据

以上就是接入 Unity Ads 广告 SDK 的流程。需要正确配置广告选项，并根据应用程序的需求选择合适的广告类型。需要测试Demo的童鞋可以点击链接获取或者关注下面👇🏻卡片公号，回复“Ads”获取。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/661316.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

C语言变量学习2

C语言变量学习2

前文已经学习了C语言变量&#xff1b; C语言变量_c语言变量块_bcbobo21cn的博客-CSDN博客 继续再学习&#xff1b;VC6新建一个单文档工程&#xff1b; void CVtestView::OnDraw(CDC* pDC) {CVtestDoc* pDoc GetDocument();ASSERT_VALID(pDoc);// TODO: add draw code for na…
阅读更多...
【C语言复习】第三篇、Gitee码云的创建和使用

【C语言复习】第三篇、Gitee码云的创建和使用

目录 第一部分、Gitee码云的用处 1、为什么要使用Gitee&#xff1f; 2、我参考的视频 第二部分、软件安装流程 1、下载Git for windows软件和TortoiseGit软件 2、Git for windows软件的安装流程 3、TortoiseGit软件软件的安装流程 第三部分、Gitee如何创建仓库&#xf…
阅读更多...
jquery和jquery ui有什么区别

jquery和jquery ui有什么区别

jquery和jquery ui有什么区别 jquery和jquery ui有什么区别 jQuery UI 与 jquery 的主要区别是&#xff1a;(1) jQuery是一个js库&#xff0c;主要提供的功能是选择器&#xff0c;属性修改和事件绑定等等。(2) jQuery UI则是在jQuery的基础上&#xff0c;利用jQuery的扩展性&…
阅读更多...
企业搭建小型直播间、中型直播间、大型直播间的介绍

企业搭建小型直播间、中型直播间、大型直播间的介绍

常用的直播间搭建大致分为实景和绿幕两种类型。实景区即公司具体场景&#xff0c;如会客厅、LOGO墙、海报展板以及纯白背景等&#xff0c;根据企业直播主题而调整&#xff1b;绿幕区则是通过搭建绿幕&#xff0c;满足企业直播过程中需要进行抠像&#xff0c;设置沉浸式背景的需…
阅读更多...
国产麒麟服务器等保二级 配置规范（一）

国产麒麟服务器等保二级 配置规范（一）

麒麟linux的加固 1.检查设备密码复杂度策略 配置文件 vi /etc/pam.d/system-auth password requisite pam_cracklib.so ucredit-1 lcredit-1 dcredit-1 minlen6 auth required pam_tally.so deny5 unlock_time600 no_lock_time account required pam_tally.sopassword suffi…
阅读更多...
大数据Doris（四十五）：Routine Load注意事项

大数据Doris（四十五）：Routine Load注意事项

文章目录 Routine Load注意事项 Routine Load注意事项 1、查看作业状态的具体命令和示例可以通过 HELP SHOW ROUTINE LOAD; 命令查看。 2、用户可以通过 STOP/PAUSE/RESUME 三个命令来控制作业的停止，暂停和重启。可以通过 HELP STOP ROUTINE LOAD; HELP PAUSE ROUTINE LOA…
阅读更多...
调用万维易源API实现证件照换装

调用万维易源API实现证件照换装

目录 1. 作者介绍2. 万维易源API简介2.1 易源数据2.2 易源API管理2.3 调用参数简介 3. 万维易源API调用过程3.1 获取ID和代码3.2 代码实现3.3 完整代码 参考&#xff08;可供参考的链接和引用文献&#xff09; 1. 作者介绍 吴宇&#xff0c;男&#xff0c;西安工程大学电子信息…
阅读更多...
LVS keepalived 集群

LVS keepalived 集群

LVS keepalived 集群 LVS keepalived 集群一、Keepalived及其工作原理1.Keepalived体系主要模块及其作用2.健康检查的方式&#xff08;探针&#xff09; 二、LVSKeepalived 高可用群集部署1.LVS部署一&#xff1a;配置负载调度器&#xff08;主、备相同&#xff09;二&#xff…
阅读更多...
FreeRTOS实时操作系统（二）任务创建与任务删除（HAL库）

FreeRTOS实时操作系统（二）任务创建与任务删除（HAL库）

文章目录 前言系统配置任务创建动态任务创建删除实践静态任务创建删除实践 前言 接着学习正点原子的FreeRTOS教程&#xff0c;涉及到一些详细的系统内文件代码 系统配置 可以通过各种的宏定义来实现我们自己的RTOS配置&#xff08;在FreeRTOSconfig.h&#xff09; “INCLUDE…
阅读更多...
100天精通Python（可视化篇）——第92天：Pyecharts绘制炫酷柱状图、条形图实战大全

100天精通Python（可视化篇）——第92天：Pyecharts绘制炫酷柱状图、条形图实战大全

文章目录 专栏导读1. 基础柱状图2. 旋转x轴标签3. 旋转坐标轴4. 添加坐标轴名称5. 添加标记点6. 添加标注线7. 添加数据8. 添加自定义背景图9. 堆叠柱状图10. 柱状图与折线图组合11. 三维柱状图12. 水平滑动、鼠标滚轮缩放柱状图 专栏导读 &#x1f525;&#x1f525;本文已收…
阅读更多...
ConcurrentHashMap源码

ConcurrentHashMap源码

HashTable是一个线程安全的类&#xff0c;它使用synchronized来锁住整张Hash表来实现线程安全&#xff0c;即每次锁住整张表让线程独占&#xff0c;相当于所有线程进行读写时都去竞争一把锁&#xff0c;导致效率非常低下。 介绍 ConcurrentHashMap的底层原理和HashMap是比较相…
阅读更多...
网页之http

网页之http

目录 一、网页概念&#xff1a; 1.纯文本格式文件 2.编写语言-----html---超文本标记语言 3.浏览器相当于翻译器&#xff0c;检查是否为html文件&#xff0c;是的话就翻译&#xff0c;否则就报错。 二、域名 三、DNS解析 1.分布式域名解析-----层次性&#xff1a;迭代处…
阅读更多...
谁是远程界的天花板？2023年5款最常用的远程软件横测：ToDesk、向日葵、TeamViewer、Splashtop、AnyDesk

谁是远程界的天花板？2023年5款最常用的远程软件横测：ToDesk、向日葵、TeamViewer、Splashtop、AnyDesk

前言 一个优秀的远控软件&#xff0c;追求的是可信赖的安全感&#xff0c;连接的流畅度、画质的清晰度、操作的简单化、毫秒级的无感延迟以及全方位的功能。另外&#xff0c;远控软件还应拥有独立的创新技术&#xff0c;具备竞争对手无法超越的市场前瞻性&#xff0c;与世界保…
阅读更多...
MySQL - 第4节 - MySQL表的约束

MySQL - 第4节 - MySQL表的约束

1.MySQL表的约束概述 • 真正约束字段的是数据类型&#xff0c;如果插入的数据超出了对应数据类型的取值范围&#xff0c;那么数据将会插入失败。 • 但是数据类型的约束很单一&#xff0c;为了更好的保证数据的合法性&#xff0c;从业务逻辑角度保证数据的正确性&#xff0c;M…
阅读更多...
ldr、str、ldm、stm、msr、mrs、swi、svc、mrc等ARM指令详解及具体应用

ldr、str、ldm、stm、msr、mrs、swi、svc、mrc等ARM指令详解及具体应用

文章目录 前言一、跳转指令1.1 相对跳转1.2 绝对跳转 二、内存操作指令2.1 Load和Store2.1.1 伪指令2.1.2 伪操作 2.2 内存操作指令具体应用 三、 寄存器的寻址方式3.1 前索引寻址3.2 后索引寻址3.3 基址变址 四、块拷贝指令&#xff08;多数据加载&#xff09;4.1 块拷贝4.2 指…
阅读更多...
Nacos 源码分析全系列

Nacos 源码分析全系列

Nacos 源码分析全系列 学习目标 主线任务 代码解析画图git库(中文注释)设计思想多版本迭代讨论群(私聊进群) 主要的大纲路线 主要拆解的是nacos的1.4.1版本和2.1.0版本,还有nacos 的一些已知的bug 正确的学习源码的姿势 服务端是如何处理客户度的请求 注册中心服务 内存…
阅读更多...
【备战秋招】每日一题:华东师范大学保研机试-2022-差分计数

【备战秋招】每日一题:华东师范大学保研机试-2022-差分计数

为了更好的阅读体检&#xff0c;可以查看我的算法学习博客差分计数 题目内容 给定n个整数,...,和一个整数x。求有多少有序对(i,j)满足 输入格式 第一行两个整数,分别代表整数的个数和题目中的x。 第二行n个用空格隔开的整数&#xff0c;第i个代表 输出格式 一行一个整数…
阅读更多...
1745_Perl中的switch结构

1745_Perl中的switch结构

全部学习汇总&#xff1a; GreyZhang/perl_basic: some perl basic learning notes. (github.com) 用了很久时间的Perl了&#xff0c;但是一直没有使用过switch结构。即使有的时候&#xff0c;基本上也通过其他的形式完成了相关工作。虽说有时候可能会效率低一些&#xff0c;但…
阅读更多...
【Python】使用pyside2时qt designer 设计窗口显示图标icon但是运行后不显示（图文说明）

【Python】使用pyside2时qt designer 设计窗口显示图标icon但是运行后不显示（图文说明）

目录 错误情况解决方法总结 欢迎关注 『Python』 系列&#xff0c;持续更新中 欢迎关注 『Python』 系列&#xff0c;持续更新中 平时用的不多&#xff0c;也不知道这个报错有没有偶然性&#xff0c;或者是我自己搞错了仅供参考。 错误情况 toolBar中的图标在designer中显示正…
阅读更多...
【备战秋招】每日一题:华东师范大学保研机试-2022-位运算

【备战秋招】每日一题:华东师范大学保研机试-2022-位运算

为了更好的阅读体检&#xff0c;可以查看我的算法学习博客位运算 题目内容 给定一个int型整数x,将x的二进制表示中第i位和第j位的值互换。 注意: x的二进制表示的最右边为第0位。 输入格式 在一行中输入三个整数&#xff0c;x,i,j, 整数之间用一个空格分隔。 输出格式 在…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023