Registro de etiquetas: masiva
Define una etiqueta que se puede cargar y descargar en un archivo masivo.
Las etiquetas te permiten organizar campañas, grupos de anuncios, anuncios y palabras clave en grupos en función de lo que sea importante para ti. A continuación, puede filtrar y ejecutar informes en las etiquetas para obtener los datos más significativos para usted.
Puede descargar todos los registros label de la cuenta incluyendo el valor DownloadEntity de Labels 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 etiqueta.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Label,,-22,,,,ClientIdGoesHere,,,Label Description,Label Name,#FFFFFF
Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkLabel , en lugar de llamar directamente a las operaciones del 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 BulkLabel
var bulkLabel = new BulkLabel
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// Label object of the Campaign Management service.
Label = new Label
{
// 'Color' column header in the Bulk file
ColorCode = "#FFFFFF",
// 'Description' column header in the Bulk file
Description = "Label Description",
// 'Id' column header in the Bulk file
Id = labelIdKey,
// 'Label' column header in the Bulk file
Name = "Label Name " + DateTime.UtcNow
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkLabel);
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 etiqueta , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
Color
Color de etiqueta como código hexadecimal.
El valor hexadecimal debe tener el prefijo '#'. Por ejemplo, puede usar el valor de #FFFFFF para una etiqueta blanca.
El color se puede ver en la aplicación web de Microsoft Advertising. La aplicación puede mostrar el color o usar el valor hexadecimal para clasificar un conjunto de etiquetas.
Añadir: Opcional. Si no especifica ningún color, el valor se asignará de forma aleatoria para cada etiqueta.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Puede actualizar el código de color, pero no puede quitarlo.
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 de la etiqueta.
La descripción de la etiqueta puede tener entre 1 y 200 caracteres.
Añadir: Opcional
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 etiqueta.
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 etiqueta en el campo Id. primario de tipos de registro dependientes, como Etiqueta de campaña. Esto se recomienda si va a agregar una nueva etiqueta 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
Etiqueta
Nombre de la etiqueta.
El nombre de la etiqueta que distingue mayúsculas de minúsculas puede tener entre 1 y 80 caracteres de longitud y debe ser único en todas las etiquetas de la cuenta.
Añadir: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
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
Estado
Estado de la etiqueta.
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.