Registro de sitio negativo del grupo de anuncios: masivo
Define un sitio negativo asignado a un grupo de anuncios que se puede cargar y descargar en un archivo masivo.
En el esquema masivo, cada uno de los sitios negativos asociados a un grupo de anuncios se representa individualmente mediante su propia fila. Por ejemplo, si tiene dos sitios negativos, se representan mediante dos registros de sitios negativos de grupo de anuncios 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 de sitios negativos del grupo de anuncios que siguen están activos.
Nota:
El sitio negativo del grupo de anuncios se puede agregar y eliminar, pero no se puede actualizar.
Puede descargar todos los registros de sitios negativos del grupo de anuncios de la cuenta incluyendo el valor DownloadEntity de AdGroupNegativeSites 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 del grupo de anuncios 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
Ad Group Negative Site,Active,,-1111,,,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 BulkAdGroupNegativeSite , 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 BulkAdGroupNegativeSites
var bulkAdGroupNegativeSites = new BulkAdGroupNegativeSites
{
// 'Ad Group' column header in the Bulk file
AdGroupName = null,
// Map properties in the Bulk file to the
// AdGroupNegativeSites object of the Campaign Management service.
AdGroupNegativeSites = new AdGroupNegativeSites
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
NegativeSites = new[]
{
// 'Website' column header in the Bulk file
"contoso.com",
}
},
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Status' column header in the Bulk file
Status = Status.Active,
};
// BulkAdGroupNegativeSites does not support 'Client Id' and
// replaces all negative sites for the ad group, whereas BulkAdGroupNegativeSite
// enables you to add or delete one negative site at a time.
// Map properties in the Bulk file to the BulkAdGroupNegativeSite
var bulkAdGroupNegativeSite = new BulkAdGroupNegativeSite
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
// 'Ad Group' column header in the Bulk file
AdGroupName = null,
// '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(bulkAdGroupNegativeSite);
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 grupo de anuncios , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
Grupo de anuncios
Nombre del grupo de anuncios 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 Grupo de anuncios .
Campaña
Nombre de la campaña que contiene el grupo de anuncios y el sitio negativo.
Agregar: Solo lectura
Actualizar: No aplicable. Se puede agregar y eliminar un sitio negativo, pero no se puede actualizar.
Borrar: 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.
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 del grupo de anuncios que contiene el sitio negativo.
Este campo masivo se asigna al campo Id del registro del grupo de anuncios .
Agregar: 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 agregar nuevos sitios negativos 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.
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 Grupo de anuncios .
Estado
Representa el estado de asociación entre el grupo de anuncios y el sitio negativo.
Si el sitio negativo está asociado al grupo de anuncios, 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 del grupo de anuncios, solo es necesario cargar el estado y el identificador primario 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