Registro de extensión de anuncio de flyer: masiva
Define una extensión de anuncio de flyer que se puede descargar y cargar en un archivo masivo.
Las extensiones de flyer permiten a los anunciantes distribuir catálogos de productos o tiendas (flyers) a clientes potenciales.
Pueden mostrarse de forma destacada en consultas amplias como "ofertas semanales" o "ventas semanales" y, por tanto, animar a los compradores a hacer clic en el anuncio en lugar de en el de la competencia. Por su naturaleza ayudan a informar mejor a los buscadores y, como resultado, aumentar la participación del usuario, por ejemplo, hacer clic en la tasa.
Nota:
Las extensiones de flyer están disponibles para los clientes en el piloto de características (GetCustomerPilotFeatures devuelve 802).
Puedes asociar una extensión de anuncio de flyer con la cuenta o con campañas y grupos de anuncios de la cuenta. Cada entidad (cuenta, campaña o grupo de anuncios) se puede asociar con hasta 3 extensiones de anuncios de flyer. Usa los registros Extensión de anuncio de folleto de cuenta, Extensión de anuncio de folleto de grupo de anuncios y Extensión de anuncio de folleto de campaña para administrar las asociaciones de extensiones de anuncios de flyer.
Puede descargar todos los registros de extensión de anuncios de Flyer de la cuenta incluyendo el valor DownloadEntity de FlyerAdExtensions 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 flyer a la biblioteca compartida de la cuenta.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Store Id,Name,Ad Schedule,Use Searcher Time Zone,Flyer Name,Description,Final Url,Mobile Final Url,Media Ids,Media Urls
Format Version,,,,,,,,,,,6.0,,,,,,
Flyer Ad Extension,Active,-18,0,,,ClientIdGoesHere,,,12/31/2020,,,(Monday[09:00-21:00]),FALSE,Flyer name goes here, Flyer description goes here,https://www.contoso.com/one; https://www.contoso.com/two; https://www.contoso.com/three,https://mobile.contoso.com/one; https://mobile.contoso.com/two; https://mobile.contoso.com/three,12345678,
Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkFlyerAdExtension , en lugar de llamar directamente a las operaciones del servicio y escribir código personalizado para analizar cada campo en el archivo masivo.
// Map properties in the Bulk file to the BulkFlyerAdExtension
var bulkFlyerAdExtension = new BulkFlyerAdExtension
{
// '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
// FlyerAdExtension object of the Campaign Management service.
FlyerAdExtension = new FlyerAdExtension
{
// 'Description' column header in the Bulk file
Description = "Flyer description",
// 'Id' column header in the Bulk file
Id = flyerAdExtensionIdKey,
// '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/one",
"https://www.contoso.com/two",
"https://www.contoso.com/three"
},
// '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/one",
"https://mobile.contoso.com/two",
"https://mobile.contoso.com/three"
},
// 'Flyer Name' column header in the Bulk file
FlyerName = "Flyer name",
// 'Media Ids' column header in the Bulk file
ImageMediaIds = new[] {
(long)12345678,
},
// 'Media Urls' column header in the Bulk file
ImageMediaUrls = null,
// 'Store Id' column header in the Bulk file
StoreId = 12345678,
// '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"
},
}
},
// 'Ad Schedule' column header in the Bulk file
Scheduling = new Schedule
{
// Each day and time range is delimited by a semicolon (;) in the Bulk file
DayTimeRanges = new[]
{
// Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
new DayTime
{
Day = Day.Monday,
StartHour = 9,
StartMinute = Minute.Zero,
EndHour = 21,
EndMinute = Minute.Zero,
},
},
// 'End Date' column header in the Bulk file
EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
{
Month = 12,
Day = 31,
Year = DateTime.UtcNow.Year + 1
},
// 'Start Date' column header in the Bulk file
StartDate = null,
// 'Use Searcher Time Zone' column header in the Bulk file
UseSearcherTimeZone = false,
},
// 'Status' column header in the Bulk file
Status = AdExtensionStatus.Active,
},
};
uploadEntities.Add(bulkFlyerAdExtension);
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 flyer , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
- Programación de anuncios
- Id. de cliente
- Descripción
- Ubicación editorial
- Código de motivo editorial
- Estado editorial
- Término editorial
- Fecha de finalización
- Final Url
- Nombre del folleto
- Id
- Identificadores de medios
- Direcciones URL multimedia
- Mobile Final Url
- Tiempo de modificación
- Parent Id
- Países editores
- Fecha de inicio
- Estado
- Id. de tienda
- Uso de la zona horaria del buscador
- Versión
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 y Usar zona horaria del buscador dependen entre sí y se actualizan juntos. Si deja ambos campos vacíos durante la actualización, ninguno de ellos se actualiza. Si incluye valores para cualquiera de estos campos, los valores anteriores de cada uno de estos campos se quitan o reemplazan.
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
Descripción
Descripción que puede usar el anunciante, la agencia o el administrador de cuentas para realizar un seguimiento, etiquetar o administrar extensiones de volantes.
Esta descripción no se muestra con el anuncio o la imagen.
La longitud máxima de este elemento es de 1024 caracteres.
Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
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.
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.
La fecha de finalización debe estar dentro de los 30 días posteriores a la fecha de inicio.
Añadir: Obligatorio
Actualizar: Opcional. La fecha de finalización se puede acortar o ampliar, siempre que la fecha de inicio no esté establecida o tenga lugar hasta 30 días antes de la nueva fecha de finalización.
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: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura
Nombre del folleto
El nombre del volante.
La longitud máxima de este elemento es de 150 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
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 tipos de registro dependientes, como Extensión de anuncio de folleto de grupo de anuncios y Extensión de anuncio de folleto 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
Identificadores de medios
Identificador de la imagen que se va a incluir en el anuncio.
Solo puede establecer un identificador multimedia.
Cada identificador multimedia corresponde a una imagen del subtipo "GenericImage".
La imagen debe tener un ancho mínimo y un alto de 220 px, y un tamaño máximo de archivo de 3,9 MB.
Añadir: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura
Direcciones URL multimedia
Dirección URL del medio que ya agregó.
Añadir: Solo lectura
Actualizar: Solo lectura
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.
La fecha de finalización debe estar dentro de los 30 días posteriores a la fecha de inicio.
Añadir: Obligatorio
Actualizar: Opcional. La fecha de inicio se puede acortar o ampliar, siempre y cuando la fecha de finalización no esté establecida o se produzca hasta 30 días después de la nueva fecha de inicio.
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.
Id. de tienda
Identificador único de una tienda de Microsoft Merchant Center que se usa para los anuncios de productos.
Añadir: Opcional
Actualizar: Solo lectura. No se puede actualizar el identificador de almacén después de establecerlo.
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 y Usar zona horaria del buscador dependen entre sí y se actualizan juntos. Si deja ambos campos vacíos durante la actualización, ninguno de ellos se actualiza. Si incluye valores para cualquiera de estos campos, los valores anteriores de cada uno de estos campos se quitan o reemplazan.
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