Minden visszaigazolt foglalás szerveroldalról jelentve a Google Ads, a Meta, a TikTok, a Microsoft Ads és a GA4 felé

A TapTime az asztal- vagy időpontfoglalást olyan konverzióvá alakítja, amelyből a hirdetési platformok tanulni tudnak: szerveroldalról küldve, a vendég kattintásazonosítójával, a pixelével szemben duplikációszűrve, és webhookon, postbacken vagy API-n keresztül a saját rendszereibe is eljuttatva. Az asztal- és időpontfoglalással jár, havi 10 490 Ft összegtől.

14 napig ingyenes Így jut el egy foglalás

14 napig ingyenesBankkártya nélkülGoogle, Meta és TikTok csatlakoztatása 10 perc alatt

Hirdetéskattintás vagy link gclid · fbclid · UTM-címkék

Foglalás visszaigazolva evt_… · érték · attribúció

Google AdsKattintásos konverzió feltöltése
MetaConversions API
TikTokEvents API
Microsoft AdsUET Conversions API
GA4Measurement Protocol
Tag ManagerdataLayer az oldalon
WebhookAláírt JSON, bármely 2xx
PostbackKövető URL makrókkal
REST APIFoglalások és eseményfolyam

Egy visszaigazolt foglalás, kilenc célpont, egy eseményazonosító.

Mi a foglalási konverziókövetés?

A foglalási konverziókövetés azt jelenti, hogy minden visszaigazolt asztal- vagy időpontfoglalást visszajelentünk annak a platformnak, amely a vendéget hozta, így a Google Ads, a Meta, a TikTok, a Microsoft Ads és a Google Analytics 4 oldalmegtekintések helyett foglalásokat mér, és azokra az emberekre optimalizál, akik valóban foglalnak. A TapTime ezt szerveroldalról végzi, a hirdetési kattintásazonosítóhoz kapcsolva, foglalásonként egyetlen eseményazonosítóval, így az oldalon lévő pixel soha nem számolja kétszer.

Röviden

A konverziókat a TapTime szervere küldi el, amikor a foglalást visszaigazolják, így a hirdetésblokkolók, egy bezárt lap vagy egy lassú telefon nem tudja elveszíteni őket.
A Google Ads a kattintásos konverziót a gclid, gbraid vagy wbraid azonosítóval kapja; a Meta és a TikTok szervereseményt kap a Conversions és Events API-jukon; a Microsoft Ads UET-eseményt kap az msclkid azonosítóval; a GA4 a látogató munkamenetéhez kapcsolt Measurement Protocol eseményt kap.
Minden foglalásnak egy eseményazonosítója van. A pixele vagy konverziós címkéje ugyanezzel az azonosítóval fut le, és a platformok pontosan egyet tartanak meg.
Csak azok a foglalások számítanak, amelyeket a vendégek maguk adtak le. A személyzet által felvitt telefonos foglalásokat és betérő vendégeket soha nem jelentjük konverzióként.
Webhookok, szerver–szerver postbackek és REST API juttatja el ugyanazt a foglalást az attribúciójával együtt a CRM-jébe, a követőrendszerébe, a Zapierbe vagy a saját kódjába.
A vendégrendelések és az új hűségprogram-tagok is jelenthetők — vásárlásként az értékével és tételeivel, illetve regisztrációként —, mindegyik egyszer.
A Telegram, a Slack, a Microsoft Teams, a Google Chat, a Discord és a Mattermost minden új foglalási kérést, rendelést vagy jutalmat olvasható üzenetként kap meg; a Zapier, a Make, az n8n és a Pipedream adatként, bármilyen munkafolyamathoz.
Nincs felár. A konverziókövetés, a webhookok, a postbackek, a chatértesítések, az automatizálás és az API minden modul része.

9
célpont egyetlen visszaigazolt foglaláshoz: 1
eseményazonosító, közös a szerver és a böngésző számára: 30 nap
ideig emlékszünk a vendég kampányára: 8
kézbesítési kísérlet nagyjából egy nap alatt

Miért optimalizál a legtöbb éttermi és szalonhirdetés rossz célra

A hirdetési platformok abból tanulnak, amit Ön konverzióként jelent nekik. Ha csak oldalmegtekintést látnak, olyanokat találnak, akik nézelődnek. Ha visszaigazolt foglalásokat látnak, olyanokat találnak, akik foglalnak.

„A pixel szerint 12 foglalás volt. A tábla szerint 31.”

Egy böngészős címke csak akkor fut le, ha a vendég böngészője engedi: nincs hirdetésblokkoló, nincs szigorú iOS-adatvédelmi beállítás, és a lap még nyitva van, amikor a visszaigazolás betöltődik. Minden elmulasztott foglalás egy jelzés, amelyből a Google és a Meta soha nem tanul.

„A konverzióim között vannak a személyzet által felvitt telefonos foglalások is.”

Egy foglalás, amelyet a recepciós kézzel vitt fel, nem hirdetésből jött. Ha konverzióként számolják, a kampány jobbnak tűnik, mint amilyen, és a költségkeret rossz kulcsszavakra megy.

„Nem tudom megmondani, melyik kampány töltötte meg valójában a teraszt.”

Ha a kampány, a kattintásazonosító és a hivatkozó nincs magán a foglaláson elmentve, a táblán minden foglalás egyformán néz ki. Az Instagram-bejegyzés, a Google-hirdetés és a partnerhotel ugyanannyi elismerést kap: semennyit.

Hogyan lesz egy foglalásból konverzió a TapTime-ban

Négy lépés, és egyiket sem Önnek kell felügyelnie. A teljes útvonal a TapTime oldalán fut, a kattintástól a kézbesítési naplóig.

1

A vendég kattintásazonosítóval vagy címkézett linkkel érkezik

