Registro de extensión de anuncio del logotipo de campaña: masiva
Define un registro de asociación entre una campaña y una extensión de anuncio de logotipo que se puede cargar y descargar en un archivo masivo. Para cargar o descargar la extensión de anuncio de campaña o logotipo, usa el registro Campaña o Extensión de anuncio de logotipo .
Puede descargar todos los registros de extensión de anuncio del logotipo de campaña de la cuenta incluyendo el valor DownloadEntity de CampaignLogoAdExtensions 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 logotipo a una campaña si se proporcionan valores válidos de id . e id . primario.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name
Format Version,,,,,,,,6.0
Campaign Logo 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 BulkCampaignLogoAdExtension , 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 BulkCampaignLogoAdExtension
var bulkCampaignLogoAdExtension = new BulkCampaignLogoAdExtension
{
// 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 = logoAdExtensionIdKey,
// '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(bulkCampaignLogoAdExtension);
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 extensión de anuncio del logotipo 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
Campaña
Nombre de la campaña en la que se asocia o quita esta extensión de anuncio.
Agregar: Solo lectura y Obligatorio
Borrar: Solo lectura y Obligatorio
Nota:
Para agregar y eliminar, debe especificar el identificador principal o la 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
Borrar: Solo lectura
Ubicación editorial
Componente o propiedad de la extensión de anuncio que produjo un error en la revisión editorial.
Agregar: Solo lectura
Borrar: Solo lectura
Código de motivo editorial
Código que identifica el motivo del error. Para obtener una lista de posibles códigos de motivo, consulte Códigos de motivo editoriales.
Agregar: Solo lectura
Borrar: Solo lectura
Estado editorial
Estado editorial de la extensión del anuncio.
Los valores posibles se describen en la tabla siguiente.
Agregar: Solo lectura
Borrar: Solo lectura
Término editorial
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.
Agregar: Solo lectura
Borrar: Solo lectura
Id
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 del logotipo .
Agregar: 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 del logotipo 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.
Borrar: 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.
Agregar: Solo lectura
Borrar: Solo lectura
Parent Id
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 .
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 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.
Borrar: Solo lectura y Obligatorio
Nota:
Para agregar y eliminar, debe especificar el identificador principal o la campaña.
Países editores
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 (;).
Agregar: Solo lectura
Borrar: Solo lectura
Estado
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.
Agregar: Solo lectura
Borrar: Obligatorio. El estado debe establecerse en Eliminado.