Guida alla configurazione: integrazioni per il sito web

1. Prima di iniziare

Un piano Pro. Il widget degli annunci, il pulsante per i residenti, i pulsanti già pronti, i codici QR e i feed di dati fanno parte di RentMerchant Pro. I link semplici e la sua pagina RentMerchant gratuita funzionano con ogni piano. Passi a Pro da Fatturazione nel suo account.
Un indirizzo email confermato. Gli annunci e i widget si caricano solo per gli account verificati.
Accesso per modificare il suo sito web. Deve poter aggiungere un elemento di pagina nel suo website builder. Alcuni builder consentono il codice personalizzato solo nei piani a pagamento; le passaggi per il suo strumento di creazione siti qui sotto indicano dove.

2. Trovi il suo codice

Acceda su app.rentmerchant.com.
Apra Impostazioni, poi la scheda Integrazioni.
Clicchi su un'opzione per aprirla, poi usi il suo pulsante Copia codice. Il codice contiene già il nome del suo account, quindi lo incolli esattamente come copiato.

Negli esempi di questa pagina, your-name sostituisce il nome del suo account. Copi sempre il suo codice reale dalla pagina Integrazioni invece di riscrivere questi esempi.

3. Aggiunga i suoi annunci di affitto

Il widget mostra gli immobili che pubblica. Nulla è pubblicato finché non lo attiva, un immobile alla volta.

Apra Annunci (in Locazione). Ci sono tutte le sue unità. Un immobile senza unità mostra un pulsante Crea annuncio.
Clicchi Modifica su una casa e compili camere, bagni, piedi quadrati, affitto mensile, deposito, la data di disponibilità (la lasci vuota per "disponibile ora"), animali e una descrizione.
Carichi fino a 12 foto. La prima foto è la copertina; usi le frecce per riordinarle. I dati sulla posizione vengono rimossi automaticamente da ogni foto.
Spunti Pubblica questa casa e clicchi Salva annuncio.

Quando un immobile è affittato, clicchi Rimuovi dagli annunci nella pagina Annunci. Scompare dal suo sito web entro cinque minuti, senza modificare alcun codice.

Ogni annuncio ha anche una propria pagina con una galleria di foto e un pulsante Fai domanda per questa casa. Il modulo di domanda si apre con quella casa già selezionata e le domande arrivano nella sua scheda Domande di locazione.

Mostra i suoi immobili pubblicati come schede con foto, affitto, camere da letto, bagni e disponibilità. I visitatori cliccano una scheda per aprire la pagina dell'annuncio.

Opzione A: codice widget (consigliata)

Si adatta alla larghezza della pagina e cresce in base ai suoi annunci. Lo incolli dove devono apparire gli annunci:

<div data-rentmerchant-listings="your-name"></div>
<script src="https://app.rentmerchant.com/embed/v1/listings.js" async></script>

Opzione B: iframe

Per i builder che non consentono script. È un riquadro ad altezza fissa con scorrimento:

<iframe src="https://app.rentmerchant.com/embed/listings/your-name" title="Available rentals"
        loading="lazy" style="width:100%;height:900px;border:0"></iframe>

Se il suo builder consente uno script accanto, usi invece la versione a dimensionamento automatico dalla pagina Integrazioni. Aggiunge una riga che rende il riquadro alto esattamente quanto i suoi annunci.

5. Pulsante residenti fluttuante

Aggiunge un pulsante Residenti nell'angolo in basso di ogni pagina. Apre un piccolo menu: Accesso residenti, Paga l'affitto, Invia una richiesta di manutenzione, Fai domanda e Immobili disponibili (ciascuna voce appare solo se pertinente al suo account). Lo incolli una sola volta, nell'area del suo builder che aggiunge codice a ogni pagina (di solito chiamata codice per tutto il sito, codice del piè di pagina o code injection):

<script src="https://app.rentmerchant.com/embed/v1/resident-button.js" data-rentmerchant-site="your-name" async></script>

Se il suo builder non ha un'area per il codice di tutto il sito, lo incolli in ogni pagina in cui desidera il pulsante.

6. Pulsanti e link

