# JavaScript kód a Cart Rules (Kosárszabályok) funkcióhoz

Canonical URL: https://support.optimonk.com/hu/articles/javascript-code-for-cart-rules

**Fontos:** ha **ShopRenter**, **Shopify**, **WordPress**, **WooCommerce** vagy **Magento** oldalt használsz, az OptiMonk automatikusan felismeri a látogató kosarának tartalmát, és ezt az információt felhasználja a kampányaid megjelenítési szabályaihoz, amint az OptiMonk kód telepítve van.

Ha a fentiek egyikét használod, **nincs szükséged semmilyen további JavaScript kódra** — telepítsd az OptiMonkot az oldaladra, és a **Kosárszabályok** célzási szabály készen áll a használatra. Ugorj egyenesen a lenti *[Kampány beállítása](#set-up-the-campaign)* részhez.

Ha másfajta oldalt üzemeltetsz, illeszd be a cikkben leírt kódot, hogy az OptiMonk tudja, mi van a kosárban.

---

## 1. Mikor érdemes eCommerce kosárszegmentálást használni?

Akkor, amikor a kosár tartalma alapján szeretnéd megjeleníteni az üzenetedet. Például, amikor speciális ajánlatot szeretnél adni azoknak a látogatóknak, akik már raktak valamit a kosarukba, és egy másik üzenetet azoknak, akik még nem tettek semmit a kosarukba.

## 2. Miért érdemes eCommerce kosárszegmentálást használni?

A kosárelhagyás az egyik legnagyobb kihívás az eCommerce oldalak számára. Az eCommerce kosárszegmentálás OptiMonkkal segít abban, hogy a látogatóid eljussanak a pénztárig, és arra ösztönzi a látogatókat, hogy tegyenek termékeket a kosarukba, mivel minden látogatói csoportnak külön üzenetet jelenítsz meg.

## 3. Hogyan állítsam be az oldalamat, hogy az OptiMonk lekérje a látogató kosarának tartalmát?

Az OptiMonk JavaScript kód segítségével kéri le a kosár tartalmára vonatkozó információkat. A kódot a kosár tartalma vagy konkrét termékek alapján testre szabod, majd elhelyezed az oldaladon.

## 4. Milyen kódra van szükségem, hogy az OptiMonk lekérje a kosár tartalmára vonatkozó információkat?

Amikor valaki terméket ad a kosarához az oldaladon, egy ehhez hasonló kódot kell végrehajtani:

```
<script type="text/javascript"> if (window.OptiMonk || window.OptiMonkEmbedded ) { var OM = window.OptiMonk || window.OptiMonkEmbedded; var adapter = OM.Visitor.createAdapter(); adapter.Cart.add('##{{ cartProductID }}', {quantity:##{{ cartProductQty }}, price:##{{ cartProductPrice }}}); } </script>
```

**Fontos**: `OptiMonk.Visitor` csak akkor létezik, ha a domainen legalább egy aktív kampány van.

A fenti példában az OptiMonk csak néhány nagyon alapvető adatot kér le a kosár tartalmáról.

Az OptiMonk részletesebb információkat is lekérhet a látogató kosarában lévő konkrét termékekről. Részletesebb információkhoz egy ehhez hasonló kódot kell végrehajtani:

```
<script type="text/javascript"> if (window.OptiMonk || window.OptiMonkEmbedded ) { var OM = window.OptiMonk || window.OptiMonkEmbedded; var adapter = OM.Visitor.createAdapter(); adapter.Cart.add('##{{ 'product1' }}', {quantity:##{{ 3 }}, price:##{{ 1000 }}, color:##{{ red }}}); adapter.Cart.add('##{{ 'product2' }}', {quantity:##{{ 3 }}, price:##{{ 1000 }}, color:##{{ blue }}}); } </script>
```

A fenti példában két, a kosárba adott terméket definiálunk, ezek azonosítói:

- `product1` és `product2`

és mindkét termékhez 3 változót adunk át:

- mennyiség, azaz "3"

- ár, azaz "1000"

- szín, azaz "blue"

**Fontos:** a termék mennyisége és ára kötelező adat, ezért ezeket mindig be kell állítani.

## 5. Mi történik, ha egy látogató eltávolít egy tételt a kosarából?

Az oldaladra kódot is beilleszthetsz, hogy az OptiMonk tudja, ha egy látogató eltávolít egy tételt a kosarából:

```
<script type="text/javascript"> if (window.OptiMonk || window.OptiMonkEmbedded ) { var OM = window.OptiMonk || window.OptiMonkEmbedded; var adapter = OM.Visitor.createAdapter(); adapter.Cart.remove('##{{ cartProductID }}'); } </script>
```

Vagy egyetlen hívással is kiürítheted a kosarat:

```
<script type="text/javascript"> if (window.OptiMonk || window.OptiMonkEmbedded ) { var OM = window.OptiMonk || window.OptiMonkEmbedded; var adapter = OM.Visitor.createAdapter(); adapter.Cart.clear(); } </script>
```

## 6. Mire figyelj a kód beillesztésekor

- A saját attribútumaid vagy termékeid neve nem tartalmazhat speciális karaktereket.

- A termékek és változók kis- és nagybetű-érzékenyek.

- Az `OptiMonkOnReady` függvényt csak egyszer szabad definiálni, azaz oldalanként csak egyszer.

---

## Kampány beállítása

Amint a kosáradatok elérik az OptiMonkot — akár automatikusan egy támogatott platformon, akár a fent leírt kód segítségével — adj hozzá egy **Kosárszabályok** célzási szabályt a kampányhoz.

1. Nyisd meg a **Kampányok** menüpontot a bal oldali menüben, és kattints arra a kampányra, amelyben a kosáradatokat szeretnéd használni.

2. Nyisd meg a **Beállítások** fület.

3. A **Kik lássák a popupot** részben kattints az **Új szabály hozzáadása** gombra.

4. Válaszd a **Kosárszabályok** lehetőséget — *kosárérték, tételszám, termékek (Shopify és társai)*.

5. Építsd fel a feltételeidet. Minden feltétel azzal kezdődik, hogy mit vizsgál:

| Feltétel | Mit vizsgál | Operátorok |
| --- | --- | --- |
| Kosárérték | A kosár teljes értéke | egyenlő, nagyobb mint, kisebb mint, legalább, legfeljebb, között |
| Termékek száma | Hány tétel van a kosárban | ugyanaz a hat |
| Termék a kosárban | Egy konkrét termék — a kosár tartalmazza vagy a kosár NEM tartalmazza | termék szerint (a katalógusodból kiválasztva) vagy név szerint |

6. Kattints a **Feltétel hozzáadása** gombra egy második, harmadik… feltételhez. Ezek ÉS kapcsolattal kapcsolódnak: *A kosárfeltételek ÉS kapcsolattal kapcsolódnak, és a bolt élő adatain értékelődnek ki (Shopify, ShopRenter, WooCommerce, …). Nem támogatott boltok esetén a szabály soha nem teljesül.*

7. Mentsd el a szabályt, majd kattints a **Módosítások mentése** gombra a Beállítások fül alján.

A szabálykártyán ezután például ez áll: *Kosárszabályok · Kosárérték legalább 100*, a beállítások összefoglalója pedig ezt mutatja: **Kosárszabályok (1 feltétel)**.

### Termékek kiválasztása a katalógusodból

A **Termék a kosárban** esetén az OptiMonk felajánlhatja a tényleges termékeidet: gépelj a *Termékek keresése…* mezőbe, és válassz a találatok közül. Ehhez aktív, a fiókhoz kapcsolt Shopify bolt szükséges — ellenkező esetben az ablak ezt írja ki: *A termékválasztáshoz aktív Shopify bolt kell — a kiválasztott termékeket eltávolíthatod, vagy név szerint is egyeztethetsz*, és ilyenkor **név szerint** — a kosárban megjelenő terméknév alapján — egyeztetsz.

### Példák

- **Teljes kosár elhagyása:** *Kosárérték* — *legalább* — `100`, exit-intent triggerrel kombinálva.

- **Az első tétel ösztönzése:** *Termékek száma* — *egyenlő* — `0`.

- **Kategória-specifikus ajánlat:** *Termék a kosárban* — *a kosár tartalmazza* — válaszd ki a termékeket a katalógusból.

> Tipp: megkérheted a jobb oldali asszisztenst is, hogy állítsa be ezt neked (például: *"csak akkor jelenjen meg, ha a kosár értéke 100 euró felett van"*). A szabálykártyák frissülnek, ahogy szerkeszti azokat.
