Compartir a través de

Registro de extensión de anuncio de imagen: masiva

  • Artículo

Define una extensión de anuncio de imagen que se puede descargar y cargar en un archivo masivo.

Puede asociar una extensión de anuncio de imagen a la cuenta o a campañas y grupos de anuncios de la cuenta. Cada cuenta puede tener hasta 250 000 asociaciones de extensión de imagen de campaña y hasta 250 000 asociaciones de extensión de imagen de grupo de anuncios. Cada entidad (cuenta, campaña o grupo de anuncios) se puede asociar con hasta 25 extensiones de anuncio de imagen. Usa los registros Extensión de anuncio de imagen de cuenta, Extensión de anuncio de imagen de grupo de anuncios y Extensión de anuncio de imagen de campaña para administrar las asociaciones de extensiones de anuncios de imagen.

Puede descargar todos los registros de extensión de Image Ad de la cuenta incluyendo el valor DownloadEntity de ImageAdExtensions en la solicitud de servicio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Además, la solicitud de descarga debe incluir el ámbito EntityData . Para obtener más información sobre el servicio masivo, incluidos los procedimientos recomendados, consulte Descarga y carga masivas.

En el siguiente ejemplo de CSV masivo se agregaría una nueva extensión de anuncio de imagen a la biblioteca compartida de la cuenta.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Alternative Text,Media Ids,Final Url Suffix
Format Version,,,,,,,,,,,6.0,,,,,
Image Ad Extension,Active,-14,0,,,ClientIdGoesHere,,,,,,,FALSE,ImageAdExtension Alternative Text,ImageMediaIdHere,

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkImageAdExtension , en lugar de llamar a las operaciones del servicio directamente y escribir código personalizado para analizar cada campo en el archivo masivo.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkImageAdExtension
var bulkImageAdExtension = new BulkImageAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // ImageAdExtension object of the Campaign Management service.
    ImageAdExtension = new ImageAdExtension
    {
        // 'Alternative Text' column header in the Bulk file
        AlternativeText = "ImageAdExtension Alternative Text",
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Id' column header in the Bulk file
        Id = imageAdExtensionIdKey,
        // 'Media Ids' column header in the Bulk file
        ImageMediaIds = new long[] { ImageMediaIdHere },
        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkImageAdExtension);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Para un registro de extensión de anuncio de imagen , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

Programación de anuncios

La lista de intervalos de día y hora que quieres que la extensión del anuncio se muestre con tus anuncios. Cada día y intervalo de tiempo incluye el día programado de la semana, la hora de inicio/finalización y el minuto de inicio y finalización. Cada intervalo de día y hora se incluye entre paréntesis izquierdo y derecho, y se separa de otros intervalos de días y horas con un punto y coma (;) delimitador. Dentro de cada intervalo de día y hora, el formato es Day[StartHour:StartMinue-EndHour:EndMinute].

Los valores posibles de StartHour oscilan entre 00 y 23, donde 00 es equivalente a 12:00 a.m. y 12 es a las 12:00 p.m.

Los valores posibles de EndHour oscilan entre 00 y 24, donde 00 es equivalente a 12:00 a.m. y 12 es 12:00 p.m.

Los valores posibles de StartMinute y EndMinute van de 00 a 60.

En el ejemplo siguiente se muestran los intervalos de día y hora durante los días laborables de 9:00 a.m. a 9:00 p.m.: (lunes[09:00-21:00]);( Martes[09:00-21:00]); (Miércoles[09:00-21:00]); (Jueves[09:00-21:00]); (Viernes[09:00-21:00])

