Fiecare rezervare confirmată, raportată la Google Ads, Meta, TikTok, Microsoft Ads și GA4 de pe server

TapTime transformă o rezervare la masă sau o programare într-o conversie din care platformele publicitare pot învăța: trimisă de pe server împreună cu ID-ul clicului oaspetelui, deduplicată în raport cu pixelul dvs. și livrată către propriile dvs. sisteme prin webhook, postback sau API. Inclus în rezervările și programările începând de la 390 MDL pe lună.

14 zile gratuiteNu este necesar un cardConectați Google, Meta și TikTok în 10 minute

Clic pe anunț sau pe link gclid · fbclid · Etichete UTM
Rezervare confirmată evt_… · valoare · atribuire
  • Google AdsÎncărcare conversii pe clic
  • MetaConversions API
  • TikTokEvents API
  • Microsoft AdsUET Conversions API
  • GA4Measurement Protocol
  • Tag ManagerdataLayer pe pagină
  • WebhookSemnat JSON, orice 2xx
  • PostbackURL-ul trackerului cu macrocomenzi
  • REST APIRezervări și flux de evenimente
O rezervare confirmată, nouă destinații, un ID de eveniment.

Ce este urmărirea conversiilor rezervărilor?

Urmărirea conversiilor din rezervări înseamnă raportarea fiecărei rezervări sau programări confirmate înapoi către platforma care a adus clientul, astfel încât Google Ads, Meta, TikTok, Microsoft Ads și Google Analytics 4 să măsoare rezervări în loc de afișări de pagină și să optimizeze către oamenii care chiar rezervă. TapTime face asta de pe server, legat de ID-ul clicului pe reclamă, cu un singur ID de eveniment per rezervare, astfel încât un pixel din pagină să nu o numere niciodată de două ori.

Pe scurt

  • Conversiile sunt trimise de pe serverul TapTime atunci când o rezervare este confirmată, astfel încât blocatoarele de reclame, o filă închisă sau un telefon lent nu le pot pierde.
  • Google Ads primește conversia pe clic cu gclid, gbraid sau wbraid; Meta și TikTok primesc un eveniment de server prin Conversions API și Events API; Microsoft Ads primește un eveniment UET cu msclkid; GA4 primește un eveniment Measurement Protocol legat de sesiunea vizitatorului.
  • Fiecare rezervare are un singur ID de eveniment. Pixelul sau eticheta de conversie se activează cu același ID, iar platformele păstrează exact unul singur.
  • Se iau în calcul doar rezervările efectuate direct de clienți. Rezervările telefonice și cele fără programare introduse manual de personal nu sunt niciodată raportate ca conversii.
  • Webhook-urile, postback-urile server-la-server și un REST API transmit aceeași rezervare, împreună cu atribuirea acesteia, către CRM, tracker, Zapier sau propriul dvs. cod.
  • Comenzile oaspeților și membrii noi ai programului de fidelizare pot fi raportați și ei — ca achiziție, cu valoarea și produsele ei, și ca înscriere — fiecare o singură dată.
  • Telegram, Slack, Microsoft Teams, Google Chat, Discord și Mattermost primesc fiecare cerere nouă de rezervare, comandă sau recompensă ca mesaj ușor de citit; Zapier, Make, n8n și Pipedream o primesc ca date pentru orice flux de lucru.
  • Nu există nicio taxă suplimentară. Urmărirea conversiilor, webhook-urile, postback-urile, alertele în chat, automatizarea și API-ul fac parte din fiecare modul.
9
destinații pentru o rezervare confirmată
1
ID-ul evenimentului partajat de server și browser
30 de zile
campania oaspetelui este memorată
8
încercări de livrare pe parcursul a aproximativ o zi

De ce majoritatea anunțurilor pentru restaurante și saloane de înfrumusețare se optimizează pentru elementele greșite

Platformele publicitare învață din ceea ce raportați ca fiind o conversie. Dacă tot ce văd este o vizualizare a paginii, vor identifica persoanele care doar se uită. Dacă văd rezervări confirmate, vor identifica persoanele care rezervă.

01

„Pixelul indică 12 rezervări. Tabloul indică 31.”

O etichetă de browser se declanșează numai dacă browserul oaspetelui permite acest lucru: fără blocator de reclame, fără setări stricte de confidențialitate „iOS”, fila rămânând deschisă în momentul încărcării confirmării. Fiecare rezervare pe care o ratează reprezintă un semnal din care Google și Meta nu învață niciodată.

02

„Conversiile mele includ apelurile telefonice introduse de angajații mei.”

O rezervare introdusă manual de recepționer nu provine dintr-un anunț. Atunci când aceasta este contabilizată ca o conversie, campania pare mai performantă decât este în realitate, iar bugetul este alocat cuvintelor cheie greșite.

03

„Nu pot spune care campanie a umplut efectiv terasa.”

Fără campania, ID-ul clicului și sursa de referință salvate în însăși rezervarea, fiecare rezervare arată la fel în tabel. Postarea de pe Instagram, anunțul Google și hotelul partener primesc toate același credit, adică niciunul.

Cum o rezervare devine o conversie în TapTime

