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 thêm phần thưởng vào 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 người dù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
- Xem hết Hướng dẫn bắt đầu sử dụng.
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, vì vậy, mã này rất an toàn để 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.
/21775744923/example/rewarded-interstitial
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 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 bắt đầu 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 khởi động.
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à:
- Tải quảng cáo xen kẽ có tặng thưởng
- [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)
- 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
- Theo dõi các sự kiện của quảng cáo xen kẽ có tặng thưởng
- Xoá quảng cáo xen kẽ có tặng thưởng
- 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ể hoàn thành việc tải một quảng cáo xen kẽ có tặng thưởng bằng cách sử dụng Load()
tĩnh
trên lớp RewardedInterstitialAd
. Phương thức tải yêu cầu một quảng cáo
mã đơn vị, một đối tượng AdManagerAdRequest
và một lượt hoàn thành
trình xử lý được gọi khi tải quảng cáo thành công hoặc không thành công. Các URL đã tải
Đối tượng RewardedInterstitialAd
được cung cấp dưới dạng tham số trong phần hoàn thành
trình xử lý. Ví dụ bên dưới cho biết cách tải một RewardedInterstitialAd
.
// This ad unit is configured to always serve test ads.
private string _adUnitId = "/21775744923/example/rewarded-interstitial";
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 AdManagerAdRequest();
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)
Ứng dụng yêu cầu thêm dữ liệu trong quy trình xác minh phía máy chủ
Các lệnh gọi lại nên sử dụng tính năng dữ liệu tùy 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 trên đối tượng quảng cáo có tặng thưởng đều được truyền đến custom_data
tham số truy vấn của lệnh gọi lại adb. Nếu không có giá trị dữ liệu tuỳ chỉnh nào được đặt, thì giá trị
Giá trị tham số truy vấn custom_data
sẽ không được đưa vào lệnh gọi lại của SSO.
Mã mẫu sau đây minh hoạ cách đặt các tuỳ chọn của tính năng SSO sau 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 lệnh gọi lại để xử lý phần thưởng cho
người dùng. Quảng cáo chỉ có thể xuất hiện một lần cho mỗi lượt tải. Sử dụng phương thức CanShowAd()
để
xác minh rằng quảng cáo đã sẵn sàng để hiển thị.
Đoạn mã sau đây trình bày phương pháp tốt nhất để hiển thị quảng cáo có tặng thưởng quảng cáo xen kẽ.
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. Theo dõi những sự kiện này bằng cách đăng ký người được uỷ quyền như minh hoạ dưới đây.
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);
};
}
Dọn dẹp quảng cáo xen kẽ có tặng thưởng
Khi bạn đã hoàn tất với RewardedInterstitialAd
, hãy nhớ gọi phương thức
Destroy()
trước khi xoá tệp tham chiếu đến đối tượng đó:
_rewardedInterstitialAd.Destroy();
Thao tác này sẽ thông báo cho trình bổ trợ rằng đối tượng không còn được sử dụng nữa và bộ nhớ mà đối tượng đó không còn được sử dụng. chiếm lại có thể được xác nhận lại. Nếu không gọi được 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 một phần thưởng
quảng cáo xen kẽ xuất hiện, nên bạn không thể sử dụng lại đối tượng này. Để yêu cầu một URL khác
quảng cáo xen kẽ có tặng thưởng, bạn sẽ cần tải một 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,
tải trước quảng cáo xen kẽ có tặng thưởng sau khi OnAdFullScreenContentClosed
hoặc
OnAdFullScreenContentFailed
sự kiện quảng cáo đã được tạo.
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
- Ví dụ về HelloWorld: Cách triển khai tối giản cho tất cả định dạng quảng cáo.