Añadir: Opcional. Si no establece este campo, la extensión del anuncio será apta para programar en cualquier momento durante las fechas de inicio y finalización del calendario.
Actualizar: Opcional. No se pueden actualizar los intervalos de día y hora individuales. Puede actualizar eficazmente los intervalos de día y hora mediante el envío de un nuevo conjunto que debe reemplazar el conjunto anterior. Los campos Programación de anuncios, Fecha de finalización, Fecha de inicio y Usar zona horaria del buscador dependen entre sí y se actualizan juntos. Si deja todos estos campos vacíos durante la actualización, ninguno de ellos se actualiza. Si incluye valores para cualquiera de estos campos, los valores anteriores de todos estos campos se quitan o reemplazan. Para quitar toda la configuración de programación anterior, establezca cada uno de estos campos en delete_value.
Eliminar: Solo lectura

Texto alternativo

Descripción alternativa del medio de imagen para su facilidad de uso. Si no se pudo mostrar la imagen, se usa el texto alternativo en su lugar.

La longitud máxima de este campo es de 90 caracteres.

Añadir: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Identificador de cliente

Se usa para asociar registros en el archivo de carga masiva con registros en el archivo de resultados. El servidor no usa ni almacena el valor de este campo; simplemente se copia del registro cargado en el registro de resultados correspondiente. Puede ser cualquier cadena válida de hasta 100 en longitud.

Añadir: Opcional
Actualizar: Opcional
Eliminar: Solo lectura

Parámetro personalizado

Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL.

En un archivo masivo, la lista de parámetros personalizados tiene el formato siguiente.

  • Dé formato a cada par de parámetros personalizado como Key=Value, por ejemplo{_promoCode}=PROMO1.

  • Microsoft Advertising aceptará los tres primeros pares de clave y valor de parámetro personalizados que incluya, y se omitirán los parámetros personalizados adicionales. Para los clientes de la fase 3 de aumento de límite de parámetros personalizados piloto (GetCustomerPilotFeatures devuelve 635), Microsoft Advertising aceptará los primeros 8 pares de clave y valor de parámetro personalizados que incluya y, si incluye más de 8 parámetros personalizados, se devolverá un error.

  • Cada par de clave y valor se delimita por un punto y coma y un espacio ("; "), por ejemplo {_promoCode}=PROMO1; {_season}=verano.

  • Una clave no puede contener un punto y coma. Si un valor contiene un punto y coma, debe tener escape como '\;'. Además, si el valor contiene una barra diagonal inversa, también debe tener el carácter de escape '\'.

  • La clave no puede superar los 16 bytes UTF-8 y el valor no puede superar los 200 bytes UTF-8. Para los clientes del piloto de la fase 3 de aumento de límite de parámetros personalizados (GetCustomerPilotFeatures devuelve 635), el límite de valores aumenta a 250 bytes UTF-8. La clave es necesaria y el valor es opcional. El tamaño máximo de la clave no incluye las llaves y el carácter de subrayado, es decir, '{', '_' y '}'.

    Nota:

    Con el servicio bulk, la clave debe tener formato con llaves circundantes y un carácter de subrayado inicial, por ejemplo, si la clave es promoCode, debe tener el formato {_promoCode}. Con el servicio Administración de campañas no puede especificar las llaves y el carácter de subrayado circundantes.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para quitar todos los parámetros personalizados, establezca este campo en delete_value. La palabra clave delete_value quita la configuración anterior. Para quitar un subconjunto de parámetros personalizados, especifique los parámetros personalizados que desea conservar y omita los que no desee conservar. El nuevo conjunto de parámetros personalizados reemplazará a cualquier conjunto de parámetros personalizados anterior.
Eliminar: Solo lectura

Dirección URL de destino

Dirección URL de la página web a la que se va a llevar al usuario cuando hace clic en la imagen.

La dirección URL puede contener cadenas de texto dinámicas como {keyword}. Para obtener más información, consulte ¿Qué parámetros de seguimiento o dirección URL puedo usar?.

La dirección URL puede contener un máximo de 1024 caracteres. Si la dirección URL no especifica un protocolo, el sistema usa el protocolo HTTP cuando un usuario hace clic en el anuncio. Si la dirección URL especifica el protocolo HTTP al agregar un anuncio, el servicio quitará la cadena de protocolo http:// (la cadena de protocolo HTTP no cuenta con el límite de 1024 caracteres); sin embargo, el servicio no quitará una cadena de protocolo HTTPS (https://) de la dirección URL.