Patru pași, dintre care niciunul nu necesită intervenția dumneavoastră. Întregul proces se desfășoară pe partea TapTime, de la clic până la jurnalul de livrare.

  1. 1

    Oaspetele ajunge pe pagină cu un ID de clic sau un link etichetat

    Google Ads adaugă gclid, gbraid sau wbraid la link. Meta adaugă fbclid, Microsoft, msclkid, TikTok și ttclid. Linkurile dvs. proprii conțin utm_source, utm_medium, utm_campaign, utm_term și utm_content. ID-ul unui tracker de afiliere apare sub forma click_id, clickid sau subid. TapTime le citește o singură dată, pe pagina dvs. de rezervări, în meniul dvs. sau în widgetul de rezervări de pe site-ul dvs., și le păstrează timp de 30 de zile pe dispozitivul oaspetelui.

  2. 2

    Rezervarea este confirmată

    Automat sau prin aprobarea ulterioară a unei solicitări în așteptare de către personalul dvs. În orice caz, în momentul în care rezervarea este confirmată, TapTime înregistrează un eveniment de rezervare și un rând de livrare pentru fiecare destinație, în aceeași tranzacție de bază de date ca și rezervarea însăși. O livrare nu se poate pierde niciodată între cele două sisteme.

  3. 3

    Fiecare destinație primește evenimentul cu un singur ID comun

    Google Ads primește o încărcare de conversie pe clic cu ID-ul clicului și valoarea conversiei. Meta și TikTok primesc un eveniment de server prin Conversions API și Events API. Microsoft Ads primește un eveniment UET personalizat prin propriul Conversions API. GA4 primește un eveniment Measurement Protocol legat de ID-ul de client și de sesiune al vizitatorului. Webhook-urile dumneavoastră primesc JSON semnat, trackerul primește URL-ul său de postback cu macrourile completate, iar fluxul de evenimente al API adaugă un rând. ID-ul evenimentului este același peste tot.

  4. 4

    În caz de eșec, se va încerca din nou, iar dvs. puteți vedea fiecare livrare

    O destinație care răspunde cu o eroare este încercată din nou după 1, 5 și 15 minute, apoi după 1, 3, 6 și 12 ore, în total opt încercări. Ecranul „Integrări” afișează ultimele 25 de transmiteri per destinație, împreună cu răspunsul propriu al platformei, precum și un buton „Trimite din nou” pentru cea pe care doriți să o trimiteți chiar acum.

Nouă moduri în care o rezervare confirmată părăsește TapTime

Conectați una sau pe toate din secțiunea „Integrări” a panoului. Fiecare are un buton „Testează conexiunea” sau „Trimite un test”, un jurnal de livrări și un ghid pas cu pas în centrul de ajutor. Comenzile și înscrierile la fidelizare pot fi raportate acelorași platforme.

Google Ads urmărirea conversiilor

Două părți pe care le puteți utiliza împreună. O etichetă de browser (ID de conversie și etichetă) se activează pe pagina de confirmare. O încărcare pe server trimite conversia prin API-ul Google Ads cu gclid, gbraid sau wbraid din linkul de rezervare, chiar și atunci când eticheta de browser a fost blocată. Google acceptă încărcări pentru clicurile din ultimele 90 de zile. Ambele conțin același ID de comandă, astfel încât o rezervare reprezintă o singură conversie.

Configurați conversiile „Google Ads”

Meta Conversions API (Facebook și Instagram)

Un eveniment server pentru fiecare rezervare confirmată, trimis către setul de date al pixelului dvs. împreună cu fbclid, cookie-urile de browser Meta, adresa IP și browserul oaspetelui și, dacă nu dezactivați această opțiune, adresa de e-mail și numărul de telefon al oaspetelui, hash-uite cu SHA-256 înainte ca acesta să părăsească TapTime. Alegeți „Schedule”, „Lead” sau „Purchase” ca nume al evenimentului. Testați cu un cod de eveniment de test de la Events Manager și urmăriți cum acesta ajunge la destinație.

Configurați conversiile Meta

TikTok Events API

Un eveniment de server pentru fiecare rezervare confirmată, trimis către pixelul dumneavoastră TikTok cu ttclid din linkul de rezervare, adresa IP și browserul clientului și, dacă nu dezactivați opțiunea, e-mailul și telefonul acestuia, criptate cu SHA-256 înainte de a părăsi TapTime. Alegeți „Schedule”, „Lead”, „Submit form” sau „Place an order” ca nume de eveniment. TapTime pune pixelul și pe pagina de rezervare, așa că evenimentul din browser și cel de pe server au același ID, iar TikTok păstrează unul singur.

Configurați conversiile TikTok

Conversii în Microsoft Ads (Bing)

Două jumătăți, ca la Google Ads. TapTime pune eticheta UET pe pagina de rezervare și declanșează un eveniment personalizat când un client rezervă. Adăugați tokenul Conversions API și serverul raportează ce nu vede eticheta: rezervări confirmate după plecarea clientului, comenzile clienților și noii membri de fidelitate, creditate prin msclkid sau prin e-mailul și telefonul criptate. Microsoft acceptă evenimente de server din ultimele 7 zile.

Configurați conversiile Microsoft Ads