A Google Ads gclid, gbraid vagy wbraid paramétert ad a linkhez. A Meta fbclid, a Microsoft msclkid, a TikTok ttclid paramétert. A saját linkjei utm_source, utm_medium, utm_campaign, utm_term és utm_content címkéket hordoznak. Egy affiliate követő azonosítója click_id, clickid vagy subid formában érkezik. A TapTime ezeket egyszer olvassa be — a foglalási oldalán, az étlapján vagy a saját weboldalába ágyazott foglalási widgetben —, és 30 napig megőrzi a vendég eszközén.
2

A foglalást visszaigazolják

Automatikusan, vagy úgy, hogy a személyzet később jóváhagy egy függő kérést. Mindkét esetben abban a pillanatban, amikor a foglalás visszaigazolt lesz, a TapTime létrehoz egy foglalási eseményt és célpontonként egy kézbesítési sort, ugyanabban az adatbázis-tranzakcióban, mint magát a foglalást. Egy kézbesítés soha nem veszhet el két rendszer között.
3

Minden célpont egy közös azonosítóval kapja meg az eseményt

A Google Ads kattintásos konverziófeltöltést kap a kattintásazonosítóval és a konverzió értékével. A Meta és a TikTok szervereseményt kap a Conversions és Events API-jukon. A Microsoft Ads egyéni UET-eseményt kap a Conversions API-ján keresztül. A GA4 a látogató kliensazonosítójához és munkamenet-azonosítójához kapcsolt Measurement Protocol eseményt kap. A webhookjai aláírt JSON-t kapnak, a követőrendszere a kitöltött makrókkal ellátott postback URL-jét, az API eseményfolyama pedig egy új sort. Az eseményazonosító mindenhol ugyanaz.
4

A hibák újrapróbálódnak, és minden kézbesítést lát

Ha egy célpont hibával válaszol, 1, 5 és 15 perc, majd 1, 3, 6 és 12 óra múlva újrapróbáljuk, összesen nyolc kísérlettel. Az Integrációk képernyő célpontonként mutatja az utolsó 25 kézbesítést a platform saját válaszával, és egy Újraküldés gombot ahhoz, amelyiket azonnal el szeretné küldeni.

Kilencféle módon hagyja el egy visszaigazolt foglalás a TapTime-ot

Csatlakoztasson egyet vagy mindet a kezelőfelület Integrációk menüpontjában. Mindegyikhez tartozik Kapcsolat tesztelése vagy Teszt küldése gomb, kézbesítési napló és lépésről lépésre útmutató a súgóközpontban. A rendelések és a hűségprogram-csatlakozások ugyanezekre a platformokra jelenthetők.

Google Ads konverziókövetés

Két rész, amelyeket együtt is használhat. Egy böngészős címke (konverzióazonosító és címke) fut le a visszaigazoló oldalon. Egy szerveroldali feltöltés a Google Ads API-n keresztül küldi el a konverziót a foglalási link gclid, gbraid vagy wbraid azonosítójával, akkor is, ha a böngészős címkét letiltották. A Google az elmúlt 90 nap kattintásaihoz fogad el feltöltéseket. Mindkettő ugyanazt a rendelésazonosítót hordozza, így egy foglalás egy konverzió.

Google Ads konverziók beállítása

Meta Conversions API (Facebook és Instagram)

Visszaigazolt foglalásonként egy szerveresemény a pixele adatkészletébe, az fbclid azonosítóval, a Meta böngészősütikkel, a vendég IP-címével és böngészőjével, valamint — ha nem kapcsolja ki — a vendég e-mail-címével és telefonszámával, amelyeket SHA-256-tal hash-elünk, mielőtt elhagynák a TapTime-ot. Eseménynévként a Schedule, a Lead vagy a Purchase közül választhat. Tesztelje az Events Manager tesztesemény-kódjával, és nézze meg, ahogy megérkezik.

Meta konverziók beállítása

TikTok Events API

Visszaigazolt foglalásonként egy szerveresemény a TikTok-pixelébe, a foglalási link ttclid azonosítójával, a vendég IP-címével és böngészőjével, valamint — ha nem kapcsolja ki — az e-mail-címével és telefonszámával, amelyeket SHA-256-tal hash-elünk, mielőtt elhagynák a TapTime-ot. Eseménynévként a Schedule, a Lead, a Submit form vagy a Place an order közül választhat. A TapTime a pixelét is elhelyezi a foglalási oldalon, így a böngészős és a szervereseménynek közös azonosítója van, és a TikTok egyet tart meg.

TikTok konverziók beállítása

Microsoft Ads (Bing) konverziók

Két rész, mint a Google Ads-nél. A TapTime elhelyezi az UET-címkéjét a foglalási oldalon, és egyéni eseményt indít, amikor egy vendég foglal. Adja hozzá a Conversions API tokent, és a szerver jelenti azt, amit a címke nem lát: a vendég távozása után visszaigazolt foglalásokat, a vendégrendeléseket és az új hűségprogram-tagokat, az msclkid vagy a hash-elt e-mail-cím és telefonszám alapján jóváírva. A Microsoft az elmúlt 7 nap szervereseményeit fogadja el.

Microsoft Ads konverziók beállítása

Google Analytics 4 foglalási események

Foglalásonként egy booking_confirmed esemény a Measurement Protocolon keresztül, értékkel és pénznemmel, a látogató GA-kliensazonosítójával és a tulajdonságonkénti munkamenet-azonosítóval, így a foglalás a látogatáshoz és az azt hozó kampányhoz kapcsolódik. Jelölje meg kulcseseményként a GA4-ben, és minden riportban, valamint a Google Ads ajánlattételében konverzióként számít.

A Google Analytics 4 csatlakoztatása

Webhookok a CRM-jéhez, a Zapierhez, a Make-hez, az n8n-hez vagy a Pipedreamhez

Rendszerenként egy https-végpont, feliratkozva az Ön által választott foglalási, rendelési és hűségprogram-eseményekre. Minden kérés JSON formátumú, a teljes foglalással, rendeléssel vagy hűségkártyával és annak attribúciójával, HMAC-SHA256 aláírással, így ellenőrizheti, hogy a TapTime-tól jött. Bármely 2xx sikernek számít, a 410 leállítja az újrapróbálást, és minden eseménynek van azonosítója, amely alapján kiszűrheti a duplikátumokat.

