Reklamy pełnoekranowe zakrywają interfejs aplikacji, w której się wyświetlają. Zazwyczaj wyświetlają się w naturalnych punktach przejścia w aplikacji. np. podczas przerwy między poziomami w grze. Gdy aplikacja wyświetla reklama pełnoekranowa, użytkownik może ją kliknąć i przejść do jej stronę docelową lub zamknąć ją i wrócić do aplikacji.
Z tego przewodnika dowiesz się, jak zintegrować reklamy pełnoekranowe z aplikacją w Unity.
Wymagania wstępne
- Zapoznaj się z przewodnikiem dla początkujących.
Zawsze korzystaj z reklam testowych
Ten przykładowy kod zawiera identyfikator jednostki reklamowej, którego możesz użyć do przesłania żądania reklam testowych. Został on skonfigurowany tak, aby wyświetlać reklamy testowe, a nie aby tworzyć bezpieczne reklamy dla każdego żądania.
Jeśli jednak zarejestrujesz aplikację w Interfejs internetowy Ad Managera i utworzona własną jednostkę reklamową Identyfikatory do wykorzystania w aplikacji; jawnie skonfiguruj urządzenie jako testowe urządzenia w trakcie w Google Cloud.
/6499/example/interstitial
Zainicjowanie pakietu SDK do reklam mobilnych
Przed wczytaniem reklam poproś aplikację o zainicjowanie pakietu SDK do reklam mobilnych, wywołując
MobileAds.Initialize() Wystarczy to zrobić tylko raz, najlepiej podczas uruchamiania aplikacji.
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.
});
}
}
Jeśli korzystasz z zapośredniczenia, poczekaj, aż nastąpi wywołanie zwrotne, zanim wczytasz reklamy jako Dzięki temu wszystkie adaptery zapośredniczenia zostaną zainicjowane.
Implementacja
Główne etapy integracji reklam pełnoekranowych:
- Wczytaj reklamę pełnoekranową
- Pokaż reklamę pełnoekranową
- Odsłuchiwanie zdarzeń reklamy pełnoekranowej
- Wyczyść reklamę pełnoekranową
- Wstępnie wczytaj następną reklamę pełnoekranową
Wczytaj reklamę pełnoekranową
Reklamę pełnoekranową można wczytać za pomocą statycznej metody Load() na stronie
InterstitialAd zajęcia. Metoda wczytywania wymaga identyfikatora jednostki reklamowej,
AdManagerAdRequest i moduł obsługi uzupełniania,
jest wywoływana, gdy reklama zostanie wczytana lub nie uda się. Wczytany
Obiekt AdManagerInterstitialAd jest podawany jako parametr w
z modułem do obsługi uzupełniania. Poniższy przykład pokazuje, jak wczytać
AdManagerInterstitialAd
// This ad unit is configured to always serve test ads.
private string _adUnitId = "/6499/example/interstitial";
private InterstitialAd _interstitialAd;
/// <summary>
/// Loads the interstitial ad.
/// </summary>
public void LoadInterstitialAd()
{
// Clean up the old ad before loading a new one.
if (_interstitialAd != null)
{
_interstitialAd.Destroy();
_interstitialAd = null;
}
Debug.Log("Loading the interstitial ad.");
// create our request used to load the ad.
var adRequest = new AdManagerAdRequest();
// send the request to load the ad.
AdManagerInterstitialAd.Load(_adUnitId, adRequest,
(InterstitialAd ad, LoadAdError error) =>
{
// if error is not null, the load request failed.
if (error != null || ad == null)
{
Debug.LogError("interstitial ad failed to load an ad " +
"with error : " + error);
return;
}
Debug.Log("Interstitial ad loaded with response : "
+ ad.GetResponseInfo());
_interstitialAd = ad;
});
}
Pokaż reklamę pełnoekranową
Aby wyświetlić wczytaną reklamę pełnoekranową, wywołaj metodę Show() w
AdManagerInterstitialAd instancję. Reklamy mogą być wyświetlane raz na
strony. Użyj metody CanShowAd(), aby sprawdzić, czy reklama jest gotowa do wyświetlenia.
/// <summary>
/// Shows the interstitial ad.
/// </summary>
public void ShowInterstitialAd()
{
if (_interstitialAd != null && _interstitialAd.CanShowAd())
{
Debug.Log("Showing interstitial ad.");
_interstitialAd.Show();
}
else
{
Debug.LogError("Interstitial ad is not ready yet.");
}
}
Odsłuchiwanie zdarzeń reklamy pełnoekranowej
Aby jeszcze bardziej dostosować działanie swojej reklamy, możesz wykorzystać różne zdarzenia w cyklu życia reklamy. Wykrywaj te zdarzenia, rejestrując przedstawiciela jak pokazano poniżej.
private void RegisterEventHandlers(InterstitialAd interstitialAd)
{
// Raised when the ad is estimated to have earned money.
interstitialAd.OnAdPaid += (AdValue adValue) =>
{
Debug.Log(String.Format("Interstitial ad paid {0} {1}.",
adValue.Value,
adValue.CurrencyCode));
};
// Raised when an impression is recorded for an ad.
interstitialAd.OnAdImpressionRecorded += () =>
{
Debug.Log("Interstitial ad recorded an impression.");
};
// Raised when a click is recorded for an ad.
interstitialAd.OnAdClicked += () =>
{
Debug.Log("Interstitial ad was clicked.");
};
// Raised when an ad opened full screen content.
interstitialAd.OnAdFullScreenContentOpened += () =>
{
Debug.Log("Interstitial ad full screen content opened.");
};
// Raised when the ad closed full screen content.
interstitialAd.OnAdFullScreenContentClosed += () =>
{
Debug.Log("Interstitial ad full screen content closed.");
};
// Raised when the ad failed to open full screen content.
interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("Interstitial ad failed to open full screen content " +
"with error : " + error);
};
}
Wyczyść reklamę pełnoekranową
Gdy skończysz pracę z AdManagerInterstitialAd, zrób
pamiętaj, aby przed usunięciem odwołania wywołać do niej metodę Destroy():
_interstitialAd.Destroy();
Wtyczka powiadomi wtyczkę, że obiekt nie jest już używany, a także jego pamięć można odzyskać. Niewywołanie tej metody może spowodować wycieki pamięci.
Wstępnie wczytaj następną reklamę pełnoekranową
Reklamy pełnoekranowe są przeznaczone do jednorazowego użytku. Oznacza to, że po wyświetleniu reklamy pełnoekranowej
obiektu, nie można go użyć ponownie. Aby poprosić o kolejną reklamę pełnoekranową:
utwórz nowy obiekt AdManagerInterstitialAd.
Aby przygotować reklamę pełnoekranową na następne wyświetlenie, wczytaj wstępnie element
reklama pełnoekranowa.OnAdFullScreenContentClosed
Zgłoszono OnAdFullScreenContentFailed zdarzenie reklamowe.
private void RegisterReloadHandler(InterstitialAd interstitialAd)
{
// Raised when the ad closed full screen content.
interstitialAd.OnAdFullScreenContentClosed += ()
{
Debug.Log("Interstitial Ad full screen content closed.");
// Reload the ad so that we can show another as soon as possible.
LoadInterstitialAd();
};
// Raised when the ad failed to open full screen content.
interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("Interstitial ad failed to open full screen content " +
"with error : " + error);
// Reload the ad so that we can show another as soon as possible.
LoadInterstitialAd();
};
}
Zdarzenia w aplikacjach
Zdarzenia w aplikacji pozwalają tworzyć reklamy, które mogą wysyłać komunikaty do kodu aplikacji. Aplikacja mogą podejmować działania na podstawie tych komunikatów.
Możesz nasłuchiwać zdarzeń Ad Managera w aplikacjach za pomocą narzędzia AppEvent. Te wydarzenia
może wystąpić w dowolnym momencie cyklu życia reklamy, nawet przed wywołaniem wczytywania.
namespace GoogleMobileAds.Api.AdManager;
/// The App event message sent from the ad.
public class AppEvent
{
// Name of the app event.
string Name;
// Argument passed from the app event.
string Value;
}
Wartość OnAppEventReceived jest podwyższana, gdy w reklamie wystąpi zdarzenie w aplikacji. Oto
przykład obsługi tego zdarzenia w kodzie:
_interstitialAd.OnAppEventReceived += (AppEvent args) =>
{
Debug.Log($"Received app event from the ad: {args.Name}, {args.Value}.");
};
Oto przykład, który pokazuje, jak zmienić kolor tła aplikacji w zależności od zdarzenia w aplikacji o nazwie koloru:
_interstitialAd.OnAppEventReceived += (AppEvent args) =>
{
if (args.Name == "color")
{
Color color;
if (ColorUtility.TryParseColor(arg.Value, out color))
{
gameObject.GetComponent<Renderer>().material.color = color;
}
}
};
A oto odpowiednia kreacja wysyłająca zdarzenie w aplikacji koloru:
<html>
<head>
<script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
<script>
document.addEventListener("DOMContentLoaded", function() {
// Send a color=green event when ad loads.
admob.events.dispatchAppEvent("color", "green");
document.getElementById("ad").addEventListener("click", function() {
// Send a color=blue event when ad is clicked.
admob.events.dispatchAppEvent("color", "blue");
});
});
</script>
<style>
#ad {
width: 320px;
height: 50px;
top: 0px;
left: 0px;
font-size: 24pt;
font-weight: bold;
position: absolute;
background: black;
color: white;
text-align: center;
}
</style>
</head>
<body>
<div id="ad">Carpe diem!</div>
</body>
</html>
Sprawdzone metody
- Ustal, czy reklamy pełnoekranowe to odpowiedni typ reklamy do Twojej aplikacji.
- Reklamy pełnoekranowe sprawdzają się najlepiej w aplikacjach z naturalnymi punktami przejściowymi. Zakończenie zadania w aplikacji, np. udostępnienie obrazu lub ukończenie zadania poziom gry, tworzy taki punkt. Zastanów się, w których momentach jak najlepiej wyświetlać reklamy pełnoekranowe w aplikacji i jak użytkownik na nie zareaguje.
- Możesz wstrzymać działanie podczas wyświetlania reklamy pełnoekranowej.
- Jest wiele różnych typów reklam pełnoekranowych, takich jak reklamy tekstowe,
graficzny lub wideo. Upewnij się, że gdy aplikacja wyświetla
reklama pełnoekranowa wstrzymuje również korzystanie z niektórych zasobów, aby umożliwić
jak je wykorzystać. Na przykład gdy wykonujesz wywołanie dotyczące wyświetlenia
reklama pełnoekranowa, pamiętaj o wstrzymaniu wszystkich wyjść audio generowanych przez aplikację.
Możesz wznowić odtwarzanie dźwięków w zdarzeniu
OnAdFullScreenContentClosed(), który można wywołać, gdy użytkownik zakończy interakcję z reklamą. W warto tymczasowo wstrzymać wykonywanie intensywnych zadań obliczeniowych, takich jak w czasie wyświetlania reklamy. Dzięki temu użytkownik nie będzie wolno lub nie reaguje na obraz albo zacina się podczas odtwarzania filmu. - Nie zasypuj reklam reklamami.
- Zwiększenie częstotliwości wyświetlania reklam pełnoekranowych w aplikacji może się wydawać świetnym sposobem na zwiększenie przychodów, ale może też pogarszać wrażenia użytkowników i niższych współczynnikach klikalności. Dopilnuj, aby użytkownicy nie zaglądali zbyt często gdy użytkownik nie może już korzystać z Twojej aplikacji.
Dodatkowe materiały
- Przykład HelloWorld: Minimalne wdrożenie wszystkich formatów reklam.