Google Analytics 4 evenimente de rezervare

Un eveniment „booking_confirmed” pentru fiecare rezervare efectuată prin intermediul Measurement Protocol, cu valoarea și moneda, ID-ul de client GA al vizitatorului și ID-ul sesiunii pentru fiecare proprietate, astfel încât rezervarea să fie asociată cu vizita și cu campania care a condus la aceasta. Marcați-l ca eveniment cheie în GA4 și acesta va fi considerat o conversie în fiecare raport și în licitațiile Google Ads.

Conectați-vă la Google Analytics 4

Webhook-uri pentru CRM, Zapier, Make, n8n sau Pipedream

Un punct final https pentru fiecare sistem, abonat la evenimentele de rezervare, comandă și fidelizare pe care le alegeți. Fiecare cerere este un JSON cu întreaga rezervare, comandă sau card de fidelitate și atribuirea lor, semnat cu HMAC-SHA256, ca să puteți verifica faptul că vine de la TapTime. Orice 2xx înseamnă succes, 410 oprește reîncercările, iar fiecare eveniment are un ID după care puteți elimina duplicatele.

Adăugați un webhook

Postback-uri server-la-server pentru trackeri și afiliați

Lipiți adresa URL de postback pe care ați primit-o de la o rețea publicitară, o platformă de afiliere sau un tracker și inserați substituenții: {click_id}, {event}, {status}, {value}, {currency}, {party_size}, {booking_id}, {utm_source}, {utm_campaign}, {gclid}, {fbclid} și altele. GET sau POST. ID-ul de clic al trackerului ajunge la rezervare atunci când linkul dvs. conține click_id, clickid sau subid.

Configurați un postback

REST API pentru rezervări și evenimente

Bearer chei, numai pentru citire sau citire-scriere, 50 de solicitări pe minut per cheie. Afișați rezervările și programările filtrate după stare, sucursală, interval de date sau data ultimei actualizări („updatedSince”), preluați o rezervare, modificați o stare din propriul sistem sau interogați fluxul de evenimente ordonate cu un cursor pentru a rămâne sincronizat. Modificările de stare efectuate prin API declanșează aceleași webhook-uri și conversii ca și panoul de control.

Creați o cheie API

Tag Manager, eticheta „GA4”, pixelul „Meta” și codul personalizat de pe pagină

Pagina dvs. TapTime conține propriul dvs. ID de măsurare GA4, containerul GTM, Pixelul Meta și, exclusiv pentru proprietar, codul personalizat din antet. Când un oaspete efectuează o rezervare, pagina trimite booking_confirmed sau booking_requested către dataLayer împreună cu tipul rezervării, valoarea și ID-ul evenimentului, astfel încât orice alt instrument să poată declanșa o acțiune pe baza acestora. Widgetul de rezervare de pe propriul dvs. site web face același lucru pentru etichetele site-ului dvs.

Adăugați etichete paginii dvs.

Nu doar rezervările: contează și comenzile, și fidelizarea

Același mecanism care raportează rezervările raportează și ce se întâmplă după ce oaspetele se așază la masă. Activați fiecare obiectiv separat pentru fiecare platformă, în secțiunea „Ce se raportează” a conexiunii.

Comenzile ca achiziții

Comanda unui client de pe pagina dumneavoastră, de pe codul QR al mesei, la pachet sau cu livrare este trimisă o dată, când ajunge la dumneavoastră: o achiziție GA4 cu articolele ei, un Purchase Meta sau TikTok cu conținutul ei, un eveniment de achiziție Microsoft Ads, o încărcare către propria acțiune de conversie Google Ads. Valoarea este ce s-a comandat, fără bacșiș. Vânzările înregistrate la casă nu sunt raportate niciodată — nu le-a provocat nicio reclamă.

Înscrierile la fidelizare

Prima ștampilă a unui client într-un program este o înscriere: sign_up în GA4, CompleteRegistration în Meta și TikTok, potrivit după telefonul criptat, un eveniment de înscriere în Microsoft Ads, iar în Google Ads doar dacă a venit dintr-un clic pe reclamă. O dată per membru și program, oricâte carduri ar completa.

Fiecare eveniment, oriunde altundeva

Webhook-urile, postback-urile, alertele în chat, platformele de automatizare și REST API primesc toate cele unsprezece evenimente: o rezervare solicitată, confirmată, anulată, marcată ca neprezentare sau finalizată; o comandă plasată sau plătită; un membru nou, o ștampilă, o recompensă obținută și una folosită.

Urmărirea conversiilor pe partea de browser sau pe partea de server: de care are nevoie un restaurant sau un salon?

Ambele, iar TapTime le utilizează pe amândouă. Eticheta din browser înregistrează vizita pe platforme, iar evenimentul de pe server garantează că rezervarea este luată în calcul. Iată ce se schimbă atunci când se conectează partea de server.

