Segurament no has vist mai l'API de Google Ads i no la veuràs mai. No té botons, no té un panell bonic i no surt enlloc del teu compte quan hi entres al matí a mirar com van les campanyes. I tot i així, si inverteixes en Google Ads amb un mínim de seriositat, hi ha moltes possibilitats que la meitat de la teva operativa depengui d'ella sense que ho sàpigues: l'informe automàtic que reps cada dilluns, el connector que porta les dades a Looker Studio, la plataforma de gestió de bids que fa servir la teva agència, la sincronització amb el CRM que et diu quins clics s'han convertit en clients reals.
Fa uns dies Google va anunciar la publicació d'una nova versió major de l'API de Google Ads, la v25. Per a un desenvolupador és una notícia de calendari. Per a un anunciant hauria de ser una excusa perfecta per fer-se una pregunta que gairebé ningú es fa fins que és massa tard: de què depèn, exactament, que les meves dades i les meves automatitzacions segueixin funcionant el mes que ve? En aquest article t'ho expliquem sense tecnicismes, des de la perspectiva de qui gestiona pressupostos i respon davant de resultats, no de qui escriu codi.
Què és, de veritat, l'API de Google Ads
Imagina't que la interfície de Google Ads —el lloc on entres a crear campanyes i mirar mètriques— és la façana d'un edifici. És el que veu tothom. L'API (interfície de programació d'aplicacions) és la porta de servei del darrere: un accés tècnic que Google ofereix perquè altres programes puguin entrar, llegir dades i executar accions dins del teu compte de manera automàtica, sense que cap persona hagi de clicar res.
Aquesta porta del darrere és el que fa possible tot l'ecosistema d'eines que orbita al voltant de Google Ads. Quan una plataforma de tercers optimitza bids en temps real, quan un connector extreu cada nit les xifres de despesa per abocar-les a un full de càlcul, quan un script apaga automàticament els anuncis d'un producte que s'ha esgotat, quan el teu equip d'analítica creua les conversions de Google amb els ingressos reals del teu sistema de facturació… tot això passa per l'API. No per la pantalla que tu mires.
Per això la frase clau d'aquest article és aquesta: no cal que programis res perquè l'API de Google Ads sigui crítica per al teu negoci. N'hi ha prou que facis servir gairebé qualsevol eina que no sigui el panell natiu de Google.
Què vol dir que Google publica una "versió major"
Google no toca l'API cada dia a l'atzar. La versiona: v23, v24, i ara v25. Cada versió major és una fotografia estable d'allò que l'API sap fer en un moment determinat. Google en publica de noves diverses vegades l'any i, quan ho fa, hi passen tres coses que sí que afecten el teu negoci, encara que estiguin explicades amb llenguatge d'enginyeria.
Primer: arriben capacitats noves. Les novetats de Google Ads —nous tipus de campanya, nous senyals per a l'optimització, noves mètriques de reporting, nous camps de dades— sovint apareixen abans o de manera més completa a través de l'API que no pas al panell visual. Qui treballa amb integracions ben mantingudes accedeix a aquestes capacitats amb avantatge respecte de qui només mira la pantalla.
Segon: es reorganitza com es demanen i es retornen les dades. Amb el temps, Google refina la manera com s'estructura la informació. Un camp es pot reanomenar, una mètrica es pot calcular diferent, una manera antiga de demanar dades es pot substituir per una de nova. Res d'això es veu des de fora… fins que un informe deixa de quadrar.
Tercer, i el més important per a tu: les versions antigues caduquen. Aquí és on cal parar molta atenció.
La caducitat: el detall que fa mal si l'ignores
Google no manté totes les versions de l'API vives per sempre. Cada versió té una data de defunció programada. Quan Google publica la v25, no és només que estrena coses noves: és que posa en marxa el rellotge de compte enrere per a les versions anteriors. Al cap d'un temps —Google ho anuncia amb marge a les seves notes de versió oficials— les versions velles deixen de respondre. Simplement, un dia, la porta del darrere que feia servir aquella versió antiga es tanca amb clau.
Aquí és on la teoria es converteix en un problema molt concret. Si una eina, un script o un connector que fas servir està construït sobre una versió de l'API que arriba al final de la seva vida i ningú l'actualitza a temps, aquell component deixa de funcionar. I gairebé mai ho fa amb un cartell vermell ben visible. El més habitual és el pitjor escenari possible: que falli en silenci.
- Construïda sobre una versió de l'API que Google ja ha marcat com a obsoleta.
- Les dades deixen d'actualitzar-se un dia qualsevol, sovint sense error visible al dashboard.
- L'informe segueix mostrant xifres… però són d'ahir, o d'una setmana enrere, congelades.
- Les decisions de pressupost es prenen amb dades mortes sense que ningú se n'adoni.
- Quan es detecta el problema, ja s'han pres males decisions durant setmanes.
- Migrada a temps a la versió vigent de l'API abans que la vella caduqui.
- Les dades flueixen contínuament i coincideixen amb el que mostra el panell natiu.
- Les novetats de campanya i de reporting arriben tan bon punt Google les allibera.
- Les alertes salten si alguna cosa deixa de sincronitzar, no tres setmanes després.
- Les decisions es prenen sobre dades vives i verificades.
Per què "fallar en silenci" és tan perillós
Un error sorollós és, paradoxalment, una bona notícia: el veus, el corregeixes i segueixes. El problema real de les integracions caducades no és que s'aturin de cop amb un missatge clar. És que sovint segueixen aparentment funcionant. El dashboard continua carregant. L'informe continua arribant els dilluns. Els números hi són. El que ja no passa és que aquells números s'actualitzin, o que reflecteixin la realitat.
Pensa en el que això significa quan estàs decidint on posar el pressupost del mes. Redistribueixes inversió cap a la campanya que "millor funciona" segons un informe que porta dues setmanes congelat. Puges el bid d'un grup d'anuncis basant-te en un cost per conversió que la teva plataforma ja no rep bé de Google. Apagues una campanya que en realitat estava rendint, però les dades que la descrivien s'havien quedat mudes. El cost d'unes dades brutes o mortes no és el cost de reparar la integració: és el cost de totes les decisions equivocades que has pres mentre no ho sabies.
Qui hauria d'estar mirant tot això (pista: no ets tu)
La bona notícia és que, com a anunciant, tu no has d'entendre ni una línia de codi de l'API. La teva feina és el negoci: el producte, el marge, els clients, el missatge. La feina de gestionar el cicle de vida de les versions, planificar les migracions i vigilar que cap integració es quedi enrere és, precisament, una de les coses que hauria de fer per tu qui et gestiona la publicitat.
Aquí és on es nota la diferència entre qui "porta campanyes" i qui gestiona amb rigor. A Daimatics gestionem Google Ads entenent que una campanya no acaba a la interfície: acaba a les dades que en surten i a les eines que hi connecten. Ser Partner oficial de Google i tenir més de vint anys d'ofici vol dir, entre moltes altres coses, tractar aquests anuncis de canvi d'API com el que són —un avís operatiu— i no com soroll tècnic que no va amb nosaltres.
- Saps quines eines externes toquen el teu compte de Google Ads (reporting, bidding, CRM, scripts)?
- Hi ha algú clarament responsable de mantenir cada integració al dia amb les versions de l'API?
- Les dades dels teus informes coincideixen amb les del panell natiu de Google quan les compares?
- Rebries una alerta si un connector deixés de sincronitzar, o te n'assabentaries setmanes després?
- El teu sistema de conversions i el teu tracking estan documentats i verificats, no només "muntats en el seu dia"?
- Algú revisa periòdicament les notes de versió oficials de Google per anticipar canvis?
Com ho abordem, pas a pas
Quan Google publica una versió major com la v25, el procés que segueix un equip que treballa bé no té res de misteriós. És metòdic i es pot explicar a qualsevol client sense un sol tecnicisme. Aquest és, en essència, el nostre.
El fil que ho connecta tot: dades netes
Hi ha un motiu de fons pel qual aquest tema ens importa tant, i va més enllà de l'API en si mateixa. Tota la disciplina de Google Ads moderna —el Smart Bidding, les campanyes automatitzades, l'optimització que fa la mateixa Google— s'alimenta de dades. Si les dades de conversió que entren al sistema són incompletes, tardanes o brutes, l'automatització no fa màgia: amplifica l'error. Prendrà decisions ràpides i massives sobre informació dolenta.
Per això no separem mai la conversa sobre integracions de la conversa sobre analítica i tracking. L'API és el canal per on viatgen les dades; el tracking és el que garanteix que aquelles dades signifiquin alguna cosa. Una integració impecable que transporta conversions mal mesurades és tan inútil com un connector caducat. Les dues coses han d'anar de la mà: canonades en bon estat i aigua neta a dins. És exactament aquí on una plataforma com Google Ads deixa de ser una eina que "engegues" i passa a ser un sistema que cal cuidar.
I ara què fas, en concret
Si has arribat fins aquí, probablement estàs en un de dos escenaris. O bé gestiones les campanyes amb una agència o equip que ja té tot això controlat —en aquest cas, perfecte, aquest article et serveix per saber quines preguntes fer-los i confirmar que la resposta és sòlida—. O bé has llegit el checklist de més amunt i has notat aquella incomoditat de no saber del cert la resposta a més d'una pregunta.
Si és el segon cas, no cal que t'espantis, però tampoc que ho deixis per demà. Les versions d'API caduquen segons un calendari públic, i el bon moment per revisar les teves dependències és sempre abans que salti l'alarma, no després. Pots començar tu mateix consultant la Central d'Ajuda de Google Ads per entendre l'ecosistema, o pots deixar que ho miri qui ho fa cada dia. Sigui com sigui, el missatge de fons és un de sol: la publicitat digital que rendeix no és només la que es veu al panell, sinó tota la fontaneria invisible que la sosté. I aquesta fontaneria, com qualsevol altra, necessita manteniment.
L'API de Google Ads i les teves dades: preguntes freqüents
Si jo no programo ni tinc desenvolupadors, m'afecta realment la nova versió de l'API de Google Ads?
Sí, molt probablement. No cal programar per dependre de l'API. Si fas servir qualsevol eina que no sigui el panell natiu de Google —un connector de reporting cap a Looker Studio o un full de càlcul, una plataforma de gestió de bids, una sincronització amb el teu CRM o el teu sistema d'analítica, o scripts d'automatització—, totes aquestes eines es comuniquen amb Google a través de l'API. Quan surt una versió nova i les antigues caduquen, són aquestes eines les que han d'estar actualitzades perquè segueixin funcionant.
Què passa exactament si una integració es queda amb una versió antiga de l'API?
Google manté cada versió viva durant un temps limitat i n'anuncia la data de fi de vida amb marge. Quan aquella data arriba, la versió antiga deixa de respondre. La integració que en depenia s'atura. El perill és que sovint no ho fa amb un error visible: el dashboard segueix carregant i l'informe segueix arribant, però amb dades congelades o desactualitzades. Pots estar prenent decisions de pressupost amb informació morta sense adonar-te'n durant setmanes.
Com sé quines eines del meu compte depenen de l'API?
Fes-te una llista de tot allò que «toca» el teu compte de Google Ads sense que hi entri una persona a mà: d'on surten els informes automàtics, quines plataformes externes optimitzen les campanyes, si hi ha sincronització amb CRM o analítica, i si algú va instal·lar scripts en el seu dia. Si no ho tens clar, és precisament el senyal que cal una auditoria de dependències. No pots protegir el que no saps que existeix.
Cada quan surt una versió nova de l'API i he d'estar-hi pendent constantment?
Google publica diverses versions majors l'any. La bona notícia és que no és una cosa que hagis de vigilar tu personalment cada setmana; és una tasca de manteniment que hauria de dur qui et gestiona la publicitat, contrastant les teves eines amb el calendari de deprecació oficial i planificant les migracions amb temps. El que has d'evitar és el model «instal·lar i oblidar»: una integració que ningú adopta acabarà caducant.
Les novetats de Google Ads arriben abans per l'API que al panell?
Sovint sí. Molts tipus de campanya, senyals d'optimització i mètriques de reporting apareixen abans, o de manera més completa, a través de l'API que no pas a la interfície visual. Per això qui treballa amb integracions ben mantingudes sol tenir accés a capacitats noves amb cert avantatge. No és una regla absoluta ni passa amb tot, però és una raó més per no deixar les integracions endarrerides.
Com puc saber si les meves dades estan «brutes» o desactualitzades ara mateix?
La comprovació més senzilla és comparar. Agafa una mètrica clau —despesa, conversions, cost per conversió d'un període— al teu informe o dashboard i contrasta-la amb el que mostra el panell natiu de Google Ads per al mateix període. Si no coincideixen o si les dades del teu informe semblen «aturades» en el temps, tens un problema de sincronització. És una revisió que val la pena fer periòdicament, no només quan sospites que hi ha una avaria.
La migració a una versió nova de l'API pot fer que perdi històric o configuracions?
Una migració ben feta i planificada no t'hauria de fer perdre res: es tracta d'actualitzar la manera com les eines es connecten, no d'esborrar dades. El risc real no és la migració en si, sinó fer-la tard o malament, en mode urgència, sense verificar després que les dades segueixen quadrant. Per això insistim tant en el pas de verificació post-migració: una migració no s'acaba fins que has confirmat que tot flueix i coincideix amb la realitat.
Per què barregeu sempre el tema de l'API amb el del tracking i l'analítica?
Perquè són les dues cares de la mateixa moneda. L'API és el canal per on viatgen les dades entre Google i les teves eines; el tracking és el que garanteix que aquelles dades siguin correctes en origen. De res serveix una integració impecable si les conversions que transporta estan mal mesurades, i de res serveix un tracking perfecte si el canal que el mou està caducat. L'automatització de Google Ads s'alimenta d'aquestes dades: si entren brutes, amplifica l'error a gran escala. Canonades en bon estat i aigua neta a dins: les dues coses, sempre juntes.
Segur que les teves dades de Google Ads estan vives?
A Daimatics revisem quines eines toquen el teu compte, si depenen de versions d'API que caduquen i si els teus informes coincideixen amb la realitat. Som Partner oficial de Google i tractem aquests canvis com el que són: un avís operatiu, no soroll tècnic.
Explica'ns el teu cas i comprovem que res no falli en silenci.
Revisar les meves campanyes i dades →
