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

Artículo
11/13/2024

Un formato de anuncio con capacidad de respuesta para anuncios de audiencia y anuncios multimedia.

El objeto ResponsiveAd se usa para anuncios multimedia en la red de búsqueda y anuncios de audiencia en Microsoft Audience Network. Consulte la sección de comentarios a continuación para obtener más información sobre los diferenciadores clave.

Nota:

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

<xs:complexType name="ResponsiveAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="AdSubType" nillable="true" type="tns:AdSubType">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
        <xs:element minOccurs="0" name="CallToActionLanguage" nillable="true" type="tns:LanguageName" />
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Headline" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImpressionTrackingUrls" nillable="true" type="q4:ArrayOfstring">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="LongHeadline" nillable="true" type="tns:AssetLink" />
        <xs:element minOccurs="0" name="LongHeadlineString" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="VerifiedTrackingSettings" nillable="true" type="tns:VerifiedTrackingSetting">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Videos" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AdFormatPreference": "ValueHere",
  "DevicePreference": "LongValueHere",
  "EditorialStatus": "ValueHere",
  "FinalAppUrls": [
    {
      "OsType": "ValueHere",
      "Url": "ValueHere"
    }
  ],
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "Type": "ResponsiveAd",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  },
  "AdSubType": "ValueHere",
  "BusinessName": "ValueHere",
  "CallToAction": "ValueHere",
  "CallToActionLanguage": "ValueHere",
  "Descriptions": [
    {
      "Asset": {
        "Id": "LongValueHere",
        "Name": "ValueHere",
        "Type": "ImageAsset",
        "CropHeight": IntValueHere,
        "CropWidth": IntValueHere,
        "CropX": IntValueHere,
        "CropY": IntValueHere,
        "SubType": "ValueHere",
        "TargetHeight": IntValueHere,
        "TargetWidth": IntValueHere
      },
      "AssetPerformanceLabel": "ValueHere",
      "EditorialStatus": "ValueHere",
      "PinnedField": "ValueHere"
    }
  ],
  "Headline": "ValueHere",
  "Headlines": [
    {
      "Asset": {
        "Id": "LongValueHere",
        "Name": "ValueHere",
        "Type": "ImageAsset",
        "CropHeight": IntValueHere,
        "CropWidth": IntValueHere,
        "CropX": IntValueHere,
        "CropY": IntValueHere,
        "SubType": "ValueHere",
        "TargetHeight": IntValueHere,
        "TargetWidth": IntValueHere
      },
      "AssetPerformanceLabel": "ValueHere",
      "EditorialStatus": "ValueHere",
      "PinnedField": "ValueHere"
    }
  ],
  "Images": [
    {
      "Asset": {
        "Id": "LongValueHere",
        "Name": "ValueHere",
        "Type": "ImageAsset",
        "CropHeight": IntValueHere,
        "CropWidth": IntValueHere,
        "CropX": IntValueHere,
        "CropY": IntValueHere,
        "SubType": "ValueHere",
        "TargetHeight": IntValueHere,
        "TargetWidth": IntValueHere
      },
      "AssetPerformanceLabel": "ValueHere",
      "EditorialStatus": "ValueHere",
      "PinnedField": "ValueHere"
    }
  ],
  "ImpressionTrackingUrls": [
    "ValueHere"
  ],
  "LongHeadline": {
    "Asset": {
      "Id": "LongValueHere",
      "Name": "ValueHere",
      "Type": "ImageAsset",
      "CropHeight": IntValueHere,
      "CropWidth": IntValueHere,
      "CropX": IntValueHere,
      "CropY": IntValueHere,
      "SubType": "ValueHere",
      "TargetHeight": IntValueHere,
      "TargetWidth": IntValueHere
    },
    "AssetPerformanceLabel": "ValueHere",
    "EditorialStatus": "ValueHere",
    "PinnedField": "ValueHere"
  },
  "LongHeadlines": [
    {
      "Asset": {
        "Id": "LongValueHere",
        "Name": "ValueHere",
        "Type": "ImageAsset",
        "CropHeight": IntValueHere,
        "CropWidth": IntValueHere,
        "CropX": IntValueHere,
        "CropY": IntValueHere,
        "SubType": "ValueHere",
        "TargetHeight": IntValueHere,
        "TargetWidth": IntValueHere
      },
      "AssetPerformanceLabel": "ValueHere",
      "EditorialStatus": "ValueHere",
      "PinnedField": "ValueHere"
    }
  ],
  "LongHeadlineString": "ValueHere",
  "Text": "ValueHere",
  "VerifiedTrackingSettings": {
    "Details": [
      {
        "key": "ValueHere",
        "value": "ValueHere"
      }
    ]
  },
  "Videos": [
    {
      "Asset": {
        "Id": "LongValueHere",
        "Name": "ValueHere",
        "Type": "ImageAsset",
        "CropHeight": IntValueHere,
        "CropWidth": IntValueHere,
        "CropX": IntValueHere,
        "CropY": IntValueHere,
        "SubType": "ValueHere",
        "TargetHeight": IntValueHere,
        "TargetWidth": IntValueHere
      },
      "AssetPerformanceLabel": "ValueHere",
      "EditorialStatus": "ValueHere",
      "PinnedField": "ValueHere"
    }
  ]
}

