Référence

Paramètres

Description des paramètres au niveau de la page

Vous ne devez spécifier ces paramètres qu'une seule fois par page. Ils s'appliquent à tous les 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 annonces affichées seront la deuxième page de cinq annonces.

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.
Requête de recherche saisie par l'utilisateur. La valeur du paramètre de requête doit être non encodées.

Remarque:Si vous utilisez ce paramètre pour la recherche associée sur des pages de contenu, 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 sur laquelle la requête correspond terme de recherche associée sur lequel l'utilisateur a cliqué. L'URL resultsPageBaseUrl peut inclure sa propre URL , à 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. Elle contrôle le type L'expérience de recherche associée s'affiche en fonction du contexte de la page: <ph type="x-smartling-placeholder">
    </ph>
  • 'content' Utilisez cette option pour la recherche associée sur les pages de contenu (articles, articles de blog).
  • 'query' Utilisez cette option exclusivement pour la recherche associée sur 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 essentiel de noter que cette valeur par défaut conçue uniquement pour les pages de résultats de recherche (recherche associée dans la recherche Google). Si vous utilisez si vous utilisez la recherche associée sur tout autre type de page (par exemple, des articles ou des articles de blog), vous devez définit explicitement le paramètre sur "content".

Remarque : L'utilisation de ce paramètre est soumise aux consignes ci-dessous.

  • Certaines fonctionnalités de recherche associée peuvent être activées ou désactivées en fonction de la valeur .
  • Déclarations trompeuses concernant le type de page ou utilisation de la "requête" par défaut du paramètre sur les pages de résultats de recherche autres que les pages de résultats de recherche est considéré comme un cas de non-respect des ces instructions écrites.
  • Google peut vérifier périodiquement l'exactitude de cette valeur, qu'elle soit définie ou non. manuellement ou en utilisant la valeur par défaut.

Exemples :

'relatedSearchTargeting' : 'content'
'relatedSearchTargeting' : 'query'
styleId Obligatoire
Spécifie l'ID du style de recherche personnalisé à appliquer à l'annonce ou aux blocs de recherche associée sur la page. <ph type="x-smartling-placeholder"></ph> En savoir plus sur l'utilisation des styles de recherche personnalisés Notez qu'avec le styleId défini pour une requête, les annonces ou les recherches associées s'afficheront avec le style, et les anciens paramètres de style seront sont ignorées. Si le styleId n'est pas spécifié dans la requête, un style par défaut du système sera affiché.

Exemple :

'styleId': '1234567890'

Facultatif

Paramètre Description et exemples
linkTarget Facultatif
Indique si un clic sur une annonce ouvre la même fenêtre ou une nouvelle fenêtre. La valeur par défaut est "_top". Ce paramètre peut également être utilisé au niveau du bloc.
  • '_top' S'ouvre dans la même fenêtre.
  • '_blank' S'ouvre 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 aucune valeur maximale n'est définie, aucune valeur maximale n'est définie.

Exemple :

'maxTermLength' : 50

