Registro de extensión de anuncio de ubicación de campaña: masiva
Define un registro de asociación entre una campaña y una extensión de anuncio de ubicación que se puede cargar y descargar en un archivo masivo. Para cargar o descargar la extensión de anuncio de campaña o ubicación, use el registro Campaña o Extensión de anuncio de ubicación .
Puede descargar todos los registros de extensión de anuncio de ubicación de campaña de la cuenta incluyendo el valor DownloadEntity de CampaignLocationAdExtensions 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 asociaría una extensión de anuncio de ubicación a una campaña si se proporcionan valores válidos id . e Id. primario .
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name
Format Version,,,,,,,,6.0
Campaign Location Ad Extension,Active,-11,-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 BulkCampaignLocationAdExtension , 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 BulkCampaignLocationAdExtension
var bulkCampaignLocationAdExtension = new BulkCampaignLocationAdExtension
{
// Map properties in the Bulk file to the
// AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
{
// 'Id' column header in the Bulk file
AdExtensionId = locationAdExtensionIdKey,
// 'Parent Id' column header in the Bulk file
EntityId = campaignIdKey,
},
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active,
};
uploadEntities.Add(bulkCampaignLocationAdExtension);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
En el caso de un registro de extensión de anuncio de ubicación de campaña, los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
- Campaña
- Id. de cliente
- Ubicación editorial
- Código de motivo editorial
- Estado editorial
- Término editorial
- Id
- Tiempo de modificación
- Parent Id
- Países editores
- Estado
Nombre de la campaña en la que se asocia o quita esta extensión de anuncio.
Añadir: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio
Nota
Para agregar y eliminar, debe especificar el identificador principal o la campaña.
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
Componente o propiedad de la extensión de anuncio que produjo un error en la revisión editorial.
Añadir: Solo lectura
Eliminar: Solo lectura
Código que identifica el motivo del error. Para obtener una lista de posibles códigos de motivo, consulte Códigos de motivo editoriales.
Añadir: Solo lectura
Eliminar: Solo lectura
Estado editorial de la extensión del anuncio.
Los valores posibles se describen en la tabla siguiente.
Añadir: Solo lectura
Eliminar: Solo lectura
El término que falló en la revisión editorial.
Este campo no se establecerá si una combinación de términos produjo el error o si el error se basó en una infracción de directiva.
Añadir: Solo lectura
Eliminar: Solo lectura
Identificador de la extensión de anuncio asociada o eliminada de la campaña.
Este campo masivo se asigna al campo Id del registro Extensión de anuncio de ubicación .
Añadir: Solo lectura y Obligatorio. Debe especificar un identificador de extensión de anuncio existente o especificar un identificador negativo que sea igual al campo Id del registro de extensión de anuncio de ubicación primario. Esto se recomienda si va a agregar nuevas extensiones y asociaciones 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
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
Identificador de la campaña en la que se asocia o quita esta extensión de anuncio.
Este campo masivo se asigna al campo Id del registro Campaña .
Añadir: 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 asociar extensiones de anuncio 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.
Eliminar: Solo lectura y Obligatorio
Nota
Para agregar y eliminar, debe especificar el identificador principal o la campaña.
Lista de países o regiones del publicador cuyas directrices editoriales no permiten el término especificado.
En un archivo masivo, la lista de países o regiones del publicador se delimita con un punto y coma (;).
Añadir: Solo lectura
Eliminar: Solo lectura
Representa el estado de asociación entre la campaña y la extensión del anuncio.
Los valores posibles son Active y Deleted. Si la extensión del anuncio está asociada a la campaña, el valor de este campo es Activo.
Añadir: Solo lectura
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.