Använd den sparade widgeten från Installera. Sidan anger bara produkt- eller platsnycklarna som behövs. Utelämnad typ ger where-to-buy; tomma, okända och borttagna typer visar inget.
<script
src="https://cdn.test.stockisto.com/widget.js"
data-api-base="https://api.test.stockisto.com"
data-embed="we_0123456789abcdef0123456789abcdef"
data-sku="7130171"
async
></script>
01De åtta widgetarna
| Widget | Placering | Nycklar | Widgetsida |
|---|---|---|---|
where-to-buy | Varumärkets produktsida; butiker nära kunden | data-embed, data-sku | Var finns varan |
guided-handoff | Varumärkets produktsida; förfrågan till butik och installatör | data-embed | Hitta installatör |
store-locator | Varumärkets sida; nätverket på karta eller lista | data-embed | Hitta butik |
installer-finder | Varumärkets sida; godkända installatörer | data-embed | Hitta installatör |
store-availability | Återförsäljarens produktsida; lager per filial | data-stockisto-slug, data-retailer, data-sku | Lager i butik |
store-card | Butikssida; adress, öppettider, varumärken och betyg | data-store-id, data-retailer | Butikskort |
installer-card | Installatörens sida; behörighet och täckning | data-installer, data-stockisto-slug | Installatörskort |
stock-alert | Återförsäljarens produktsida; mejl vid åter i lager | data-stockisto-slug, data-store-id, data-sku | Lageravisering |
| Attribut | Värden eller standard |
|---|---|
data-widget-type | where-to-buy, guided-handoff, store-locator, installer-finder, store-availability, store-card, installer-card, stock-alert, (where-to-buy) |
data-view | full, inline, button, pill, corner, map, list, (full) |
02Produkter
En produktkod, högst 100 tecken. Okänd kod visar att produkten saknas, aldrig hela varumärkets resultat. data-skus tar högst 6 kommaseparerade koder.
| Attribut | Vad det gör |
|---|---|
data-sku-type | Kodtypen i data-sku. rsk, gtin, enummer, mpn, sku, vvs, nrf, lvi, retailer_sku, nobb, finfo, efo, elnummer_dk, sahkonumero, tun, ean |
data-sku | En produktkod, högst 100 tecken. |
data-skus-type | Kodtypen i data-skus. rsk, gtin, enummer, mpn, sku, vvs, nrf, lvi, retailer_sku, nobb, finfo, efo, elnummer_dk, sahkonumero, tun, ean |
data-skus | Högst 6 kommaseparerade produktkoder. |
03Plats och lista
En fast sökpunkt med data-lat och data-lng hindrar en fråga om webbläsarens plats. data-radius anges i kilometer. data-per-view styr rader i inline-vyn.
| Attribut | Standard | Vad det gör |
|---|---|---|
data-lat | Fast latitud för sökningen. -90–90 | |
data-lng | Fast longitud för sökningen. -180–180 | |
data-radius | 50 | Sökradie i kilometer. >= 0 |
data-filter | Filtrera lager eller återförsäljarstatus. confirmed, showroom, authorized | |
data-rank | stock | Sortera resultatet. stock, distance, price |
data-channel | all | Välj försäljningskanal. all, near, online |
data-prices | retailer | Välj vilka priser som visas. retailer, online, msrp, off |
data-audience | consumer | Välj kundgrupp. consumer, trade |
data-quantity | Önskat antal. 1–9007199254740991 | |
data-reserve | false | Aktivera reservationer. |
data-guided | false | Aktivera guidade frågor. |
data-per-view | 3 | Rader innan alla visas. 1–12 |
data-jsonld | on | Inkludera strukturerade data. on, off |
data-map-height | 480 | Kartans höjd i pixlar. 320–800 |
04Utseende
data-theme och färginställningarna tar hex-färger. data-width tar full eller 200 till 2000 pixlar. Webbläsaren tillhandahåller typsnittet; inget webbtypsnitt laddas.
| Attribut | Värden eller standard |
|---|---|
data-theme-preset | light, heritage, dark, blue, copper, fjord, oak, signal, graphite, (heritage) |
data-radius-scale | sm, md, lg, (md) |
data-density | spacious, cozy, compact, dense, (cozy) |
data-shadow | soft, flat, none, (soft) |
data-font | grotesk, sans, serif, mono, system, (grotesk) |
data-theme | (#1e5e45) |
data-theme-accent2 | Andra accentfärgen, hexvärde. |
data-theme-surface | Kortets bakgrund, hexvärde. |
data-theme-ink | Textfärg, hexvärde. |
data-width | Full bredd eller 200 till 2000 pixlar. |
05Språk och samtycke
| Attribut | Värden eller standard |
|---|---|
data-analytics-consent | Bara det bokstavliga true skickar analys. Lämna avstängt tills samtycke finns. |
data-lang | en, sv, nb, da, fi, (en) |
Utan data-lang följer widgeten sidans språk, sedan webbläsaren och sist engelska. Bara värdet true i data-analytics-consent aktiverar analys.
06Content Security Policy
| CSP | TEST | För |
|---|---|---|
| script-src | https://cdn.test.stockisto.com | Alla widgetar |
| connect-src | https://api.test.stockisto.com | Alla widgetar |
| style-src | 'unsafe-inline' | Alla widgetar |
| img-src | https://api.test.stockisto.com | Alla widgetar |
| frame-src | https://find.test.stockisto.com | Hitta butik och Hitta installatör |
07Startfel
data-stockisto-error | Vad ni ska kontrollera |
|---|---|
unknown-widget-type | data-widget-type |
embed-unavailable | data-embed, data-api-base |
missing-data-source | data-embed, data-stockisto-slug |
unknown-brand-slug | data-stockisto-slug |
pill-target-locator-without-brand-slug | data-stockisto-slug |
08Analyshändelser
Med samtycke skickar widgeten händelser till /api/v1/analytics/events utan inloggningsuppgifter. API:et svarar 202. För koppling till ert konto krävs sidans domän i Tillåtna ursprung.
Händelser för säljaråtgärder
Händelsen heter retailer_cta_click, med widgetEvent cta_click och ctaType call, directions eller website.
En offertlänk som öppnar ett telefonnummer eller en webbplats räknas som ett telefon- eller webbplatsklick.
09Installera från npm
Inte lanserat än. Det lokala paketet har version 2.11.0 med ESM, CommonJS och TypeScript-typer. npm-installation är inte tillgänglig förrän publiceringen har verifierats. Använd skripttaggen ovan.
import {
readConfig,
fetchRetailers,
mountStoreListWidget,
} from "@stockisto/widget";
const script = document.createElement("script");
script.dataset.apiBase = "https://api.test.stockisto.com";
script.dataset.stockistoSlug = "your-brand-slug";
script.dataset.sku = "7130171";
const config = readConfig(script);
const { rows } = await fetchRetailers(config, new AbortController().signal);
const container = document.getElementById("where-to-buy");
if (container) mountStoreListWidget(container, rows, config);
| Widget | npm |
|---|---|
where-to-buy | mountStoreListWidget, mountPdpWidget, mountWhereToBuyButton, mountPillWidget, mountCornerWidget |
store-locator | mountStoreLocatorWidget(container, config) |
installer-finder | mountInstallerFinderWidget |
store-availability | mountStoreAvailabilityWidget(container, config, rows) |
store-card | mountStoreCardWidget, storeCardParts |
installer-card | mountInstallerCardWidget |
guided-handoff | renderGuidedHandoff |