Registro de etiqueta de grupo de anuncios: masivo
Define un registro de asociación entre un grupo de anuncios y una etiqueta que se puede cargar y descargar en un archivo masivo. Para cargar o descargar el grupo de anuncios o la etiqueta, use el registro Grupo de anuncios o Etiqueta .
Puede descargar todos los registros de etiquetas de grupo de anuncios de la cuenta incluyendo el valor DownloadEntity de AdGroupLabels 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 aplicaría una etiqueta a un grupo de anuncios si se proporcionan valores válidos id . e id . primario.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Ad Group Label,,-22,-1111,,,ClientIdGoesHere,,,,,
Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkAdGroupLabel , en lugar de llamar a las operaciones del servicio directamente 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 BulkAdGroupLabel
var bulkAdGroupLabel = new BulkAdGroupLabel
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// LabelAssociation object of the Campaign Management service.
LabelAssociation = new LabelAssociation
{
// 'Parent Id' column header in the Bulk file
EntityId = adGroupIdKey,
// 'Id' column header in the Bulk file
LabelId = labelIdKey
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkAdGroupLabel);
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 de grupo de anuncios , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
Nota:
Los campos Grupo de anuncios y Campaña no se devuelven en el archivo de descarga.
Grupo de anuncios
Nombre del grupo de anuncios donde se aplica o quita esta etiqueta.
Añadir: Solo lectura
Eliminar: Solo lectura
Nota:
Para agregar y eliminar, debe especificar el Identificador primario o los campos Grupo de anuncios y Campaña .
Campaña
Nombre de la campaña que contiene el grupo de anuncios donde se aplica o quita esta etiqueta.
Añadir: Solo lectura
Eliminar: Solo lectura
Nota:
Para agregar y eliminar, debe especificar el Identificador primario o los campos Grupo de anuncios y Campaña . Para la descarga masiva, no se devuelven los campos Grupo de anuncios y Campaña .
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
Eliminar: Solo lectura
Id
Identificador de la etiqueta que se aplica o quita del grupo de anuncios.
Este campo masivo se asigna al campo Id del registro Label .
Añadir: Solo lectura y Obligatorio. Debe especificar un identificador de etiqueta existente o especificar un identificador negativo que sea igual al campo Id del registro label primario. Esto se recomienda si va a aplicar nuevas etiquetas a grupos de anuncios en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Eliminar: Solo lectura y Obligatorio
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
Eliminar: Solo lectura
Parent Id
Identificador del grupo de anuncios donde se aplica o quita esta etiqueta.
Este campo masivo se asigna al campo Id del registro del grupo de anuncios .
Añadir: Solo lectura y Obligatorio. Debe especificar un identificador de grupo de anuncios existente o especificar un identificador negativo que sea igual al campo Id del registro del grupo de anuncios primario. Esto se recomienda si va a aplicar etiquetas a un nuevo grupo de anuncios en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Eliminar: Solo lectura y Obligatorio
Nota:
Para agregar y eliminar, debe especificar el Identificador primario o los campos Grupo de anuncios y Campaña . Para la descarga masiva, no se devuelven los campos Grupo de anuncios y Campaña .
Estado
Representa el estado aplicado entre el grupo de anuncios y la etiqueta.
Los valores posibles son Active y Deleted. Si la etiqueta se aplica al grupo de anuncios, el valor de este campo es Activo.
Añadir: Solo lectura
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.