Especificações da fonte de dados de promoções locais

As informações fornecidas sobre as promoções locais são veiculadas em anúncios locais na guia "Shopping" e exibidas em computadores e dispositivos móveis. Para isso, faça upload de uma fonte que contenha informações sobre as promoções que você usa nas lojas. As informações devem ser precisas e incluir todos os atributos que você usa para descrever as promoções locais.

Uma fonte de dados é um arquivo XML, um arquivo delimitado por tabulações ou uma planilha do Google enviada ao Google Merchant Center e pode incluir várias entradas. Faça upload da fonte de promoções na mesma conta do Merchant Center usada para a fonte de dados de produtos.

Observação: a mesma fonte de promoções pode ser usada em ofertas on-line e na loja física.

Neste artigo, vamos conhecer os atributos disponíveis para uma fonte de promoções específica de promoções locais. Para conferir um exemplo de fonte de promoções, clique no botão abaixo.

Baixar um exemplo de fonte de dados

Observação importante

• Todas as promoções são analisadas com base nas políticas do programa de promoções e nos requisitos editoriais.
• Recomendamos o uso de atributos de dados estruturados para ofertas enviadas com uma fonte de promoções. Saiba mais sobre os atributos de dados estruturados.
• Ofertas relacionadas ao frete não são aceitas em promoções locais.
• Fornecer uma fonte de promoções não afeta suas classificações no Google.

Atributos obrigatórios

ID da promoção [promotion_id]

Esse é o ID exclusivo de uma promoção. Para promoções na loja física válidas para produtos específicos, os valores de ID da promoção [promotion_id] na sua fonte de promoções precisam corresponder aos valores desse atributo na sua fonte de dados de produtos. Isso permitirá que o Google identifique a quais produtos a promoção será aplicada.

Importante:

• o ID da promoção diferencia maiúsculas de minúsculas. Se você estiver mapeando uma promoção específica para um conjunto de produtos na sua fonte de dados de produtos, ela deve ser escrita da mesma maneira nas duas fontes de dados.
• O ID da promoção não pode conter espaços ou símbolos (por exemplo, %, ! etc.).
• Para adicionar vários valores de ID da promoção a um item (é possível adicionar até 10 por item), envie-os separados por vírgulas na coluna "ID da promoção" da sua fonte de dados de produtos.
• O ID da promoção não pode ter mais de 60 caracteres.

Produtos qualificados para a promoção [product_applicability]

Indica se a promoção é aplicável a todos os produtos ou somente a produtos específicos.

Valores válidos:

• Todos os produtos [all_products]
• Produtos específicos [specific_products]

Importante:

• se o valor for definido como specific_products, os atributos de segmentação de produto serão usados para determinar para quais produtos a promoção é válida. Consulte os atributos opcionais abaixo para saber mais sobre a segmentação de produtos.
• Se o valor for definido como all_products, os filtros de segmentação de produtos serão ignorados.

Código do cupom necessário [offer_type]

Esse atributo indica se você precisa ou não que os compradores on-line usem um código para resgatar a oferta.

Valores válidos:

• Sem código [no_code]
• Código genérico [generic_code]

Observação: se o valor do atributo código do cupom necessário [offer_type] for definido como generic_code (ou seja, o mesmo código para todos os compradores), o atributo código de resgate genérico [generic_redemption_code] também será obrigatório.

Código de resgate genérico [generic_redemption_code]

Esse atributo especifica o código (exemplo: EXTRA20) que os compradores usarão on-line para resgatar a promoção.

Importante:

• É obrigatório se o atributo de código do cupom necessário [offer_type] estiver definido como generic_code.
• O valor enviado para o atributo de código de resgate genérico [generic_redemption_code] não pode exceder 20 caracteres.

Título da promoção [long_title]

Este é o título completo da promoção. Estes requisitos editoriais descrevem as diretrizes e a formatação dos títulos, além de fornecer exemplos do que é ou não aceitável.

Importante:

• O título da promoção [long_title] precisa descrever a promoção de forma completa e precisa.
• Ele não pode exceder 60 caracteres.

Data de início da promoção [promotion_effective_dates]

Esse atributo indica as datas e o período em que a promoção está ativa. Sintaxe:

