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 CheckChecking 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]ouYYYY-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
Tpara 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 useZpara 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_pricenã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