És una queixa habitual: la botiga registra cent comandes en una setmana i l'Administrador d'esdeveniments de Meta en mostra força menys. El píxel està instal·lat i, tot i així, falten conversions. Les campanyes optimitzen amb aquesta dada incompleta.
L'API de conversions de Meta (Conversions API o CAPI) existeix per tancar aquesta bretxa. Expliquem què és, com es configura sense comptar dues vegades cada venda i què revisar quan les compres no apareixen.
En resum
- El píxel envia esdeveniments des del navegador; l'API de conversions els envia des d'un servidor. Meta recomana fer servir tots dos alhora.
- El píxel perd esdeveniments per bloquejadors, límits de cookies del navegador, consentiment rebutjat o pàgines que es tanquen abans d'hora.
- Si envies el mateix esdeveniment per les dues vies, cal deduplicar-lo amb el mateix
event_namei el mateixevent_id. - Com més dades de client enviïs, xifrades amb SHA-256, millor és la qualitat de coincidència.
- L'API no substitueix el consentiment: només pots enviar dades d'usuaris que l'hagin donat.
Què és l'API de conversions de Meta
És una connexió directa entre el teu servidor, el teu CRM o el teu e-commerce i Meta. En lloc de dependre d'un script al navegador, el teu sistema envia cada esdeveniment (una compra, un lead, un registre) amb el seu nom, hora, valor, moneda i informació del client. Meta el fa servir igual que un esdeveniment del píxel: per atribuir, optimitzar el lliurament i construir audiències.
Per què el píxel perd esdeveniments
El píxel només funciona si el navegador carrega l'script, desa les seves cookies i arriba a enviar la petició. Qualsevol d'aquests passos pot fallar:
- Bloquejadors d'anuncis i de rastreig. Moltes extensions i alguns navegadors bloquegen l'script de Meta.
- Límits de cookies. Safari, amb la seva protecció ITP, i Firefox escurcen la vida de les cookies creades des de JavaScript. Si l'usuari compra dies després del clic, és possible que el navegador ja hagi oblidat d'on venia.
- App Tracking Transparency a iOS. Els usuaris d'iPhone que rebutgen el seguiment entre apps redueixen la informació que Meta pot fer servir per relacionar anunci i compra.
- Consentiment rebutjat. Si l'usuari rebutja les cookies de publicitat, el píxel no s'ha de disparar. És el correcte, i aquests esdeveniments no han d'arribar per cap via.
- Pàgines que es tanquen abans d'hora. Si l'usuari paga en una passarel·la externa i no torna a la pàgina de confirmació, la compra no s'envia mai.
L'API resol les fallades tècniques, perquè l'esdeveniment surt del teu servidor quan es registra la comanda. El consentiment no el resol, ni l'ha de resoldre.
Píxel i API alhora: com deduplicar
Meta recomana una configuració redundant: el píxel envia els esdeveniments des del navegador i l'API, els mateixos des del servidor. Si un falla, arriba l'altre. Si arriben tots dos, Meta comptaria la compra dues vegades.
Per evitar-ho, cada esdeveniment ha de portar el mateix event_name (per exemple, Purchase) i el mateix event_id a les dues vies. L'event_id el generes tu, per exemple el número de comanda. Si Meta rep dos esdeveniments amb el mateix nom i identificador en poc temps, se'n queda un.
A més, convé enviar per l'API les cookies del píxel, _fbp (identificador del navegador) i _fbc (identificador del clic, derivat del fbclid de l'URL). No substitueixen l'event_id, però ajuden a relacionar l'esdeveniment amb la visita i el clic.
Dades de client i qualitat de coincidència
Un esdeveniment del servidor no porta la sessió del navegador, així que Meta necessita saber qui va comprar per una altra via: els paràmetres d'informació del client, email, telèfon, nom, cognoms, ciutat, codi postal, país o un identificador extern com el teu ID de client. Es normalitzen (minúscules, sense espais, telèfon amb prefix) i es xifren amb SHA-256. La IP i l'agent d'usuari s'envien sense xifrar.
A l'Administrador d'esdeveniments, cada esdeveniment té una puntuació de qualitat de coincidència (Event Match Quality), de 0 a 10, que indica com de bé relaciona Meta els teus esdeveniments amb els seus usuaris. Si és baixa, sol faltar algun paràmetre o estar mal normalitzat. L'email i el telèfon són els que més pesen.
Quatre maneres d'implementar-la
1. Integració d'un partner
Shopify, WooCommerce i molts CRM activen l'API sense programar. És la via més ràpida, tot i que controles poc què s'envia.
2. Conversions API Gateway
Una solució de Meta que es desplega al teu núvol i replica des del servidor els esdeveniments del píxel. Poca feina tècnica, però només envia el que el píxel ja veu.
3. Google Tag Manager del costat del servidor
Si ja tens un contenidor server-side de GTM, una etiqueta de l'API reenvia a Meta els esdeveniments que rep. Dona control sobre les dades i serveix per a altres plataformes.
4. Integració directa amb l'API
El teu equip envia els esdeveniments des del backend amb un token d'accés. L'opció més flexible i la que exigeix més manteniment.
Esdeveniments offline i del CRM per la mateixa API
L'API també rep resultats que passen fora del web: un lead qualificat per l'equip comercial, una venda per telèfon o una compra a la botiga. S'envien al mateix conjunt de dades indicant-ne l'origen i Meta els atribueix igual que una compra online. Ho expliquem a com carregar conversions offline a Google Ads i Meta.
Consentiment
Enviar des del servidor no canvia les regles: si l'usuari va rebutjar la publicitat personalitzada, el seu esdeveniment tampoc no ha d'arribar per l'API. El teu servidor ha de conèixer la decisió registrada al teu CMP i aplicar-la abans de cada enviament.
El píxel no registra compres: com diagnosticar-ho
- Fes servir l'eina de prova d'esdeveniments. Fes una compra de prova i comprova a l'Administrador d'esdeveniments que
Purchasearriba des del navegador, des del servidor o des de tots dos. - Revisa la pestanya de diagnòstic. Meta avisa de paràmetres que falten, esdeveniments sense deduplicar o caigudes brusques de volum.
- Comprova la pàgina de confirmació. Si el pagament acaba en una passarel·la externa i l'usuari no torna, el píxel no es dispara. És la causa més habitual de compres perdudes.
- Compara amb les teves comandes. Compara una setmana de compres a Meta amb les comandes del teu e-commerce o el teu ERP. Si Meta en registra menys, falten esdeveniments; si en registra més, probablement no estàs deduplicant.
Errors habituals
- No deduplicar. El píxel i l'API envien la mateixa compra sense un
event_idcomú i Meta la compta dues vegades. - Enviar poques dades de client. Només la IP i l'agent d'usuari donen una coincidència baixa.
- Ignorar el consentiment. Enviar pel servidor el que l'usuari va rebutjar és un risc legal.
- Oblidar el valor i la moneda. Sense
valueicurrency, Meta no pot optimitzar per ingressos ni calcular el ROAS.
Google i TikTok tenen equivalents: les conversions millorades (Enhanced Conversions) de Google Ads i l'Events API de TikTok. La lògica és la mateixa.
Com ho fa Babuin
Amb el mesurament server-side de MonkeyFlux, els esdeveniments del teu web i la teva app passen per un servidor al teu propi domini. Allà s'aplica el consentiment, es descarta el trànsit de bots, es deduplica per event_id i s'enriqueixen amb el marge, el LTV o la qualitat del lead del teu CRM i el teu ERP. Després arriben a Meta per l'API de conversions, i a Google, TikTok o GA4 per Enhanced Conversions, Events API o Measurement Protocol. Compatible amb el teu contenidor server-side de GTM.
Amb aquestes conversions, Babuin dona a MonkeyBot el senyal per pujar per valor real i a DBA la dada per repartir el pressupost entre mitjans. Meta optimitza amb el que rep; l'API decideix quant del teu negoci arriba a veure.
Preguntes freqüents
Necessito el píxel si faig servir l'API de conversions?
Sí, en la majoria dels casos. Meta recomana fer servir tots dos alhora: el píxel aporta senyals del navegador i l'API cobreix els esdeveniments que el píxel perd. Per no comptar dues vegades, envia el mateix event_name i event_id per les dues vies.
Per què tinc esdeveniments duplicats entre el píxel i l'API?
Perquè els esdeveniments no porten el mateix event_id o el mateix nom a les dues vies. Comprova a l'eina de prova d'esdeveniments que cada compra arriba amb el mateix identificador, per exemple el número de comanda, des del navegador i des del servidor.
L'API de conversions evita haver de demanar consentiment?
No. Enviar les dades des del servidor no canvia les obligacions legals. Només pots enviar esdeveniments d'usuaris que hagin consentit aquest ús, i el teu servidor ha d'aplicar la decisió registrada al teu CMP.
Com puc millorar la qualitat de coincidència d'esdeveniments?
Envia més paràmetres de client, sobretot email i telèfon, ben normalitzats i xifrats amb SHA-256, juntament amb la IP, l'agent d'usuari i les cookies _fbp i _fbc. La puntuació es veu per esdeveniment a l'Administrador d'esdeveniments.