Registro de partición de producto de grupo de anuncios: masiva

Define una partición de producto de grupo de anuncios que se puede cargar y descargar en un archivo masivo.

Puede cargar registros de partición de producto de grupo de anuncios para varios grupos de anuncios en el mismo archivo masivo, siempre y cuando se cumplan las reglas de validación que se describen a continuación.

• Como mínimo, debe especificar al menos el nodo raíz para la estructura de árbol del grupo de particiones de producto. El nodo raíz del grupo de particiones de producto debe tener su campo Condición de producto 1 establecido en "Todos" y Valor de producto 1 nulo o vacío. Si va a pujar por todos los productos del catálogo por igual, establezca el campo Subtipo en Unidad. Si va a crear particiones de las pujas en función de condiciones de producto más específicas, establezca el campo Subtipo en Subdivision, el Id. de criterio primario en null o vacío y el Id en un valor negativo. Usará el valor negativo como Id. de criterio primario para los nodos secundarios.

• El nodo raíz se considera nivel 0 y un árbol puede tener ramas de hasta 7 niveles de profundidad.

• Por solicitud de carga, puede incluir un máximo de 20 000 nodos de árbol de particiones de producto por grupo de anuncios. El número completo de nodos de árbol de particiones de producto para un grupo de anuncios no puede superar los 20 000.

• Los nodos de árbol de partición de producto para el mismo árbol (mismo grupo de anuncios) deben agruparse en el archivo.

• El orden de los nodos de partición de producto no está garantizado durante la descarga y es posible que se proporcionen nodos primarios después de los nodos secundarios; sin embargo, todos los nodos del mismo grupo de anuncios se agruparán en el archivo.

• Si va a crear o modificar la estructura de árbol, los nodos de árbol de partición de producto primario se deben ordenar antes que los nodos de árbol de partición de producto secundario; sin embargo, la orden no es importante para los cambios no estructurales, como actualizar la oferta. Por ejemplo, si desea actualizar las pujas sin agregar, eliminar o actualizar la estructura del árbol, solo tiene que cargar los campos Id, Parent Id y Bid .

• Para actualizar el campo Condición de producto 1, Valor de producto 1 o Está excluido , debe eliminar el nodo de árbol de partición de producto existente y cargar un nuevo nodo de árbol de particiones de producto que obtendrá un nuevo identificador.

• Si se produce un error en alguna acción, también se producirá un error en todas las acciones restantes que podrían haberse realizado correctamente.

• Todas las acciones de adición y eliminación de nodos de partición de producto deben dar lugar a una estructura de árbol completa.

• Cada ruta de acceso desde el nodo raíz hasta el final de una rama debe terminar con un nodo hoja (Subtipo=Unidad). Cada unidad debe tener una puja, a menos que el campo Se excluye sea TRUE, lo que significa que el nodo es un criterio negativo del grupo de anuncios.

• Cada subdivisión debe tener al menos un nodo hoja que puja por el resto de las condiciones de la subdivisión, es decir, usar el mismo operando que sus unidades del mismo nivel y establecer su valor de producto 1 null o vacío.

• Si va a agregar particiones con varios niveles en los que aún no existe ninguno de los elementos primarios o secundarios, use un valor int negativo como referencia para identificar al elemento primario. Por ejemplo, establezca el id. del elemento primario y el campo Parent Criterion Id del elemento secundario en el mismo valor negativo. Los identificadores negativos solo son válidos durante la llamada. Los identificadores únicos del sistema para cada criterio de grupo de anuncios agregado correctamente se devuelven en el archivo de resultados de carga.

• Los campos Url de puja y destino solo son aplicables si el campo Está excluido es FALSE, lo que significa que el nodo es un criterio de grupo de anuncios que se puede pujar. Sin embargo, estos campos se omiten para los nodos de partición de subdivisión . Esos elementos solo son pertinentes para los nodos de partición de unidad (hoja).

• Para pausar cualquier partición de producto, debe pausar todo el grupo de anuncios actualizando el campo Estado del grupo de anuncios a Pausado. Puedes pausar toda la campaña actualizando el campo Estado de la campaña a Pausado .

• En el caso de una acción Eliminada , solo tiene que especificar el identificador y el identificador primario.

• Si elimina una partición de producto primaria, también se eliminarán todos sus elementos secundarios y descendientes.

• No puede especificar condiciones de producto duplicadas en una rama.

Sugerencia

Para obtener información general y más información sobre las campañas de compras de Microsoft, consulte las guías técnicas Anuncios de productos y Campañas de compras inteligentes .

