Registo de Partição de Produtos do Grupo de Anúncios - Em Massa

Define uma partição de produto do grupo de anúncios que pode ser carregada e transferida num ficheiro em massa.

Pode carregar registos de Partição de Produtos do Grupo de Anúncios para vários grupos de anúncios no mesmo ficheiro em massa, desde que as regras de validação sejam cumpridas conforme descrito abaixo.

• No mínimo, tem de especificar, pelo menos, o nó raiz para a estrutura da árvore do grupo de partições do produto. O nó raiz do grupo de partições de produtos tem de ter o campo Condição de Produto 1 definido como "Tudo" e Valor do Produto 1 nulo ou vazio. Se estiver a licitar em todos os produtos no catálogo de forma igual, defina o campo Sub type como Unidade. Se estiver a criar partições das ofertas com base em condições de produto mais específicas, defina o campo Sub type como Subdivisão, o ID do Critério Principal como nulo ou vazio e o ID para um valor negativo. Irá utilizar o valor negativo como ID de Critério Principal para todos os nós subordinados.

• O nó raiz é considerado nível 0 e uma árvore pode ter ramos até 7 níveis de profundidade.

• Por pedido de carregamento, pode incluir um máximo de 20 000 nós de árvore de partição de produtos por grupo de anúncios. A contagem completa de nós da árvore de partições do produto para um grupo de anúncios não pode exceder os 20 000.

• Os nós da árvore de partição do produto para a mesma árvore (mesmo grupo de anúncios) têm de ser agrupados no ficheiro.

• A ordem dos nós de partição do produto não é garantida durante a transferência e os nós principais podem ser fornecidos após os nós subordinados; no entanto, todos os nós do mesmo grupo de anúncios serão agrupados no ficheiro.

• Se estiver a criar ou modificar a estrutura da árvore, os nós da árvore de partição do produto principal têm de ser ordenados antes dos nós da árvore de partição do produto subordinado; no entanto, a ordem não importa para alterações não estruturais, tais como a actualização da oferta. Por exemplo, se quiser atualizar as ofertas sem adicionar, eliminar ou atualizar a estrutura da árvore, só precisa de carregar os campos ID, ID Principal e Licitação .

• Para atualizar o campo Condição do Produto 1, Valor do Produto 1 ou Está Excluído , tem de eliminar o nó de árvore de partição de produto existente e carregar um novo nó de árvore de partição de produto que irá obter um novo identificador.

• Se alguma ação falhar, todas as ações restantes que possam ter sido bem-sucedidas também falharão.

• Todas as ações de adição e eliminação de nós de partição de produtos têm de resultar numa estrutura de árvore completa.

• Todos os caminhos do nó raiz até ao fim de um ramo têm de terminar com um nó de folha (Sub Type=Unit). Cada Unidade tem de ter uma oferta, a menos que o campo É Excluído seja VERDADEIRO, o que significa que o nó é um critério de grupo de anúncios negativo.

• Cada subdivisão deve ter, pelo menos, um nó de folha que lance no resto das condições da subdivisão, ou seja, utilizar o mesmo operando que as unidades colaterais e definir o valor do produto 1 nulo ou vazio.

• Se estiver a adicionar partições com vários níveis em que o elemento principal ou o subordinado ainda não existem, utilize um valor int negativo como referência para identificar o elemento principal. Por exemplo, defina o ID do elemento principal e o campo ID do Critério Principal do menor para o mesmo valor negativo. Os IDs negativos só são válidos durante a chamada. Os identificadores de sistema exclusivos para cada critério de grupo de anúncios adicionado com êxito são devolvidos no ficheiro de resultado de carregamento.

• Os campos Url de Licitação e Destino só são aplicáveis se o campo É Excluído for FALSO, o que significa que o nó é um critério de grupo de anúncios bidível. No entanto, estes campos são ignorados para nós de partição de subdivisão . Esses elementos só são relevantes para nós de partição de Unidade (folha).

