Intégrer des publicités MREC

Vue d'ensemble

Vungle MREC 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.

À partir du SDK Vungle v.6.4.11, 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

Pour intégrer des publicités MREC 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

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
  }
};

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
}
};

Étape 3. Charger, afficher et fermer une publicité MREC

Charger une publicité MREC

Charger une publicité MREC équivaut à charger une publicité plein écran. Toutefois, le placement doit être configuré pour prendre en charge un flux MREC. Contactez le responsable de votre compte Vungle afin d'activer MREC en vue d'un placement.

Afficher une publicité MREC

Étant donné que la taille de l'affichage est fixe, le conteneur utilisé pour afficher la publicité MREC doit être spécifié comme étant de 300dp x 250dp. L'affichage peut être placé n'importe où sur l'écran. Ce conteneur est un RelativeLayOut.

Vous pouvez placer ce RelativeLayout n'importe où sur l'écran. Vous devez ensuite appeler AdConfig.setAdSize pour spécifier la taille de la publicité qui sera AdConfig.AdSize.VUNGLE_MREC et transmettre cet objet en appelant Vungle.getNativeAd pour obtenir l'objet de la publicité MREC.

Enfin, appelez la fonction addView pour associer le conteneur à la publicité MREC. Vungle MREC diffuse avec le son activé par défaut, mais vous pouvez régler l'option setMuted sur true pour démarrer la vidéo en mode muet.

private RelativeLayout mrecContainer = findViewById(...);

AdConfig adConfig = new AdConfig();
adConfig.setAdSize(AdConfig.AdSize.VUNGLE_MREC);
adConfig.setMuted(true);

VungleNativeAd vungleNativeAd = Vungle.getNativeAd("MREC_ID", adConfig, vunglePlayAdCallback);
View nativeAdView = vungleNativeAd.renderNativeView();
mrecContainer.addView(nativeAdView);

Fermer une publicité MREC

Puisque vous avez ajouté l'affichage de la publicité MREC à l'affichage de votre conteneur, vous devez également le retirer si l'affichage de la publicité disparaît de l'écran, si l'activité ou le fragment est détruit, ou si le conteneur de l'affichage parent est recyclé ou détruit. Si vous essayez de diffuser une autre publicité MREC sans fermer la publicité précédente, un tel événement provoquera un comportement inattendu de votre application. De ce fait, invoquez finishDisplayingAd pour mettre fin à l'expérience publicitaire. Nous vous recommandons également de supprimer l'événement d'affichage onAdEnd.

private VungleNativeAd vungleNativeAd;

// Calling finishDisplayingAd when you want to finish displaying MREC Ad
// will trigger onAdEnd and will tell you when you can remove the child
// MREC view container 
vungleNativeAd.finishDisplayingAd();

// And removing empty ad view from container
@Override 
public void onAdEnd(String id, boolean completed) {
    …
    parentView.removeView(nativeAdView);
    vungleNativeAd = null;
    …
}

Attacher et détacher l'état d'une publicité MREC

Si l'utilisateur fait défiler la page jusqu'à un endroit où la publicité vidéo n'est plus visible à l'écran, vous devez mettre la vidéo en pause et reprendre la lecture lorsqu'elle est à nouveau visible. Pour contrôler les états de pause et de reprise, appelez setAdVisibility depuis l'instance VungleNativeAd et définissez-le sur « true » lorsque la vidéo est visible et « false » lorsqu'elle ne l'est pas. Il ne faut pas confondre setAdVisibility avec la visibilité de l'affichage : ce setter informe le SDK Vungle si l'affichage de la publicité MREC est visible ou non et, selon le cas, le SDK suspend ou reprend la lecture de la vidéo.

• Mettre sur pause une publicité MREC :
  vungleNativeAd.setAdVisibility(false);

• Reprendre une publicité MREC :
  vungleNativeAd.setAdVisibility(true);

Étape 4. Personnaliser les publicités MREC (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 les options AdConfig disponibles pour les publicités MREC :

Note : vous pouvez utiliser le même objet AdConfig pour plusieurs publicités.