Veillez à accéder à Votre page AdSense, où vous trouverez des informations personnalisées sur votre compte pour optimiser vos performances avec AdSense.

Annonces pour les recherches

Description des paramètres applicables aux annonces pour les recherches personnalisées

Cette liste destinée aux utilisateurs avancés répertorie les paramètres de style de recherche actuellement disponibles. Le code que vous générez dans AdSense contient toutes les options de paramètre les plus souvent utilisées. Deux paramètres sont obligatoires : pubId et query. AdSense fournit le pubId, mais vous devez modifier le code et attribuer une valeur au paramètre query. Tous les autres paramètres décrits ci-dessous sont facultatifs.

Types de paramètre

Il existe deux types de paramètres :

Voici quelques exemples de résultats fournis par le générateur de code dans le cas de deux blocs d'annonces. Pour configurer ce code, vous devez définir le paramètre query requis dans la fonction pageOptions (par exemple, "query": myQuery). Aucune autre configuration n'est nécessaire pour commencer à diffuser des annonces. Vous pouvez aussi définir des paramètres facultatifs au niveau de la page dans le bloc d'annonces au niveau de la page, ainsi que des paramètres au niveau d'un bloc individuel dans les fonctions adblock1 et adblock2.

<div id="afscontainer1"></div>
<div id="afscontainer2"></div>

<script type="text/javascript" charset="utf-8">

  // Page level parameters
  var pageOptions = {
    "pubId": "partner-pub-1234567891234567",
    "styleId": "1234567890",
    "query": myQuery,
  };

  // Unit level parameters
  var adblock1 = {
    "container": "afscontainer1"
  };

  var adblock2 = {
    "container": "afscontainer2"
  };

  _googCsa('ads', pageOptions, adblock1, adblock2);

</script>

Description des paramètres au niveau de la page

Vous ne devez définir ces paramètres qu'une seule fois par page. Ils s'appliquent à l'ensemble des blocs d'annonces de la page.

Obligatoire

Paramètre Description et exemples
adPage Obligatoire lorsque l'utilisateur accède à la page de résultats suivante ou précédente.

Le paramètre adPage définit la page de résultats sur laquelle les annonces sont diffusées. Il est utilisé lorsque les internautes naviguent au-delà de la première page des résultats de recherche. Par exemple, si cinq annonces sont demandées et que le paramètre adPage est défini sur "2", les cinq annonces renvoyées seront affichées sur la seconde page.

pubId Obligatoire
Il s'agit de votre ID client AdSense. Votre pubId correspond à la partie de votre ID client indiquée après "partner-". Par exemple, si votre ID client est "partner-test-property", votre pubId est "test-property". Il s'agit du protocole standard pour les annonces personnalisées ciblées sur les recherches.

Exemple :

'pubId' : 'test-property'
query Obligatoire
Il s'agit de la requête de recherche saisie par l'utilisateur. La valeur du paramètre de requête ne doit pas être codée.

Exemples :

'query' : 'flowers'

'query' : 'black & decker'

'query' : myQuery // where myQuery is a JavaScript variable containing the search query

resultsPageBaseUrl Obligatoire lorsque la page contient des blocs de recherche associée
Spécifie l'URL de la page de résultats de recherche où la requête de recherche correspond au terme de recherche associée sur lequel l'utilisateur a cliqué. La resultsPageBaseUrl peut inclure ses propres paramètres, à l'exception de la requête de recherche qui sera ajoutée automatiquement.

Exemple :

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

styleId Obligatoire
Spécifie l'ID du style de recherche à appliquer à l'annonce ou aux blocs de recherche associée sur la page. En savoir plus sur l'utilisation de styles de recherche Notez que si le styleId est défini pour une requête, le style est appliqué aux annonces ou aux recherches associées, et les anciens paramètres de style sont ignorés. Si le styleId n'est pas spécifié dans la requête, un style système par défaut sera affiché.

Exemple

'styleId': '1234567890'

Facultatif

