Objeto de datos de palabras clave: administración de campañas

  • Artículo

Define una palabra clave.

Las palabras clave son las palabras o frases que se buscan al buscar un producto o servicio. Por ejemplo, las palabras clave podrían ser cualquiera de las siguientes:

  • Zapatos
  • Cruceros en barcos de vacaciones
  • Clases de tenis en Nueva York

Como se muestra anteriormente, una palabra clave puede ser solo una sola palabra, varias palabras o incluso una frase. En el contexto de la publicidad de búsqueda, todo esto simplemente se conoce como palabra clave.

Importante

A partir de abril de 2021, no se pueden establecer estrategias de puja para grupos de anuncios o palabras clave. Si intenta establecer estrategias de puja para grupos de anuncios o palabras clave, la solicitud se omitirá sin errores. Los grupos de anuncios y las palabras clave heredarán la estrategia de puja de su campaña.

Sintaxis

<xs:complexType name="Keyword" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Bid" nillable="true" type="tns:Bid" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:KeywordEditorialStatus" />
    <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
    <xs:element xmlns:q32="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q32:ArrayOfstring" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q33="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q33:ArrayOfstring" />
    <xs:element xmlns:q34="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q34:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MatchType" nillable="true" type="tns:MatchType" />
    <xs:element minOccurs="0" name="Param1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param3" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:KeywordStatus" />
    <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
  </xs:sequence>
</xs:complexType>

Elementos

El objeto Keyword tiene los siguientes elementos: Bid, BiddingScheme, DestinationUrl, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, MatchType, Param1, Param2, Param3, Status, Text, TrackingUrlTemplate, UrlCustomParameters.

Elemento Descripción Tipo de datos
Oferta La cantidad máxima que quieres pagar cada vez que alguien hace clic en tu anuncio.

Pujas contra otros anunciantes con la misma palabra clave, por lo que, en general, las pujas más altas ayudan a que el anuncio se muestre en ubicaciones más deseables en la página de resultados de búsqueda.

En lugar de usar la puja predeterminada de nivel de grupo de anuncios, puede establecer pujas personalizadas para cada palabra clave. Las pujas personalizadas para palabras clave invalidan la puja predeterminada del grupo de anuncios para esas palabras clave específicas. Con las pujas personalizadas, puede centrar su tiempo y dinero en las palabras clave más rentables, pero tendrá que dedicar más tiempo a administrar las pujas individuales.

Si no se establece la puja de nivel de palabra clave, se usa el cpcbid del grupo de anuncios. Para obtener más información, consulte Estrategias de presupuesto y pujas.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para eliminar la palabra clave bid y usar la puja de tipo de coincidencia predeterminada de AdGroup , establezca el elemento Amount del objeto Bid en null.		 Oferta
PujaScheme Tipo de estrategia de puja para cómo desea administrar las pujas.

Para obtener más información sobre las estrategias de puja admitidas por tipo de campaña, consulte Estrategias de presupuesto y puja.

NOTA: A partir de abril de 2021, no se pueden establecer estrategias de puja para grupos de anuncios o palabras clave. Si intenta establecer estrategias de puja para grupos de anuncios o palabras clave, la solicitud se omitirá sin errores. Los grupos de anuncios y las palabras clave heredarán la estrategia de puja de su campaña.

Añadir: Opcional. Si no establece este elemento, se usa InheritFromParentBiddingScheme de forma predeterminada.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 PujaScheme
DestinationUrl Dirección URL de la página web a la que se va a llevar al usuario al hacer clic en el anuncio. La dirección URL de destino de la palabra clave se usa si se especifica; De lo contrario, se usa la dirección URL de destino del anuncio.

Importante: A partir de noviembre de 2018, la dirección URL de destino de la palabra clave no se puede agregar ni actualizar. En su lugar, puede usar las direcciones URL finales . Para obtener más información, consulte Migración de las direcciones URL de destino de la palabra clave a direcciones URL finales.

Añadir: No permitido
Actualizar: No permitido		 string
EditorialStatus Estado de revisión editorial de la palabra clave, que indica si la palabra clave está pendiente de revisión, se ha aprobado o se ha desaprobado.

Añadir: Solo lectura
Actualizar: Solo lectura		 KeywordEditorialStatus
FinalAppUrls Reservado para uso futuro. Matriz AppUrl
FinalMobileUrls Dirección URL de la página de aterrizaje móvil. La dirección URL móvil final de la palabra clave se usa si se especifica; De lo contrario, se usa la dirección URL móvil final del anuncio.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 matriz de cadenas
FinalUrls Dirección URL de la página de aterrizaje. La dirección URL final de la palabra clave se usa si se especifica; De lo contrario, se usa la dirección URL final del anuncio.