Situație Pixel sau etichetă numai pe pagină TapTime pe partea de server + eticheta dvs.
Blocatoarele de reclame și setările stricte de confidențialitate ale browserului Conversia se pierde în mod silențios Trimis de pe server, indiferent de browserul oaspetelui
Oaspetele închide fila înainte ca confirmarea să se încarce Pierdut Se trimite atunci când rezervarea este salvată, nu atunci când pagina se afișează
Personalul confirmă o solicitare în așteptare a doua zi dimineață Fără încărcarea paginii, nu există conversie Trimis în momentul confirmării, indiferent de persoana care a confirmat
Rezervări telefonice și clienți fără programare Se ia în calcul dacă personalul utilizează aceeași pagină Nu se raportează niciodată; doar rezervările efectuate online de către oaspete
Atât eticheta, cât și declanșatorul de pe server Două conversii pentru o singură rezervare Un singur ID de eveniment partajat; platforma păstrează unul singur
Valoarea conversiei Indiferent de ce conține eticheta codificată static Prețul serviciului sau valoarea pe rezervare, multiplicată opțional cu numărul de persoane din grup
Care campanie primește meritul Depinde de menținerea cookie-urilor ID-ul clicului și etichetele UTM salvate la rezervare sunt reținute timp de 30 de zile

Cum împiedică TapTime ca o rezervare să fie contorizată de două ori?

Fiecare rezervare are exact un ID de eveniment de conversie — un HMAC al rezervării, pe care TapTime îl returnează paginii în răspunsul la rezervare și îl trimite de pe server. Evenimentul din browser îl poartă ca ID de tranzacție Google Ads și ca ID de eveniment pentru Meta, TikTok și eticheta UET Microsoft; evenimentul de pe server poartă aceeași valoare. Aceste patru platforme elimină duplicatele după el, iar GA4 nu primește deloc eveniment din browser cât timp integrarea de server este conectată. O rezervare confirmată, anulată și confirmată din nou trimite un al doilea webhook, pentru că sistemul dumneavoastră trebuie să știe, dar rămâne o singură conversie.

Platformă Pe partea de server Partea de browser Cheie de deduplicare
Google Ads uploadClickConversions cu ID-ul clicului gtag conversie cu send_to orderId / transaction_id
Meta Conversions APIe, evenimente din ultimele 7 zile fbq Urmăriți cu eventID event_id
TikTok Events API cu ttclid ttq.track cu event_id event_id
Microsoft Ads Conversions API, evenimente din ultimele 7 zile uetq push cu event_id event_id
GA4 Measurement Protocol cu ID-ul clientului și al sesiunii numai atunci când partea de server nu este conectată one source at a time

Cum arată un webhook de rezervare de tip „TapTime”?

O cerere POST cu corp JSON: ID-ul, tipul și ora evenimentului, dacă este un test, și întreaga rezervare (sau comandă, sau card de fidelitate), inclusiv oaspetele, ora, masa sau serviciul, starea și sursa. Patru antete o identifică și o semnează.

TapTime-Event
tipul evenimentului: booking.confirmed, order.placed, loyalty.reward_issued și încă opt
TapTime-Event-Id
ID-ul evenimentului, același la fiecare încercare, pentru deduplicare
TapTime-Delivery
ID-ul acestei încercări de livrare
TapTime-Signature
t=<timp Unix>,v1=<HMAC-SHA256ul hexazecimal al „t.body”> cu secretul dvs. whsec_
  • Răspundeți cu orice stare „2xx” în limita timpului de așteptare al cererii, iar livrarea va fi marcată ca fiind efectuată.
  • Orice alt răspuns, sau lipsa unui răspuns, este încercat din nou de până la opt ori pe parcursul unei zile, cu întârzieri din ce în ce mai mari.
  • Răspundeți cu 410 Gone, iar TapTime nu mai reîncearcă acel eveniment către acel punct final.
  • Redirecționările nu sunt urmate. Punctele finale trebuie să fie https în mediul de producție și nu pot indica adrese private sau de loopback.
  • Până la 50 de puncte finale, chaturi și conexiuni de automatizare per companie. Proprietarul poate afișa din nou sau roti secretul de semnare; rotirea îl dezactivează imediat pe cel vechi.
Citiți ghidul privind webhook-urile
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=…"
      }
    }
  }
}
Verificați semnătura (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));

Cum funcționează postback-urile server-la-server pentru conversiile rezervărilor?

Un postback este propria adresă URL a trackerului, apelată de serverul TapTime la fiecare eveniment, cu detaliile rezervării substituite în locurile rezervate. Acesta este modul în care rețelele de afiliere, platformele de CPA și trackerele de clicuri înregistrează o conversie fără a fi necesar vreun cod pe pagină. Linkul dvs. de rezervare conține ID-ul de clic al trackerului sub forma click_id, clickid sau subid; TapTime îl stochează împreună cu rezervarea și îl reintroduce în URL atunci când rezervarea este confirmată, anulată sau marcată ca neprezentare.

Citiți ghidul privind postback-ul
URL de postback cu substituenți · GET sau POST
https://tracker.example/postback
  ?cid={click_id}
  &event={event}
  &status={status}
  &payout={value}
  &cur={currency}
  &guests={party_size}
  &src={utm_source}

Locuri de rezervare disponibile

  • {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}

Alerte în chatul pe care echipa îl folosește deja — și automatizare fără cod

