Objeto de datos ResponsiveSearchAd: Administración de campañas

Artículo
12/21/2023

Un formato de anuncio con capacidad de respuesta para los anuncios de texto en la red de búsqueda.

Nota:

Los anuncios de búsqueda con capacidad de respuesta duplicados se permiten en el mismo grupo de anuncios.

Los anuncios de búsqueda con capacidad de respuesta le permiten establecer entre 3 y 15 titulares de anuncios únicos (también conocidos como "títulos") y entre 2 y 4 descripciones de anuncios en un único anuncio. Desde allí, Bing seleccionará la combinación de título y descripción más relevante para cada consulta determinada y el usuario de búsqueda correspondiente. Al permitir que Bing AI seleccione el título y la descripción más relevantes para cada consulta, nos aseguramos de que el mensaje adecuado llegue a cada uno de los clientes potenciales, en el momento adecuado, en todas las señales de intención posibles.

Los anuncios dinámicos que se muestran a los usuarios parecen idénticos a los anuncios de texto expandido, es decir, hasta 3 titulares (partes del título a través de anuncios de texto expandidos) y 2 descripciones (partes de texto a través de anuncios de texto expandidos). Para maximizar las impresiones en todos los formatos de anuncio, es posible que las descripciones no siempre se muestren en el anuncio.

Al crear anuncios de búsqueda con capacidad de respuesta, las listas Descripciones y Titulares se almacenan como recursos de texto que se pueden compartir con cualquier anuncio de búsqueda con capacidad de respuesta dentro de la cuenta. Por ejemplo, si "Integración directa" es un recurso de texto, observará que tiene el mismo identificador de recurso en todos los anuncios que se vinculan a "Integración directa" en la misma cuenta de Microsoft Advertising. Los identificadores de recursos no se incluyen en la respuesta AddAds o UpdateAds . Con el servicio Administración de campañas, la única manera de obtener los identificadores de recursos es recuperar los anuncios que ha creado. Puede obtener los identificadores de recursos de descripciones y titulares recuperando los anuncios en una llamada de servicio posterior, por ejemplo, a través de GetAdsByAdGroupId. Con el servicio bulk, los identificadores de recursos se incluyen en el archivo de resultados de carga masiva.

Nota:

Los anuncios de búsqueda con capacidad de respuesta solo se pueden crear en campañas de búsqueda donde AdGroupType está establecido en "SearchStandard". Si AdGroupType está establecido en "SearchDynamic", el grupo de anuncios no admite anuncios de búsqueda con capacidad de respuesta.

Sintaxis

<xs:complexType name="ResponsiveSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Domain" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

El objeto ResponsiveSearchAd tiene los siguientes elementos: Descriptions, Domain, Headlines, Path1, Path2.

