Leer en inglés

Compartir a través de


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.