Webhook hozzáadása

Szerver–szerver postbackek követőrendszereknek és affiliate partnereknek

Illessze be a hirdetési hálózattól, affiliate platformtól vagy követőrendszertől kapott postback URL-t, és helyezzen el benne helyőrzőket: {click_id}, {event}, {status}, {value}, {currency}, {party_size}, {booking_id}, {utm_source}, {utm_campaign}, {gclid}, {fbclid} és továbbiak. GET vagy POST. A követő kattintásazonosítója akkor jut el a foglaláshoz, ha a linkje click_id, clickid vagy subid paramétert tartalmaz.

Postback beállítása

REST API foglalásokhoz és eseményekhez

Bearer kulcsok, csak olvasási vagy olvasási-írási joggal, kulcsonként percenként 50 kérés. Listázza az asztal- és időpontfoglalásokat állapot, telephely, dátumtartomány vagy updatedSince szerint szűrve, kérjen le egy foglalást, módosítson állapotot a saját rendszeréből, vagy kérdezze le kurzorral a sorba rendezett eseményfolyamot a szinkronban maradáshoz. Az API-n keresztül végzett állapotmódosítások ugyanazokat a webhookokat és konverziókat indítják, mint a tábla.

API-kulcs létrehozása

Analitikai címkék az oldalon

A TapTime-oldala egy biztonságosan elszigetelt analitikai sandboxban hordozza a saját GA4 mérési azonosítóját, GTM-tárolóját és Meta Pixelét. Amikor egy vendég foglal, az oldal booking_confirmed vagy booking_requested eseményt küld az engedélyezett dataLayerbe a foglalás típusával, értékével és eseményazonosítójával, így az analitikai eszközök indíthatnak rá. A rendelési és fizetési oldalak nem kapnak üzleti címkéket, a saját weboldalába ágyazott foglalási widget pedig ugyanezt teszi a weboldala címkéivel.

Címkék hozzáadása az oldalhoz

Nem csak foglalások: a rendelések és a hűségprogram is számítanak

Ugyanaz a kimenő sor, amely a foglalásokat jelenti, azt is jelenti, ami azután történik, hogy a vendég leül. Kapcsolja be az egyes célokat platformonként, a kapcsolat „Mit jelentsünk” szakaszában.

Rendelések vásárlásként

A vendég rendelését az oldaláról, egy asztal QR-kódjáról, elvitelre vagy kiszállításra egyszer küldjük el, amikor megérkezik Önhöz: GA4 purchase a tételeivel, Meta vagy TikTok Purchase a tartalmával, Microsoft Ads vásárlási esemény, Google Ads-feltöltés a saját konverziós műveletébe. Az érték a rendelt összeg, borravaló nélkül. A kasszán beütött eladásokat soha nem jelentjük — azokat nem hirdetés okozta.

Hűségprogram-csatlakozások

Egy ügyfél első pecsétje egy programban regisztrációnak számít: GA4 sign_up, Meta és TikTok CompleteRegistration a hash-elt telefonszám alapján párosítva, Microsoft Ads regisztrációs esemény, Google Ads csak akkor, ha hirdetéskattintásból érkezett. Tagonként és programonként egyszer, akárhány kártyát tölt is meg.

Minden esemény mindenhová máshová

A webhookok, a postbackek, a chatértesítések, az automatizálási platformok és a REST API mind a tizenegy eseményt megkapják: foglalás kérve, visszaigazolva, lemondva, meg nem jelenésként jelölve vagy lezárva; rendelés leadva vagy kifizetve; tag csatlakozása, pecsét, megszerzett és beváltott jutalom.

Böngészőoldali vagy szerveroldali konverziókövetés: melyikre van szüksége egy étteremnek vagy szalonnak?

Mindkettőre, és a TapTime mindkettőt futtatja. A böngészős címke a látogatást adja át a platformoknak; a szervereseménnyel garantált, hogy a foglalás beszámít. Íme, mi változik, ha a szerveroldal is csatlakoztatva van.

Helyzet	Csak pixel vagy címke az oldalon	TapTime szerveroldal + az Ön címkéje
Hirdetésblokkolók és szigorú böngészős adatvédelem	A konverzió észrevétlenül elvész	A szerverről küldjük, függetlenül a vendég böngészőjétől
A vendég bezárja a lapot, mielőtt a visszaigazolás betöltődne	Elvész	A foglalás mentésekor küldjük, nem az oldal megjelenésekor
A személyzet másnap reggel igazol vissza egy függő kérést	Nem töltődik be oldal, nincs konverzió	A visszaigazolás pillanatában küldjük, bárki igazolta is vissza
Telefonos foglalások és betérő vendégek	Beszámít, ha a személyzet ugyanazt az oldalt használja	Soha nem jelentjük; csak a vendég által online leadott foglalásokat
A címke és a szerver is lefut	Két konverzió egyetlen foglalásra	Egy közös eseményazonosító; a platform egyet tart meg
Konverziós érték	Amit a címkébe beégettek	A szolgáltatás ára vagy az Ön által megadott foglalásonkénti érték, opcionálisan a létszámmal szorozva
Melyik kampány kapja a jóváírást	Attól függ, megmaradnak-e a sütik	A kattintásazonosító és az UTM-címkék a foglaláson elmentve, 30 napig megőrizve

Hogyan akadályozza meg a TapTime, hogy egy foglalás kétszer számítson?