• Para colocar em pausa qualquer partição de produto, tem de colocar todo o grupo de anúncios em pausa ao atualizar o campo Estado do Grupo de Anúncios para Colocado em Pausa. Pode colocar toda a campanha em pausa ao atualizar o campo Estado da Campanha para Em Pausa.

• Para uma ação Eliminada , só precisa de especificar o ID e o ID Principal.

• Se eliminar uma partição de produto principal, todos os respetivos subordinados e descendentes também serão eliminados.

• Não pode especificar condições de produto duplicadas num ramo.

Sugestão

Para obter uma descrição geral e mais informações sobre as campanhas de compras da Microsoft, consulte os Guias técnicos de Anúncios de Produtos e Campanhas de Compras Inteligentes .

Pode transferir todos os registos da Partição de Produtos do Grupo de Anúncios na conta ao incluir o valor DownloadEntity de AdGroupProductPartitions no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para obter mais detalhes sobre o Serviço em massa, incluindo as melhores práticas, veja Transferência e Carregamento em Massa.

O seguinte exemplo de CSV em Massa adicionaria uma nova partição de produto do grupo de anúncios se for fornecido um valor de ID Principal 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

Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo com o BulkServiceManager para carregar e transferir o objeto BulkAdGroupProductPartition , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.

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 um registo de Partição de Produto do Grupo de Anúncios , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

• Grupo de Anúncios
• Licitação
• Ajuste da Oferta
• Campanha
• ID de Cliente
• Parâmetro Personalizado
• URL de Destino
• Sufixo de URL Final
• ID
• Está Excluído
• Hora da Modificação
• ID do Critério Principal
• ID principal
• Condição do Produto 1
• Valor do Produto 1
• Estado
• Subtipo
• Modelo de Controlo

Grupo de Anúncios

O nome do grupo de anúncios que contém a partição de produto.

Adicionar: Só de leitura e Obrigatório
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

Licitação

O montante a licitar no leilão.

Nota

Para grupos de anúncios nas Campanhas Comerciais da Microsoft configuradas para Produtos Patrocinados, este campo não é aplicável se a Opção de Licitação do grupo de anúncios estiver definida como BidBoost. Veja Ajuste da Oferta para obter mais informações.

Adicionar: Necessário se For Excluído for FALSO e o Subtipo for Unidade, caso contrário, a oferta não é permitida.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Ajuste da Oferta

A percentagem (superior a zero) que permite que a oferta de Produtos Patrocinados seja flexível.

Por exemplo, digamos que o seu parceiro oferece 5 USD no respetivo grupo de produtos (através do campo Oferta ). Se o ajuste da oferta (este campo) estiver definido como 20 (por cento) e a Oferta Máxima do seu grupo de anúncios for de 0,50 (50 cêntimos), a sua ação será de 50 cêntimos e não de 1 USD.

Este campo só é aplicável se a Opção de Licitação do grupo de anúncios estiver definida como BidBoost. Se a Opção de Licitação do grupo de anúncios estiver definida como BidValue, o leilão utiliza a Oferta do grupo de produtos.

Os valores suportados são negativos noventa (-90) até novecentos positivos (900).

Nota

Esta definição só é aplicável a grupos de anúncios nas Campanhas comerciais da Microsoft que estão configuradas para Produtos Patrocinados. Os Produtos Patrocinados só estão disponíveis no Estados Unidos e estão atualmente em beta aberta.

Adicionar: Opcional. O ajuste da oferta será definido como a predefinição de 0 , se não for incluído.
Atualização: Necessário
Eliminar: Só de leitura

Campanha

O nome da campanha que contém o grupo de anúncios e a partição de produto.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

ID de Cliente

