Options d'annonces natives

Sélectionnez une plate-forme : Android iOS

Les annonces natives offrent de nombreuses fonctionnalités avancées qui vous permettent de personnaliser davantage vos annonces et d'offrir la meilleure expérience publicitaire possible. Ce guide vous explique comment utiliser les fonctionnalités avancées des annonces natives.

Prérequis

• Intégrez le format d'annonce native.

Options des composants

Cette section explique comment personnaliser les assets de création dans vos annonces natives. Vous pouvez spécifier un format préféré pour les composants multimédias, ainsi que la façon dont les composants Image sont téléchargés et affichés.

Commandes de format multimédia préféré

Les commandes de format du média vous permettent de spécifier une préférence pour le format des créations publicitaires.

Important : L'utilisation de cette API ne garantit pas que toutes les créations publicitaires répondront à la préférence spécifiée.

Définissez GADNativeAdMediaAdLoaderOptions mediaAspectRatio avec un GADMediaAspectRatio.

• Si cette valeur n'est pas définie, l'annonce renvoyée peut avoir n'importe quel format média.

• Si vous le définissez, vous pourrez améliorer l'expérience utilisateur en spécifiant le type de format préféré.

L'exemple suivant indique au SDK de privilégier une image ou une vidéo de retour avec un format spécifique.

Swift

let nativeOptions = NativeAdMediaAdLoaderOptions()
nativeOptions.mediaAspectRatio = .any

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdMediaAdLoaderOptions *nativeOptions = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOptions.mediaAspectRatio = GADMediaAspectRatioAny;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Remplacez nativeAdUnitID par l'ID de votre bloc d'annonces.

Contrôle du téléchargement d'images

Le contrôle du téléchargement d'images vous permet de choisir si le SDK renvoie des composants Image ou uniquement des URI.

Définissez GADNativeAdImageAdLoaderOptions disableImageLoading avec une valeur BOOL.

• Les commandes de téléchargement d'images sont désactivées par défaut.

• Lorsqu'il est désactivé, le SDK Google Mobile Ads renseigne l'image et l'URI pour vous.

• Lorsqu'il est activé, le SDK ne renseigne que l'URI, ce qui vous permet de télécharger les images réelles à votre convenance.

L'exemple suivant indique au SDK de ne renvoyer que l'URI.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.isImageLoadingDisabled = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.disableImageLoading = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Commandes de charge utile d'image

Certaines annonces comportent une série d'images plutôt qu'une seule. Utilisez cette fonctionnalité pour indiquer si votre application est prête à afficher toutes les images ou une seule.

• Les commandes de charge utile d'image sont désactivées par défaut.

• Lorsqu'il est désactivé, votre application demande au SDK de ne fournir que la première image pour les composants qui contiennent une série.

• Lorsque ce paramètre est activé, votre application indique qu'elle est prête à afficher toutes les images pour les composants qui en comportent plusieurs.

L'exemple suivant indique au SDK de renvoyer plusieurs composants d'image.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.shouldRequestMultipleImages = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.shouldRequestMultipleImages = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Emplacements Choisir sa pub

Cette section explique comment positionner le calque AdChoices. Vous pouvez choisir de le placer dans l'un des quatre coins ou de l'afficher dans une vue personnalisée.

Contrôles de la position du badge "Choisir sa pub"

Les commandes de positionnement de l'icône "Choisir sa pub" vous permettent de choisir dans quel coin l'afficher.

Définissez GADNativeAdViewAdOptions preferredAdChoicesPosition avec une valeur GADAdChoicesPosition.

• Si elle n'est pas définie, la position de l'icône Choisir sa pub est définie sur "en haut à droite".

• Si cette option est définie, le badge "Choix de pub" est placé à la position personnalisée demandée.

L'exemple suivant montre comment définir une position personnalisée pour l'image AdChoices.

Swift

let nativeOptions = NativeAdViewAdOptions()
nativeOptions.preferredAdChoicesPosition = .topRightCorner

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopRightCorner;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Vue personnalisée "Choisir sa pub"