Alegeți ce evenimente primește un chat: o cerere nouă de rezervare de confirmat, o comandă nouă, o anulare, o recompensă obținută. Fiecare sosește în câteva secunde ca mesaj scurt, în limba aleasă de dvs., cu cine, când, câte persoane și ce sumă, plus un link înapoi în panou.

Aplicații de mesagerie

Telegram

Un bot creat cu @BotFather publică într-un grup, un canal sau un anumit subiect al unui grup. Panoul găsește chatul în locul dvs.

Slack

Un webhook de intrare publică mesaje formatate în orice canal.

Microsoft Teams

Un webhook Workflows publică un Adaptive Card cu detaliile și un buton spre panou.

Google Chat

Un webhook al spațiului publică fiecare eveniment în spațiu.

Discord

Un webhook al serverului publică un embed colorat după tipul evenimentului; mențiunile sunt mereu dezactivate.

Mattermost

Un webhook de intrare pe serverul dvs., în cloud sau găzduit de dvs.

Configurați alertele în chat

Platforme de automatizare

Zapier

Declanșatorul Catch Hook: adăugați fiecare rezervare în Google Sheets, fiecare comandă în contabilitate, fiecare membru nou în Mailchimp.

Make

Declanșatorul Custom webhook pentru scenarii cu routere, filtre și peste 2.000 de aplicații.

n8n

Nodul Webhook în n8n Cloud sau pe propriul server — datele nu trebuie să vă părăsească niciodată infrastructura.

Pipedream

Declanșatorul HTTP pentru fluxuri de lucru cu propriii pași în Node.js sau Python.

Platformele de automatizare primesc același JSON semnat ca webhook-urile. Aplicațiile create pentru ele se pot abona și dezabona prin REST API, astfel încât utilizatorii activează declanșatoarele fără să lipească vreun URL.

Conectați o platformă de automatizare

Ce poate face TapTime REST API?

Suficient pentru propriile rapoarte, pentru sincronizarea unui CRM sau a unei case de marcat ori pentru confirmarea rezervărilor din alt sistem, fără program de parteneriat și fără apel cu echipa de vânzări. Cheile se creează în secțiunea „Integrări”, sunt afișate o singură dată, stocate ca hash SHA-256 și revocate cu un singur clic.

Solicitare Rezultate
GET /v1/company Compania căreia îi aparține cheia
GET /v1/company/reservations Rezervări, filtrate după status, branchId, from, to sau updatedSince; până la 100 pe pagină
GET /v1/company/appointments Programări cu aceleași filtre
GET /v1/company/reservations/{id} O rezervare, sub forma încărcăturii webhook, cu atribuirea acesteia
POST /v1/company/reservations/{id}/status Confirmare, anulare, marcare ca neprezentare, finalizare, alocare loc sau redeschidere (acțiuni de scriere); declanșează aceleași webhook-uri și conversii
GET /v1/company/orders Comenzile, cu liniile și totalurile lor, filtrate după status, source, fulfilment, dată sau paidSince
GET /v1/company/loyalty/cards Cardurile de fidelitate ale membrilor; programele și recompensele au propriile liste
GET /v1/company/events?after={cursor} Fiecare eveniment de rezervare, comandă și fidelizare, în ordine, opțional doar anumite tipuri; interogați-l cu ultimul cursor ca să rămâneți sincronizați
POST /v1/company/webhooks Abonați un URL la evenimente și ștergeți-l cu DELETE pentru dezabonare — REST hooks pentru aplicațiile Zapier, Make, n8n și Pipedream
Rezervările confirmate modificate începând cu o anumită dată
curl "https://api.tapti.me/v1/company/reservations?status=confirmed&updatedSince=2026-09-01T00:00:00Z" \
  -H "Authorization: Bearer tt_live_…"
Rămâneți sincronizați cu fluxul de evenimente
curl "https://api.tapti.me/v1/company/events?after=eyJpZCI6OTk4fQ&limit=100" \
  -H "Authorization: Bearer tt_live_…"
Referință completă privind API-ul Citiți ghidul API

Ce date de atribuire sunt stocate pentru fiecare rezervare?

Fiecare rezervare și programare păstrează campania care a adus clientul, curățată și stocată chiar în rezervare. Aceasta este afișată în panoul de detalii al rezervării, rezumată pe tabloul de bord la secțiunea „De unde provin rezervările”, inclusă în exporturile „CSV” și „Excel” și trimisă odată cu fiecare webhook, răspuns API și conversie.

Campanie

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

ID-uri de clicuri pe anunțuri

  • gclid
  • gbraid
  • wbraid
  • fbclid
  • msclkid
  • ttclid
  • click_id / clickid / subid

Identitate Analytics

  • GA4 ID-ul clientului
  • GA4 ID-ul sesiunii pentru fiecare proprietate
  • Meta fbp cookie
  • Meta fbc (generată de la fbclid atunci când cookie-ul lipsește)

Context

  • canal: web, widget sau aplicație
  • URL-ul paginii de destinație
  • referrer
  • Adresa IP și agentul utilizatorului

Aplicația pentru clienți citește campania o singură dată, la adresa la care a fost deschisă, o păstrează timp de 30 de zile, iar o vizită ulterioară fără etichete nu o șterge. Ultima campanie are prioritate. Rezervările introduse manual de personal și comenzile înregistrate la casă nu au nicio campanie asociată, ceea ce este corect: clientul nu a ajuns prin intermediul unui link.