• Formato de data: AAAA-MM-DD
• Formato de hora: HH:MM:SS, sem incluir a conversão necessária para GMT (veja abaixo).
  • Os horários são baseados no fuso horário de Greenwich (GMT, na sigla em inglês). Portanto, também é necessário incluir o número de horas e minutos (+HH:MM ou -HH:MM) em que seu horário é diferente do GMT, imediatamente depois.
    • Por exemplo, se o horário da promoção for em PST (Horário Padrão do Pacífico), adicione "-08:00", já que o Horário do Pacífico é oito horas antes do GMT.
• As datas e os horários devem ser separados pela letra "T".
• Primeiro, liste a data e o horário de início, seguidos pela data e horário de término, separando-os com uma barra (/).

Exemplos:

• Se sua promoção era válida das 3h de 19 de julho de 2019 às 21h de 26 de julho de 2019 EST (horário padrão do leste dos EUA), você teria enviado:
  • 2019-07-19T03:00:00-05:00/2019-07-26T21:00:00-05:00
• Se sua promoção era válida das 3h de 19 de julho de 2019 às 21h de 26 de julho de 2019 GMT (horário de Greenwich), você teria enviado:
  • 2019-07-19T03:00:00+00:00/2019-07-26T21:00:00+00:00

Importante:

• Ajuste o horário de verão, quando aplicável:
  • No horário padrão, "-05:00" representa EST, enquanto "-08:00" representa PST.
  • Durante o horário de verão, "-04:00" representa EDT, enquanto "-07:00" representa PDT.

Qualificação on-line para promoção [redemption_channel]

Esse atributo indica onde sua promoção é oferecida.

Valores válidos:

• in_store
• online
• online_and_in_store

Importante:

• Se você tiver uma promoção omnichannel (disponível tanto na loja física quanto on-line), envie o valor como online_and_in_store.
• Se esse valor for deixado em branco, sua promoção será definida como on-line por padrão.
  • As promoções on-line não serão restritas ao raio da loja da região e aparecerão nos seus anúncios do Shopping on-line.

Aplicabilidade às lojas [store_applicability]

Esse atributo indica se a promoção é aplicável a todas as lojas ou somente a lojas específicas.

Valores válidos:

• all_stores
• specific_stores

Importante:

• Se specific_stores for selecionado, também será necessário usar os atributos inclusão de códigos das lojas [store_codes_inclusion] ou exclusão de códigos das lojas [store_codes_exclusion].
• Se o valor all_stores for selecionado, os atributos inclusão e exclusão de códigos das lojas (veja abaixo) serão ignorados.

URL da promoção [promotion_url]

O URL da promoção precisa ser um link que direcione para a página do site em que os clientes possam encontrar os detalhes da promoção. Ela pode ser uma página do site que descreve a promoção, uma página com o banner promocional ou aquela em que a imagem do banner promocional está hospedada. O link é usado como parte do processo de aprovação da promoção para verificar a aplicabilidade local e se ela pode ser resgatada na loja ou como retirada no local. Ele também é usado para verificar se os clientes não precisam realizar outras etapas para resgatar a promoção na loja, além de apresentar um código de cupom ou um código de barras. As informações na página com os detalhes da sua promoção precisam corresponder aos dados enviados.

Destino da promoção [promotion_destination]

Esse atributo indica o destino da promoção.

Valores válidos:

• destino da promoção [promotion_destination]: anúncios de inventário local [local_inventory_ads]
• destino da promoção [promotion_destination]: anúncios do Shopping [Shopping_ads]
• destino da promoção [promotion_destination]: listagens no programa Comprar com o Google [Buy_on_Google_listings]
• destino da promoção [promotion_destination]: listagens gratuitas [Free_listings]

Atributos relacionados à loja

Inclusão de códigos das lojas [store_codes_inclusion]

Esse atributo indica as lojas específicas a que sua promoção se aplica.

Importante:

• Se a promoção se aplicar a specific_stores, liste esses códigos de loja conforme enviados para seus Perfis de Empresas.
• Você pode usar o atributo de inclusão de códigos das lojas [store_codes_inclusion] ou de exclusão de códigos das lojas [store_codes_exclusion], mas não ambos simultaneamente.

Exclusão de códigos das lojas [store_codes_exclusion]

Esse atributo indica as lojas específicas em que sua promoção é excluída.

Importante:

