Vue d'ensemble
Vungle prend en charge les trois tailles de bannières suivantes et la taille standard des publicités MREC.
VungleBannerSize |
Dimensions |
|
320,0f x 50,0f |
|
300,0f x 50,0f |
|
728,0f x 90,0f (pour les tablettes) |
|
300,0f x 250,0f (MREC) |
À propos des bannières publicitaires
Vungle Banner est actuellement en phase BÊTA. Veuillez contacter directement le responsable de votre compte pour obtenir un accès afin d'assurer un lancement réussi.
Le plugin Vungle Unity prend en charge les bannières publicitaires et les publicités MREC à partir du SDK Vungle pour Unity v6.7.0.0. Ce format de publicité ne nécessite pas un plein écran : l'éditeur choisit l'emplacement du conteneur dans l'application. La taille du conteneur pour afficher les bannières publicitaires peut être de 320x50, 300x50 ou 728x90 (pour les tablettes). Vous pouvez placer des bannières publicitaires n'importe où à l'écran et l'utilisateur peut continuer à naviguer dans l'application pendant que la publicité défile. L'énumération qui répertorie les différentes tailles de bannières se trouve dans le fichier VungleSDK.h
(ainsi que dans le tableau ci-dessous).
Il n'y a pas de limite au nombre de publicités n'occupant pas tout l'écran que vous pouvez afficher au même moment, mais le plugin ne vérifie pas si plusieurs publicités sont affichées sur une seule position. Assurez-vous que vous appelez une publicité pour n'importe quelle position fournie par notre plugin et assurez-vous également qu'elles ne se chevauchent pas les unes les autres si vous en affichez plusieurs.
VungleBannerPosition |
Position de la publicité sur l'écran |
|
Coin supérieur gauche |
|
Haut au milieu |
|
Coin supérieur droit |
|
Centre |
|
Coin inférieur gauche |
|
Bas au milieu |
|
Coin inférieur droit |
Le type de placement des bannières publicitaires doit être du type « Bannière » dans le tableau de bord de Vungle. N'hésitez pas à contacter votre gestionnaire de compte pour permettre le placement de bannières dans le tableau de bord.
À propos des publicités MREC
À partir du SDK Vungle v.6.4.3, Vungle prend en charge les publicités vidéo MREC. MREC est l'abréviation de publicités « medium rectangle ». Contrairement aux publicités interstitielles, les publicités MREC ne nécessitent pas d'affichage plein écran. Comme les bannières publicitaires, les publicités vidéo MREC sont des publicités rectangulaires qui occupent un emplacement n'importe où dans la structure de l'application, généralement affichées en haut ou en bas de l'écran, afin que l'utilisateur puisse continuer à interagir avec l'application pendant la diffusion de la publicité. La taille du conteneur pour afficher une publicité MREC est celle de la norme du secteur : 300x250.
Étape 1. Intégration de base complète du plugin
Pour intégrer des bannières publicitaires et des publicités MREC à votre application Unity, commencez par suivre les instructions de l'article sur l' intégration de plugin de base . Cet article contient des informations supplémentaires et suppose que vous avez effectué l'intégration de base.
Étape 2. Mettre en place des gestionnaires d'événements (facultatif)
Vous pouvez configurer des gestionnaires d'événements pour les cinq événements du SDK Vungle qui entourent la présentation de la publicité.
- L'événement suivant est déclenché lorsque le SDK commence à lire une publicité vidéo. Il s'agit d'un excellent placement pour mettre en pause le gameplay, les effets sonores, les animations, etc.
public static event Action onAdStartedEvent;
- L'événement suivant est déclenché lorsque le SDK ferme une publicité. Il s'agit d'un excellent placement pour récompenser vos utilisateurs et reprendre le gameplay, les effets sonores, les animations, etc.
public static event Action<string, AdFinishedEventArgs> onAdFinishedEvent;
AdFinishedEventArgs
se compose des propriétés suivantes pour que vous puissiez vérifier le résultat de la lecture d'une publicité :public class AdFinishedEventArgs : EventArgs { //Represents a BOOL whether or not the user clicked the download button. public bool WasCallToActionClicked{ get; set;} //Represents a bool whether or not the video can be considered a completed view. public bool IsCompletedView{ get; set;} }
- L'événement suivant est déclenché lorsque le SDK a modifié le statut de la disponibilité d'une publicité. Le booléen
isAdPlayable
indique la nouvelle jouabilité d'unplacementID
spécifique.public static event Action<string, bool> adPlayableEvent;
- L'événement suivant est déclenché lorsque le SDK est initialisé avec succès.
public static event Action onInitializeEvent;
Exemple de code :
void initializeEventHandlers()
{
Vungle.onAdStartedEvent += (placementID) => {
DebugLog ("Ad " + placementID + " is starting! Pause your game animation or sound here.");
};
Vungle.onAdFinishedEvent += (placementID, args) => {
DebugLog ("Ad finished - placementID " + placementID + ", was call to action clicked:" + args.WasCallToActionClicked + ", is completed view:"
+ args.IsCompletedView);
};
Vungle.adPlayableEvent += (placementID, adPlayable) => {
DebugLog ("Ad's playable state has been changed! placementID " + placementID + ". Now: " + adPlayable);
};
Vungle.onInitializeEvent += () => {
adInited = true;
DebugLog ("SDK initialized");
};
}
Étape 3. Charger, afficher et fermer une publicité
Charger une publicité
Le chargement d'une publicité ne s'affichant pas sur tout l'écran fonctionne différemment d'une publicité plein écran. Il existe une API loadBanner
spécifique que vous utilisez pour le chargement. Vous devez spécifier la taille et la position de la publicité n'occupant pas tout l'écran que vous souhaitez charger et le SDK la réactualisera automatiquement avec l'intervalle de temps que vous avez configuré sur le tableau de bord. Vous devez utiliser des placements spécialement conçus pour les bannières publicitaires et les publicités MREC.
Chargez une publicité n'occupant pas tout l'écran en appelant la méthode loadBanner
:
Vungle.loadBanner("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner, Vungle.VungleBannerPosition.BottomCenter);
Afficher une publicité
Les publicités qui ne sont pas en plein écran seront affichées à l'emplacement dans la taille que vous avez spécifiée au moment d'invoquer loadBanner
lorsque vous appelez showBanner
.
Vungle.showBanner("PLACEMENT_ID");
Nous vous recommandons de vérifier la disponibilité d'une publicité avant de l'activer et isAdvertAvailable
peut être utilisé au même titre que les publicités plein écran. Cependant, en ce qui concerne les publicités n'occupant pas tout l'écran, vous aurez besoin de transmettre VungleBannerSize
en plus de l'ID de placement de la publicité que vous souhaitez afficher.
Vungle.isAdvertAvailable("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner);
Fermer une publicité
Vous pouvez appeler closeBanner
lorsque vous souhaitez rejeter une publicité qui n'est pas diffusée sur l'ensemble de l'écran.
Vungle.closeBanner("PLACEMENT_ID");