Bắt đầu

Quảng cáo lớp phủ gốc được hiển thị cho người dùng thông qua các thành phần giao diện người dùng là gốc vào nền tảng. Những quảng cáo này được hiển thị dưới dạng lớp phủ ở trên . Tính năng này tương tự như cách hoạt động của quảng cáo biểu ngữ, nhưng có thể tuỳ chỉnh giao diện của quảng cáo.

Quảng cáo lớp phủ gốc hỗ trợ tính năng dàn xếp và quảng cáo dạng video. Đây là một lợi thế chính quảng cáo lớp phủ gốc có nhiều hơn quảng cáo gốc.

Hướng dẫn này cũng cho bạn biết cách triển khai quảng cáo lớp phủ gốc trong ứng dụng Unity như một số điều quan trọng cần xem xét trong quá trình triển khai.

Điều kiện tiên quyết

• Xem hết Hướng dẫn bắt đầu sử dụng.
• Trình bổ trợ Unity phiên bản 9.0.0 trở lên.

Luôn thử nghiệm bằng quảng cáo thử nghiệm

Mã mẫu sau đây chứa một mã đơn vị quảng cáo mà bạn có thể sử dụng để yêu cầu quảng cáo thử nghiệm. Mã này được định cấu hình đặc biệt để trả về quảng cáo thử nghiệm thay vì quảng cáo thực tế cho mọi yêu cầu, giúp đảm bảo an toàn khi sử dụng.

Tuy nhiên, sau khi đăng ký một ứng dụng trong Giao diện web Ad Manager và tạo đơn vị quảng cáo của riêng bạn Mã nhận dạng để sử dụng trong ứng dụng của bạn, hãy định cấu hình thiết bị của bạn làm quá trình kiểm tra một cách rõ ràng thiết bị trong khoảng thời gian phát triển ứng dụng.

/6499/example/native

Tải quảng cáo lớp phủ gốc

Bạn có thể tải một quảng cáo lớp phủ gốc bằng cách sử dụng phương thức Load() tĩnh trên lớp NativeOverlayAd. Đối tượng NativeOverlayAd đã tải được cung cấp dưới dạng một tham số trong trình xử lý hoàn thành.

Đoạn mã sau đây sử dụng NativeOverlayAd để tải quảng cáo:

// This ad unit is configured to always serve test ads.
private string _adUnitId = "/6499/example/native";



private NativeOverlayAd _nativeOverlayAd;

/// <summary>
/// Loads the ad.
/// </summary>
public void LoadAd()
{
    // Clean up the old ad before loading a new one.
    if (_nativeOverlayAd != null)
    {
        DestroyAd();
    }

    Debug.Log("Loading native overlay ad.");

    // Create a request used to load the ad.
    var adRequest = new AdRequest();

    // Optional: Define native ad options.
    var options = new NativeAdOptions
    {
        AdChoicesPosition = AdChoicesPlacement.TopRightCorner,
        MediaAspectRatio = NativeMediaAspectRatio.Any,
    };

    // Send the request to load the ad.
    NativeOverlayAd.Load(_adUnitId, adRequest, options,
        (NativeOverlayAd ad, LoadAdError error) =>
    {
        if (error != null)
        {
            Debug.LogError("Native Overlay ad failed to load an ad " +
                           " with error: " + error);
            return;
        }

        // The ad should always be non-null if the error is null, but
        // double-check to avoid a crash.
        if (ad == null)
        {
            Debug.LogError("Unexpected error: Native Overlay ad load event " +
                           " fired with null ad and null error.");
            return;
        }

        // The operation completed successfully.
        Debug.Log("Native Overlay ad loaded with response : " +
                   ad.GetResponseInfo());
        _nativeOverlayAd = ad;

        // Register to ad events to extend functionality.
        RegisterEventHandlers(ad);
    });
}

Hiển thị và tạo kiểu cho quảng cáo lớp phủ gốc

Quảng cáo lớp phủ gốc được hiển thị bằng cách sử dụng NativeTemplateStyle. Lớp này xác định các trường cho phép bạn tuỳ chỉnh hình thức của quảng cáo.

TemplateID là một chuỗi bắt buộc xác định mẫu gốc được dùng để hiển thị quảng cáo lớp phủ gốc. Sử dụng hằng số NativeTemplateID để chọn một mẫu gốc phù hợp cho quảng cáo của bạn.

Mã sau đây hiển thị quảng cáo lớp phủ gốc với một mẫu trung bình và kiểu tuỳ chỉnh.

/// <summary>
/// Renders the ad.
/// </summary>
public void RenderAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Rendering Native Overlay ad.");

        // Define a native template style with a custom style.
        var style = new NativeTemplateStyle
        {
            TemplateID = NativeTemplateID.Medium,
            MainBackgroundColor = Color.red,
            CallToActionText = new NativeTemplateTextStyles
            {
                BackgroundColor = Color.green,
                FontColor = Color.white,
                FontSize = 9,
                Style = NativeTemplateFontStyle.Bold
            }
        };

        // Renders a native overlay ad at the default size
        // and anchored to the bottom of the screne.
        _nativeOverlayAd.RenderTemplate(style, AdPosition.Bottom);
    }
}

Hiện và ẩn quảng cáo lớp phủ gốc

Mã sau đây minh hoạ cách hiển thị quảng cáo lớp phủ gốc đã tải.

/// <summary>
/// Shows the ad.
/// </summary>
public void ShowAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Showing Native Overlay ad.");
        _nativeOverlayAd.Show();
    }
}

Ẩn quảng cáo lớp phủ gốc

Mã sau đây minh hoạ cách ẩn quảng cáo lớp phủ gốc.

/// <summary>
/// Hides the ad.
/// </summary>
public void HideAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Hiding Native Overlay ad.");
        _nativeOverlayAd.Hide();
    }
}

Huỷ bỏ quảng cáo lớp phủ gốc

Khi hoàn tất việc sử dụng quảng cáo lớp phủ gốc, hãy nhớ gọi Destroy() để phát hành tài nguyên.

/// <summary>
/// Destroys the native overlay ad.
/// </summary>
public void DestroyAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Destroying native overlay ad.");
        _nativeOverlayAd.Destroy();
        _nativeOverlayAd = null;
    }
}