Annonces associées

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

Prérequis

• Application Android avec le SDK IMA intégré. Consultez 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.

Ressources utiles

Si vous devez toujours 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 compagnon

Avant de demander un compagnon, vous devez créer un espace pour celui-ci dans votre mise en page. Dans le fichier XML de mise en page, ajoutez un élément ViewGroup. Cet exemple utilise un LinearLayout. À 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 à 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 prend une liste d'emplacements d'annonces associées afin que vous puissiez diffuser plusieurs annonces associées à la fois. Vous devez créer une instance de ImaSdkFactory pour créer 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 espace publicitaire associé pour chaque taille d'annonce associée que vous souhaitez diffuser dans votre application. Le SDK IMA renseigne 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 permet également d'utiliser des annonces associées fluides. Une fois que vous avez créé le companionAdSlots, vous devez l'ajouter au AdsLoader. Les exemples suivants montrent comment procéder selon que vous utilisez l'exemple de base Android IMA qui utilise l'extension Exoplayer-IMA ou d'autres implémentations IMA qui n'utilisent pas l'extension.

BasicExample

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

Autres mises en œuvre

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

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

Afficher des annonces 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 du compagnon. Elles sont définies à l'aide de la taille d'annonce associée Fluid dans Ad Manager. Consultez l'image suivante pour savoir où définir cette valeur.

Mettre à jour les applications Android pour des compagnons fluides

Vous pouvez déclarer un emplacement de compagnon fluide en mettant à jour la méthode CompanionAdSlot.setSize() pour qu'elle accepte CompanionAdSlot.FLUID_SIZE comme deux 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 les annonces associées. Que dois-je faire ?

Tout d'abord, vérifiez que votre balise renvoie bien des compagnons. Pour ce faire, ouvrez la balise dans un navigateur Web et recherchez une balise CompanionAds. Si vous constatez cela, vérifiez que la taille du compagnon renvoyé est identique à celle des dimensions que vous transmettez à l'objet CompanionAdSlot.

À quoi ressemblera mon espace publicitaire associé si je suis ce guide ?

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