ProductCondition Data Object - Gestão de Campanhas
Define uma condição que determina se um produto está selecionado a partir do ficheiro de catálogo do Microsoft Merchant Center de um cliente.
Pode utilizar condições de produção ao nível da campanha com campanhas de Compras, campanhas de Audiência baseadas em feeds e campanhas de Pesquisa com anúncios multimédia, ou seja, as campanhas que tiram partido de um ID de loja do Microsoft Merchant Center. (Nota: nem todos têm campanhas de Pesquisa com anúncios multimédia ainda. Se não o fizer, não se preocupe - estará disponível em breve!) As condições de produto ao nível do grupo de anúncios só podem ser utilizadas com campanhas de Compras. As condições do produto ao nível do grupo de recursos só podem ser utilizadas com campanhas Performance Max. 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.
Sintaxe
<xs:complexType name="ProductCondition" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="Attribute" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Operand" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Operator" nillable="true" type="xs:string">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
Elementos
O objeto ProductCondition tem os seguintes elementos: Atributo, Operando, Operador.
| Elemento | Descrição | Tipo de Dados |
|---|---|---|
| Atributo | 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. Os valores Atributo e Operando disponíveis variam consoante o tipo de campanha. Para obter os valores de atributo e operando suportados, veja Observações abaixo. Adicionar ou Aplicar: Necessário Atualização: Opcional |
cadeia |
| Operando | O operando da condição. Os operandos incluem implicitamente o operador de igual. Por exemplo, leia Marca como Marca=. Adicionar ou Aplicar: Necessário Atualização: Opcional |
cadeia |
| Operador | O operador de item de regra. Adicionar: Necessário Atualização: Necessário |
cadeia |
Observações
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 condição do produto (operando) e Valor do Produto (atributo) para a campanha ProductScope e objetos ProductPartition 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ções do Produto para Campanhas de Pesquisa
Nota
Nem todos têm esta funcionalidade ainda. Se não o fizer, não se preocupe.
Podem ser especificadas várias condições de produto para cada campanha do Microsoft Search com anúncios multimédia. 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.
Em Campanhas de pesquisa, as condições dos produtos podem ser definidas ao nível da campanha. A tabela seguinte descreve as regras de negócio condição do produto (operando) e Valor do Produto (atributo) para objetos productScope de campanha.
| Condição do Produto (Operando) | Descrição do Valor do Produto (Atributo) | Regras de Âmbito de Produto de Campanha |
|---|---|---|
| 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. |
| CategoryL1 Está disponível um valor de operando de categoria, ou seja, CategoryL1. |
Uma categoria de produto definida pela loja Microsoft Merchant Center. Veja Taxonomia da Categoria Bing para obter valores de categoria válidos e taxonomia. Um máximo de 100 carateres. |
Cada um dos operandos CategoryL pode ser utilizado uma vez por filtro de âmbito de produto de campanha. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| ProductType1 Está disponível um valor de operando de tipo de produto, ou seja, ProductType1. |
Um tipo de produto ou categoria definido pelo comerciante. ProductType1 é o tipo de produto de nível mais elevado. 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. |
Condições do Produto para Campanhas Máximas de Desempenho
Podem ser especificadas várias condições de produto para cada grupo de recursos Do Microsoft Performance Max. 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 Performance Max, as condições do produto só podem ser definidas ao nível do grupo de recursos. A tabela seguinte descreve as regras de negócio da Condição do Produto (operando) e do Valor do Produto (atributo) para objetos do grupo de ativos AssetGroupListingGroup .
| Condição do Produto (Operando) | Descrição do Valor do Produto (Atributo) | Regras de Partição de Produtos do Grupo de Ativos |
|---|---|---|
| Todos | Tem de ser nulo. | Para as partições de produtos de um grupo de recursos, o nó raiz tem de ter o operando definido como Tudo e atributo definido como nulo ou vazio. |
| Marca | Fabricante, marca ou fabricante do produto. Um máximo de 1000 carateres. |
Para as partições de produtos de um grupo de recursos, o nó raiz tem de ter o operando definido como Tudo e atributo definido como nulo ou vazio. |
| 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 em vários ramos. 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 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 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 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 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. |
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 . |
| ID | O identificador do produto definido pelo comerciante. Um máximo de 1000 carateres. |
O operando ID 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. |
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 . |
Requisitos
Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13