Partilhar via

Registo do Âmbito do Produto de Campanha - Em Massa

  • Artigo

Define um âmbito de produto ao nível da campanha com uma lista de condições que ajudam a determinar que itens do catálogo deve incluir na campanha, por exemplo, filtrar por marca ou condição.

Pode utilizar âmbitos de produtos de campanha com campanhas de Compras e campanhas de Audiência baseadas em feeds, ou seja, as campanhas que tiram partido de um ID de loja do Microsoft Merchant Center. O âmbito do produto permite-lhe escolher os itens do seu catálogo a incluir na campanha, por exemplo, filtrar por marca ou condição.

Sugestão

Para obter uma descrição geral e mais informações sobre as campanhas de compras da Microsoft, consulte o Guia técnico de Anúncios de Produtos .

Nota

As condições de âmbito do produto ao nível da campanha não são suportadas com Campanhas de Compras Inteligentes , ou seja, campanhas com o Tipo de Campanha definido como Compras e Subtipo definido como ShoppingSmartAds.

Pode transferir todos os registos do Âmbito do Produto de Campanha na conta ao incluir o valor DownloadEntity de CampaignProductScopes 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 um novo âmbito de produto de campanha 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,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,,,,,,,,,,,,,,

Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo ao utilizar o BulkServiceManager para carregar e transferir o objeto BulkCampaignProductScope , 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 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 um registo âmbito de produto de campanha , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Campanha

O nome da campanha que contém o âmbito do 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 Campanha .

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

ID

O identificador gerado pelo sistema do âmbito do produto.

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

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 principal

O identificador gerado pelo sistema da campanha que contém o âmbito do produto.

Este campo em massa mapeia para o campo ID do registo campanha .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de campanha existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Campanha principal. Isto é recomendado se estiver a adicionar novos âmbitos de produto a uma nova campanha 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
Eliminar: Só de leitura

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Campanha .

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 cada condição de produto como operando para o valor de produto correspondente.

Condição do Produto (Operando) Valor do Produto (Atributo) Operador de Produto (Operador)
Condição do Produto 1 Valor do Produto 1 Operador de Produto 1
Condição do Produto 2 Valor do Produto 2 Operador de Produto 2
Condição do Produto 3 Valor do Produto 3 Operador de Produto 3
Condição do Produto 4 Valor do Produto 4 Operador de Produto 4
Condição do Produto 5 Valor do Produto 5 Operador de Produto 5
Condição do Produto 6 Valor do Produto 6 Operador de Produto 6
Condição do Produto 7 Valor do Produto 7 Operador de Produto 7

Cada condição é cumprida se o valor do atributo do produto for igual ao valor do atributo do operando. Por exemplo, se o 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.

Nota

Para adicionar e atualizar, é necessário, pelo menos, uma condição de produto e um par de valores e o número do índice não tem relevância. Por exemplo, pode especificar valores válidos para a Condição de Produto 2 e o Valor do Produto 2 e deixar os campos de condição e valor restantes vazios.

Adicionar: Opcional
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 o âmbito do produto e adicionar um novo.
Eliminar: Só de leitura

Para obter a Condição de Produto (operando) suportada e o Valor do Produto (atributo) por tipo de campanha, veja as tabelas abaixo.

Condições do Produto para Campanhas de Audiência Feed-Based

Podem ser especificadas várias condições de produto para cada campanha de Audiência baseada em feeds. Cada condição é cumprida se o valor do atributo do produto for igual ao valor do atributo do operando. Por exemplo, se o 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.

Condição do Produto (Operando) Descrição do Valor do Produto (Atributo) Regras de Negócio
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.
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.
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.		 Cada um dos operandos do tipo de produto pode ser utilizado uma vez por filtro de âmbito de produto de campanha.

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".
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.		 Cada um dos operandos CustomLabel pode ser utilizado uma vez por filtro de âmbito de produto de campanha.

Condições do Produto para Campanhas de Compras

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.

Condição do Produto 2

Suporta os mesmos valores e regras da Condição de Produto 1.

Condição do Produto 3

Suporta os mesmos valores e regras da Condição de Produto 1.

Condição do Produto 4

Suporta os mesmos valores e regras da Condição de Produto 1.

Condição do Produto 5

Suporta os mesmos valores e regras da Condição de Produto 1.

Condição do Produto 6

Suporta os mesmos valores e regras da Condição de Produto 1.

Condição do Produto 7

Suporta os mesmos valores e regras da Condição de Produto 1.

Operador de Produto 1

O valor do operador da condição. O valor do operador é igual ou notequal.

Adicionar: Opcional
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 o âmbito do produto de campanha e adicionar um novo.
Eliminar: Só de leitura

Operador de Produto 2

Suporta os mesmos valores e regras que o Operador de Produto 1.

Operador de Produto 3

Suporta os mesmos valores e regras que o Operador de Produto 1.

Operador de Produto 4

Suporta os mesmos valores e regras que o Operador de Produto 1.

Operador de Produto 5

Suporta os mesmos valores e regras que o Operador de Produto 1.

Operador de Produto 6

Suporta os mesmos valores e regras que o Operador de Produto 1.

Operador de Produto 7

Suporta os mesmos valores e regras que o Operador de Produto 1.

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.

Para regras de negócio, consulte Condição do Produto 1.

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 o âmbito do produto de campanha e adicionar um novo.
Eliminar: Só de leitura

Valor do Produto 2

Suporta os mesmos valores e regras que o Valor do Produto 1.

Valor do Produto 3

Suporta os mesmos valores e regras que o Valor do Produto 1.

Valor do Produto 4

Suporta os mesmos valores e regras que o Valor do Produto 1.

Valor do Produto 5

Suporta os mesmos valores e regras que o Valor do Produto 1.

Valor do Produto 6

Suporta os mesmos valores e regras que o Valor do Produto 1.

Valor do Produto 7

Suporta os mesmos valores e regras que o Valor do Produto 1.

Estado

O estado do âmbito 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.