Lägg widgeten på en produktsida

Utvecklardokumentation: alla sidor

Börja

Hjälp och dokumentation

Ändringar

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.

AttributVärde
data-embedDen sparade widgetens publika we_-id. Det anger ägare, typ och sparade inställningar.
data-api-baseDen genererade API-adressen. Håll TEST och produktion åtskilda.
data-skuDen aktuella produktens artikelnummer, HTML-escapat för ett attribut.
data-sku-typeValfri kodtyp: rsk, gtin (eller ean), sku, mpn, enummer, finfo, nrf, nobb, efo, vvs, elnummer_dk, tun, lvi, sahkonumero eller retailer_sku.
data-viewValfri vy för Where to buy: full, inline, button, pill eller corner.
data-analytics-consentEndast värdet true aktiverar analys. Sätt det först efter besökarens samtycke.

04Kontrollera installationen

  1. Öppna den publicerade produktsidan och rulla fram widgeten.
  2. Kontrollera det anonyma uppslaget /api/v1/locator/widget-embeds/we_... i webbläsarens nätverkspanel. Svaret ska innehålla din sparade widget.
  3. Prova en annan produkt med ett annat artikelnummer. Kontrollera produkt, butikslänkar och vägbeskrivningar.
  4. 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.
  5. 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 resultatObservation och nästa steg
Rendered on your siteWidgeten rapporterade att den visades. Öppna sidan och kontrollera innehållet.
Loads; framed view not observableWidgeten öppnade en ram men kan inte se in i den. Kontrollera ramen i webbläsaren.
Loads, but refusedWidgeten rapporterade att den nekades. Kontrollera publicering och om planen omfattar widgettypen.
Loads, showed nothingWidgeten rapporterade att inget innehåll visades. Kontrollera produktnyckel och sparade inställningar.
Loads, failed to renderWidgeten rapporterade ett renderingsfel. Läs nätverkspanelen och CSP-felen i webbläsaren innan du ändrar koden.