Partager via

KeywordUrls

  • Article

Contient les méthodes de gestion des URL du mot clé, du modèle de suivi et des paramètres personnalisés. Pour plus d’informations, consultez Suivi des URL avec des URL mises à niveau.

Méthodes

Nom de la méthode Type renvoyé Description
clearFinalUrl void Supprime l’URL finale du mot clé.
clearMobileFinalUrl void Supprime l’URL finale du mot clé pour les appareils mobiles.
clearTrackingTemplate void Supprime le modèle de suivi du mot clé.
getCustomParameters Objet Obtient les paramètres personnalisés du mot clé.
getFinalUrl string Obtient l’URL finale du mot clé.
getMobileFinalUrl string Obtient l’URL finale du mot clé pour les appareils mobiles.
getTrackingTemplate string Obtient le modèle de suivi du mot clé.
setCustomParameters(Object customParameters) void Définit les paramètres personnalisés du mot clé.
setFinalUrl(String finalUrl) void Définit l’URL finale du mot clé.
setMobileFinalUrl(String finalUrl) void Définit l’URL finale du mot clé pour mobile.
setTrackingTemplate(String trackingTemplate) void Définit le modèle de suivi du mot clé.

clearFinalUrl

Supprime l’URL finale du mot clé.

Retourne

Type Description
void Renvoie la valeur nothing.

clearMobileFinalUrl

Supprime l’URL finale du mot clé pour les appareils mobiles.

Retourne

Type Description
void Renvoie la valeur nothing.

clearTrackingTemplate

Supprime le modèle de suivi du mot clé.

Retourne

Type Description
void Renvoie la valeur nothing.

getCustomParameters

Obtient les paramètres personnalisés du mot clé.

Les paramètres personnalisés sont utiles pour le partage d’informations dynamiques entre plusieurs URL. Pour plus d’informations sur son utilisation, consultez Paramètres personnalisés.

Retourne

Type Description
Objet Carte des paramètres personnalisés du mot clé.

Par exemple, {key1: 'value1', key2: 'value2', key3: 'value3'}, où key est le nom du paramètre personnalisé et value est la valeur du paramètre.

getFinalUrl

Obtient l’URL finale du mot clé. Il s’agit de l’URL de la page web vers laquelle l’utilisateur est redirigé lorsqu’il clique sur la publicité.

Les mêmes règles de substitution s’appliquent qu’ailleurs. Par exemple, la spécification de l’URL finale d’un mot clé remplace l’URL finale de l’annonce.

Retourne

Type Description
string URL finale du mot clé.

getMobileFinalUrl

Obtient l’URL finale du mot clé pour les appareils mobiles. Il s’agit de l’URL de la page web mobile vers laquelle l’utilisateur est redirigé lorsqu’il clique sur la publicité.

Les mêmes règles de substitution s’appliquent qu’ailleurs. Par exemple, la spécification de l’URL finale mobile d’un mot clé remplace l’URL finale mobile de l’annonce.

Retourne

Type Description
string URL finale du mot clé pour les appareils mobiles.

getTrackingTemplate

Obtient le modèle de suivi du mot clé.

Les modèles de suivi sont utilisés avec le FinalUrl de l’mot clé pour créer l’URL de destination utilisée par l’annonce. Pour plus d’informations, consultez Quels paramètres de suivi ou d’URL puis-je utiliser ?

Retourne

Type Description
string Modèle de suivi du mot clé.

setCustomParameters(Object customParameters)

Définit les paramètres personnalisés du mot clé. Utilisez cette méthode si l’URL ou le modèle de suivi final comprend des chaînes de substitution personnalisées.

Pour utiliser un nom de paramètre client dans l’URL ou le modèle de suivi final, placez le nom entre accolades et ajoutez un trait de soulignement (_) au nom. Par exemple, si le nom du paramètre est foo, utilisez {_foo} dans le modèle de suivi ou l’URL finale. N’ajoutez pas de trait de soulignement de début au nom du paramètre lors de la définition de l’objet de paramètres personnalisés.

L’appel de cette méthode remplace les paramètres personnalisés existants de l’mot clé.

