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.

Conditions préalables

Application Android avec le SDK IMA intégré. Consultez BasicExample si vous ne disposez pas encore d'une 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 les questions fréquentes.

Introductions utiles

Si vous devez encore mettre en œuvre 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 l'application associée

Avant de demander une création associée, vous devez créer un espace pour celle-ci dans votre mise en page. Dans le fichier XML de mise en page, ajoutez un élément ViewGroup. Cet exemple utilise un élément LinearLayout. Lors d'une étape ultérieure, vous transmettrez une référence à cet élément à votre AdDisplayContainer. Si vous vous intégrez à l'application BasicExample, ajoutez cet élément à activity_my.xml sous le 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 ensuite ajouté à un ArrayList<CompanionAdSlot>. AdDisplayContainer utilise une liste d'espaces publicitaires associés pour que vous puissiez afficher plusieurs annonces associées simultanément. 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 de création associée que vous souhaitez diffuser dans votre application. Le SDK IMA insère dans cet espace publicitaire toutes les annonces associées issues 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, vous devez les ajouter à AdsLoader. Les exemples suivants montrent comment procéder selon que vous utilisez IMA Android BasicExample, 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 maintenant des annonces associées.

Afficher des annonces associées fluides

IMA est désormais compatible avec les annonces associées fluides. Ces annonces peuvent être redimensionnées pour correspondre à la taille de l'espace publicitaire. Ils occupent 100% de la largeur de la vue parent, puis redimensionnent leur hauteur pour l'adapter au contenu de l'élément associé. Ils sont définis à l'aide de la taille d'annonce associée Fluid dans Ad Manager. Consultez l'image ci-dessous pour savoir où définir cette valeur.

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

Mettre à jour les applis Android pour les compagnons fluides

Vous pouvez déclarer un emplacement fluide associé 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 d'annonces associées. Que dois-je faire ?: Tout d'abord, vérifiez que votre tag renvoie réellement des créations associées. Pour ce faire, ouvrez la balise dans un navigateur Web et recherchez une balise CompanionAds. Dans ce cas, assurez-vous que la taille de l'élément associé renvoyé est identique à celle des dimensions que vous transmettez dans l'objet CompanionAdSlot.
À quoi ressemblera mon espace publicitaire associé si vous suivez ce guide ?: L'image ci-dessous a été créée à partir de l'exemple de base BasicExample , et le contenu vidéo ci-dessus est lu avec l'annonce associée ci-dessous.