Compartir a través de

Registro de ámbito de producto de campaña: masiva

  • Artículo

Define un ámbito de producto de nivel de campaña con una lista de condiciones que ayudan a determinar qué elementos del catálogo se incluirán en la campaña, por ejemplo, filtrar por marca o condición.

Puedes usar los ámbitos de producto de campaña con las campañas de Shopping y las campañas de audiencia basadas en fuentes, es decir, aquellas campañas que aprovechan un identificador de tienda de Microsoft Merchant Center. El ámbito del producto le permite elegir qué elementos de su catálogo incluir en la campaña, por ejemplo, filtrar por marca o condición.

Sugerencia

Para obtener información general y más información sobre las campañas de compras de Microsoft, consulte la guía técnica anuncios de productos.

Nota:

Las condiciones de ámbito de producto de nivel de campaña no son compatibles con las campañas de Smart Shopping , es decir, las campañas con tipo de campaña establecido en Shopping y Subtipo establecido en ShoppingSmartAds.

Puede descargar todos los registros de ámbito de producto de campaña de la cuenta incluyendo el valor DownloadEntity de CampaignProductScopes 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 ámbito de producto de campaña si se proporciona un valor de Id. primario válido.

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Product Condition 1,Product Value 1,Product Condition 2,Product Value 2,Product Condition 3,Product Value 3,Product Condition 4,Product Value 4,Product Condition 5,Product Value 5,Product Condition 6,Product Value 6,Product Condition 7,Product Value 7,Is Excluded,Parent Criterion Id,Tracking Template,Custom Parameter
Format Version,,,,,,,,,,6.0,,,,,,,,,,,,,,,,,,
Campaign Product Scope,Active,,-113,,,,ClientIdGoesHere,,,,Condition,New,CustomLabel0,MerchantDefinedCustomLabel,,,,,,,,,,,,,,

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkCampaignProductScope , 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 BulkCampaignProductScope
var bulkCampaignProductScope = new BulkCampaignProductScope
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // SharedEntityAssociation object of the Campaign Management service.
    CampaignCriterion = new CampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new ProductScope
        {
            // Conditions are mapped to Product Value 1..7 and Product Condition 1..7 columns
            Conditions = new []
            {
                new ProductCondition
                {
                    // 'Product Value 1' column header in the Bulk file
                    Attribute = "New",
                    // 'Product Condition 1' column header in the Bulk file
                    Operand = "Condition",
                    // 'Product Operator 1' column header in the Bulk file
                    Operator = "Operator",
                },
                new ProductCondition
                {
                    // 'Product Value 2' column header in the Bulk file
                    Attribute = "MerchantDefinedCustomLabel",
                    // 'Product Condition 2' column header in the Bulk file
                    Operand = "CustomLabel0",
                    // 'Product Operator 2' column header in the Bulk file
                    Operator = "Operator",
                },
            },
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },

    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignProductScope);

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 ámbito de producto 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 ámbito del producto.

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

Id

Identificador generado por el sistema del ámbito del producto.

Agregar: Solo lectura
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 de la campaña que contiene el ámbito del producto.

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 ámbitos de producto 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: Solo lectura
Borrar: Solo lectura

Nota:

Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Campaña .

Condición del producto 1

Operando de la condición. Los operandos incluyen implícitamente el operador igual. Por ejemplo, puede leer Marca como Brand=.

Use cada condición de producto como operando para el valor de producto correspondiente.

Condición del producto (operando) Valor del producto (atributo) Operador product (operador)
Condición del producto 1 Valor del producto 1 Operador de producto 1
Condición del producto 2 Valor del producto 2 Operador de producto 2
Condición del producto 3 Valor del producto 3 Operador de producto 3
Condición del producto 4 Valor del producto 4 Operador de producto 4
Condición del producto 5 Valor del producto 5 Operador de producto 5
Condición del producto 6 Valor del producto 6 Operador de producto 6
Condición del producto 7 Valor del producto 7 Operador de producto 7

Cada condición se cumple si el valor del atributo del producto es igual al valor del atributo del operando. Por ejemplo, si el operando se establece en Marca y el atributo se establece en Contoso, se cumple la condición si el valor del atributo Brand del catálogo de productos es igual a Contoso.

Nota:

