Registro de sitio negativo de campaña: masivo
Define un sitio negativo asignado a una campaña que se puede cargar y descargar en un archivo masivo.
En el esquema masivo, cada uno de los sitios negativos asociados a una campaña se representa individualmente mediante su propia fila. Por ejemplo, si tiene dos sitios negativos, se representan mediante dos registros de sitio negativo de campaña en el archivo masivo con estado establecido en Activo. Al cargar o descargar registros de una lista actualizada de sitios negativos asociados, un registro tendrá estado establecido en Eliminado con un campo sitio web vacío. Esto indica que se han realizado algunos cambios en la lista y que los registros del sitio negativo de campaña que siguen están activos.
Nota:
El sitio negativo de campaña se puede agregar y eliminar, pero no se puede actualizar.
Puede descargar todos los registros del sitio negativo de campaña de la cuenta incluyendo el valor DownloadEntity de CampaignNegativeSites 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 sitio negativo de campaña si se proporciona un valor de Id. primario válido.
Type,Status,Id,Parent Id,Campaign,Ad Group,Website,Client Id,Modified Time,Name
Format Version,,,,,,,,,6.0
Campaign Negative Site,Active,,-112,,,contoso.com,ClientIdGoesHere,,
Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkCampaignNegativeSite , en lugar de llamar a las operaciones de 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 BulkCampaignNegativeSites
var bulkCampaignNegativeSites = new BulkCampaignNegativeSites
{
// 'Campaign' column header in the Bulk file
CampaignName = null,
// Map properties in the Bulk file to the
// CampaignNegativeSites object of the Campaign Management service.
CampaignNegativeSites = new CampaignNegativeSites
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
NegativeSites = new[]
{
// 'Website' column header in the Bulk file
"contoso.com",
}
},
// 'Status' column header in the Bulk file
Status = Status.Active,
};
// BulkCampaignNegativeSites does not support 'Client Id' and
// replaces all negative sites for the campaign, whereas BulkCampaignNegativeSite
// enables you to add or delete one negative site at a time.
// Map properties in the Bulk file to the BulkCampaignNegativeSite
var bulkCampaignNegativeSite = new BulkCampaignNegativeSite
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active,
// 'Website' column header in the Bulk file
Website = "contoso.com",
};
uploadEntities.Add(bulkCampaignNegativeSite);
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 sitio negativo de campaña , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
Campaña
Nombre de la campaña que contiene el sitio negativo.
Agregar: Solo lectura y Obligatorio
Actualizar: No aplicable. Se puede agregar y eliminar un sitio negativo, pero no se puede actualizar.
Borrar: Solo lectura y Obligatorio
Nota:
Para agregar y eliminar, debe especificar el campo Id. primario o 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.
Agregar: Opcional
Actualizar: No aplicable. Se puede agregar y eliminar un sitio negativo, pero no se puede actualizar.
Borrar: 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.
Agregar: Solo lectura
Actualizar: No aplicable. Se puede agregar y eliminar un sitio negativo, pero no se puede actualizar.
Borrar: Solo lectura
Parent Id
Identificador generado por el sistema de la campaña que contiene el sitio negativo.
Este campo masivo se asigna al campo Id del registro Campaña .
Agregar: Solo lectura y Obligatorio. Debe especificar un identificador de campaña existente o especificar un identificador negativo que sea igual al campo Id del registro de campaña primario. Esto se recomienda si va a agregar nuevos sitios negativos a una nueva campaña en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: No aplicable. Se puede agregar y eliminar un sitio negativo, pero no se puede actualizar.
Borrar: Solo lectura
Nota:
Para agregar y eliminar, debe especificar el campo Id. primario o Campaña .
Estado
Representa el estado de asociación entre la campaña y el sitio negativo.
Si el sitio negativo está asociado a la campaña, el valor de este campo es Activo.
Los valores posibles son Active o Deleted.
Agregar: Opcional. El valor predeterminado es Active.
Actualizar: No aplicable. Se puede agregar y eliminar un sitio negativo, pero no se puede actualizar.
Borrar: Obligatorio. El estado debe establecerse en Eliminado. Para eliminar un sitio negativo específico, debe cargar el estado, el identificador principal y el sitio web. Para eliminar todos los sitios negativos de la campaña, solo es necesario cargar el estado y el identificador principal en un único registro. A continuación, opcionalmente puede agregar nuevos registros de sitio negativos para reemplazar el conjunto eliminado.
Sitio web
La dirección URL del sitio web donde no desea que se muestren los anuncios.
Cada dirección URL debe especificar el nombre de dominio, por ejemplo, contoso.com que puede incluir hasta tres subdominios y dos subdirectorios. El recuento de subdominios incluye el prefijo www . Por ejemplo, one.two.three.contoso.com/1/2, www.two.three.contoso.com/1/2 y one.two.contoso.co.uk/1/2 son direcciones URL válidas, mientras que one.two.three.contoso.co.uk/1/2 (demasiados subdominios) y one.two.three.contoso.com/1/2/3 (demasiados subdirectorios) no lo son. No se permiten direcciones URL de sitio negativas duplicadas por campaña o grupo de anuncios.
Solo puede excluir sitios web para sitios web de búsqueda sindicada. La red del grupo de anuncios debe establecerse en OwnedAndOperatedAndSyndicatedSearch.
Las direcciones URL de sitio negativas especificadas en el nivel de grupo de anuncios se usan en lugar de las direcciones URL de sitio negativas especificadas en el nivel de campaña. Si asocias listas de exclusión de sitios web a una cuenta publicitaria (disponible a través del servicio Administración de campañas), la lista de sitios negativos se usa además de los sitios negativos de la campaña o los sitios negativos del grupo de anuncios.
Agregar: Obligatorio
Actualizar: No aplicable. Se puede agregar y eliminar un sitio negativo, pero no se puede actualizar.
Borrar: Solo lectura