• Se a promoção excluir specific_stores, liste esses códigos de loja conforme enviados para seus Perfis de Empresas.
• Você pode usar o atributo de exclusão de códigos das lojas [store_codes_exclusion] ou de inclusão de códigos das lojas [store_codes_inclusion], mas não ambos simultaneamente.

Atributos opcionais

Atributos de segmentação de produtos

Os atributos de segmentação de produtos são "filtros" opcionais que permitem especificar a quais produtos a oferta pode ser aplicada diretamente na fonte de promoções.

Como alternativa, adicione o atributo ID da promoção [promotion_id] diretamente aos produtos na fonte de dados de produtos.

ID do produto da promoção [item_id]

Esse atributo mapeia a promoção de itens específicos na sua fonte de dados de produtos.

Se o atributo produtos qualificados para a promoção [product_applicability] estiver definido como specific_products para suas promoções, a definição do atributo de ID do item mapeará sua promoção para os itens representados pelos IDs associados na sua fonte de dados de produtos.

Importante:

• até 20 IDs de produtos podem ser mapeados para uma única promoção na sua fonte de promoções.
• Não use o atributo ID do produto da promoção [item_id] se quiser atribuir a promoção a mais de 20 itens. Em vez disso, adicione o ID da promoção diretamente aos itens na sua fonte de dados de produtos.

Categoria Google do produto [google_product_category]

Esse atributo mapeia a promoção para uma categoria específica de produtos na sua fonte de dados de produtos.

Se o atributo produtos qualificados para a promoção [product_applicability] estiver definido como specific_products, a definição do atributo Categoria Google do produto[google_product_category] permitirá mapear a promoção para uma categoria específica de produtos do Google.

Importante:

• Não defina este atributo se houver exclusões na categoria. Se esse for o caso, será necessário mapear manualmente o ID da promoção [promotion_id] para os itens qualificados na sua fonte de dados de produtos ou usar o atributo ID do produto da promoção [item_id] (confira acima) para mapear os itens qualificados na sua fonte de promoções. Para mais detalhes sobre mapeamento, acesse o artigo Escolher produtos para sua promoção no nosso guia de implementação de promoções.
• As categorias de nível mais alto, como "Vestuário e acessórios" (166) ou "Mídia" (783), não são compatíveis. Se seus produtos se encaixarem em uma delas, você precisará fornecer uma categoria mais granular. Por exemplo: Vestuário e acessórios > Roupas > Roupas esportivas > Roupas de ciclismo (5697).

Tipo de produto [product_type]

Esse atributo mapeia a promoção para um ou vários tipos específicos de produto na sua fonte de dados de produtos.

Se o atributo produtos qualificados para a promoção [product_applicability] estiver definido como specific_products, configure o atributo tipo de produto [product_type] para mapear a promoção para um ou mais tipos de produtos.

Importante:

• Não defina este atributo se houver exclusões nos tipos de produto. Se esse for o caso, será necessário mapear manualmente o ID da promoção [promotion_id] para os itens qualificados na sua fonte de dados de produtos ou usar o atributo ID do produto da promoção [item_id] (confira acima) para mapear os itens qualificados na sua fonte de promoções (para até 20 itens). Para mais detalhes sobre mapeamento, acesse o artigo Escolher produtos para sua promoção no nosso guia de implementação de promoções.

Marca [brand]

O atributo de marca mapeia sua promoção para uma marca específica na sua fonte de dados de produtos.

Se o atributo produtos qualificados para a promoção [product_applicability] estiver definido como specific_products, configure o atributo de marca para mapear sua promoção para marcas selecionadas.

Importante:

• É possível especificar até 10 marcas. Separe cada marca listada com uma vírgula.
• As marcas diferenciam espaços e maiúsculas de minúsculas e devem ter a mesma grafia da fonte de dados de produtos.
• Não defina este atributo se houver exclusões nas marcas. Se esse for o caso, será necessário mapear manualmente o ID da promoção [promotion_id] para os itens qualificados na sua fonte de dados de produtos ou usar o atributo ID do produto da promoção [item_id] (confira acima) para mapear os itens qualificados na sua fonte de promoções (para até 20 itens). Para mais detalhes sobre mapeamento, acesse o artigo Escolher produtos para sua promoção no nosso guia de implementação de promoções.

ID do item excluído [item_id_exclusion]

O atributo ID do item excluído permite excluir da promoção itens específicos na sua fonte de dados de produtos.