Para agregar y actualizar, se requiere al menos una condición de producto y un par de valores, y el número de índice no tiene relevancia. Por ejemplo, puede especificar valores válidos para product condition 2 y product value 2 y dejar vacíos los campos de condición y valor restantes.

Agregar: Opcional
Actualizar: Solo lectura. No se pueden actualizar los campos de condición o valor. Para actualizar las condiciones, debe eliminar el ámbito del producto y agregar uno nuevo.
Borrar: Solo lectura

Para obtener información sobre la condición de producto (operando) y el valor del producto (atributo) por tipo de campaña, consulte las tablas siguientes.

Condiciones del producto para campañas de Feed-Based audiencia

Se pueden especificar varias condiciones de producto para cada campaña de audiencia basada en fuentes. Cada condición se cumple si el valor del atributo del producto es igual al valor del atributo del operando. Por ejemplo, si el operando se establece en Marca y el atributo se establece en Contoso, se cumple la condición si el valor del atributo Brand del catálogo de productos es igual a Contoso.

Condición del producto (operando) Descripción del valor del producto (atributo) Reglas de negocios
Marca Fabricante, marca o editor del producto.

Un máximo de 1000 caracteres.		 El operando Marca solo se puede especificar una vez por filtro de ámbito de producto de campaña.
Condición Condición del producto.

Si el operando se establece en Condición, los valores de atributo admitidos que puede especificar son New, Used y Refurbished.		 El operando Condición solo se puede especificar una vez por filtro de ámbito de producto de campaña.
ProductType1-5

Hay cinco valores de operando de tipo de producto disponibles, es decir, ProductType1, ProductType2, ProductType3, ProductType4 y ProductType5.		 Tipo de producto o categoría definido por el comerciante.

ProductType1 es el tipo de producto de nivel más alto y ProductType5 es el nivel más bajo o el tipo de producto más granular.

Un máximo de 100 caracteres.		 Cada uno de los operandos de tipo de producto se puede usar una vez por filtro de ámbito de producto de campaña.

Si establece el operando en un tipo de producto de 1 a 5, se deben especificar en orden ascendente. Por ejemplo, el operando se puede establecer en "ProductType2" con el atributo "Pet Supplies", si una partición de producto de nivel superior tiene operando "ProductType1" con el atributo "Animals & Pet Supplies".
CustomLabel0-4

Hay cinco valores de operando de etiqueta personalizados disponibles, como CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 y CustomLabel4.		 Etiqueta personalizada definida por el comerciante.

Las etiquetas personalizadas, por ejemplo, CustomLabel0 y CustomLabel4, no se validan en función de ninguna jerarquía.

Un máximo de 100 caracteres.		 Cada uno de los operandos CustomLabel se puede usar una vez por filtro de ámbito de producto de campaña.

Condiciones del producto para campañas de compra

Se pueden especificar varias condiciones de producto para cada campaña y grupo de anuncios de Microsoft Shopping. Cada condición se cumple si el valor del atributo del producto es igual al valor del atributo del operando. Por ejemplo, si el operando se establece en Marca y el atributo se establece en Contoso, se cumple la condición si el valor del atributo Brand del catálogo de productos es igual a Contoso.

En las campañas de Shopping, las condiciones del producto se pueden establecer en el nivel de campaña y grupo de anuncios. En la tabla siguiente se describen las reglas de negocio Condición del producto (operando) y Valor del producto (atributo) para los registros Ámbito de producto de campaña y Partición de producto del grupo de anuncios .

Condición del producto (operando) Descripción del valor del producto (atributo) Reglas de ámbito de producto de campaña Reglas de partición de producto de grupo de anuncios
todas Debe ser null. No procede. Para las particiones de producto de un grupo de anuncios, el nodo raíz debe tener el operando establecido en "All" y el atributo establecido en null o vacío.
Marca Fabricante, marca o editor del producto.

Un máximo de 1000 caracteres.		 El operando Marca solo se puede especificar una vez por filtro de ámbito de producto de campaña. El operando Brand se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
CategoryL1-5

Hay cinco valores de operando de categoría disponibles, es decir, CategoryL1, CategoryL2, CategoryL3, CategoryL4 y CategoryL5.		 Categoría de producto definida por la tienda de Microsoft Merchant Center.