Citiți ghidul de atribuire

Ce se consideră o conversie și ce nu se consideră niciodată o conversie?

Se consideră o conversie

  • O rezervare sau o programare efectuată de client online, pe pagina dvs. TapTime, în widgetul de rezervare de pe propriul site sau în aplicație, odată ce aceasta a fost confirmată.
  • O solicitare în așteptare pe care personalul dvs. o va aproba ulterior. Conversia este trimisă în momentul aprobării.
  • O rezervare cu un ID de clic Google, pentru încărcările pe serverul Google Ads. Rezervările fără un astfel de ID sunt omise de Google, nu sunt niciodată considerate eșuate și sunt totuși transmise către Meta, GA4 și webhook-urile dvs.

Nu a fost niciodată luat în calcul

  • Rezervările introduse manual de personalul dvs. în urma unui apel telefonic sau a unei vizite la sediu. Acestea nu au clicuri și nu sunt asociate cu nicio campanie.
  • O a doua conversie pentru aceeași rezervare, indiferent de câte ori aceasta este redeschisă și confirmată din nou.
  • O rezervare anulată sau neprezentare. Acestea sunt transmise ca evenimente webhook și postback cu propriul statut, nu ca conversii.

Concepută pentru companiile care plătesc pentru rezervări

Dacă achiziționați clicuri care se finalizează cu o rezervare sau o programare, aceasta este jumătatea lipsă din contul dvs. publicitar.

Glosar privind urmărirea conversiilor

Termenii folosiți de platforme, într-un singur loc, împreună cu semnificația lor în contextul unei rezervări.

Conversie
O acțiune pe care ați indicat-o unei platforme publicitare să o ia în calcul și să o optimizeze. Pentru TapTime, aceasta reprezintă o rezervare sau o programare confirmată efectuată online de către client.
Urmărirea conversiilor pe partea de server
Raportarea conversiei se face de la server către API-ul platformei, în loc de la un script din browserul oaspetelui, astfel încât să nu se piardă din cauza programelor de blocare a reclamelor, a setărilor de confidențialitate sau a unei file închise.
gclid, gbraid, wbraid
Identificatorii de clicuri ai Google, adăugați la URL-ul de destinație al anunțului. gclid este varianta clasică; gbraid și wbraid sunt variantele care protejează confidențialitatea din campaniile de aplicații și campaniile web de pe iOS. Google Ads poate atribui o conversie încărcată doar unui clic pe care îl recunoaște prin unul dintre aceștia.
fbclid, fbp, fbc
Meta
Google Ads conversie prin clic încărcare
Metoda API „Google Ads” (uploadClickConversions) pe care un server o utilizează pentru a raporta o conversie pentru un clic specific, împreună cu ID-ul clicului, ora, valoarea și un ID de comandă utilizat pentru deduplicare.
ttclid, msclkid
Identificatorii de clic ai TikTok și Microsoft, adăugați la adresa de destinație a reclamei prin etichetare automată. TikTok Events API și Microsoft Conversions API îi folosesc pentru a atribui o rezervare clicului pe reclamă care a adus-o.
Meta Conversions API (CAPI)
Meta
GA4 Measurement Protocol
Punctul final HTTP al Google Analytics 4 pentru evenimente de server. Un eveniment se alătură sesiunii vizitatorului atunci când conține ID-ul clientului și ID-ul sesiunii din cookie-urile GA, iar sesiunea are o vechime mai mică de aproximativ 72 de ore.
Eveniment cheie
GA4
Eliminarea duplicatelor de evenimente
Trimiteți un singur identificator comun atât cu evenimentul din browser, cât și cu cel de pe server, astfel încât o platformă care le primește pe amândouă să înregistreze o singură conversie.
Parametrii UTM
utm_source, utm_medium, utm_campaign, utm_term și utm_content: etichete pe care le adăugați la propriile linkuri, astfel încât rezervarea să rețină postarea, newsletter-ul, fluturașul sau partenerul care a adus clientul.
Webhook
O cerere HTTP pe care TapTime o trimite către o adresă URL deținută de dvs. ori de câte ori se întâmplă ceva, cu detalii complete în JSON și o semnătură pentru verificarea acesteia.
Postback (pixel server-la-server)
O adresă URL furnizată de o rețea publicitară sau de un tracker, pe care serverul advertiserului o accesează la fiecare conversie, cu ID-ul clicului din tracker și suma plății completate în locurile rezervate.
HMAC-SHA256 semnătură
Un hash cu cheie al corpului cererii și o marcă temporală, calculat cu ajutorul unei chei secrete comune. Recalcularea acestuia pe partea ta dovedește că cererea a provenit de la TapTime și nu a fost modificată.
Livrare „cel puțin o dată”
Garanția că fiecare eveniment este transmis, cu riscul ca o încercare repetată să ducă la transmiterea acestuia de două ori. De aceea, fiecare eveniment TapTime conține un ID care permite ignorarea duplicatelor.
Conversie offline
O conversie care are loc în afara sesiunii browserului, cum ar fi confirmarea unei solicitări de către personal a doua zi. TapTime o trimite în momentul confirmării, împreună cu ID-ul original al clicului.

