# AppLovin

> Az AppLovin (Axon) pixel beállítása: eseménykulcs, Advanced Matching, Conversion API, shortcode és a támogatott események.

Pro funkció, a bővítmény bétában kezeli. Az AppLovin az Axon hirdetési platformján keresztül futtat webes kampányokat. Az Axon pixel azokat a vásárlási eseményeket követi, amelyeket az AppLovin az attribúcióhoz és a kampányok optimalizálásához használ. Ha az eseménykulcs be van állítva, a Pixel Manager maga tölti be a pixelt, és maga küldi az összes konverziós eseményt. A beállítások a **Tracking Pixels** fül **AppLovin** kártyáján vannak.

![Az AppLovin kártya az Event Key, a Conversion API Key és az Advanced Matching beállítással](./kepek/pixelek-applovin.webp)

*Az AppLovin kártya az Event Key, a Conversion API Key és az Advanced Matching beállítással* (https://minta-bolt.hu/wp-admin/admin.php?page=pmw)

A képen az **Event Key** alapmező és a **Show advanced settings** alatti **Conversion API Key** mező, valamint az **Advanced Matching** kapcsoló látható.

## Alapbeállítás

1. Nyisd meg az AppLovin felületét, és lépj az **Account → General → Keys** oldalra.
2. Másold ki az eseménykulcsot (Event Key).
3. A Pixel Managerben a **Tracking Pixels → AppLovin** kártyán illeszd be a kulcsot az **Event Key** mezőbe, és mentsd.

Ennyi az egész. Nem kell kézzel beillesztened az AppLovin pixelkódját vagy az eseménykódokat: a Pixel Manager mindent maga tölt be és küld. Ugyanez az eseménykulcs a Conversion API pixelazonosítója is, tehát csak egy azonosítót kell megadnod.

Mint minden hirdetési pixel, az AppLovin is csak akkor töltődik be, ha a látogató megadta a marketing-hozzájárulást.

### Mit küld a pixel

A Pixel Manager az AppLovin saját eseménynevein küld adatot, amelyek a GA4 elnevezését követik (`axon("track", ...)` hívással). Az AppLovin vásárlási oldalakra előírt minimuma: `page_view`, `view_item`, `add_to_cart`, `begin_checkout` és `purchase`, valamint a `sign_up` és a `login`. A bővítmény ezek mindegyikét, és még néhány továbbit is küld.

A tételek ezeket a mezőket tartalmazzák:

- `item_id`: a termékazonosító beállítás szerint, így egyezik a katalógusodban lévő azonosítókkal
- `item_name`
- `price`
- `quantity`
- `item_brand`
- `item_variant_id`: változatoknál

Az AppLovin ismeri az `item_category_id` és az `image_url` mezőt is, de ezeket a bővítmény nem küldi: az `item_category_id` Google-termékkategória-szám, amit a WooCommerce nem tárol, a termékképet pedig az adatréteg nem hordozza.

### Kettőzésmegelőzés

Minden böngészős esemény kap egy `dedupe_id` azonosítót, és a Conversion API ugyanazt küldi ugyanarra az eseményre. Vásárlásnál a `dedupe_id` értéke `pmw_<rendelésazonosító>`. Az AppLovin az öt percen belül érkező ismétlődéseket összevonja, így az az esemény, amely mindkét csatornán megérkezik, egyszer számít.

### Az aleid és az alart URL-paraméter megtartása

Az AppLovin minden hirdetéskattintás URL-jéhez hozzáfűzi az `aleid` és az `alart` paramétert, és az attribúcióhoz szüksége van rájuk a céloldalon. Ügyelj rá, hogy semmilyen átirányítás ne dobja el őket a webhelyeden, például olyan, amely levágja a lekérdezési paramétereket, kényszerített nyelvi vagy pénznem-átirányítás, vagy URL-rövidítő. Ha egy átirányítás elveszíti őket, az adott látogatás attribúciója megszűnik.

## Advanced Matching

Bekapcsolva a Pixel Manager a bejelentkezett vásárlók és a vásárlók e-mail-címét, telefonszámát és felhasználóazonosítóját SHA-256-tal hash-elve küldi az AppLovinnak, a pixeleseményekkel és a Conversion API eseményeivel is. A Conversion API ezen felül az országot és az irányítószámot is megkapja.

A hash-elés az AppLovin saját normalizálási szabályait követi: az e-mail-címek kisbetűsek lesznek, a Gmail és Googlemail címekből a pontok és a plusz utáni rész kikerül, a telefonszámból pedig csak a számjegyek maradnak az országhívószámmal együtt.

Minden személyes adat a szervereden hash-elődik, mielőtt kimenne. Az AppLovin csak a hash-eket kapja, a nyers értékeket soha.

A kapcsoló a **Tracking Pixels → AppLovin → Advanced Matching** helyen van (a **Show advanced settings** alatt).

Az AppLovin a `purchase` és a `sign_up` eseményeknél kötelezőnek jelöli a felhasználói adatot. Ha az Advanced Matching ki van kapcsolva, az AppLovin Pixel Helper hiányosnak jelzi a vásárlási eseményt, ezért érdemes bekapcsolni.

## Conversion API (CAPI)

A Conversion API az AppLovin pixel opcionális kiegészítése, amely a konverziós adatot szerver-szerver kapcsolaton küldi az AppLovinnak. A vásárlásokat a WooCommerce-rendelésből küldi, ezért akkor is követhetők, ha egy hirdetésblokkoló leállítja a pixelt, vagy a vásárló a rendelés-visszaigazoló oldal betöltése előtt bezárja a lapot. A böngészős tölcsér-események is átmennek a Conversion API-n, és a közös `dedupe_id` miatt nem számolódnak kétszer.

1. Nyisd meg az AppLovin felületét, és lépj az **Account → General → Keys** oldalra.
2. Másold ki a Conversion API kulcsot. Ha nem látszik ott, kérd meg az AppLovin ügyfélszolgálatát, hogy állítson ki egyet a fiókodhoz.
3. A Pixel Managerben a **Tracking Pixels → AppLovin** kártyán, a **Show advanced settings** alatt illeszd be a kulcsot a **Conversion API Key** mezőbe, és mentsd.

A Conversion API az alapbeállításban megadott eseménykulcsot használja pixelazonosítóként, ezért második azonosító nem kell.

### Azonosítók

Az AppLovin a Conversion API eseményeit ezek alapján párosítja:

- a pixel `_axwrt` látogatósütije
- az AppLovin `aleid` kattintásazonosítója, amelyet a bővítmény a céloldal URL-jéből és a pixel `_axeid` sütijéből rögzít, és a rendelés mellett tárol, így a szerveroldali vásárlási esemény is hordozza
- a kliens IP-címe és a böngésző azonosítója (user agent)
- a hash-elt e-mail-cím, telefonszám és felhasználóazonosító, ha az Advanced Matching be van kapcsolva

Az AppLovin elutasítja azt az eseményt, amelynek egyik azonosítója sincs meg (látogatóazonosító, kattintásazonosító, e-mail, telefon vagy felhasználóazonosító). A Pixel Manager ezért az ilyen eseményt kihagyja, ahelyett hogy eleve sikertelen kérést küldene.

A vásárlások a SweetCode Clouddal mennek, ha az aktív, különben közvetlenül az AppLovinnak.

### Fokozott felhasználóazonosítás

Az AppLovin azt javasolja, hogy a pixel `_axwrt` sütijét a szerver által beállított sütibe is másold át, mert a Safari korlátozza a JavaScripttel írt sütik élettartamát, és a visszatérő látogatók pár nap után újnak látszanának. A Pixel Manager ezt magától elvégzi: az `_axwrt` értékét egy szerver által beállított `axwrt` sütibe másolja, amely egy évig él, a bolt `www` nélküli domainjén, `SameSite=Lax` beállítással.

A süti csak akkor kerül be, ha a látogató megadta a marketing-hozzájárulást, és csak a Pixel Manager saját, gyorsítótárazatlan kéréséből, a kosár és a pénztár oldalon, így az oldal gyorsítótárazását nem érinti.

### Tesztelés

A böngészős események ellenőrzéséhez használd az **AppLovin Pixel Helper** Chrome-bővítményt (a Chrome webáruházban érhető el). Minden eseményt zölddel, narancssárgával vagy pirossal jelöl aszerint, hogy teljes, hiányoznak az ajánlott mezői, vagy érvénytelen.

Az AppLovin nem ad teszteseménykódot a Conversion API-hoz, ezért nem lehet olyan szerveroldali eseményt küldeni, amely kimarad a jelentésekből.

A Conversion API hívásait a [Server-Side Proxy](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/szerveroldal/) is át tudja venni a WooCommerce szervertől, így csökken a szerver terhelése, és az események egy saját aldomainen át mennek.

## Shortcode

A `[conversion-pixel]` shortcode lead-konverziót küld az AppLovinnak, például űrlapokhoz és más, a bolt tölcsérén kívüli konverziókhoz. Alapból `generate_lead` eseményt küld.

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

Másik eseményhez állítsd az `applovin-event` paramétert `generate_lead`, `sign_up` vagy `subscribe` értékre.

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

Az AppLovin a 0 értékű leadet leértékeli, ezért az `applovin-value` paraméterrel adj meg értéket.

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

## Támogatott események

A Pixel Manager ezeket az AppLovin-eseményeket küldi:

| Esemény | Mikor megy |
|---|---|
| `page_view` | minden oldalon |
| `view_item` | terméklapon, a termék adataival |
| `add_to_cart` | kosárba tételkor, a termék adataival, árral és mennyiséggel |
| `remove_from_cart` | termék kosárból való eltávolításakor |
| `view_cart` | a kosár oldalon, a kosár tételeivel |
| `begin_checkout` | a pénztár indításakor, a kosár értékével és tételeivel |
| `add_payment_info` | amikor a vásárló fizetési módot választ a pénztárban |
| `search` | keresési találati oldalon, a `search_term` értékkel és a találati tételekkel |
| `login` | bejelentkezéskor |
| `sign_up` | vásárlói fiók létrehozásakor |
| `purchase` | rendeléskor: a rendelésszám `transaction_id`-ként, az érték, adó, szállítás, pénznem, az új vásárló jelzése és az összes tétel |
| `generate_lead`, `sign_up`, `subscribe` | a `[conversion-pixel]` shortcode küldi |

A `purchase` értékét az AppLovin adó és szállítás nélkül értelmezi, a bővítmény pedig a marketingérték beállítás szerint számolja (lásd [Bolt beállításai](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/elso-lepesek-bolt-beallitasok/)). Az általános eseménylista a [Támogatott események](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/funkciok-esemenyek/) fejezetben van.

Az AppLovin a követőeseményekben szereplő termékazonosítókat a neki megadott termékkatalógushoz párosítja. Ügyelj rá, hogy a Pixel Managerben beállított termékazonosító egyezzen az AppLovinnak megadott katalógus azonosítóival (lásd [Általános beállítások](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/altalanos/)).