Intégrer les publicités interstitielles et récompensées

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 du plugin

Pour intégrer des publicités interstitielles et récompensées dans 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;

  La classe 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'un placementID spécifique.
  

  public static event Action<string, bool> adPlayableEvent;

  Consultez la section « Vérifier la disponibilité de la publicité pour un placement » de cet article pour plus de détails.
• 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 et diffuser une publicité

Charger une publicité pour un placement

Pour tous les placements, appelez la méthode loadAd() pour charger une publicité.

public static void loadAd(string placementID)

Veillez à utiliser le placementID lié à la plateforme correcte.

Exemple de code :

string placementID;
#if UNITY_IPHONE
  placementID = "ios_placement_id";
#elif UNITY_ANDROID
  placementID = "android_placement_id";
#elif UNITY_WSA_10_0 || UNITY_WINRT_8_1 || UNITY_METRO
  placementID = "windows_placement_id";
#endif
  Vungle.loadAd(placementID);

Vérifier la disponibilité de la publicité pour un placement

Lorsque le SDK a terminé de mettre en cache une publicité pour un placement, l'événement suivant est appelé :

public static event Action<string, bool> adPlayableEvent;

Exemple de code :

Vungle.adPlayableEvent += (placementID, adPlayable) => {
  if(placementID == "ios_placement_id") {
    playButtonPlacement1.enabled = adPlayable;
  }
};

Remarque : pour les placements optimisés par la mise en cache, cet événement est uniquement appelé lorsqu'une publicité est disponible. Les placements optimisés tentent automatiquement de remplir sans aucune autre action. Pour tous les autres placements, cet événement est également appelé en cas "d'échec du chargement" (adPlayable renvoie false dans ce cas).

Vous pouvez également vérifier la disponibilité de la publicité pour un placement avec la méthode suivante :

public static bool isAdvertAvailable(string placementID);

Diffuser une publicité

Important : ne diffusez pas de publicité avant que la fonction adPlayableEvent décrite ci-dessus ne renvoie "true". Si vous essayez de diffuser une publicité avant que la fonction adPlayableEvent ne renvoie "true", cela peut nuire à l'expérience utilisateur tandis que la publicité essaie de charger. Si vous déployez sur Android, utilisez plutôt la valeur renvoyée par isAdvertAvailable() pour vous assurer qu'une publicité est disponible (étant donné que adPlayableEvent ne renverra pas "faux" si aucune publicité n'est disponible).

Lorsqu'une publicité est disponible pour un placement, vous pouvez la jouer avec la méthode suivante :

public static void playAd(string placementID);

Exemple de code :

Vungle.playAd(placementID);