Documentation

Atributo Sale Price Effective Date

O atributo sale_price_effective_date (data de validade do preço promocional) define o período específico de data e hora em que seu sale_price é aplicado. Esse atributo permite que você pré-agende promoções em plataformas como Google Merchant Products, Facebook Products,Pinterest Products, Tiktok Products e Reddit Products.

O envio de datas de vigência precisas garante que seus preços com desconto sejam aplicados e removidos automaticamente, evitando violações de políticas relacionadas a incompatibilidade de preços entre seus anúncios e páginas de destino.

Índice:


Verificação Rápida de Sintaxe

Cole o snippet XML <g:sale_price_effective_date> ou o valor do CSV abaixo para validar o formato:

Test your <g:sale_price_effective_date>

Live Check
<g:sale_price_effective_date>

Checking one by one? Validate your entire feed instantly.

Upload & Analyze File

Comparação de Requisitos por Plataforma

Embora todas as plataformas usem padrões ISO 8601, há convenções de nomenclatura e comportamentos específicos de cada plataforma.

Requisito Google Merchant Products Facebook Products Pinterest Products Tiktok Products Reddit Products
Tag XML <g:sale_price_effective_date> <g:sale_price_effective_date> <g:sale_price_effective_date> <g:sale_price_effective_date> <g:sale_price_effective_date>
Cabeçalho CSV sale_price_effective_date sale_price_effective_date sale_price_effective_date_attribute sale_price_effective_date sale_price_effective_date
Formato ISO 8601 / ISO 8601 ISO 8601 / ISO 8601 ISO 8601 / ISO 8601 ISO 8601 / ISO 8601 ISO 8601 / ISO 8601
Fuso Horário Padrão UTC se omitido Explícito recomendado Explícito recomendado Explícito recomendado Explícito recomendado
Tamanho Máx. 51 caracteres Padrão Padrão Padrão 51 caracteres
Notas Especiais Começa à meia-noite se a hora for omitida Exige data de início e término Usa um nome de coluna específico em CSV Atualmente não é estritamente aplicado para expiração Substitui o preço normal apenas durante esta janela

Requisitos Gerais de Formatação

Para agendar com sucesso suas promoções, siga as seguintes regras rígidas de formatação:

  • Conformidade com a ISO 8601: Datas e horários devem ser formatados como YYYY-MM-DDThh:mm[±hhmm] ou YYYY-MM-DDThh:mmZ.
  • Separador: A data/hora de início e a data/hora de término DEVEM ser separadas por uma única barra (/).
  • Designador de Tempo: Use a letra maiúscula T para separar a data do horário.
  • Deslocamento de Fuso Horário: Sempre inclua o deslocamento do fuso horário em relação ao UTC (ex.: -0300, +02:00) ou use Z para UTC. Se omitido, plataformas como o Google Merchant Products adotarão o UTC como padrão.
  • Dependência: Esse atributo é totalmente ignorado caso o sale_price não seja fornecido.

Exemplos de Formatação

Formato de Feed XML

Formatação Correta: Usa o designador 'T', inclui o deslocamento de fuso horário e separa o início e o término com uma barra.

<g:sale_price>19.99 BRL</g:sale_price>
<g:sale_price_effective_date>2026-11-25T00:00-03:00/2026-11-30T23:59-03:00</g:sale_price_effective_date>

Formatação Incorreta: Falta do designador 'T', ausência do fuso horário e não utilização da barra separadora.

<!-- Incorrect: Missing 'T' separator, timezone, and uses 'to' instead of a slash -->
<g:sale_price_effective_date>2026-11-25 00:00 to 2026-11-30 23:59</g:sale_price_effective_date>

Formato de Feed CSV / TSV

Ao trabalhar com arquivos CSV, mantenha a string contígua, sem espaços em volta da barra. Observe que o Pinterest Products espera um nome de cabeçalho específico nos arquivos CSV.

Formatação Correta: Intervalos de datas válidos com indicadores de fuso horário.

id,title,price,sale_price,sale_price_effective_date
SKU123,Jaqueta Premium,150.00 BRL,99.00 BRL,2026-12-01T00:00Z/2026-12-31T23:59Z

Formatação Correta (Pinterest CSV): Usa o cabeçalho de coluna específico do Pinterest.

id,title,price,sale_price,sale_price_effective_date_attribute
SKU124,Camiseta de Verão,25.00 BRL,15.00 BRL,2026-06-01T09:00:00.000Z/2026-06-15T21:00:00.000Z

Formatação Incorreta: Formatos de datas inválidos e a ausência de barras farão com que o upload do feed falhe.

id,title,price,sale_price,sale_price_effective_date
SKU125,Tênis de Corrida,80.00 BRL,50.00 BRL,11/25/2026-11/30/2026

FAQ

O que acontece se eu enviar um preço promocional sem uma data de validade?
Se você fornecer um sale_price, mas omitir a data de validade, o preço promocional permanecerá ativo indefinidamente até que você o remova do seu feed.
Como formato as datas de início e término?
Você deve usar o formato ISO 8601 (YYYY-MM-DDThh:mmZ) e separar as datas de início e término com uma barra (/). Por exemplo: 2026-11-20T00:00-0800/2026-11-30T23:59-0800.
Fusos horários são obrigatórios?
Embora algumas plataformas como Google Merchant Products usem UTC como padrão caso nenhum fuso horário seja fornecido, é altamente recomendável declarar explicitamente o fuso horário (ex.: +00:00, Z ou -0300) para garantir que suas promoções comecem e terminem exatamente quando planejado.

Have thousands of products? Don't check them manually. Upload your file and find errors in 30 seconds.

Try Validator
Last updated: 17 março, 2026