Cette page a été traduite par l'API Cloud Translation.

Options des annonces natives

Elles offrent de nombreuses fonctionnalités avancées personnalisations et 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.

Commandes des composants

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

Les contrôles de format vous permettent de spécifier une préférence pour le format dans vos créations publicitaires.

Définir GADNativeAdMediaAdLoaderOptions mediaAspectRatio avec un GADMediaAspectRatio.

Si cette règle n'est pas configurée, l'annonce renvoyée peut présenter n'importe quel format multimédia.
Si ce paramètre est défini, vous pouvez améliorer l'expérience utilisateur en spécifiant la le type de format souhaité.

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

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

Le contrôle de téléchargement d'images vous permet de décider si les composants Image ou uniquement les URI renvoyées par le SDK.

Définir GADNativeAdImageAdLoaderOptions disableImageLoading avec une valeur BOOL.

La commande de téléchargement d'images est désactivée par défaut.
Lorsqu'il est désactivé, le SDK Google Mobile Ads insère à la fois l'image et l'URI.
Lorsque cette option est activée, le SDK ne remplit que l'URI, ce qui vous permet de télécharger les images à votre discrétion.

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

Commandes de charge utile de l'image

Certaines annonces contiennent 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 d'entre elles.

Définir GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages avec une valeur BOOL.

Les commandes de charge utile de l'image sont désactivées par défaut.
Lorsque cette option est désactivée, votre application demande au SDK de fournir uniquement première image de tout élément contenant une série.
Lorsque cette option est activée, votre application indique qu'elle est prête à afficher toutes les images pour les éléments qui en comportent plusieurs.

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

Emplacements Choisir sa pub

Commandes de position de Choisir sa pub

Les commandes de position "Choisir sa pub" vous permettent de choisir l'angle à afficher Icône Choisir sa pub.

Définir GADNativeAdViewAdOptions preferredAdChoicesPosition avec un GADAdChoicesPosition .

Si cette règle n'est pas configurée, l'icône Choisir sa pub est positionnée en haut à droite.
S'il est défini, "Choisir sa pub" est placé à la position personnalisée demandée.

L'exemple suivant montre comment définir une position d'image personnalisée pour Choisir sa pub.

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

Vue personnalisée "Choisir sa pub"

La vue personnalisée "Choisir sa pub" vous permet de positionner l'icône "Choisir sa pub" dans un emplacement personnalisé. Ceci est différent des contrôles de position de Choisir sa pub, qui ne permet de spécifier l'un des quatre coins.

Définissez la GADNativeAd.adChoicesView établissement avec un GADAdChoicesView avant l'affichage. Le contenu "Choisir sa pub" s'affichera dans la GADAdChoicesView

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

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {

    ...

    
    GADAdChoicesView *customAdChoicesView =
        [[GADAdChoicesView alloc] initWithFrame: CGRectMake(..., ..., ..., ...)];

    [nativeAdView addSubview:customAdChoicesView];
    nativeAdView.adChoicesView = customAdChoicesView;

    // Associate the native ad view with the native ad object. This is
    // required to make the ad clickable.
    // Note: this should always be done after populating the ad views.
    nativeAdView.nativeAd = nativeAd;
}

Swift

func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
    refreshAdButton.isEnabled = true

    ...
    // Define a custom position for the AdChoices icon.
    let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
    let customAdChoicesView = GADAdChoicesView(frame: customRect)
    nativeAdView.addSubview(customAdChoicesView)
    nativeAdView.adChoicesView = customAdChoicesView

    // Associate the native ad view with the native ad object. This is
    // required to make the ad clickable.
    // Note: this should always be done after populating the ad views.
    nativeAdView.nativeAd = nativeAd;
}

Commandes vidéo

Activer le mode silencieux

Le paramètre "Son coupé au démarrage" vous permet de désactiver ou d'activer le son de début d'une vidéo.

Définir GADVideoOptions startMuted avec une valeur BOOL.

Le son est activé par défaut au démarrage.
Lorsque cette option est désactivée, votre application demande que la vidéo commence par audio.
Lorsque cette option est activée, votre application demande que la vidéo commence avec le son coupé.

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

Commandes de lecture personnalisées

Vous pouvez ainsi demander des commandes d'entrée vidéo personnalisées pour lire, mettre en pause ou couper le son vidéo.

Définir GADVideoOptions customControlsRequested avec une valeur BOOL.

Les commandes de lecture personnalisées sont désactivées par défaut.
Lorsque cette option est désactivée, votre vidéo affiche les commandes d'entrée affichées par le SDK.

Lorsque cette option est activée, vous pouvez utiliser GADVideoController play GADVideoController pause et GADVideoController setMute pour contrôler l'annonce vidéo.

Si l'annonce comporte du contenu vidéo et que les commandes personnalisées sont activées, vous devez vous pouvez afficher vos commandes personnalisées avec l'annonce, celle-ci n'étant pas diffusée se contrôle lui-même. Les commandes peuvent ensuite appeler les méthodes appropriées sur la GADVideoController

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

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

Parce qu'au moment de la demande, on ne sait pas si l'annonce affichée autorisera des commandes vidéo personnalisées, vous devez vérifier si elles sont activées.

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd*)nativeAd {

  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  BOOL canShowCustomControls = videoController.customControlsEnabled;

}

Swift

func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
        let videoController = nativeAd.mediaContent.videoController
        let canShowCustomControls = videoController?.customControlsEnabled() == true
}

Gestes de clic personnalisés

Les gestes de clic personnalisés sont une fonctionnalité des annonces natives qui permet de balayer l'écran être enregistrés en tant que clics sur les annonces. Il est conçu pour fonctionner avec les applications qui utilisent le balayage des gestes pour la navigation dans le contenu. Ce guide explique comment activer les clics personnalisés sur vos annonces natives.

Initialiser un GADNativeAdCustomClickGestureOptions avec la direction de balayage sélectionnée. Vous devez également indiquer si vous souhaitez que les clics 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 clics sont comptabilisés.
Lorsque cette option est activée, les gestes de balayage sont comptabilisés comme des clics. Vous pouvez spécifier que si les tapotements peuvent toujours être comptabilisés comme des clics.

L'exemple suivant vous montre comment implémenter un geste de balayage personnalisé pour et préserve le comportement d'appui normal.

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

// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
self.adLoader = [[GADAdLoader alloc]
        initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
      rootViewController:self
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ swipeGestureOptions ]];

Écouter les événements liés aux gestes de balayage

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

#pragma mark - GADNativeAdDelegate implementation

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

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

Médiation

Les gestes de clic personnalisés ne fonctionnent que sur les annonces natives que Google Mobile Rendus du SDK Ads. Sources d'annonces nécessitent des SDK tiers pour ne répondent pas au paramètre d'itinéraire personnalisé par clic.