Utilizado para associar registos no ficheiro de carregamento em massa a registos no ficheiro de resultados. O valor deste campo não é utilizado ou armazenado pelo servidor; é simplesmente copiado do registo carregado para o registo de resultados correspondente. Pode ser qualquer cadeia válida até 100 de comprimento.

Adicionar: Opcional
Atualização: Opcional
Eliminar: Só de leitura

Parâmetro Personalizado

A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs.

Num ficheiro em massa, a lista de parâmetros personalizados é formatada da seguinte forma.

• Formate cada par de parâmetros personalizado como Key=Value, por exemplo {_promoCode}=PROMO1.

• O Microsoft Advertising aceitará os primeiros oito pares de chave e valor personalizados que incluir e, se incluir mais de 8 parâmetros personalizados, será devolvido um erro.

• Cada par chave e valor é delimitado por um ponto e vírgula e espaço ("; "), por exemplo {_promoCode}=PROMO1; {_season}=verão.

• Uma Chave não pode conter um ponto e vírgula. Se um Valor contiver um ponto e vírgula, tem de ser escapado como '\;'. Além disso, se o Valor contiver uma barra invertida, também terá de ser escapado como "\".

• A Chave não pode exceder os 16 bytes UTF-8 e o Valor não pode exceder os 250 bytes UTF-8. A Chave é necessária e o Valor é opcional. O tamanho máximo da Chave não inclui as chavetas e o caráter de sublinhado, ou seja, "{", "_" e "}".

  Nota

  Com o serviço em massa, a Chave tem de ser formatada com chavetas adjacentes e um caráter de sublinhado à esquerda, por exemplo, se a Chave for promoCode, tem de ser formatada como {_promoCode}. Com o serviço Gestão de Campanhas, não pode especificar as chavetas adjacentes e o caráter de sublinhado.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para remover todos os parâmetros personalizados, defina este campo como delete_value. A palavra-chave delete_value remove a definição anterior. Para remover um subconjunto de parâmetros personalizados, especifique os parâmetros personalizados que pretende manter e omita os que não pretende manter. O novo conjunto de parâmetros personalizados substituirá qualquer conjunto de parâmetros personalizados anterior.
Eliminar: Só de leitura

URL de Destino

O URL da página Web para a qual o utilizador é levado quando clica no anúncio.

Se estiver a utilizar atualmente URLs de Destino, terá eventualmente de substituí-los por Modelos de Controlo. Para obter mais informações, veja Controlo de URLs com URLs Atualizados.

O URL pode conter parâmetros dinâmicos, como {MatchType}. Para obter uma lista dos parâmetros suportados, veja o artigo ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar?.

O URL pode conter um máximo de 1024 carateres. Se o URL não especificar um protocolo, o sistema utiliza o protocolo HTTP quando um utilizador clica no anúncio. Se o URL especificar o protocolo HTTP ao adicionar um anúncio, o serviço removerá a cadeia de protocolo http:// (a cadeia de protocolo HTTP não conta com o limite de 1024 carateres); no entanto, o serviço não removerá uma cadeia de protocolo HTTPS (https://) do URL.

Nota

Este URL de destino é utilizado se for especificado; caso contrário, o URL de destino é determinado pelo valor correspondente da "Ligação" que especificou para a oferta de produto no catálogo do Microsoft Merchant Center.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura

Sufixo de URL Final

O sufixo de URL final pode incluir parâmetros de controlo que serão anexados ao final do URL da página de destino. Recomendamos que coloque os parâmetros de controlo de que a página de destino necessita num sufixo de URL final para que os seus clientes sejam sempre enviados para a sua página de destino. Para obter mais detalhes e regras de validação, veja Sufixo de URL Final nos guias técnicos.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema da partição do produto.

Adicionar: Só de leitura
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Está Excluído

Determina se a partição do produto representa um critério bidível ou negativo.

Se estiver definido como VERDADEIRO , será um critério negativo e, caso contrário, se for FALSO , será um critério bidível.