Elemento	Descripción	Tipo de datos
Descripciones	Lista de descripciones que Bing puede usar para optimizar el diseño del anuncio. Para maximizar las impresiones en todos los formatos de anuncio, es posible que las descripciones no siempre se muestren en el anuncio. A menos que ancle una de las descripciones a una posición específica, Bing optimizará el diseño del anuncio dinámicamente con los mejores titulares y descripciones para la consulta de búsqueda del usuario. Desde la perspectiva de un modelo de datos, las desripciones y los titulares se almacenan como recursos de texto, es decir, un TextAsset por AssetLink. Varios anuncios pueden usar el mismo recurso. Por ejemplo, si "Integración directa" es un recurso de texto, tendrá el mismo identificador de recurso en todos los anuncios de la misma cuenta de Microsoft Advertising. Debe establecer entre 2 y 4 descripciones. El texto de cada descripción debe contener al menos una palabra. Para un uso eficaz de los recursos, se recomienda usar cadenas de texto dinámicas como {keyword} en lugar de crear una nueva copia de anuncios para cada 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. La longitud máxima de entrada del texto de cada descripción es de 1000 caracteres, incluidas las cadenas de texto dinámicas, y de esos 1000 no se permiten más de 90 caracteres finales después de la sustitución. El anuncio no se mostrará o se usará texto predeterminado si la longitud supera los 90 caracteres después de que se produzca la sustitución dinámica de texto. En el caso de los idiomas con caracteres de doble ancho, por ejemplo, el chino tradicional, la longitud máxima de entrada es de 500 caracteres, incluidas las cadenas de texto dinámicas, y de esos 500 no se permiten más de 45 caracteres finales después de la sustitución. El anuncio no se mostrará o se usará texto predeterminado si la longitud supera los 45 caracteres después de que se produzca la sustitución dinámica de texto. Los caracteres de doble ancho vienen determinados por los caracteres que se usan en lugar del conjunto de caracteres de la campaña o la configuración del idioma del grupo de anuncios. Los caracteres de doble ancho incluyen caracteres coreanos, japoneses y chinos, así como emojis. El texto no puede contener el carácter de nueva línea (\n). El texto puede contener funciones IF . Añadir: Obligatorio Actualizar: Opcional. Para conservar todos los vínculos de recursos existentes, establezca o deje este elemento nulo. Si estableces este elemento, se reemplazarán las descripciones que se vincularon anteriormente a este anuncio.	Matriz AssetLink
Dominio	Dirección URL que se mostrará en lugar de la dirección URL final. La dirección URL final se seguirá usando para la dirección URL de la página de aterrizaje. Reservado para uso piloto limitado, por ejemplo, clientes farmacéuticos. La parte de dominio de la dirección URL en combinación con las cadenas de ruta de acceso 1 y ruta de acceso 2 no puede superar los 67 caracteres. 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
Encabezados	Lista de títulos de anuncios que Bing puede usar para optimizar el diseño del anuncio. A menos que ancle uno de los titulares a una posición específica, Bing optimizará el diseño del anuncio dinámicamente con los mejores titulares y descripciones para la consulta de búsqueda del usuario. Desde la perspectiva de un modelo de datos, las desripciones y los titulares se almacenan como recursos de texto, es decir, un TextAsset por AssetLink. Varios anuncios pueden usar el mismo recurso. Por ejemplo, si "Integración directa" es un recurso de texto, tendrá el mismo identificador de recurso en todos los anuncios de la misma cuenta de Microsoft Advertising. Debe establecer entre 3 y 15 titulares. El texto de cada título debe contener al menos una palabra. Para un uso eficaz de los recursos, se recomienda usar cadenas de texto dinámicas como {keyword} en lugar de crear una nueva copia de anuncios para cada 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. La longitud máxima de entrada del texto de cada título es de 1000 caracteres, incluidas las cadenas de texto dinámicas, y de esos 1000 no se permiten más de 30 caracteres finales después de la sustitución. El anuncio no se mostrará o se usará texto predeterminado si la longitud supera los 30 caracteres después de que se produzca la sustitución dinámica de texto. En el caso de los idiomas con caracteres de doble ancho, por ejemplo, el chino tradicional, la longitud máxima de entrada es de 500 caracteres, incluidas las cadenas de texto dinámicas, y de esos 500 no se permiten más de 15 caracteres finales después de la sustitución. El anuncio no se mostrará o se usará texto predeterminado si la longitud supera los 15 caracteres después de que se produzca la sustitución dinámica de texto. Los caracteres de doble ancho vienen determinados por los caracteres que se usan en lugar del conjunto de caracteres de la campaña o la configuración del idioma del grupo de anuncios. Los caracteres de doble ancho incluyen caracteres coreanos, japoneses y chinos, así como emojis. El texto no puede contener el carácter de nueva línea (\n). El texto puede contener funciones IF . Añadir: Obligatorio Actualizar: Opcional. Para conservar todos los vínculos de recursos existentes, establezca o deje este elemento nulo. Si estableces este elemento, se reemplazarán los titulares que se vincularon anteriormente a este anuncio.	Matriz AssetLink
Ruta de acceso1	La primera parte de la ruta de acceso opcional que se anexará a la parte del dominio de la dirección URL para mostrar. La parte del dominio de la dirección URL de presentación, por ejemplo, https://www.contoso.com se generará a partir del dominio de la dirección URL final (elemento FinalUrls ). A continuación, si ha especificado un valor para Path1 , se anexará a la dirección URL para mostrar. Si también ha especificado un valor para Path2, también se anexará a la dirección URL para mostrar después de Path1. Por ejemplo, si FinalUrls contiene https://www.contoso.com, Path1 se establece en subdirectory1 y Path2 se establece en subdirectorio2, la dirección URL mostrada será https://www.contoso.com/subdirectory1/subdirectory2. La ruta de acceso puede contener parámetros dinámicos como {MatchType}. Para obtener una lista de los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?. La longitud máxima de entrada es de 1000 caracteres si se incluyen cadenas de texto dinámicas. No se pueden introducir más de 15 caracteres finales (no texto dinámico). El anuncio no se mostrará o se usará el texto predeterminado si la longitud del dominio de dirección URL final y las rutas de acceso combinadas superan los 67 caracteres. En el caso de los idiomas con caracteres de ancho doble, por ejemplo, el chino tradicional, la longitud máxima de entrada es de 1000 caracteres si se incluyen cadenas de texto dinámicas. No se pueden introducir más de 7 caracteres finales (no de texto dinámico). El anuncio no se mostrará o se usará el texto predeterminado si la longitud del dominio de dirección URL final y las rutas de acceso combinadas superan los 33 caracteres. Los caracteres de doble ancho vienen determinados por los caracteres que se usan en lugar del conjunto de caracteres de la campaña o la configuración del idioma del grupo de anuncios. Los caracteres de doble ancho incluyen caracteres coreanos, japoneses y chinos, así como emojis. La ruta de acceso no puede contener los caracteres de barra diagonal (/) o nueva línea (\n). Si la ruta de acceso incluye un espacio, se reemplazará por un carácter de subrayado (_) cuando se muestre el anuncio. La ruta de acceso puede contener funciones IF . 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
Ruta de acceso 2	La segunda parte de la ruta de acceso opcional que se anexará a la parte del dominio de la dirección URL de presentación. La parte del dominio de la dirección URL de presentación, por ejemplo, https://www.contoso.com se generará a partir del dominio de la dirección URL final (elemento FinalUrls ). A continuación, si ha especificado un valor para Path1 , se anexará a la dirección URL para mostrar. Si también ha especificado un valor para Path2, también se anexará a la dirección URL para mostrar después de Path1. Por ejemplo, si FinalUrls contiene https://www.contoso.com, Path1 se establece en subdirectory1 y Path2 se establece en subdirectorio2, la dirección URL mostrada será https://www.contoso.com/subdirectory1/subdirectory2. Solo puede especificar Path2 si path1 también está establecido. La ruta de acceso puede contener parámetros dinámicos como {MatchType}. Para obtener una lista de los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?. La longitud máxima de entrada es de 1000 caracteres si se incluyen cadenas de texto dinámicas. No se pueden introducir más de 15 caracteres finales (no texto dinámico). El anuncio no se mostrará o se usará el texto predeterminado si la longitud del dominio de dirección URL final y las rutas de acceso combinadas superan los 67 caracteres. En el caso de los idiomas con caracteres de ancho doble, por ejemplo, el chino tradicional, la longitud máxima de entrada es de 1000 caracteres si se incluyen cadenas de texto dinámicas. No se pueden introducir más de 7 caracteres finales (no de texto dinámico). El anuncio no se mostrará o se usará el texto predeterminado si la longitud del dominio de dirección URL final y las rutas de acceso combinadas superan los 33 caracteres. Los caracteres de doble ancho vienen determinados por los caracteres que se usan en lugar del conjunto de caracteres de la campaña o la configuración del idioma del grupo de anuncios. Los caracteres de doble ancho incluyen caracteres coreanos, japoneses y chinos, así como emojis. La ruta de acceso no puede contener los caracteres de barra diagonal (/) o nueva línea (\n). Si la ruta de acceso incluye un espacio, se reemplazará por un carácter de subrayado (_) cuando se muestre el anuncio. La ruta de acceso puede contener funciones IF . 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

