Registro de anuncios de texto: masivo
Define un anuncio de texto que se puede descargar y cargar en un archivo masivo.
Importante
A partir de abril de 2020, no se admite la entrega de anuncios de texto standart (STA).
Los anuncios de texto estándar han quedado en desuso a favor de los anuncios de texto expandido (EXTA). La compatibilidad con la adición y actualización de anuncios de texto estándar (STA) finalizó el 31 de julio de 2017. Ahora, los anunciantes pueden obtener y eliminar, pero ya no pueden agregar nuevas AEA ni actualizar los anuncios de texto estándar existentes. Una excepción a la regla es que todavía puede actualizar el estado STA, por ejemplo, de Activo a Pausado. De lo contrario, los intentos de agregar o actualizar LASA producirán el error CampaignServiceAdTypeInvalid .
Puede descargar todos los registros de Text Ad de la cuenta incluyendo el valor DownloadEntity de TextAds 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 de texto si se proporciona un valor de Id. primario válido.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Text Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,contoso.com,,,All,False,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,,,,
Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkTextAd , en lugar de llamar directamente a las operaciones del servicio y escribir código personalizado para analizar cada campo del archivo masivo.
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkTextAd
var bulkTextAd = new BulkTextAd
{
// '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
// TextAd object of the Campaign Management service.
TextAd = new TextAd
{
// 'Ad Format Preference' column header in the Bulk file
AdFormatPreference = "All",
// 'Destination Url' column header in the Bulk file
DestinationUrl = null,
// 'Device Preference' column header in the Bulk file
DevicePreference = 0,
// 'Display Url' column header in the Bulk file
DisplayUrl = "contoso.com",
// '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"
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdStatus.Active,
// 'Text' column header in the Bulk file
Text = "Find New Customers & Increase Sales!",
// 'Title' column header in the Bulk file
Title = "Contoso Quick Setup",
// '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(bulkTextAd);
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 text ad , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
- Preferencia de formato de anuncio
- Grupo de anuncios
- Campaña
- Id. de cliente
- Parámetro personalizado
- Preferencia de dispositivo
- Dirección URL para mostrar
- Estado de la apelación editorial
- Ubicación editorial
- Código de motivo editorial
- Estado editorial
- Término editorial
- Final Url
- Id
- Mobile Final Url
- Tiempo de modificación
- Parent Id
- Países editores
- Estado
- Texto
- Title
- Plantilla de seguimiento
Preferencia de formato de anuncio
El campo Preferencia de formato de anuncio se usa para indicar si prefieres que la copia del anuncio se muestre a los usuarios como un anuncio de búsqueda o de audiencia. Los anuncios de búsqueda tienden a escribirse como una llamada a la acción, mientras que los anuncios de audiencia deben escribirse con un estilo más informativo. Aunque tienes la opción de usar anuncios de texto de búsqueda como anuncios de audiencia, designar un anuncio como formato preferido de anuncios de audiencia te permite optimizar su mensajería para la entrega nativa.
Importante
Debes definir al menos un anuncio de texto por grupo de anuncios que no prefiera anuncios de audiencia; de lo contrario, la copia de anuncios de todos los anuncios de texto será apta para anuncios de búsqueda y de audiencia.
Los valores posibles son Audience Ad y All. Si se establece en Todo, el anuncio será apto para los formatos de anuncios de búsqueda y audiencia. Si se establece en Audience Ad, el anuncio solo será apto para el formato de anuncio de audiencia.
Añadir: No compatible
Actualizar: No compatible
Eliminar: Solo lectura
Grupo de anuncios
Nombre del grupo de anuncios que contiene el anuncio.
Añadir: No compatible
Actualizar: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio
Nota:
Para actualizar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .
Campaña
Nombre de la campaña que contiene el grupo de anuncios y el anuncio.
Añadir: No compatible
Actualizar: Solo lectura
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: No compatible
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 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.
Añadir: No compatible
Actualizar: No compatible
Eliminar: Solo lectura
Preferencia de dispositivo
Este campo determina si la preferencia es que los anuncios de texto se muestren en todos los dispositivos o solo en dispositivos móviles.
Los valores posibles son All y Mobile, que difieren de los valores usados en el servicio de administración de campañas.
SixMonths
En el archivo de resultados de carga y descarga masiva, este campo nunca estará vacío. Si no especificó una preferencia de dispositivo, se devolverá el valor predeterminado de Todo .
Importante
Debes definir al menos un anuncio de texto por grupo de anuncios que no sea el preferido para dispositivos móviles; de lo contrario, la copia de anuncios de todos los anuncios de texto será apta para todos los dispositivos.
Añadir: No compatible
Actualizar: No compatible
Eliminar: Solo lectura
Dirección URL para mostrar
Dirección URL que se va a mostrar en el anuncio.
El subdirectorio de la dirección URL para mostrar puede contener cadenas de texto dinámicas, como {keyword}; sin embargo, el nombre de host de la dirección URL no puede contener texto dinámico. Para obtener más información, consulte el artículo de ayuda de Microsoft Advertising Personalización automática de los anuncios con parámetros de texto dinámico.
La longitud máxima de entrada de la dirección URL es de 200 caracteres y puede contener cadenas de texto dinámicas. Sin embargo, el anuncio no se mostrará si la dirección URL supera los 35 caracteres después de que se produzca la sustitución dinámica de texto.
Añadir: No compatible
Actualizar: No compatible
Eliminar: 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 |
|---|---|
| Atractivo | 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. |
Añadir: No compatible
Actualizar: Solo lectura
Eliminar: Solo lectura
Ubicación editorial
Componente o propiedad del anuncio que no pudo revisar editorialmente.
Añadir: No compatible
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: No compatible
Actualizar: Solo lectura
Eliminar: Solo lectura
Estado editorial
Estado editorial del anuncio.
Los valores posibles se describen en la tabla siguiente.
Añadir: No compatible
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: No compatible
Actualizar: Solo lectura
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 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.
Añadir: No compatible
Actualizar: No compatible
Eliminar: Solo lectura
Id
Identificador generado por el sistema del 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 el anuncio en el campo Id. primario de tipos de registro dependientes, como Text Ad Label. 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
Eliminar: Solo lectura y Obligatorio
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.
Añadir: No compatible
Actualizar: No compatible
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: No compatible
Actualizar: Solo lectura
Eliminar: 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 .
Añadir: No compatible
Actualizar: Solo lectura
Eliminar: Solo lectura
Nota:
Para 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 (;).
Añadir: No compatible
Actualizar: Solo lectura
Eliminar: Solo lectura
Estado
Estado del anuncio.
Los valores posibles son Active, Paused o Deleted.
Añadir: No compatible
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.
Texto
La copia del anuncio.
El texto debe contener al menos una palabra y puede contener cadenas de texto dinámicas como {keyword}. Para obtener más información, consulte el artículo de ayuda de Microsoft Advertising Personalización automática de los anuncios con parámetros de texto dinámico.
La longitud máxima de entrada de la copia es de 300 caracteres y puede contener cadenas de texto dinámicas. El anuncio no se mostrará o se usará texto predeterminado si la longitud supera los 80 caracteres después de que se produzca la sustitución dinámica de texto. Tenga en cuenta que para los grupos de anuncios que usan chino tradicional, la longitud máxima de entrada de la copia es de 150 caracteres y el texto se limita a 40 caracteres después de la sustitución.
El texto no puede contener el carácter de nueva línea (\n).
Añadir: No compatible
Actualizar: No compatible
Eliminar: Solo lectura
Cargo
El título del anuncio.
El título debe contener al menos una palabra. La copia y el título combinados del anuncio deben totalizar al menos tres palabras.
El título puede contener cadenas de texto dinámicas como {keyword}. Para obtener más información, consulte el artículo de ayuda de Microsoft Advertising Personalización automática de los anuncios con parámetros de texto dinámico.
La longitud máxima de entrada del título es de 80 caracteres y puede contener cadenas de texto dinámicas. El anuncio no se mostrará o se usará texto predeterminado si la longitud supera los 25 caracteres después de que se produzca la sustitución dinámica de texto. Tenga en cuenta que para los grupos de anuncios que usan chino tradicional, el título se limita a 15 caracteres después de la sustitución.
El título no puede contener el carácter de nueva línea (\n).
Añadir: No compatible
Actualizar: No compatible
Eliminar: 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.
Añadir: No compatible
Actualizar: No compatible
Eliminar: Solo lectura