# Instalacja na stronie

> Instalacja wyceniarki propertly.io: kod do osadzenia na stronie, link bezpośredni, przekazywanie UTM oraz zdarzenia JavaScript dla analityki.

Źródło: https://propertly.io/dokumentacja/wyceniarka/instalacja
Ostatnia aktualizacja: 2026-10-27

Po skonfigurowaniu wyceniarki dostaniesz od nas jej **adres** (np. `twoje-biuro`). Wyceniarkę osadzisz na dowolnej stronie: WordPress, Webflow, Wix, własny HTML i inne.

## Kod do osadzenia

Wklej ten kod w miejscu strony, w którym ma się pojawić wyceniarka, zamieniając `twoje-biuro` na adres Twojej wyceniarki:

```html
<div data-propertly-avm="twoje-biuro"></div>
<script src="https://widget.propertly.io/wycena/embed.js" async></script>
```

Wyceniarka zajmie całą szerokość kontenera i sama dopasuje wysokość do zawartości, więc nie będzie na niej pasków przewijania.

> **WordPress**
>
> W edytorze blokowym dodaj blok **Własny HTML** i wklej do niego cały kod. Jeśli korzystasz z kreatora stron (np. Elementor), użyj jego widżetu HTML.

Skrypt wystarczy dodać raz na stronie, nawet gdy osadzasz kilka wyceniarek.

## Link bezpośredni

Wyceniarka działa też jako osobna strona pod adresem:

```
https://widget.propertly.io/wycena/twoje-biuro
```

Link możesz dodać do menu strony, stopki e-maila, posta w mediach społecznościowych albo reklamy. W tej wersji nad formularzem widać logo Twojego biura.

## Kampanie i UTM

Wyceniarka zapamiętuje, z jakiej strony wysłano formularz i z jakiej kampanii przyszedł odwiedzający. Parametry `utm_source`, `utm_medium`, `utm_campaign`, `utm_term` i `utm_content` oraz `gclid` i `fbclid` z adresu Twojej strony są automatycznie przekazywane do osadzonej wyceniarki. Dzięki temu wiesz, które kampanie przynoszą wyceny.

Przy linku bezpośrednim dodaj parametry UTM do samego linku, np. `https://widget.propertly.io/wycena/twoje-biuro?utm_source=facebook&utm_campaign=wycena`.

## Zdarzenia dla analityki

Osadzona wyceniarka wysyła na stronie zdarzenie `propertly:avm-widget`. Możesz go użyć np. do mierzenia konwersji w Google Analytics, Google Tag Managerze albo Meta Pixel.

| `detail.type` | Kiedy | Dodatkowe pola |
|---|---|---|
| `step` | Odwiedzający przechodzi do kolejnego kroku | `step`: `property`, `goal`, `contact` albo `phone-verification` |
| `submitted` | Formularz został wysłany | `valuationState`: `COMPLETED` albo `FAILED` |

```html
<script>
  document.addEventListener('propertly:avm-widget', function (event) {
    if (event.detail.type === 'submitted') {
      window.dataLayer = window.dataLayer || [];
      window.dataLayer.push({ event: 'wycena_wyslana' });
    }
  });
</script>
```

`valuationState` równe `FAILED` oznacza, że formularz wysłano, ale nie udało się policzyć ceny. Lead i tak trafia do Twojej listy, więc do mierzenia konwersji licz oba przypadki.