Puede descargar todos los registros de partición de producto de grupo de anuncios de la cuenta incluyendo el valor DownloadEntity de AdGroupProductPartitions 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 una nueva partición de producto del grupo de anuncios 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,Is Excluded,Parent Criterion Id,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,6.0,,,,,,,
Ad Group Product Partition,Paused,,-1112,,,,ClientIdGoesHere,,0.5,,All,,FALSE,,,,{_promoCode}=PROMO1; {_season}=summer

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkAdGroupProductPartition , 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 BulkAdGroupProductPartition
var bulkAdGroupProductPartition = new BulkAdGroupProductPartition
{
    // Map properties in the Bulk file to the BiddableAdGroupCriterion or
    // NegativeAdGroupCriterion object of the Campaign Management service.
    // Use the BiddableAdGroupCriterion to set the 'Is Excluded' field in the Bulk file to True,
    // and otherwise use the NegativeAdGroupCriterion to set the 'Is Excluded' field to False.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new ProductPartition { 
            Condition = new ProductCondition
            {
                // 'Product Value 1' column header in the Bulk file
                Attribute = null,
                // 'Product Condition 1' column header in the Bulk file
                Operand = "All",
            },
            // 'Parent Criterion Id' column header in the Bulk file
            ParentCriterionId = null
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
            Amount = 0.50
        },
        // 'Destination Url' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        DestinationUrl = null,
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // 'Tracking Template' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
    // '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",
};

uploadEntities.Add(bulkAdGroupProductPartition);

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 partición de producto de grupo de anuncios , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

• Grupo de anuncios
• Oferta
• Ajuste de la oferta
• Campaña
• Id. de cliente
• Parámetro personalizado
• Dirección URL de destino
• Sufijo de dirección URL final
• Id
• Se excluye
• Tiempo de modificación
• Id. de criterio primario
• Parent Id
• Condición del producto 1
• Valor del producto 1
• Estado
• Subtipo
• Plantilla de seguimiento

Grupo de anuncios

Nombre del grupo de anuncios que contiene la partición 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 Grupo de anuncios .

Oferta

Cantidad que se va a pujar en la subasta.

Nota:

En el caso de los grupos de anuncios de las campañas de Compras de Microsoft que están configurados para productos patrocinados, este campo no es aplicable si la opción de puja del grupo de anuncios está establecida en BidBoost. Consulte Ajuste de pujas para obtener más información.

Agregar: Obligatorio si Se excluye es FALSE y el subtipo es Unidad y, de lo contrario, no se permite la puja.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura

Ajuste de la oferta

El porcentaje (mayor que cero) que permite que la oferta de productos patrocinados se flexibilite.

Por ejemplo, supongamos que su asociado puja 5 USD en su grupo de productos (a través del campo Bid ). Si el ajuste de la oferta (este campo) está establecido en 20 (porcentaje) y la puja máxima del grupo de anuncios es de 0,50 (50 centavos), el recurso compartido sería de 50 centavos y no de 1 USD.

Este campo solo es aplicable si la opción de puja del grupo de anuncios está establecida en BidBoost. Si la opción de puja del grupo de anuncios está establecida en BidValue, la subasta usa la oferta del grupo de productos.

Los valores admitidos son noventa negativos (-90) a noventacientos (900) positivos.

Nota:

Esta configuración solo es aplicable a los grupos de anuncios de las campañas de Compras de Microsoft que están configurados para productos patrocinados. Los productos patrocinados solo están disponibles en el Estados Unidos y actualmente están en versión beta abierta.

Agregar: Opcional. El ajuste de puja se establecerá en el valor predeterminado de 0 si no se incluye.
Actualizar: Obligatorio
Borrar: Solo lectura

Campaña

Nombre de la campaña que contiene el grupo de anuncios y la partición del producto.

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

Parámetro personalizado

Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL.

En un archivo masivo, la lista de parámetros personalizados tiene el formato siguiente.

• Dé formato a cada par de parámetros personalizado como Key=Value, por ejemplo{_promoCode}=PROMO1.

• Microsoft Advertising aceptará los 8 primeros pares de clave y valor de parámetro personalizados que incluya y, si incluye más de 8 parámetros personalizados, se devolverá un error.

• Cada par de clave y valor se delimita por un punto y coma y un espacio ("; "), por ejemplo {_promoCode}=PROMO1; {_season}=verano.

• Una clave no puede contener un punto y coma. Si un valor contiene un punto y coma, debe tener escape como '\;'. Además, si el valor contiene una barra diagonal inversa, también debe tener el carácter de escape '\'.

• La clave no puede superar los 16 bytes UTF-8 y el valor no puede superar los 250 bytes UTF-8. La clave es necesaria y el valor es opcional. El tamaño máximo de la clave no incluye las llaves y el carácter de subrayado, es decir, '{', '_' y '}'.

  Nota:

  Con el servicio bulk, la clave debe tener formato con llaves circundantes y un carácter de subrayado inicial, por ejemplo, si la clave es promoCode, debe tener el formato {_promoCode}. Con el servicio Administración de campañas no puede especificar las llaves y el carácter de subrayado circundantes.

Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para quitar todos los parámetros personalizados, establezca este campo en delete_value. La palabra clave delete_value quita la configuración anterior. Para quitar un subconjunto de parámetros personalizados, especifique los parámetros personalizados que desea conservar y omita los que no desee conservar. El nuevo conjunto de parámetros personalizados reemplazará a cualquier conjunto de parámetros personalizados anterior.
Borrar: Solo lectura

Dirección URL de destino

