KeywordUrls

Contient les méthodes de gestion des URL, du modèle de suivi et des paramètres personnalisés du mot clé. 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, voir 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 valeur 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 dirigé lorsqu’il clique sur l’annonce.

Les mêmes règles de dérogation 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 dirigé lorsqu’il clique sur l’annonce.

Les mêmes règles de dérogation 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 l’URL finale du 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 finale ou le modèle de suivi inclut des chaînes de substitution personnalisées.

Pour utiliser un nom de paramètre client dans l’URL finale ou le modèle de suivi, 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 dans l’URL finale. N’ajoutez pas de trait de soulignement 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 du mot clé.

Pour effacer les paramètres personnalisés du mot clé, transmettez un objet vide (par exemple, setCustomParameters({})). Si vous effacez les paramètres personnalisés du 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, voir Paramètres personnalisés.

Arguments

Nom Type Description
customParameters Objet Carte de trois paramètres personnalisés maximum à utiliser dans le mot clé. Par exemple, {key1: 'value1', key2: 'value2', key3: 'value3'}, où key est le nom du paramètre personnalisé et valeur est la valeur du paramètre. Le nom du paramètre ne peut contenir que des caractères alphanumériques et la valeur du paramètre ne doit pas contenir d’espaces. 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 dirigé lorsqu’il clique sur l’annonce. Si cela n’est pas spécifié, l’entité hérite de l’URL finale de son entité parente. Par exemple, l’entité de mot clé hérite de l’URL finale de l’annonce. 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 silencieusement. Pour confirmer si la propriété a été réellement mise à jour, récupérez l’objet et testez si la valeur de la propriété est égale à la nouvelle valeur. Pour plus d’informations, voir 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 dirigé lorsqu’il clique sur l’annonce. Si cela n’est pas spécifié, l’entité hérite de l’URL finale de son entité parente. Par exemple, l’entité de mot clé hérite de l’URL finale de l’annonce. 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 périphériques mobiles, spécifiez d’abord une URL finale pour les périphériques non mobiles (reportez-vous à la section setFinalUrl()).

Si la valeur de la propriété n’est pas valide, l’appel échoue silencieusement. Pour confirmer si la propriété a été réellement mise à jour, récupérez l’objet et testez si la valeur de la propriété est égale à la nouvelle valeur. Pour plus d’informations, voir Gestion des erreurs et des avertissements.

Arguments

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

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 l’URL finale du 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 silencieusement. Pour confirmer si la propriété a été réellement mise à jour, récupérez l’objet et testez si la valeur de la propriété est égale à la nouvelle valeur. Pour plus d’informations, voir 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.