Adicionar: Necessário
Atualização: Só de leitura
Eliminar: Só de leitura

Hora da Modificação

A data e hora em que a entidade foi atualizada pela última vez. O valor está em Hora Universal Coordenada (UTC).

Nota

O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

ID do Critério Principal

O identificador de critério da partição do produto principal.

Nota

Este campo não é aplicável ao nó de partição de produto raiz da árvore, que não tem um elemento principal.

Adicionar: Só de leitura e Obrigatório
Atualização: Só de leitura
Eliminar: Só de leitura

ID principal

O identificador gerado pelo sistema do grupo de anúncios que contém a partição de produto.

Este campo em massa mapeia para o campo ID do registo do Grupo de Anúncios .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de grupo de anúncios existente ou especificar um identificador negativo que seja igual ao campo ID do registo do Grupo de Anúncios principal. Isto é recomendado se estiver a adicionar novas partições de produto a um novo grupo de anúncios no mesmo Ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

Condição do Produto 1

O operando da condição. Os operandos incluem implicitamente o operador de igual. Por exemplo, pode ler Marca como Marca=.

Utilize a Condição de Produto 1 como operando do Valor do Produto 1.

Podem ser especificadas várias condições de produto para cada campanha e grupo de anúncios do Microsoft Shopping. Cada condição é cumprida se o valor do atributo do produto for igual ao valor do atributo do operando. Por exemplo, se operando estiver definido como Marca e o atributo estiver definido como Contoso, a condição será cumprida se o valor do atributo Marca do catálogo de produtos for igual a Contoso.

Nas campanhas de Compras, as condições dos produtos podem ser definidas ao nível da campanha e do grupo de anúncios. A tabela seguinte descreve as regras de negócio de Condição do Produto (operando) e Valor do Produto (atributo) para o Âmbito do Produto de Campanha e os registos de Partição de Produtos do Grupo de Anúncios .