Nota:

Si no se especifica la dirección URL para la extensión de anuncio de imagen, se usa la dirección URL del anuncio.

Añadir: Opcional. Nota: Este campo es necesario para las extensiones de anuncio de varias imágenes. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Nota: Este campo es necesario para las extensiones de anuncio de varias imágenes.
Eliminar: Solo lectura

Mostrar texto

Texto para mostrar de la extensión de imagen.

La longitud máxima de este campo es de 35 caracteres.

Añadir: Obligatorio
Actualizar: Obligatorio. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Ubicación editorial

Componente o propiedad de la extensión de anuncio que produjo un error en la revisión editorial.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Código de motivo editorial

Código que identifica el motivo del error. Para obtener una lista de posibles códigos de motivo, consulte Códigos de motivo editoriales.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Estado editorial

Estado editorial de la extensión del anuncio.

Los valores posibles se describen en la tabla siguiente.

Valor Descripción
Activo La extensión del anuncio superó la revisión editorial.
ActiveLimited La extensión de anuncio superó la revisión editorial en uno o varios mercados, y uno o varios elementos de la extensión del anuncio están siendo revisados editorialmente en otro mercado. Por ejemplo, la extensión de anuncio pasó la revisión editorial para Canadá y todavía está pendiente de revisión en el Estados Unidos.
Desaprobó No se pudo revisar la extensión del anuncio.
Inactivo Uno o varios elementos de la extensión del anuncio se están revisando editorialmente.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Término editorial

El término que falló en la revisión editorial.

Este campo no se establecerá si una combinación de términos produjo el error o si el error se basó en una infracción de directiva.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Fecha de finalización

Cadena de fecha de finalización programada de la extensión de anuncio con formato MM/DD/AAAA.

La fecha de finalización es inclusiva. Por ejemplo, si establece este campo en 12/31/2020, las extensiones de anuncio dejarán de mostrarse a las 11:59 p. m. del 12/31/2020.

Añadir: Opcional. Si no especificas una fecha de finalización, la extensión del anuncio se seguirá entregando a menos que pauses las campañas, grupos de anuncios o anuncios asociados.
Actualizar: Opcional. La fecha de finalización se puede acortar o ampliar, siempre que la fecha de inicio sea nula o se produzca antes de la nueva fecha de finalización. Si establece este campo en la cadena de delete_value , quitará eficazmente la fecha de finalización. Los campos Programación de anuncios, Fecha de finalización, Fecha de inicio y Usar zona horaria del buscador dependen entre sí y se actualizan juntos. Si deja todos estos campos vacíos durante la actualización, ninguno de ellos se actualiza. Si incluye valores para cualquiera de estos campos, los valores anteriores de todos estos campos se quitan o reemplazan. Para quitar toda la configuración de programación anterior, establezca cada uno de estos campos en delete_value.
Eliminar: Solo lectura

Final Url

Dirección URL de la página de aterrizaje.

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 de lista para la dirección URL final y la dirección URL final móvil; sin embargo, solo se usa el primer elemento de cada lista para la entrega. El servicio permite hasta 10 elementos de lista para una posible compatibilidad con reenvíos.
  • Cada dirección URL está delimitada por un punto y coma y un espacio ("; ").
  • 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 Mobile Final Url, también debe especificar La dirección URL final.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Sufijo de dirección URL final

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.

Nota:

Esta característica solo está disponible para los clientes de la fase 3 del sufijo final url (GetCustomerPilotFeatures devuelve 636). Si no está en el piloto, esta propiedad se omitirá y no se devolverá ningún error.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Eliminar: Solo lectura

Id

Identificador generado por el sistema de la extensión de anuncio.

