Cette page a été traduite par l'API Cloud Translation.

Annonces associées

Ce guide est destiné aux éditeurs qui souhaitent ajouter des annonces associées leur mise en œuvre IMA pour Android.

Prérequis

Application Android intégrant le SDK IMA Reportez-vous à l'exemple BasicExample si vous 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 échantillon, consultez les questions fréquentes.

Introductions utiles

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

Ajouter des annonces associées à votre application

Créer un ViewGroup pour afficher votre création associée

Avant de demander une création associée, vous devez lui créer un espace dans votre mise en page. Dans le fichier XML de mise en page, ajoutez un élément ViewGroup. ce exemple utilise un LinearLayout. Lors d'une étape ultérieure, vous transmettrez référence à cet élément dans votre AdDisplayContainer. Si vous utilisez lors de l'intégration dans l'application BasicExample, ajoutez ceci à activity_my.xml en dessous de com.google.android.exoplayer2.ui.PlayerView.

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 puis ajouté à un ArrayList<CompanionAdSlot>. AdDisplayContainer prend une liste d'espaces publicitaires associés pour que vous puissiez afficher plusieurs annonces associées à la fois. Vous devez 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 espace publicitaire associé pour chaque taille d'annonce associée que vous souhaitez diffuser dans votre application. Le SDK IMA insère les annonces associées issues de la réponse VAST qui dont les dimensions correspondent à la hauteur et à la largeur de la vue. Le SDK IMA permet également d'utiliser annonces associées de taille fluide. Une fois les companionAdSlots créés, ils devaient être ajoutés au AdsLoader Les exemples suivants montrent comment procéder selon que vous utilisent le IMA Android BasicExample, qui utilise la Extension Exoplayer-IMA, ou toute autre mise en œuvre IMA qui n'utilise 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 l'annonce associée annonces.

Afficher des annonces associées fluides

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

Image montrant les paramètres des annonces associées dans Ad Manager. Met en évidence l'option des tailles des créations associées.

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

Vous pouvez déclarer un emplacement associé fluide en mettant à jour CompanionAdSlot.setSize() pour utiliser CompanionAdSlot.FLUID_SIZE comme étant les 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 d'annonces associées. Que dois-je faire ?: Tout d'abord, assurez-vous que votre tag renvoie réellement des créations associées. À faire ouvrez le tag dans un navigateur Web et recherchez un tag CompanionAds. Si vous voyez Vérifiez que la taille de l'annonce associée à renvoyer est identique taille que les dimensions que vous transmettez à CompanionAdSlot objet.
À quoi ressemblera mon espace publicitaire associé dans le cadre de ce guide ?: L'image ci-dessous a été créée à partir de BasicExample . La vidéo du contenu est alors lue au-dessus avec l'annonce associée ci-dessous.