Annonces associées

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

Prérequis

  • 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 d'implémenter 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 lui créer un espace dans votre mise en page. Dans votre storyboard, glissez-déposez une vue dans votre ViewController, puis redimensionnez-la en fonction de l'annonce associée. Vérifiez ensuite que l'espace 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'annonce associée:

Image illustrant la création d'une vue 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 remplit l'espace publicitaire associé avec toutes les créations associées issues de la réponse VAST dont les dimensions sont correspondant à la hauteur et à la largeur de la vue. Le SDK IMA permet également d'utiliser annonces 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 indiquer au SDK que cet emplacement associé existe en transmettant un tableau de vos emplacements associés au constructeur IMAAdDisplayContainer:

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

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

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 l'espace publicitaire. Elles occupent 100% de la largeur de la vue parent, puis redimensionnent leur hauteur pour s'adapter à le 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.

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 iOS pour les annonces associées fluides

Vous pouvez déclarer un emplacement associé fluide en lançant la méthode IMACompanionAdSlot avec uniquement le paramètre view. à l'exception de 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, assurez-vous 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 à renvoyer est identique à celle de l'UIView dans laquelle vous essayez de l'afficher.