Prise en charge des annonces associées

Sélectionnez la plate-forme : HTML5 Android iOS

Ce guide est destiné aux éditeurs qui souhaitent ajouter des annonces associées à leur implémentation IMA Android.

Prérequis

• Application Android avec le SDK IMA intégré. Consultez le BasicExample si vous n'avez pas encore d'application avec le SDK intégré. Si vous avez besoin d'aide pour implémenter le SDK IMA dans votre application, consultez Configurer le SDK IMA.
• Tag d'emplacement publicitaire configuré pour renvoyer une annonce associée. Si vous avez besoin d'un exemple, consultez nos questions fréquentes.

Ajouter des annonces associées à votre application

Suivez les étapes ci-dessous pour ajouter un emplacement d'annonce associée et afficher des annonces associées dans votre application.

Créer un ViewGroup pour afficher votre annonce associée

Avant de demander une annonce associée, vous devez créer un espace pour celle-ci dans votre mise en page. Dans le code XML de votre mise en page, ajoutez un élément ViewGroup. Cet exemple utilise un LinearLayout. Lors d'une étape ultérieure, vous transmettrez une référence à cet élément à votre AdDisplayContainer.

Si vous effectuez l'intégration dans l'application BasicExample, ajoutez ce code au activity_my.xml fichier, sous videoPlayerContainer.

<LinearLayout
    android:id="@+id/companionAdSlot"
    android:layout_width="match_parent"
    android:layout_height="250dp"
    android:layout_gravity="center_horizontal"
    android:gravity="center"
    android:orientation="vertical"
    android:textAlignment="center" />
companion_ad_slot_snippet.xml

Créer un CompanionAdSlot

L'étape suivante consiste à créer un objet CompanionAdSlot, qui est ensuite ajouté à une instance ArrayList<CompanionAdSlot>. L'interface AdDisplayContainer accepte une liste d'emplacements d'annonces associées afin que vous puissiez afficher plusieurs annonces associées à la fois. Vous devez créer une instance de ImaSdkFactory classe pour créer l'objet CompanionAdSlot.

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}
CompanionAdSnippets.java

Créez un emplacement d'annonce associée pour chaque taille d'annonce associée que vous comptez afficher dans votre application. Le SDK IMA remplit l'emplacement d'annonce associée avec toutes les annonces associées de la réponse VAST dont les dimensions correspondent à la hauteur et à la largeur de la vue. Le SDK IMA est également compatible avec les annonces associées de taille fluide . Une fois que vous avez créé les companionAdSlots, ajoutez-les à AdsLoader. Les exemples suivants montrent comment procéder selon que vous utilisez l' extension Exoplayer-IMA, ou d'autres implémentations IMA qui n'utilisent pas l'extension.

Extension Exoplayer-IMA

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}
CompanionAdSnippets.java

Autres mises en œuvre

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}
CompanionAdSnippets.java

Vous savez tout ! Votre application affiche désormais des annonces associées.

Afficher des annonces associées fluides

IMA est compatible avec les annonces associées fluides. Ces annonces associées peuvent être redimensionnées pour correspondre à la taille de l'emplacement publicitaire. Elles occupent 100 % de la largeur de la vue parente, puis redimensionnent leur hauteur pour s'adapter au contenu de l'annonce associée. Elles sont définies à l'aide de la Fluid taille d'annonce associée dans Ad Manager. Consultez l'image suivante pour savoir où définir cette valeur.

Mettre à jour les applications Android pour les annonces associées fluides

Vous pouvez déclarer un emplacement d'annonce associée fluide en mettant à jour la CompanionAdSlot.setSize() pour qu'elle accepte CompanionAdSlot.FLUID_SIZE comme paramètres.

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
CompanionAdSnippets.java

Questions fréquentes

J'ai suivi le guide, mais je ne vois pas d'annonces associées. Que dois-je faire ?

Tout d'abord, vérifiez que votre tag renvoie bien des annonces associées. Pour ce faire, ouvrez le tag dans un navigateur Web et recherchez un <CompanionAds> tag. Si vous le voyez, vérifiez que la taille de l'annonce associée renvoyée est la même que celle des dimensions que vous transmettez à l'objet CompanionAdSlot.

À quoi ressemblera mon emplacement d'annonce associée si je suis ce guide ?

L'image suivante a été créée à partir de BasicExample . La vidéo de contenu est diffusée en haut et l'annonce associée en dessous.