Inclus. Nu este un supliment și nici un nivel superior.

Urmărirea conversiilor, webhook-urile, postback-urile, alertele în chat, automatizarea și REST API sunt incluse în fiecare modul: evenimentele de rezervare vin cu „Rezervări la masă”, de la 390 MDL pe lună per locație, și cu „Programări”, de la 390 MDL pe lună per locație, evenimentele de comandă cu „Meniu QR”, iar cele de fidelizare cu „Fidelizare”. Nu există nicio taxă per eveniment și nicio limită de utilizare pentru livrări.

Fiecare modul are propria perioadă de probă gratuită de 14 zile, fără necesitatea introducerii datelor cardului de credit pentru a începe, facturare lunară, fără contract. Dacă încetați plata, modulul este suspendat după o scurtă perioadă de grație; nimic nu este șters.

Întrebări adresate de managerii de publicitate și dezvoltatori

TapTime trimite datele privind conversiile de pe server sau din browserul oaspetelui?

Ambele. Serverul trimite conversia în momentul confirmării rezervării, prin intermediul API-ului Google Ads, al Meta Conversions API și al GA4 Measurement Protocol. Eticheta sau pixelul din browserul dvs. se poate declanșa, de asemenea; acesta conține același ID de eveniment, astfel încât platformele înregistrează o singură conversie.

Am nevoie de un cont Google Tag Manager pentru a urmări conversiile rezervărilor?

Nu. TapTime comunică direct de pe server cu Google Ads, Meta și GA4. Tag Manager este util doar dacă doriți să declanșați alte instrumente din evenimentul „booking_confirmed” pe care pagina îl trimite către dataLayer.

De ce am nevoie de la Google Ads pentru a activa încărcările pe partea de server?

O acțiune de conversie, ID-ul dvs. de client, ID-ul acțiunii de conversie (numărul care urmează după „ctId=” în adresa acțiunii) și accesul la API: un token de dezvoltator, un ID și o cheie secretă de client OAuth, precum și un token de reîmprospătare. Agenția sau dezvoltatorul dvs. le poate emite. Fără acces la API, puteți utiliza în continuare eticheta de browser.

De ce apare la o livrare mesajul „Niciun clic pe un anunț Google pentru această rezervare”?

Oaspetele nu a ajuns prin intermediul unui anunț Google, astfel încât linkul de rezervare nu conținea gclid, gbraid sau wbraid. Google acceptă doar conversiile încărcate pentru clicurile pe care le recunoaște, astfel încât rezervarea este omisă pentru Google Ads, în loc să fie încercată din nou. Totuși, aceasta este redirecționată către Meta, GA4 și webhook-urile dvs.

Cum face Meta Conversions API corelarea unei rezervări cu un anunț?

Cu ajutorul codului „fbclid” din link, cookie-urile de browser „Meta” (fbp și fbc), adresa IP și browserul oaspetelui și, cu excepția cazului în care dezactivați opțiunea „Send hashed email and phone”, adresa de e-mail și numărul de telefon ale oaspetelui, hashate cu SHA-256 înainte ca acesta să părăsească TapTime.

Cum raportează TapTime rezervările către TikTok?

Prin TikTok Events API, de pe server, în momentul în care rezervarea este confirmată. TapTime pune și TikTok Pixel pe pagina de rezervare, așa că nu trebuie să îl adăugați acolo. Ambele evenimente poartă același ID de eveniment, iar TikTok păstrează unul singur. Potrivirea folosește ttclid din link, adresa IP și browserul clientului și, dacă nu dezactivați opțiunea, e-mailul și telefonul acestuia criptate cu SHA-256.

De ce am nevoie ca să urmăresc conversiile în Microsoft Ads (Bing)?

ID-ul etichetei UET este suficient pentru început: TapTime pune eticheta pe pagina dumneavoastră de rezervări și declanșează acțiunea de eveniment când un client rezervă. Adăugați tokenul Conversions API din setările etichetei și serverul raportează și rezervările confirmate după plecarea clientului, comenzile clienților și noii membri de fidelitate. Microsoft activează Conversions API cont cu cont și acceptă doar evenimente din ultimele 7 zile.

Ce valoare de conversie este transmisă?

Pentru programări, prețul serviciului. Pentru rezervările de mese, valoarea pe rezervare pe care o setați, o cheltuială medie, înmulțită opțional cu numărul de persoane din grup. Dacă lăsați câmpul gol, conversiile sunt trimise fără o valoare.

Rezervările introduse manual de personalul meu vor fi considerate conversii din reclame?

Nu. Doar rezervările efectuate online de către clienți sunt raportate ca conversii. Rezervările telefonice și cele fără programare introduse de personal nu umflă niciodată rezultatele publicitare. Acestea apar totuși în exporturi și pe tabloul de bord.

Ce se întâmplă când o rezervare este confirmată, anulată și confirmată din nou?

Webhook-urile și postback-urile dvs. primesc fiecare modificare, fiecare cu propriul ID de eveniment și statut, deoarece sistemul dvs. trebuie să fie la curent. Google Ads, Meta și GA4 primesc o singură conversie per rezervare, întotdeauna.

