Compartir a través de

Registro de anuncios de producto: masivo

  • Artículo

Define un anuncio de producto que se puede descargar y cargar en un archivo masivo.

Un anuncio de producto no se usa directamente para la copia del anuncio entregado. En su lugar, el motor de entrega genera anuncios de productos a partir de los detalles del producto que encuentra en el catálogo de la tienda Microsoft Merchant Center del cliente.

Puede descargar todos los registros de Product Ad de la cuenta incluyendo el valor DownloadEntity de ProductAds 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 anuncio de producto si se proporciona un valor de Id. primario válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Product Ad,Active,,-1112,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,,,Find New Customers & Increase Sales!,,,,,,,,,,,,,

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkProductAd , en lugar de llamar a las operaciones del 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 BulkProductAd
var bulkProductAd = new BulkProductAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ProductAd object of the Campaign Management service.
    ProductAd = new ProductAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Promotion' column header in the Bulk file
        PromotionalText = "Find New Customers & Increase Sales!",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
    },
};

uploadEntities.Add(bulkProductAd);

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 anuncio de producto , 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 anuncio.

Agregar: Solo lectura y Obligatorio
Actualizar: Solo lectura y Obligatorio
Borrar: Solo lectura y Obligatorio

Nota:

Para agregar, actualizar 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 anuncio.

Agregar: Solo lectura
Actualizar: Solo lectura
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: Opcional
Borrar: Solo lectura

Estado de la apelación editorial

Determina si puede apelar los problemas encontrados por la revisión editorial.

Los valores posibles se describen en la tabla siguiente.

Valor Descripción
Apelable El tema editorial es atractivo.
AppealPending El tema editorial es apelable y se ha presentado una apelación.
NotAppealable El tema editorial no es atractivo.

Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: Solo lectura

Ubicación editorial

Componente o propiedad del anuncio que no pudo revisar editorialmente.

Agregar: Solo lectura
Actualizar: 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
Actualizar: Solo lectura
Borrar: Solo lectura

Estado editorial

Estado editorial del anuncio.

Los valores posibles se describen en la tabla siguiente.

Valor Descripción
Activo El anuncio superó la revisión editorial.
ActiveLimited El anuncio superó la revisión editorial en uno o varios mercados, y uno o varios elementos del anuncio están siendo revisados editorialmente en otro mercado. Por ejemplo, el anuncio pasó la revisión editorial para Canadá y todavía está pendiente de revisión en el Estados Unidos.
Desaprobó El anuncio falló en la revisión editorial.
Inactivo Uno o varios elementos del anuncio se están revisando editorialmente.

Agregar: Solo lectura
Actualizar: 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
Actualizar: Solo lectura
Borrar: Solo lectura

Id

Identificador generado por el sistema del anuncio.

Agregar: Opcional. Debe dejar este campo vacío o especificar un identificador negativo. A continuación, se puede hacer referencia a un identificador negativo establecido para el anuncio en el campo Id. primario de tipos de registro dependientes, como Etiqueta de anuncio de producto. Esto se recomienda si va a agregar nuevos anuncios y nuevos registros dependientes en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura y Obligatorio
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
Actualizar: Solo lectura
Borrar: Solo lectura

Parent Id

Identificador generado por el sistema del grupo de anuncios que contiene el anuncio.

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 anuncios 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: Solo lectura
Borrar: Solo lectura

Nota:

Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .

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
Actualizar: Solo lectura
Borrar: Solo lectura

Estado

Estado del anuncio.

Nota:

A partir del 3 de diciembre de 2024, la operación de eliminación ya no se admitirá en bulk API para los registros de anuncios de producto. Esto se debe a que la entidad de anuncio del producto se genera mediante el sistema.

Los valores posibles son Active, Paused o Deleted.

Agregar: Opcional. El valor predeterminado es Active.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Obligatorio. El estado debe establecerse en Eliminado.