Elementos

El objeto ResponsiveAd tiene los siguientes elementos: AdSubType, BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headline, Headlines, Images, ImpressionTrackingUrls, LongHeadline, LongHeadlines, LongHeadlineString, Text, VerifiedTrackingSettings, Videos.

Elemento	Descripción	Tipo de datos
AdSubType	Los posibles subtipos de anuncios.	AdSubType
BusinessName	Nombre de la empresa. El nombre de tu empresa puede aparecer en tu anuncio, en función de la ubicación del anuncio. La longitud de la cadena está limitada a 25 caracteres. Agregar: Obligatorio Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	string
CallToAction	Una breve y contundente razón para que los clientes haga clic en su anuncio en este momento. Esto se muestra en el botón llamada a la acción. Agregar: No aplicable a los anuncios de audiencia; Obligatorio para los anuncios multimedia Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	CallToAction
CallToActionLanguage	Idioma en el que se atenderá la llamada a la acción. La llamada a la acción siempre se atenderá en este idioma, independientemente de la configuración del idioma de la campaña. Agregar: No aplicable a los anuncios de audiencia; Obligatorio para los anuncios multimedia Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	LanguageName
Descripciones	Las descripciones que se muestran debajo de la ruta de acceso del anuncio. Para maximizar las impresiones en todos los formatos de anuncio, es posible que las descripciones no siempre se muestren en el 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 1 y 5 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). Agregar: Necesario para anuncios multimedia y anuncios de audiencia. No se aplica a los anuncios de vídeo. 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
Titular	Los titulares son el texto más destacado que aparece en tu anuncio, por lo que deberías sacar el máximo partido a los caracteres disponibles. Necesitamos varios titulares para que el anuncio pueda mostrarse de forma flexible en una variedad de publicadores y ubicaciones. La longitud de la cadena está limitada a 30 caracteres. Agregar: Necesario para los anuncios de vídeo. No es aplicable para anuncios multimedia y anuncios de audiencia. Actualizar: Opcional. En desuso para los anuncios multimedia y de audiencia. En su lugar, use Titulares.	string
Encabezados	Los titulares son el texto más destacado que aparece en tu anuncio, por lo que deberías sacar el máximo partido a los caracteres disponibles. Necesitamos varios titulares para que el anuncio pueda mostrarse de forma flexible en una variedad de publicadores y ubicaciones. 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 1 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). Agregar: Necesario para anuncios multimedia y anuncios de audiencia. No se aplica a los anuncios de vídeo. 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
Imágenes	Recursos de imagen con diferentes tamaños y proporciones de aspecto para que puedan mostrarse de forma flexible en una variedad de publicadores y ubicaciones. Incluya uno o varios objetos AssetLink que contengan un ImageAsset con subtipo y opciones de recorte que coincidan con la relación de aspecto deseada. Para obtener más información, consulte los comentarios siguientes. Agregar: Obligatorio Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si incluye imágenes durante la actualización, se reemplazarán las imágenes establecidas anteriormente.	Matriz AssetLink
ImpressionTrackingUrls	Direcciones URL para píxeles de seguimiento de impresiones de 1x1. Cada píxel notificará las impresiones de Microsoft Audience Network a la herramienta de informes de anuncios de terceros. Puede incluir hasta 2 direcciones URL de seguimiento de impresiones para cada anuncio con capacidad de respuesta. Cada dirección URL debe ser accesible. 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. Para cada impresión de Microsoft Audience Network, Microsoft hará ping a la dirección URL para habilitar el seguimiento de impresiones en la herramienta de informes de anuncios de terceros. No se admite el seguimiento de usuarios de nivel avanzado, como el seguimiento de conversiones o el seguimiento basado en cookies o direcciones IP. Este elemento no se devuelve de forma predeterminada. Para obtener este elemento, incluya el valor ImpressionTrackingUrls en el elemento ReturnAdditionalFields cuando llame a las operaciones de servicio GetAdsByAdGroupId, GetAdsByEditorialStatus y GetAdsByIds . Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para quitar las direcciones URL de seguimiento de impresiones, establezca este elemento en una matriz de cadenas vacía.	matriz de cadenas
LongHeadline	En el caso de las campañas de audiencia, LongHeadline es el más largo de los dos posibles titulares de anuncios con capacidad de respuesta.	AssetLink
LongHeadlines	Debe establecer entre 1 y 5 titulares largos. El texto de cada título debe contener al menos una palabra. El texto no puede contener el carácter de nueva línea (\n). Si la campaña primaria se asocia a una tienda y especifica LongHeadlines, también debe especificar Titulares, descripciones e imágenes. Agregar: opcional si la campaña primaria se asocia a un almacén, necesario si su campaña primaria no se asocia a un almacén. Usará LongHeadlineString si está vacío. Actualización: opcional. Para conservar todos los vínculos de recursos existentes, establezca o deje este elemento nulo. Si establece un valor para este elemento, se reemplazarán los titulares que se vincularon anteriormente a este grupo de recursos. Si la campaña primaria se asocia a un almacén y establece este elemento en una lista vacía, se eliminará la configuración anterior.	Matriz AssetLink
LongHeadlineString	Los titulares son el texto más destacado que aparece en tu anuncio, por lo que deberías sacar el máximo partido a los caracteres disponibles. Necesitamos varios titulares para que el anuncio pueda mostrarse de forma flexible en una variedad de publicadores y ubicaciones. La longitud de la cadena está limitada a 90 caracteres. Agregar: Opcional. Se omite cuando se proporciona LongHeadlines . Rellenaremos LongHeadlines con LongHeadlineString si LongHeadlines está vacío. No se aplica a los anuncios multimedia. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	string
Mensaje de texto	Este texto aparecerá debajo o adyacente al título largo o corto del anuncio, dependiendo de la ubicación del anuncio. Tienes más espacio de caracteres con el que trabajar en el texto del anuncio que en el título. Por lo tanto, una vez que las imágenes y el titular tienen la atención de un cliente potencial, el texto del anuncio debe convencerle de que haga clic en él. ¿Qué diferencia su producto o servicio? El texto debe contener al menos una palabra. La longitud de la cadena está limitada a 90 caracteres. El texto no puede contener el carácter de nueva línea (\n). Agregar: Necesario para los anuncios de vídeo. No es aplicable para anuncios multimedia y anuncios de audiencia. Actualizar: Opcional para anuncios de vídeo. Usa descripciones en su lugar para anuncios de audiencia o anuncios multimedia (en desuso).	string
VerifiedTrackingSettings	VerifiedTrackingSetting relaciona la configuración de medida de terceros. Esto le permite realizar un seguimiento de la visibilidad, la seguridad de la marca y las métricas de tráfico no válidas a través de un proveedor de verificación de terceros, como Integral Ad Science. Esta característica está disponible para anuncios nativos, de visualización y de vídeo en línea mediante la estrategia de pujas de CPM. Nota: Actualmente, IAS es el único proveedor admitido (vendorName), pero otros proveedores de verificación llegarán próximamente. El ejemplo siguiente pertenece a IAS. Hay 3 pares clave-valor para IAS: "vendorName" "advertiserEntityID" (id. de cliente para el proveedor de verificación) "publisherEntityID" (id. de informe para el proveedor de verificación) Ejemplo (necesario para IAS): vendorName: "IAS" advertiserEntityID: "12345678" publisherEntityID: "12345678"	VerifiedTrackingSetting
Vídeos	Recursos de vídeo con diferentes tamaños y proporciones de aspecto para que puedan mostrarse de forma flexible en una variedad de publicadores y ubicaciones. Incluya uno o varios objetos AssetLink que contengan un Objeto VideoAsset con un SubType. Agregar: Obligatorio para los anuncios de vídeo Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si incluye vídeos durante una actualización, se reemplazarán los vídeos establecidos anteriormente.	Matriz AssetLink