Paramètre Description et exemples
linkTarget Facultatif
Spécifie si un clic sur une annonce ouvre le contenu dans la même fenêtre ou dans une nouvelle. La valeur par défaut est "_top". Ce paramètre peut aussi être utilisé au niveau des blocs.
  • '_top' : ouverture dans la même fenêtre
  • '_blank' : ouverture dans une nouvelle fenêtre

Exemple :

'linkTarget' : '_blank'
maxTermLength Facultatif
Spécifie le nombre maximal de caractères d'un terme de recherche associée, espaces compris. Si ce nombre n'est pas défini, aucune limite n'est appliquée.

Exemple :

'maxTermLength' : 50
referrerAdCreative Facultatif
Lorsqu'un utilisateur accède à votre page de contenu incluant un bloc de recherche associée après avoir cliqué sur une annonce ou un lien sur un autre site, et si vous gérez cette annonce ou ce lien, ce paramètre doit être défini sur le texte de l'annonce ou du lien.

Les consignes suivantes s'appliquent à l'utilisation de ce paramètre :

  • Ce paramètre ne doit être fourni que dans une requête de recherche associée pour une page de contenu. Il sera ignoré dans toutes les autres requêtes.
  • Il ne doit être utilisé que pour le trafic que vous recevez volontairement à partir d'autres sites Web, et jamais pour celui généré par les résultats naturels.
  • Il peut inclure la ligne de titre et/ou la description de l'annonce ou de la création du lien.
  • Il n'est pas sensible à la casse.
  • Il accepte un encodage UTF-8 valide, et les caractères Unicode/diacritiques sont compatibles.
  • Google peut utiliser ou ignorer le paramètre que vous envoyez. Son utilisation peut avoir une incidence sur la sélection et le classement des termes.

Exemples :

'referrerAdCreative': 'search for ads related to dental implants'
'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam Facultatif
Spécifie le nom du paramètre d'URL pour la requête de recherche sur la page des résultats de recherche. Si aucun nom n'est défini, la valeur par défaut est "q".

Exemple :

'resultsPageQueryParam' : 'query'
terms Facultatif
Ce paramètre vous permet de fournir votre propre liste de termes de recherche associée séparés par des virgules à renvoyer avec une requête de recherche associée. Toutefois, rien ne garantit que Google les utilisera.

Exemple :

'terms' : 'cars rental, flight ticket'

Paramètres de configuration

Paramètre Description et exemples
adsafe Facultatif
Spécifie les règles de filtrage que Google doit appliquer aux annonces correspondant à la requête de recherche. Voici les valeurs valides pour adsafe et l'impact de chacune d'elles sur les annonces renvoyées :
  • high : cette valeur entraîne la diffusion d'annonces tous publics. Elle ne permet pas d'afficher des annonces à caractère sexuel ou non adaptées à tous les publics.
  • medium : cette valeur entraîne la diffusion d'annonces adaptées ou non à tous les publics. Elle ne permet pas d'afficher des annonces à caractère sexuel.
  • low : cette valeur entraîne la diffusion de tous les types d'annonce.
Remarque : Par défaut, le paramètre adsafe est défini sur "high".

Exemple :

'adsafe': 'medium'
adtest Facultatif
Le paramètre adtest permet d'indiquer qu'une demande d'annonces est un test. Lorsque la valeur "on" est définie pour le paramètre adtest, Google traite la demande comme un test. Nous ne comptabilisons donc aucune impression d'annonce et n'effectuons aucun suivi des résultats de clics.

Lorsque le paramètre adtest est associé à la valeur "on", vous ne générez aucun revenu.

Remarque : Utilisez ce paramètre pour effectuer des tests, mais pas dans les systèmes de production, car vous ne seriez pas rémunéré pour les annonces diffusées.

Par défaut, la valeur du paramètre "adtest" est "off".

Exemple :

'adtest' : 'on'
channel Facultatif
Vous pouvez inclure un critère AdSense pour les recherches afin d'effectuer le suivi des performances de différentes pages. Utilisez l'ID de critère unique que vous avez créé dans votre compte AdSense. En savoir plus sur le suivi des performances des annonces avec des critères personnalisés

