KeywordUrls

Contiene los métodos para administrar las direcciones URL de la palabra clave, la plantilla de seguimiento y los parámetros personalizados. Para obtener información, consulta Seguimiento de direcciones URL con direcciones URL actualizadas.

Métodos

Nombre del método	Tipo de valor devuelto	Description
clearFinalUrl	void	Quita la URL final de la palabra clave.
clearMobileFinalUrl	void	Quita la URL final de la palabra clave para dispositivos móviles.
clearTrackingTemplate	void	Quita la plantilla de seguimiento de la palabra clave.
getCustomParameters	Objeto	Obtiene los parámetros personalizados de la palabra clave.
getFinalUrl	string	Obtiene la dirección URL final de la palabra clave.
getMobileFinalUrl	string	Obtiene la dirección URL final de la palabra clave para dispositivos móviles.
getTrackingTemplate	string	Obtiene la plantilla de seguimiento de la palabra clave.
setCustomParameters(Object customParameters)	void	Establece los parámetros personalizados de la palabra clave.
setFinalUrl(String finalUrl)	void	Establece la dirección URL final de la palabra clave.
setMobileFinalUrl(String finalUrl)	void	Establece la dirección URL final de la palabra clave para móviles.
setTrackingTemplate(String trackingTemplate)	void	Establece la plantilla de seguimiento de la palabra clave.

clearFinalUrl

Quita la URL final de la palabra clave.

Valores devueltos

Tipo	Description
void	Devuelve el valor nothing.

clearMobileFinalUrl

Quita la URL final de la palabra clave para dispositivos móviles.

Valores devueltos

Tipo	Description
void	Devuelve el valor nothing.

clearTrackingTemplate

Quita la plantilla de seguimiento de la palabra clave.

Valores devueltos

Tipo	Description
void	Devuelve el valor nothing.

getCustomParameters

Obtiene los parámetros personalizados de la palabra clave.

Los parámetros personalizados son útiles para compartir información dinámica entre varias direcciones URL. Para obtener más información sobre su uso, consulte Parámetros personalizados.

Valores devueltos

Tipo	Descripción
Object	Un mapa de los parámetros personalizados de la palabra clave. Por ejemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, donde clave es el nombre del parámetro personalizado y valor es el valor del parámetro.

getFinalUrl

Obtiene la dirección URL final de la palabra clave. Es la URL de la página web a la que se dirigirá al usuario cuando haga clic en el anuncio.

Se aplican las mismas reglas de anulación que en otros lugares. Por ejemplo, si se especifica la URL final de una palabra clave, se anula la URL final del anuncio.

Valores devueltos

Tipo	Descripción
string	La URL final de la palabra clave.

getMobileFinalUrl

Obtiene la dirección URL final de la palabra clave para dispositivos móviles. Es la URL de la página web móvil a la que se dirigirá al usuario cuando haga clic en el anuncio.

Se aplican las mismas reglas de anulación que en otros lugares. Por ejemplo, si se especifica la URL final móvil de una palabra clave, se reemplaza la URL final móvil del anuncio.

Valores devueltos

Tipo	Descripción
string	La URL final de la palabra clave para dispositivos móviles.

getTrackingTemplate

Obtiene la plantilla de seguimiento de la palabra clave.

Las plantillas de seguimiento se usan con la FinalUrl de la palabra clave para crear la URL de destino que usa el anuncio. Para obtener más información, consulta ¿Qué parámetros de seguimiento o de URL puedo usar?

Valores devueltos

Tipo	Descripción
string	La plantilla de seguimiento de la palabra clave.

setCustomParameters(Object customParameters)

Establece los parámetros personalizados de la palabra clave. Usa este método si la URL final o la plantilla de seguimiento incluyen cadenas de sustitución personalizadas.

Para usar un nombre de parámetro de cliente en la URL final o en la plantilla de seguimiento, escribe el nombre entre llaves y antepóngale un carácter de subrayado (_). Por ejemplo, si el nombre del parámetro es foo, usa {_foo} en la plantilla de seguimiento o en la URL final. No agregue un guion bajo inicial al nombre del parámetro al definir el objeto de parámetros personalizados.

