Les annonces avec récompense sont des annonces avec lesquelles les utilisateurs ont la possibilité d'interagir en échange pour obtenir des récompenses dans l'application. Ce guide vous explique comment intégrer des annonces avec récompense dans une application Unity.
Lisez des témoignages de clients: étude de cas 1, étude de cas 2.Ce guide explique comment intégrer des annonces avec récompense dans une application Unity.
Prérequis
- Suivez le guide de démarrage.
Toujours tester avec des annonces tests
L'exemple de code suivant contient un ID de bloc d'annonces que vous pouvez utiliser pour demander des annonces tests. Il a été spécialement configuré pour renvoyer des annonces tests des annonces de production pour chaque requête, ce qui vous permet de les utiliser en toute sécurité.
Cependant, une fois que vous avez enregistré une application dans L'interface Web AdMob et créé votre propre bloc d'annonces ID à utiliser dans votre application, configurez explicitement votre appareil en tant que test de l'appareil développement d'applications.
Android
ca-app-pub-3940256099942544/5224354917
iOS
ca-app-pub-3940256099942544/1712485313
Initialiser le SDK Mobile Ads
Avant de charger les annonces, demandez à votre application d'initialiser le SDK Mobile Ads en appelant
MobileAds.Initialize()
Cette opération ne doit être effectuée qu'une seule fois, idéalement au lancement de l'application.
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.
});
}
}
Si vous utilisez la médiation, attendez que le rappel ait lieu avant de charger les annonces en tant que afin de garantir que tous les adaptateurs de médiation sont initialisés.
Implémentation
Voici les principales étapes à suivre pour intégrer des annonces avec récompense:
- Charger l'annonce avec récompense
- [Facultatif] Valider les rappels de validation côté serveur (SSV)
- Diffuser l'annonce avec récompense avec un rappel associé à la récompense
- Écouter des événements d'annonces avec récompense
- Nettoyer l'annonce avec récompense
- Précharger la prochaine annonce avec récompense
Charger l'annonce avec récompense
Le chargement d'une annonce avec récompense s'effectue à l'aide de la méthode statique Load()
sur la
RewardedAd
. L'objet RewardedAd
chargé est fourni en tant que
dans le gestionnaire d'achèvement. L'exemple ci-dessous montre comment charger un
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;
});
}
[Facultatif] Valider les rappels de validation côté serveur (SSV)
Applications nécessitant des données supplémentaires lors de la validation côté serveur
les rappels doivent utiliser la fonctionnalité de données personnalisées des annonces avec récompense.
Toute valeur de chaîne définie sur un objet d'annonce avec récompense est transmise à custom_data
paramètre de requête du rappel SSV. Si aucune valeur de données personnalisées n'est définie, le
La valeur du paramètre de requête custom_data
ne sera pas présente dans le rappel de validation côté serveur.
L'exemple de code suivant montre comment définir les options de validation côté serveur après la l'annonce avec récompense est chargée.
// 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);
});
Si vous souhaitez définir une chaîne de récompense personnalisée, vous devez le faire avant d'afficher la annonce.
Diffuser l'annonce avec récompense avec un rappel associé à la récompense
Lorsque vous présentez votre annonce, vous devez fournir un rappel pour gérer la récompense pour
l'utilisateur. Les annonces ne peuvent être diffusées qu'une seule fois par chargement. Utilisez la méthode CanShowAd()
pour
vérifier que l'annonce est prête à être diffusée
Le code suivant présente la meilleure méthode pour diffuser une annonce avec récompense.
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));
});
}
}
Écouter des événements d'annonces avec récompense
Pour personnaliser davantage le comportement de votre annonce, vous pouvez intégrer un certain nombre les événements du cycle de vie de l'annonce: ouverture, fermeture, etc. Écouter ces événements en enregistrant un délégué comme indiqué ci-dessous.
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);
};
}
Nettoyer l'annonce avec récompense
Lorsque vous avez terminé avec un RewardedAd
, veillez à appeler Destroy()
avant d'y déposer votre référence:
_rewardedAd.Destroy();
Cela indique au plug-in que l'objet n'est plus utilisé et la mémoire qu'il occupée peut être récupérée. L'échec de l'appel de cette méthode entraîne des fuites de mémoire.
Précharger la prochaine annonce avec récompense
RewardedAd
est un objet à usage unique. Cela signifie qu'une fois
qu'une annonce avec récompense est diffusée,
l'objet ne peut pas être réutilisé. Pour demander une autre annonce avec récompense,
vous devez créer un objet RewardedAd
.
Afin de préparer une annonce avec récompense pour la prochaine opportunité d'impression, préchargez le
annonce avec récompense une fois que l'option OnAdFullScreenContentClosed
ou
OnAdFullScreenContentFailed
événement d'annonce est déclenché.
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();
};
}
Ressources supplémentaires
- Exemple HelloWorld: Une implémentation minimale de tous les formats d'annonces.