Registro de extensión de anuncio de promoción: masiva
Define una extensión de anuncio de promoción que se puede descargar y cargar en un archivo masivo.
Nota:
Las extensiones de promoción están disponibles para los clientes en AU, CA, DE, FR, EE. UU. y Reino Unido.
Puedes asociar una extensión de anuncio de promoción a la cuenta o a campañas y grupos de anuncios de la cuenta. Cada entidad (cuenta, campaña o grupo de anuncios) se puede asociar con hasta 20 extensiones de anuncios de promoción. Usa los registros Extensión de anuncio de promoción de cuenta, Extensión de anuncio de promoción de grupo de anuncios y Extensión de anuncio de promoción de campaña para administrar las asociaciones de extensiones de anuncios de promoción.
Puede descargar todos los registros de extensión de anuncios de promoción de la cuenta incluyendo el valor DownloadEntity de PromotionAdExtensions 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 promoción a la biblioteca compartida de la cuenta.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Language,Start Date,End Date,Name,Version,Ad Schedule,Use Searcher Time Zone,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Promotion Target,Discount Modifier,Percent Off,Money Amount Off,Promotion Code,Orders Over Amount,Occasion,Promotion Start,Promotion End,Currency Code
Format Version,,,,,,,,,,,6,,,,,,,,,,,,,,,,,
Promotion Ad Extension,Active,-25,0,,,ClientIdGoesHere,,English,,12/31/2021,,,(Monday[09:00-21:00]),FALSE,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,shoes,None,20000000,,SAVE20,,WomensDay,,12/31/2021,USD
Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkPromotionAdExtension , 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 BulkPromotionAdExtension
var bulkPromotionAdExtension = new BulkPromotionAdExtension
{
// '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
// PromotionAdExtension object of the Campaign Management service.
PromotionAdExtension = new PromotionAdExtension
{
// 'Id' column header in the Bulk file
Id = promotionAdExtensionIdKey,
// 'Currency Code' column header in the Bulk file
CurrencyCode = "USD",
// 'Discount Modifier' column header in the Bulk file
DiscountModifier = PromotionDiscountModifier.None,
// 'Language' column header in the Bulk file
Language = "English",
// 'Money Amount Off' column header in the Bulk file
MoneyAmountOff = null,
// 'Orders Over Amount' column header in the Bulk file
OrdersOverAmount = null,
// 'Percent Off' column header in the Bulk file
PercentOff = 20000000,
// 'Promotion Code' column header in the Bulk file
PromotionCode = "SAVE20",
// 'Promotion Target' column header in the Bulk file
PromotionItem = "shoes",
// 'Occasion' column header in the Bulk file
PromotionOccasion = PromotionOccasion.WomensDay,
// 'Promotion End' column header in the Bulk file
PromotionEndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
{
Month = 12,
Day = 31,
Year = DateTime.UtcNow.Year + 1
},
// 'Promotion Start' column header in the Bulk file
PromotionStartDate = null,
// '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"
},
// '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"
},
// '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(bulkPromotionAdExtension);
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 promoción , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
- Programación de anuncios
- Id. de cliente
- Código de moneda
- Parámetro personalizado
- Modificador de descuento
- Ubicación editorial
- Código de motivo editorial
- Estado editorial
- Término editorial
- Fecha de finalización
- Final Url
- Sufijo de dirección URL final
- Id
- Language
- Mobile Final Url
- Tiempo de modificación
- Cantidad de dinero fuera
- Ocasión
- Pedidos por encima del importe
- Parent Id
- Países editores
- Código de promoción
- Finalización de la promoción
- Inicio de promoción
- Destino de promoción
- Fecha de inicio
- Estado
- Plantilla de seguimiento
- 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, 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
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
Código de moneda
Código de moneda para el precio o descuento de la promoción.
Este campo solo es aplicable si establece Money Amount Off o Orders Over Amount.
Los códigos de moneda admitidos son ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, GBP, HKD, INR, MXN, NZD, PEN, PHP, PLN, SEK, SGD, USD, TWD y VEF.
Añadir: Obligatorio si se establece Money Amount Off o Orders Over Amount .
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece Porcentaje desactivado o Código de promoción, esta configuración ya no es aplicable y se eliminará.
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
Modificador de descuento
Modificador de descuento de promoción.
Los valores posibles para este campo son None y UpTo.
- Ninguno: el descuento de promoción no se modifica.
- UpTo: el descuento de promoción se modifica con el prefijo de cadena "Hasta". Por ejemplo, si el descuento de promoción sin modificar sería "$20$ de descuento en zapatos", la promoción modificada es "Hasta $20 de descuento en zapatos".
Añadir: Opcional. Si no especifica este campo o lo deja vacío, se establecerá el valor predeterminado Ninguno .
Actualizar: Opcional. 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.
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: Obligatorio
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 promoción de grupo de anuncios y Extensión de anuncio de promoción 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
Idioma
Idioma en el que se proporcionará la extensión del anuncio.
La extensión siempre se servirá en este idioma, independientemente de la configuración de idioma de la campaña o del grupo de anuncios.
Las cadenas de idioma admitidas son: danés, holandés, inglés, finés, francés, alemán, italiano, noruego, portugués, español, sueco y tradicional chino.
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
Cantidad de dinero fuera
El dinero de la promoción.
Por ejemplo, para promover "$20 off shoes - On orders over $100", establezca el objetivo de promoción en "shoes", establezca Código de moneda en "USD", establezca Money Amount Off en 20 y orders Over Amount en 100.
Añadir: Obligatorio. Debe establecer Money Amount Off o Percent Off, pero no puede establecer ambos.
Actualizar: Opcional. Puede establecer Money Amount Off o Percent Off, pero no puede establecer ambos.
Eliminar: Solo lectura
Ocasión
La ocasión de promoción.
Los campos Ocasión y Programación de la promoción (Programación de anuncios, Fecha de finalización, Fecha de inicio y Usar zona horaria del buscador ) determinan cuándo se puede mostrar la promoción en los anuncios.
La promoción Ocasión determina el período de tiempo o la estacionalidad, por ejemplo, WomensDay del 15 de febrero al 31 de marzo de cada año. La promoción solo se ejecutará dentro de las fechas correspondientes a la ocasión que establezca. Consulte la tabla siguiente para obtener más información sobre el intervalo de fechas definido para cada ocasión.
La programación puede limitar la promoción a un período de tiempo más corto dentro del intervalo de fechas de la ocasión, por ejemplo, limitar la promoción para que se ejecute del 20 de febrero al 8 de marzo. La programación también se puede usar para ejecutar la misma promoción varios años, por ejemplo, ejecutar la promoción WomensDay cada año del 15 de febrero al 31 de marzo.
Añadir: Opcional. Si no especifica este campo o lo deja vacío, se establecerá el valor predeterminado Ninguno .
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo, el inicio de la promoción y el final de la promoción también deben establecerse para conservar o actualizar la configuración anterior.
Eliminar: Solo lectura
Pedidos por encima del importe
Los pedidos sobre el valor de importe anexados al destino de promoción.
Por ejemplo, para promover "$20 off shoes - On orders over $100", establezca el objetivo de promoción en "shoes", establezca Código de moneda en "USD", establezca Money Amount Off en 20 y orders Over Amount en 100.
Añadir: Opcional. No se pueden establecer tanto los pedidos por encima de la cantidad como el código de promoción.
Actualizar: Opcional. No se pueden establecer tanto los pedidos por encima de la cantidad como el código de promoción. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en "0" (cero), se eliminará la configuración anterior.
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
Porcentaje desactivado
Porcentaje de descuento en el valor de promoción como valor doble.
Por ejemplo, 10,0 representa un descuento del 10 %.
Añadir: Obligatorio. Debe establecer Money Amount Off o Percent Off, pero no puede establecer ambos.
Actualizar: Opcional. Puede establecer Money Amount Off o Percent Off, pero no puede establecer ambos. Si establece este campo, el valor de Código de moneda ya no es aplicable y se eliminará si se estableció anteriormente.
Eliminar: Solo lectura
Código de promoción
Código de promoción anexado al destino de promoción.
Por ejemplo, para promover "$20 off shoes - Promocode SAVE20", establezca el destino de promoción en "shoes", establezca Código de moneda en "USD", establezca Money Amount Off en 20 y establezca Código de promoción en "SAVE20".
La cadena puede contener un máximo de 15 caracteres.
Añadir: Opcional. No se pueden establecer tanto los pedidos por encima de la cantidad como el código de promoción.
Actualizar: Opcional. No se pueden establecer tanto los pedidos por encima de la cantidad como el código de promoción. 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 eliminará la configuración anterior. Si establece este campo, el valor de Código de moneda ya no es aplicable y se eliminará si se estableció anteriormente.
Eliminar: Solo lectura
Finalización de la promoción
La fecha de finalización ayuda a informar de la fecha de promoción o las fechas que se mostrarán en el anuncio.
Por ejemplo, si las fechas de inicio y finalización de la promoción se establecen en el 14 de febrero, el texto "Válido 14 de febrero" podría incluirse en la promoción mostrada.
La fecha de inicio de la promoción debe ser anterior o igual a la fecha de finalización de la promoción.
Esta propiedad no invalida el intervalo de entrega inherente para una promoción. Los campos Ocasión y Programación de la promoción (Programación de anuncios, Fecha de finalización, Fecha de inicio y Usar zona horaria del buscador) determinan cuándo se puede mostrar la promoción en los anuncios.
Si la fecha de finalización ya ha pasado para el año actual, cada fecha de inicio y finalización debe establecerse para las fechas durante el año siguiente.
Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para eliminar la fecha de finalización actual y no establecer eficazmente ninguna fecha de finalización, establezca este campo en la cadena delete_value . Cuando recupere la extensión de anuncio de promoción la próxima vez, este campo no se establecerá.
Eliminar: Solo lectura
Inicio de promoción
La fecha de inicio ayuda a informar de la fecha de promoción o las fechas que se mostrarán en el anuncio.
Por ejemplo, si las fechas de inicio y finalización de la promoción se establecen en el 14 de febrero, el texto "Válido 14 de febrero" podría incluirse en la promoción mostrada.
La fecha de inicio de la promoción debe ser anterior o igual a la fecha de finalización de la promoción.
Esta propiedad no invalida el intervalo de entrega inherente para una promoción. Los campos Ocasión y Programación de la promoción (Programación de anuncios, Fecha de finalización, Fecha de inicio y Usar zona horaria del buscador) determinan cuándo se puede mostrar la promoción en los anuncios.
Si la fecha de finalización ya ha pasado para el año actual, cada fecha de inicio y finalización debe establecerse para las fechas durante el año siguiente.
Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para eliminar la fecha de finalización actual y no establecer eficazmente ninguna fecha de finalización, establezca este campo en la cadena delete_value . Cuando recupere la extensión de anuncio de promoción la próxima vez, este campo no se establecerá.
Eliminar: Solo lectura
Destino de promoción
Destino o elemento de promoción.
Por ejemplo, puede ejecutar una promoción para "zapatos" con un descuento del 20 % o del 20 %. Para ejecutar una promoción para "Hasta 20 USD de zapatos", establezca el destino de promoción en "zapatos", establezca el Modificador de descuento en "UpTo", establezca Código de moneda en "USD" y establezca Money Amount Off en 20.
La cadena puede contener un máximo de 20 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
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