Paramètres
Description des paramètres au niveau de la page
Ces paramètres ne doivent être spécifiés qu'une seule fois par page. Ils s'appliquent à tous les blocs d'annonces de la page.
Obligatoire
Paramètres | Description et exemples |
---|---|
adPage
|
Obligatoire lorsque l'utilisateur accède à la page de résultats suivante ou précédente. Le paramètre |
pubId
|
Obligatoire Il s'agit de votre ID client AdSense. Votre pubId est la partie de votre ID client situé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 pour les recherches personnalisées. Exemple : 'pubId' : 'test-property' |
query
|
Obligatoire, sauf pour la recherche associée sur les pages de 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 encodée. Remarque:L'utilisation de ce paramètre sur la recherche associée sur des pages de contenu génère 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 des résultats de recherche sur laquelle la requête de recherche correspond au terme de recherche associée sur lequel l'utilisateur a cliqué. La valeur 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 personnalisé à appliquer à l'annonce ou aux blocs de recherche associée sur la page. En savoir plus sur l'utilisation de styles de recherche personnalisés Notez que si le styleId est défini pour une requête, les annonces ou les recherches associées sont affichées avec le style, 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ètres | Description et exemples |
---|---|
linkTarget
|
Facultatif Indique si un clic sur une annonce s'ouvre dans la même fenêtre ou dans une nouvelle. La valeur par défaut est "_top". Ce paramètre peut également être utilisé au niveau du bloc d'annonces.
Exemple : 'linkTarget' : '_blank' |
maxTermLength
|
Facultatif Spécifie le nombre maximal de caractères d'un terme de recherche associée, espaces compris. Si aucune valeur n'est définie, aucune valeur maximale n'est définie. Exemple : 'maxTermLength' : 50 |
referrerAdCreative
|
Facultatif Si un utilisateur accède à votre page de contenu qui contient un bloc de recherche associée pour le contenu en cliquant sur une annonce ou un lien sur un autre site Web, et que vous contrôlez cette annonce ou ce lien, ce paramètre doit être défini tel quel. Les consignes suivantes s'appliquent à l'utilisation de ce paramètre:
Remarque:Ce paramètre est obligatoire lorsque vous utilisez le paramètre 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 de résultats de recherche. Si aucune valeur n'est spécifiée, la valeur par défaut est "q". Exemple : 'resultsPageQueryParam' : 'query' |
terms
|
Facultatif Ce paramètre vous permet de fournir une liste de vos propres termes de recherche associée, séparés par une virgule, qui sera renvoyée avec une requête de recherche associée. Toutefois, Google peut ou non utiliser les termes fournis ici.
Remarque:Lorsque vous utilisez ce paramètre, 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 qui peut être ignoré en toute sécurité sans affecter le contenu principal ni l'expérience utilisateur. Remarque:Le produit Recherche associée sur le contenu s'appuie sur le système d'exploration de 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 générer des termes de recherche associés inexacts ou non pertinents. Ce paramètre de page indique au robot d'exploration Google d'ignorer ces paramètres non essentiels afin de garantir une indexation correcte du contenu et de réduire la charge d'exploration inutile. Cela permet à Google de mieux reconnaître une page comme ayant déjà été explorée et de commencer à afficher des suggestions de termes (à la fois Google et celui du partenaire, s'il est éligible). Les consignes suivantes s'appliquent à l'utilisation de ce paramètre:
Exemples :
http://example.com/content?utm_medium=social&page_id=123&click_id=456Fournit les paramètres d'URL que l'utilisateur peut ignorer : 'ignoredPageParams' : 'utm_medium,click_id,session_ref'L'URL de la page de contenu doit être traitée comme suit : http://example.com/content?page_id=123 |
Paramètres de configuration
Paramètres | 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 paramètres valides pour adsafe et l'impact de chaque valeur sur les annonces renvoyées :
Par défaut, AdSafe est défini sur "high". Exemple : 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
Facultatif Le paramètre adtest permet d'indiquer qu'une demande d'annonces correspond à un test. Lorsque le paramètre adtest est associé à la valeur on, Google traite la demande comme un test, ne comptabilise pas les impressions d'annonces et n'effectue pas le suivi des clics. Lorsque le paramètre adtest est associé à la valeur on, vous ne générez aucun revenu. Utilisez ce paramètre pour effectuer des tests, mais pas dans les systèmes de production. Sinon, vous ne serez 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 de suivre les performances de différentes pages. Utilisez l'ID de critère unique créé dans votre compte AdSense ou par votre responsable de compte technique. Pour en savoir plus sur les chaînes, cliquez ici. Si vous ajoutez plusieurs chaînes, vous devez les séparer par le symbole "+". Exemples : 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl
|
Facultatif Ce paramètre identifie la langue que les annonces demandées ou les recherches associé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 La valeur par défaut de
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Facultatif Le paramètre La valeur par défaut de
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
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 au trafic incorrect et un stockage local pour le trafic autorisé et non autorisé.
Par défaut, l'IVT est défini 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ètres | 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 est au-dessus des résultats de recherche. Utilisez ce paramètre pour spécifier le nombre d'annonces à diffuser dans le bloc d'annonces supérieur. Remarque: Ce paramètre est utilisé à la place du paramètre "number". Il doit être suffisamment large pour que la première ligne des annonces ne fasse pas l'objet d'un retour automatique à la ligne. 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ètres | 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. Le paramètre doit être défini sur une fonction de rappel JavaScript que vous implémentez et qui permet d'effectuer une action une fois l'appel d'annonce terminé. La fonction de rappel utilise les paramètres suivants:
Remarque: Veuillez tester votre fonction de rappel pour vous assurer qu'elle ne génère aucune erreur, en particulier si elle perturbe 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 aucune valeur n'est spécifiée, la valeur par défaut est 0. Exemple : 'relatedSearches' : 4 |