Pour effacer les paramètres personnalisés de la mot clé, passez un objet vide (par exemple, setCustomParameters({})). Si vous effacez les paramètres personnalisés de l’mot clé, le mot clé hérite des URL de son groupe d’annonces parent (si le groupe d’annonces spécifie des URL). Pour effacer complètement les paramètres personnalisés, effacez-les à tous les niveaux de la hiérarchie.

Les paramètres personnalisés sont utiles pour le partage d’informations dynamiques entre plusieurs URL. Pour plus d’informations sur son utilisation, consultez Paramètres personnalisés.

Arguments

Nom Type Description
customParameters Objet Carte de jusqu’à trois paramètres personnalisés à utiliser dans le mot clé. Par exemple, {key1: 'value1', key2: 'value2', key3: 'value3'}, où key est le nom du paramètre personnalisé et value est la valeur du paramètre. Le nom du paramètre peut contenir uniquement des caractères alphanumériques et la valeur du paramètre peut ne pas contenir d’espace blanc. Le nom peut contenir un maximum de 16 caractères de 8 octets et la valeur peut contenir un maximum de 200 caractères de 8 octets.

Retourne

Type Description
void Renvoie la valeur nothing.

setFinalUrl(String finalUrl)

Définit l’URL finale du mot clé.

L’URL finale identifie la page web vers laquelle l’utilisateur est redirigé lorsqu’il clique sur la publicité. Si elle n’est pas spécifiée, l’entité hérite de l’URL finale de son entité parente. Par exemple, l’entité mot clé hérite de l’URL finale de la publicité. Spécifiez l’URL finale du mot clé pour remplacer l’URL finale de l’annonce.

Pour plus d’informations, consultez Quels paramètres de suivi ou d’URL puis-je utiliser ?

Si la valeur de la propriété n’est pas valide, l’appel échoue en mode silencieux. Pour vérifier si la propriété a été réellement mise à jour, récupérez à nouveau l’objet et testez si la valeur de la propriété est égale à la nouvelle valeur. Pour plus d’informations, consultez Gestion des erreurs et des avertissements.

Arguments

Nom Type Description
finalUrl string URL finale du mot clé.

Retourne

Type Description
void Renvoie la valeur nothing.

setMobileFinalUrl(String finalUrl)

Définit l’URL finale du mot clé pour les appareils mobiles.

L’URL finale identifie la page web vers laquelle l’utilisateur est redirigé lorsqu’il clique sur la publicité. Si elle n’est pas spécifiée, l’entité hérite de l’URL finale de son entité parente. Par exemple, l’entité mot clé hérite de l’URL finale de la publicité. Spécifiez l’URL finale du mot clé pour remplacer l’URL finale de l’annonce.

Pour plus d’informations, consultez Quels paramètres de suivi ou d’URL puis-je utiliser ?

Pour spécifier une URL finale pour les appareils mobiles, spécifiez d’abord une URL finale pour les appareils non mobiles (voir setFinalUrl()).

Si la valeur de la propriété n’est pas valide, l’appel échoue en mode silencieux. Pour vérifier si la propriété a été réellement mise à jour, récupérez à nouveau l’objet et testez si la valeur de la propriété est égale à la nouvelle valeur. Pour plus d’informations, consultez Gestion des erreurs et des avertissements.

Arguments

Nom Type Description
finalUrl chaîne L’URL finale des appareils mobiles du mot clé.

Retourne

Type Description
void Renvoie la valeur nothing.

setTrackingTemplate(String trackingTemplate)

Définit le modèle de suivi du mot clé.

Les modèles de suivi sont utilisés avec le FinalUrl de l’mot clé pour créer l’URL de destination utilisée par l’annonce. Pour plus d’informations, consultez Quels paramètres de suivi ou d’URL puis-je utiliser ?

Si la valeur de la propriété n’est pas valide, l’appel échoue en mode silencieux. Pour vérifier si la propriété a été réellement mise à jour, récupérez à nouveau l’objet et testez si la valeur de la propriété est égale à la nouvelle valeur. Pour plus d’informations, consultez Gestion des erreurs et des avertissements.

Arguments

Nom Type Description
trackingTemplate string Modèle de suivi du mot clé.

Retourne

Type Description
void Renvoie la valeur nothing.