El objeto ResponsiveSearchAd tiene elementos heredados.

Elementos heredados

Elementos heredados de Ad

El objeto ResponsiveSearchAd deriva del objeto Ad y hereda los siguientes elementos: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Las descripciones siguientes son específicas de ResponsiveSearchAd y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto Ad .

Elemento	Descripción	Tipo de datos
AdFormatPreference	No se admite para este tipo de anuncio.	string
DevicePreference	No se admite para este tipo de anuncio.	Largo
EditorialStatus	El estado de revisión editorial del anuncio, que indica si el anuncio está pendiente de revisión, se ha aprobado o se ha desaprobado. Añadir: Solo lectura Actualizar: Solo lectura	AdEditorialStatus
FinalAppUrls	No se admite para este tipo de anuncio.	Matriz AppUrl
FinalMobileUrls	Dirección URL de la página de aterrizaje móvil. 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. Esta dirección URL solo se usa si la palabra clave no especifica una dirección URL móvil final. Añadir: Opcional Actualizar: Opcional	matriz de cadenas
FinalUrls	Dirección URL de la página de aterrizaje. La parte de dominio de la dirección URL en combinación con las cadenas de ruta de acceso 1 y ruta de acceso 2 no puede superar los 67 caracteres. 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 establece el elemento TrackingUrlTemplate o UrlCustomParameters de este anuncio, se requiere al menos una dirección URL final. Esta dirección URL solo se usa si la palabra clave no especifica una dirección URL final. Añadir: Obligatorio Actualizar: Opcional	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 único de Microsoft Advertising del anuncio. Añadir: Solo lectura Actualizar: Obligatorio y Read-Only	Largo
Estado	Estado del anuncio. Puedes establecer el estado del anuncio en Activo o En pausa. Añadir: Opcional Actualizar: Opcional	AdStatus
TrackingUrlTemplate	Plantilla de seguimiento que se usará como valor predeterminado para todas las direcciones URL de página de aterrizaje. 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
Tipo	Tipo del anuncio. Este valor es ResponsiveSearch cuando se recupera un anuncio de búsqueda con capacidad de respuesta. Para obtener más información sobre los tipos de anuncios, consulte comentarios sobre los objetos de datos de anuncios. Añadir: Solo lectura Actualizar: Solo lectura	AdType
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