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, consulte Seguimiento de direcciones URL con direcciones URL actualizadas.
Métodos
| Nombre del método | Tipo de valor devuelto | Descripción |
|---|---|---|
| clearFinalUrl | void | Quita la dirección URL final de la palabra clave. |
| clearMobileFinalUrl | void | Quita la dirección 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 dispositivos móviles. |
| setTrackingTemplate(String trackingTemplate) | void | Establece la plantilla de seguimiento de la palabra clave. |
clearFinalUrl
Quita la dirección URL final de la palabra clave.
Valores devueltos
| Tipo | Descripción |
|---|---|
| void | Devuelve el valor nothing. |
clearMobileFinalUrl
Quita la dirección URL final de la palabra clave para dispositivos móviles.
Valores devueltos
| Tipo | Descripción |
|---|---|
| void | Devuelve el valor nothing. |
clearTrackingTemplate
Quita la plantilla de seguimiento de la palabra clave.
Valores devueltos
| Tipo | Descripción |
|---|---|
| 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, vea Parámetros personalizados.
Valores devueltos
| Tipo | Descripción |
|---|---|
| Object | Mapa de los parámetros personalizados de la palabra clave. Por ejemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, donde key es el nombre del parámetro personalizado y value es el valor del parámetro. |
getFinalUrl
Obtiene la dirección URL final de la palabra clave. Esta es la dirección URL de la página web a la que se lleva al usuario cuando hace clic en el anuncio.
Se aplican las mismas reglas de invalidación que en otro lugar. Por ejemplo, especificar la dirección URL final de una palabra clave invalida la dirección URL final del anuncio.
Valores devueltos
| Tipo | Descripción |
|---|---|
| string | Dirección URL final de la palabra clave. |
getMobileFinalUrl
Obtiene la dirección URL final de la palabra clave para dispositivos móviles. Esta es la dirección URL de la página web móvil a la que se lleva al usuario cuando hace clic en el anuncio.
Se aplican las mismas reglas de invalidación que en otro lugar. Por ejemplo, si se especifica la dirección URL final móvil de una palabra clave, se invalida la dirección URL final móvil del anuncio.
Valores devueltos
| Tipo | Descripción |
|---|---|
| string | Dirección 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 finalUrl de la palabra clave para crear la dirección URL de destino usada por el anuncio. Para obtener más información, consulte ¿Qué parámetros de seguimiento o dirección URL puedo usar?
Valores devueltos
| Tipo | Descripción |
|---|---|
| string | Plantilla de seguimiento de la palabra clave. |
setCustomParameters(Object customParameters)
Establece los parámetros personalizados de la palabra clave. Use este método si la dirección URL final o la plantilla de seguimiento incluyen cadenas de sustitución personalizadas.
Para usar un nombre de parámetro de cliente en la dirección URL final o la plantilla de seguimiento, incluya el nombre entre llaves y anteponga un carácter de subrayado (_) al nombre. Por ejemplo, si el nombre del parámetro es foo, use {_foo} en la plantilla de seguimiento o la dirección URL final. No agregue un carácter de subrayado 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 , pase un objeto vacío (por ejemplo, setCustomParameters({})). Si borra los parámetros personalizados de la palabra clave, la palabra clave hereda las direcciones URL de su grupo de anuncios primario (si el grupo de anuncios especifica direcciones URL). Para borrar completamente los parámetros personalizados, borrelos 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, vea Parámetros personalizados.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| customParameters | Objeto | Mapa de hasta tres parámetros personalizados para usar en la palabra clave . Por ejemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, donde key es el nombre del parámetro personalizado y value es el valor del parámetro. El nombre del parámetro solo puede contener caracteres alfanuméricos y el valor del parámetro puede no contener espacio 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 | Descripción |
|---|---|
| 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 lleva al usuario cuando hace clic en el anuncio. Si no se especifica, la entidad hereda la dirección URL final de su entidad primaria. Por ejemplo, la entidad de palabra clave hereda la dirección URL final del anuncio. Especifique la dirección URL final de la palabra clave para invalidar la dirección URL final del anuncio.
Para obtener más información, consulte ¿Qué parámetros de seguimiento o dirección URL puedo usar?
Si el valor de la propiedad no es válido, se produce un error en la llamada silenciosa. Para confirmar si la propiedad se actualizó realmente, vuelva a obtener el objeto y pruebe si el valor de la propiedad es igual al nuevo valor. Para obtener información, consulte Control de errores y advertencias.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| finalUrl | string | Dirección URL final de la palabra clave. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| 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 lleva al usuario cuando hace clic en el anuncio. Si no se especifica, la entidad hereda la dirección URL final de su entidad primaria. Por ejemplo, la entidad de palabra clave hereda la dirección URL final del anuncio. Especifique la dirección URL final de la palabra clave para invalidar la dirección URL final del anuncio.
Para obtener más información, consulte ¿Qué parámetros de seguimiento o dirección URL puedo usar?
Para especificar una dirección URL final para dispositivos móviles, especifique primero una dirección URL final para dispositivos que no sean móviles (consulte setFinalUrl()).
Si el valor de la propiedad no es válido, se produce un error en la llamada silenciosa. Para confirmar si la propiedad se actualizó realmente, vuelva a obtener el objeto y pruebe si el valor de la propiedad es igual al nuevo valor. Para obtener información, consulte Control de errores y advertencias.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| finalUrl | string | Dispositivos móviles de la dirección URL final de la palabra clave. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| void | Devuelve el valor nothing. |
setTrackingTemplate(String trackingTemplate)
Establece la plantilla de seguimiento de la palabra clave.
Las plantillas de seguimiento se usan con finalUrl de la palabra clave para crear la dirección URL de destino usada por el anuncio. Para obtener más información, consulte ¿Qué parámetros de seguimiento o dirección URL puedo usar?
Si el valor de la propiedad no es válido, se produce un error en la llamada silenciosa. Para confirmar si la propiedad se actualizó realmente, vuelva a obtener el objeto y pruebe si el valor de la propiedad es igual al nuevo valor. Para obtener información, consulte Control de errores y advertencias.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| trackingTemplate | string | Plantilla de seguimiento de la palabra clave. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| void | Devuelve el valor nothing. |