Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Contiene los métodos para administrar una palabra clave. Para obtener información sobre las palabras clave, consulte Palabra clave.
Métodos
| Nombre del método | Tipo de valor devuelto | Description |
|---|---|---|
| adParams | AdParamSelector | Obtiene un selector que se usa para obtener todos los parámetros de sustitución usados en el anuncio para esta palabra clave. |
| applyLabel(string name) | void | Aplica la etiqueta a esta palabra clave. |
| Pujas | KeywordBidding | Obtiene los métodos usados para administrar el importe de la puja de esta palabra clave. |
| clearDestinationUrl | void | Quita la dirección URL de destino de esta palabra clave. |
| habilitar | void | Habilita esta palabra clave. |
| getAdGroup | Grupo de anuncios | Obtiene el grupo de anuncios al que pertenece esta palabra clave. |
| getApprovalStatus | string | Obtiene el estado de aprobación editorial de esta palabra clave. |
| getCampaign | Campaña | Obtiene la campaña a la que pertenece esta palabra clave. |
| getEntityType | string | Obtiene el tipo de esta entidad. |
| getFirstPageCpc | double | Obtiene la puja estimada necesaria para estar en la primera página de los resultados de búsqueda. |
| getId | string | Obtiene el identificador que identifica de forma única esta palabra clave. |
| getMatchType | string | Obtiene el tipo de coincidencia de esta palabra clave. |
| getQualityScore | integer | Obtiene la puntuación de calidad de esta palabra clave. |
| getStats | Estadísticas | Obtiene los datos de rendimiento de esta palabra clave. |
| getText | string | Obtiene el texto de la palabra clave. |
| getTopOfPageCpc | double | Obtiene la puja estimada necesaria para estar en la parte superior de los resultados de búsqueda. |
| isEnabled | Booleano | Obtiene un valor booleano que indica si esta palabra clave está habilitada. |
| isPaused | Booleano | Obtiene un valor booleano que indica si esta palabra clave está en pausa. |
| Etiquetas | LabelSelector | Obtiene un selector que se usa para filtrar la lista de etiquetas asociadas a esta palabra clave. |
| pausar | void | Pausa esta palabra clave. |
| remove | void | Quita esta palabra clave. |
| removeLabel(nombre de la cadena) | void | Quita la etiqueta de esta palabra clave. |
| setAdParam(int index, string insertionText) | void | Agrega el parámetro de sustitución y establece su valor en el texto especificado. |
| Direcciones URL | KeywordUrls | Obtiene los métodos usados para administrar las URL finales, la plantilla de seguimiento y los parámetros personalizados de estas palabras clave. |
adParams
Obtiene un selector de todos los parámetros de sustitución usados en los anuncios para esta palabra clave.
Los valores de sustitución se usan en un anuncio si el título, el texto, la dirección URL para mostrar o la dirección URL de destino del anuncio contienen la cadena de sustitución dinámica {Param1}, {Param2} o {Param3}.
Valores devueltos
| Tipo | Description |
|---|---|
| AdParamSelector | El selector que contiene la lista de parámetros de sustitución de esta palabra clave. |
applyLabel(string name)
Aplica la etiqueta a la palabra clave.
Puedes aplicar un máximo de 50 etiquetas a una palabra clave. Para ver un ejemplo en el que se agrega una etiqueta a una palabra clave, consulte Uso de etiquetas.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| name | string | El nombre de la etiqueta que distingue mayúsculas de minúsculas. Para obtener una lista de etiquetas en esta cuenta que puede aplicar, consulte AdsApp.labels. |
Valores devueltos
| Tipo | Description |
|---|---|
| void | Devuelve el valor nothing. |
Pujas
Obtiene los métodos usados para administrar el importe de la puja de esta palabra clave.
Valores devueltos
| Tipo | Description |
|---|---|
| KeywordBidding | Contiene los métodos usados para administrar el importe de la puja de esta palabra clave. |
clearDestinationUrl
Quita la dirección URL de destino de esta palabra clave.
Valores devueltos
| Tipo | Description |
|---|---|
| void | Devuelve el valor nothing. |
habilitar
Habilita esta palabra clave.
Valores devueltos
| Tipo | Description |
|---|---|
| void | Devuelve el valor nothing. |
getAdGroup
Obtiene el grupo de anuncios al que pertenece esta palabra clave.
Valores devueltos
| Tipo | Description |
|---|---|
| Grupo de anuncios | El grupo de anuncios al que pertenece esta palabra clave. |
getApprovalStatus
Obtiene el estado de aprobación editorial de esta palabra clave.
Valores devueltos
| Tipo | Descripción |
|---|---|
| string | El estado de aprobación editorial de la palabra clave. El estado indica si la palabra clave está en revisión, está aprobada o no está permitida. Los posibles valores son:
|
getCampaign
Obtiene la campaña a la que pertenece esta palabra clave.
Valores devueltos
| Tipo | Description |
|---|---|
| Campaña | La campaña a la que pertenece esta palabra clave. |
getEntityType
Devuelve el tipo de esta entidad.
Valores devueltos
| Tipo | Descripción |
|---|---|
| string | El tipo de esta entidad, que es Keyword. |
getId
Obtiene el identificador que identifica de forma única esta palabra clave.
Valores devueltos
| Tipo | Descripción |
|---|---|
| string | El id. que identifica de forma única esta palabra clave. |
getFirstPageCpc
Obtiene la puja estimada necesaria para que el anuncio aparezca en la barra lateral.
Valores devueltos
| Tipo | Description |
|---|---|
| double | La puja estimada necesaria para que el anuncio aparezca en la barra lateral. |
getMatchType
Obtiene el tipo de coincidencia de esta palabra clave.
Valores devueltos
| Tipo | Descripción |
|---|---|
| string | El tipo de coincidencia de la palabra clave. Los posibles valores son:
|
getQualityScore
Obtiene la puntuación de calidad de esta palabra clave.
Valores devueltos
| Tipo | Description |
|---|---|
| integer | La puntuación de calidad de la palabra clave. La puntuación está en el intervalo del 1 al 10 (la más alta). Si no se puede calcular la puntuación de calidad de la palabra clave, este método devuelve NULL. La puntuación muestra el grado de competitividad de sus anuncios en el mercado midiendo la relevancia de las palabras clave y las páginas de destino para los términos de búsqueda de los clientes. Para obtener más información, consulte Informe de rendimiento de palabras clave. |
getStats
Obtiene los datos de rendimiento de estas palabras clave.
Para llamar a este método, debe incluir uno de los métodos en la forDateRange cadena del selector de palabras clave .
Valores devueltos
| Tipo | Description |
|---|---|
| Estadísticas | Datos de rendimiento de la palabra clave. Por ejemplo, los clics y las impresiones. |
getText
Obtiene el texto de la palabra clave. El texto incluye la sintaxis del tipo de coincidencia de la palabra clave, si la hay. Por ejemplo:
- La palabra clave es libros si el tipo de coincidencia es amplio o +libros si la palabra clave usa el modificador de tipo general
- La palabra clave es "libros" si el tipo de coincidencia es phrase
- La palabra clave es [libros de tapa dura] si el tipo de coincidencia es exacto
Para obtener información sobre estos tipos, vea ¿Qué son los tipos de coincidencia de palabra clave y cómo se usan?
Valores devueltos
| Tipo | Descripción |
|---|---|
| string | El texto de la palabra clave. |
getTopOfPageCpc
Obtiene la puja estimada necesaria para que el anuncio aparezca por encima de los resultados de búsqueda orgánicos.
Valores devueltos
| Tipo | Description |
|---|---|
| double | La puja estimada necesaria para que el anuncio aparezca por encima de los resultados de búsqueda orgánicos. |
isEnabled
Obtiene un valor booleano que indica si esta palabra clave está habilitada.
Valores devueltos
| Tipo | Descripción |
|---|---|
| Booleano | Es verdadero si esta palabra clave está habilitada; de lo contrario, false. |
isPaused
Obtiene un valor booleano que indica si esta palabra clave está en pausa.
Valores devueltos
| Tipo | Descripción |
|---|---|
| Booleano | Es verdadero si esta palabra clave está en pausa; de lo contrario, false. |
Etiquetas
Obtiene un selector que se usa para filtrar la lista de etiquetas asociadas a esta palabra clave.
Valores devueltos
| Tipo | Description |
|---|---|
| LabelSelector | Selector que se usa para filtrar la lista de etiquetas asociadas a esta palabra clave. |
pausar
Pausa esta palabra clave.
Valores devueltos
| Tipo | Description |
|---|---|
| void | Devuelve el valor nothing. |
quitar
Quita esta palabra clave.
Valores devueltos
| Tipo | Description |
|---|---|
| void | Devuelve el valor nothing. |
removeLabel(nombre de la cadena)
Quita la etiqueta de la palabra clave.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| name | string | El nombre de la etiqueta que distingue mayúsculas de minúsculas. Para obtener una lista de etiquetas asociadas a esta palabra clave, consulta Etiquetas. |
Valores devueltos
| Tipo | Description |
|---|---|
| void | Devuelve el valor nothing. |
setAdParam(int index, string insertionText)
Agrega el parámetro de sustitución y establece su valor en el texto especificado. Si el parámetro de sustitución existe, su texto se sobrescribe.
Los valores de sustitución se usan en un anuncio si el título, el texto, la URL para mostrar o la URL final del anuncio contienen las cadenas de sustitución dinámicas {Param1}, {Param2} o {Param3}. Para obtener restricciones e información sobre el uso de estos parámetros, vea Param1, Param2 y Param3.
Los valores de sustitución también se usan en la plantilla de seguimiento si esta especifica los marcadores de posición {param1:default}, {param2:default} o {param3:default}.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| index | Entero | El índice del parámetro de sustitución que se va a establecer. Los valores de índice válidos son del 1 al 3, ambos inclusive. Use 1 para Param1, 2 para Param2 y 3 para Param3. |
| insertionText | string | El texto para establecer el parámetro de sustitución. |
Valores devueltos
| Tipo | Description |
|---|---|
| void | Devuelve el valor nothing. |
urls
Obtiene los métodos usados para administrar las URL finales, la plantilla de seguimiento y los parámetros personalizados de estas palabras clave.
Valores devueltos
| Tipo | Description |
|---|---|
| KeywordUrls | Contiene los métodos utilizados: las URL finales, la plantilla de seguimiento y los parámetros personalizados de la palabra clave. |