Minden foglalásnak pontosan egy konverziós eseményazonosítója van: a foglalás HMAC-értéke, amelyet a TapTime a foglalási válaszban visszaad az oldalnak, és a szerverről is elküld. A böngészős esemény ezt Google Ads-tranzakcióazonosítóként, illetve a Meta, a TikTok és a Microsoft UET-címke eseményazonosítójaként hordozza; a szervereseménynek ugyanez az értéke. Ez a négy platform ez alapján szűri a duplikátumokat, a GA4 pedig egyáltalán nem kap böngészős eseményt, amíg a szerverintegráció csatlakoztatva van. Ha egy foglalást visszaigazolnak, lemondanak, majd újra visszaigazolnak, egy második webhook is megy, mert a rendszerének tudnia kell róla, de egy konverzió marad.

Platform	Szerveroldal	Böngészőoldal	Duplikációszűrő kulcs
Google Ads	uploadClickConversions a kattintásazonosítóval	gtag konverzió send_to paraméterrel	`orderId / transaction_id`
Meta	Conversions API, legfeljebb 7 napos események	fbq track eventID-vel	`event_id`
TikTok	Events API a ttclid azonosítóval	ttq.track event_id-vel	`event_id`
Microsoft Ads	Conversions API, legfeljebb 7 napos események	uetq push event_id-vel	`event_id`
GA4	Measurement Protocol kliens- és munkamenet-azonosítóval	csak ha a szerveroldal nincs csatlakoztatva	`egyszerre egy forrás`

Hogyan néz ki egy TapTime foglalási webhook?

Egy POST kérés JSON-törzzsel: az esemény azonosítója, típusa és ideje, hogy teszt-e, valamint a teljes foglalás (vagy rendelés, vagy hűségkártya), beleértve a vendéget, az időpontot, az asztalt vagy a szolgáltatást, az állapotot és a forrást. Négy fejléc azonosítja és írja alá.

TapTime-Event: az eseménytípus: booking.confirmed, order.placed, loyalty.reward_issued és még nyolc másik
TapTime-Event-Id: az eseményazonosító, minden újrapróbálásnál ugyanaz, a duplikátumok kiszűréséhez
TapTime-Delivery: ennek a konkrét kézbesítési kísérletnek az azonosítója
TapTime-Signature: t=<unix time>,v1=<a "t.body" hexadecimális HMAC-SHA256 értéke> az Ön whsec_ titkos kulcsával

Válaszoljon bármely 2xx állapotkóddal a kérés időkorlátján belül, és a kézbesítés kézbesítettként lesz jelölve.
Minden más választ vagy a válasz hiányát legfeljebb nyolcszor próbáljuk újra, nagyjából egy nap alatt, egyre hosszabb szünetekkel.
Ha 410 Gone választ ad, a TapTime leállítja az adott esemény újrapróbálását az adott végpontra.
Az átirányításokat nem követjük. Éles környezetben a végpontoknak https-nek kell lenniük, és nem mutathatnak privát vagy loopback címre.
Cégenként legfeljebb 50 végpont, chat és automatizálási kapcsolat. Az aláíró titkos kulcsot a tulajdonos újra megjelenítheti vagy lecserélheti; a csere azonnal érvényteleníti a régit.

Webhook-útmutató

POST · application/json · booking.confirmed

{
  "id": "evt_9f3c2a7e1b",
  "type": "booking.confirmed",
  "createdAt": "2026-09-12T19:02:11+03:00",
  "test": false,
  "data": {
    "booking": {
      "kind": "reservation",
      "id": 4821,
      "status": "confirmed",
      "startsAt": "2026-09-12T20:00:00+03:00",
      "partySize": 4,
      "guest": { "name": "Maria K.", "email": "…", "phone": "…" },
      "attribution": {
        "channel": "widget",
        "utmSource": "instagram",
        "utmMedium": "paid_social",
        "utmCampaign": "summer_terrace",
        "gclid": null,
        "fbclid": "IwAR2…",
        "landingUrl": "https://example-bistro.com/?fbclid=…"
      }
    }
  }
}

Az aláírás ellenőrzése (Node.js)

const [t, v1] = req.headers["taptime-signature"]
  .split(",").map(part => part.split("=")[1]);
const expected = crypto
  .createHmac("sha256", process.env.TAPTIME_WEBHOOK_SECRET)
  .update(`${t}.${rawBody}`)
  .digest("hex");
const valid = crypto.timingSafeEqual(
  Buffer.from(expected), Buffer.from(v1));

Hogyan működnek a szerver–szerver postbackek a foglalási konverzióknál?

A postback a követőrendszer saját URL-je, amelyet a TapTime szervere minden eseménynél meghív, a foglalás adataival a helyőrzők helyén. Így számolják a konverziókat az affiliate hálózatok, a CPA-platformok és a kattintáskövetők, anélkül, hogy kód lenne az oldalon. A foglalási linkje click_id, clickid vagy subid paraméterként hordozza a követő kattintásazonosítóját; a TapTime a foglalással együtt eltárolja, és visszahelyezi az URL-be, amikor a foglalást visszaigazolják, lemondják vagy meg nem jelenésként jelölik.

Postback-útmutató

Postback URL helyőrzőkkel · GET vagy POST

https://tracker.example/postback
  ?cid={click_id}
  &event={event}
  &status={status}
  &payout={value}
  &cur={currency}
  &guests={party_size}
  &src={utm_source}

Elérhető helyőrzők

{event}
{event_id}
{status}
{booking_id}
{booking_type}
{order_id}
{customer_id}
{conversion_id}
{value}
{currency}
{party_size}
{branch_id}
{timestamp}
{utm_source}
{utm_medium}
{utm_campaign}
{utm_term}
{utm_content}
{gclid}
{fbclid}
{msclkid}
{ttclid}
{click_id}

Értesítések abban a chatben, amelyet a csapata már használ — és kód nélküli automatizálás

Válassza ki, mely eseményekről kapjon hírt egy chat: új, visszaigazolásra váró foglalási kérés, új rendelés, lemondás, megszerzett jutalom. Mindegyik másodperceken belül megérkezik rövid üzenetként, az Ön által választott nyelven, azzal, hogy ki, mikor, hányan és mennyiért, valamint egy linkkel a kezelőfelületre.

Üzenetküldők