CategoryL0 es la categoría de nivel más alto y CategoryL4 es el nivel más bajo o la categoría más granular.

Un máximo de 100 caracteres.		 Cada uno de los operandos CategoryL se puede usar una vez por filtro de ámbito de producto de campaña.

Si especifica una condición de producto con el operando establecido en una categoría de producto de 1 a 5,
deben especificarse en orden ascendente. Por ejemplo, puede establecer el operando en "CategoryL2" con el atributo "Pet Supplies", si una condición de producto anterior tiene el operando "CategoryL1" con el atributo "Animals & Pet Supplies".		 Cada uno de los operandos CategoryL se puede usar en varias ramas, pero solo se puede especificar una vez por rama. Por ejemplo, una rama puede contener CategoryL1 y CategoryL2, pero puede que no contenga otro nodo con el operando CategoryL2.

Si establece el operando en una categoría de producto de 1 a 5, se deben especificar en orden ascendente. Por ejemplo, el operando se puede establecer en "CategoryL2" con el atributo "Pet Supplies", si una partición de producto de nivel superior tiene operando "CategoryL1" con el atributo "Animals & Pet Supplies".

No es necesario especificar el operando de categoría de producto de nivel anterior en la partición primaria inmediata. Por ejemplo, se podría especificar una condición CategoryL2 para una partición de producto si el elemento primario de su elemento primario especificaba una condición CategoryL1.
Canal El canal anuncios de inventario local (LIA).

Entre los valores posibles se incluyen "Tiendas locales" y "En línea".

Si la campaña no ha optado por anuncios de inventario local, todas las ofertas son de forma predeterminada solo en línea (Channel=Online) y un solo canal (ChannelExclusivity=Single-channel). Para obtener más información, consulta la página de ayuda de Anuncios de inventario local .		 El operando channel solo se puede especificar una vez por filtro de ámbito de producto de campaña. El operando channel se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
ChannelExclusivity Exclusividad del canal anuncios de inventario local (LIA).

Entre los valores posibles se incluyen "Canal único" y "Multicanal".

Si la campaña no ha optado por anuncios de inventario local, todas las ofertas son de forma predeterminada solo en línea (Channel=Online) y un solo canal (ChannelExclusivity=Single-channel). Para obtener más información, consulta la página de ayuda de Anuncios de inventario local .		 El operando ChannelExclusivity solo se puede especificar una vez por filtro de ámbito de producto de campaña. El operando ChannelExclusivity se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
Condición Condición del producto.

Si el operando se establece en Condición, los valores de atributo admitidos que puede especificar son New, Used y Refurbished.		 El operando Condición solo se puede especificar una vez por filtro de ámbito de producto de campaña. El operando Condition se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
CustomLabel0-4

Hay cinco valores de operando de etiqueta personalizados disponibles, como CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 y CustomLabel4.		 Etiqueta personalizada definida por el comerciante.

Las etiquetas personalizadas, por ejemplo, CustomLabel0 y CustomLabel4, no se validan en función de ninguna jerarquía.

Un máximo de 100 caracteres.

Este operando no es aplicable a productos patrocinados.		 Cada uno de los operandos CustomLabel se puede usar una vez por filtro de ámbito de producto de campaña. Cada uno de los operandos CustomLabel se puede usar en varias ramas, pero solo se puede especificar una vez por rama. Por ejemplo, una rama puede contener CustomLabel0 y CustomLabel1, pero puede que no contenga otro nodo con el operando CustomLabel1 .
GTIN Número de artículo comercial global definido por el comerciante.

El campo GTIN tiene un límite de 50 caracteres, con cada valor GTIN con hasta 14 dígitos.

Este operando solo es aplicable con productos patrocinados.		 El operando GTIN solo se puede especificar una vez por filtro de ámbito de producto de campaña. El operando GTIN se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
Id Identificador de producto definido por el comerciante.

Un máximo de 1000 caracteres.		 El operando Id solo se puede especificar una vez por filtro de ámbito de producto de campaña. El operando Id se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
MPN Número de artículo comercial global definido por el comerciante.

Un máximo de 70 caracteres.

Este operando solo es aplicable con productos patrocinados.		 El operando MPN solo se puede especificar una vez por filtro de ámbito de producto de campaña. El operando MPN se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
ProductType1-5