Las siguientes reglas de validación se aplican a las direcciones URL finales y las direcciones URL de Final Mobile.
- La longitud de la dirección URL está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres.
- Puede especificar hasta 10 elementos para FinalUrls y FinalMobileUrls; sin embargo, solo se usa el primer elemento de cada lista para la entrega. El servicio permite hasta 10 para la posible compatibilidad con reenvíos.
- El uso de '{' y '}' solo puede delinear etiquetas, por ejemplo {lpurl}.
- Las direcciones URL finales deben ser una dirección URL bien formada a partir de http:// o https://.
- Si especifica FinalMobileUrls, también debe especificar FinalUrls.
- No puede especificar FinalMobileUrls si la preferencia de dispositivo está establecida en móvil. Tenga en cuenta también que si se establecen los elementos TrackingUrlTemplate o UrlCustomParameters , se requiere al menos una dirección URL final. Para obtener más información, consulte Seguimiento de direcciones URL con direcciones URL actualizadas.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 matriz de cadenas
FinalUrlSuffix El sufijo de dirección URL final puede incluir parámetros de seguimiento que se anexarán al final de la dirección URL de la página de aterrizaje. Se recomienda colocar los parámetros de seguimiento que requiere la página de aterrizaje en un sufijo de dirección URL final para que los clientes siempre se envíen a la página de aterrizaje. Para obtener más detalles y reglas de validación, consulte Sufijo de dirección URL final en las guías técnicas.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este elemento en una cadena vacía (""), se eliminará la configuración anterior.		 string
ForwardCompatibilityMap Lista de cadenas de clave y valor para la compatibilidad con reenvíos para evitar cambios importantes en caso contrario cuando se agregan nuevos elementos en la versión actual de la API.

Los cambios de compatibilidad de reenvío se anotarán aquí en futuras versiones. Actualmente no hay cambios de compatibilidad de reenvío para este objeto.		 Matriz KeyValuePairOfstringstring
Id Identificador generado por el sistema de la palabra clave .

Añadir: Solo lectura
Actualizar: Obligatorio		 Largo
MatchType Tipo de coincidencia para comparar la palabra clave y el término de búsqueda del usuario.

Añadir: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 MatchType
Param1 Cadena que se usará como valor de sustitución 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 contiene la cadena de sustitución dinámica {Param1}.

Aunque puede usar {Param1} para especificar la dirección URL de destino de un anuncio, se recomienda no hacerlo. En su lugar, debe establecer el elemento DestinationUrl de la palabra clave.

La cadena puede contener un máximo de 1022 caracteres. El límite real depende de la longitud del elemento que hace referencia a la cadena de sustitución. Por ejemplo, la longitud del título de un anuncio de texto puede contener un máximo de 25 caracteres.

Al implementar texto dinámico en la copia de anuncios, debe proporcionar una cadena predeterminada, por ejemplo, {Param1:default} que el sistema usará si Param1 para una palabra clave es null o está vacío, o si incluir el valor de sustitución de Param1 hará que la cadena expandida supere el límite del elemento; de lo contrario, el anuncio no servirá con esta palabra clave. Para obtener más información, consulte el artículo de ayuda de Microsoft Advertising Personalización automática de los anuncios con parámetros de texto dinámico.

Tenga en cuenta también que si el grupo de anuncios solo tiene un anuncio y si ese anuncio usa {Param1} pero no proporciona una cadena predeterminada, por ejemplo, {Param1:default}, debe proporcionar un valor para Param1 válido para esa sustitución. De lo contrario, esta palabra clave no se puede agregar ni actualizar.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este elemento en una cadena vacía (""), se eliminará la configuración anterior.		 string
Param2 Cadena que se usará como valor de sustitución en un anuncio si el título, texto, dirección URL de presentación o dirección URL de destino contiene la cadena de sustitución dinámica {Param2}.

Normalmente, se usa la cadena de sustitución {Param2} en los elementos de título o texto (descripción de copia de anuncios) de un anuncio.

La cadena puede contener un máximo de 70 caracteres. El límite real depende de la longitud del elemento que hace referencia a la cadena de sustitución. Por ejemplo, la longitud del título de un anuncio de texto puede contener un máximo de 25 caracteres.

Al implementar texto dinámico en la copia de anuncios, debe proporcionar una cadena predeterminada, por ejemplo, {Param2:default} que el sistema usará si Param2 para una palabra clave es null o está vacío, o si incluir el valor de sustitución de Param2 hará que la cadena expandida supere el límite del elemento; de lo contrario, el anuncio no servirá con esta palabra clave. Para obtener más información, consulte el artículo de ayuda de Microsoft Advertising Personalización automática de los anuncios con parámetros de texto dinámico.