Condição do Produto (Operando)	Descrição do Valor do Produto (Atributo)	Regras de Âmbito de Produto de Campanha	Regras de Partição de Produtos do Grupo de Anúncios
Todos	Tem de ser nulo.	Não aplicável.	Para as partições de produtos de um grupo de anúncios, o nó raiz tem de ter o operando definido como "Tudo" e o atributo definido como nulo ou vazio.
Marca	Fabricante, marca ou fabricante do produto. Um máximo de 1000 carateres.	O operando Marca só pode ser especificado uma vez por filtro de âmbito de produto de campanha.	O operando Marca pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
CategoriaL1-5 Estão disponíveis cinco valores de operando de categoria, ou seja, CategoryL1, CategoryL2, CategoryL3, CategoryL4 e CategoryL5.	Uma categoria de produto definida pela loja Microsoft Merchant Center. Veja Taxonomia da Categoria Bing para obter valores de categoria válidos e taxonomia. CategoryL0 é a categoria de nível mais alto e CategoryL4 é o nível mais baixo ou a categoria mais granular. Um máximo de 100 carateres.	Cada um dos operandos CategoryL pode ser utilizado uma vez por filtro de âmbito de produto de campanha. Se especificar uma condição de produto com operando definido para uma categoria de produto de 1 a 5, têm de ser especificados por ordem ascendente. Por exemplo, pode definir o operando como "CategoryL2" com o atributo "Pet Supplies", se uma condição de produto anterior tiver o operando "CategoryL1" com o atributo "Animals & Pet Supplies".	Cada um dos operandos CategoryL pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo. Por exemplo, um ramo pode conter CategoryL1 e CategoryL2, mas pode não conter outro nó com o operando CategoryL2. Se definir o operando para uma categoria de produto de 1 a 5, estes têm de ser especificados por ordem ascendente. Por exemplo, o operando pode ser definido como "CategoryL2" com o atributo "Pet Supplies", se uma partição de produto de nível superior tiver o operando "CategoryL1" com o atributo "Animals & Pet Supplies". O operando de categoria de produto de nível anterior não precisa de ser especificado na partição principal imediata. Por exemplo, uma condição CategoryL2 poderia ser especificada para uma partição de produto se o elemento principal do respetivo elemento principal especificasse uma condição CategoryL1.
Canal	O canal Anúncios de Inventário Local (LIA). Os valores possíveis incluem "Lojas Locais" e "Online". Se a campanha não tiver optado pelos Anúncios de Inventário Local, todas as ofertas são, por predefinição, Apenas Online (Channel=Online) e Canal Único (ChannelExclusivity=Single-channel). Para obter mais informações, veja a página de ajuda Anúncios de Inventário Local .	O operando Canal só pode ser especificado uma vez por filtro de âmbito de produto de campanha.	O operando Canal pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
ChannelExclusivity	Exclusividade do canal de Anúncios de Inventário Local (LIA). Os valores possíveis incluem "Canal único" e "Multi-channel". Se a campanha não tiver optado pelos Anúncios de Inventário Local, todas as ofertas são, por predefinição, Apenas Online (Channel=Online) e Canal Único (ChannelExclusivity=Single-channel). Para obter mais informações, veja a página de ajuda Anúncios de Inventário Local .	O operando ChannelExclusivity só pode ser especificado uma vez por filtro de âmbito de produto de campanha.	O operando ChannelExclusivity pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
Condição	A condição do produto. Se operando estiver definido como Condição, os valores de atributo suportados que pode especificar são Novo, Utilizado e Recondicionado.	O operando Condição só pode ser especificado uma vez por filtro de âmbito de produto de campanha.	O operando Condição pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
CustomLabel0-4 Estão disponíveis cinco valores de operando de etiqueta personalizada, ou seja, CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 e CustomLabel4.	Uma etiqueta personalizada definida pelo comerciante. As etiquetas personalizadas, por exemplo, CustomLabel0 e CustomLabel4 não são validadas com base em nenhuma hierarquia. Um máximo de 100 carateres. Este operando não é aplicável aos Produtos Patrocinados.	Cada um dos operandos CustomLabel pode ser utilizado uma vez por filtro de âmbito de produto de campanha.	Cada um dos operandos CustomLabel pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo. Por exemplo, um ramo pode conter CustomLabel0 e CustomLabel1, mas pode não conter outro nó com o operando CustomLabel1 .
GTIN	O Número De Item de Comércio Global definido pelo comerciante. O campo GTIN tem um limite de 50 carateres, com cada valor GTIN com até 14 dígitos. Este operando só é aplicável com Produtos Patrocinados.	O operando GTIN só pode ser especificado uma vez por filtro de âmbito de produto de campanha.	O operando GTIN pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
ID	O identificador do produto definido pelo comerciante. Um máximo de 1000 carateres.	O operando ID só pode ser especificado uma vez por filtro de âmbito de produto de campanha.	O operando ID pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
MPN	O Número De Item de Comércio Global definido pelo comerciante. Um máximo de 70 carateres. Este operando só é aplicável com Produtos Patrocinados.	O operando MPN só pode ser especificado uma vez por filtro de âmbito de produto de campanha.	O operando MPN pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
ProductType1-5 Estão disponíveis cinco valores de operando de tipo de produto, ou seja, ProductType1, ProductType2, ProductType3, ProductType4 e ProductType5.	Um tipo de produto ou categoria definido pelo comerciante. ProductType1 é o tipo de produto de nível mais alto e ProductType5 é o tipo de produto mais baixo ou granular. Um máximo de 100 carateres. Este operando não é aplicável aos Produtos Patrocinados.	Cada um dos operandos do tipo de produto pode ser utilizado uma vez por filtro de âmbito de produto de campanha. Se especificar uma condição de produto com operando definido para um tipo de produto de 1 a 5, têm de ser especificados por ordem ascendente. Por exemplo, pode definir o operando como "ProductType2" com o atributo "Pet Supplies", se uma condição de produto anterior tiver o operando "ProductType1" com o atributo "Animals & Pet Supplies".	Cada um dos operandos ProductType pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo. Por exemplo, um ramo pode conter ProductType1 e ProductType2, mas pode não conter outro nó com o operando ProductType2 . Se definir o operando para um tipo de produto de 1 a 5, estes têm de ser especificados por ordem ascendente. Por exemplo, o operando pode ser definido como "ProductType2" com o atributo "Pet Supplies", se uma partição de produto de nível superior tiver o operando "ProductType1" com o atributo "Animals & Pet Supplies". O operando de tipo de produto de nível anterior não precisa de ser especificado na partição principal imediata. Por exemplo, uma condição ProductType2 poderia ser especificada para uma partição de produto se o principal do respetivo elemento principal especificasse uma condição ProductType1.