referrerAdCreative Facultatif
Lorsqu'un utilisateur accède à une page de contenu comportant un bloc de recherche associée pour le réseau de contenu lorsqu'ils cliquent sur une annonce ou un lien figurant sur un autre site Web et que vous contrôlez cette annonce ou ce lien, ce paramètre doit correspondre exactement au 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 demande de recherche associée pour le contenu est ignoré pour toutes les autres requêtes.
  • Il ne doit être utilisé que pour le trafic que vous générez intentionnellement à partir d'autres sur les sites Web et ne doivent pas être utilisées pour le trafic généré par les résultats naturels.
  • Elle doit inclure la ligne de titre, la description et/ou toute autre formulation dans l'annonce ou avec la création associée à un lien.
  • L'omission des valeurs de la création associée à l'annonce ou au lien (ou à l'inclusion de valeurs supplémentaires) est considéré comme un non-respect de ces instructions écrites.
  • Ce champ n'est pas sensible à la casse.
  • Il accepte un encodage UTF-8 valide. Les caractères Unicode et les caractères diacritiques sont acceptés.
  • Google peut utiliser ou ignorer le paramètre que vous envoyez. Son utilisation peut affecter la sélection et le classement des termes.

Remarque:Ce paramètre est obligatoire lorsque vous utilisez la méthode 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 de résultats de recherche. S'il n'est pas spécifié, 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és, séparés par une virgule. à renvoyer avec une requête de recherche associée, même si Google peut ou non utiliser l'attribut conditions d'utilisation fournies ici.

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

Exemples:

'terms' : 'cars rental, flight ticket'

ignoredPageParams Facultatif
Spécifie la liste des paramètres d'URL pour une page de contenu avec une recherche associée pour les pages de contenu qui peut être ignoré sans risque, sans affecter le contenu principal ni l'expérience utilisateur.

Remarque:Pour que les termes de recherche associée puissent apparaître sur votre site, Google doit explorer vos pages pour vous assurer que les termes sont pertinents d'un point de vue contextuel. Lorsqu'une page n'a pas encore été explorées ou dont l'exploration est bloquée (par un fichier robots.txt, par exemple) robot d'exploration AdSense nous n'affichons pas les termes de recherche associée que vous fournissez à Google.

Le produit Recherche associée sur le contenu s'appuie sur le système d'exploration de contenu de Google pour indexer pages et générer des termes de recherche pertinents. URL des pages de contenu contenant des paramètres de requête tels que car les variables de suivi, les ID utilisateur, les ID de session ou d'autres identifiants dynamiques peuvent interférer avec la capacité du robot d'exploration à évaluer le contenu principal de la page, et peut donner lieu à des des termes de recherche associée non pertinents. Ce paramètre de page demande au robot d'exploration Google d'ignorer ces paramètres non essentiels, ce qui garantit une indexation appropriée du contenu et une réduction de l'exploration inutile de votre application. Cela permet à Google de mieux reconnaître qu'une page a déjà été explorée et de commencer affichant les termes suggérés (à la fois ceux de Google et ceux du partenaire, s'ils sont éligibles).

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

  • Ce paramètre ne doit être fourni que dans une demande de recherche associée pour le contenu est ignoré pour 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'affichent lorsqu'un utilisateur accède à la page de contenu.
  • Ce champ est sensible à la casse.
  • Lorsqu'un paramètre d'URL de cette liste est supprimé de l'URL de la page de contenu, vous devez n'ont pas d'impact significatif sur le contenu, l'apparence ou l'expérience utilisateur des pages.
  • l'inclusion d'un paramètre d'URL qui a un impact significatif sur le contenu, l'apparence ou expérience utilisateur est considérée comme une violation de ces instructions écrites.
  • Google peut vérifier périodiquement les effets de l'omission des paramètres d'URL fournis.

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

http://example.com/content?utm_medium=social&page_id=123&click_id=456
Fournir les paramètres d'URL pouvant être ignorés:
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
L'URL de la page de contenu est traitée 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 paramètres adsafe valides et l'impact de chaque valeur sur les annonces renvoyées: <ph type="x-smartling-placeholder">
    </ph>
  • 'high' entraîne la diffusion d'annonces tous publics. Ce paramètre ne permet pas la diffusion d'annonces à caractère sexuel ou pour adultes uniquement.
  • 'medium' : entraîne la diffusion d'annonces tous publics et pour adultes uniquement. Ce paramètre ne permet pas la diffusion d'annonces à caractère sexuel.
  • 'low' Renvoie tous les types d'annonces.

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.

Les demandes d'annonces dont le paramètre adtest est défini sur on et qui proviennent d'un domaine qui n'a pas été approuvé dans l'onglet "Sites" renverront des annonces comportant une "annonce test". se superposent et ne sont pas cliquables.

Utilisez ce paramètre pour effectuer des tests, mais pas dans les systèmes de production, car 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 d'effectuer le suivi des performances de différentes pages. Utiliser l'ID de chaîne unique dans votre compte AdSense ou par votre responsable de compte technique. Pour en savoir plus sur les critères, cliquez ici.

S'il y a plusieurs critères, séparez-les à l'aide du 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 ie définit le schéma d'encodage 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 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 d'encodage des caractères que Google doit utiliser pour encoder le texte des annonces. Bien que ce paramètre soit techniquement facultatif, 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, 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 d'indiquer une valeur booléenne indiquant à Google que vous souhaitez autoriser les annonces qui utilisent un cookie dédié uniquement au trafic incorrect le stockage local sur le trafic autorisé et non autorisé.
  • true Si ce paramètre n'est pas présent ou que vous le définissez sur "true", nous définirons un cookie dédié uniquement au trafic incorrect et n'utiliserons le stockage local que pour le trafic autorisé.
  • false Lorsque vous définissez ce paramètre sur "false" nous définirons un cookie dédié uniquement au trafic incorrect et utiliserons le 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è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 est placé au-dessus des résultats de recherche.

Ce paramètre permet de spécifier le nombre d'annonces à diffuser dans le bloc d'annonces supérieur.

Remarque: Ce paramètre remplace le "numéro". . Ce bloc d'annonces doit être suffisamment large pour que la première ligne des annonces ne soit pas encapsulée. Utilisation de la commande maxTop à tout autre emplacement de la page constitue un cas de non-respect des règles.

Exemple :

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

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 lorsqu'aucune annonce ou recherche associée n'est diffusée. Le paramètre doit être défini sur Fonction de rappel JavaScript que vous implémentez et qui permet d'effectuer une action lorsque que 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 y a au moins une annonce ou un terme de recherche associée à afficher, et "false" Lorsqu'aucune annonce ou recherche associée ne s'affiche.
isExperimentVariant Défini sur "true" si un test de style personnalisé est en cours et si la variante de la est choisi pour afficher les annonces.
callbackOptions Un objet JSON contenant les champs suivants:
termPositions: Pour un bloc de recherche associée, contient un élément map<string,int> des annonces fournies par l'éditeur à la position indexée sur zéro de ces termes dans la réponse. Si un terme est fourni mais n'est pas renvoyée, il n'apparaîtra pas sur la carte.

Remarque: Veuillez tester votre fonction de rappel pour vous assurer qu'elle ne génère aucune erreur. en particulier ceux qui peuvent 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 aucune valeur n'est spécifiée, la valeur par défaut est 0.

Exemple :

'relatedSearches' : 4