Egy @BotFatherrel létrehozott bot ír egy csoportba, egy csatornába vagy egy csoport egyik témájába. A kezelőfelület megkeresi Önnek a chatet.

Slack

Egy bejövő webhook formázott üzeneteket küld bármelyik csatornába.

Microsoft Teams

Egy Workflows webhook Adaptive Cardot küld a részletekkel és egy gombbal a kezelőfelülethez.

Google Chat

Egy tér webhookja minden eseményt elküld a térbe.

Discord

Egy szerver webhookja színkódolt beágyazást küld; az említések mindig ki vannak kapcsolva.

Mattermost

Bejövő webhook a felhőben vagy a saját üzemeltetésű szerverén.

Chatértesítések beállítása

Automatizálási platformok

Zapier

Catch Hook trigger: minden foglalás a Google Sheetsbe, minden rendelés a könyvelésébe, minden új tag a Mailchimpbe.

Make

Custom webhook trigger routereket, szűrőket és több mint 2000 alkalmazást használó forgatókönyvekhez.

n8n

Webhook node az n8n Cloudon vagy a saját szerverén — az adatoknak soha nem kell elhagyniuk az infrastruktúráját.

Pipedream

HTTP trigger saját Node.js vagy Python lépéseket tartalmazó munkafolyamatokhoz.

Az automatizálási platformok ugyanazt az aláírt JSON-t kapják, mint a webhookok. A számukra készült alkalmazások a REST API-n keresztül fel- és leiratkozhatnak, így a felhasználók URL beillesztése nélkül kapcsolhatják be a triggereket.

Automatizálási platform csatlakoztatása

Mire képes a TapTime REST API?

Elég ahhoz, hogy saját riportokat készítsen, szinkronizáljon egy CRM-et vagy kasszát, vagy egy másik rendszerből igazoljon vissza foglalásokat — partnerprogram és értékesítési hívás nélkül. A kulcsokat az Integrációk menüpontban hozhatja létre, egyszer jelennek meg, SHA-256 hashként tároljuk őket, és egy kattintással visszavonhatók.

Kérés	Visszatérési érték
`GET /v1/company`	A cég, amelyhez a kulcs tartozik
`GET /v1/company/reservations`	Asztalfoglalások status, branchId, from, to vagy updatedSince szerint szűrve; oldalanként legfeljebb 100
`GET /v1/company/appointments`	Időpontfoglalások ugyanezekkel a szűrőkkel
`GET /v1/company/reservations/{id}`	Egy foglalás, a webhook-adatcsomag formájában, az attribúciójával
`POST /v1/company/reservations/{id}/status`	Visszaigazolás, lemondás, meg nem jelenés jelölése, lezárás, leültetés vagy újranyitás (írási kulcsokkal); ugyanazokat a webhookokat és konverziókat indítja
`GET /v1/company/orders`	Rendelések a tételeikkel és végösszegeikkel, status, source, fulfilment, dátum vagy paidSince szerint szűrve
`GET /v1/company/loyalty/cards`	A tagok hűségkártyái; a programoknak és a jutalmaknak saját listájuk van
`GET /v1/company/events?after={cursor}`	Minden foglalási, rendelési és hűségprogram-esemény sorrendben, opcionálisan csak bizonyos típusok; kérdezze le az utolsó kurzorral, hogy szinkronban maradjon
`POST /v1/company/webhooks`	URL feliratkoztatása eseményekre, és DELETE kérés a leiratkozáshoz — REST hookok Zapier-, Make-, n8n- és Pipedream-alkalmazásokhoz

Egy dátum óta módosított, visszaigazolt asztalfoglalások

curl "https://api.tapti.me/v1/company/reservations?status=confirmed&updatedSince=2026-09-01T00:00:00Z" \
  -H "Authorization: Bearer tt_live_…"

Szinkronban maradás az eseményfolyammal

curl "https://api.tapti.me/v1/company/events?after=eyJpZCI6OTk4fQ&limit=100" \
  -H "Authorization: Bearer tt_live_…"

Teljes API-referencia API-útmutató

Milyen attribúciós adatokat tárolunk minden foglalással?

Minden asztal- és időpontfoglalás megőrzi a vendéget hozó kampányt, megtisztítva és magán a foglaláson tárolva. Megjelenik a foglalás részletező paneljén, összesítve a kezelőfelületen Honnan jönnek a foglalások címmel, szerepel a CSV- és Excel-exportokban, és minden webhookkal, API-válasszal és konverzióval együtt elküldjük.

Kampány

utm_source
utm_medium
utm_campaign
utm_term
utm_content

Hirdetési kattintásazonosítók

gclid
gbraid
wbraid
fbclid
msclkid
ttclid
click_id / clickid / subid

Analitikai azonosítás

GA4 kliensazonosító
GA4 munkamenet-azonosító tulajdonságonként
Meta fbp süti
Meta fbc (az fbclid alapján képezve, ha a süti hiányzik)

Kontextus

csatorna: web, widget vagy alkalmazás
érkezési URL
hivatkozó
IP-cím és böngészőazonosító

A vendégoldal egyszer olvassa be a kampányt, azon a címen, amelyen megnyitották, 30 napig megőrzi, és egy későbbi, címkék nélküli látogatás nem törli. Az utolsó kampány számít. A személyzet által kézzel felvitt foglalásoknak és a kasszán beütött rendeléseknek nincs kampányuk, és ez így helyes: a vendég nem linken keresztül érkezett.

Attribúciós útmutató

Mi számít konverziónak, és mi soha?

Konverziónak számít

Egy asztal- vagy időpontfoglalás, amelyet a vendég online adott le a TapTime-oldalán vagy a saját weboldalába ágyazott foglalási widgetben, miután visszaigazolták.
Egy függő kérés, amelyet a személyzete később jóváhagy. A konverziót a jóváhagyás pillanatában küldjük.
Egy Google-kattintásazonosítóval rendelkező foglalás a Google Ads szerveroldali feltöltéseihez. Az azonosító nélküli foglalásokat a Google esetében kihagyjuk, nem jelöljük hibásnak, és továbbra is elmennek a Metának, a GA4-nek és a webhookjainak.