Avertissement : L'accès à cette fonctionnalité est limité. Pour demander l'accès, contactez votre responsable de compte.

La fonctionnalité de vue personnalisée Choisir sa pub vous permet de positionner l'icône Choisir sa pub à un emplacement personnalisé. Cela diffère des contrôles de position du badge Vos choix de pub, qui ne permettent de spécifier que l'un des quatre angles.

Définissez la propriété GADNativeAd.adChoicesView avec un GADAdChoicesView avant le rendu. Le contenu du sélecteur de publicité s'affiche dans le GADAdChoicesView.

L'exemple suivant montre comment définir une vue AdChoices personnalisée. L'icône "Choisir sa pub" s'affiche dans le GADAdChoicesView :

Swift

private func createAdChoicesView(nativeAdView: NativeAdView) {
  // Define a custom position for the AdChoices icon.
  let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
  let customAdChoicesView = AdChoicesView(frame: customRect)
  nativeAdView.addSubview(customAdChoicesView)
  nativeAdView.adChoicesView = customAdChoicesView
}
NativeAdOptionsSnippets.swift

Objective-C

- (void)createAdChoicesViewWithNativeAdView:(GADNativeAdView *)nativeAdView {
  // Define a custom position for the AdChoices icon.
  CGRect customRect = CGRectMake(100, 100, 15, 15);
  GADAdChoicesView *customAdChoicesView = [[GADAdChoicesView alloc] initWithFrame:customRect];
  [nativeAdView addSubview:customAdChoicesView];
  nativeAdView.adChoicesView = customAdChoicesView;
}
NativeAdOptionsSnippets.m

Commandes vidéo

Cette section explique comment personnaliser l'expérience de lecture des annonces vidéo. Vous pouvez définir l'état de mise en sourdine initial et implémenter des commandes de lecture personnalisées.

Ignorer un comportement

Le comportement de démarrage avec le son désactivé vous permet de désactiver ou d'activer le son de début d'une vidéo.

Définissez GADVideoOptions startMuted avec une valeur BOOL.

• Le comportement "Démarrer en mode silencieux" est activé par défaut.

• Lorsqu'elle est désactivée, votre application demande que la vidéo commence avec le son.

• Lorsque cette option est activée, votre application demande que la vidéo commence sans le son.

L'exemple suivant montre comment démarrer la vidéo avec le son activé.

Swift

let videoOptions = VideoOptions()
videoOptions.shouldStartMuted = false

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.startMuted = NO;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

Commandes de lecture personnalisées

Avertissement : L'accès à cette fonctionnalité est limité. Pour demander l'accès, contactez votre responsable de compte.

Cela vous permet de demander des commandes d'entrée vidéo personnalisées pour lire, mettre en pause ou couper le son de la vidéo.

Définissez GADVideoOptions customControlsRequested avec une valeur BOOL.

• Les commandes de lecture personnalisées sont désactivées par défaut.

• Si cette option est désactivée, les commandes d'entrée rendues par le SDK s'affichent dans votre vidéo.

• Une fois activé, vous pouvez utiliser GADVideoController play, GADVideoController pause et GADVideoController setMute pour contrôler l'annonce vidéo.

Si l'annonce contient du contenu vidéo et que les commandes personnalisées sont activées, vous devez afficher vos commandes personnalisées avec l'annonce, car l'annonce n'affichera aucune commande. Les contrôles peuvent ensuite appeler les méthodes appropriées sur le

GADVideoController.

L'exemple suivant montre comment demander une vidéo avec des commandes de lecture personnalisées.

Swift

let videoOptions = VideoOptions()
videoOptions.areCustomControlsRequested = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.customControlsRequested = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

Vérifier si les commandes personnalisées sont activées

Étant donné qu'il n'est pas possible de savoir au moment de la demande si l'annonce renvoyée autorisera les commandes vidéo personnalisées, vous devez vérifier si les commandes personnalisées sont activées.

