Quảng cáo xen kẽ có tặng thưởng (thử nghiệm)

Quảng cáo xen kẽ có tặng thưởng là một loại định dạng quảng cáo có tặng thưởng, cho phép bạn tặng thưởng cho những quảng cáo tự động xuất hiện tại các điểm chuyển tiếp tự nhiên của ứng dụng. Không giống như quảng cáo có tặng thưởng, người dùng không bắt buộc phải chọn xem quảng cáo xen kẽ có tặng thưởng.

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

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ể dùng để yêu cầu hiển thị 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, vì vậy, mã này rất an toàn để sử dụng.

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

Android

ca-app-pub-3940256099942544/5354046379

iOS

ca-app-pub-3940256099942544/6978759866

Khởi chạy SDK quảng cáo trên thiết bị di động

Trước khi tải quảng cáo, hãy để ứng dụng của bạn khởi chạy SDK quảng cáo trên thiết bị di động bằng cách gọi MobileAds.Initialize(). Bạn chỉ cần thực hiện việc này một lần, tốt nhất là khi khởi chạy ứng dụng.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

Nếu bạn đang sử dụng tính năng dàn xếp, hãy đợi cho đến khi lệnh gọi lại xảy ra trước khi tải quảng cáo vì điều này sẽ đảm bảo rằng tất cả các bộ chuyển đổi dàn xếp đều được khởi chạy.

Triển khai

Các bước chính để tích hợp quảng cáo xen kẽ có tặng thưởng là:

  1. Tải quảng cáo xen kẽ có tặng thưởng
  2. [Không bắt buộc] Xác thực lệnh gọi lại của tính năng xác minh phía máy chủ (SSV)
  3. Hiển thị quảng cáo xen kẽ có tặng thưởng với lệnh gọi lại phần thưởng
  4. Theo dõi các sự kiện của quảng cáo xen kẽ có tặng thưởng
  5. Xoá quảng cáo xen kẽ có tặng thưởng
  6. Tải trước quảng cáo xen kẽ có tặng thưởng tiếp theo

Tải quảng cáo xen kẽ có tặng thưởng

Bạn có thể tải một quảng cáo xen kẽ có tặng thưởng bằng cách sử dụng phương thức Load() tĩnh cho lớp RewardedInterstitialAd. Phương thức tải này yêu cầu một mã đơn vị quảng cáo, một đối tượng AdRequest và một trình xử lý hoàn thành để gọi khi tải quảng cáo thành công hoặc không thành công. Đối tượng RewardedInterstitialAd đã tải được cung cấp dưới dạng một thông số trong trình xử lý hoàn thành. Ví dụ bên dưới cho biết cách tải RewardedInterstitialAd.


  // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
  private string _adUnitId = "ca-app-pub-3940256099942544/5354046379";
#elif UNITY_IPHONE
  private string _adUnitId = "ca-app-pub-3940256099942544/6978759866";
#else
  private string _adUnitId = "unused";
#endif

  private RewardedInterstitialAd _rewardedInterstitialAd;

  /// <summary>
  /// Loads the rewarded interstitial ad.
  /// </summary>
  public void LoadRewardedInterstitialAd()
  {
      // Clean up the old ad before loading a new one.
      if (_rewardedInterstitialAd != null)
      {
            _rewardedInterstitialAd.Destroy();
            _rewardedInterstitialAd = null;
      }

      Debug.Log("Loading the rewarded interstitial ad.");

      // create our request used to load the ad.
      var adRequest = new AdRequest();
      adRequest.Keywords.Add("unity-admob-sample");

      // send the request to load the ad.
      RewardedInterstitialAd.Load(_adUnitId, adRequest,
          (RewardedInterstitialAd ad, LoadAdError error) =>
          {
              // if error is not null, the load request failed.
              if (error != null || ad == null)
              {
                  Debug.LogError("rewarded interstitial ad failed to load an ad " +
                                 "with error : " + error);
                  return;
              }

              Debug.Log("Rewarded interstitial ad loaded with response : "
                        + ad.GetResponseInfo());

              _rewardedInterstitialAd = ad;
          });
  }

[Không bắt buộc] Xác thực lệnh gọi lại của tính năng xác minh phía máy chủ (SSV)

Những ứng dụng cần có thêm dữ liệu về lệnh gọi lại của tính năng xác minh phía máy chủ nên sử dụng tính năng dữ liệu tuỳ chỉnh của quảng cáo xen kẽ có tặng thưởng. Bất kỳ giá trị chuỗi nào được đặt cho đối tượng quảng cáo có tặng thưởng đều sẽ được truyền đến tham số truy vấn custom_data cho lệnh gọi lại của SSV. Nếu bạn không đặt giá trị dữ liệu tuỳ chỉnh, thì giá trị tham số truy vấn custom_data sẽ không được đưa vào lệnh gọi lại SSV.

Mã mẫu sau đây minh hoạ cách đặt các lựa chọn của tính năng Phân tích lượt chuyển đổi (SSV) sau khi quảng cáo xen kẽ có tặng thưởng được tải.

