# Eseménykövetés akciókampókkal

> Események rögzítése kódból a fluent_crm/track_event_activity akciókampóval, és egy kapcsolattartó eseményeinek lekérése a REST API-val.

Ha az eseményt a webhely kódjából szeretnéd rögzíteni (például egy oldal megtekintésekor vagy egy gombnyomásra), akciókampót használsz. A módszerhez kell a bekapcsolt **Eseménykövetési modul** (lásd [Követési események, indító és szűrő](https://hub.hellowp.io/hu/plugins/fluentcampaign-pro/esemenykovetes-esemenyek-es-szuro/)).

## Esemény rögzítése kóddal

A kódot nem a témád fájljába érdemes tenni, hanem egy kódrészlet-kezelő bővítménybe (snippet plugin). Az alábbi lépések a FluentSnippets bővítménnyel mutatják meg a folyamatot, de bármelyik hasonló bővítmény megfelel.

1. Telepítsd és aktiváld a FluentSnippets bővítményt (wordpress.org-ról, **Bővítmények → Új hozzáadása**).
2. Nyisd meg a bővítmény oldalát, és kattints az **Első kódrészlet létrehozása** vagy az új kódrészlet gombra.
3. Másold be a PHP-kódrészlet mezőbe az alábbi kódot:

```php
do_action('fluent_crm/track_event_activity', [
    'event_key' => 'fcrm_event_tested',
    'title'     => 'Testing FluentCRM Event',
    'value'     => 'This is my event value with plain Text',
    'email'     => 'vasarlo@example.com',
    'provider'  => 'woocommerce'
], true);
```

4. Írd át az `event_key`, `title`, `value`, `email` és `provider` értékét a saját adataidra.
5. Aktiváld a kódrészletet.
6. Nyisd meg a kapcsolattartó adatlapját: az esemény a jobb oldali **További információ** sávban, az **Eseménykövetés** alatt jelenik meg.

A tömb mezői:

| Mező | Jelentés |
|---|---|
| `event_key` | Az esemény azonosítója. Ugyanezzel a kulccsal szűrhetsz és indíthatsz automatizálást. |
| `title` | Az esemény olvasható neve. |
| `value` | Az esemény értéke: szöveg vagy szám. |
| `email` | Annak a kapcsolattartónak az e-mail-címe, akihez az esemény tartozik. |
| `provider` | Az esemény forrásának neve, például `woocommerce` vagy `weboldal`. |

Ha ugyanaz a kapcsolattartó ugyanazzal a kulccsal újra rögzíti az eseményt, a meglévő rekord előfordulásszáma növekszik.

## Egy kapcsolattartó eseményeinek lekérése

Egy kapcsolattartó összes eseményét a REST API végpontján kérheted le:

```text
https://a-te-domained.hu/wp-json/fluent-crm/v2/subscribers/{ID}/tracking-events
```

Az `{ID}` a kapcsolattartó azonosítója. A hívásnak bejelentkezett, megfelelő jogosultságú felhasználó kell. A válasz egy `events` objektum, lapozva, az `events.data` tömbben a kapcsolattartó eseményeivel. Egy esemény mezői: `id`, `subscriber_id`, `counter` (az előfordulások száma), `created_by`, `provider`, `event_key`, `title`, `value`, `created_at`, `updated_at`.