Swift

private func checkCustomControlsEnabled(nativeAd: NativeAd) -> Bool {
  let videoController = nativeAd.mediaContent.videoController
  return videoController.areCustomControlsEnabled
}
NativeAdOptionsSnippets.swift

Objective-C

- (BOOL)checkCustomControlsEnabledWithNativeAd:(GADNativeAd *)nativeAd {
  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  return videoController.customControlsEnabled;
}
NativeAdOptionsSnippets.m

Afficher des commandes vidéo personnalisées

Affichez des commandes vidéo personnalisées en suivant les bonnes pratiques suivantes :

1. Affichez la vue des commandes personnalisées en tant qu'enfant de la vue de l'annonce native. Cette approche permet aux calculs de visibilité Open Measurement de considérer les commandes personnalisées comme une obstruction conviviale.
2. Évitez d'afficher une superposition invisible sur l'intégralité de la vue du contenu multimédia. Les calques bloquent les clics sur la vue du contenu multimédia, ce qui a un impact négatif sur les performances des annonces natives. Créez plutôt un petit calque suffisamment grand pour contenir les commandes.

Remarque : Pour en savoir plus sur les fournisseurs de mesure et de validation qui se sont engagés à développer la norme Open Measurement pour la visibilité, consultez le groupe de travail Open Measurement.

Gestes de clic personnalisés

Avertissement : L'accès à cette fonctionnalité est limité. Pour demander l'accès, contactez votre responsable de compte.

Les gestes de clic personnalisés sont une fonctionnalité des annonces natives qui permet d'enregistrer les balayages sur les vues d'annonces comme des clics sur les annonces. Il est conçu pour fonctionner avec les applications qui utilisent des gestes de balayage pour parcourir le contenu. Ce guide vous explique comment activer les gestes de clic personnalisés sur vos annonces natives.

Initialisez une instance GADNativeAdCustomClickGestureOptions avec la direction de balayage de votre choix. Vous devez également indiquer si vous souhaitez que les appuis soient autorisés en tant que clics.

• Les gestes de clic personnalisés sont désactivés par défaut.

• Lorsque cette option est désactivée, seuls les appuis sont comptabilisés comme des clics.

• Si cette option est activée, les gestes de balayage sont comptabilisés comme des clics. Vous pouvez également spécifier si les gestes d'appui peuvent toujours être comptabilisés comme des clics.

L'exemple suivant montre comment implémenter un geste de balayage personnalisé vers la droite tout en conservant le comportement normal d'un appui.

Swift

let swipeGestureOptions = NativeAdCustomClickGestureOptions(
  swipeGestureDirection: .right,
  tapsAllowed: true)

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [swipeGestureOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdCustomClickGestureOptions *swipeGestureOptions =
    [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ swipeGestureOptions ]];
NativeAdOptionsSnippets.m

Avertissement : Si votre compte n'est pas activé pour les gestes de clic personnalisés, les demandes d'annonces renverront un message "Aucune annonce à diffuser".

Écouter les événements de balayage

Lorsqu'un clic par balayage est enregistré, le SDK Google Mobile Ads appelle la méthode déléguée nativeAdDidRecordSwipeGestureClick: sur GADNativeAdDelegate, en plus de la méthode déléguée nativeAdDidRecordClick: existante.

Swift

// Called when a swipe gesture click is recorded, as configured in
// NativeAdCustomClickGestureOptions.
func nativeAdDidRecordSwipeGestureClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click has occurred.")
}

// Called when a swipe gesture click or a tap click is recorded.
func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click or tap click has occurred.")
}
NativeAdOptionsSnippets.swift

Objective-C

// Called when a swipe gesture click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}
NativeAdOptionsSnippets.m

Médiation

Les gestes de clic personnalisés ne fonctionnent que sur les annonces natives affichées par le SDK Google Mobile Ads. Les sources d'annonces qui nécessitent des SDK tiers pour le rendu ne répondent pas au paramètre d'instructions de clic personnalisées.