Cum pot verifica dacă un webhook provine într-adevăr de la TapTime?

Citiți antetul „TapTime-Signature”, care are forma t=1726128000,v1=<hex>. Calculați valoarea „HMAC-SHA256” pentru șirul „t.body” folosind cheia secretă de semnare și comparați-o cu „v1” folosind o comparație în timp constant. Respingeți solicitarea dacă valoarea este diferită sau dacă „t” este mai vechi decât considerați acceptabil.

Un webhook poate fi direcționat către Zapier, Make sau n8n?

Da. Creați un „catch” sau un webhook personalizat în instrument, lipiți adresa acestuia ca punct final și apăsați „Trimite test” pentru ca instrumentul să învețe câmpurile. Detaliile oaspetelui, ora, starea și atribuirea rezervării se află toate în JSON.

Cât timp este reținută o campanie înainte de efectuarea rezervării?

30 de zile pe dispozitivul oaspetelui. Un oaspete poate deschide meniul dvs. dintr-un anunț de tip „Instagram” luni și poate face o rezervare joi; rezervarea va fi în continuare asociată acelei campanii. O vizită ulterioară fără etichete nu o șterge, iar o vizită ulterioară cu o campanie diferită o înlocuiește.

Widgetul de rezervare de pe propriul meu site web urmărește și el conversiile?

Da. Scriptul de încorporare citește etichetele UTM ale site-ului dvs., ID-urile de clicuri și cookie-urile GA și Meta și le transmite către sistemul de rezervări, astfel încât o rezervare efectuată prin widget să fie atribuită anunțului care a adus vizitatorul pe site-ul dvs. De asemenea, acesta trimite taptime_booking_confirmed către dataLayer al site-ului dvs. și poate declanșa propriile etichete GA4 și Meta ale paginii dvs.

Există o limită de frecvență sau un cost per apel API sau per webhook?

Cheile API sunt limitate la 50 de solicitări pe minut fiecare, iar o companie poate deține până la 10 chei active și 20 de puncte finale de tip webhook sau postback. Nu se percepe nicio taxă pe apel, pe eveniment sau pe conversie; totul este inclus în abonamentele pentru rezervări și programări.

Ce se întâmplă dacă nu mai plătesc pentru modul?

După o scurtă perioadă de grație, modulul este suspendat, iar pagina de rezervări afișează un mesaj care indică indisponibilitatea temporară a serviciului. Nu se șterge nimic, inclusiv integrările; efectuați din nou plata, iar livrările vor fi reluate pentru noile rezervări.

Există vreun abonament separat pentru aceste servicii?

Nu. Google Ads, conversiile Meta și GA4, webhook-urile, postback-urile și API-ul REST fac parte din modulul „Rezervări la masă” începând de la 390 MDL pe lună și din modulul „Programări” începând de la 390 MDL pe lună, per locație, cu o perioadă de probă gratuită de 14 zile și fără a fi necesară o carte de credit pentru a începe.

Poate TapTime să raporteze comenzile și înscrierile la fidelizare drept conversii?

Da. În secțiunea „Ce se raportează” a fiecărei conexiuni, activați comenzile oaspeților (trimise ca achiziție, cu valoarea și produsele: purchase în GA4, Purchase în Meta sau o a doua acțiune de conversie în Google Ads) și membrii noi ai programului de fidelizare (sign_up în GA4, CompleteRegistration în Meta). Fiecare este trimis o singură dată pentru fiecare comandă, respectiv o singură dată pentru fiecare membru și program. Vânzările înregistrate la casă nu sunt raportate niciodată.

Cum primesc rezervările și comenzile noi în Telegram sau Slack?

Deschideți Integrări → Notificări, alegeți aplicația de mesagerie, lipiți tokenul botului (Telegram) sau URL-ul webhook-ului (Slack, Teams, Google Chat, Discord, Mattermost), alegeți evenimentele și limba și apăsați „Trimite un test”. De atunci, fiecare eveniment ales sosește ca mesaj scurt, cu un link spre panou. Adresa și tokenul sunt stocate criptat.

Funcționează TapTime cu Zapier, Make, n8n și Pipedream?

Da, fără niciun plugin de instalat. Creați un catch hook în platformă, lipiți URL-ul lui în Integrări → Automatizare, alegeți evenimentele și apăsați „Trimite un test”, ca platforma să învețe câmpurile. De atunci, fiecare eveniment de rezervare, comandă și fidelizare vă pornește fluxul, semnat la fel ca webhook-urile noastre. Aplicațiile se pot abona și singure, prin POST /v1/company/webhooks.

Oferiți anunțurilor dvs. singurul semnal care contează: rezervarea.

Conectați Google Ads, Meta, TikTok, Microsoft Ads și GA4 în zece minute, adăugați un webhook pentru CRM și urmăriți cum se completează jurnalul de livrări. Gratuit timp de 14 zile, fără card de credit, se poate anula oricând.

14 zile gratuit Fără card necesar Anulați oricând

Urmăriți rezervările ca conversii Începeți gratuit timp de 14 zile