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 họ đang mở ứng dụng của bạn. Dưới đây là một ví dụ về cách hiển thị 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 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 của Ad Manager 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.
/21775744923/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 thời 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 = "/21775744923/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 = "/21775744923/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ý một thực thể đại diệ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 thời 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 để 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 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ờ. 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 tham chiếu đến đối tượng đó:
appOpenAd.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 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
Từ đầu đến giờ, 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 vào lúc người dùng đưa ứng dụng của bạn lên nền trước khi ứng dụng bị tạm ngưng trong bộ nhớ. Quy trì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 đó, ứng dụng 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. Trong trường hợp khởi động nguội, quảng cáo khi mở ứng dụng chưa được tải trước lần nào nên chưa sẵn sàng để hiển thị ngay lập tức. Một tình huống có thể xảy ra trong khoảng thời gian từ khi bạn yêu cầu quảng cáo cho đến khi nhận được quảng cáo (gọi là độ trễ), đó là người dùng vừa mới sử dụng ứng dụng của bạn trong chốc lát thì một quảng cáo không phù hợp đột ngột xuất hiện khiến họ bị bất ngờ. Bạn nên tránh làm như vậy vì điều này sẽ tạo ra trải nghiệm kém 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, cách tốt nhất là bạn nên 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 chạy lần đầu và khi chuyển đổi ứng dụng. Tuy nhiên, bạn cần ghi nhớ 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 của bạn 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 đó đã 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,
AppStateEventNotifiertạo bản sao choAppStateEventClient GameObject. Bạn phải sử dụngGameObjectnày để kích hoạt các sự kiện, nên đừng huỷ bỏ nó. Các sự kiện sẽ 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.