Soha nem számít

Azok a foglalások, amelyeket a személyzete telefonhívás vagy betérő vendég alapján vitt fel. Ezeknek nincs kattintásuk és kampányuk.
Egy második konverzió ugyanarra a foglalásra, akárhányszor nyitják is újra és igazolják vissza.
Lemondott vagy meg nem jelenéssel zárult foglalás. Ezek saját állapotukkal webhook- és postback-eseményként mennek ki, nem konverzióként.

Olyan vállalkozásoknak, amelyek fizetnek a foglalásokért

Ha olyan kattintásokat vásárol, amelyek asztal- vagy időpontfoglalással végződnek, ez a hirdetési fiókja hiányzó fele.

Éttermek, amelyek Google Ads-hirdetéssel szereznek asztalfoglalásokat
Instagramon és Facebookon hirdető éttermek
Instagramról foglaló kozmetikai szalonok
Borbélyüzletek
Online új pácienseket szerző fogászatok
Orvosok és magánrendelők
Masszázs- és wellnessstúdiók
Állatorvosi rendelők
Autószervizek és gumiszervizek
Gyógytorna- és fizioterápiás rendelők
Vendéglátós ügyfelek hirdetéseit kezelő ügynökségek
Foglalásonként fizető affiliate és CPA hálózatok

A konverziókövetés szótára

A platformok által használt fogalmak egy helyen, és hogy mit jelentenek egy foglalás esetében.

Konverzió: Egy művelet, amelyről megmondta egy hirdetési platformnak, hogy számolja és optimalizáljon rá. A TapTime esetében ez egy visszaigazolt, a vendég által online leadott asztal- vagy időpontfoglalás.
Szerveroldali konverziókövetés: A konverzió jelentése egy szerverről a platform API-jára, nem pedig a vendég böngészőjében futó szkriptből, így nem vész el a hirdetésblokkolók, az adatvédelmi beállítások vagy egy bezárt lap miatt.
gclid, gbraid, wbraid: A Google kattintásazonosítói, amelyeket a hirdetés érkezési URL-jéhez ad. A gclid a klasszikus; a gbraid és a wbraid az iOS-alkalmazáskampányok és a webes kampányok adatvédelmet megőrző változatai. A Google Ads egy feltöltött konverziót csak olyan kattintáshoz tud jóváírni, amelyet ezek egyike alapján felismer.
fbclid, fbp, fbc: A Meta kattintásazonosítója az URL-ben, a pixel által beállított böngészőazonosító süti, és az fbclid alapján képzett kattintássüti. Mindhárom segít a Conversions API-nak egy foglalást a hirdetéskattintáshoz párosítani.
Google Ads kattintásos konverziófeltöltés: A Google Ads API metódusa (uploadClickConversions), amellyel egy szerver egy adott kattintáshoz tartozó konverziót jelent, a kattintásazonosítóval, az időponttal, az értékkel és a duplikációszűréshez használt rendelésazonosítóval.
ttclid, msclkid: A TikTok és a Microsoft kattintásazonosítói, amelyeket az automatikus címkézés ad a hirdetés érkezési URL-jéhez. A TikTok Events API és a Microsoft Conversions API ezek alapján írja jóvá a foglalást annak a hirdetéskattintásnak, amely hozta.
Meta Conversions API (CAPI): A Meta szerver–szerver végpontja az eseményekhez. Minden esemény event_id azonosítót hordoz; ha a pixel ugyanazt az eseményt ugyanazzal az azonosítóval küldi el, a Meta egyet tart meg.
GA4 Measurement Protocol: A Google Analytics 4 HTTP-végpontja a szervereseményekhez. Egy esemény akkor kapcsolódik a látogató munkamenetéhez, ha hordozza a GA-sütikből származó kliens- és munkamenet-azonosítót, és a munkamenet nagyjából 72 óránál nem régebbi.
Kulcsesemény: A konverzió neve a GA4-ben. Egy esemény csak akkor számít konverziónak a GA4-riportokban és a Google Ads ajánlattételében, ha az Adminisztráció → Események menüpontban kulcseseményként jelöli meg.
Események duplikációszűrése: Egy közös azonosító küldése a böngészős és a szervereseménnyel, hogy a mindkettőt megkapó platform egyetlen konverziót számoljon.
UTM-paraméterek: utm_source, utm_medium, utm_campaign, utm_term és utm_content: címkék, amelyeket a saját linkjeihez ad, hogy a foglalás emlékezzen a bejegyzésre, hírlevélre, szórólapra vagy partnerre, amely a vendéget hozta.
Webhook: HTTP-kérés, amelyet a TapTime egy Ön által birtokolt URL-re küld, valahányszor történik valami, a teljes részletekkel JSON formátumban és egy ellenőrizhető aláírással.
Postback (szerver–szerver pixel): Egy hirdetési hálózat vagy követőrendszer által megadott URL, amelyet a hirdető szervere minden konverziónál meghív, a helyőrzőkbe beírt kattintásazonosítóval és jutalékösszeggel.
HMAC-SHA256 aláírás: A kéréstörzs és egy időbélyeg kulcsos hash-e, egy közös titkos kulccsal számítva. Ha az Ön oldalán újraszámolja, ezzel igazolja, hogy a kérés a TapTime-tól jött, és nem módosították.
Legalább egyszeri kézbesítés: A garancia, hogy minden esemény kézbesítésre kerül, azzal a kompromisszummal, hogy egy újrapróbálás egy eseményt kétszer is kézbesíthet. Ezért hordoz minden TapTime-esemény azonosítót, amely alapján a duplikátumok figyelmen kívül hagyhatók.
Offline konverzió: A böngészős munkameneten kívül bekövetkező konverzió, például amikor a személyzet másnap igazol vissza egy kérést. A TapTime a visszaigazolás pillanatában küldi el, az eredeti kattintásazonosítóval.

