Guida rapida a SDK#

Aggiungi al negozio un punto di accesso alla visualizzazione con un prodotto preparato prima di estenderlo all’intero catalogo.

1. Preparare il negozio e il prodotto#

Seleziona il negozio nel Pannello di controllo. Ottieni Shop ID e Publishable Key. Apri Pannello di controllo → Impostazioni, aggiungi l’origine del negozio a Allowed Origins (CORS) e fai clic su Salva. Assicurati che almeno un prodotto sia pronto per la visualizzazione. Se importi dal tuo sistema lato server, segui Product Import API e controlla il risultato finale dell’attività.

2. Scegliere la guida per la piattaforma#

Usa Shopify per i temi Liquid, WooCommerce per i negozi WooCommerce oppure negozio personalizzato per il tuo sito. Altre guide sono elencate nella panoramica di SDK.

3. Caricare SDK una sola volta#

Per un negozio personalizzato, carica questo script una sola volta nella pagina che lo ospita. Sostituisci entrambi i segnaposto con valori dello stesso negozio.

html

<script
  src="https://sdk.ideal.house/sdk.js"
  data-shop-id="YOUR_SHOP_ID"
  data-publishable-key="YOUR_PUBLISHABLE_KEY"
  async
></script>

4. Visualizzare un elemento di destinazione corrispondente#

Usa il codice esatto del prodotto presente nel catalogo preparato. Questo esempio chiede a SDK di creare il pulsante dopo la convalida del prodotto.

html

<div data-idealhouse-button-container data-product-code="YOUR_PRODUCT_CODE"></div>

La presenza di un elemento di destinazione non dimostra da sola che il prodotto sia idoneo. Verifica la variante selezionata, la disponibilità del prodotto per la visualizzazione e l’associazione degli identificatori.

5. Provare il percorso del cliente#

Verifica che sdk.js venga caricato correttamente, che compaia il pulsante corretto e che un clic apra Viewer con il prodotto previsto. Cambia variante, passa a un altro prodotto e ripeti su dispositivi mobili. Completa la lista di controllo per la pubblicazione prima di pubblicare.