El objeto ResponsiveAd tiene elementos heredados.

Elementos heredados

Elementos heredados de Ad

El objeto ResponsiveAd 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 ResponsiveAd 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. Agregar: 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. Agregar: 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 lista vacía, se eliminará la configuración anterior.	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. Agregar: 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. Agregar: 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
Identificación	Identificador único de Microsoft Advertising del anuncio. Agregar: Solo lectura Actualizar: Obligatorio y Read-Only	largo
Estado	Estado del anuncio. Puedes establecer el estado del anuncio en Activo o En pausa. Agregar: 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. Agregar: 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 ResponsiveAd cuando se recupera un anuncio con capacidad de respuesta. Para obtener más información sobre los tipos de anuncios, consulte comentarios sobre los objetos de datos de anuncios. Agregar: 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 . Agregar: 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

Comentarios

El objeto ResponsiveAd se usa para los anuncios multimedia en la red de búsqueda y los anuncios de audiencia en Microsoft Audience Network.

La mayoría de las propiedades admitidas son las mismas, pero estas son algunas de las diferenciadoras clave.

En el caso de los anuncios de audiencia, establecerá BusinessName, Headlines, Images, ImpressionTrackingUrls, LongHeadlines y Descriptions.
En el caso de los anuncios multimedia, establecerá BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headlines, Images y LongHeadlines.