Adicionar: Necessário
Atualização: Só de leitura. Não é possível atualizar os campos de condição ou valor. Para atualizar as condições, tem de eliminar a partição do produto e adicionar uma nova.
Eliminar: Só de leitura

Valor do Produto 1

O valor do atributo da condição.

O valor de um atributo tem de corresponder exatamente ao valor especificado no ficheiro de catálogo do Microsoft Merchant Center do cliente.

Adicionar: Necessário
Atualização: Só de leitura. Não é possível atualizar os campos de condição ou valor. Para atualizar as condições, tem de eliminar a partição do produto e adicionar uma nova.
Eliminar: Só de leitura

Estado

O estado da partição do produto.

Os valores possíveis são Ativos ou Eliminados.

Adicionar: Opcional. O único estado possível é Ativo. Se definir o estado como Eliminado , este será ignorado e o registo devolvido terá o estado definido como Ativo.
Atualização: Opcional
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.

Subtipo

O tipo de partição de produto.

Os valores possíveis são Subdivisão e Unidade.

Adicionar: Necessário
Atualização: Só de leitura
Eliminar: Só de leitura

Modelo de Controlo

Os modelos de controlo podem ser utilizados em conjunto com o URL especificado no campo "Ligação" da oferta de produto que submeteu através da API de Conteúdo. Ao combinar o URL do feed com o modelo de controlo, o URL da página de destino é montado onde um utilizador é direcionado depois de clicar no anúncio. Quando utiliza o campo Modelo de Controlo para atualizar os parâmetros do URL em vez de os atualizar no URL do feed, o URL do feed não precisa de passar pela revisão editorial e os anúncios continuarão a servir ininterruptamente. Por exemplo, se o URL da oferta do produto no feed de catálogo for https://contoso.com/, pode especificar o seguinte modelo de controlo: {lpurl}?matchtype={matchtype}&device={device}.

As seguintes regras de validação aplicam-se aos modelos de controlo. Para obter mais detalhes sobre os modelos e parâmetros suportados, consulte o artigo de ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar?

• Os modelos de controlo definidos para entidades de nível inferior, por exemplo, os anúncios substituem os conjuntos de entidades de nível superior, por exemplo, campanha. Para obter mais informações, veja Limites de Entidades.

• O comprimento do modelo de controlo está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.

• O modelo de controlo tem de ser um URL bem formado, começando por um dos seguintes: http://, https://, {lpurl} ou {unescapedlpurl}.

• O Microsoft Advertising não valida se existem parâmetros personalizados. Se utilizar parâmetros personalizados no seu modelo de controlo e estes não existirem, o URL da página de destino incluirá os marcadores de posição de chave e valor dos parâmetros personalizados sem substituição. Por exemplo, se o seu modelo de controlo for https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}, e nem {_season} nem {_promocode} estiverem definidos na campanha, grupo de anúncios, critério, palavra-chave ou nível de anúncio, o URL da página de destino será o mesmo.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura