Prise en charge des annonces associées

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

Prérequis

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

Guides utiles

Si vous devez encore implémenter le SDK IMA dans votre application, consultez notre guide de démarrage.

Ajouter des annonces associées à votre application

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

Avant de demander un compagnon, vous devez créer un espace pour celui-ci dans votre mise en page. Dans votre fichier XML de 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 intégrez l'application BasicExample, ajoutez-le à activity_my.xml sous videoPlayerContainer.

activity_my.xml

<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 CompanionAdSlot

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

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

Créez un emplacement d'annonce associée pour chaque taille d'annonce associée que vous souhaitez 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 permet également d'utiliser des créations associées de taille fluide. Une fois que vous avez créé les companionAdSlots, vous devez les ajouter au AdsLoader. Les exemples suivants montrent comment procéder selon que vous utilisez l'exemple de base IMA pour Android qui utilise l'extension Exoplayer-IMA ou d'autres implémentations IMA qui n'utilisent pas l'extension.

adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

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

Annonces display associées fluides

IMA est désormais compatible avec les annonces associées fluides. Ces annonces associées peuvent être redimensionnées pour correspondre à la taille de l'espace publicitaire. Ils remplissent 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 taille de l'annonce associée Fluid dans Ad Manager. L'image ci-dessous indique où définir cette valeur.

Mettre à jour les applications Android pour des compagnons fluides

Vous pouvez déclarer un emplacement de bannières fluides en mettant à jour la méthode CompanionAdSlot.setSize() pour qu'elle accepte CompanionAdSlot.FLUID_SIZE comme paramètres.

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

Questions fréquentes

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

Commencez par vérifier que votre tag renvoie bien des annonces associées. Pour ce faire, ouvrez le tag dans un navigateur Web et recherchez un tag CompanionAds. Si c'est le cas, vérifiez que la taille de la création associée renvoyée correspond à celle des dimensions que vous transmettez à l'objet CompanionAdSlot.

À quoi ressemblera mon emplacement pour les annonces associées si je suis ce guide ?

L'image ci-dessous a été créée à partir de l'exemple de base BasicExample . La vidéo de contenu est lue en haut et l'annonce associée en bas.