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