Référence

Paramètres

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. Ce paramètre est utilisé lorsque les utilisateurs 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 sur le Réseau de Recherche.

Exemple :

'pubId' : 'test-property'
query Obligatoire, sauf sur les pages de recherche associée sur le contenu.
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.

Remarque:L'utilisation de ce paramètre dans la recherche associée sur les pages de contenu entraînera des résultats inattendus.

Exemples :

'query' : 'flowers'
'query' : 'black & decker'
'query' : myQuery // myQuery is a 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'
relatedSearchTargeting Obligatoire lorsque la page contient des blocs de recherche associée.
Ce paramètre est obligatoire lorsque des blocs de recherche associée sont demandés. Il contrôle le type d'expérience de recherche associée qui s'affiche, en fonction du contexte de la page :
  • 'content' Utilisez cette option pour la recherche associée sur les pages de contenu (articles, posts de blog, etc.).
  • 'query' Utilisez cette option exclusivement pour la recherche associée sur les pages de résultats de recherche.

Remarque:Le paramètre de page relatedSearchTargeting est automatiquement défini sur "query" par défaut. Toutefois, il est important de noter que cette valeur par défaut est conçue uniquement pour les pages de résultats de recherche (recherche associée dans la recherche). Si vous utilisez la recherche associée sur un autre type de page (articles, articles de blog, par exemple), vous devez définir explicitement le paramètre sur "content".

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

  • Certaines fonctionnalités de recherche associée peuvent être activées ou désactivées en fonction de la valeur de ce paramètre de page.
  • Toute représentation trompeuse du type de page ou tout recours au paramètre par défaut "query" pour le paramètre relatedSearchTargeting sur les pages autres que les résultats de recherche est considéré comme une violation de ces instructions écrites.
  • Google peut vérifier régulièrement l'exactitude de cette valeur, que ce soit manuellement ou à l'aide de la valeur par défaut.

Exemples :

'relatedSearchTargeting' : 'content'
'relatedSearchTargeting' : 'query'
styleId Obligatoire
Spécifie l'ID du style personnalisé dans les recherches à appliquer à l'annonce ou aux blocs de recherche associée sur la page. En savoir plus sur l'utilisation des styles personnalisés dans les recherches 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
Indique 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' : s'ouvre dans la même fenêtre.
  • '_blank' : ouvre dans une nouvelle fenêtre.

Exemple :