Añadir: Opcional. Debe dejar este campo vacío o especificar un identificador negativo. A continuación, se puede hacer referencia a un identificador negativo establecido para la extensión de anuncio en el campo Id de los tipos de registro dependientes, como Extensión de anuncio de imagen de grupo de anuncios y Extensión de anuncio de imagen de campaña. Esto se recomienda si va a agregar nuevas extensiones de anuncio y nuevos registros dependientes en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio

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.

Solo es necesario proporcionar un recurso de imagen horizontal, es decir, este campo debe contener un recurso de imagen con subType establecido en LandscapeImageMedia. Las dimensiones recomendadas para LandscapeImageMedia 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 LandscapeImageMedia.

Los recursos de imagen se representan en el archivo masivo como una cadena JSON. En el json de ejemplo siguiente se incluyen siete imágenes y solo se recorta LandscapeImageMedia subType . id es una propiedad del recurso, mientras que , cropHeightcropWidth, cropX, cropYy subType son propiedades del vínculo del recurso, es decir, la relación entre el recurso y el anuncio. Para obtener más información, vea cropHeight, cropWidth, cropX, cropY, id y subType a continuación.

[{
	"id": 1234567890000,
	"subType": "LandscapeImageMedia"
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia169X100",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 1061,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia93X100",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 584,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia155X100",
	"cropX": 114,
	"cropY": 0,
	"cropWidth": 973,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia133X100",
	"cropX": 183,
	"cropY": 0,
	"cropWidth": 835,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia178X100",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 1118,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia172X100",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1080,
	"cropHeight": 628
}]

Nota:

