# Attribúció: Triple Whale és Hyros

> A Triple Whale és a Hyros beállítása: azonosítók, Orders API, WooCommerce-kapcsolat, hozzájárulás, elküldött események és tesztelés.

A Triple Whale és a Hyros attribúciós platform: a látogató útját a hirdetési költéshez kötik, hogy lásd, mely csatornák és kampányok hozzák a rendeléseket. Mindkettő Pro funkció, és a Pixel Manager **Attribution** kategóriájába tartozik. Az attribúciós pixelek a statisztikai hozzájárulási kategóriát követik: ha a kifejezett hozzájárulási mód (Explicit Consent Mode) be van kapcsolva, a pixel csak a látogató statisztikai hozzájárulása után töltődik be, és csak ezután küld adatot. Mindkét integráció jelenleg béta.

## Triple Whale

A Triple Pixel a webhelyen követi a látogató útját, és összekapcsolja a hirdetési költéssel. A Pixel Manager betölti a Triple Pixelt, elküldi az e-kereskedelmi eseményeket, és szerveroldalon teljes rendelési rekordokat (a visszatérítéseket is) szinkronizálhat a Triple Whale-hez.

### Beállítás

A Triple Whale nem használ pixelazonosítót: a boltot a domain azonosítja, ezért a bekapcsolás egyetlen kapcsoló.

1. A Pixel Managerben nyisd meg a **Tracking Pixels → Triple Whale** kártyát, kapcsold be az **Enable Triple Whale** kapcsolót, és mentsd.
2. Ellenőrizd, hogy a domain egyezik. A Triple Whale a boltot az oldal domainje („TripleName”) alapján azonosítja, és ennek egyeznie kell a Triple Whale **Settings → Store** oldalán megadott **Shop URL** értékkel. Ha egyeznek, kész vagy, az események maguktól megjelennek a Triple Whale-ben.
3. Opcionálisan adj meg egy Orders API-kulcsot, hogy a Pixel Manager szerveroldalon szinkronizálja a rendeléseket. A Triple Whale az attribúcióhoz megköveteli a rendelési rekordokat, ezért ez a lépés erősen ajánlott.

![A Triple Whale kártya az Enable Triple Whale kapcsolóval](./kepek/elemzok-triple-whale.webp)

