Quảng cáo khi mở ứng dụng là một định dạng quảng cáo đặc biệt dành cho những nhà xuất bản muốn kiếm tiền từ màn hình tải ứng dụng của họ. Quảng cáo khi mở ứng dụng được thiết kế để xuất hiện khi người dùng chạy ứng dụng của bạn trên nền trước và họ có thể đóng quảng cáo này bất cứ lúc nào.
Quảng cáo khi mở ứng dụng tự động hiển thị một vùng nhỏ chứa thông tin thương hiệu để người dùng biết rằng họ đang ở trong ứng dụng của bạn. Dưới đây là một ví dụ về giao diện của quảng cáo khi mở ứng dụng:
Đ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 7.1.0 trở lên.
Luôn kiểm tra 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 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 webAd Manager và tạo các 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.
/6499/example/app-open
Triển khai
Các bước chính để tích hợp quảng cáo khi mở ứng dụng là:
- Tạo một lớp tiện ích
- Tải quảng cáo khi mở ứng dụng
- Theo dõi các sự kiện của quảng cáo khi mở ứng dụng
- Xem xét ngày hết hạn của quảng cáo
- Theo dõi các sự kiện về trạng thái ứng dụng
- Hiển thị quảng cáo khi mở ứng dụng
- Xoá quảng cáo khi mở ứng dụng
- Tải trước quảng cáo khi mở ứng dụng tiếp theo
Tạo một lớp tiện ích
Tạo một lớp mới có tên là AppOpenAdController để tải quảng cáo. Lớp này sẽ
kiểm soát một biến bản sao để theo dõi quảng cáo đã tải và mã đơn vị quảng cáo
cho từng nền tảng.
using System;
using UnityEngine;
using GoogleMobileAds.Api;
using GoogleMobileAds.Common;
/// <summary>
/// Demonstrates how to use the Google Mobile Ads app open ad format.
/// </summary>
[AddComponentMenu("GoogleMobileAds/Samples/AppOpenAdController")]
public class AppOpenAdController : MonoBehaviour
{
// This ad unit is configured to always serve test ads.
private string _adUnitId = "/6499/example/app-open";
public bool IsAdAvailable
{
get
{
return _appOpenAd != null;
}
}
public void Start()
{
// Initialize the Google Mobile Ads SDK.
MobileAds.Initialize((InitializationStatus initStatus) =>
{
// This callback is called once the MobileAds SDK is initialized.
});
}
/// <summary>
/// Loads the app open ad.
/// </summary>
public void LoadAppOpenAd()
{
}
/// <summary>
/// Shows the app open ad.
/// </summary>
public void ShowAppOpenAd()
{
}
}
Tải quảng cáo khi mở ứng dụng
Bạn có thể hoàn thành việc tải một quảng cáo khi mở ứng dụng bằng cách sử dụng phương thức Load() tĩnh cho
lớp AppOpenAd. 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 AdManagerAdRequest 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 AppOpenAd đã tải được
cung cấp dưới dạng một thông số trong trình xử lý hoàn thành. Dưới đây là ví dụ về cách tải một
AppOpenAd.
// This ad unit is configured to always serve test ads.
private string _adUnitId = "/6499/example/app-open";
private AppOpenAd appOpenAd;
/// <summary>
/// Loads the app open ad.
/// </summary>
public void LoadAppOpenAd()
{
// Clean up the old ad before loading a new one.
if (appOpenAd != null)
{
appOpenAd.Destroy();
appOpenAd = null;
}
Debug.Log("Loading the app open ad.");
// Create our request used to load the ad.
var adRequest = new AdManagerAdRequest();
// send the request to load the ad.
AppOpenAd.Load(_adUnitId, adRequest,
(AppOpenAd ad, LoadAdError error) =>
{
// if error is not null, the load request failed.
if (error != null || ad == null)
{
Debug.LogError("app open ad failed to load an ad " +
"with error : " + error);
return;
}
Debug.Log("App open ad loaded with response : "
+ ad.GetResponseInfo());
appOpenAd = ad;
RegisterEventHandlers(ad);
});
}
Theo dõi các sự kiện của quảng cáo khi mở ứng dụ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: mở, đóng và các sự kiện khác. Hãy 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ạ bên dưới.
private void RegisterEventHandlers(AppOpenAd ad)
{
// Raised when the ad is estimated to have earned money.
ad.OnAdPaid += (AdValue adValue) =>
{
Debug.Log(String.Format("App open ad paid {0} {1}.",
adValue.Value,
adValue.CurrencyCode));
};
// Raised when an impression is recorded for an ad.
ad.OnAdImpressionRecorded += () =>
{
Debug.Log("App open ad recorded an impression.");
};
// Raised when a click is recorded for an ad.
ad.OnAdClicked += () =>
{
Debug.Log("App open ad was clicked.");
};
// Raised when an ad opened full screen content.
ad.OnAdFullScreenContentOpened += () =>
{
Debug.Log("App open ad full screen content opened.");
};
// Raised when the ad closed full screen content.
ad.OnAdFullScreenContentClosed += () =>
{
Debug.Log("App open ad full screen content closed.");
};
// Raised when the ad failed to open full screen content.
ad.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("App open ad failed to open full screen content " +
"with error : " + error);
};
}
Xem xét ngày hết hạn của quảng cáo
Để đảm bảo bạn không hiển thị quảng cáo đã hết hạn, hãy thêm một phương thức vào
AppOpenAdController nhằm kiểm tra thời lượng kể từ khi quảng cáo của bạn được tải.
Sau đó, hãy sử dụng phương thức đó để kiểm tra xem liệu quảng cáo có còn hợp lệ hay không.
Quảng cáo khi mở ứng dụng có thời gian chờ là 4 giờ. Hãy lưu thời gian tải vào bộ nhớ đệm trong biến _expireTime.
// send the request to load the ad.
AppOpenAd.Load(_adUnitId, adRequest,
(AppOpenAd ad, LoadAdError error) =>
{
// If the operation failed, an error is returned.
if (error != null || ad == null)
{
Debug.LogError("App open ad failed to load an ad with error : " +
error);
return;
}
// If the operation completed successfully, no error is returned.
Debug.Log("App open ad loaded with response : " + ad.GetResponseInfo());
// App open ads can be preloaded for up to 4 hours.
_expireTime = DateTime.Now + TimeSpan.FromHours(4);
_appOpenAd = ad;
});
Cập nhật thuộc tính IsAdAvailable để kiểm tra _expireTime nhằm xác nhận rằng quảng cáo
đã tải vẫn hợp lệ.
public bool IsAdAvailable
{
get
{
return _appOpenAd != null
&& _appOpenAd.IsLoaded()
&& DateTime.Now < _expireTime;
}
}
Theo dõi các sự kiện về trạng thái ứng dụng
Sử dụng AppStateEventNotifier để theo dõi các sự kiện trong nền và
nền trước của ứng dụng. Lớp này sẽ kích hoạt sự kiện AppStateChanged bất cứ lúc nào
ở nền trước hoặc trong nền của ứng dụng.
private void Awake()
{
// Use the AppStateEventNotifier to listen to application open/close events.
// This is used to launch the loaded ad when we open the app.
AppStateEventNotifier.AppStateChanged += OnAppStateChanged;
}
private void OnDestroy()
{
// Always unlisten to events when complete.
AppStateEventNotifier.AppStateChanged -= OnAppStateChanged;
}
Khi xử lý trạng thái AppState.Foreground và IsAdAvailable
là true, chúng ta sẽ gọi ShowAppOpenAd() để hiển thị quảng cáo.
private void OnAppStateChanged(AppState state)
{
Debug.Log("App State changed to : "+ state);
// if the app is Foregrounded and the ad is available, show it.
if (state == AppState.Foreground)
{
if (IsAdAvailable)
{
ShowAppOpenAd();
}
}
}
Hiển thị quảng cáo khi mở ứng dụng
Để hiển thị quảng cáo khi mở ứng dụng đã tải, hãy gọi phương thức Show() cho bản sao của AppOpenAd. 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ị.
/// <summary>
/// Shows the app open ad.
/// </summary>
public void ShowAppOpenAd()
{
if (appOpenAd != null && appOpenAd.CanShowAd())
{
Debug.Log("Showing app open ad.");
appOpenAd.Show();
}
else
{
Debug.LogError("App open ad is not ready yet.");
}
}
Xoá quảng cáo khi mở ứng dụng
Khi bạn đã tạo xong AppOpenAd, hãy nhớ gọi phương thức Destroy()
trước khi xoá thông tin dẫn chiếu đến đối tượng đó:
appOpenAd.Destroy();
Hành động này thông báo cho các 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 sử dụng có thể bị 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 khi mở ứng dụng tiếp theo
AppOpenAd là đối tượng dùng một lần. Điều này có nghĩa là sau khi quảng cáo khi mở ứng dụng hiển thị,
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 khi mở ứng dụng khác,
bạn cần phải tạo một đối tượng AppOpenAd mới.
Để chuẩn bị quảng cáo khi mở ứng dụng cho cơ hội hiển thị tiếp theo, hãy tải trước
quảng cáo khi mở ứng dụng sau khi sự kiện quảng cáo OnAdFullScreenContentClosed hoặc
OnAdFullScreenContentFailed xảy ra.
private void RegisterReloadHandler(AppOpenAd ad)
{
...
// Raised when the ad closed full screen content.
ad.OnAdFullScreenContentClosed += ()
{
Debug.Log("App open ad full screen content closed.");
// Reload the ad so that we can show another as soon as possible.
LoadAppOpenAd();
};
// Raised when the ad failed to open full screen content.
ad.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("App open ad failed to open full screen content " +
"with error : " + error);
// Reload the ad so that we can show another as soon as possible.
LoadAppOpenAd();
};
}
Khởi động nguội và màn hình tải
Cho đến nay, tài liệu này giả định rằng bạn chỉ hiển thị quảng cáo khi mở ứng dụng khi người dùng đưa ứng dụng của bạn lên nền trước khi ứng dụng đang bị tạm ngưng trong bộ nhớ. "Khởi động nguội" xảy ra khi người dùng chạy ứng dụng của bạn nhưng trước đó không bị tạm ngưng trong bộ nhớ.
Một ví dụ về khởi động nguội là khi người dùng mở ứng dụng của bạn lần đầu tiên. Khi khởi động nguội, quảng cáo khi mở ứng dụng chưa được tải trước đó sẽ không sẵn sàng để hiển thị ngay lập tức. Một tình huống trong đó người dùng có thể sử dụng ứng dụng của bạn trong thời gian ngắn trước khi bị một quảng cáo không theo bối cảnh gây bất ngờ. Bạn nên tránh làm như vậy vì đây sẽ là trải nghiệm không tốt cho người dùng.
Để sử dụng quảng cáo khi mở ứng dụng vào lúc khởi động nguội, bạn nên sử dụng màn hình tải để tải các thành phần trò chơi hoặc ứng dụng và chỉ nên hiển thị quảng cáo trên màn hình tải. Nếu ứng dụng đã tải xong và đã đưa người dùng đến nội dung chính của ứng dụng, thì bạn đừng hiển thị quảng cáo.
Các phương pháp hay nhất
Quảng cáo khi mở ứng dụng giúp bạn kiếm tiền từ màn hình tải của ứng dụng khi ứng dụng khởi chạy lần đầu tiên và trong quá trình chuyển đổi ứng dụng. Tuy nhiên, bạn cần lưu ý các phương pháp hay nhất sau đây để người dùng thích sử dụng ứng dụng của bạn.
- Hiển thị quảng cáo khi mở ứng dụng đầu tiên sau khi người dùng sử dụng ứng dụng của bạn vài lần.
- Hiển thị quảng cáo khi mở ứng dụng trong thời gian người dùng chờ ứng dụng tải.
- Nếu bạn có màn hình tải trong quảng cáo khi mở ứng dụng và màn hình tải
sẽ tải xong trước khi quảng cáo bị đóng, hãy đóng màn hình tải trong
trình xử lý sự kiện
OnAdDidDismissFullScreenContent. - Trên nền tảng iOS,
AppStateEventNotifiersẽ tạo thực thể cho mộtAppStateEventClient GameObject.GameObjectnày là bắt buộc để kích hoạt các sự kiện, vì vậy, không huỷ bỏ sự kiện đó. Các sự kiện ngừng kích hoạt nếuGameObjectbị huỷ bỏ.
Tài nguyên khác
- Ví dụ về HelloWorld: Cách triển khai tối giản cho mọi định dạng quảng cáo.