'linkTarget' : '_blank'
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 doit inclure la ligne de titre, la description et/ou tout autre libellé de l'annonce ou de la création du lien.
  • L'omission de valeurs de la création de l'annonce ou du lien (ou l'inclusion de valeurs supplémentaires) est considérée comme une violation de ces instructions écrites.
  • Ce champ 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.

Remarque:Ce paramètre est obligatoire lorsque vous utilisez le paramètre terms.

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.

Remarque:Lorsque vous utilisez ce paramètre, referrerAdCreative est également obligatoire, et relatedSearchTargeting est obligatoire et doit être défini sur "content".

Exemples :

'terms' : 'cars rental, flight ticket'
ignoredPageParams Facultatif
Spécifie la liste des paramètres d'URL pour une page de contenu avec un bloc de recherche associée pour le contenu pouvant être ignoré sans affecter le contenu principal ni l'expérience utilisateur.

Remarque:Avant que les termes de recherche associée puissent apparaître sur votre site, Google doit explorer vos pages pour s'assurer qu'ils sont pertinents dans le contexte. Lorsqu'une page n'a pas encore été explorée ou qu'elle est bloquée (par exemple, par un fichier robots.txt) par le robot d'exploration AdSense, nous n'affichons pas les suggestions de termes de recherche associés que vous fournissez à Google.

Le produit "Recherche associée sur le contenu" s'appuie sur le système d'exploration du contenu de Google pour indexer les pages et générer des termes de recherche pertinents. Les URL de pages de contenu contenant des paramètres de requête tels que des variables de suivi, des ID utilisateur, des ID de session ou d'autres identifiants dynamiques peuvent empêcher le robot d'exploration d'évaluer le contenu principal de la page et peuvent entraîner des termes de recherche associés inexacts ou non pertinents. Ce paramètre de page indique à l'explorateur de Google d'ignorer ces paramètres non essentiels, ce qui garantit une indexation correcte du contenu et réduit la charge d'exploration inutile. Cela permet à Google de mieux reconnaître qu'une page a déjà été explorée et de commencer à afficher des suggestions de termes (à la fois de Google et du partenaire, le cas échéant).

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.
  • La valeur de ce paramètre doit être une liste de paramètres d'URL séparés par une virgule qui peuvent s'afficher lorsqu'un utilisateur accède à la page de contenu.
  • Ce champ est sensible à la casse.
  • Lorsque vous supprimez un paramètre d'URL de cette liste de l'URL de la page de contenu, cela ne devrait pas avoir d'impact significatif sur le contenu, l'apparence ou l'expérience utilisateur de la page.
  • L'inclusion d'un paramètre d'URL qui a un impact significatif sur le contenu, l'apparence ou l'expérience utilisateur des pages est considérée comme une violation de ces instructions écrites.
  • Google peut vérifier périodiquement l'impact de l'ignorance des paramètres d'URL fournis.

Exemples :
Un utilisateur consulte une page de contenu dont l'URL est:

http://example.com/content?utm_medium=social&page_id=123&click_id=456
Fournissez les paramètres d'URL ignorables suivants:
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
traitera l'URL de la page de contenu comme suit:
http://example.com/content?page_id=123

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.

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.

Les demandes d'annonces avec le paramètre adtest défini sur on provenant d'un domaine qui n'a pas été approuvé dans l'onglet "Sites" renvoient des annonces avec un calque "Annonce test" et qui ne sont pas cliquables.

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.

La valeur par défaut 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 chaîne unique créé dans votre compte AdSense ou par votre responsable de compte technique. En savoir plus sur les chaînes

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 ou les recherches associées demandées doivent cibler. La valeur par défaut est en.

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

Remarque : Les annonceurs indiquent les langues ciblées par leurs annonces. Si vous incluez ce paramètre dans votre demande, Google diffuse uniquement les annonces ciblées sur cette langue ou sur toutes les langues. Cela ne signifie pas pour autant que le texte d'annonce apparaîtra dans la langue spécifiée.

Il est recommandé de définir le paramètre hl sur 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 par défaut de ie 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, suédois)
latin2 ISO-8859-2 Europe de l'Est (croate, hongrois, polonais, roumain, serbe, slovaque, slovène, tchèque)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Pays baltes (estonien, letton, lituanien)
cyrillic ISO-8859-5 Bulgare, 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 Tous
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 par défaut de oe 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, suédois)
latin2 ISO-8859-2 Europe de l'Est (croate, hongrois, polonais, roumain, serbe, slovaque, slovène, tchèque)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Pays baltes (estonien, letton, lituanien)
cyrillic ISO-8859-5 Bulgare, 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 Tous
ivt Facultatif
Ce paramètre vous permet de fournir une valeur booléenne qui indique à Google que vous souhaitez autoriser les annonces qui utilisent un cookie dédié uniquement à la détection du trafic incorrect et un espace de stockage local pour le trafic avec et sans consentement.
  • true Lorsque ce paramètre n'est pas présent ou que vous le définissez sur "true", nous définissons un cookie dédié uniquement à la détection du trafic incorrect et utilisons le stockage local uniquement pour le trafic consenti.
  • false Lorsque vous définissez ce paramètre sur "false", nous définissons un cookie dédié uniquement à la détection du trafic incorrect et utilisons un espace de stockage local pour le trafic avec et sans consentement.

Par défaut, la valeur de l'attribut IVT est définie sur "true".

Exemple :

'ivt': 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'internaute. Vous pouvez définir chaque paramètre individuellement pour chaque bloc d'annonces.

Obligatoire

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

Exemple :

'container' : 'afscontainer1'
maxTop Obligatoire lorsque le bloc d'annonces se trouve au-dessus des résultats de recherche.

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) de l'annonce ou du bloc de recherche associée.

Exemple :

'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é.
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 carte.

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