*A Triple Whale kártya az Enable Triple Whale kapcsolóval* (https://minta-bolt.hu/wp-admin/admin.php?page=pmw)

A kártyán az **Enable Triple Whale** kapcsoló és a leírás látszik, pixelazonosító mező nincs.

### Eltérő bolt-azonosító

Ha a Triple Whale-ben megadott Shop URL eltér a WordPress-webhelyed címétől (például domainváltás után, vagy tesztkörnyezetnél, proxynál), a származtatott bolt-azonosítót a `pmw_triple_whale_shop` szűrővel írhatod felül:

```php
// /wp-content/themes/child-theme/functions.php
add_filter('pmw_triple_whale_shop', function ($shop) {
    return 'example.com';
});
```

### Elküldött események

A Triple Pixel a betöltés után magától követi az oldalbetöltéseket és a látogató útját. Ezen felül a Pixel Manager az alábbi e-kereskedelmi eseményeket küldi:

- `AddToCart`: a termék kosárba tételekor.
- `checkoutStarted`: a pénztár megkezdésekor. A Triple Whale ehhez az eseményhez e-mail-címet vagy telefonszámot követel, ezért csak azoknak a látogatóknak megy el, akiket a Pixel Manager azonosítani tud (jellemzően a bejelentkezett vásárlók).
- `purchase`: a rendelés-visszaigazoló oldalon, a rendelés azonosítójával és a vásárló adataival, hogy a Triple Whale a rendelést a látogató útjához kapcsolhassa.

A `purchase` esemény önmagában nem hozza létre a rendelést a Triple Whale-ben: a hozzá tartozó rendelési rekordot az Orders API-n át szerveroldalon kell szinkronizálni.

### Orders API

Az Orders API-kulccsal a Pixel Manager közvetlenül, szerverről szerverre küldi a rendelési rekordokat a Triple Whale-nek. A Triple Whale ezeket párosítja a Triple Pixel böngészős eseményeivel, így teljes az attribúció.

Ez kiváltja a Triple Whale saját WooCommerce-integrációját: nem kell a bolt REST API-ját összekötni a Triple Whale-lel, és a Triple Whale saját bővítményét sem kell telepíteni. A rendelési adatokat a Pixel Manager maga küldi, a bolt hitelesítő adatai nem hagyják el a webhelyet.

1. Jelentkezz be a Triple Whale-be, és nyisd meg a **Data → APIs** oldalt.
2. Hozz létre egy API-kulcsot **Orders: Write** jogosultsággal, és másold ki.
3. A Pixel Managerben a **Tracking Pixels → Triple Whale** kártyán illeszd be a kulcsot az **Orders API Key** mezőbe, és mentsd.

Beállítás után a Pixel Manager minden új rendelésről rekordot küld, a tételekkel, a vásárló adataival, a szállítással, az adókkal és a kuponkódokkal együtt. Visszatérítéskor a frissített rendelési rekordot a visszatérítés adataival újra elküldi, így a visszatérítések maguktól megjelennek a Triple Whale-ben.

## Hyros

A Hyros hirdetés-attribúciós és követési platform. A Universal Script végigköveti a látogatót a vásárlási úton, és minden lépést visszakapcsol a hirdetésre, e-mailre vagy organikus forrásra, amelyből érkezett. A Pixel Manager betölti a Universal Scriptet, hozzájárulást figyelembe véve, minden oldalon, és megjelöli a vásárlási út mérföldköveit.

### Beállítás: Product Hash

A Hyros a fiókodat a product hash-ből ismeri fel, amely a Universal Script `ph` értéke.

1. Jelentkezz be a Hyrosba, és nyisd meg a **Tracking → Universal Script** oldalt.
2. Másold ki a Universal Scriptet.
3. A Pixel Managerben nyisd meg a **Tracking Pixels → Hyros** kártyát, illeszd be a **Product Hash** mezőbe, és mentsd. A hash-t nem kell kikeresned a kódrészletből: beillesztheted a teljes script címkét vagy csak a script URL-jét, a Pixel Manager kiolvassa belőle a `ph` értéket. Ha a hash-t már ismered, azt is beírhatod.

![A Hyros kártya a Product Hash mezővel és az Application Tag haladó beállítással](./kepek/elemzok-hyros.webp)

*A Hyros kártya a Product Hash mezővel és az Application Tag haladó beállítással* (https://minta-bolt.hu/wp-admin/admin.php?page=pmw)

A kártyán a **Product Hash** mező alatt a **Hide advanced settings** gombbal nyíló részben az **Application Tag** mező látszik.

Ennyi a követőszkript beállítása. A Universal Scriptet ne illeszd be emellett a sablon fejlécébe vagy egy fejléc-szkript bővítménybe: a Pixel Manager már betölti, és a második másolat miatt a Hyros minden látogatást kétszer számolna.

### A WooCommerce összekötése a Hyrosszal (értékesítési adatokhoz)

A Universal Script a látogató útját követi, a bevételt nem jelenti. A Hyros a rendeléseket közvetlenül a WooCommerce-ből olvassa, ezért kell a natív WooCommerce-kapcsolat is:

1. A WordPressben a **WooCommerce → Beállítások → Speciális → REST API** oldalon hozz létre egy olvasási jogú kulcsot.
2. A Hyrosban nyisd meg a **Settings → Integrations** oldalt, keresd meg a WooCommerce-t, kattints a **Configure** gombra, és add meg a fogyasztói kulcsot (consumer key), a fogyasztói titkot (consumer secret), a bolt nevét és a domaint.

E lépés nélkül a Hyros látja a forgalmat, de az eladásokat nem, és az attribúciós jelentések üresek maradnak.

### Application Tag

A Hyros minden látogatóhoz címkét rendel abban a pillanatban, amikor egy követett oldalra érkezik. Alapértelmezetten ez `!clicked`, és a Hyrosban a **Tracking → Universal Script** oldal **Application Tag** mezőjében állítható.

Ha ott megváltoztattad, ugyanazt az értéket add meg a Pixel Managerben a **Tracking Pixels → Hyros → Advanced → Application Tag** mezőben. Üresen hagyva a Hyros alapértelmezése érvényes.

Érdemes átírni, ha ugyanaz a Hyros-fiók több értékesítési csatornát követ, és a bolt forgalmát külön akarod választani. Csak betű, számjegy, aláhúzás, kötőjel és a vezető felkiáltójel engedélyezett.

### Elküldött események

A Universal Script az oldalmegtekintéseket és az érkezési címkét magától rögzíti. Ezen felül a Pixel Manager műveleti címkéket ad a látogató útjához, így a Hyros útnézetében a vásárlási út ellenőrzőpontok láncaként látszik:

| Mérföldkő | Hyros műveleti címke |
|---|---|
| Termék kosárba tétele | `!add_to_cart` |
| Pénztár megkezdése | `!begin_checkout` |
| Vásárlás befejezése | `!purchase` |

Ezek a címkék az út mérföldkövei: rendelési értéket és tételeket nem tartalmaznak, és nem hozzák létre az eladást a Hyrosban. Az eladás a fent leírt WooCommerce-kapcsolatból jön.

### Tesztelés

1. Nyisd meg a boltot a böngésző konzoljával, és kapcsold be a Pixel Manager naplózóját (az URL végére `?pmwloggeron`). A konzolban a `Hyros: pixel loaded` sort kell látnod.
2. A hálózati fülön keress egy `t.hyros.com/v1/lst/universal-script` kérést. Ez `ph` néven a product hash-t, `tag` néven az application tag-et, `ref_url` néven az aktuális oldal URL-jét viszi.
3. Tegyél egy terméket a kosárba, és fejezz be egy tesztrendelést. A konzol a `Hyros: !add_to_cart tag sent` és a `Hyros: !purchase tag sent` sort naplózza.
4. A Hyrosban nyisd meg az adott látogató útját. A műveleti címkék az attribúció ideje szerint rendezve látszanak, legfelül a legfrissebb esemény.

Ha a script nem töltődik be, ellenőrizd, hogy a Hyros be van-e kapcsolva a Pixel Managerben, helyes-e a product hash, és hogy a sütibannered megadja-e a statisztikai hozzájárulást.

A [Támogatott események](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/funkciok-esemenyek/) fejezetben az összes platform eseményei megtalálhatók.