2026-11-24 · 11 min
Harga Promo Sudah Berubah, Schema Belum: Sinkronkan JSON-LD Product
Setiap mendekati gajian 25 dan pra-Black Friday, pola yang saya temui di klien UMKM Tangerang selalu sama: pemilik toko mengubah harga di halaman produk, menambahkan label promo, lalu lupa satu hal yang tidak terlihat pengunjung. Schema markup product di balik layar masih menyimpan harga minggu lalu. Kadang lebih buruk lagi, promonya sudah ditandai lewat priceValidUntil tiga hari yang lalu, tapi tidak ada yang sadar karena halamannya sendiri terlihat baik-baik saja.
Masalah ini berbeda dari seri sebelumnya. JSON-LD LocalBusiness untuk landing page SMB membahas data identitas yang jarang berubah, dan schema markup menu restoran membahas menu yang berubah tiap beberapa bulan. Harga promo musiman berubah dalam hitungan hari, dan di periode itulah markup paling sering basi. Tulisan ini bagian dari pilar Search & Backend untuk Bisnis Lokal, untuk toko yang jualan lewat website sendiri, bukan marketplace. Untuk fondasi basis data di balik tabel produk, lihat juga skema database multi-tenant.
Skenario yang kita pakai: toko batik dan kemeja di Karawaci, Tangerang, katakanlah “Batik Lippo Karawaci” (nama fiktif). Mereka memasang promo gajian 25 November: kemeja flanel turun dari Rp150.000 menjadi Rp119.000 sampai 29 November. Harga di halaman berubah jam 00.00, tapi JSON-LD masih Rp150.000. Itu yang kita perbaiki.
Untuk pemilik toko: yang perlu Anda tanyakan ke developer
- Apakah harga di data terstruktur dan harga yang tampil di halaman berasal dari satu sumber data yang sama?
- Apa yang terjadi pada markup begitu promo berakhir, dan siapa yang mengecek?
- Apakah status stok di markup mengikuti stok sungguhan?
- Apakah ada tes otomatis yang gagal kalau dua harga itu berbeda?
Kalau jawabannya “nanti dicek manual”, Anda butuh sisa artikel ini.
Sebagai konsultan local SEO, saya memandu Anda dan developer Anda langkah demi langkah, dari tabel produk sampai validasi. Bagian kode memakai PostgreSQL dan Node.js 20 ke atas dengan Express dan pg; polanya bisa dipindahkan ke stack apa pun.
Dua Istilah yang Harus Dipahami Dulu
Sebelum masuk ke kode, saya cek ulang dokumentasi resmi Google Search Central untuk tiga halaman: Introduction to Product structured data, Merchant listing, dan Product snippet. Kutipan di bawah saya ambil dari halaman tersebut pada saat penulisan, bukan dari ingatan, tapi Google sering memperbarui detailnya, jadi cek ulang sebelum Anda menerapkannya.
- Merchant listing, menurut Google, “For pages where customers can purchase products from you. This markup has more options for specifying detailed product information, like apparel sizing, shipping details, and return policy information.” Ini untuk halaman toko Anda sendiri tempat orang benar-benar bisa checkout.
- Product snippet “For product pages where people can’t directly purchase the product. This markup has more options for specifying review information.” Ini lebih cocok untuk halaman katalog atau review produk yang tidak menjual langsung.
Untuk toko UMKM yang jualan lewat website sendiri dengan keranjang dan checkout, markup yang relevan adalah merchant listing. Saya akan memakai kosakata Product dan Offer yang sama untuk keduanya, karena keduanya sama-sama dibangun dari schema.org/Product.
Dua hal yang perlu diingat sejak awal, juga langsung dari dokumentasi Google:
- Rich result tidak dijamin. Halaman product snippet menegaskan, “Google does not guarantee that features that consume structured data will show up in search results.” Markup yang benar adalah syarat perlu, bukan jaminan tampil.
- Google bisa memakai data Merchant Center, bukan markup Anda. Masih dari dokumentasi yang sama, “Some experiences combine data from structured data and Google Merchant Center feeds if both are available. For example, product snippets may use pricing data from your merchant feed if it’s not present in the structured data on the page.” Kalau toko Anda juga mendaftarkan feed ke Merchant Center, dua sumber data ini harus sama-sama benar, bukan cuma salah satunya.
Kenapa Schema Markup Product Jadi Basi Saat Musim Promo
Di toko seperti Batik Lippo Karawaci tadi, polanya hampir selalu salah satu dari ini:
- Harga di JSON-LD di-hardcode saat halaman produk dibuat, lalu promo musiman ditempel di atasnya hanya lewat teks dan CSS coret, tanpa menyentuh markup sama sekali.
priceValidUntildiisi sekali untuk promo lalu, dan tidak pernah diperbarui ke promo berikutnya. Tanggalnya diam di masa lalu sementara halaman sudah menampilkan promo baru.availabilitytidak mengikuti stok. Produk habis masih bertandaInStock, atau sebaliknya produk yang sudah restock masih bertandaOutOfStockdari minggu lalu.- Harga anggota versus harga publik, atau harga marketplace versus harga website, ikut tercampur, misalnya harga normal tercampur dengan harga diskon anggota.
Pedoman Google soal structured data pada dasarnya satu kalimat: markup harus mewakili apa yang terlihat di halaman. Kalau halaman menampilkan harga promo Rp119.000 tapi JSON-LD masih menyebut Rp150.000, keduanya bertentangan, terlepas dari niat baik siapa pun. Solusinya: jadikan ketidaksinkronan ini mustahil secara struktur, bukan sekadar mengandalkan developer rajin mengingat.
Langkah 1: Tabel Produk dan Promo yang Jadi Satu Sumber Kebenaran
Tiga tabel: product, product_promo, dan product_stock. Saya pisahkan promo dari produk supaya satu produk bisa punya riwayat promo tanpa menimpa harga normalnya.
CREATE TABLE product (
id serial PRIMARY KEY,
slug text UNIQUE NOT NULL,
name text NOT NULL,
description text,
url text NOT NULL,
image_url text,
brand text,
sku text,
price_normal integer NOT NULL CHECK (price_normal >= 0), -- rupiah, tanpa desimal
stock_qty integer NOT NULL DEFAULT 0,
is_discontinued boolean NOT NULL DEFAULT false,
updated_at timestamptz NOT NULL DEFAULT now()
);
-- Hanya satu promo yang boleh aktif per produk dalam satu rentang waktu.
-- Validasi tumpang-tindih dilakukan di aplikasi, bukan di constraint ini.
CREATE TABLE product_promo (
id serial PRIMARY KEY,
product_id int NOT NULL REFERENCES product(id) ON DELETE CASCADE,
price_promo integer NOT NULL CHECK (price_promo >= 0),
starts_at timestamptz NOT NULL,
ends_at timestamptz NOT NULL CHECK (ends_at > starts_at),
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE OR REPLACE FUNCTION touch_updated_at() RETURNS trigger AS $$
BEGIN
NEW.updated_at := now();
RETURN NEW;
END;
$$ LANGUAGE plpgsql;
CREATE TRIGGER product_touch
BEFORE UPDATE ON product
FOR EACH ROW EXECUTE FUNCTION touch_updated_at();
Alasan desainnya:
price_normaldanprice_promoberupainteger, bukannumeric. Rupiah tidak butuh desimal, jadi ini menghindari masalah pembulatan dan membuatpgmengembalikannya sebagai angka JavaScript, bukan string.- Promo punya tabel sendiri dengan
starts_atdanends_at. Dengan begitu, “apakah promo ini masih berlaku” menjadi pertanyaan yang dijawab database lewat perbandingan waktu, bukan kolom boolean yang bisa lupa dimatikan. stock_qtysebagai sumberavailability. Status ketersediaan tidak pernah ditulis manual. Ia dihitung dari angka stok yang sama yang dipakai sistem inventaris.is_discontinueduntuk produk yang sudah tidak dijual lagi, berbeda dari sekadar habis stok sementara.
Contoh data uji untuk toko fiktif tadi, dengan ID mengasumsikan database baru. Promo gajian 25 berjalan 25 sampai 29 November (zona WIB):
INSERT INTO product (slug, name, description, url, brand, sku, price_normal, stock_qty)
VALUES ('kemeja-flanel-tangerang', 'Kemeja Flanel Lengan Panjang',
'Kemeja flanel katun campuran, tersedia ukuran S sampai XL',
'https://batik-lippo-karawaci.example/produk/kemeja-flanel-tangerang',
'Batik Lippo Karawaci', 'KFL-001', 150000, 42);
INSERT INTO product_promo (product_id, price_promo, starts_at, ends_at)
VALUES (1, 119000, '2026-11-25 00:00:00+07', '2026-11-29 23:59:59+07');
Rentang promo ini menutupi gajian 25 sampai Black Friday 27 November, dan harganya Rp119.000, bukan angka bulat marketing; pembeli lokal terbiasa membaca harga seperti ini.
Langkah 2: Ambil Produk dengan Promo Aktif dalam Satu Query
Repository ini memutuskan harga mana yang berlaku di level database, bukan di kode aplikasi, supaya tidak ada dua tempat yang bisa salah hitung harga aktif secara berbeda.
// src/product-repo.js
export async function loadProduct(pool, slug) {
const { rows } = await pool.query(
`SELECT
p.id, p.slug, p.name, p.description, p.url, p.image_url,
p.brand, p.sku, p.price_normal, p.stock_qty, p.is_discontinued,
promo.price_promo, promo.ends_at AS promo_ends_at
FROM product p
LEFT JOIN LATERAL (
SELECT price_promo, ends_at
FROM product_promo
WHERE product_id = p.id
AND now() BETWEEN starts_at AND ends_at
ORDER BY starts_at DESC
LIMIT 1
) promo ON true
WHERE p.slug = $1`,
[slug]
);
if (rows.length === 0) return null;
const row = rows[0];
const activePrice = row.price_promo ?? row.price_normal;
let availability;
if (row.is_discontinued) availability = 'Discontinued';
else if (row.stock_qty <= 0) availability = 'OutOfStock';
else availability = 'InStock';
return {
id: row.id,
slug: row.slug,
name: row.name,
description: row.description,
url: row.url,
imageUrl: row.image_url,
brand: row.brand,
sku: row.sku,
priceNormal: row.price_normal,
priceActive: activePrice,
isOnPromo: row.price_promo != null,
promoEndsAt: row.promo_ends_at,
availability,
};
}
Klausa LEFT JOIN LATERAL ... WHERE now() BETWEEN starts_at AND ends_at adalah bagian yang menjawab pertanyaan “harga mana yang berlaku sekarang” secara otomatis. Begitu waktu server melewati ends_at, promo berhenti ikut terambil dengan sendirinya, dan activePrice kembali ke price_normal tanpa ada yang perlu menjalankan skrip pembersih.
Langkah 3: Bangun JSON-LD Product dan Offer
Inilah inti dari json-ld product offer. Harga dalam IDR, priceValidUntil dari tanggal berakhirnya promo, dan availability dari stok.
// src/jsonld.js
const AVAILABILITY_URL = {
InStock: 'https://schema.org/InStock',
OutOfStock: 'https://schema.org/OutOfStock',
Discontinued: 'https://schema.org/Discontinued',
};
export function buildProductJsonLd(product) {
const offer = {
'@type': 'Offer',
url: product.url,
price: product.priceActive,
priceCurrency: 'IDR',
availability: AVAILABILITY_URL[product.availability],
};
// priceValidUntil hanya diisi kalau harga aktif memang harga promo.
// Format YYYY-MM-DD (ISO 8601) dalam zona Asia/Jakarta, bukan UTC.
// Locale 'sv-SE' kebetulan memberi format YYYY-MM-DD.
if (product.isOnPromo && product.promoEndsAt) {
offer.priceValidUntil = new Intl.DateTimeFormat('sv-SE', {
timeZone: 'Asia/Jakarta',
}).format(product.promoEndsAt);
}
const jsonld = {
'@context': 'https://schema.org',
'@type': 'Product',
'@id': `${product.url}#product`,
name: product.name,
sku: product.sku,
url: product.url,
offers: offer,
};
if (product.description) jsonld.description = product.description;
if (product.brand) jsonld.brand = { '@type': 'Brand', name: product.brand };
if (product.imageUrl) jsonld.image = product.imageUrl;
return jsonld;
}
// Aman ditempel di dalam HTML: karakter "<" di-escape agar teks seperti
// "</script>" di deskripsi produk tidak menutup tag script lebih awal.
export function toScriptTag(jsonld) {
const json = JSON.stringify(jsonld).replace(/</g, '\\u003c');
return `<script type="application/ld+json">${json}</script>`;
}
Detail yang sering jadi sumber structured data harga promo yang keliru:
priceberupa angka, bukan teks berformat."Rp119.000"atau"119.000"salah. Di schema.org titik adalah pemisah desimal, jadi119.000bisa terbaca sebagai seratus sembilan belas. Tulis119000dan biarkanpriceCurrency: "IDR"menjelaskan mata uangnya.priceValidUntilhanya diisi saat ada promo. Kalau produk dijual dengan harga normal tanpa batas waktu, biarkan properti ini kosong. Dokumentasi merchant listing mencantumkannya sebagai properti recommended dan menyatakan, “Your listing may not display if thepriceValidUntilproperty indicates a past date.” Mengisinya dengan tanggal asal-asalan sama berisikonya dengan tidak mengisinya sama sekali.availabilitysatu nilai saja. Dokumentasi merchant listing menyebutkan beberapa nilai yang didukung sepertiInStock,OutOfStock,BackOrder,Discontinued, dan menegaskan “Don’t specify more than one value.” Repository di Langkah 2 sudah memastikan hanya satu nilai yang dihasilkan.@idyang stabil, supaya entitas Product bisa dirujuk konsisten dari halaman lain di situs yang sama.
Harga Coret di Google Merchant Listing
Pertanyaan yang sering saya dengar: bagaimana menandai harga asli yang dicoret berdampingan dengan harga promo? Untuk harga coret google merchant listing, dokumentasi Google menjelaskan lewat priceSpecification dengan dua entri, satu untuk harga aktif dan satu untuk harga lama. Kutipannya: “Only use this property if you want Google to show sale pricing for your product. You must set the priceType to the https://schema.org/StrikethroughPrice value (no other values are supported).” Praktiknya, hanya harga lama yang diberi priceType, harga promo aktif tidak.
if (product.isOnPromo) {
offer.priceSpecification = [
{
'@type': 'UnitPriceSpecification',
price: product.priceActive,
priceCurrency: 'IDR',
// Harga aktif TIDAK diberi priceType.
},
{
'@type': 'UnitPriceSpecification',
price: product.priceNormal,
priceCurrency: 'IDR',
priceType: 'https://schema.org/StrikethroughPrice',
},
];
}
Tambahan ini opsional, bukan pengganti offer.price yang tetap wajib diisi dengan harga aktif.
Langkah 4: Endpoint dan Halaman Produk dari Data yang Sama
Halaman yang terlihat pengunjung dan JSON-LD-nya dirender dari objek yang sama, dalam request yang sama. Ini yang membuat harga di markup tidak mungkin berbeda dari harga di halaman, karena keduanya datang dari satu pemanggilan loadProduct.
// src/product-page.js
import { buildProductJsonLd, toScriptTag } from './jsonld.js';
const esc = (s) =>
String(s).replace(/[&<>"']/g, (c) => ({
'&': '&', '<': '<', '>': '>', '"': '"', "'": ''',
})[c]);
const rupiah = (n) => 'Rp' + n.toLocaleString('id-ID');
export function renderProductPage(product) {
const jsonld = buildProductJsonLd(product);
const priceBlock = product.isOnPromo
? `<p><s>${rupiah(product.priceNormal)}</s> <strong>${rupiah(product.priceActive)}</strong></p>`
: `<p><strong>${rupiah(product.priceActive)}</strong></p>`;
return `<!doctype html>
<html lang="id">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>${esc(product.name)} - Batik Lippo Karawaci</title>
${toScriptTag(jsonld)}
</head>
<body>
<h1>${esc(product.name)}</h1>
${product.description ? `<p>${esc(product.description)}</p>` : ''}
${priceBlock}
<p>Status: ${product.availability === 'InStock' ? 'Tersedia' : product.availability === 'OutOfStock' ? 'Stok habis' : 'Tidak dijual lagi'}</p>
</body>
</html>`;
}
// server.js
import express from 'express';
import pg from 'pg';
import { loadProduct } from './src/product-repo.js';
import { buildProductJsonLd } from './src/jsonld.js';
import { renderProductPage } from './src/product-page.js';
const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
const app = express();
app.get('/api/products/:slug/jsonld', async (req, res, next) => {
try {
const product = await loadProduct(pool, req.params.slug);
if (!product) return res.status(404).json({ error: 'product_not_found' });
res.set('Cache-Control', 'public, max-age=300');
res.type('application/ld+json').send(JSON.stringify(buildProductJsonLd(product), null, 2));
} catch (err) {
next(err);
}
});
app.get('/produk/:slug', async (req, res, next) => {
try {
const product = await loadProduct(pool, req.params.slug);
if (!product) return res.status(404).send('Produk tidak ditemukan');
res.set('Cache-Control', 'public, max-age=300');
res.type('html').send(renderProductPage(product));
} catch (err) {
next(err);
}
});
app.listen(3000, () => console.log('Server jalan di http://localhost:3000'));
Jalankan dengan:
npm init -y && npm pkg set type=module
npm install express pg
DATABASE_URL=postgres://user:pass@localhost:5432/toko node server.js
curl -s http://localhost:3000/api/products/kemeja-flanel-tangerang/jsonld
Cache-Control lima menit adalah kompromi: perubahan harga terlihat dalam hitungan menit tanpa membebani database setiap kunjungan. Kalau Anda memakai CDN, pastikan ada purge cache setiap kali admin menyimpan perubahan harga atau promo baru, terutama menjelang periode ramai seperti gajian dan Black Friday ketika admin bisa mengubah harga berkali-kali dalam sehari.
Langkah 5: Cek Otomatis Agar Harga di Markup Selalu Sama dengan Harga di Halaman
Karena harga promo berubah cepat, saya minta setiap tim memasang tes yang membandingkan harga di JSON-LD dengan harga yang benar-benar dirender di HTML, bukan cuma menguji fungsi JSON-LD sendirian.
// test/price-sync.test.js
import test from 'node:test';
import assert from 'node:assert/strict';
import { buildProductJsonLd } from '../src/jsonld.js';
import { renderProductPage } from '../src/product-page.js';
function sampleProduct(overrides = {}) {
return {
id: 1,
slug: 'kemeja-flanel-tangerang',
name: 'Kemeja Flanel Lengan Panjang',
description: null,
url: 'https://batik-lippo-karawaci.example/produk/kemeja-flanel-tangerang',
imageUrl: null,
brand: 'Batik Lippo Karawaci',
sku: 'KFL-001',
priceNormal: 150000,
priceActive: 119000,
isOnPromo: true,
promoEndsAt: new Date('2026-11-29T16:59:59Z'),
availability: 'InStock',
...overrides,
};
}
test('harga di JSON-LD sama dengan harga yang dirender di HTML', () => {
const product = sampleProduct();
const jsonld = buildProductJsonLd(product);
const html = renderProductPage(product);
const rupiahAktif = 'Rp' + product.priceActive.toLocaleString('id-ID');
assert.equal(jsonld.offers.price, product.priceActive);
assert.ok(html.includes(rupiahAktif), 'HTML harus menampilkan harga aktif yang sama');
});
test('priceValidUntil hanya muncul saat sedang promo, dan formatnya YYYY-MM-DD', () => {
const promo = buildProductJsonLd(sampleProduct());
assert.match(promo.offers.priceValidUntil, /^\d{4}-\d{2}-\d{2}$/);
const normal = buildProductJsonLd(sampleProduct({ isOnPromo: false, priceActive: 150000 }));
assert.equal('priceValidUntil' in normal.offers, false);
});
test('priceValidUntil memakai tanggal Asia/Jakarta, bukan UTC', () => {
// 29 Nov 2026 23:59:59 WIB = 16:59:59 UTC, tanggalnya harus tetap 2026-11-29.
const jsonld = buildProductJsonLd(sampleProduct());
assert.equal(jsonld.offers.priceValidUntil, '2026-11-29');
// 30 Nov 00:00:00 WIB = 29 Nov 17:00 UTC, harus 2026-11-30.
const tengahMalam = buildProductJsonLd(
sampleProduct({ promoEndsAt: new Date('2026-11-29T17:00:00Z') })
);
assert.equal(tengahMalam.offers.priceValidUntil, '2026-11-30');
});
test('promo kedaluwarsa: harga normal, tanpa priceValidUntil dan tanpa harga coret', () => {
// Ini yang dikembalikan loadProduct setelah ends_at lewat:
// isOnPromo false dan priceActive kembali ke priceNormal.
const product = sampleProduct({ isOnPromo: false, priceActive: 150000, promoEndsAt: null });
const jsonld = buildProductJsonLd(product);
const html = renderProductPage(product);
assert.equal(jsonld.offers.price, 150000);
assert.equal('priceValidUntil' in jsonld.offers, false);
assert.equal('priceSpecification' in jsonld.offers, false);
assert.equal(html.includes('<s>'), false, 'tidak ada harga coret di HTML');
});
test('availability mengikuti stok, bukan ditulis manual', () => {
const habis = buildProductJsonLd(sampleProduct({ availability: 'OutOfStock' }));
assert.equal(habis.offers.availability, 'https://schema.org/OutOfStock');
});
test('teks </script> di deskripsi tidak bisa menutup tag script', () => {
const product = sampleProduct({ description: '</script><b>pancingan</b>' });
const html = renderProductPage(product);
const scriptOpen = html.indexOf('<script type="application/ld+json">');
const scriptClose = html.indexOf('</script>', scriptOpen + 1);
const scriptBody = html.slice(scriptOpen, scriptClose);
assert.equal(scriptBody.includes('</script>'), false);
});
Jalankan dengan node --test. Tes tanggal Asia/Jakarta dan tes promo kedaluwarsa adalah yang terpenting untuk kasus ini: keduanya memastikan promo yang sudah berakhir tidak meninggalkan priceValidUntil atau harga coret basi.
Tes di atas memakai data buatan, jadi tambahkan satu pemeriksaan di cron harian yang membaca data sungguhan. Query berikut mencari promo yang baru berakhir dalam tiga hari terakhir. Halaman yang di-cache atau dirender statis (build lama, CDN) bisa saja masih menayangkan harga promo itu, jadi daftar ini adalah daftar halaman yang wajib dicek ulang. Kalau ada hasilnya, tim tahu harus memverifikasi halaman produk tersebut, menyiapkan promo baru, atau purge cache.
-- Promo yang baru berakhir 3 hari terakhir: kandidat halaman yang mungkin masih basi
SELECT p.name, pr.price_promo, pr.ends_at
FROM product_promo pr
JOIN product p ON p.id = pr.product_id
WHERE pr.ends_at < now()
AND pr.ends_at > now() - interval '3 days'
ORDER BY pr.ends_at;
Langkah 6: Validasi di Rich Results Test
Urutan validasi saya untuk seo toko online umkm:
- Cek output mentah.
curlendpoint JSON-LD, pastikanpriceberupa angka,priceValidUntilhanya ada saat memang sedang promo, danavailabilitysesuai stok sebenarnya. - Schema Markup Validator untuk memastikan seluruh pohon
ProductdanOffervalid menurut kosakata schema.org. - Rich Results Test dari Google. Selagi di lokal, Google tidak bisa mengakses
localhost, jadi pakai mode kode:curl -s http://localhost:3000/produk/kemeja-flanel-tangerang, lalu tempel HTML-nya. Setelah deploy, uji URL produk yang sebenarnya. Ingat poin di atas: lolos di sini bukan jaminan tampil sebagai rich result, karena itu memang keputusan Google, bukan alat ini. - URL Inspection di Search Console setelah halaman live, memastikan versi yang diindeks adalah versi dengan harga terbaru, bukan cache lama.
- Cek silang manual saat promo dimulai dan saat promo berakhir. Ambil tiga produk promo secara acak, bandingkan harga di halaman, di JSON-LD, dan kalau ada, di feed Merchant Center. Lakukan ini dua kali: sehari setelah promo dipasang, dan sehari setelah promo seharusnya berakhir.
Bedakan error dari warning. Error berarti markup tidak bisa dipakai dan wajib diperbaiki. Warning biasanya berarti ada properti opsional yang kosong, dan boleh diisi kalau datanya memang tersedia. Jangan mengarang data hanya supaya warning hilang.
Checklist Pemilik Toko: Pricevaliduntil Schema dan Harga Sebelum Promo Naik
Cetak dan tempel di meja admin. Sebelum promo mulai: (1) catat harga promo dan tanggal berakhirnya di tabel promo, bukan hanya di spanduk; (2) buka halaman produk dan cocokkan harga di layar dengan hasil Rich Results Test; (3) pastikan pricevaliduntil schema hanya muncul saat promo berjalan. Sehari setelah promo berakhir: ulangi pengecekan, harga harus kembali normal dan tanggal itu harus hilang. Untuk structured data harga promo yang aman, aturannya satu: yang dibaca Google harus sama dengan yang dilihat pembeli.
Kesalahan yang Paling Sering Saya Temui Saat Musim Promo
- Harga di JSON-LD tidak berubah saat harga di halaman berubah, karena keduanya dirender dari sumber kode yang berbeda, bukan dari satu objek data yang sama.
priceValidUntildari promo bulan lalu masih menempel, padahal halaman sudah menampilkan promo baru.availabilityditulis statisInStockdi template, tidak pernah dihubungkan ke tabel stok sungguhan.- Harga ditulis sebagai teks berformat seperti
"Rp119.000"alih-alih angka119000. - Harga aktif ikut diberi
priceType: StrikethroughPrice, padahal properti itu seharusnya hanya menempel ke harga lama. - Tidak ada pengecekan ulang setelah promo berakhir, sehingga harga kembali normal di halaman tapi JSON-LD masih menyimpan harga promo yang sudah tidak berlaku.
Penutup
Menjelang gajian dan musim Black Friday, trafik ke halaman produk biasanya naik, dan di saat yang sama harga paling sering berubah. Kombinasi ini membuat schema markup product yang basi jadi lebih terasa dampaknya daripada di hari biasa. Markup yang benar bukan trik ranking, dan rich result tetap tidak dijamin tampil meski semua propertinya valid. Yang bisa Anda kendalikan adalah memastikan harga, status promo, dan ketersediaan yang dibaca mesin pencari sama persis dengan apa yang dilihat pengunjung, saat ini juga, bukan saat halaman pertama kali dibuat.
Kalau Anda ingin mulai sebelum promo berikutnya naik:
- Pisahkan harga promo dari harga normal di tabel sendiri, dengan
starts_atdanends_atyang jelas. - Bangun satu fungsi
buildProductJsonLdyang mengisipriceValidUntilhanya saat promo aktif, dan kunci perilakunya dengan tes. - Render halaman produk dan JSON-LD dari objek data yang sama, dalam request yang sama.
- Tambahkan tes otomatis yang membandingkan harga di JSON-LD dengan harga yang dirender di HTML, plus query harian untuk promo yang sudah lewat tanggal.
- Validasi di Schema Markup Validator dan Rich Results Test, lalu cek silang manual saat promo dimulai dan saat promo berakhir.
Setelah itu, mengubah harga menjelang gajian atau Black Friday berikutnya cukup dilakukan sekali, di satu tempat, dan markup-nya ikut berubah dengan sendirinya.
Ditulis oleh Doni Saputra