Pour séparer plusieurs critères, utilisez le symbole "+".
 

Exemples :

'channel' : 'testA'
'channel' : 'testA+testB'
hl Facultatif
Ce paramètre identifie la langue que les annonces demandées doivent cibler. La valeur par défaut est "en".

Tous les codes de langue de l'API Google Ads sont acceptés.

Remarque : Les annonceurs indiquent les langues ciblées par leurs annonces. Si vous incluez ce paramètre dans votre demande, Google affichera uniquement les annonces qui ciblent la langue spécifiée ou qui ciblent toutes les langues, mais ne garantit pas que le texte d'annonce apparaîtra dans la langue spécifiée.

Généralement, vous définissez le paramètre hl de façon qu'il corresponde à la langue principale de la page à partir de laquelle il est envoyé.

Exemples :

'hl' : 'es'
ie Facultatif

Le paramètre ie définit le schéma de codage des caractères à utiliser pour interpréter la chaîne de requête.

La valeur ie par défaut est "utf-8".

Valeur Nom standard Langues associées acceptées
latin1 ISO-8859-1 Europe occidentale (allemand, anglais, catalan, danois, espagnol, finnois, français, indonésien, italien, néerlandais, norvégien, portugais et suédois)
latin2 ISO-8859-2 Europe de l'Est (croate, hongrois, polonais, roumain, serbe, slovaque, slovène et tchèque)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Pays baltes (estonien, letton et lituanien)
cyrillic ISO-8859-5 Bulgare et russe
arabic ISO-8859-6  
greek ISO-8859-7 Grec
hebrew ISO-8859-8 Hébreu
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandais
euc-jp EUC-JP Japonais
euc-kr EUC-KR Coréen
sjis Shift_JIS Japonais
big5 Big5 Chinois traditionnel
gb GB2312 Chinois simplifié
utf-8 UTF-8 Toutes
oe Facultatif

Le paramètre oe définit le schéma de codage des caractères à utiliser pour encoder le texte des annonces. Bien que ce paramètre soit facultatif d'un point de vue technique, il est recommandé de lui attribuer une valeur.

La valeur oe par défaut est "utf-8".

Valeur Nom standard Langues acceptées
latin1 ISO-8859-1 Europe occidentale (allemand, anglais, catalan, danois, espagnol, finnois, français, indonésien, italien, néerlandais, norvégien, portugais et suédois)
latin2 ISO-8859-2 Europe de l'Est (croate, hongrois, polonais, roumain, serbe, slovaque, slovène et tchèque)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Pays baltes (estonien, letton et lituanien)
cyrillic ISO-8859-5 Bulgare et russe
arabic ISO-8859-6  
greek ISO-8859-7 Grec
hebrew ISO-8859-8 Hébreu
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandais
euc-jp EUC-JP Japonais
euc-kr EUC-KR Coréen
sjis Shift_JIS Japonais
gb GB2312 Chinois simplifié
utf-8 UTF-8 Toutes
personalizedAds Facultatif
Spécifie si les utilisateurs ont autorisé l'éditeur à partager des informations personnelles avec Google pour la publicité personnalisée.
  • La valeur true renvoie des annonces ciblées en fonction de la requête, ainsi que certaines annonces susceptibles d'utiliser les cookies Google de l'utilisateur à des fins de ciblage. Si ce dernier est situé dans l'Union européenne, il doit d'abord autoriser votre site à partager des informations personnelles avec Google dans le cadre de la publicité personnalisée.
  • La valeur false ne renvoie que des annonces ciblées en fonction de la requête. Elle ne renvoie donc aucune annonce utilisant les cookies Google de l'utilisateur à des fins de ciblage. Si un utilisateur a refusé que votre site partage des informations personnelles avec Google pour la publicité personnalisée, vous devez définir cette valeur sur "false".
Remarque : Par défaut, la valeur personalizedAds est définie sur "true".

