Registro de anuncios con capacidad de respuesta: masiva
Define un anuncio con capacidad de respuesta que se puede descargar y cargar en un archivo masivo.
Los anuncios con capacidad de respuesta se ajustan automáticamente para adaptarse a los tamaños y formas de los formatos de anuncios de audiencia. Estos anuncios funcionan mejor con texto informativo en lugar de llamadas a la acción.
Nota:
Esta característica está disponible actualmente en Estados Unidos, Canadá, Reino Unido y Australia. Si anuncias en Estados Unidos, Canadá, Reino Unido o Australia y quieres participar en anuncios de audiencia, ponte en contacto con el soporte técnico.
Nota:
Los anuncios con capacidad de respuesta duplicados se permiten en el mismo grupo de anuncios.
Puede descargar todos los registros de Responsive Ad de la cuenta incluyendo el valor DownloadEntity de ResponsiveAds 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 un nuevo anuncio con capacidad de respuesta si se proporciona un valor de Id. primario válido.
Type,Status,Id,Parent Id,Campaign,Ad Group,Sync Time,Client Id,Modified Time,Tracking Template,Final Url Suffix,Custom Parameter,Final Url,Mobile Final Url,Text,Business Name,Device Preference,Ad Format Preference,Name,Call To Action,Headline,Long Headline,Images
Format Version,,,,,,,,,,,,,,,,,,6.0,,,,
Responsive Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,Contoso,,,,,Short Headline Here,Long Headline Here,"[{""id"":1234567890000,""subType"":""LandscapeImageMedia""}]"
Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkResponsiveAd , en lugar de llamar directamente a las operaciones de servicio 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 BulkResponsiveAd
var bulkResponsiveAd = new BulkResponsiveAd
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
// 'Ad Group' column header in the Bulk file
AdGroupName = "AdGroupNameGoesHere",
// 'Campaign' column header in the Bulk file
CampaignName = "ParentCampaignNameGoesHere",
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// ResponsiveAd object of the Campaign Management service.
ResponsiveAd = new ResponsiveAd
{
// 'Call To Action' column header in the Bulk file
CallToAction = CallToAction.AddToCart,
// 'Mobile Final Url' column header in the Bulk file
FinalMobileUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://mobile.contoso.com/womenshoesale"
},
// 'Final Url' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://www.contoso.com/womenshoesale"
},
// 'Headline' column header in the Bulk file
Headline = "Short Headline Here",
// 'Id' column header in the Bulk file
Id = null,
// 'Images' column header in the Bulk file
Images = new[]
{
// Each AssetLink is represented as a JSON list item in the Bulk file.
new AssetLink
{
Asset = new ImageAsset
{
CropHeight = null,
CropWidth = null,
CropX = null,
CropY = null,
Id = landscapeImageMediaId,
SubType = "LandscapeImageMedia"
},
},
},
// 'Long Headline' column header in the Bulk file
LongHeadlineString = "Long Headline Here",
// 'Status' column header in the Bulk file
Status = AdStatus.Active,
// 'Text' column header in the Bulk file
Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
// 'Tracking Template' column header in the Bulk file
TrackingUrlTemplate = null,
// 'Custom Parameter' column header in the Bulk file
UrlCustomParameters = new CustomParameters
{
// Each custom parameter is delimited by a semicolon (;) in the Bulk file
Parameters = new[] {
new CustomParameter(){
Key = "promoCode",
Value = "PROMO1"
},
new CustomParameter(){
Key = "season",
Value = "summer"
},
}
},
},
};
uploadEntities.Add(bulkResponsiveAd);
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 ad con capacidad de respuesta, los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
- Grupo de anuncios
- Nombre de la empresa
- Llamada a la acción
- Lenguaje de llamada a la acción
- Campaña
- Id. de cliente
- Parámetro personalizado
- Descripciones
- Estado de la apelación editorial
- Ubicación editorial
- Código de motivo editorial
- Estado editorial
- Término editorial
- Final Url
- Titular
- Encabezados
- Sufijo de dirección URL final
- Id
- Images
- Url de seguimiento de impresiones
- Id. multimedia de imagen horizontal
- Id. multimedia del logotipo de Landscape
- Título largo
- Titulares largos
- Cadena de título largo
- Mobile Final Url
- Tiempo de modificación
- Parent Id
- Países editores
- Estado
- Id. de medio de imagen cuadrada
- Id. multimedia del logotipo cuadrado
- Text
- Plantilla de seguimiento
Grupo de anuncios
Nombre del grupo de anuncios que contiene el anuncio.
Agregar: Solo lectura y Obligatorio
Actualizar: Solo lectura y Obligatorio
Borrar: Solo lectura y Obligatorio
Nota:
Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .
Nombre de la empresa
Nombre de la empresa.
En función de la ubicación del anuncio de audiencia, el nombre de la empresa puede aparecer en el 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.
Borrar: Solo lectura
Llamada a la acción
Una breve y contundente razón para que los clientes haga clic en su anuncio en este momento.
Esta es la llamada a las acciones disponibles para buscar anuncios multimedia:
Llamada a la acción |
---|
Actuar ahora |
Aplicar ahora |
Apostar ahora |
Pujar ahora |
Reservar un coche |
Book Hotel |
Reservar ahora |
Compilar ahora |
Comprar ahora |
Chatear ahora |
Compare |
Póngase en contacto con nosotros |
Distribuidores |
Indicaciones |
Donar |
Descargar |
Correo electrónico ahora |
Inscribirse ahora |
Archivo ahora |
Buscar trabajo |
Buscar tienda |
Juego gratis |
Cotización gratuita |
Evaluación gratuita |
Obtener cupón |
Obtener ofertas |
Obtener demostración |
Obtener ahora |
Obtener oferta |
Obtener presupuesto |
Ir a demostración |
Únete ahora |
Más información |
Escucha ahora |
Inicia sesión |
Ordenar ahora |
Juego de juego |
Reproducir ahora |
Publicar trabajo |
Registrarse |
Renovar ahora |
Alquiler de un coche |
Alquiler ahora |
Reordenar |
Reserva |
Guardar ahora |
Programación |
Consulte la demostración |
Ver menú |
Ver modelos |
Ver oferta |
Ver ofertas |
Ver venta |
Vender ahora |
Comprar ahora |
Showtimes |
Iniciar sesión |
Registrarse |
Empezar ahora |
Subscribe |
Versión de prueba |
Pruébelo ahora |
Visualización de coches |
Ver demostración |
Ver planes |
Visita a la tienda |
Votar ahora |
Reloj |
Ver más |
Ver ahora |
Agregar: No se aplica a los anuncios de audiencia.
Actualizar: Solo lectura
Borrar: Solo lectura
Llamada a la acción Langauge
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.
Estos son los idiomas de llamada a la acción disponibles para buscar anuncios multimedia:
Llamada a la acción |
---|
Language.Albanian |
Language.Arabic |
Language.Bosnian |
Language.Bulgarian |
Language.Croatian |
Language.Czech |
Idioma.danés |
Language.Dutch |
Language.English |
Language.Estonian |
Language.Finnish |
Language.French |
Language.German |
Language.Greek |
Language.Hebreo |
Language.Hungarian |
Language.Islandia |
Language.Italian |
Language.Japanese |
Language.Letón |
Language.Lithuanian |
Language.Macedonian |
Language.Maltese |
Language.Norwegian |
Language.Polish |
Language.Portuguese |
Language.Rumano |
Idioma.ruso |
Language.Serbian |
Language.Eslovaco |
Idioma.esloveno |
Language.Spanish |
Language.Swedish |
Language.TraditionalChinese |
Language.Turkish |
Agregar: No aplicable a los anuncios de audiencia; Necesario para los anuncios multimedia.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura
Campaña
Nombre de la campaña que contiene el grupo de anuncios y el anuncio.
Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: 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.
Agregar: Opcional
Actualizar: Opcional
Borrar: 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 8 primeros 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 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.
Agregar: 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.
Borrar: Solo lectura
Descripciones
En función de la ubicación del anuncio de audiencia, este texto aparecerá debajo o adyacente al titular largo o corto 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.
El límite superior de descripciones es 5. La longitud de la cadena está limitada a 90 caracteres. El formato de datos de los titulares se incluye en el json de ejemplo siguiente.
[{
"text": "Contoso",
},
{
"text": "Quick & Easy Setup"
},
{
"text": "Seamless Integration"
}]
Agregar: Obligatorio para anuncios de audiencia y anuncios multimedia. No se aplica a los anuncios de vídeo. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Borrar: Solo lectura
Estado de la apelación editorial
Determina si puede apelar los problemas encontrados por la revisión editorial.
Los valores posibles se describen en la tabla siguiente.
Valor | Descripción |
---|---|
Apelable | El tema editorial es atractivo. |
AppealPending | El tema editorial es apelable y se ha presentado una apelación. |
NotAppealable | El tema editorial no es atractivo. |
Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: Solo lectura
Ubicación editorial
Componente o propiedad del anuncio que no pudo revisar editorialmente.
Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: 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.
Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: Solo lectura
Estado editorial
Estado editorial del anuncio.
Los valores posibles se describen en la tabla siguiente.
Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: 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.
Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: Solo lectura
Final Url
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 las direcciones URL finales y las direcciones URL móviles finales; 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.
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}".
Cada dirección URL debe ser una dirección URL bien formada a partir de http:// o https://.
Si especifica direcciones URL de Final Mobile, también debe especificar La dirección URL final.
Tenga en cuenta también que si se establecen los campos Plantilla de seguimiento o Parámetro personalizado , se requiere al menos una dirección URL final.
Nota:
Esta dirección URL solo se usa si la palabra clave no especifica una dirección URL final.
Agregar: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: 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.
Agregar: 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.
Borrar: Solo lectura
k
Titular
Este es uno de los dos titulares posibles que podrían aparecer en tus anuncios de vídeo.
Dado que los anuncios de vídeo tienen capacidad de respuesta, necesitamos varios titulares para que puedan servir 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.
Borrar: Solo lectura
Encabezados
Dado que los anuncios de audiencia responden, necesitamos varios titulares para que puedan ofrecer servicios flexibles en una variedad de publicadores y ubicaciones.
El límite superior de los titulares es 15. Y la longitud de cada título está limitada a 30 caracteres. El formato de datos de los titulares se incluye en el json de ejemplo siguiente.
[{
"text": "Contoso",
},
{
"text": "Quick & Easy Setup"
},
{
"text": "Seamless Integration"
}]
Agregar: Necesario para anuncios multimedia y anuncios de audiencia. No se aplica a los anuncios de vídeo.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura
Id
Identificador generado por el sistema del anuncio.
Agregar: 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 el anuncio en el campo Id. primario de tipos de registro dependientes, como etiqueta de anuncio adaptable. Esto se recomienda si va a agregar nuevos anuncios 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
Borrar: Solo lectura y Obligatorio
Imágenes
Dado que los anuncios de audiencia responden, puedes crear varios 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.
Nota:
A partir de ahora, SubType OriginalImage reemplaza el rol de LandscapeImageMedia como imagen predeterminada para ResponsiveAd de Audience Campaign.
Solo es necesario proporcionar un recurso OriginalImage, es decir, este campo debe contener un recurso de imagen 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.
Nota:
Si este campo está establecido (no está vacío), se omiten el id. multimedia de imagen horizontal y el id. de medio de imagen cuadrada .
Los recursos de imagen se representan en el archivo masivo como una cadena JSON. En el json de ejemplo siguiente se incluyen nueve imágenes y solo se recorta OriginalImage subType
.
id
es una propiedad del recurso, mientras que , cropHeight
cropWidth
, cropX
, cropY
y 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": "OriginalImage"
},
{
"id": 1234567890000,
"subType": "LandscapeLogoMedia",
"cropX": 0,
"cropY": 0,
"cropWidth": 512,
"cropHeight": 128
},
{
"id": 1234567890000,
"subType": "SquareLogoMedia",
"cropX": 0,
"cropY": 0,
"cropWidth": 128,
"cropHeight": 128
},
{
"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":"OriginalImage""},{"id"":1234567890000,"subType"":"LandscapeLogoMedia""".","cropX"":0,""cropY"":0,""cropWidth"":512,""cropHeight"":128},{"id"":1234567890000, ""subType"":""SquareLogoMedia",""cropX"":0,"cropY"":0,""cropWidth":128,""cropHeight"":128},{"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 OriginalImage, se recortan todos los recursos de imagen excepto la imagen asociada a OriginalImage.
- Independientemente de si OriginalImage tiene su propia configuración de recorte, Microsoft Advertising usa el alto verdadero de la imagen asociada a OriginalImage para toda la configuración de recorte predeterminada. 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. Incluso si el vínculo del recurso OriginalImage se hubiera creado con la configuración de recorte, por ejemplo, 703x368, la configuración de recorte de los recursos de imagen generados automáticamente se basa en las dimensiones completas de OriginalImage (de nuevo, sería 1200x628 en este ejemplo).
- Aunque en Bing Ads API, versión 12, podría usar el id. multimedia de imagen horizontal y el id. de medio de imagen cuadrada, estos campos están en desuso y se quitarán en una versión futura. Tiene más flexibilidad y control de las imágenes recortadas a través del campo Imágenes .
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 anuncios con capacidad de respuesta 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.
El subtipo debe establecerse en "Logo" si la imagen está asociada a un anuncio como "LandscapeLogoMedia" o "SquareLogoMedia".
Los posibles valores de subtipo son OriginalImage, LandscapeLogoMedia, SquareLogoMedia, LandscapeImageMedia, SquareImageMedia, ImageMedia4x1, ImageMedia1x2, ImageMedia169X100, ImageMedia201X100, ImageMedia120X100, ImageMedia200X100, ImageMedia124X100 e ImageMedia153X100. 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 | Relación de aspecto | Dimensiones mínimas en píxeles |
---|---|---|
OriginalImage | N/D | 703 ancho x 368 alto |
LandscapeLogoMedia | 4:1 | 512 ancho x 128 alto |
SquareLogoMedia | 1:1 | 128 ancho x 128 de alto |
LandscapeImageMedia | 1.91:1 | 300 ancho x 157 de alto |
SquareImageMedia | 1:1 | 114 ancho x 114 alto |
ImageMedia4x1 | 4:1 | 608 ancho x 152 de alto |
ImageMedia1x2 | 1:2 | 470 ancho x 940 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 |
Agregar: Obligatorio si el identificador multimedia de imagen horizontal está vacío. 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.
Borrar: Solo lectura
Url de seguimiento de impresiones
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 está delimitada por un punto y coma y un espacio ("; ").
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.
Agregar: 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.
Borrar: Solo lectura
Id. multimedia de imagen horizontal
Identificador del recurso de imagen usado para las imágenes horizontales con una relación de aspecto 1.91:1 que podría aparecer en los anuncios de audiencia.
La relación de aspecto del medio de imagen almacenado puede variar, siempre y cuando la configuración de recorte del recurso de imagen tenga como resultado la relación de aspecto admitida para este campo. Para confirmar la relación de aspecto efectiva con la configuración de recorte, use el campo Imágenes .
Nota:
Aunque en Bing Ads API versión 12 puede usar landscape Image Media Id y SquareImageMediaId, estos campos están en desuso y se quitarán en una versión futura. Tiene más flexibilidad y control de las imágenes recortadas a través del campo Imágenes .
Agregar: Obligatorio si no se establece Images. Si se establece Imágenes , se omite este campo.
Actualizar: Opcional. Si se establece Imágenes , se omite este campo. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura
Id. multimedia del logotipo de Landscape
Este campo está reservado para uso interno y se quitará de una versión futura de la API de Bing Ads.
Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura
Título largo
Este es uno de los dos titulares posibles que podrían aparecer en los anuncios de audiencia.
Dado que los anuncios de audiencia responden, necesitamos varios titulares para que puedan ofrecer servicios flexibles en una variedad de publicadores y ubicaciones.
La longitud de la cadena está limitada a 90 caracteres.
Agregar: Obligatorio
Actualizar: Obsolescente. Use titulares largos en su lugar.
Borrar: Solo lectura
Titulares largos
Dado que los anuncios de audiencia responden, necesitamos varios titulares para que puedan ofrecer servicios flexibles en una variedad de publicadores y ubicaciones.
El límite superior de los titulares largos es 5. Y la longitud de cada título está limitada a 90 caracteres. El formato de datos de los titulares largos se incluye en el json de ejemplo siguiente.
[{
"text": "Contoso",
},
{
"text": "Quick & Easy Setup"
},
{
"text": "Seamless Integration"
}]
Agregar: Necesario para anuncios multimedia y anuncios de audiencia. No se aplica a los anuncios de vídeo.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura
Cadena de título largo
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. Dado que los anuncios de audiencia responden, necesitamos varios titulares para que puedan ofrecer servicios flexibles en una variedad de publicadores y ubicaciones.
La longitud de cada título está limitada a 90 caracteres. El formato de datos de los titulares largos se incluye en el json de ejemplo siguiente.
[{
"text": "Contoso",
},
{
"text": "Quick & Easy Setup"
},
{
"text": "Seamless Integration"
}]
Agregar: Se requiere para anuncios de audiencia y anuncios de vídeo. 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.
Borrar: Solo lectura
Mobile Final Url
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 las direcciones URL finales y las direcciones URL móviles finales; 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.
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}".
Cada dirección URL debe ser una dirección URL bien formada a partir de http:// o https://.
Si especifica direcciones URL de Final Mobile, también debe especificar La dirección URL final.
Nota:
Esta dirección URL solo se usa si la palabra clave no especifica una dirección URL final de Mobile.
Agregar: 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.
Borrar: 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.
Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: Solo lectura
Parent Id
Identificador generado por el sistema del grupo de anuncios que contiene el anuncio.
Este campo masivo se asigna al campo Id del registro del grupo de anuncios .
Agregar: Solo lectura y Obligatorio. Debe especificar un identificador de grupo de anuncios existente o especificar un identificador negativo que sea igual al campo Id del registro del grupo de anuncios primario. Esto se recomienda si va a agregar nuevos anuncios a un nuevo grupo de anuncios en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura
Borrar: Solo lectura
Nota:
Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .
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 (;).
Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: Solo lectura
Estado
Estado del anuncio.
Los valores posibles son Active, Paused o Deleted.
Agregar: Opcional. El valor predeterminado es Active.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Obligatorio. El estado debe establecerse en Eliminado.
Id. de medio de imagen cuadrada
Identificador del recurso de imagen usado para las imágenes cuadradas con una relación de aspecto 1:1 que podría aparecer en los anuncios de audiencia.
La relación de aspecto del medio de imagen almacenado puede variar, siempre y cuando la configuración de recorte del recurso de imagen tenga como resultado la relación de aspecto admitida para este campo. Para confirmar la relación de aspecto efectiva con la configuración de recorte, use el campo Imágenes .
Nota:
Aunque en Bing Ads API versión 12 puede usar landscape Image Media Id y SquareImageMediaId, estos campos están en desuso y se quitarán en una versión futura. Tiene más flexibilidad y control de las imágenes recortadas a través del campo Imágenes .
Agregar: Opcional. Si se establece Images , este campo se omite y Microsoft Advertising creará automáticamente un nuevo recurso de imagen cuadrada recortando el recurso de imagen LandscapeImageMedia. Si No se establece Imágenes y no se establece este campo, Microsoft Advertising creará automáticamente un nuevo recurso de imagen cuadrada recortando el id. multimedia de imagen horizontal.
Actualizar: Opcional. Si se establece Images , este campo se omite y Microsoft Advertising creará automáticamente un nuevo recurso de imagen cuadrada recortando el recurso de imagen LandscapeImageMedia. Si No se establece Imágenes y no se establece este campo, Microsoft Advertising creará automáticamente un nuevo recurso de imagen cuadrada recortando el id. multimedia de imagen horizontal. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura
Id. multimedia del logotipo cuadrado
Este campo está reservado para uso interno y se quitará de una versión futura de la API de Bing Ads.
Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura
Texto
En función de la ubicación del anuncio de vídeo, este texto aparecerá debajo o adyacente al titular largo o corto 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 de audiencia o anuncios multimedia.
Actualizar: Opcional para anuncios de vídeo. Usa descripciones en su lugar para anuncios de audiencia o anuncios multimedia (en desuso).
Borrar: Solo lectura
Plantilla de seguimiento
Plantilla de seguimiento que se va a usar como valor predeterminado para la dirección URL especificada con FinalUrls.
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 campo en la cadena delete_value , se quita la configuración anterior.
Borrar: Solo lectura