Tenga en cuenta también que si el grupo de anuncios solo tiene un anuncio y si ese anuncio usa {Param2} pero no proporciona una cadena predeterminada, por ejemplo, {Param2:default}, debe proporcionar un valor para Param2 válido para esa sustitución. De lo contrario, esta palabra clave no se puede agregar ni actualizar.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este elemento en una cadena vacía (""), se eliminará la configuración anterior.		 string
Param3 Cadena que se usará como valor de sustitución en un anuncio si el título, el texto, la dirección URL de presentación o la dirección URL de destino contiene la cadena de sustitución dinámica {Param3}.

Normalmente, se usa la cadena de sustitución {Param3} en los elementos de título o texto (descripción de copia de anuncios) de un anuncio.

La cadena puede contener un máximo de 70 caracteres. El límite real depende de la longitud del elemento que hace referencia a la cadena de sustitución. Por ejemplo, la longitud del título de un anuncio de texto puede contener un máximo de 25 caracteres.

Al implementar texto dinámico en la copia de anuncios, debe proporcionar una cadena predeterminada, por ejemplo, {Param3:default} que el sistema usará si Param3 para una palabra clave es null o está vacío, o si incluir el valor de sustitución de Param3 hará que la cadena expandida supere el límite del elemento; de lo contrario, el anuncio no servirá con esta palabra clave. Para obtener más información, consulte el artículo de ayuda de Microsoft Advertising Personalización automática de los anuncios con parámetros de texto dinámico.

Tenga en cuenta también que si el grupo de anuncios solo tiene un anuncio y si ese anuncio usa {Param3} pero no proporciona una cadena predeterminada, por ejemplo{ Param3:default}, debe proporcionar un valor para Param3 válido para esa sustitución. De lo contrario, esta palabra clave no se puede agregar ni actualizar.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este elemento en una cadena vacía (""), se eliminará la configuración anterior.		 string
Estado Estado de la palabra clave. De forma predeterminada, el estado se establece en Activo.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 KeywordStatus
Texto Texto de palabra clave. El texto puede contener un máximo de 100 caracteres. Debe especificar la palabra clave en la configuración regional del valor language que especificó para el grupo de anuncios al que pertenece la palabra clave.

Añadir: Obligatorio
Actualizar: Solo lectura		 string
TrackingUrlTemplate Plantilla de seguimiento que se va a usar como valor predeterminado para todos los FinalUrls y FinalMobileUrls.

Las siguientes reglas de validación se aplican a las plantillas de seguimiento. Para obtener más información sobre las plantillas y los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?
- Las plantillas de seguimiento definidas para entidades de nivel inferior, por ejemplo, los anuncios, reemplazan a las establecidas para entidades de nivel superior, por ejemplo, campaña. Para obtener más información, vea Límites de entidad.
- La longitud de la plantilla de seguimiento está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres.
- La plantilla de seguimiento debe ser una dirección URL bien formada que comience por una de las siguientes: http://, https://, {lpurl}o {unescapedlpurl}.
- Microsoft Advertising no valida si existen parámetros personalizados. Si usa parámetros personalizados en la plantilla de seguimiento y no existen, la dirección URL de la página de aterrizaje incluirá los marcadores de posición de clave y valor de los parámetros personalizados sin sustitución. Por ejemplo, si la plantilla de seguimiento es https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} y no se definen {_season} ni {_promocode} en el nivel de campaña, grupo de anuncios, criterio, palabra clave o anuncio, la dirección URL de la página de aterrizaje será la misma.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este elemento en una cadena vacía (""), se eliminará la configuración anterior.		 string
UrlCustomParameters Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL.

Microsoft Advertising aceptará los 8 primeros objetos CustomParameter que incluya en el objeto CustomParameters y, si incluye más de 8 parámetros personalizados, se devolverá un error. Cada CustomParameter incluye elementos Key y Value .

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Establezca el elemento UrlCustomParameters en null o vacío para conservar los parámetros personalizados existentes. Para quitar todos los parámetros personalizados, establezca el elemento Parameters del objeto CustomParameters en null o vacío. Para quitar un subconjunto de parámetros personalizados, especifique los parámetros personalizados que desea conservar en el elemento Parameters del objeto CustomParameters .		 CustomParameters

Requisitos

Servicio: CampaignManagementService.svc v13
Nombres: https://bingads.microsoft.com/CampaignManagement/v13

Usado por

AddKeywords
GetKeywordsByAdGroupId
GetKeywordsByEditorialStatus
GetKeywordsByIds
UpdateKeywords