Neste artigo, você encontra todos os atributos que pode incluir na sua fonte de dados de promoções.
Para usar as promoções, envie os dados de produtos para o Google usando uma fonte de dados. Em seguida, as informações na fonte de dados são distribuídas por diferentes Serviços do Google, incluindo a Pesquisa, a guia "Shopping", o Chrome e muito mais. Clientes com acesso por computador e dispositivo móvel da Austrália, Alemanha, Brasil, Canadá, Coreia do Sul, Espanha, Estados Unidos, França, Índia, Itália, Japão, Países Baixos e Reino Unido podem ver o feed de promoções.
Enviar uma fonte de dados de promoções
Tipo de arquivo: é possível usar um arquivo XML, um delimitado por tabulações ou uma planilha Google. Confira um exemplo de modelo de fonte de dados
Como registrar e carregar uma nova fonte de dados: siga as etapas para registrar e carregar uma nova fonte de dados de promoções. Faça upload da fonte de promoções na mesma conta do Merchant Center que você usa para a fonte de dados de produtos on-line.
Como criar promoções para segmentar produtos específicos
É possível criar promoções de produtos específicos das seguintes maneiras:
- Aplique atributos de filtro de produtos à fonte de dados de promoções: se uma promoção é válida para itens específicos na fonte de dados de produto, é possível usar atributos de filtro. Consulte os filtros de produtos.
- Correlacione o ID da promoção aos itens na fonte de dados de produto: o Google só reconhece os produtos incluídos na sua promoção quando você fornece um valor para o atributo de ID da promoção
[promotion ID]e o associa aos itens qualificados na fonte de dados de produto. Para mais informações, consulte como criar uma promoção para produtos específicos.
Ao definir filtros de produto nas fontes de dados de promoções e IDs de promoção explícitos na fonte de dados de produto, a promoção é aplicada aos produtos que você seleciona com o uso de atributos de filtro e o mapeamento do ID da promoção.
Dados básicos de promoções
Inclua os seguintes atributos na fonte de dados para definir como as promoções vão aparecer:
| Atributo | Resumo dos requisitos mínimos |
|---|---|
ID da promoção [promotion_id]
Sintaxe
|
Esse atributo é o ID exclusivo de uma promoção. O atributo de ID da promoção |
|
Produtos qualificados para a promoção
Valores compatíveis
|
Esse atributo determina se a promoção vale para todos os produtos ou somente para itens específicos.
|
|
Código do cupom necessário
Valores compatíveis
Se o valor desse atributo for
|
Esse atributo indica se um código de cupom é necessário para que os clientes resgatem a oferta. Observação: todas as promoções de frete precisam incluir um código de resgate válido.
Saiba como incluir códigos de resgate para divulgar promoções nas políticas do programa de promoções. |
Título da promoção [long_title]
Sintaxe
Exemplo
|
Este atributo especifica o título completo da promoção. Importante: Siga nossos requisitos editoriais com atenção. Eles descrevem os requisitos de título e fornecem exemplos úteis de títulos aceitáveis e inaceitáveis. O título deve descrever a promoção de forma completa e precisa. |
Data de início da promoção [promotion_effective_dates]
Sintaxe
Exemplo Se a sua promoção fosse válida das 3h de 19 de julho de 2009 às 21h de 26 de julho de 2009 EST (Horário Padrão Oriental), você enviaria:
Se a sua promoção fosse válida das 3h de 19 de julho de 2009 às 21h de 26 de julho de 2009 GMT (horário de Greenwich), você enviaria:
|
Importante:
Se você usar o criador de promoções, ele só vai ser compatível com o atributo de data de início da promoção Dica: é possível validar a promoção antes do início dela usando o atributo de datas de exibição da promoção |
|
Canal qualificado para promoções Observação: esse atributo está disponível apenas no Merchant Center clássico.
Valores compatíveis
Importante:
|
Este atributo indica se a promoção é válida on-line, na loja ou em ambos. |
|
Destino da promoção
Valores compatíveis
Adicione um valor compatível com a fonte de dados. Para enviar sua promoção a um ou mais destinos, envie cada valor de destino como uma coluna separada:
Importante: se você usar o atributo destino da promoção |
Importante: Esses são campos repetidos e ambos os valores são aceitos simultaneamente. Os valores indicados neste campo vão substituir os padrões do produto. Para mais detalhes sobre campos repetidos, acesse Sobre atributos com campos repetidos. Observações:
|
|
Aplicabilidade às lojas
Valores compatíveis
|
Este atributo indica se a promoção é aplicável a todas as lojas ou somente a lojas específicas. Importante:
|
|
Inclusão de códigos das lojas
|
Esse atributo indica as lojas específicas a que sua promoção se aplica. Importante:
|
|
Exclusão de códigos das lojas
|
Esse atributo indica as lojas específicas de que sua promoção é excluída. Importante:
|
|
URL da promoção |
O URL da promoção precisa ser um link que direcione para a página do site em que os clientes encontram os detalhes da promoção. As informações na página com os detalhes da sua promoção precisam corresponder aos dados enviados. |
Shopping Actions, Surfaces across Google e Local surfaces across Google. Esses valores ainda serão aceitos, mas recomendamos que você atualize seus produtos para incluir os novos valores destes destinos: Free_listings, Free_local_listings.Filtros de produto
Se você criar uma promoção que se aplique somente a produtos específicos na fonte de dados de produto, use o filtro de produto na fonte de promoções. Os atributos de filtro de produto só são válidos quando os produtos qualificados para a promoção [product_applicability] estão definidos para produtos específicos [specific_products]. Todos os atributos nesta seção são campos repetidos com um limite de até 1.000 em XML/CSV.
Os atributos de filtro de produto na tabela abaixo determinam os produtos que se aplicam a uma promoção. Quando o mesmo atributo é usado mais de uma vez, o produto precisa corresponder a pelo menos um dos atributos para que o filtro seja aplicado. Quando houver vários filtros, somente os produtos que passarem em todos os filtros serão selecionados para a promoção. Se um filtro excluir um produto e outro filtro incluir o mesmo produto, o produto será excluído da promoção.
Exemplo:
Por exemplo, se você criar uma promoção para brand = "example1" e product_type = "Tshirt", a promoção vai ser válida somente para os itens na fonte de dados de produto com brand = "example1" e product_type = "Tshirt".
Outra opção é vincular um produto a uma promoção específica definindo o atributo ID da promoção [promotion_id] na fonte de dados.
| Atributo | Descrição |
|---|---|
|
ID do produto da promoção Sintaxe
|
A promoção só é válida para produtos que correspondem ao ID do produto da promoção Observação: o atributo de ID do produto da promoção |
|
Tipo de produto Sintaxe
|
A promoção só é válida para produtos que correspondem ao tipo de produto especificado neste atributo. |
|
Marca Sintaxe
|
A promoção só se aplica a produtos que correspondem à marca especificada neste atributo. |
|
ID do grupo de itens
Sintaxe
|
A promoção é válida para produtos que correspondem ao ID do grupo de itens |
|
ID do item excluído
Sintaxe
|
Os produtos com um desses IDs de item são excluídos da promoção. |
|
Tipos de produtos excluídos
Sintaxe
Exemplo Argolas |
Os produtos com um desses tipos de produto são excluídos da promoção. |
|
Marcas excluídas Sintaxe
Exemplo Produtos Acme |
Os produtos com uma dessas marcas são excluídos da promoção. |
|
ID do grupo de itens excluído Sintaxe
|
Os produtos com um ID do grupo de itens excluído são removidos da promoção. |
|
Rótulo personalizado 0 a 4
Sintaxe
|
A promoção só é válida para produtos que correspondem aos rótulos personalizados especificados nesse atributo. |
|
Rótulo personalizado 0 a 4 excluído
Sintaxe
|
Os produtos com um desses rótulos personalizados são excluídos da promoção. |
Detalhes da promoção
As seções a seguir descrevem os diferentes atributos que você pode usar para criar promoções estruturadas, como "Compre N, ganhe M".
- Condições prévias são usadas para definir os requisitos que o usuário precisa atender para resgatar a promoção.
- As categorias de promoção determinam o tipo de promoção.
- Os limites determinam as restrições que podem ser aplicadas às promoções. Por exemplo, é possível definir um limite para a quantidade ou preço mínimo de compras qualificadas necessárias para o usuário receber uma promoção.
Condições prévias
Esse atributo informa a condição prévia ou um montante mínimo da compra que o cliente precisa atender para resgatar uma promoção. Ele não filtra os produtos qualificados para uma promoção. Para filtrar, use os filtros de produto.
Por exemplo, se você quiser criar:
- Em uma promoção "Frete grátis com a compra de R$ 50", defina o montante mínimo da compra
[minimum_purchase_amount]como 50 BRL. - Em uma promoção "Mochila gratuita com R$ 100 de compra" defina o atributo de montante mínimo da compra
[minimum_purchase_amount]como 100 BRL.
| Atributo | Descrição |
|---|---|
Montante mínimo da compra: [minimum_purchase_amount]
Sintaxe As fontes de promoções aceitam moedas apenas das localidades especificadas. Exemplo 20 BRL |
Este atributo define o valor mínimo da compra para a promoção ser resgatada. Por exemplo, para X quantidade de compras do mesmo produto ou uma combinação de produtos, o cliente vai receber a promoção Y. O valor do montante mínimo da compra precisa ser igual ou maior que 1. |
|
Quantidade mínima de compra da promoção
Sintaxe Precisa ser um número inteiro Exemplo
|
O atributo especifica a quantidade necessária de itens para se qualificar para a promoção. |
|
Restrição de resgate
Exemplo Tipo enumerado |
Lista de valores:
|
|
Condição de resgate personalizada
Sintaxe
|
Esse atributo define a condição de resgate personalizada se redemption_restriction for custom. |
Categorias de promoção
A tabela abaixo mostra os tipos de categorias de promoção. Especifique uma categoria de promoção para criar uma promoção estruturada, como uma promoção “Compre 1, ganhe 1 grátis”. Saiba mais sobre os atributos de dados estruturados.
Você pode associar apenas uma categoria de promoção a um ID da promoção [promotion_id]. É possível restringir ainda mais uma categoria de promoção com limites. Confira os Limites.
| Atributo | Descrição |
|---|---|
|
Valor da porcentagem de desconto
Sintaxe Precisa ser um número inteiro Exemplo 10 |
Este atributo especifica o desconto percentual oferecido na promoção. Por exemplo, 10% de desconto. |
|
Valor do desconto da promoção
Sintaxe Precisa ser um número e a moeda Exemplo 20.00 BRL |
Este atributo especifica o valor do desconto. Por exemplo, 20.00 BRL de desconto. |
|
Quantidade qualificada para a promoção
Sintaxe Precisa ser um número inteiro Exemplo 2 |
Esse atributo especifica a quantidade de itens a que a promoção ou desconto se aplica e quando o tipo de promoção é Por exemplo, defina esse atributo como 1 no caso de uma promoção "Compre 2, ganhe 1" (100% de desconto). |
|
Frete grátis
Valores compatíveis
Observação: este atributo não está disponível para promoções locais |
Este atributo especifica o tipo de frete grátis oferecido na promoção. |
|
Valor do brinde
Sintaxe Precisa ser um número e especificar a moeda Exemplo 400.00 BRL |
Este atributo especifica o valor monetário do brinde oferecido na promoção. |
|
Descrição do brinde
Sintaxe A string não deve exceder 100 caracteres Exemplo Bolsa gratuita com compras no valor de R$ 100. |
Esse atributo é a descrição, e não o valor, de um brinde oferecido na promoção. Em vez disso, use o atributo de ID do item de brinde |
|
ID do item de brinde
Sintaxe
|
Esse atributo vai especificar um brinde se for um item na fonte de dados de produto. O ID do produto da promoção É preciso mapear o ID do produto da promoção |
|
Tipo de valor do cupom
Valores aceitos:
|
Esse atributo indica o tipo de promoção que você está exibindo. Assim o Google pode realizar uma análise mais automatizada, o que acelera a aprovação da promoção. Quando você usa o atributo opcional de tipo de valor do cupom Por exemplo, se você definir o atributo de tipo de valor do cupom Observação: os atributos [coupon_value_type]. |
|
Valor mínimo do desconto
Sintaxe Precisa ser um número e especificar a moeda. Exemplo R$ 50 |
Defina essa opção se Se
|
|
Valor máximo do desconto
Sintaxe Precisa ser um número e especificar a moeda. Exemplo R$ 50 |
Defina essa opção se Se
money_off_range não for especificado. |
|
Porcentagem mínima de desconto |
Defina essa opção se Se
|
|
Porcentagem máxima de desconto |
Esse atributo é um número entre 1 e 99 e precisa ser maior que Defina essa opção se Se
percent_off_range não for especificado. |
Atributos para usar com coupon_value_type na fonte de promoções
A lista a seguir inclui os valores compatíveis do tipo de valor do cupom [coupon_value_type] e os atributos de fonte de dados obrigatórios e opcionais para cada um deles.
Sem dados estruturados [no_structured_data]
- Obrigatório: nenhum
- Opcional: montante mínimo da compra
[minimum_purchase_amount], quantidade mínima de compra da promoção[buy_this_quantity], quantidade de compra máxima na promoção[limit_quantity], preço promocional[promotion_price], valor do desconto da promoção[money_off_amount], valor da porcentagem de desconto[percent_off], quantidade qualificada para a promoção[get_this_quantity_discounted], valor do brinde [free_gift_value], ID do item de brinde[free_gift_item_id], descrição do brinde[free_gift_description], restrição de resgate [redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Valor do desconto [money_off]
- Obrigatório: valor do desconto da promoção
[money_off_amount] - Opcional: montante mínimo da compra
[minimum_purchase_amount], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Porcentagem de desconto [percent_off]
- Obrigatório: porcentagem de desconto
[percent_off] - Opcional: montante mínimo da compra
[minimum_purchase_amount], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Compre m e leve n com um desconto de x [buy_m_get_n_money off]
- Obrigatórios: valor do desconto da promoção
[money_off_amount], quantidade mínima de compra da promoção[buy_this_quantity]e quantidade qualificada para a promoção[get_this_quantity_discounted] - Opcional: restrição de resgate
[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Compre m e leve n com um desconto [buy_m_get_n_percent_off]
- Obrigatórios: valor da porcentagem de desconto
[percent_off], quantidade mínima de compra da promoção[buy_this_quantity]e quantidade qualificada para a promoção[get_this_quantity_discounted] - Opcional: restrição de resgate
[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Compre m e ganhe um desconto de x [buy_m_get_money_off]
- Obrigatórios: valor do desconto da promoção
[money_off_amount]e quantidade mínima de compra da promoção[buy_this_quantity] - Opcional: restrição de resgate
[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Compre m e ganhe x de desconto [buy_m_get_percent_off]
- Obrigatórios: valor da porcentagem de desconto
[percent_off]e quantidade mínima de compra da promoção[buy_this_quantity] - Opcional: restrição de resgate
[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Brinde [free_gift]
- Obrigatório: descrição do brinde
[free_gift_description] - Opcional: montante mínimo da compra
[minimum_purchase_amount], quantidade mínima de compra da promoção[buy_this_quantity], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Valor do brinde [free_gift_with_value]
- Obrigatório: valor do brinde
[free_gift_value] - Opcional: montante mínimo da compra
[minimum_purchase_amount], quantidade mínima de compra da promoção[buy_this_quantity], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
ID do item de brinde [free_gift_with_item_id]
- Obrigatório: ID do item de brinde
[free_gift_item_id] - Opcional: montante mínimo da compra
[minimum_purchase_amount], quantidade mínima de compra da promoção[buy_this_quantity], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Padrão de frete grátis [free_shipping_standard]
- Obrigatório: nenhum
- Opcional: tipo de frete grátis
[free_shipping_type], montante mínimo da compra[minimum_purchase_amount], quantidade mínima de compra da promoção[buy_this_quantity], quantidade mínima de compra da promoção[buy_this_quantity], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Frete grátis no próximo dia [free_shipping_overnight]
- Obrigatório: nenhum
- Opcional: tipo de frete grátis
[free_shipping_type], montante mínimo da compra[minimum_purchase_amount], quantidade mínima de compra da promoção[buy_this_quantity], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Frete grátis em dois dias [free_shipping_two_day]
- Obrigatório: nenhum
- Opcional: tipo de frete grátis
[free_shipping_type], montante mínimo da compra[minimum_purchase_amount], quantidade mínima de compra da promoção[buy_this_quantity], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Frete grátis com a configuração de frete [free_shipping_with_shipping_config]
- Obrigatório: nenhum
- Opcional: nenhum
Cashback [cash_back]
- Obrigatório: valor de cashback
[cash_back_amount] - Opcional: montante mínimo da compra
[minimum_purchase_amount], quantidade mínima de compra da promoção[buy_this_quantity], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Porcentagem de cashback [percentage_cash_back]
- Obrigatório: porcentagem de cashback
[cash_back_percentage] - Opcional: montante mínimo da compra
[minimum_purchase_amount], quantidade mínima de compra da promoção[buy_this_quantity], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Intervalo de valor do desconto [money_off_range]
- Obrigatório: valor mínimo do desconto da promoção
[min_money_off_amount]e valor máximo do desconto da promoção[max_money_off_amount]. Defina um desses atributos ou ambos. - Opcional: montante mínimo da compra
[minimum_purchase_amount], quantidade mínima de compra da promoção[buy_this_quantity], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Intervalo de porcentagem do desconto [percent_off_range] porcentagem do desconto [percent_off_range]
- Obrigatório: valor mínimo da porcentagem de desconto
[min_percent_off_amount]e valor máximo da porcentagem de desconto[max_percent_off_amount]. Defina um desses atributos ou ambos. - Opcional: montante mínimo da compra
[minimum_purchase_amount], quantidade mínima de compra da promoção[buy_this_quantity], restrição de resgate[redemption_restriction], condição de resgate personalizada[custom_redemption_restriction]
Limites
Esses atributos informam os limites que o cliente precisa atingir para resgatar uma promoção. Os limites não filtram os produtos qualificados para uma promoção. Para fazer a filtragem, use os filtros de produto.
Por exemplo:
- "Compre um, leve dois, até 10 itens" e defina a quantidade de compra máxima na promoção
[limit_quantity]como 10. - "10% de desconto até US$ 100", define o limite máximo de desconto
[max_discount_amount]como US$ 100.
| Atributo | Descrição |
|---|---|
|
Quantidade de compra máxima na promoção
Sintaxe Precisa ser um número inteiro Exemplo 5 |
Esse atributo é usado para informar a quantidade máxima de itens que podem ser comprados usando a promoção. |
|
Limite máximo do valor do desconto
Sintaxe Precisa ser um número e especificar a moeda. Exemplo R$ 50 |
Esse atributo informa o valor máximo do desconto da promoção. Ele é usado no tipo de valor do cupom |
Atributos adicionais
| Atributo | Descrição |
|---|---|
|
Datas de exibição da promoção
Sintaxe As datas de início e de término são separadas por uma barra (/). O formato da data é (AAAA-MM-DD), seguido pela letra "T", a hora do dia em que a venda começa ou termina e uma expressão do fuso horário da venda. Exemplo Se sua promoção era válida das 3h de 19 de julho de 2009 às 21h de 26 de julho de 2009 EST (horário padrão do leste dos EUA), você teria enviado:
Se sua promoção era válida das 3h de 19 de julho de 2009 às 21h de 26 de julho de 2009 GMT (horário de Greenwich), você teria enviado:
|
Importante:
Esse atributo especifica a data e o período em que a promoção será publicada no Google.com.br e nos anúncios do Shopping. Se o atributo datas de exibição da promoção |
|
Sintaxe
|
Este atributo especifica a descrição da promoção. A descrição não é exibida aos clientes |
|
Código de resgate genérico
Sintaxe
Exemplo EXTRA20 |
Esse atributo especifica o código que os clientes podem usar on-line para resgatar a promoção. Ele é obrigatório quando o código do cupom necessário Observação: todas as promoções de frete precisam incluir um código de resgate válido. As promoções de frete grátis precisam incluir um código do cupom válido que os compradores possam aplicar manualmente. Caso contrário, o frete vai ser considerado como um serviço que normalmente é oferecido e precisa ser especificado na fonte de dados do produto. Se a promoção for oferecida por uma duração específica, esse período também precisará ser refletido na fonte de dados de produto. Consulte as políticas do programa de promoções para mais informações. |
|
Letras miúdas da promoção
Sintaxe
|
Esse atributo é o texto dos termos e condições relativos à promoção, como restrições e exclusões. Os clientes têm acesso aos termos e condições junto com o código de resgate genérico. |
|
Preço promocional
Sintaxe Precisa ser um número e a moeda. Exemplo R$ 15 |
Esse atributo é o preço promocional de um item ou categoria. Por exemplo, uma promoção em que todos os jeans custam R$ 50. O preço promocional está disponível para clientes que inserem um código ou atendem aos requisitos da promoção. |
Para mostrar seu interesse no programa de promoções, preencha este formulário.
Criar um evento promocional no feed
Siga o CSV de exemplo para fazer upload de produtos e eventos.
Confira as explicações detalhadas sobre os atributos relacionados aos eventos de venda.
O evento promocional está disponível apenas para promoções segmentadas para os Estados Unidos.
| Atributo | Formato | Descrição |
|---|---|---|
Destino da promoção [promotion_destination] |
Valor compatível
|
No momento, para se inscrever em eventos, você precisa definir [Free_listings] como o único destino da promoção. |
Tipo de valor do cupom [coupon_value_type] |
Valores compatíveis
|
Todos os tipos de valor de cupom atuais são compatíveis com o evento. |
|
Aplicabilidade do evento
|
Valores compatíveis
[specific_categories] |
A aplicabilidade do evento para essa promoção. Se a aplicabilidade do evento estiver definida como A aplicabilidade do evento, que indica o evento, não pode ser definida com a aplicabilidade do produto Se você definir um evento, a Aplicabilidade do evento vai ser um campo obrigatório. Caso contrário, o campo Aplicabilidade do produto |
URL da promoção [promotion_url] |
Obrigatório para o evento Sintaxe
|
|
Categoria Google do produto[google_product_category] |
Opcional Defina essa opção se Valores compatíveis Categoria Google do produto predefinida: o ID ou o caminho completo da categoria do produto. É possível enviar o ID ou o caminho completo, mas não ambos. Faça o download da lista de todas as categorias Google do produto: Para evitar texto truncado na versão .txt: altere a codificação do seu navegador para Unicode UTF-8.
Campo repetido Sim. São aceitas até cinco categorias Google do produto. |
Exemplo
ou
|