Nota:

Los datos de Images se aprovisionan mediante la operación AddMedia . Puede usar los tipos MIME GIF, JPEG o PNG. No se admiten imágenes con animación. Aunque solo puede agregar elementos multimedia con algunas relaciones de aspecto a través de la operación AddMedia , puede usar la configuración de recorte de ImageAsset para determinar la relación de aspecto efectiva en el contexto de cada assetlink de anuncio dinámico. La relación de aspecto de la imagen almacenada no se modificaría en la biblioteca multimedia de nivel de cuenta.

El tamaño máximo del archivo es de 5 MB. El ancho y alto máximos en píxeles son 2592 y 2048 de forma independiente, y debe mantener una de las relaciones de aspecto admitidas. Por ejemplo, si el recurso de imagen con subtipo LandscapeImageMedia tiene un ancho de 2592, el alto debe ser 1357.

Imágenes de anuncios multimedia

En el caso de los anuncios multimedia, creará varios recursos de imagen con diferentes tamaños y proporciones de aspecto. Debe agregar al menos 1 imagen con relación de aspecto 1.91:1 y 1 imagen con relación de aspecto 1:1.

En el elemento Images se incluyen uno o varios objetos AssetLink . Cada vínculo de recurso contiene un ImageAsset con SubType establecido en uno de los valores de cadena de la tabla siguiente.

