Įdiegus Facebook CAPI (Conversions API), „Meta“ apie pirkimus, užklausas ir kitus svarbius veiksmus sužino dviem keliais: per pikselį lankytojo naršyklėje ir tiesiai iš jūsų serverio. Prijungti CAPI galima per vieną dieną. Rezultatą vis dėlto lemia ne pats prijungimas, o smulkmenos: abiejuose kanaluose vienodi įvykių pavadinimai ir ID, tvarkingai perduodami kliento duomenys, sutikimų valdymas ir patikra prieš paleidžiant. Jei vieną šių dalių sutvarko svetainės kūrėjas, o kitą reklamos specialistas, klaidos lieka tarp jų, ir reklamos algoritmas mokosi iš iškreiptų skaičių. Todėl CAPI verta diegti kaip reklamos sistemos dalį, o ne kaip dar vieną įskiepį. „Market Smart“ Facebook reklamos valdymą, techninį svetainių optimizavimą ir nuolatinę analizę su ataskaitomis siūlo kaip vieną paslaugų rinkinį.
Trumpai
- CAPI papildo pikselį, o ne jį pakeičia. Įvykius verta siųsti iš naršyklės ir iš serverio vienu metu.
- Svarbiausia vieta yra deduplikacija. Tas pats įvykis abiejuose kanaluose turi turėti vienodą pavadinimą ir vienodą ID, kitaip vienas pardavimas ataskaitose virsta dviem.
- Diegimo būdą lemia jūsų svetainė: platformos integracija, CAPI Gateway, serverio pusės Google Tag Manager arba tiesioginė API integracija.
- Prieš paleisdami išbandykite. „Meta“ įvykių tvarkyklėje (Events Manager) esantis „Test Events“ įrankis parodo, ar įvykiai ateina ir ar dublikatai pašalinami.
- Sutikimai galioja ir serverio įvykiams. ES taisyklės nesiskiria pagal tai, kuriuo kanalu duomenys keliauja.
Turinys
- Kas yra Conversions API ir kuo ji skiriasi nuo pikselio
- Ką paruošti prieš diegimą
- Diegimo būdai: kurį pasirinkti
- CAPI diegimas žingsnis po žingsnio
- Deduplikacija: vieta, kur slypi dažniausia klaida
- Pardavimai, kurie vyksta ne svetainėje
- Sutikimai ir privatumas: ką reikia žinoti Lietuvoje
- Mūsų požiūris
- Kaip CAPI diegimą perima „Market Smart“
- Dažniausi klausimai
- Šaltiniai
Kas yra Conversions API ir kuo ji skiriasi nuo pikselio
Facebook pikselis, dabar vadinamas „Meta“ pikseliu, yra „JavaScript“ kodas, kuris veikia lankytojo naršyklėje. Jis fiksuoja veiksmus: puslapio ar prekės peržiūrą, įdėjimą į krepšelį, pirkimą. Bėda ta, kad pikselis priklauso nuo naršyklės. Reklamų blokatoriai, naršyklių privatumo apribojimai ar nestabilus mobilusis ryšys gali sutrukdyti įvykiui pasiekti „Meta“.
Conversions API tą pačią informaciją siunčia iš jūsų serverio. Užklausa keliauja tiesiai į „Meta“ adresu graph.facebook.com/{pikselio ID}/events. Tokie serverio įvykiai susiejami su pikseliu ir apdorojami kaip naršyklės įvykiai: jie naudojami matavimui, ataskaitoms ir kampanijų optimizavimui. Paieškoje dažnai sutinkamas „server side tracking“ terminas reiškia tą pačią idėją: duomenys apie konversijas keliauja serverio kanalu, o ne vien naršykle.
| Pikselis (naršyklė) | Conversions API (serveris) | |
|---|---|---|
| Kur veikia | Lankytojo naršyklėje | Jūsų serveryje ar debesų aplinkoje |
| Kas gali sutrukdyti | Blokatoriai, naršyklės apribojimai, ryšys | Klaidinga konfigūracija, pasibaigęs prieigos raktas |
| Kokius veiksmus mato | Tik tai, kas vyksta svetainėje | Svetainės veiksmus ir pardavimus iš kitų sistemų |
| Diegimas | Kodas ar įskiepis svetainėje | Integracija, Gateway, serverio GTM ar programavimas |
| Geriausias rezultatas | Kartu su CAPI | Kartu su pikseliu |
Iš lentelės aiškiai matyti, kad abu kanalai vienas kitą papildo. „Meta“ dokumentacijoje rekomenduojama siųsti tuos pačius įvykius per pikselį ir per Conversions API, su vienodu įvykio pavadinimu ir ID. Taip pirkimas, kurio naršyklė nepranešė, vis tiek pasiekia sistemą, o pirkimas, apie kurį pranešė abu kanalai, suskaičiuojamas vieną kartą.
Ką paruošti prieš diegimą
Diegimas dažniausiai užstringa ne ties kodu, o ties prieigomis. Prieš pradėdami pasirūpinkite šiais dalykais:
- Administratoriaus teisės „Meta“ verslo paskyroje (Business Manager). Su reklamuotojo ar analitiko teisėmis prieigos rakto nesugeneruosite.
- Pikselis arba duomenų rinkinys (dataset), priklausantis jūsų verslui. Kai duomenų rinkinys susietas su pikseliu, jų ID sutampa, todėl naršyklės ir serverio įvykiai keliauja į tą pačią vietą.
- Prieigos raktas (access token). Tai slaptažodis, kuriuo serveris prisistato „Meta“. Jis generuojamas įvykių tvarkyklėje ir naudojamas integracijos nustatymuose. Raktas laikomas tik serveryje, niekada svetainės kode ar naršyklėje.
- Įvykių sąrašas. Užsirašykite, kurie veiksmai jums svarbūs: el. parduotuvei tai dažniausiai
ViewContent,AddToCart,InitiateCheckoutirPurchase, paslaugų įmoneiLeadarContact. - Prieiga prie svetainės ir serverio. Reikės TVS (turinio valdymo sistemos) administratoriaus teisių, o renkantis serverio sprendimą ir prieigos prie talpinimo ar debesų paskyros.
- Slapukų sutikimų sprendimas. Jis turi valdyti ir pikselį, ir serverio įvykius (daugiau apie tai skyriuje apie privatumą).
Diegimo būdai: kurį pasirinkti
Tinkamą būdą lemia trys dalykai: kokia platforma sukurta jūsų svetainė, kiek įvykių siunčiate ir ar dalis pardavimų vyksta ne svetainėje.
Platformos integracija
Populiarios el. prekybos platformos ir TVS, tarp jų WordPress su WooCommerce, turi „Meta“ integracijas arba įskiepius. Jie įjungia pikselį ir serverio įvykius iš karto. Tai greičiausias kelias standartinei el. parduotuvei. Dažniausios klaidos čia būna dvi: šalia integracijos paliekamas senas, ranka įklijuotas pikselio kodas (tada įvykiai dubliuojasi naršyklėje), o sutikimų juosta nesusiejama su įskiepiu.
Conversions API Gateway
Tai „Meta“ sprendimas, kuris veikia jūsų debesų paskyroje. Jis gauna pikselio įvykius ir jų kopijas siunčia serverio kanalu. Programuoti nereikia, tačiau reikia debesų paslaugų tiekėjo paskyros ir priežiūros. „Meta“ dokumentacijoje nurodoma, kad siunčiant įvykius į Gateway reikia perduoti įvykio ID, kad būtų išvengta dublikatų.
Serverio pusės Google Tag Manager
Tinka, kai svetainėje jau naudojamas Google Tag Manager ir GA4. Naršyklė įvykį perduoda į jūsų serverio konteinerį, o jis siunčia jį į „Meta“. „Meta“ vadove aprašyta, kaip tą patį įvykio ID perduoti pikseliui ir serverio žymai per bendrą trigerį. Šis būdas suteikia daugiausia kontrolės, bet reikalauja daugiausia techninių žinių.
Tiesioginė API integracija
Svetainės ar CRM sistema pati siunčia užklausas į Conversions API. Ją renkasi, kai svetainė individuali, kai reikia perduoti pardavimus iš kitų sistemų arba kai užsakymai patvirtinami vėliau, pavyzdžiui, po apmokėjimo banko pavedimu.
| Būdas | Kam tinka | Ko reikia | Kur dažniausiai klystama |
|---|---|---|---|
| Platformos integracija | Standartinė el. parduotuvė | TVS administratoriaus teisių | Dvigubas pikselis, nesusieti sutikimai |
| CAPI Gateway | Svetainės be programuotojo | Debesų paskyros | Nepriežiūra, nesekamos išlaidos |
| Serverio GTM | Svetainės su GTM ir GA4 | Serverio konteinerio | Skirtingi įvykių ID naršyklėje ir serveryje |
| Tiesioginė API | Individualios sistemos, CRM | Programavimo | Neužkoduoti duomenys, vėluojantys įvykiai |
CAPI diegimas žingsnis po žingsnio
1. Sutvarkykite pikselį
CAPI remiasi pikseliu, todėl pirmiausia patikrinkite, ar pikselis įdiegtas vieną kartą ir ar jis siunčia standartinius įvykius tinkamuose puslapiuose. Pirkimo įvykis turi suveikti padėkos puslapyje, o ne kiekvieną kartą perkrovus krepšelį. Jei pikselis siunčia klaidingus duomenis, CAPI tas klaidas tik padvigubins.
2. Sugeneruokite prieigos raktą ir prijunkite integraciją
Įvykių tvarkyklėje pasirinkite pikselį, sugeneruokite prieigos raktą ir prijunkite pasirinktą integraciją. Platformos įskiepis raktą dažnai gauna automatiškai, o serverio GTM ir tiesioginei integracijai jį reikia įvesti ranka.
3. Sukonfigūruokite serverio įvykius
Kiekvienas serverio įvykis yra duomenų paketas. Pagal „Meta“ užklausos pavyzdį jame būna:
event_name: įvykio pavadinimas, pvz.,Purchase;event_time: veiksmo laikas Unix sekundėmis (veiksmo, o ne siuntimo);event_id: unikalus įvykio ID deduplikacijai;action_source: iš kur atėjo įvykis, svetainės įvykiamswebsite;event_source_url: puslapio adresas;user_data: IP adresas, naršyklės identifikatorius (user agent),fbpirfbcslapukų reikšmės, el. paštas ir telefonas;custom_data: vertė, valiuta, prekių ID.
„Meta“ pavyzdyje el. paštas ir telefonas perduodami ne atviru tekstu, o SHA-256 maišos (hash) reikšmėmis: prieš tai el. paštas užrašomas mažosiomis raidėmis be tarpų, telefonas su šalies kodu be tarpų. IP adresas, naršyklės identifikatorius ir fbp/fbc reikšmės siunčiamos neužkoduotos.
4. Įjunkite deduplikaciją
Tai svarbiausias žingsnis, jį aptariame atskirame skyriuje žemiau.
5. Išbandykite su „Test Events“
Įvykių tvarkyklėje atidarykite Data Sources, pasirinkite pikselį, tada Test Events. Įrankis sugeneruoja testinį kodą, kurį perduodate parametru test_event_code, ir serverio įvykiai pradeda rodytis testavimo lange. Atlikite tikrą bandomąjį užsakymą ar užklausą. Turėtumėte matyti tą patį įvykį iš naršyklės ir iš serverio, pažymėtą kaip deduplikuotą. Baigę testą, testinį kodą iš gamybinių užklausų pašalinkite.
6. Stebėkite po paleidimo
Pirmąsias dvi savaites kasdien peržiūrėkite skiltį Diagnostics ir kiekvieno įvykio detales. „Meta“ duomenų kokybės įrankiuose matomi keli rodikliai: įvykių atitikties kokybė, įvykių aprėptis, deduplikacija ir duomenų šviežumas. Įvykių atitikties kokybė (Event Match Quality, EMQ) parodo, kaip gerai jūsų siunčiami kliento duomenys leidžia įvykį susieti su „Meta“ paskyra. Aprėptis parodo, kokia dalis pikselio įvykių turi atitikmenį serverio kanale su bendru deduplikacijos raktu. Aukštą EMQ dažniausiai lemia el. paštas ir telefonas, užfiksuoti užsakymo ar formos metu.
Deduplikacija: vieta, kur slypi dažniausia klaida
„Meta“ tą patį įvykį atpažįsta pagal dvi reikšmes. Pikselio eventID turi sutapti su serverio event_id, o pikselio įvykio pavadinimas su serverio event_name. Jei tokia pora tam pačiam pikseliui atkeliauja per 48 valandas, vėlesni įvykiai atmetami. Pikselyje ID perduodamas kaip ketvirtasis fbq('track', ...) argumentas. Jei įvykiai turiniu nesiskiria, paprastai paliekamas tas, kuris atėjo pirmas.
Praktiškai tai reiškia tris taisykles:
- ID kuriamas vieną kartą. Pirkimui patogiausia naudoti užsakymo numerį, kitiems įvykiams unikalų atsitiktinį ID, kurį gauna ir pikselis, ir serveris.
- Pavadinimai sutampa iki raidės.
Purchaseirpurchasesistemai yra skirtingi įvykiai. - Serverio įvykiai siunčiami iš karto. Jei pirkimas iš serverio išsiunčiamas po trijų dienų, 48 valandų langas jau būna pasibaigęs ir įvykis suskaičiuojamas iš naujo.
Pavyzdys. Per mėnesį reklamai išleidžiate 500 €, o reklama atneša 1 500 € pardavimų, taigi reklamos grąža (ROAS) yra 3. Jei deduplikacija neveikia, kiekvienas pirkimas ataskaitose rodomas du kartus: matote 3 000 € ir ROAS 6. Tokiu atveju didinate biudžetą kampanijoms, kurios iš tikrųjų uždirba perpus mažiau, o algoritmas optimizuoja pagal netikrus signalus. Šią klaidą matome tik palygindami „Meta“ ataskaitą su tikrais užsakymais el. parduotuvėje, todėl tokį palyginimą verta įtraukti į kiekvieną mėnesio ataskaitą.
Pardavimai, kurie vyksta ne svetainėje
Pikselis mato tik svetainę. Daugelis Lietuvos MVĮ ir gamybos įmonių didelę dalį užsakymų gauna telefonu, el. paštu ar per vadybininką, o sandorį uždaro CRM sistemoje. Conversions API leidžia šiuos pardavimus perduoti „Meta“ kaip įvykius, o parametras action_source nurodo, iš kur atėjo įvykis. Taip reklama optimizuojama pagal tikrus sandorius, o ne vien pagal užpildytas formas.
Kad tokie duomenys būtų naudingi, juos reikia užfiksuoti nuosekliai: kiekviena užklausa turi turėti kontaktą, laiką ir būseną. Pavyzdžiui, jei skambučius priima dirbtinio intelekto balso administratorius, kuris teikia kasdienes skambučių suvestines, šie įrašai tampa aiškiu šaltiniu, iš kurio į CRM ir toliau į Conversions API galima perkelti tik kokybiškus potencialius klientus. Svarbu, kad toks įvykis turėtų el. paštą ar telefoną, nes būtent jie leidžia susieti pardavimą su reklama.
Sutikimai ir privatumas: ką reikia žinoti Lietuvoje
Serverio kanalas nepanaikina reikalavimo gauti sutikimą. Pagal Bendrąjį duomenų apsaugos reglamentą sutikimas turi būti laisvas, konkretus, informuotas ir nedviprasmiškas. Tyla, iš anksto pažymėti langeliai ar neveikimas sutikimu nelaikomi, o įmonė turi galėti įrodyti, kad sutikimą gavo. Lietuvoje taip pat galioja Asmens duomenų teisinės apsaugos įstatymas. Jo pakeitimai įsigaliojo 2024 m. liepos 1 d., o viena jų dalis nuo 2025 m. sausio 1 d.
Diegiant CAPI tai reiškia:
- sutikimų juosta turi valdyti ir pikselį, ir serverio įvykius: jei lankytojas reklaminių slapukų atsisakė, serveris jo įvykio su asmens duomenimis nesiunčia;
- siunčiate tik tuos duomenis, kurių reikia kampanijoms optimizuoti ir auditorijoms kurti;
- kontaktiniai duomenys užkoduojami prieš siunčiant, o prieigos raktas laikomas tik serveryje;
- privatumo politikoje įvardijate „Meta“ kaip duomenų gavėją.
Šį principą gerai apibūdina duomenų apsauga nuo projektavimo: privatumas planuojamas dar prieš paleidžiant sistemą, o ne taisomas vėliau. Privatumo politikos ir sutikimų tekstų teisinę formuluotę aptarkite su savo įmonės duomenų apsaugos pareigūnu ar teisininku.
Mūsų požiūris
CAPI diegimą vertiname ne kaip techninę užduotį, o kaip reklamos biudžeto apsaugą. „Meta“ algoritmas optimizuoja pagal tai, ką jam siunčiate. Jei įvykiai dingsta naršyklėje arba skaičiuojami du kartus, kampanijos mokosi iš klaidingų duomenų, o įmonė priima sprendimus pagal netikrą grąžą.
Todėl CAPI diegimą siejame su visa grandine: svetainės technine būkle, įvykių struktūra, reklamos strategija ir ataskaitomis. Mūsų darbo pagrindas yra išsami analizė, aiškūs veiksmai ir išmatuojami rezultatai, o nuolatinės ataskaitos ir priežiūra padeda pastebėti, kada po svetainės atnaujinimo ar naujo įskiepio įvykiai nustoja ateiti.
Daugeliui įmonių didžiausią naudą duoda ne pats CAPI įjungimas, o tai, kas vyksta po jo: struktūra, kurioje kampanijų tikslai, įvykiai ir ataskaitos kalba ta pačia kalba. Kaip kampanijų tikslus ir struktūrą derinti su konversijų įvykiais, aprašėme Facebook reklamos strategijos gide.
Market smart
Kaip CAPI diegimą perima „Market Smart“
„Market Smart“ teikia Facebook reklamos paslaugas, techninį svetainių optimizavimą ir nuolatinę analizę su ataskaitomis. Turime Google Partnerio statusą, o reklamas kuria sertifikuoti META reklamų specialistai. Tad diegdami sekimą, valdydami reklamą ir rengdami mėnesio ataskaitą žiūrime į tuos pačius skaičius.
Techninę dalį galite užsakyti ir atskirai: techninis optimizavimas kainuoja 100 €, būtinų ir rekomenduojamų įskiepių diegimas ir konfigūravimas 75 €, o el. parduotuvėms skirtas e. komercijos diegimas ir konfigūravimas 100 €. Jei planuojate reklamos biudžetą, peržiūrėkite ir Facebook reklamos kainas Lietuvoje.
Dažniausi klausimai
Ar įdiegus CAPI galima išjungti Facebook pikselį?
Ne, geriausias rezultatas pasiekiamas naudojant abu kanalus kartu. Pikselis fiksuoja naršyklėje vykstančius veiksmus realiu laiku, o CAPI užtikrina, kad svarbūs įvykiai pasiektų „Meta“ net tada, kai naršyklė jų neperduoda. Svarbu tik įjungti deduplikaciją, kad tas pats įvykis nebūtų suskaičiuotas du kartus.
Kiek laiko trunka CAPI diegimas?
Standartinei el. parduotuvei su platformos integracija dažniausiai užtenka vienos darbo dienos, įskaitant testavimą. Serverio GTM ar tiesioginė integracija su CRM užtrunka ilgiau, nes reikia suderinti įvykių ID, kliento duomenis ir sutikimų logiką. Po paleidimo verta skirti dar dvi savaites stebėjimui.
Kaip suprasti, ar CAPI veikia teisingai?
Įvykių tvarkyklėje atlikite bandomąjį užsakymą per „Test Events“ ir patikrinkite, ar įvykis ateina iš naršyklės ir iš serverio bei ar pažymėtas kaip deduplikuotas. Vėliau stebėkite Diagnostics skiltį, įvykių atitikties kokybę ir aprėptį. Galiausiai palyginkite „Meta“ ataskaitos pirkimus su tikrais užsakymais savo sistemoje.
Ar CAPI padeda apeiti slapukų sutikimą?
Ne. ES duomenų apsaugos taisyklės taikomos nepriklausomai nuo to, ar duomenys siunčiami iš naršyklės, ar iš serverio. Jei lankytojas reklaminių slapukų atsisakė, jo asmens duomenų su įvykiais nesiunčiate. CAPI padeda perduoti tuos įvykius, kuriuos turite teisę perduoti, bet kurių naršyklė dėl techninių priežasčių neperdavė.
Šaltiniai
Meta for Developers: Get started with the Conversions APIMeta for Developers: Using the API, Conversions APIMeta for Developers: Handling Duplicate Pixel and Conversions API EventsMeta for Developers: Conversions API for Server-Side Google Tag ManagerMeta for Developers: Dataset Quality APIFacebook Server-Side API specifikacija (GitHub)Reglamentas (ES) 2016/679, Bendrasis duomenų apsaugos reglamentasXIV-2626 Lietuvos Respublikos asmens duomenų teisinės apsaugos įstatymo pakeitimas



