Compartir a través de

Palabra clave

  • Artículo

Contiene los métodos para administrar una palabra clave. Para obtener información sobre las palabras clave, vea Keyword.

Métodos

Nombre del método Tipo de valor devuelto Descripción
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(nombre de cadena) void Aplica la etiqueta a esta palabra clave.
Licitación KeywordBidding Obtiene los métodos utilizados para administrar la cantidad de 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 Adgroup 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 la 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 usado para filtrar la lista de etiquetas asociadas a esta palabra clave.
Pausa void Pausa esta palabra clave.
remove void Quita esta palabra clave.
removeLabel(nombre de 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.
Url KeywordUrls Obtiene los métodos usados para administrar las direcciones URL finales de estas palabras clave, la plantilla de seguimiento y los parámetros personalizados.

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 de presentación o la dirección URL de destino del anuncio contienen la cadena de sustitución dinámica {Param1}, {Param2}o {Param3}.

Valores devueltos

Tipo Descripción
AdParamSelector Selector que contiene la lista de parámetros de sustitución para esta palabra clave.

applyLabel(nombre de cadena)

Aplica la etiqueta a la palabra clave .

Puede aplicar un máximo de 50 etiquetas a una palabra clave. Para obtener un ejemplo que agrega una etiqueta a una palabra clave, consulte Uso de etiquetas.

Argumentos

Nombre Tipo Descripción
name string Nombre que distingue mayúsculas de minúsculas de la etiqueta. Para obtener una lista de las etiquetas de esta cuenta que puedes aplicar, consulta AdsApp.labels.

Valores devueltos

Tipo Descripción
void Devuelve el valor nothing.

Licitación

Obtiene los métodos utilizados para administrar la cantidad de puja de esta palabra clave.

Valores devueltos

Tipo Descripción
KeywordBidding Contiene los métodos utilizados para administrar la cantidad de puja de esta palabra clave.

clearDestinationUrl

Quita la dirección URL de destino de esta palabra clave.

Valores devueltos

Tipo Descripción
void Devuelve el valor nothing.

habilitar

Habilita esta palabra clave.

Valores devueltos

Tipo Descripción
void Devuelve el valor nothing.

getAdGroup

Obtiene el grupo de anuncios al que pertenece esta palabra clave.

Valores devueltos

Tipo Descripción
Adgroup 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 Estado de aprobación editorial de la palabra clave. El estado indica si la palabra clave está en revisión, está aprobada o no. Los posibles valores son:
  • APROBADO
  • APPROVED_LIMITED
  • DESAPROBÓ
  • UNDER_REVIEW
Para obtener información sobre cómo se asignan estos valores de estado a Bing Ads API, consulte Asignación de valores de estado de aprobación editorial.

getCampaign

Obtiene la campaña a la que pertenece esta palabra clave.

Valores devueltos

Tipo Descripción
Campaña Campaña a la que pertenece esta palabra clave.

getEntityType

Devuelve el tipo de esta entidad.

Valores devueltos

Tipo Descripción
string 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 Identificador 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 Descripción
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 Tipo de coincidencia de la palabra clave. Los posibles valores son:
  • AMPLIO
  • PHRASE
  • EXACTA
Para obtener información sobre estos tipos, vea ¿Qué son los tipos de coincidencia de palabras clave y cómo los uso?

getQualityScore

Obtiene la puntuación de calidad de esta palabra clave.

Valores devueltos

Tipo Descripción
integer Puntuación de calidad de la palabra clave. La puntuación está en el intervalo de 1 a 10 (mayor). Si no se puede calcular la puntuación de calidad de la palabra clave, este método devuelve NULL.

La puntuación muestra la competitividad de los anuncios en Marketplace mediante la medición de la relevancia de las palabras clave y las páginas de aterrizaje en los términos de búsqueda de los clientes. Para obtener más información, vea Informe de rendimiento de palabras clave.

getStats

Obtiene estos datos de rendimiento de palabras clave.

Para llamar a este método, debe incluir uno de los forDateRange métodos en la cadena del selector de palabras clave .

Valores devueltos

Tipo Descripción
Estadísticas Datos de rendimiento de la palabra clave. Por ejemplo, clics e impresiones.

Gettext

Obtiene el texto de la palabra clave. El texto incluye la sintaxis del tipo de coincidencia de la palabra clave, si existe. Por ejemplo:

  • La palabra clave es books si el tipo de coincidencia es amplio o +books si la palabra clave usa el modificador de tipo amplio.
  • La palabra clave es "books" si el tipo de coincidencia es phrase
  • La palabra clave es [hardcover books] si el tipo de coincidencia es exacto

Para obtener información sobre estos tipos, vea ¿Qué son los tipos de coincidencia de palabras clave y cómo los uso?

Valores devueltos

Tipo Descripción
string 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 Descripción
double La oferta 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 true 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 true si esta palabra clave está en pausa; De lo contrario, false.

Etiquetas

Obtiene un selector usado para filtrar la lista de etiquetas asociadas a esta palabra clave.

Valores devueltos

Tipo Descripción
LabelSelector Selector que se usa para filtrar la lista de etiquetas asociadas a esta palabra clave.

Pausa

Pausa esta palabra clave.

Valores devueltos

Tipo Descripción
void Devuelve el valor nothing.

quite

Quita esta palabra clave.

Valores devueltos

Tipo Descripción
void Devuelve el valor nothing.

removeLabel(nombre de cadena)

Quita la etiqueta de la palabra clave .

Argumentos

Nombre Tipo Descripción
name string Nombre que distingue mayúsculas de minúsculas de la etiqueta. Para obtener una lista de etiquetas asociadas a esta palabra clave, consulte etiquetas.

Valores devueltos

Tipo Descripción
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, se sobrescribe el texto.

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 final del anuncio contienen las cadenas de sustitución dinámica {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 la plantilla especifica los marcadores de posición {param1:default}, {param2:default} o {param3:default}.

Argumentos

Nombre Tipo Descripción
index Entero Índice del parámetro de sustitución que se va a establecer. Los valores de índice válidos son de 1 a 3, ambos inclusive. Use 1 para Param1, 2 para Param2 y 3 para Param3.
insertionText string Texto en el que se va a establecer el parámetro de sustitución.

Valores devueltos

Tipo Descripción
void Devuelve el valor nothing.

urls

Obtiene los métodos usados para administrar las direcciones URL finales de estas palabras clave, la plantilla de seguimiento y los parámetros personalizados.

Valores devueltos

Tipo Descripción
KeywordUrls Contiene los métodos utilizados para las direcciones URL finales de la palabra clave, la plantilla de seguimiento y los parámetros personalizados.

Consulte también