// send the request to load the ad.
RewardedInterstitialAd.Load(_adUnitId,
                            adRequest,
                            (RewardedInterstitialAd ad, LoadAdError error) =>
    {
        // If the operation failed, an error is returned.
        if (error != null || ad == null)
        {
            Debug.LogError("Rewarded interstitial ad failed to load an ad " +
                           " with error : " + error);
            return;
        }

        // If the operation completed successfully, no error is returned.
        Debug.Log("Rewarded interstitial ad loaded with response : " +
                   ad.GetResponseInfo());
        
        // Create and pass the SSV options to the rewarded ad.
        var options = new ServerSideVerificationOptions
                              .Builder()
                              .SetCustomData("SAMPLE_CUSTOM_DATA_STRING")
                              .Build()
        ad.SetServerSideVerificationOptions(options);
        
});

Nếu muốn đặt chuỗi phần thưởng tuỳ chỉnh, bạn phải thực hiện trước khi hiển thị quảng cáo.

Hiển thị quảng cáo xen kẽ có tặng thưởng với lệnh gọi lại phần thưởng

Khi hiển thị quảng cáo, bạn phải cung cấp một lệnh gọi lại để xử lý phần thưởng cho người dùng. Quảng cáo chỉ có thể hiển thị một lần cho mỗi lượt tải. Hãy sử dụng phương thức CanShowAd() để xác minh rằng quảng cáo đã sẵn sàng hiển thị.

Bạn nên sử dụng đoạn mã sau đây để hiển thị một quảng cáo xen kẽ có tặng thưởng.

public void ShowRewardedInterstitialAd()
{
    const string rewardMsg =
        "Rewarded interstitial ad rewarded the user. Type: {0}, amount: {1}.";

    if (rewardedInterstitialAd != null && rewardedInterstitialAd.CanShowAd())
    {
        rewardedInterstitialAd.Show((Reward reward) =>
        {
            // TODO: Reward the user.
            Debug.Log(String.Format(rewardMsg, reward.Type, reward.Amount));
        });
    }
}

Theo dõi các sự kiện của quảng cáo xen kẽ có tặng thưởng

Để tuỳ chỉnh thêm hoạt động của quảng cáo, bạn có thể dựa vào một số sự kiện trong vòng đời của quảng cáo. Hãy theo dõi những sự kiện này bằng cách đăng ký một thực thể đại diện như minh hoạ bên dưới.

private void RegisterEventHandlers(RewardedInterstitialAd ad)
{
    // Raised when the ad is estimated to have earned money.
    ad.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("Rewarded interstitial ad paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    ad.OnAdImpressionRecorded += () =>
    {
        Debug.Log("Rewarded interstitial ad recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    ad.OnAdClicked += () =>
    {
        Debug.Log("Rewarded interstitial ad was clicked.");
    };
    // Raised when an ad opened full screen content.
    ad.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("Rewarded interstitial ad full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    ad.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("Rewarded interstitial ad full screen content closed.");
    };
    // Raised when the ad failed to open full screen content.
    ad.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Rewarded interstitial ad failed to open " +
                       "full screen content with error : " + error);
    };
}

Xoá quảng cáo xen kẽ có tặng thưởng

Khi bạn đã tạo xong RewardedInterstitialAd, hãy nhớ gọi phương thức Destroy() trước khi xoá thông tin tham chiếu đến đối tượng đó:

_rewardedInterstitialAd.Destroy();

Điều này thông báo cho trình bổ trợ rằng đối tượng này không còn được sử dụng nữa và dung lượng bộ nhớ mà đối tượng này chiếm có thể được thu hồi. Nếu không gọi phương thức này, bộ nhớ sẽ bị rò rỉ.

Tải trước quảng cáo xen kẽ có tặng thưởng tiếp theo

RewardedInterstitialAd là đối tượng dùng một lần. Điều này có nghĩa là sau khi quảng cáo xen kẽ có tặng thưởng xuất hiện, bạn sẽ không thể sử dụng lại đối tượng này. Để yêu cầu hiển thị một quảng cáo xen kẽ có tặng thưởng khác, bạn sẽ cần phải tải một đối tượng RewardedInterstitialAd mới.

Để chuẩn bị quảng cáo xen kẽ có tặng thưởng cho cơ hội hiển thị tiếp theo, hãy tải trước quảng cáo xen kẽ có tặng thưởng sau khi sự kiện quảng cáo OnAdFullScreenContentClosed hoặc OnAdFullScreenContentFailed xảy ra.

private void RegisterReloadHandler(RewardedInterstitialAd ad)
{
    // Raised when the ad closed full screen content.
    ad.OnAdFullScreenContentClosed += ()
    {
        Debug.Log("Rewarded interstitial ad full screen content closed.");

        // Reload the ad so that we can show another as soon as possible.
        LoadRewardedInterstitialAd();
    };
    // Raised when the ad failed to open full screen content.
    ad.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Rewarded interstitial ad failed to open " +
                       "full screen content with error : " + error);

        // Reload the ad so that we can show another as soon as possible.
        LoadRewardedInterstitialAd();
    };
}

Tài nguyên khác