Subtipo	Relación de aspecto	Dimensiones mínimas en píxeles
LandscapeImageMedia	1.91:1	703 ancho x 368 alto
ImageMedia4x1	4:1	608 ancho x 152 de alto
SquareImageMedia	1:1	470 ancho x 470 alto
ImageMedia1x2	1:2	470 ancho x 940 alto

Logotipos de anuncios multimedia

En el caso de los anuncios multimedia, crearás varios recursos de logotipo con diferentes tamaños, relaciones de aspecto y configuración de recorte para que puedan mostrarse de forma flexible en la lista de miniaturas.

El subtipo debe establecerse en "Logo" si la imagen está asociada a un anuncio como "LandscapeLogoMedia" o "SquareLogoMedia".

Subtipo	Relación de aspecto	Dimensiones mínimas en píxeles
LandscapeLogoMedia	4:1	512 ancho x 128 alto
SquareLogoMedia	1:1	128 ancho x 128 de alto

Imágenes de anuncios de audiencia

En el caso de los anuncios de audiencia, creará varios recursos de imagen con diferentes tamaños, relaciones de aspecto y configuración de recortes para que puedan mostrarse de forma flexible en una variedad de publicadores y ubicaciones.

En el elemento Images se incluyen uno o varios objetos AssetLink . Cada vínculo de recurso contiene un ImageAsset con SubType establecido en uno de los valores de cadena de la tabla siguiente.

Nota:

Los subtipos de imagen y en la tabla siguiente para anuncios de audiencia versión 2 y están actualmente en versión piloto.

Subtipo	Relación de aspecto	Dimensiones mínimas en píxeles
OriginalImage	N/D	703 ancho x 368 alto
LandscapeImageMedia	1.91:1	300 ancho x 157 de alto
SquareImageMedia	1:1	114 ancho x 114 alto
ImageMedia201X100	2.01:1	612 ancho x 304 de alto
ImageMedia120X100	1.2:1	300 ancho x 250 de alto
ImageMedia200X100	2:1	200 ancho x 100 alto
ImageMedia169X100	1.69:1	628 ancho x 372 de alto
ImageMedia124X100	1.24:1	104 ancho x 84 de alto
ImageMedia153X100	1.53:1	306 de ancho x 200 de alto

Nota:

Los subtipos de imagen de la tabla siguiente son para anuncios de audiencia versión 1.

Subtipo	Dimensiones mínimas en píxeles
LandscapeImageMedia	703 ancho x 368 alto Radio de aspecto 1.91:1
SquareImageMedia	300 ancho x 300 alto Radio de aspecto 1:1
ImageMedia169X100	622 ancho x 368 alto Radio de aspecto 1.69:1
ImageMedia93X100	311 ancho x 333 de alto Radio de aspecto 0.93:1
ImageMedia15X10	300 ancho x 200 alto Radio de aspecto 1.5:1
ImageMedia155X100	300 ancho x 194 de alto Radio de aspecto 1.55:1
ImageMedia133X100	100 ancho x 75 de alto Radio de aspecto 1.33:1
ImageMedia178X100	624 ancho x 350 alto Radio de aspecto 1.78:1
ImageMedia172X100	300 ancho x 174 de alto Radio de aspecto 1.72:1

Solo es necesario proporcionar un recurso de imagen OriginalImage predeterminado (la imagen predeterminada era anteriormente LandscapeImageMedia). En el elemento Images se incluye un AssetLink que contiene un Objeto ImageAsset con SubType establecido en OriginalImage. Las dimensiones recomendadas para OriginalImage son de 1200 ancho x 628 de alto. Opcionalmente, puede incluir vínculos de recursos adicionales, es decir, un recurso de imagen para cada subtipo admitido. Para los subtipos de recursos de imagen que no establezca explícitamente, Microsoft Advertising creará automáticamente vínculos de recursos de imagen recortando OriginalImage.

