API de conversions

1. Per què fer-ho al costat del servidor?

Un píxel del navegador ha de superar tres obstacles abans de poder comunicar una conversió: un bloquejador d’anuncis, una configuració de prevenció del seguiment i el fet que el visitant tanqui la pestanya abans que s’activi el píxel. Una crida des del servidor supera tots tres perquè no es produeix al navegador.

MousePlayer ja sap quan s’ha assolit un dels seus objectius: per això serveixen els objectius. Les API de conversions simplement transmeten aquest fet a la xarxa publicitària des del nostre servidor.

2. Què enviem i què no enviem mai

L’únic que identifica el visitant en aquestes crides és la galeta o l’identificador de clic que ha definit la mateixa xarxa. Cap altra dada de la persona no surt del nostre servidor.

Xarxa	Identificador utilitzat	D’on prové
Meta	_fbp, _fbc	Galetes pròpies que defineix el píxel de Meta
LinkedIn	li_fat_id	Galeta pròpia que defineix LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp és una galeta, ttclid prové de l’URL del clic a l’anunci
Google Ads	gclid, wbraid, gbraid	De l’URL del clic a l’anunci o, després, de la galeta _gcl_aw corresponent
Microsoft Advertising	msclkid	De l’URL del clic a l’anunci o de la galeta _uetmsclkid que escriu l’etiqueta UET

Només amb consentiment

Totes aquestes crides passen pel mateix control de consentiment que la gravació. Una sessió sense consentiment no genera cap notificació de conversió, independentment de l’interruptor de la configuració del projecte.

3. Google Ads té tres identificadors, no un

Això sorprèn molta gent, i per això ho expliquem clarament. Google utilitza gclid per a un sol clic a un anunci. Quan la prevenció del seguiment d’Apple impedeix atribuir un clic individual, Google envia wbraid o gbraid en lloc seu; representen un grup de clics.

Els tres són mútuament excloents: Google rebutja una conversió que en conté dos. Nosaltres n’enviem exactament un, i gclid té prioritat quan n’hi ha més d’un, perquè és el més precís.

Només apareixen a l’URL una vegada

L’identificador només apareix a l’adreça de la primera pàgina després del clic a l’anunci. Després, l’etiqueta de Google el desa a la galeta _gcl_aw corresponent. Llegim la galeta com a alternativa; sense aquesta, una conversió a la tercera pàgina de la visita no trobaria cap identificador.

4. Configuració

Meta, LinkedIn i TikTok

Dos camps per a cadascun: l’identificador del píxel o de la regla de conversió i un token d’accés que crea a la interfície de la xarxa. Tots dos es desen xifrats amb AES-256-GCM i no es tornen a mostrar després de desar-los.

Google Ads en necessita sis

Google és l’excepció, i convé conèixer-ne el motiu abans de començar: a diferència dels altres tres, Google no emet cap token d’accés simple. L’accés es fa mitjançant OAuth amb un token d’actualització, i l’API d’Ads també requereix un token de desenvolupador.

Camp	On es troba
Identificador de client	A dalt a la dreta a Google Ads. Només dígits, sense guionets.
Identificador de l’acció de conversió	A Objectius i conversions i, després, a l’acció a la qual vulgui atribuir-la.
Token de desenvolupador	Al seu compte d’administrador de Google Ads, Centre d’API.
Identificador i secret del client OAuth	A la consola de Google Cloud, Credencials, client OAuth de tipus «aplicació d’escriptori».
Token d’actualització	El genera vostè mateix una sola vegada per a l’abast adwords.

LinkedIn té dues vies, i li interessa la curta

A Campaign Manager: Dades, Gestor de senyals, API directa, Generar un token d’accés. Aquesta és la via per als anunciants que envien dades pròpies: sense aplicació de desenvolupador ni revisió. El token no caduca i Campaign Manager no el torna a mostrar; per tant, copiï’l de seguida.

L’altra via, una aplicació de desenvolupador sol·licitada al Developer Portal de LinkedIn, està pensada per a plataformes que envien dades en nom de molts anunciants. Requereix verificar la pàgina d’empresa i aprovar un cas d’ús; aquí no necessita res d’això.

Microsoft Advertising és l’opció senzilla

Després de Google Ads, s’espera la mateixa complexitat: OAuth, un token de desenvolupador, un pas d’aprovació. És al revés: dos camps. L’identificador de l’etiqueta UET que ja utilitza al navegador i un token que copia a Microsoft Advertising dins de l’etiqueta UET, a «Utilitzar Conversions API», «Copiar el token». No cal sol·licitar res.

Utilitzi el mateix identificador que el de l’etiqueta del navegador. Això permet a Microsoft reconèixer l’esdeveniment del servidor i el del navegador com una sola conversió en lloc de dues.

5. Quan es comunica una conversió

Exactament una vegada per objectiu i sessió. MousePlayer evita duplicats abans d’enviar la crida, i la càrrega útil també conté un identificador perquè la xarxa pugui tornar a evitar-los a la seva banda. Un visitant que afegeix cinc articles al carret genera una conversió, no cinc.

Què veurà al seu compte publicitari

La conversió conté el nom de l’objectiu, el seu valor i la moneda si els ha definit, i el moment en què s’ha produït. En funcionament normal, arriba en menys d’un minut.

Si no arriba res

• No hi ha identificador de clic. El visitant no ha arribat a través d’un anunci d’aquesta xarxa o ha arribat abans que el píxel definís la galeta. No s’envia res; és el comportament previst, no un error.
• No hi ha consentiment. El control de consentiment té prioritat.
• La xarxa ha acceptat la crida, però ha rebutjat la conversió. Google, TikTok i d’altres responen amb HTTP 200 i un error dins del cos de la resposta. Llegim el cos, no només l’estat, i el motiu apareix al registre de lliuraments.