Annonces associées

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

Conditions préalables

  • Application iOS avec le SDK IMA intégré.
  • Tag d'emplacement publicitaire configuré pour renvoyer une annonce associée.

Introductions utiles

Si vous avez encore besoin de mettre en œuvre le SDK IMA dans votre application, consultez notre guide de démarrage.

Ajouter des annonces associées à votre application

Créer une UIView pour votre création 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 votre storyboard, glissez-déposez une vue sur votre ViewController et redimensionnez-la pour l'adapter à l'annonce associée. Assurez-vous ensuite que votre espace publicitaire associé est lié à une variable dans votre implémentation (cet exemple utilise une variable appelée "CompanionView"). Dans la capture d'écran ci-dessous, la vue gris clair correspond à l'affichage de l'annonce associée:

Image représentant la création d'un UIView pour votre création associée.

Créer un IMACompanionAdSlot

L'étape suivante consiste à créer un objet IMACompanionAdSlot à partir de votre vue. Le SDK IMA insère dans l'espace publicitaire associé toutes les créations 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.

ViewController.h 
@property(nonatomic, weak) IBOutlet UIView *companionView;
ViewController.m 
self.companionSlot =
    [[IMACompanionAdSlot alloc] initWithView:self.companionView
                                       width:self.companionView.frame.size.width
                                      height:self.companionView.frame.size.height];

Transmettre l'espace publicitaire associé à votre conteneur d'annonces

Enfin, vous devez informer le SDK de la présence de cet emplacement associé en transmettant un tableau de vos espaces associés au constructeur IMAAdDisplayContainer:

ViewController.m 
return [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                           viewController:self
                                           companionSlots:@[ self.companionSlot ]];

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 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 applications iOS pour les compagnons fluides

Vous pouvez déclarer un emplacement fluide associé en lançant IMACompanionAdSlot uniquement avec le paramètre view, en excluant width et height.

ViewController.m 
self.companionSlot =
      [[IMACompanionAdSlot alloc] initWithView:self.companionView];

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 le tag dans un navigateur Web et recherchez un tag CompanionAds. Dans ce cas, vérifiez que la taille de l'annonce associée renvoyée est identique à celle de l'UIView dans laquelle vous essayez de l'afficher.