Dirección URL de la página web a la que se lleva al usuario al hacer clic en el anuncio.

Si actualmente usa direcciones URL de destino, finalmente debe reemplazarlas por Plantillas de seguimiento. Para obtener más información, consulte Seguimiento de direcciones URL con direcciones URL actualizadas.

La dirección URL puede contener parámetros dinámicos como {MatchType}. Para obtener una lista de los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?.

La dirección URL puede contener un máximo de 1024 caracteres. Si la dirección URL no especifica un protocolo, el sistema usa el protocolo HTTP cuando un usuario hace clic en el anuncio. Si la dirección URL especifica el protocolo HTTP al agregar un anuncio, el servicio quitará la cadena de protocolo http:// (la cadena de protocolo HTTP no cuenta con el límite de 1024 caracteres); sin embargo, el servicio no quitará una cadena de protocolo HTTPS (https://) de la dirección URL.

Nota:

Esta dirección URL de destino se usa si se especifica; De lo contrario, la dirección URL de destino viene determinada por el valor correspondiente del "Vínculo" que especificó para la oferta de producto en el catálogo de Microsoft Merchant Center.

Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Borrar: Solo lectura

Sufijo de dirección URL final

El sufijo de dirección URL final puede incluir parámetros de seguimiento que se anexarán al final de la dirección URL de la página de aterrizaje. Se recomienda colocar los parámetros de seguimiento que requiere la página de aterrizaje en un sufijo de dirección URL final para que los clientes siempre se envíen a la página de aterrizaje. Para obtener más detalles y reglas de validación, consulte Sufijo de dirección URL final en las guías técnicas.

Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Borrar: Solo lectura

Id

Identificador generado por el sistema de la partición de producto.

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

Se excluye

Determina si la partición del producto representa un criterio biddable o negativo.

Si se establece en TRUE , es un criterio negativo y, de lo contrario, si FALSE es un criterio que se puede pujar.

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

Id. de criterio primario

Identificador de criterio de la partición del producto primario.

Nota:

Este campo no es aplicable al nodo de partición del producto raíz del árbol, que no tiene ningún elemento primario.

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

Parent Id

Identificador generado por el sistema del grupo de anuncios que contiene la partición del producto.

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 nuevas particiones de producto 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 y Obligatorio
Borrar: Solo lectura y Obligatorio

Nota:

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

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 la condición de producto 1 como operando para el valor de producto 1.

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.

Agregar: Obligatorio
Actualizar: Solo lectura. No se pueden actualizar los campos de condición o valor. Para actualizar las condiciones, debe eliminar la partición del producto y agregar una nueva.
Borrar: Solo lectura

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.

Agregar: Obligatorio
Actualizar: Solo lectura. No se pueden actualizar los campos de condición o valor. Para actualizar las condiciones, debe eliminar la partición del producto y agregar una nueva.
Borrar: Solo lectura

Estado

Estado de la partición de 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.

Subtipo

Tipo de partición de producto.

Los valores posibles son Subdivision y Unit.

Agregar: Obligatorio
Actualizar: Solo lectura
Borrar: Solo lectura

Plantilla de seguimiento

Las plantillas de seguimiento se pueden usar junto con la dirección URL especificada en el campo "Link" para la oferta de producto que envió a través de Content API. Al combinar la dirección URL de la fuente con la plantilla de seguimiento, la dirección URL de la página de aterrizaje se ensambla donde se dirige a un usuario después de hacer clic en el anuncio. Al usar el campo Plantilla de seguimiento para actualizar los parámetros de dirección URL en lugar de actualizarlos en la dirección URL de la fuente, la dirección URL de la fuente no tiene que pasar por la revisión editorial y los anuncios seguirán atendiendo de forma ininterrumpida. Por ejemplo, si la dirección URL de la oferta de producto en la fuente de catálogo es https://contoso.com/, podría especificar la siguiente plantilla de seguimiento: {lpurl}?matchtype={matchtype}&device={device}.

Las siguientes reglas de validación se aplican a las plantillas de seguimiento. Para obtener más información sobre las plantillas y los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?

• Las plantillas de seguimiento definidas para entidades de nivel inferior, por ejemplo, los anuncios, reemplazan a las establecidas para entidades de nivel superior, por ejemplo, campaña. Para obtener más información, vea Límites de entidad.

• La longitud de la plantilla de seguimiento está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres.

• La plantilla de seguimiento debe ser una dirección URL bien formada que comience por una de las siguientes: http://, https://, {lpurl}o {unescapedlpurl}.

• Microsoft Advertising no valida si existen parámetros personalizados. Si usa parámetros personalizados en la plantilla de seguimiento y no existen, la dirección URL de la página de aterrizaje incluirá los marcadores de posición de clave y valor de los parámetros personalizados sin sustitución. Por ejemplo, si la plantilla de seguimiento es https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}y no se definen {_season} ni {_promocode} en el nivel de campaña, grupo de anuncios, criterio, palabra clave o anuncio, la dirección URL de la página de aterrizaje será la misma.

Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Borrar: Solo lectura