Exemple :

'personalizedAds': false

Description des paramètres au niveau du bloc d'annonces

Ces paramètres ont un impact sur la façon dont chaque bloc d'annonces est présenté à l'utilisateur. Vous pouvez définir chacun d'eux pour chaque bloc d'annonces.

Obligatoire

Paramètre Description et exemples
container Obligatoire
Identifiant du conteneur d'annonces vide <div id='afscontainer1'></div> dans lequel l'annonce doit apparaître.

Exemple :

'container' : 'afscontainer1'
maxTop Obligatoire

Ce paramètre vous permet de spécifier le nombre d'annonces à afficher dans le bloc d'annonces en haut de la page.

Remarque : Il remplace le paramètre number. Ce bloc d'annonces doit être suffisamment large pour que la première ligne des annonces ne fasse pas l'objet d'un retour à la ligne automatique. Toute utilisation du paramètre maxTop à un autre emplacement de la page constitue un non-respect des règles.

Exemple :

'maxTop' : 4
width Obligatoire
Spécifie la largeur (en pixels) du bloc d'annonces ou du bloc de recherche associée.

Exemples :

'width' : '700px'
'width' : 700

Paramètres de configuration

Paramètre Description et exemples
adLoadedCallback Facultatif
Spécifie une fonction JavaScript à appeler lorsque les annonces ou les recherches associées ont été chargées, ou lorsqu'aucune annonce ni recherche associée n'est diffusée. Ce paramètre doit être défini sur une fonction de rappel JavaScript que vous implémentez et qui permet d'effectuer une action lorsque l'appel d'annonce est terminé.

La fonction de rappel utilise les paramètres suivants :

containerName Nom du conteneur de l'annonce ou du bloc de recherche associée.
adsLoaded Défini sur "true" lorsqu'il existe au moins une annonce ou un terme de recherche associée à afficher, et sur "false" lorsqu'aucune annonce ni recherche associée n'est renvoyée.
isExperimentVariant Défini sur "true" si un test de style personnalisé est en cours et que la variante du test est choisie pour afficher les annonces.
callbackOptions Objet JSON contenant les champs suivants :

termPositions : pour un bloc de recherche associée, contient une map<string,int> des termes fournis par l'éditeur et leur position commençant par zéro dans la réponse. Si un terme est fourni, mais pas renvoyé, il n'apparaîtra pas dans la fonction.

Remarque : Veuillez tester votre fonction de rappel pour vous assurer qu'elle ne génère aucune erreur, en particulier celles qui pourraient interférer avec le chargement de votre page.

Exemple de rappel JavaScript :

var adblock1 = {
  'container' : 'adblock1_div_id',
  'adLoadedCallback' : function(containerName, adsLoaded,
    isExperimentVariant, callbackOptions) {
    if (adsLoaded) {
       try {
         // most likely do nothing
       } catch (e) {
         alert ("Error in callback function");
         // Do something to handle error gracefully
       }
    } else {
       // as you always do when there is no ad coverage from Google
    }
  }
};
number Facultatif
Nombre d'annonces à diffuser dans ce bloc. La valeur par défaut est "2".

Exemple :

'number' : 4
relatedSearches Facultatif
Nombre de recherches associées à afficher dans ce bloc. Si ce nombre n'est pas spécifié, la valeur par défaut est "0".

Exemple :

'relatedSearches' : 4
Ces informations vous-ont elles été utiles ?
Comment pouvons-nous l'améliorer ?

Vous avez encore besoin d'aide ?

Connectez-vous pour accéder à des options d'assistance supplémentaires afin de résoudre rapidement votre problème.

true
Votre page d'assistance AdSense

Présentation de la page d'assistance AdSense : cette nouvelle ressource vous permettra de trouver des informations personnalisées et de nouvelles opportunités dans votre compte afin de profiter pleinement d'AdSense.

Recherche
Effacer la recherche
Fermer le champ de recherche
Applications Google
Menu principal
true
Rechercher dans le centre d'aide
true
true
true
true
true
157