Meta Conversions API (CAPI) ajánlatkérő űrlapokhoz: megkeresések küldése dupla számolás nélkül
Hogyan küldje el a megkereséseket a Metának a Pixelen és a Conversions API-n keresztül egyetlen közös eseményazonosítóval, hogyan szerezzen hozzáférési tokent, hogyan ellenőrizze a Teszteseményekben, és hogyan kezelje a hozzájárulást a hashelt kapcsolattartási adatokná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
- Pixel- (adatkészlet-) azonosító a Meta Eseménykezelőből → Adatforrások.
- 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.
- Teszteseménykód (nem kötelező): a Tesztesemények lapon jelenik meg,
TESTelő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_urluser_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
- változatlanul küldve:
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:
- 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ő.
- Hashelt kapcsolattartási adatokat csak azoknál küldjön, akik hozzájárultak.
- Mindenki másnál csak IP-címmel, user agenttel és kattintásazonosítókkal küldje az eseményt.
- 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, vagy készítse el az ingyenes hozzájárulásiszöveg-generátorral.
Ellenőrzés
- Adja meg a teszteseménykódot, és küldjön be egy tesztmegkeresést.
- 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.
- É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.