Hay cinco valores de operando de tipo de producto disponibles, es decir, ProductType1, ProductType2, ProductType3, ProductType4 y ProductType5.		 Tipo de producto o categoría definido por el comerciante.

ProductType1 es el tipo de producto de nivel más alto y ProductType5 es el nivel más bajo o el tipo de producto más granular.

Un máximo de 100 caracteres.

Este operando no es aplicable a productos patrocinados.		 Cada uno de los operandos de tipo de producto se puede usar una vez por filtro de ámbito de producto de campaña.

Si especifica una condición de producto con el operando establecido en un tipo de producto de 1 a 5,
deben especificarse en orden ascendente. Por ejemplo, puede establecer el operando en "ProductType2" con el atributo "Pet Supplies", si una condición de producto anterior tiene el operando "ProductType1" con el atributo "Animals & Pet Supplies".		 Cada uno de los operandos ProductType se puede usar en varias ramas, pero solo se puede especificar una vez por rama. Por ejemplo, una rama puede contener ProductType1 y ProductType2, pero no puede contener otro nodo con el operando ProductType2 .

Si establece el operando en un tipo de producto de 1 a 5, se deben especificar en orden ascendente. Por ejemplo, el operando se puede establecer en "ProductType2" con el atributo "Pet Supplies", si una partición de producto de nivel superior tiene operando "ProductType1" con el atributo "Animals & Pet Supplies".

No es necesario especificar el operando de tipo de producto de nivel anterior en la partición primaria inmediata. Por ejemplo, se podría especificar una condición ProductType2 para una partición de producto si el elemento primario de su elemento primario especificaba una condición ProductType1.

Condición del producto 2

Admite los mismos valores y reglas que la condición de producto 1.

Condición del producto 3

Admite los mismos valores y reglas que la condición de producto 1.

Condición del producto 4

Admite los mismos valores y reglas que la condición de producto 1.

Condición del producto 5

Admite los mismos valores y reglas que la condición de producto 1.

Condición del producto 6

Admite los mismos valores y reglas que la condición de producto 1.

Condición del producto 7

Admite los mismos valores y reglas que la condición de producto 1.

Operador de producto 1

Valor del operador de la condición. El valor del operador es igual o notequal.

Agregar: Opcional
Actualizar: Solo lectura. No se pueden actualizar los campos de condición o valor. Para actualizar las condiciones, debe eliminar el ámbito del producto de la campaña y agregar uno nuevo.
Borrar: Solo lectura

Operador de producto 2

Admite los mismos valores y reglas que el operador de producto 1.

Operador de producto 3

Admite los mismos valores y reglas que el operador de producto 1.

Operador de producto 4

Admite los mismos valores y reglas que el operador de producto 1.

Operador de producto 5

Admite los mismos valores y reglas que el operador de producto 1.

Operador de producto 6

Admite los mismos valores y reglas que el operador de producto 1.

Operador de producto 7

Admite los mismos valores y reglas que el operador de producto 1.

Valor del producto 1

Valor del atributo de la condición. El valor de un atributo debe coincidir exactamente con el valor especificado en el archivo de catálogo de Microsoft Merchant Center del cliente.

Para ver las reglas de negocio, consulte Condición de producto 1.

Agregar: Obligatorio
Actualizar: Solo lectura. No se pueden actualizar los campos de condición o valor. Para actualizar las condiciones, debe eliminar el ámbito del producto de la campaña y agregar uno nuevo.
Borrar: Solo lectura

Valor del producto 2

Admite los mismos valores y reglas que el valor de producto 1.

Valor del producto 3

Admite los mismos valores y reglas que el valor de producto 1.

Valor del producto 4

Admite los mismos valores y reglas que el valor de producto 1.

Valor del producto 5

Admite los mismos valores y reglas que el valor de producto 1.

Valor del producto 6

Admite los mismos valores y reglas que el valor de producto 1.

Valor del producto 7

Admite los mismos valores y reglas que el valor de producto 1.

Estado

Estado del ámbito del producto.

Los valores posibles son Active o Deleted.

Agregar: Opcional. El único estado posible es Activo. Si establece el estado en Eliminado , se omitirá y el registro devuelto tendrá el estado establecido en Activo.
Actualizar: Opcional
Borrar: Obligatorio. El estado debe establecerse en Eliminado.