01Spara din widget
Öppna Locator → Widgets, spara en Where to buy-widget och kopiera dess installationskod. Välj inline-vyn för en panel på produktsidan. Behåll inbäddnings-id och API-adress från din sparade widget.
02Lägg skriptet på produktsidan
Klistra in skriptet där widgeten ska visas. Sidmallen ska skriva den aktuella produktens artikelnummer i data-sku. Ersätt exemplets inbäddnings-id med ditt sparade id.
<script
src="https://cdn.test.stockisto.com/widget.js"
data-api-base="https://api.test.stockisto.com"
data-embed="we_0123456789abcdef0123456789abcdef"
data-sku="2910784"
async></script>
Använd guiden för WordPress, Shopify eller Google Tag Manager för dessa verktyg.
03Ange sidans attribut
Sidans attribut gäller före sparade inställningar. Utelämnade värden hämtas från den sparade widgeten. Ett tomt data-sku stänger av produktberoende visning: Where to buy söker på varumärket utan webbutiker eller reservationer; butikstillgänglighet visar ingenting. En okänd kod ger ett resultat där produkten inte hittas.
| Attribut | Värde |
|---|---|
data-embed | Den sparade widgetens publika we_-id. Det anger ägare, typ och sparade inställningar. |
data-api-base | Den genererade API-adressen. Håll TEST och produktion åtskilda. |
data-sku | Den aktuella produktens artikelnummer, HTML-escapat för ett attribut. |
data-sku-type | Valfri kodtyp: rsk, gtin (eller ean), sku, mpn, enummer, finfo, nrf, nobb, efo, vvs, elnummer_dk, tun, lvi, sahkonumero eller retailer_sku. |
data-view | Valfri vy för Where to buy: full, inline, button, pill eller corner. |
data-analytics-consent | Endast värdet true aktiverar analys. Sätt det först efter besökarens samtycke. |
04Kontrollera installationen
- Öppna den publicerade produktsidan och rulla fram widgeten.
- Kontrollera det anonyma uppslaget
/api/v1/locator/widget-embeds/we_...i webbläsarens nätverkspanel. Svaret ska innehålla din sparade widget. - Prova en annan produkt med ett annat artikelnummer. Kontrollera produkt, butikslänkar och vägbeskrivningar.
- Lägg till varje webbplatsadress under På er webbplats, Embed script → Allowed origins, och öppna sidan igen. Analys och leadattribuering kräver en tillåten adress.
- Läs det senaste rapporterade resultatet under Install Health på samma sida.
05Om widgeten inte visas
Ett misslyckat uppslag av en namngiven widget får inte använda cachade resultat. Kopiera id och API-adress igen. Kontrollera artikelnummer och kodtyp om produkten inte hittas. Läs data-stockisto-error på skriptet vid startfel. Befintliga attributbaserade installationer stöds fortfarande; utelämnade värden använder ägarens standardwidget, med attributen som reserv om uppslaget misslyckas.
Content Security Policy
Tillåt den genererade CDN-adressen i script-src och API-adressen i connect-src. För ramar med butikssökare och installatörssökare tillåter du Find-adressen i frame-src. På TEST är adresserna https://cdn.test.stockisto.com, https://api.test.stockisto.com och https://find.test.stockisto.com. Produktion använder de genererade adresserna utan .test. Ett blockerat API-anrop är ett inläsningsfel, inget bevis på en tom butikslista.
Vad Install Health observerade
| Rapporterat resultat | Observation och nästa steg |
|---|---|
| Rendered on your site | Widgeten rapporterade att den visades. Öppna sidan och kontrollera innehållet. |
| Loads; framed view not observable | Widgeten öppnade en ram men kan inte se in i den. Kontrollera ramen i webbläsaren. |
| Loads, but refused | Widgeten rapporterade att den nekades. Kontrollera publicering och om planen omfattar widgettypen. |
| Loads, showed nothing | Widgeten rapporterade att inget innehåll visades. Kontrollera produktnyckel och sparade inställningar. |
| Loads, failed to render | Widgeten rapporterade ett renderingsfel. Läs nätverkspanelen och CSP-felen i webbläsaren innan du ändrar koden. |