Benne van az árban. Nem kiegészítő, nem magasabb csomag.

A konverziókövetés, a webhookok, a postbackek, a chatértesítések, az automatizálás és a REST API minden modullal jár: a foglalási események az Asztalfoglalással, telephelyenként havi 10 490 Ft összegtől, és az Időpontfoglalással, telephelyenként havi 14 090 Ft összegtől, a rendelési események a QR-étlappal, a hűségprogram-események a Hűségprogrammal. Nincs eseményenkénti díj, és a kézbesítéseknek nincs felső korlátja.

Minden modulnak saját 14 napos ingyenes próbaidőszaka van, az induláshoz nem kell bankkártya, havi számlázás, szerződés nélkül. Ha nem fizet tovább, a modul rövid türelmi idő után szünetel; semmi sem törlődik.

Minden modulban benne van

10 490 Ft-tól / hó helyszínenként

Asztalfoglalás 10 490 Ft összegtől · Időpontfoglalás 14 090 Ft összegtől

Google Ads böngészős címke és szerveroldali feltöltés
Meta Conversions API hash-elt ügyféladatokkal
TikTok Events API a pixellel a foglalási oldalán
Microsoft Ads UET-címke és Conversions API
GA4 Measurement Protocol események
Rendelések vásárlásként, hűségprogram-csatlakozások konverzióként
Telegram-, Slack-, Teams-, Google Chat-, Discord- és Mattermost-értesítések
Zapier, Make, n8n és Pipedream
Legfeljebb 50 webhook, postback, chat és automatizálás
Legfeljebb 10 aktív API-kulcs, egyenként percenként 50 kéréssel
Kézbesítési naplók a platform saját válaszával és Újraküldés gombbal

Csomagok és ingyenes kezdés

14 napig ingyenes · Bankkártya nem szükséges · Bármikor lemondható

Hirdetéskezelők és fejlesztők kérdései

A TapTime a szerverről vagy a vendég böngészőjéből küldi a konverziókat?

Mindkettőből. A szerver abban a pillanatban elküldi a konverziót, amikor a foglalást visszaigazolják, a Google Ads API-n, a Meta Conversions API-n és a GA4 Measurement Protocolon keresztül. A böngészős címkéje vagy pixele is lefuthat; ugyanazt az eseményazonosítót hordozza, így a platformok egy konverziót számolnak.

Szükségem van a Google Tag Managerre a foglalási konverziók követéséhez?

Nem. A TapTime közvetlenül a szerverről kommunikál a Google Ads-szel, a Metával és a GA4-gyel. A Tag Manager csak akkor hasznos, ha más eszközöket szeretne indítani az oldal által a dataLayerbe küldött booking_confirmed eseményből.

Mire van szükségem a Google Ads-ből a szerveroldali feltöltésekhez?

Egy konverziós műveletre, az ügyfélazonosítójára, a konverziós művelet azonosítójára (a művelet címében a ctId= utáni szám) és API-hozzáférésre: fejlesztői tokenre, OAuth-kliensazonosítóra és titkos kulcsra, valamint frissítési tokenre. Ezeket ügynöksége vagy fejlesztője is kiállíthatja. API-hozzáférés nélkül is használhatja a böngészős címkét.

Miért írja egy kézbesítés, hogy „Ehhez a foglaláshoz nem tartozik Google-hirdetéskattintás”?

A vendég nem Google-hirdetésen keresztül érkezett, így a foglalási linkben nem volt gclid, gbraid vagy wbraid. A Google csak olyan kattintásokhoz fogad el feltöltött konverziót, amelyeket felismer, ezért ezt a foglalást a Google Ads esetében kihagyjuk, nem próbáljuk újra. A Metához, a GA4-hez és a webhookjaihoz továbbra is eljut.

Hogyan párosítja a Meta Conversions API a foglalást a hirdetéssel?

A linkben lévő fbclid, a Meta böngészősütik (fbp és fbc), a vendég IP-címe és böngészője, valamint — ha nem kapcsolja ki a Hash-elt e-mail-cím és telefonszám küldése opciót — a vendég e-mail-címe és telefonszáma alapján, amelyeket SHA-256-tal hash-elünk, mielőtt elhagynák a TapTime-ot.

Hogyan jelenti a TapTime a foglalásokat a TikToknak?

A TikTok Events API-n keresztül, a szerverről, abban a pillanatban, amikor a foglalást visszaigazolják. A TapTime a TikTok-pixelét is elhelyezi a foglalási oldalon, így oda nem kell Önnek beillesztenie. Mindkét esemény ugyanazt az eseményazonosítót hordozza, és a TikTok egyet tart meg. A párosítás a linkben lévő ttclid, a vendég IP-címe és böngészője, valamint — ha nem kapcsolja ki — az SHA-256-tal hash-elt e-mail-címe és telefonszáma alapján történik.

Mire van szükségem a konverziók követéséhez a Microsoft Ads-ben (Bing)?

Az induláshoz elég az UET-címke azonosítója: a TapTime elhelyezi a címkét a foglalási oldalán, és lefuttatja az eseményműveletét, amikor egy vendég foglal. Adja hozzá a címke beállításaiból a Conversions API tokent, és a szerver a vendég távozása után visszaigazolt foglalásokat, a vendégrendeléseket és az új hűségprogram-tagokat is jelenti. A Microsoft fiókonként engedélyezi a Conversions API-t, és csak az elmúlt 7 nap eseményeit fogadja el.

Milyen konverziós értéket küldünk?

Időpontfoglalásnál a szolgáltatás árát. Asztalfoglalásnál az Ön által beállított foglalásonkénti értéket, egy átlagos költést, opcionálisan a létszámmal szorozva. Ha üresen hagyja, a konverziókat érték nélkül küldjük.

A személyzetem által felvitt foglalások hirdetési konverziónak számítanak?