Pulsanti: nella sezione Pulsanti di Integrazioni, selezioni i pulsanti che desidera, scelga un colore, controlli l'anteprima e copi il codice. I pulsanti sono semplici link con uno stile, quindi funzionano in qualsiasi builder che accetti HTML, comprese le newsletter via email.

Link (ogni piano): copi qualsiasi link nel menu di navigazione del suo sito, nel piè di pagina, in un profilo social o nella firma email. Nella maggior parte dei builder: apra l'editor del menu, aggiunga una voce link e incolli l'indirizzo.

7. Codici QR

Nella sezione Codici QR, clicchi Scarica PNG sotto il codice che desidera. Lo stampi su un cartello "Affittasi" (usi Immobili disponibili o Fai domanda ora), su un avviso in lavanderia (Paga l'affitto o Manutenzione) o nel pacchetto di benvenuto. Lo stampi largo almeno 2,5 cm (1 pollice) e lo scansioni con il suo telefono prima di stamparne una serie.

8. Passo passo per il suo strumento di creazione siti

I builder cambiano i loro menu di tanto in tanto. Se un'etichetta qui sotto non corrisponde esattamente, cerchi l'elemento chiamato HTML, Embed o Code.

Wix

Annunci o pulsanti: nell'Editor, clicchi Add Elements (+), poi Embed Code, poi Embed HTML. Scelga Code, incolli e clicchi Aggiorna. Trascini il riquadro fino alla dimensione desiderata.
Pulsante residenti: vada in Impostazioni del suo sito, poi Custom Code (in Avanzate), clicchi Add Custom Code, incolli, scelga Tutte le pagine e Body, end. Wix offre il Codice personalizzato solo sui siti con un dominio collegato e un piano a pagamento.
Pubblichi il suo sito.

Squarespace

Annunci o pulsanti: modifichi la pagina, clicchi su un punto di inserimento, scelga Code, incolli e si assicuri che Display Source sia disattivato.
Pulsante residenti: apra Impostazioni, poi Developer Tools (o Avanzate), poi Code Injection, e incolli in Piè di pagina.
Gli script nei blocchi Code e in Code Injection richiedono un piano Squarespace che includa il codice personalizzato. Se il codice del widget non funziona, usi invece l'opzione iframe.

WordPress

Annunci o pulsanti: modifichi la pagina, clicchi +, aggiunga un blocco Custom HTML, incolli e aggiorni la pagina.
Pulsante residenti: usi l'impostazione del codice del piè di pagina del suo tema, se presente, oppure un plugin per il codice di intestazione e piè di pagina (per esempio WPCode), e incolli nel piè di pagina.
Su WordPress.com (il servizio in hosting), gli script funzionano solo sui piani che consentono plugin e codice personalizzato. Sugli altri piani, usi l'opzione iframe e i pulsanti.

GoDaddy Websites + Marketing

Modifichi il suo sito, clicchi Add Section, cerchi HTML e lo aggiunga.
Incolli il codice nella casella del codice personalizzato della sezione e clicchi Fatto. Qui l'opzione iframe è la più affidabile.
Per il pulsante residenti, cerchi in Impostazioni del suo sito il codice per tutto il sito. Se il suo piano non lo prevede, aggiunga invece i pulsanti alle sue pagine.

Weebly (Square Online classic)

Annunci o pulsanti: trascini un elemento Embed Code sulla pagina, ci clicchi sopra, scelga Edit Custom HTML e incolli.
Pulsante residenti: Impostazioni, poi SEO, poi incolli in Footer Code.

Webflow

Annunci o pulsanti: trascini un elemento Code Embed sulla pagina e incolli.
Pulsante residenti: Impostazioni del sito, poi Codice personalizzato, e incolli in Codice del piè di pagina. Pubblichi.
Webflow richiede un piano a pagamento per il codice personalizzato.

Un sito personalizzato o fatto a mano

Incolli il codice del widget dove devono comparire gli annunci e il pulsante per i residenti subito prima del tag di chiusura </body>. Oppure usi i Feed JSON per creare un design personalizzato.

9. Riferimento opzioni

Attributo	Funziona su	Cosa fa
data-limit="3"	Widget degli annunci	Mostra solo i primi immobili (prima quelli disponibili prima).
data-accent="#0f766e"	Widget degli annunci, pulsante residenti	Il suo colore, come codice esadecimale a sei cifre. Il predefinito è l'indaco RentMerchant.
data-position="left"	Pulsante residenti	Posiziona il pulsante nell'angolo in basso a sinistra anziché a destra.
data-label="Tenants"	Pulsante residenti	Cambi il testo del pulsante (fino a 24 caratteri).
?accent=0f766e	Indirizzo dell'iframe	Il suo colore per la versione iframe, aggiunto alla fine del suo indirizzo.

Esempio, un widget che mostra tre case in verde acqua:

<div data-rentmerchant-listings="your-name" data-limit="3" data-accent="#0f766e"></div>
<script src="https://app.rentmerchant.com/embed/v1/listings.js" async></script>

10. Per sviluppatori web: feed JSON

Due feed pubblici in sola lettura contengono gli stessi dati dei widget. Non serve alcuna chiave, le richieste cross-origin sono consentite e le risposte sono memorizzate nella cache per cinque minuti.

GET https://app.rentmerchant.com/r/your-name/listings.json
GET https://app.rentmerchant.com/r/your-name/links.json

Ogni elemento di listings include:

{
  "id": 476,
  "title": "Capitol Flats · Unit 102",
  "city": "Columbus, OH",
  "rent": "$1,950/mo",          "rent_amount": 1950,
  "deposit": "$1,950",
  "facts": ["2 bed", "1 bath", "880 sq ft"],
  "bedrooms": 2, "bathrooms": 1, "square_feet": 880,
  "available": "Available now", "available_on": null,
  "pets": "Cats OK",
  "description": "Bright corner two bedroom...",
  "photos": [{ "url": "...", "thumb": "...", "w": 2000, "h": 1500 }],
  "url": "https://app.rentmerchant.com/r/your-name/listings/476",
  "apply_url": "https://app.rentmerchant.com/apply/...?unit=476"
}

Mostri il testo esattamente come fornito e colleghi a url e apply_url invece di creare un proprio modulo di domanda. L'indirizzo completo è presente solo nella pagina dell'annuncio, non nel feed. links.json restituisce il suo nome, il colore principale e i link per i residenti (key, label, url).

11. Risoluzione dei problemi

L'area del widget è vuota.: Il suo strumento di creazione siti potrebbe eliminare gli script; usi l'opzione iframe. Verifichi anche che il suo account sia su Pro e che la sua email sia confermata, e che il codice sia stato incollato per intero.
Dice che non ci sono case disponibili.: Apra Annunci nel suo account e verifichi che almeno un immobile sia contrassegnato come pubblicato. Le modifiche compaiono entro cinque minuti.
Nell'editor si vede bene ma non sul mio sito pubblicato.: La maggior parte dei builder esegue gli script solo sul sito pubblicato, non nell'anteprima dell'editor. Pubblichi, poi controlli l'indirizzo online.
L'iframe è tagliato o ha una barra di scorrimento.: Usi la versione a dimensionamento automatico, oppure aumenti il valore height nel codice iframe.
Il pulsante per i residenti non compare.: Deve trovarsi in un'area per il codice di tutto il sito o nella pagina stessa e appare solo sul sito pubblicato. Se il suo account non ha link da mostrare, resta nascosto.
Altro?: Apra Assistenza nel suo account e ci indichi l'indirizzo del suo sito web e lo strumento con cui è stato creato. Ci daremo un'occhiata.

12. Sicurezza e privacy

I pagamenti e l'accesso si aprono sempre su RentMerchant. Un inquilino non digita mai una password o un dato bancario nel suo sito web.
I widget mostrano solo link e foto di RentMerchant e sono isolati dal resto del codice e degli stili della sua pagina.
Solo gli immobili che pubblica sono visibili. Togliere un immobile dagli annunci lo rimuove ovunque contemporaneamente.
I dati sulla posizione e le altre informazioni nascoste vengono rimossi da ogni foto che carica.
Se un account viene chiuso, sospeso o lascia Pro, i suoi annunci e widget smettono automaticamente di essere mostrati.

Pronto a collegare il suo sito?

Acceda e apra Integrazioni, oppure veda prima il widget degli annunci in funzione.

Apri Integrazioni Vedi la demo dal vivo

Integrazioni per il sito web