开始使用

本指南将向您介绍如何使用原生广告插件植入原生广告 以及在此过程中需要考虑的一些重要事项。

原生广告无论是在形式上还是功能上都与用户体验相匹配 它们的放置位置。原生广告在视觉设计上与投放到的应用也如出一辙。 借助 Ad Manager 的原生广告格式,发布商可以呈现 无缝衔接您可以利用此技术来实现高度自定义 充分利用 Unity 应用中的原生代码渲染。

原生广告在展示时使用的 GameObjects 类型与您开发应用时使用的类型相同,而且能以和周围视觉设计相称的形式呈现,让用户有浑然一体的使用体验。加载原生广告时 接收包含其资源和 Unity 应用的原生对象,而不是接收 显示它们。

前提条件

  • Google 移动广告 Unity 插件 7.0.0 或更高版本。
  • 完成入门指南
  • 下载 并安装原生广告插件

加载原生广告格式

原生广告通过 AdLoader 类加载,该类拥有自己的 AdLoader.Builder 类,以便在创建过程中对其进行自定义。ForNativeAd() 方法会将 AdLoader 配置为处理原生广告。

private void RequestNativeAd() {
    AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
        .ForNativeAd()
        .Build();
}

注册 AdLoader 广告事件

要在原生广告加载成功或加载失败时收到通知,请将代理添加到下列事件的 AdLoader 类中。

OnNativeAdLoaded

在原生广告成功加载时调用。必须具有 该事件的代理来访问已加载的广告。

OnAdFailedToLoad

在原生广告加载失败时调用。

加载广告

构建完 AdLoader 后,即可调用其 LoadAd() 方法来请求广告:

adLoader.LoadAd(new AdRequest.Builder().Build());

汇总广告请求

以下代码段演示了如何构建一个 AdLoader, 配置为请求原生广告,为成功和失败的广告设置代理 并发出广告请求

private void RequestNativeAd() {
    AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
        .ForNativeAd()
        .Build();
    adLoader.OnNativeAdLoaded += this.HandleNativeAdLoaded;
    adLoader.OnAdFailedToLoad += this.HandleAdFailedToLoad;
    adLoader.LoadAd(new AdRequest.Builder().Build());
}

处理失败的广告加载

OnAdFailedToLoad 事件的类型为 EventHandle<AdFailedToLoadEventArgs>。 下面显示了从此事件中解析广告加载失败的原因。

private void RequestNativeAd() {
    ...
    adLoader.OnAdFailedToLoad += this.HandleNativeAdFailedToLoad;
}

private void HandleNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args) {
    Debug.Log("Native ad failed to load: " + args.Message);
}

展示原生广告

加载原生广告时,系统会调用相应广告格式的广告事件。 然后,就由您的应用负责展示广告了,尽管它不会 必须立即处理

处理广告加载

OnNativeAdLoaded 事件的类型为 EventHandler<NativeAdEventArgs>。通过 封装在 NativeAd 对象中的广告,可以从 NativeAdEventArgs,如下所示:

private NativeAd nativeAd;
...
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
    Debug.Log("Native ad loaded.");
    this.nativeAd = args.nativeAd;
}

检索原生广告素材资源

广告加载后,您可以对其素材资源进行访问,如下所示。图形 素材资源会以 Texture2D 对象的形式返回,文字素材资源会以 string 对象。

private bool nativeAdLoaded;
private NativeAd nativeAd;

void Update() {
    ...

    if (this.nativeAdLoaded) {
        this.nativeAdLoaded = false;
        // Get Texture2D for the icon asset of native ad.
        Texture2D iconTexture = this.nativeAd.GetIconTexture();

        // Get string for headline asset of native ad.
        string headline = this.nativeAd.GetHeadlineText();
    }
}

private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
    Debug.Log("Native ad loaded.");
    this.nativeAd = args.nativeAd;
    this.nativeAdLoaded = true;
}

请注意,只应在主线程上访问广告素材资源,例如,从 Unity 脚本的 Update() 方法访问。另请注意,并不保证以下素材资源总是存在,所以应在展示前对此进行检查:

  • GetStarRating()
  • GetStore()
  • GetPrice()
  • GetAdvertiser()
  • GetIconTexture()

“广告选择”素材资源

根据要求,广告选择素材资源必须作为原生广告的一部分展示。 此外,广告选择素材资源一定要显眼易见,因此请选择 背景颜色和图片。

为广告素材资源注册 GameObjects

您必须为要在 Unity 应用中展示的广告素材资源注册 GameObject。如果注册成功,用于注册 GameObject 的方法会返回 bool。对于 List<GameObject>,该方法会返回 int 表示已成功注册的 GameObject 数量。

如果广告素材资源注册失败, 则无法识别相应的原生广告。

if (!this.nativeAd.RegisterIconImageGameObject(icon))
{
    // Handle failure to register the icon ad asset.
}

为广告素材资源注册的 GameObject 必须具有凸形 Collider 代表 GameObject 的尺寸和形状的组件。如果 注册到广告素材资源的 GameObject 个对象缺少 Collider 个组件 或者原生广告配置不正确,则原生广告将无法正常运行。

在下面的代码段中,BoxCollider 被添加到 GameObject,后者使用 TextMesh 来展示原生广告的标题广告素材资源。部署 BoxCollider 已挂接到 GameObject,它会自动扩容为 以容纳 TextMesh 组件的文字。

// Create GameObject that will display the headline ad asset.
GameObject headline = new GameObject();
headline.AddComponent<TextMesh>();
headline.GetComponent<TextMesh>().characterSize = 0.5 f;
headline.GetComponent<TextMesh>().anchor = TextAnchor.MiddleCenter;
headline.GetComponent<TextMesh>().color = Color.black;

// Get string of the headline asset.
string headlineText = this.nativeAd.GetHeadlineText();
headline.GetComponent<TextMesh>().text = headlineText;

// Add box collider to the GameObject which will automatically scale.
headline.AddComponent<BoxCollider>();

演示

以下代码演示了如何成功检索 加载原生广告后,通过设置 Quad 的纹理来展示图标广告素材资源; 并注册用于显示该资源的 GameObject。此过程 检索广告素材资源并向原生广告类注册它, 对应用显示的每项资源重复

private GameObject icon;
private bool nativeAdLoaded;
private NativeAd nativeAd;
...
void Update() {
    ...

    if (this.nativeAdLoaded) {
        this.nativeAdLoaded = false;
        // Get Texture2D for icon asset of native ad.
        Texture2D iconTexture = this.nativeAd.GetIconTexture();

        icon = GameObject.CreatePrimitive(PrimitiveType.Quad);
        icon.transform.position = new Vector3(1, 1, 1);
        icon.transform.localScale = new Vector3(1, 1, 1);
        icon.GetComponent<Renderer>().material.mainTexture = iconTexture;

        // Register GameObject that will display icon asset of native ad.
        if (!this.nativeAd.RegisterIconImageGameObject(icon))
        {
            // Handle failure to register ad asset.
        }
    }
}
...

private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
    Debug.Log("Native ad loaded.");
    this.nativeAd = args.nativeAd;
    this.nativeAdLoaded = true;
}