Nem. Csak a vendégek által maguk online leadott foglalásokat jelentjük konverzióként. A személyzet által felvitt telefonos foglalások és betérő vendégek soha nem javítják fel a hirdetési eredményeit. Az exportokban és a táblán viszont továbbra is megjelennek.

Mi történik, ha egy foglalást visszaigazolnak, lemondanak, majd újra visszaigazolnak?

A webhookjai és postbackjei minden változást megkapnak, mindegyiket saját eseményazonosítóval és állapottal, mert a rendszerének tudnia kell róla. A Google Ads, a Meta és a GA4 foglalásonként összesen egy konverziót kap.

Hogyan ellenőrizhetem, hogy egy webhook valóban a TapTime-tól jött?

Olvassa ki a TapTime-Signature fejlécet, amely így néz ki: t=1726128000,v1=<hex>. Számítson HMAC-SHA256 értéket a t.body karakterláncra az aláíró titkos kulcsával, és hasonlítsa össze a v1 értékkel konstans idejű összehasonlítással. Utasítsa el a kérést, ha eltér, vagy ha a t régebbi, mint amit elfogadhatónak tart.

Mehet egy webhook a Zapierbe, a Make-be vagy az n8n-be?

Igen. Hozzon létre egy catch vagy custom webhookot az eszközben, illessze be a címét végpontként, és nyomja meg a Teszt küldése gombot, hogy az eszköz megtanulja a mezőket. A foglalás vendégadatai, időpontja, állapota és attribúciója mind benne vannak a JSON-ban.

Mennyi ideig emlékszünk egy kampányra a foglalás előtt?

30 napig a vendég eszközén. Egy vendég hétfőn megnyithatja az étlapját egy Instagram-hirdetésből, és csütörtökön foglalhat; a foglalás továbbra is hordozza azt a kampányt. Egy későbbi, címkék nélküli látogatás nem törli, egy másik kampányból érkező későbbi látogatás viszont felülírja.

A saját weboldalamba ágyazott foglalási widget is követi a konverziókat?

Igen. A beágyazó szkript beolvassa a weboldala UTM-címkéit, kattintásazonosítóit, valamint GA- és Meta-sütijeit, és átadja őket a foglalásnak, így a widgetes foglalást annak a hirdetésnek írjuk jóvá, amely a látogatót az oldalára hozta. A taptime_booking_confirmed eseményt is elküldi a weboldala dataLayerjébe, és lefuttathatja az oldala saját GA4- és Meta-címkéit.

Van kéréskorlát vagy díj API-hívásonként vagy webhookonként?

Az API-kulcsok egyenként percenként 50 kérésre korlátozottak, és egy cégnek legfeljebb 10 aktív kulcsa és 20 webhook- vagy postback-végpontja lehet. Nincs díj hívásonként, eseményenként vagy konverziónként; minden benne van az asztal- és időpontfoglalási előfizetésekben.

Mi történik, ha nem fizetek tovább a modulért?

Rövid türelmi idő után a modul szünetel, és a foglalási oldal ideiglenesen nem elérhető üzenetet mutat. Semmi sem törlődik, az integrációk sem; ha újra fizet, a kézbesítések az új foglalásokra folytatódnak.

Ezek közül bármelyik külön előfizetés?

Nem. A Google Ads-, Meta- és GA4-konverziók, a webhookok, a postbackek és a REST API az Asztalfoglalás modul része havi 10 490 Ft összegtől, és az Időpontfoglalás modulé havi 14 090 Ft összegtől, telephelyenként, 14 napos ingyenes próbaidőszakkal, bankkártya nélkül.

Jelentheti a TapTime a rendeléseket és a hűségprogram-csatlakozásokat konverzióként?

Igen. Minden kapcsolat „Mit jelentsünk” szakaszában bekapcsolhatja a vendégrendeléseket (vásárlásként küldve, értékkel és tételekkel: GA4 purchase, Meta Purchase, vagy egy második Google Ads konverziós művelet) és az új hűségprogram-tagokat (GA4 sign_up, Meta CompleteRegistration). Mindegyiket rendelésenként, illetve tagonként és programonként egyszer küldjük. A kasszán beütött eladásokat soha nem jelentjük.

Hogyan kaphatom meg az új foglalásokat és rendeléseket Telegramon vagy Slacken?

Nyissa meg az Integrációk → Értesítések menüpontot, válassza ki az üzenetküldőt, illessze be a bot tokent (Telegram) vagy a webhook URL-t (Slack, Teams, Google Chat, Discord, Mattermost), válassza ki az eseményeket és a nyelvet, majd nyomja meg a Teszt küldése gombot. Ettől kezdve minden kiválasztott esemény rövid üzenetként érkezik, a kezelőfelületre mutató linkkel. A címet és a tokent titkosítva tároljuk.

Működik a TapTime a Zapierrel, a Make-kel, az n8n-nel és a Pipedreammel?

Igen, telepítendő bővítmény nélkül. Hozzon létre egy catch hookot a platformon, illessze be az URL-jét az Integrációk → Automatizálás menüpontban, válassza ki az eseményeket, és nyomja meg a Teszt küldése gombot, hogy a platform megtanulja a mezőket. Ezután minden foglalási, rendelési és hűségprogram-esemény elindítja a munkafolyamatát, a webhookjainkhoz hasonlóan aláírva. Az alkalmazások maguk is feliratkozhatnak a POST /v1/company/webhooks végponton keresztül.

Lépésről lépésre útmutatók a súgóközpontban

Adja meg hirdetéseinek az egyetlen jelzést, amely számít: a foglalást.

Csatlakoztassa a Google Ads-t, a Metát, a TikTokot, a Microsoft Ads-t és a GA4-et tíz perc alatt, adjon hozzá egy webhookot a CRM-jéhez, és nézze, ahogy megtelik a kézbesítési napló. 14 napig ingyenes, bankkártya nélkül, bármikor lemondható.

14 napig ingyenes Árak megtekintése

14 napig ingyenes Bankkártya nem szükséges Bármikor lemondható