Dado el ejemplo de respuesta GetAdsByAdGroupId siguiente, tome nota de lo siguiente:

El mismo identificador de recurso de imagen (por ejemplo, 1234567890000) se usa para todos los subtipos de recursos de imagen generados automáticamente. Independientemente de si permite que Microsoft Advertising genere automáticamente las imágenes recortadas, el identificador no tiene que ser único entre los recursos de imagen vinculados al mismo anuncio.
Dado que el anuncio de este ejemplo se creó sin la configuración de recorte para el subtipo de recurso de imagen OriginalImage, se recortan todos los recursos de imagen excepto la imagen asociada a OriginalImage.
Microsoft Advertising usará la configuración de recorte de OriginalImage para todas las opciones de recorte predeterminadas. En este ejemplo, el alto de recorte de todos los recursos de imagen generados por el sistema es 628 y podemos deducir que OriginalImage (subtipo OriginalImage) con relación de aspecto 1.91:1 tiene un ancho y un alto de 1200x628. La configuración de recorte de los recursos de imagen generados automáticamente se basa en la configuración de recorte del vínculo del recurso OriginalImage.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Header>
		<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v12">3acf4989-d6a3-405f-9fd1-a2e8dd1b09f8</h:TrackingId>
	</s:Header>
	<s:Body>
		<GetAdsByAdGroupIdResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v12">
			<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
				<Ad i:type="ResponsiveAd">
					<AdFormatPreference i:nil="true"/>
					<DevicePreference>0</DevicePreference>
					<EditorialStatus>Inactive</EditorialStatus>
					<FinalAppUrls i:nil="true"/>
					<FinalMobileUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://mobile.contoso.com/womenshoesale</a:string>
					</FinalMobileUrls>
					<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://www.contoso.com/womenshoesale</a:string>
					</FinalUrls>
					<ForwardCompatibilityMap xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
					<Id>9876543210000</Id>
					<Status>Active</Status>
					<TrackingUrlTemplate i:nil="true"/>
					<Type>ResponsiveAd</Type>
					<UrlCustomParameters i:nil="true"/>
					<BusinessName>Contoso</BusinessName>
					<CallToAction>AddToCart</CallToAction>
					<Headline>Fast &amp; Easy Setup</Headline>
					<Images>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight i:nil="true"/>
								<CropWidth i:nil="true"/>
								<CropX i:nil="true"/>
								<CropY i:nil="true"/>
								<SubType>OriginalImage</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>628</CropWidth>
								<CropX>286</CropX>
								<CropY>0</CropY>
								<SubType>SquareImageMedia</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>942</CropWidth>
								<CropX>129</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia15X10</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>835</CropWidth>
								<CropX>183</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia133X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>1118</CropWidth>
								<CropX>41</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia178X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
					</Images>
					<LandscapeImageMediaId>1234567890000</LandscapeImageMediaId>
					<LandscapeLogoMediaId i:nil="true"/>
					<LongHeadline>Find New Customers &amp; Increase Sales!</LongHeadline>
					<SquareImageMediaId>1234567890000</SquareImageMediaId>
					<SquareLogoMediaId i:nil="true"/>
					<Text>Find New Customers &amp; Increase Sales! Start Advertising on Contoso Today.</Text>
				</Ad>
			</Ads>
		</GetAdsByAdGroupIdResponse>
	</s:Body>
</s:Envelope>

Requisitos

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

Usado por

CreateResponsiveAdRecommendation
RefineResponsiveAdRecommendation

Compartir a través de

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

Sintaxis

Elementos

Elementos heredados

Elementos heredados de Ad

Comentarios

Imágenes de anuncios multimedia

Logotipos de anuncios multimedia

Imágenes de anuncios de audiencia

Requisitos

Usado por

Comentarios

Recursos adicionales