# Meta Conversions API (CAPI) ajánlatkérő űrlapokhoz: megkeresések küldése dupla számolás nélkül

> **Válasz**: A Meta Conversions API (CAPI) az eseményeket az Ön szerveréről küldi, nem a látogató böngészőjéből. Használja a Pixellel együtt, és adja meg **mindkettőnél ugyanazt az eseménynevet és ugyanazt az eseményazonosítót**; a Meta ekkor az egyiket megtartja, a duplikátumot pedig elveti. Azokat a megkereséseket, amelyeket a Pixel elmulaszt (hirdetésblokkolók, böngészős követési korlátozások, bezárt lapok), a szerveroldali esemény így is rögzíti.

## Miért nem elég önmagában a Pixel

A Pixel a látogató böngészőjében fut. A hirdetésblokkolók, az iOS követési korlátozásai és az, hogy az emberek beküldés után azonnal bezárják a lapot, mind eseményvesztéssel járnak. A Meta ilyenkor kevesebb konverziót jelent, és kevesebb adat alapján optimalizálja a hirdetéseit. A szerveroldali másolat kitölti ezt a rést.

## Amire szüksége lesz

1. **Pixel- (adatkészlet-) azonosító** a Meta Eseménykezelőből → Adatforrások.
2. **Conversions API hozzáférési token**: Eseménykezelő → az adatkészlete → Beállítások → Conversions API → Hozzáférési token létrehozása.
3. **Teszteseménykód** (nem kötelező): a Tesztesemények lapon jelenik meg, `TEST` előtaggal kezdődik.

## Hogyan működik a deduplikáció

| Küldő | Eseménynév | Eseményazonosító |
|---|---|---|
| Böngészős Pixel | `Lead` | `fbq('track', 'Lead', {}, {eventID: 'abc123'})` |
| Szerver (CAPI) | `Lead` | `"event_id": "abc123"` |

Ha mindkét helyről ugyanaz a név és azonosító érkezik, a Meta egyet tart meg. Ha az azonosítók eltérnek, vagy a név más (például `Lead` és `SubmitApplication`), a megkeresést kétszer számolja. A beküldés pillanatában generáljon egyetlen azonosítót a böngészőben, és adja át mindkettőnek.

## Mit tartalmazzon a szerveroldali esemény

- `event_name` (Lead), `event_time`, `event_id`, `action_source: "website"`, `event_source_url`
- `user_data`
  - változatlanul küldve: `client_ip_address`, `client_user_agent`, `fbc` (kattintásazonosító süti), `fbp` (böngészőazonosító süti)
  - SHA-256-tal hashelve: telefonszám (`ph`, számjegyek országkóddal, pl. 821012345678), e-mail-cím (`em`, kisbetűsítve), név

Több azonosító javítja az eseményegyezési minőséget (Event Match Quality), de előbb rendezze a hozzájárulás kérdését.

## Hozzájárulás: a hashelt adat is személyes adat

Korea személyes adatok védelméről szóló törvénye (Personal Information Protection Act) – és a legtöbb adatvédelmi jogszabály – szerint egy telefonszám hashelése nem teszi azt anonimmá, a Meta pedig külföldi címzettnek minősül. Egy biztonságos beállítás:

1. Vegyen fel egy külön, nem kötelező hozzájárulást a „hirdetésméréshez szükséges, határon átnyúló adattovábbításra”: címzett (Meta Platforms), ország, adatkör, cél, megőrzési idő.
2. Hashelt kapcsolattartási adatokat csak azoknál küldjön, akik hozzájárultak.
3. Mindenki másnál csak IP-címmel, user agenttel és kattintásazonosítókkal küldje az eseményt.
4. Soha ne küldjön egészségügyi adatot, például tüneteket.

Lásd: [hozzájárulási szöveg ajánlatkérő űrlapokhoz Koreában](/en/guides/landing-consent-text), vagy készítse el az [ingyenes hozzájárulásiszöveg-generátorral](/en/tools/consent).

## Ellenőrzés

1. Adja meg a teszteseménykódot, és küldjön be egy tesztmegkeresést.
2. A Tesztesemények lapon egy Böngésző és egy Szerver eseményt kell látnia, amelyek közül az egyik deduplikáltként van megjelölve.
3. Élesítés előtt távolítsa el a tesztkódot.

## Az eredmények visszaküldése

Amikor egy megkeresésből konzultáció vagy eladás lesz, küldjön egy egyéni szerveroldali eseményt ugyanazokkal a hashelt azonosítókkal (vagy egy külső azonosítóval). A Meta így megtanulhatja, kik jutnak tovább az űrlap kitöltésénél.

## A CutLandingben

Illessze be a Pixel-azonosítót és a hozzáférési tokent a Beállítások → Összekapcsolás menüben. A megkeresés mentése után a Pixel- és a szerveroldali esemény ugyanazzal az azonosítóval megy ki, hashelt kapcsolattartási adatok csak azoknál kerülnek hozzá, akik hozzájárultak a hirdetésméréshez, egészségügyi adat soha nem kerül elküldésre, a sikertelen kézbesítéseket pedig a rendszer 24 órán át újrapróbálja.

## FAQ

### Elhagyhatom a Pixelt, és használhatom csak a Conversions API-t?

A Meta mindkettő együttes, deduplikációval történő használatát javasolja. A böngészőből származó adatok (az fbp és fbc sütik) segítik az egyeztetést, és ha az egyik oldal hibázik, a másik akkor is rögzíti a megkeresést.

### A megkereséseimet kétszer számolja a rendszer. Miért?

Az eseménynevek vagy az eseményazonosítók eltérnek a Pixel és a szerver között. Beküldésenként egyetlen azonosítót használjon mindkét oldalon, és ugyanazt az eseménynevet.

### Mi a teendő, ha kiszivárog a hozzáférési token?

Generáljon új tokent az Eseménykezelőben, és cserélje le mindenhol, ahol használatban van. A tokent csak a szerveren tárolja, soha ne az oldal HTML-kódjában.


---
Source: https://cutlanding.com/hu/guides/meta-conversions-api
© CutLanding (컷랜딩). Quote freely with a link to the source.
