Prise en charge des annonces associées

Sélectionner une 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

  • Une application Android avec le SDK IMA intégré. Consultez BasicExample si vous n'avez pas encore d'application intégrant le SDK. Si vous avez besoin d'aide pour implémenter le SDK IMA dans votre application, consultez Configurer le SDK IMA.
  • Un 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 instructions pour ajouter un espace publicitaire associé et diffuser des annonces associées dans votre application.

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

Avant de demander un compagnon, vous devez lui créer un espace dans votre mise en page. Dans le fichier XML de votre mise en page, ajoutez un élément ViewGroup. Cet exemple utilise un LinearLayout. Dans une étape ultérieure, vous transmettrez une référence à cet élément à votre AdDisplayContainer.

Si vous l'intégrez à l'application BasicExample, ajoutez-le au fichier activity_my.xml, 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" />

Créer un objet CompanionAdSlot

L'étape suivante consiste à créer un objet CompanionAdSlot, qui est ensuite ajouté à une instance ArrayList<CompanionAdSlot>. L'interface AdDisplayContainer utilise une liste d'espaces publicitaires associés pour vous permettre d'afficher plusieurs annonces associées à la fois. Vous devez créer une instance de la classe ImaSdkFactory 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);
}

Créez un espace publicitaire associé pour chaque taille d'annonce associée que vous souhaitez afficher dans votre application. Le SDK IMA insère l'espace publicitaire associé 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 créations 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();
}

Autres mises en œuvre

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

Le plus important ! Votre application diffuse désormais des annonces associées.

Diffuser des annonces associées fluides

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

Image montrant les paramètres des annonces associées dans Ad Manager. Mise en évidence de l'option &quot;Tailles de création associée&quot;.

Mettre à jour les applications Android pour les appareils associés Fluid

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

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

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 compagnons. Pour ce faire, ouvrez la balise dans un navigateur Web et recherchez une balise <CompanionAds>. Si c'est le cas, vérifiez que la taille du compagnon renvoyé correspond aux dimensions que vous transmettez à l'objet CompanionAdSlot.
À quoi ressemblera mon espace d'annonce associée si je suis ce guide ?

L'image suivante a été créée à partir de l'exemple BasicExample. Elle montre la vidéo de contenu en cours de lecture en haut et l'annonce associée en dessous.

Exemple d'image d'annonce associée IMA Android.