API de conversións
Informe dos seus obxectivos a Meta, LinkedIn, TikTok e Google Ads desde o noso servidor en lugar do navegador, vinculándoos só polo identificador do clic que estableceu a propia rede.
1. Por que no servidor?
Un píxel do navegador ten que superar tres obstáculos para comunicar unha conversión: un bloqueador de anuncios, unha opción antirrastrexo e que o visitante peche a lapela antes de activarse. Unha chamada no servidor supera os tres porque non ocorre no navegador.
MousePlayer xa sabe cando se alcanzou un obxectivo; para iso están os obxectivos. As API de conversións simplemente transmiten ese feito á rede publicitaria desde o noso servidor.
Isto non substitúe o píxel. Consérveo. Todas as redes deduplican os dous entre si e enviamos os identificadores necesarios.
2. Que enviamos e que nunca enviamos
O único que identifica o visitante nestas chamadas é a cookie ou o identificador de clic que estableceu a propia rede. Non sae do servidor ningún outro dato da persoa.
| Rede | Identificador usado | De onde vén |
|---|---|---|
| Meta | _fbp, _fbc | Cookies de primeira parte establecidas polo píxel Meta |
li_fat_id | Cookie de primeira parte establecida por LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp é unha cookie, ttclid procede do URL do clic no anuncio |
| Google Ads | gclid, wbraid, gbraid | Do URL do clic no anuncio ou da cookie _gcl_aw posteriormente |
| Microsoft Advertising | msclkid | Do URL do clic no anuncio ou da cookie _uetmsclkid que escribe a etiqueta UET |
Nunca se envían: correo electrónico, teléfono, nome nin enderezo IP, nin sequera con hash. Se un visitante non ten identificador de clic, non se envía nada. Unha conversión sen atribución vale menos para vostede que un reconto preciso.
Só con consentimento
Todas estas chamadas están detrás da mesma barreira de consentimento que a gravación. Unha sesión sen consentimento non xera ningún informe de conversión, independentemente do interruptor na configuración do proxecto.
3. Google Ads ten tres identificadores, non un
Isto sorprende, polo que paga a pena dicilo con claridade. Google usa gclid para un clic publicitario individual. Se a protección antirrastrexo de Apple impide atribuír un clic individual, Google envía wbraid ou gbraid no seu lugar; representan un grupo de clics.
Os tres exclúense mutuamente: Google rexeita unha conversión que leve dous. Enviamos exactamente un e gclid prevalece se hai máis dun porque é o máis preciso.
Só están unha vez no URL
O identificador aparece no enderezo só na primeira páxina despois do clic no anuncio. A etiqueta Google gárdao despois na cookie _gcl_aw e nós lémola como alternativa. Sen ela, unha conversión na terceira páxina da visita non atoparía ningún identificador.
4. Configuración
Meta, LinkedIn e TikTok
Dous campos por rede: o ID do píxel ou da regra de conversión e un token de acceso que crea na propia interface da rede. Ambos gárdanse cifrados con AES-256-GCM e nunca volven mostrarse tras gardalos.
Google Ads necesita seis
Google é a excepción e convén saber por que antes de comezar: a diferenza das outras tres, non ofrece un token de acceso sinxelo. O acceso usa OAuth cun token de actualización e a Ads API require ademais un token de desenvolvedor.
| Campo | Onde atopalo |
|---|---|
| ID do cliente | Arriba á dereita en Google Ads. Só díxitos, sen guións. |
| ID da acción de conversión | Goals and conversions e despois a acción na que quere rexistralo. |
| Token de desenvolvedor | A súa conta de administrador de Google Ads, API Center. |
| ID e segredo do cliente OAuth | Google Cloud Console, Credentials, cliente OAuth de tipo "desktop app". |
| Token de actualización | Xérao vostede unha vez para o ámbito adwords. |
LinkedIn ten dúas vías e convén a curta
En Campaign Manager: Data, Signals Manager, Direct API, Generate access token. É a vía para anunciantes que envían os seus propios datos, sen aplicación de desenvolvedor nin revisión. O token non caduca e Campaign Manager non o mostrará unha segunda vez, así que cópieo inmediatamente.
A outra vía, unha aplicación de desenvolvedor solicitada no Developer Portal de LinkedIn, existe para plataformas que envían datos por conta de moitos anunciantes. Require verificar a páxina da empresa e un caso de uso aprobado; aquí non necesita nada diso.
Microsoft Advertising é o sinxelo
Despois de Google Ads espera a mesma carga: OAuth, un token de desenvolvedor e unha aprobación. É o contrario: dous campos. O ID de etiqueta UET que xa usa no navegador e un token que copia de Microsoft Advertising na etiqueta UET, "Use Conversions API", "Copy Token". Non hai nada que solicitar.
Use o mesmo ID de etiqueta que no navegador. Iso permite a Microsoft recoñecer o evento do servidor e o do navegador como unha soa conversión en lugar de dúas.
O token de desenvolvedor necesita a aprobación de Google ("Basic access"), que tarda uns días. É o único paso que non pode rematar nun minuto, polo que convén comezar por el. Nunca vemos o seu contrasinal Google, só o token de actualización, e pode revogalo cando queira.
5. Cando se comunica unha conversión
Exactamente unha vez por obxectivo e sesión. MousePlayer evita as repeticións antes de enviar a chamada e os datos tamén levan un ID para que a rede as evite de novo no seu lado. Un visitante que engade cinco artigos á cesta produce unha conversión, non cinco.
Que verá na conta de anuncios
A conversión leva o nome do obxectivo, o seu valor e moeda se a estableceu e o momento en que ocorreu. En condicións normais chega nun minuto.
Se non chega nada
- Sen identificador de clic. O visitante non chegou por un anuncio desa rede ou chegou antes de que o píxel establecese a cookie. Non se envía nada; é o esperado, non un erro.
- Sen consentimento. A barreira aplicouse primeiro.
- A rede aceptou a chamada pero rexeitou a conversión. Google, TikTok e outras redes responden con HTTP 200 e un erro no corpo da resposta. Lemos o corpo, non só o estado, e o motivo aparece no rexistro de entregas.
Todas as marcas mencionadas aquí pertencen aos seus respectivos propietarios. MousePlayer non ten relación comercial con estes provedores.