Reklamy z nagrodą to reklamy, z którymi użytkownicy mogą wchodzić w interakcje w zamian za nagrody w aplikacji. Z tego przewodnika dowiesz się, jak zintegrować reklamy z nagrodą z AdMob w aplikacji na platformie Unity.
Poznaj historie sukcesu klientów: studium przypadku 1, studium przypadku 2.Ten przewodnik wyjaśnia, jak zintegrować reklamy z nagrodą z aplikacją na platformie Unity.
Wymagania wstępne
- Zapoznaj się z przewodnikiem dla początkujących.
Zawsze korzystaj z reklam testowych
Poniższy przykładowy kod zawiera identyfikator jednostki reklamowej, którego możesz użyć do wysłania żądania reklam testowych. Został on specjalnie skonfigurowany tak, aby w przypadku każdego żądania zwracać reklamy testowe zamiast reklam produkcyjnych, dzięki czemu można z niego korzystać.
Gdy jednak zarejestrujesz aplikację wAdMob interfejsie internetowym i utworzysz własne identyfikatory jednostek reklamowych do wykorzystania w niej, podczas jej tworzenia skonfiguruj urządzenie jako urządzenie testowe.
Android
ca-app-pub-3940256099942544/5224354917
iOS
ca-app-pub-3940256099942544/1712485313
Inicjowanie pakietu SDK do reklam mobilnych
Przed wczytaniem reklam Twoja aplikacja musi zainicjować pakiet SDK do reklam mobilnych, wywołując MobileAds.Initialize()
. Wystarczy to zrobić tylko raz, najlepiej przy uruchomieniu 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 używasz zapośredniczenia, poczekaj z załadowaniem reklam na wywołanie zwrotne, ponieważ dzięki temu wszystkie adaptery zapośredniczenia zostaną zainicjowane.
Implementacja
Oto główne etapy integracji z reklamami z nagrodą:
- Wczytaj reklamę z nagrodą
- [Opcjonalnie] Weryfikacja wywołań zwrotnych weryfikacji po stronie serwera (SSV)
- Pokaż reklamę z nagrodą z wywołaniem zwrotnym nagrody
- Odsłuchaj zdarzenia reklamy z nagrodą
- Wyczyść reklamę z nagrodą
- Wstępnie wczytaj następną reklamę z nagrodą
Wczytaj reklamę z nagrodą
Reklamę z nagrodą można wczytać za pomocą statycznej metody Load()
w klasie RewardedAd
. Wczytany obiekt RewardedAd
jest dostarczany jako parametr w module obsługi uzupełniania. Przykład poniżej pokazuje, jak wczytać RewardedAd
.
// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
private string _adUnitId = "ca-app-pub-3940256099942544/5224354917";
#elif UNITY_IPHONE
private string _adUnitId = "ca-app-pub-3940256099942544/1712485313";
#else
private string _adUnitId = "unused";
#endif
private RewardedAd _rewardedAd;
/// <summary>
/// Loads the rewarded ad.
/// </summary>
public void LoadRewardedAd()
{
// Clean up the old ad before loading a new one.
if (_rewardedAd != null)
{
_rewardedAd.Destroy();
_rewardedAd = null;
}
Debug.Log("Loading the rewarded ad.");
// create our request used to load the ad.
var adRequest = new AdRequest();
// send the request to load the ad.
RewardedAd.Load(_adUnitId, adRequest,
(RewardedAd ad, LoadAdError error) =>
{
// if error is not null, the load request failed.
if (error != null || ad == null)
{
Debug.LogError("Rewarded ad failed to load an ad " +
"with error : " + error);
return;
}
Debug.Log("Rewarded ad loaded with response : "
+ ad.GetResponseInfo());
_rewardedAd = ad;
});
}
[Opcjonalnie] Weryfikacja wywołań zwrotnych weryfikacji po stronie serwera (SSV)
Aplikacje, które wymagają dodatkowych danych w wywołaniach zwrotnych weryfikacji po stronie serwera, powinny używać funkcji danych niestandardowych reklam z nagrodą.
Każda wartość ciągu znaków ustawiona w obiekcie reklamy z nagrodą jest przekazywana do parametru zapytania custom_data
w wywołaniu zwrotnym SSV. Jeśli nie ustawisz niestandardowych wartości danych, wartość parametru zapytania custom_data
nie będzie widoczna w wywołaniu zwrotnym SSV.
Poniższy przykładowy kod pokazuje, jak ustawić opcje SSV po wczytaniu reklamy z nagrodą.
// send the request to load the ad.
RewardedAd.Load(_adUnitId, adRequest, (RewardedAd ad, LoadAdError error) =>
{
// If the operation failed, an error is returned.
if (error != null || ad == null)
{
Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
return;
}
// If the operation completed successfully, no error is returned.
Debug.Log("Rewarded 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);
});
Jeśli chcesz ustawić niestandardowy ciąg nagrody, musisz to zrobić przed wyświetleniem reklamy.
Pokaż reklamę z nagrodą z wywołaniem zwrotnym nagrody
Podczas wyświetlania reklamy musisz podać wywołanie zwrotne w celu obsłużenia nagrody dla użytkownika. Reklamy mogą być wyświetlane tylko raz na wczytanie. Użyj metody CanShowAd()
, aby sprawdzić, czy reklama jest gotowa do wyświetlenia.
Poniższy kod przedstawia najlepszą metodę wyświetlania reklamy z nagrodą.
public void ShowRewardedAd()
{
const string rewardMsg =
"Rewarded ad rewarded the user. Type: {0}, amount: {1}.";
if (rewardedAd != null && rewardedAd.CanShowAd())
{
rewardedAd.Show((Reward reward) =>
{
// TODO: Reward the user.
Debug.Log(String.Format(rewardMsg, reward.Type, reward.Amount));
});
}
}
Odsłuchaj zdarzenia reklamy z nagrodą
Aby jeszcze bardziej dostosować działanie reklamy, możesz uwzględnić kilka zdarzeń w jej cyklu życia: otwarcie, zamknięcie itp. Nasłuchuj tych zdarzeń, rejestrując przedstawiciela w sposób pokazany poniżej.
private void RegisterEventHandlers(RewardedAd ad)
{
// Raised when the ad is estimated to have earned money.
ad.OnAdPaid += (AdValue adValue) =>
{
Debug.Log(String.Format("Rewarded ad paid {0} {1}.",
adValue.Value,
adValue.CurrencyCode));
};
// Raised when an impression is recorded for an ad.
ad.OnAdImpressionRecorded += () =>
{
Debug.Log("Rewarded ad recorded an impression.");
};
// Raised when a click is recorded for an ad.
ad.OnAdClicked += () =>
{
Debug.Log("Rewarded ad was clicked.");
};
// Raised when an ad opened full screen content.
ad.OnAdFullScreenContentOpened += () =>
{
Debug.Log("Rewarded ad full screen content opened.");
};
// Raised when the ad closed full screen content.
ad.OnAdFullScreenContentClosed += () =>
{
Debug.Log("Rewarded ad full screen content closed.");
};
// Raised when the ad failed to open full screen content.
ad.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("Rewarded ad failed to open full screen content " +
"with error : " + error);
};
}
Wyczyść reklamę z nagrodą
Gdy skończysz korzystać z RewardedAd
, pamiętaj, by przed przeniesieniem do niego odwołania wywołać metodę Destroy()
:
_rewardedAd.Destroy();
Wtyczka powiadomi wtyczkę, że obiekt nie jest już używany, a zajmowaną przez niego pamięć można odzyskać. Niewywołanie tej metody może spowodować wycieki pamięci.
Wstępnie wczytaj następną reklamę z nagrodą
RewardedAd
to obiekt jednorazowy. Oznacza to, że po wyświetleniu reklamy z nagrodą nie będzie można ponownie użyć obiektu. Aby poprosić o kolejną reklamę z nagrodą, musisz utworzyć nowy obiekt RewardedAd
.
Aby przygotować reklamę z nagrodą na następne wyświetlenie, wczytaj ją wstępnie po wywołaniu zdarzenia reklamowego OnAdFullScreenContentClosed
lub OnAdFullScreenContentFailed
.
private void RegisterReloadHandler(RewardedAd ad)
{
// Raised when the ad closed full screen content.
ad.OnAdFullScreenContentClosed += () =>
{
Debug.Log("Rewarded Ad full screen content closed.");
// Reload the ad so that we can show another as soon as possible.
LoadRewardedAd();
};
// Raised when the ad failed to open full screen content.
ad.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("Rewarded ad failed to open full screen content " +
"with error : " + error);
// Reload the ad so that we can show another as soon as possible.
LoadRewardedAd();
};
}
Dodatkowe materiały
- Przykład HelloWorld: minimalna implementacja wszystkich formatów reklam.