Al llamar a este método, se reemplazan los parámetros personalizados existentes de la palabra clave.

Para borrar los parámetros personalizados de la palabra clave, pasa un objeto vacío (por ejemplo, setCustomParameters({})). Si borras los parámetros personalizados de la palabra clave, la palabra clave hereda las direcciones URL de su grupo de anuncios principal (si este especifica direcciones URL). Para borrar completamente los parámetros personalizados, bórrelos en todos los niveles de la jerarquía.

Los parámetros personalizados son útiles para compartir información dinámica entre varias direcciones URL. Para obtener más información sobre su uso, consulte Parámetros personalizados.

Argumentos

Nombre	Tipo	Description
customParameters	Objeto	Un mapa de hasta tres parámetros personalizados para usar en la palabra clave. Por ejemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, donde clave es el nombre del parámetro personalizado y valor es el valor del parámetro. El nombre del parámetro solo puede contener caracteres alfanuméricos y el valor del parámetro no puede contener espacios en blanco. El nombre puede contener un máximo de 16 caracteres de 8 bytes y el valor puede contener un máximo de 200 caracteres de 8 bytes.

Valores devueltos

Tipo	Description
void	Devuelve el valor nothing.

setFinalUrl(String finalUrl)

Establece la dirección URL final de la palabra clave.

La dirección URL final identifica la página web a la que se dirigirá al usuario cuando haga clic en el anuncio. Si no se especifica, la entidad hereda la dirección URL final de su entidad principal. Por ejemplo, la entidad de palabra clave hereda la URL final del anuncio. Especifica la URL final de la palabra clave para reemplazar la URL final del anuncio.

Para obtener más información, consulta ¿Qué parámetros de seguimiento o de URL puedo usar?

Si el valor de la propiedad no es válido, se produce un error en la llamada sin mensajes. Para confirmar si la propiedad se ha actualizado realmente, obtenga el objeto de nuevo y compruebe si su valor es igual al nuevo. Para obtener información, consulte Control de errores y advertencias.

Argumentos

Nombre	Tipo	Description
Url final	string	La URL final de la palabra clave.

Valores devueltos

Tipo	Description
void	Devuelve el valor nothing.

setMobileFinalUrl(String finalUrl)

Establece la dirección URL final de la palabra clave para dispositivos móviles.

La dirección URL final identifica la página web a la que se dirigirá al usuario cuando haga clic en el anuncio. Si no se especifica, la entidad hereda la dirección URL final de su entidad principal. Por ejemplo, la entidad de palabra clave hereda la URL final del anuncio. Especifica la URL final de la palabra clave para reemplazar la URL final del anuncio.

Para obtener más información, consulta ¿Qué parámetros de seguimiento o de URL puedo usar?

Para especificar una URL final para dispositivos móviles, primero especifica una URL final para dispositivos no móviles (consulta setFinalUrl()).

Si el valor de la propiedad no es válido, se produce un error en la llamada sin mensajes. Para confirmar si la propiedad se ha actualizado realmente, obtenga el objeto de nuevo y compruebe si su valor es igual al nuevo. Para obtener información, consulte Control de errores y advertencias.

Argumentos

Nombre	Tipo	Description
Url final	string	La dirección URL final de la palabra clave: dispositivos móviles.

Valores devueltos

Tipo	Description
void	Devuelve el valor nothing.

setTrackingTemplate(String trackingTemplate)

Establece la plantilla de seguimiento de la palabra clave.

Las plantillas de seguimiento se usan con la FinalUrl de la palabra clave para crear la URL de destino que usa el anuncio. Para obtener más información, consulta ¿Qué parámetros de seguimiento o de URL puedo usar?

Si el valor de la propiedad no es válido, se produce un error en la llamada sin mensajes. Para confirmar si la propiedad se ha actualizado realmente, obtenga el objeto de nuevo y compruebe si su valor es igual al nuevo. Para obtener información, consulte Control de errores y advertencias.

Argumentos

Nombre	Tipo	Description
trackingTemplate	string	La plantilla de seguimiento de la palabra clave.

Valores devueltos

Tipo	Description
void	Devuelve el valor nothing.