Se o atributo de produtos qualificados para a promoção [product_applicability] estiver definido como specific_products, a definição do atributo ID do item excluído [item_id_exclusion] mapeará sua promoção para todos os IDs de itens na sua fonte de dados de produtos, exceto para aqueles indicados aqui.

Exclusão da categoria Google do produto [google_product_category_exclusion]

O atributo de exclusão da categoria Google do produto permite que você exclua da promoção todos os itens de uma categoria específica de produtos na sua fonte de dados de produtos.

Se o atributo aplicabilidade do produto [product_applicability] estiver definido como specific_products, a definição do atributo exclusão da categoria Google do produto excluirá da promoção todos os itens com a mesma categoria de produtos na sua fonte de dados de produtos.

Importante:

• Não defina este atributo se houver itens qualificados na categoria. Se esse for o caso, será necessário mapear manualmente o ID da promoção [promotion_id] para os itens qualificados na sua fonte de dados de produtos ou usar o atributo ID do produto da promoção [item_id] (confira acima) para mapear os itens qualificados na sua fonte de promoções (para até 20 itens). Para mais detalhes sobre mapeamento, acesse o artigo Escolher produtos para sua promoção no nosso guia de implementação de promoções.

Tipos de produtos excluídos [product_type_exclusion]

O atributo tipos de produtos excluídos permite excluir da promoção um ou mais tipos de produto na sua fonte de dados de produtos.

Se o atributo produtos qualificados para a promoção [product_applicability] estiver definido como specific_products, a definição do atributo de tipos de produtos excluídos [product_type_exclusion] excluirá da promoção todos os itens com o mesmo tipo de produto na sua fonte de dados de produtos.

Importante:

• É possível especificar até 10 tipos de produtos. Separe cada tipo de produto listado com uma vírgula.
• Não defina este atributo se houver algum item qualificado nos tipos de produtos. Se esse for o caso, será necessário mapear manualmente o ID da promoção [promotion_id] para os itens qualificados na sua fonte de dados de produtos ou usar o atributo ID do produto da promoção [item_id] (confira acima) para mapear os itens qualificados na sua fonte de promoções (para até 20 itens). Para mais detalhes sobre mapeamento, acesse o artigo Escolher produtos para sua promoção no nosso guia de implementação de promoções.

Marcas excluídas [brand_exclusion]

O atributo marcas excluídas permite remover da promoção uma ou mais marcas na sua fonte de dados de produtos.

Se o atributo produtos qualificados para a promoção [product_applicability] estiver definido como specific_products, a definição do atributo marcas excluídas [brand_exclusion] excluirá da promoção todos os itens com a marca (ou as marcas) na sua fonte de dados de produtos.

Importante:

• É possível especificar até 10 marcas. Separe cada marca listada com uma vírgula.
• As marcas diferenciam espaços e maiúsculas de minúsculas e devem ter a mesma grafia da fonte de dados de produtos.
• Não defina este atributo se houver itens qualificados com as marcas. Se esse for o caso, será necessário mapear manualmente o ID da promoção [promotion_id] para os itens qualificados na sua fonte de dados de produtos ou usar o atributo ID do produto da promoção [item_id] (confira acima) para mapear os itens qualificados na sua fonte de promoções (para até 20 itens). Para mais detalhes sobre mapeamento, acesse o artigo Escolher produtos para sua promoção no nosso guia de implementação de promoções.

Tags da promoção [promotion_tags]

O atributo tags da promoção permite especificar subconjuntos em categorias de produtos, tipos de produtos e marcas a que sua promoção será aplicada. Esse atributo pode ser definido como pares dos atributos listados anteriormente e os valores específicos deles para especificar um subconjunto de itens na sua fonte de dados de produtos.

Sintaxe:

• Chaves aceitáveis: google_product_category, product_type, brand
• Formato: {attribute1: “valueA”, attribute2: “valueB”}
• O tamanho máximo é de 500 caracteres.

Exemplo:

• {brand: “Nike”, google_product_category: “Apparel & Accessories > Shoes”}

Importante:

• O atributo tags da promoção [promotion_tags] deve ser usado quando a promoção se aplicar a um subconjunto específico dos itens de uma categoria, tipo ou marca e os códigos dos itens específicos não forem conhecidos.

VOLTAR À PÁGINA INICIAL DO PROMOÇÕES