En el archivo masivo separado por comas, deberá rodear la lista de vínculos de recursos, cada clave de atributo y cada valor de cadena de atributo con un conjunto adicional de comillas dobles, por ejemplo, la cadena JSON anterior se escribiría como "[{""id"":1234567890000,"subType":""LandscapeImageMedia""},{"id"":1234567890000,"subType"":"SquareImageMedia"",", ""cropX":286,""cropY":0,""cropWidth"":628,""cropHeight"":628},{"id"":1234567890000, ""subType"":""ImageMedia169X100"","cropX":70,""cropY":0,""cropWidth":1061,""cropHeight"":628},{"id"":1234567890000,""subType"":""ImageMedia93X100"","cropX"":308,""cropY":0,"cropWidth":584,""cropHeight"":628},{""". id"":1234567890000,"subType":""ImageMedia15X10"","cropX":129,""cropY":0,""cropWidth":942,"cropHeight"":628}, {""id"":1234567890000,"subType"":"ImageMedia155X100",""cropX":114,"cropY":0,""cropWidth":973,""cropHeight"" :628},{""id":1234567890000,"subType"":"ImageMedia133X100",""cropX"":183,"cropY":0,"cropWidth":835,""cropHeight":628},{"id"":1234567890000,"subType":""ImageMedia178X100","cropX""::41,""cropY"":0,""cropWidth":1118,"cropHeight"":628},{"id"":1234567890000,"subType":"ImageMedia172X100"",""cropX":60,""cropY":0,""cropWidth":1080,""cropHeight"":628}]".

Dado el ejemplo JSON de respuesta de carga anterior, 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 LandscapeImageMedia, se recortan todos los recursos de imagen excepto la imagen horizontal original.
  • Independientemente de si la imagen horizontal tiene su propia configuración de recorte, Microsoft Advertising usa el alto real de la imagen horizontal para todos los ajustes de recorte predeterminados. En este ejemplo, el alto de recorte de todos los recursos de imagen generados por el sistema es 628 y se puede deducir que la imagen horizontal (subtipo LandscapeImageMedia) con una relación de aspecto de 1,91:1 tiene un ancho y un alto de 1200x628. Incluso si el vínculo del recurso de imagen horizontal se hubiera creado con la configuración de recorte, por ejemplo, 703x368, la configuración de recorte de los recursos de imagen generada automáticamente se basa en las dimensiones completas de la imagen horizontal (de nuevo, sería 1200x628 en este ejemplo).

cropHeight

Número de píxeles que se van a usar desde el origen del recurso de imagen, empezando por la posición recortada y moviéndose hacia arriba.

cropWidth

Número de píxeles que se van a usar desde el origen del recurso de imagen, empezando por la posición cropX y moviéndose a la derecha.

cropX

A partir de la esquina inferior izquierda del origen del recurso de imagen, este es el número de píxeles que se van a ir a la derecha en el eje X antes de aplicar el cropWidth.

cropY

A partir de la esquina inferior izquierda del origen del recurso de imagen, este es el número de píxeles que se omitirán hacia arriba en el eje Y antes de aplicar cropHeight.

id

El id atributo es un identificador único de Microsoft Advertising para el recurso de una cuenta de Microsoft Advertising.

El mismo identificador de recurso de imagen se puede usar varias veces en el mismo anuncio para diferentes relaciones de aspecto, y también puede ser utilizado por varios anuncios en la misma cuenta de Microsoft Advertising. El identificador del recurso de imagen con SubType establecido en LandscapeImageMedia se usa para todos los subtipos de recursos de imagen generados automáticamente dentro del mismo anuncio. 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.

Puede crear imágenes para extensiones de anuncios de imagen a través del registro masivo Imagen . A continuación, puede usar el identificador multimedia devuelto como identificador de recurso de imagen. La relación de aspecto de la imagen que agregó debe ser compatible con el subTipo del recurso de imagen.

Subtipo

El subType atributo representa la relación de aspecto de este recurso de imagen.

La verdadera relación de aspecto de la imagen que se almacena en la biblioteca multimedia de nivel de cuenta puede variar, siempre y cuando las dimensiones resultantes produzcan la relación de aspecto esperada por subtipo. Si no especifica la configuración de recorte, el servicio recortará automáticamente hasta el área máxima posible desde el centro de la imagen. Por ejemplo, dada una imagen de 1000 x 1000 píxeles, para la relación de aspecto 1.91:1, la configuración de recorte automático será cropWidth=1000, cropHeight=524, cropX=0 y cropY=238.

Los valores de subtipo posibles son LandscapeImageMedia, SquareImageMedia, ImageMedia169X100, ImageMedia93X100, ImageMedia15X10, ImageMedia155X100, ImageMedia133X100, ImageMedia178X100 e ImageMedia172X100. Es posible que en el futuro se agreguen nuevos subtipos, por lo que no debe tomar ninguna dependencia de un conjunto fijo de valores.

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

Añadir: Obligatorio. Solo se requieren el id . y el subType para cada vínculo de recurso.
Actualizar: Opcional. Para conservar todos los vínculos de recursos existentes, establezca o deje este campo vacío. Si estableces este campo, se reemplazarán las imágenes que se vincularon anteriormente a este anuncio. Si establece este campo, solo se requieren el identificador y el subTipo para cada vínculo de recurso.
Eliminar: Solo lectura

Diseños

Lista de diseños de imagen aptos.

Los valores admitidos son SearchSingle y SearchMultiple. Es posible que en el futuro se agreguen nuevos diseños, por lo que no debe depender de un conjunto fijo de valores.

En un archivo masivo, la lista de cadenas de diseño se delimita con un punto y coma (;).

Añadir: Opcional. Si no establece este campo, todos los diseños admitidos actuales y futuros se establecerán de forma predeterminada.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Eliminar: Solo lectura

Identificadores de medios

Identificadores de las imágenes que se incluirán en el anuncio. No puede especificar identificadores multimedia para más de una imagen de la misma relación de aspecto. En otras palabras, cada una de las imágenes a las que se hace referencia debe tener relaciones de aspecto diferentes.

Puede especificar hasta cuatro (4) identificadores de imagen . Aunque el mínimo necesario es un identificador de medio de imagen, para calificar para todas las ubicaciones de anuncios debe proporcionar cuatro identificadores multimedia de imagen.

En un archivo masivo, la lista de identificadores multimedia se delimita con un punto y coma (;).

Añadir: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Mobile Final Url

Dirección URL de la página de aterrizaje para dispositivos móviles.

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 de lista para la dirección URL final y la dirección URL final móvil; sin embargo, solo se usa el primer elemento de cada lista para la entrega. El servicio permite hasta 10 elementos de lista para una posible compatibilidad con reenvíos.
  • Cada dirección URL está delimitada por un punto y coma y un espacio ("; ").
  • 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 Mobile Final Url, también debe especificar La dirección URL final.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Eliminar: Solo lectura

Tiempo de modificación

Fecha y hora en que se actualizó por última vez la entidad. El valor se encuentra en la hora UTC (hora universal coordinada).

Nota:

El valor de fecha y hora refleja la fecha y hora en el servidor, no en el cliente. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Parent Id

Identificador generado por el sistema de la cuenta que contiene la extensión de anuncio.

Este campo masivo se asigna al campo Id del registro de cuenta .

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Países editores

Lista de países o regiones del publicador cuyas directrices editoriales no permiten el término especificado.

En un archivo masivo, la lista de países o regiones del publicador se delimita con un punto y coma (;).

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Fecha de inicio

Cadena de fecha de inicio programada de la extensión de anuncio con formato MM/DD/AAAA.

La fecha de inicio es inclusiva. Por ejemplo, si establece StartDate en 5/5/2020, las extensiones de anuncio comenzarán a mostrarse a las 12:00 AM el 5/5/2020.

Añadir: Opcional. Si no especifica una fecha de inicio, la extensión del anuncio se puede programar inmediatamente.
Actualizar: Opcional. La fecha de inicio se puede acortar o ampliar, siempre que la fecha de finalización sea nula o se produzca después de la nueva fecha de inicio. Si estableces este campo en la cadena de delete_value , estás quitando de forma eficaz la fecha de inicio y la extensión del anuncio se puede programar inmediatamente. Los campos Programación de anuncios, Fecha de finalización, Fecha de inicio y Usar zona horaria del buscador dependen entre sí y se actualizan juntos. Si deja todos estos campos vacíos durante la actualización, ninguno de ellos se actualiza. Si incluye valores para cualquiera de estos campos, los valores anteriores de todos estos campos se quitan o reemplazan. Para quitar toda la configuración de programación anterior, establezca cada uno de estos campos en delete_value.
Eliminar: Solo lectura

Estado

Estado de la extensión del anuncio.

Los valores posibles son Active o Deleted.

Añadir: Opcional. El valor predeterminado es Active.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.

Plantilla de seguimiento

Plantilla de seguimiento que se va a usar para las direcciones URL de promoción.

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 campo en la cadena delete_value , se quita la configuración anterior.
Eliminar: Solo lectura

Uso de la zona horaria del buscador

Determina si se debe usar la zona horaria de la cuenta o la zona horaria del usuario de búsqueda donde se podrían entregar los anuncios.

Establezca esta propiedad en TRUE si desea que las extensiones de anuncio se muestren en la zona horaria del usuario de búsqueda y, de lo contrario, establézcala en FALSE.

Añadir: Opcional. Si no especifica este campo o lo deja vacío, se establecerá el valor predeterminado de FALSE y se usará la zona horaria de la cuenta.
Actualizar: Opcional. Si establece este campo en la cadena delete_value , se restablece eficazmente al valor predeterminado de FALSE. Los campos Programación de anuncios, Fecha de finalización, Fecha de inicio y Usar zona horaria del buscador dependen entre sí y se actualizan juntos. Si deja todos estos campos vacíos durante la actualización, ninguno de ellos se actualiza. Si incluye valores para cualquiera de estos campos, los valores anteriores de todos estos campos se quitan o reemplazan. Para quitar toda la configuración de programación anterior, establezca cada uno de estos campos en delete_value.
Eliminar: Solo lectura

Versión

Número de veces que se ha actualizado el contenido de la extensión del anuncio. La versión se establece en 1 cuando se agrega la extensión y se incrementa cada vez que se revisa.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura