# Shortcode-ok: lead és egyedi konverziók

> A conversion-pixel és a view-item shortcode: űrlapos konverziók követése megköszönő oldalon, platformonkénti paraméterekkel.

A bővítmény shortcode-okat ad olyan konverziók követésére, amelyek mögött nincs WooCommerce-rendelés. Ilyen például egy űrlap beküldése, egy érdeklődő (lead) megadása, egy regisztráció vagy egy hírlevél-feliratkozás. A shortcode-ot arra a megköszönő oldalra tedd, ahová az űrlap a beküldés után átirányít.

Van egy külön shortcode a termék megtekintésére (`view-item`) is. Egyedi készítésű terméklapokon kell, ahol a WooCommerce nem tudja eldönteni, hogy termékoldalról van szó, ezért a bővítmény nem tudja magától beilleszteni a szükséges szkripteket. (A `view-item` esemény a Metánál például a `ViewContent` eseménynek felel meg.)

> **Fontos:** A shortcode-ok olyan konverziókra valók, amelyek mögött nincs rendelés. Ne használd őket vásárlás követésére egyedi megköszönő oldalon. A shortcode rendelési adatok nélkül, tehát rendelésazonosító, érték, pénznem és megvásárolt tételek nélkül váltja ki a konverziót, és a rendelés kettőzésmegelőzése sem védi. Egy így követett vásárlás érték nélkül érkezne a hirdetési platformokhoz, és az oldal minden újratöltésekor újra számolódhatna. A vásárlási konverzióknak a WooCommerce szabványos rendelés-fogadó végpontján és az `is_order_received_page()` feltételen kell átmenniük, mert a Pixel Manager így ismeri fel a vásárlást és így olvassa ki a rendelés adatait.

## Példák

### Minden pixel kiváltása egy shortcode-dal

A Google Ads és a LinkedIn mindig megkövetel egy eseményazonosítót.

```text
[conversion-pixel pixel="all" gads-conversion-label="aabbcc" lintrk-event="1234567"]
```

### Minden pixel kiváltása, alapértékek felülírásával

Ha az összes pixelt ki akarod váltani, és a legtöbbnél felülírnád az alapértelmezett eseményt, használd ezt (a Google Ads és a LinkedIn azonosítója itt is kötelező):

```text
[conversion-pixel pixel="all" gads-conversion-label="aabbccdd" meta-event="Schedule" twc-event="Signup" pinc-event="Signup" pinc-lead-type="test-type" snap-event="SIGN_UP" tiktok-event="SubmitForm" lintrk-event="1234567"]
```

### Minden pixel külön-külön

```text
[conversion-pixel pixel="applovin"]
[conversion-pixel pixel="applovin" applovin-event="sign_up" applovin-value="10"]
[conversion-pixel pixel="google-ads" gads-conversion-label="abcdefg"]
[conversion-pixel pixel="linkedin" lintrk-event="1234567"]
[conversion-pixel pixel="meta"]
[conversion-pixel pixel="meta" meta-event="Schedule"]
[conversion-pixel pixel="ms-ads"]
[conversion-pixel pixel="pinterest"]
[conversion-pixel pixel="pinterest" pinc-event="Signup"]
[conversion-pixel pixel="pinterest" pinc-event="Signup" pinc-lead-type="test-type"]
[conversion-pixel pixel="reddit"]
[conversion-pixel pixel="snapchat" snap-event="SIGN_UP"]
[conversion-pixel pixel="tiktok" tiktok-event="SubmitForm"]
[conversion-pixel pixel="twitter"]
[conversion-pixel pixel="twitter" twc-event="Signup"]
[view-item product-id="14"]
```

## Általános tudnivalók

Minden felhasználási esetben egyetlen kötelező paraméter van: a `pixel`. Ezzel választod ki, melyik konverziós pixel induljon, vagy hogy mind.

```text
pixel="google-ads"
pixel="all"
```

Minden pixel alapértelmezett paraméterekkel dolgozik, amelyeket felülírhatsz.

## Platformonkénti paraméterek

| Platform | `pixel` értéke | Paraméterek | Alapértelmezett esemény |
|---|---|---|---|
| AppLovin | `applovin` | `applovin-event` (`generate_lead`, `sign_up`, `subscribe`), `applovin-value` | `generate_lead` |
| Google Ads | `google-ads` | `gads-conversion-label` (kötelező), `gads-conversion-id` (nem kötelező) | nincs alapérték, a címke kötelező |
| LinkedIn | `linkedin` | `lintrk-event` (kötelező) | nincs alapérték |
| Meta (Facebook) | `meta` | `meta-event` | `Lead` |
| Microsoft Ads | `ms-ads` | `ms-ads-event`, `ms-ads-event-category`, `ms-ads-event-label`, `ms-ads-event-value` | `submit`, a címke `lead` |
| Outbrain | `outbrain` | `outbrain-event` | nincs alapérték |
| Pinterest | `pinterest` | `pinc-event`, `pinc-lead-type` | `lead` |
| Reddit | `reddit` | `reddit-event` | `Lead` |
| Snapchat | `snapchat` | `snap-event` | `SIGN_UP` |
| Taboola | `taboola` | `taboola-event` | nincs alapérték |
| TikTok | `tiktok` | `tiktok-event` | `SubmitForm` |
| X (Twitter) | `twitter` | `twc-event` | `CompleteRegistration` |

### AppLovin

Az AppLovin lead-konverzióhoz a `pixel` paraméteren kívül nincs kötelező paraméter. Az esemény alapból `generate_lead`. Felülírásához használd az `applovin-event` paramétert, amely a `generate_lead`, `sign_up` és `subscribe` értékeket fogadja:

```text
[conversion-pixel pixel="applovin" applovin-event="sign_up"]
```

Az AppLovin a nulla értékű leadeket leértékeli, ezért érdemes az `applovin-value` paraméterrel értéket is átadni:

```text
[conversion-pixel pixel="applovin" applovin-event="generate_lead" applovin-value="25"]
```

### Google Ads

Minden Google Ads konverzióhoz be kell állítani a `gads-conversion-label` paramétert, ez az egyetlen kötelező paraméter:

```text
[conversion-pixel pixel="google-ads" gads-conversion-label="abcdefg"]
```

Ha kell, a `gads-conversion-id` paramétert is megadhatod. Ha kihagyod, a bővítmény automatikusan azt a Conversion ID-t használja, amelyet a Pixel Managerben a **Tracking Pixels → Google (Ads & GA4)** alatt beállítottál.

### LinkedIn

A LinkedIn mindig eseményazonosítót kér. Hozz létre új konverziót a LinkedIn Ads Managerben, és a generált konverzióazonosítót add meg a `lintrk-event` paraméterben:

```text
[conversion-pixel pixel="linkedin" lintrk-event="1234567"]
```

### Meta (Facebook)

Az esemény alapból `Lead`. Felülírásához használd a `meta-event` paramétert:

```text
[conversion-pixel pixel="meta" meta-event="Schedule"]
```

Ha a shortcode-dal egyedi eseményt követsz, és a Meta Conversions API be van kapcsolva, a Pixel Manager az egyedi eseményeket automatikusan a Conversions API-n át is feldolgozza.

### Microsoft Ads

> **Megjegyzés:** Ez a shortcode béta állapotú, mert a Microsoft dokumentációja nem teljesen világos a lead-konverzió beállításáról.

Az esemény alapból `submit`, az eseménycímke `lead`. A következő paramétereket mind felülírhatod: `ms-ads-event`, `ms-ads-event-category`, `ms-ads-event-label`, `ms-ads-event-value`.

```text
[conversion-pixel pixel="ms-ads"]
```

### Outbrain

Az Outbrain konverziójához előbb létre kell hoznod a konverziót az Outbrainben. A JavaScript-eseménynevek az Outbrainben nem szabványosak, ezért az `outbrain-event` paraméterben pontosan azt a nevet kell használnod, amelyet a beállításkor adtál. A kis- és nagybetű számít, ezért írj mindent kisbetűvel.

Példa: ha az Outbrainben `lead` eseményre hozol létre konverziót, és az esemény nevének `lead`-et írsz, akkor az `outbrain-event` értéke is `lead`. Ajánlott eseménynevek: `registration`, `email_sign_up`, `lead`, `download`, `other`.

```text
[conversion-pixel pixel="outbrain" outbrain-event="lead"]
```

### Pinterest

Az esemény alapból `lead`. Felülírásához használd a `pinc-event` paramétert. A `pinc-lead-type` paraméter alapból üres:

```text
[conversion-pixel pixel="pinterest" pinc-event="signup"]
[conversion-pixel pixel="pinterest" pinc-event="signup" pinc-lead-type="New release promotion"]
```

### Reddit

Az esemény alapból `Lead`. Felülírás a `reddit-event` paraméterrel:

```text
[conversion-pixel pixel="reddit" reddit-event="SignUp"]
```

### Snapchat

Az esemény alapból `SIGN_UP`. Felülírás a `snap-event` paraméterrel:

```text
[conversion-pixel pixel="snapchat" snap-event="SIGN_UP"]
```

### Taboola

A Taboola konverziójához a Taboola konverziós beállításában létre kell hoznod az eseményt. Példa: hozz létre új konverziót a `lead` eseményre, és jegyezd fel az esemény nevét, amely a beállító ablak alján lévő kódpéldában látszik. Ezt a nevet add meg a `taboola-event` paraméterben:

```text
[conversion-pixel pixel="taboola" taboola-event="lead"]
```

### TikTok

Az esemény alapból `SubmitForm`. Felülírás a `tiktok-event` paraméterrel:

```text
[conversion-pixel pixel="tiktok" tiktok-event="SubmitForm"]
```

### X (Twitter)

Az esemény alapból `CompleteRegistration`. Felülírás a `twc-event` paraméterrel. Az új X-pixelnél a Lead (vagy Signup) eseményt előbb létre kell hoznod az X Ads Managerben, és a generált eseményazonosítót kell megadnod a `twc-event` paraméterben:

```text
[conversion-pixel pixel="twitter" twc-event="tw-abcde-12345"]
```

## A view-item shortcode

A `view-item` shortcode az összes bekapcsolt pixelt a saját `view-item` eseményével váltja ki, a termék minden adatával együtt. Egyedi készítésű terméklapokon kell, ahol a WooCommerce nem ismeri fel a termékoldalt, így a Pixel Manager nem tudja automatikusan beilleszteni a `view-item` eseményhez szükséges szkripteket.

A `view-item` esemény kiváltásához egyedi terméklapon add hozzá:

```text
[view-item product-id="14"]
```

A `product-id` a termék bejegyzésazonosítója (post ID), amely a termék minden adatát tartalmazza.