Vue d'ensemble
À propos des publicités interstitielles
Les publicités interstitielles sont des publicités plein écran qui couvrent l'interface de votre application. Elles sont généralement affichées aux points de transition naturels dans le flux de votre application, comme entre les activités ou pendant la pause entre les niveaux d'un jeu. Certaines publicités interstitielles sont des publicités récompensées.
À propos des publicités récompensées
Les publicités récompensées offrent une expérience utilisateur exceptionnelle en proposant aux utilisateurs quelque chose de valeur en échange de leur visionnage ou de leur participation à une publicité. Cet échange est généralement une récompense au sein de votre application, comme des vies supplémentaires dans un jeu, une monnaie virtuelle ou un indice dans un puzzle (vous déterminez la nature et le montant de la récompense). Affichées lors de pauses naturelles dans l'application, les publicités vidéo récompensées génèrent des revenus élevés, surtout si vous suivez notre recommandation de rendre leur visionnage obligatoire.
Notez que les publicités récompensées sont parfois nommées publicités répondant au mécanisme d'incitation ; les deux termes font toujours référence au même type de publicité. Même si nous préférons le terme « récompensées », dans le code SDK et dans notre API de création, nous utilisons le terme « répondant au mécanisme d'incitation ».
Il existe deux façons d'intégrer des publicités récompensées : les récompenses dans l'application (recommandées et décrites ci-dessous) ou les rappels serveur à serveur (voir notre article FAQ sur ce sujet). Avec les récompenses dans l'application, lorsqu'un utilisateur termine avec succès le visionnage d'une publicité ou clique sur le bouton de téléchargement, vous pouvez le récompenser directement dans votre application. Le principal avantage de cette approche est qu'elle est simple à mettre en œuvre. Si vous recherchez quelque chose de rapide, et que vous n'êtes pas concerné par les attaques par rejeu, cette option s'avère tout à fait adaptée.
Vungle offre désormais une variété de formats d'annonces avec des annonces-modèles dynamiques. Contrairement au format d'annonce traditionnel dans lequel la diffusion d'une annonce se compose d'une lecture vidéo suivie d'un écran de fin, nous proposons des modèles où le bouton d'appel à l'action (CTA) est disponible pendant la lecture vidéo. Les utilisateurs qui visionnent toute l'annonce vidéo, de même que ceux qui font clic sur le bouton, devraient être récompensés.
Étape 1. Intégration de base complète
Pour intégrer des publicités interstitielles dans votre application Android ou Amazon, commencez par suivre les instructions de l'article sur l'intégration 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 écouteurs d'événements
Vous pouvez utiliser des rappels génériques en implémentant LoadAdCallback
pour les événements de chargement de publicités et PlayAdCallback
pour les événements de diffusion de publicités, ou utiliser des rappels en ligne lorsque vous invoquez loadAd
et playAd
.
LoadAdCallback
private final LoadAdCallback vungleLoadAdCallback = new LoadAdCallback() {
@Override
public void onAdLoad(String id) {
// Ad has been successfully loaded for the placement
}
@Override
public void onError(String id, VungleException exception) {
// Ad has failed to load for the placement
}
};
// 6.4.x & below
private final LoadAdCallback vungleLoadAdCallback = new LoadAdCallback() {
@Override
public void onAdLoad(String id) {
// Ad has been successfully loaded for the placement
}
@Override
public void onError(String id, Throwable throwable) {
// Ad has failed to load for the placement
}
};
Méthodes alternatives | Description |
---|---|
onAdLoad(String id) |
Invoqué lorsque la publicité a été chargée et diffusée pour le placement avec succès |
onError(String id) |
Invoqué lorsqu'une erreur se produit lors de la tentative de diffusion d'une publicité. Vous pourrez vérifier le message d'erreur depuis getLocalizedMessage de VungleException et utiliser getExceptionCode pour le débogage. |
PlayAdCallback
private final PlayAdCallback vunglePlayAdCallback = new PlayAdCallback() {
@Override
public void onAdStart(String id) {
// Ad experience started
}
@Override
public void onAdEnd(String id) {
// Ad experience ended
}
@Override
public void onAdClick(String id) {
// User clicked on ad
}
@Override
public void onAdRewarded(String id) {
// User earned reward for watching an ad
}
@Override
public void onAdLeftApplication(String id) {
// User has left app during an ad experience
}
@Override
public void onError(String id, VungleException exception) {
// Ad failed to play
}
};
// 6.5.x & below
private final PlayAdCallback vunglePlayAdCallback = new PlayAdCallback() {
@Override
public void onAdStart(String placementReferenceId) {
// Ad experience started
}
// Deprecated
@Override
public void onAdEnd(String placementReferenceId, boolean completed, boolean isCTAClicked) {
// Invoked when the ad experience is completed
// isCTAClicked flag indicates whether CTA download button has been triggered
// completed flag will indicate whether user has watched 80% of video or longer.
}
@Override
public void onError(String placementReferenceId, VungleException exception) {
// Ad failed to play
}
};
Méthodes alternatives | Description |
---|---|
onAdStart(String id) |
Invoqué lorsque la publicité est lancée et affichée sur l'appareil avec succès. |
onAdEnd(String id) |
Invoqué lorsque l'intégralité de l'expérience publicitaire est terminée, juste avant que le contrôle ne soit renvoyé à l'application d'hébergement. |
onAdClick(String id) |
Invoqué lorsque l'utilisateur a cliqué sur une publicité vidéo ou un bouton de téléchargement. |
onAdRewarded(String id) |
Invoqué lorsque l'utilisateur a regardé 80 % de la vidéo récompensée et doit donc être récompensé. La récompense doit avoir lieu ici et ne sera déclenchée que pour les placements récompensés. |
onAdLeftApplication(String id) |
Invoqué lorsque l'utilisateur quitte l'application avant la fin de l'expérience publicitaire, comme l'ouverture de la page de la boutique pour la publicité. |
onAdError(String id, VungleException exception) |
Invoqué lorsqu'une erreur se produit lors de la tentative de diffusion d'une publicité. Vous pourrez vérifier le message d'erreur depuis getLocalizedMessage de VungleException et utiliser getExceptionCode pour le débogage. |
Étape 3. Charger et diffuser une publicité
Charger une publicité pour un placement
La méthode LoadAdCallback
sera informée de l'état de chargement de l'appel auquel elle a été attribuée. Le SDK ne fait que référencer ce rappel et ne le stocke nulle part ; l'appelant doit s'assurer que le rappel est géré correctement.
public static void loadAd(@NonNull final String id, @Nullable LoadAdCallback callback)
// Load Ad Implementation if (Vungle.isInitialized()) { Vungle.loadAd("PLACEMENT_ID", new LoadAdCallback() { @Override public void onAdLoad(String placementReferenceId) { } @Override public void onError(String placementReferenceId, VungleException exception) { } }); }
Vérifier la disponibilité de la publicité pour un placement
Utilisez la méthode statique canPlayAdmethod
pour vérifier si une publicité peut être diffusée au placement avant d'invoquer la méthode playAd
.
public static boolean canPlayAd(@NonNull String id)
Diffuser une publicité
Pour diffuser une publicité, invoquez la méthode playAd
en utilisant éventuellement l'ID de référence de placement AdConfig
(null si vous ne l'utilisez pas) et un écouteur d'événements PlayAdCallback
qui sera informé de la réussite ou des erreurs lors de la lecture de la publicité.
public static void playAd(@NonNull final String id, final AdConfig settings, @Nullable final PlayAdCallback listener)
Vérifiez toujours la disponibilité des publicités en appelant la méthode canPlayAd
avant d'invoquer la méthode playAd
. Une publicité ne s'affichera pas correctement si la commande playAd
est appelée plusieurs fois successivement. De ce fait, vous devez également vous assurer que vous recevez soit un rappel onAdEnd
, soit un rappel onError
de l'appel initial playAd
avant d'effectuer un playAd
supplémentaire.
if (Vungle.canPlayAd("PLACEMENT_ID")) { Vungle.playAd("PLACEMENT_ID", null, new PlayAdCallback() { @Override public void onAdStart(String placementReferenceId) { } @Override public void onAdEnd(String placementReferenceId, boolean completed, boolean isCTAClicked) { } @Override public void onError(String placementReferenceId, VungleException exception) { } }); }
Étape 4. Configurer toutes les publicités plein écran (facultatif)
Vous avez la possibilité de personnaliser chaque publicité que vous diffusez en fournissant un nouvel objet adConfig
à playAd
. Lorsque l'objet AdConfig
est null, la publicité est diffusée avec les paramètres de configuration par défaut. Lorsqu'elle est non-null, ses paramètres remplacent ceux du setter AdConfig
. Voici un exemple d'utilisation de AdConfig
:
Vungle.playAd(placementReferenceID, adConfig, vunglePlayAdCallback);
L'exemple ci-dessus utilise l'objet adConfig
qui contient des options de configuration personnalisées. Définissez l'objet AdConfig
comme indiqué :
AdConfig adConfig = new AdConfig(); adConfig.setAdOrientation(AdConfig.AUTO_ROTATE); adConfig.setMuted(true); Vungle.playAd(placementReferenceID, adConfig, vunglePlayAdCallback);
Le tableau suivant répertorie toutes les options AdConfig
disponibles :
Option |
Description |
|
« true » si le bouton de retour doit être activé avant que le bouton de fermeture de la publicité n'apparaisse, dans le cas contraire, « false » |
|
AdConfig.AUTO_ROTATE si la publicité vidéo doit pivoter automatiquement, dans le cas contraire AdConfig.LANDSCAPE ou AdConfig.PORTRAIT pour suivre l'orientation de la publicité vidéo |
|
« false » si la vidéo doit se lancer avec ses paramètres audio correspondant à ceux de l'application qui l'entoure, « true » si elle doit se lancer en sourdine |
|
prend une valeur entière du nombre ordinal pour suivre le nombre de publicités diffusées au cours de la même session |
Note : vous pouvez utiliser le même objet AdConfig
pour plusieurs publicités.
Étape 5. Personnaliser les publicités récompensées (facultatif)
Boîte de dialogue contextuelle
La boîte de dialogue contextuelle pour les publicités récompensées est configurable avec la méthode setIncentivizedFields
.
public static void setIncentivizedFields(@Nullable String userID, @Nullable String title, @Nullable String body, @Nullable String keepWatching, @Nullable String close)
Considérations sur les récompenses
Il n'existe pas de norme pour récompenser les utilisateurs. Votre décision dépend du modèle économique de votre jeu. Un développeur doit récompenser l'utilisateur juste assez pour rendre l'option vidéo attrayante, mais pas au point que la récompense remplace un achat dans l'application. Mettre en place une limite de vues journalière sur les vidéos récompensées est également important. Cette méthode limite le nombre de récompenses par utilisateur.
Voici quelques questions à vous poser pour décider du montant de la récompense :
-
Qu'est-ce qui a le plus de valeur pour l'utilisateur : une monnaie faible ou forte ?
La monnaie faible est moins chère à donner mais les utilisateurs peuvent être plus enclins à regarder une vidéo pour un article qu'ils peuvent utiliser immédiatement. Vous pouvez également utiliser la vidéo récompensée comme un moyen de présenter de nouveaux articles à l'utilisateur, l'incitant à acheter dans l'application plus tard. -
La récompense est-elle attrayante pour l'utilisateur ?
Vous devez vous assurer que la récompense est quelque chose dont l'utilisateur a réellement besoin ou envie, et qu'elle n'est pas facile à obtenir. -
Où se situe la récompense par rapport à l'achat dans l'application la plus courante ?
La récompense doit représenter la première étape pour obtenir l'achat dans l'application que l'utilisateur souhaite ou quelque chose que l'utilisateur peut vouloir mais qu'il n'achète jamais. -
Où se situe la récompense par rapport à ce que l'utilisateur gagnera en moyenne en jouant au jeu ?
Si l'utilisateur gagne le même montant de récompense en ne jouant qu'un seul niveau, il se peut qu'il ne considère pas que la récompense vaille 15 secondes de son temps. -
Dois-je limiter le nombre de récompenses par utilisateur et par jour ?
Oui, la fixation d'une limite de vues journalière peut vous aider à contrôler le nombre d'articles ou de pièces gratuits que l'utilisateur peut gagner.
Notre équipe de gestion des comptes est également là pour vous aider. Envoyez-nous un e-mail à monetize@vungle.com.