Los términos de búsqueda son las palabras que la gente escribió de verdad, a diferencia de las palabras clave que compraste. La distancia entre unas y otras es donde vive la mayor parte del gasto desperdiciado, y leerla es una llamada que no puede cambiar nada.
La llamada
curl -sG https://top-rated.team/google-ads/v1/accounts/1234567890/report \ -H "X-API-KEY: $MAKEHYBRID_KEY" \ --data-urlencode 'query=SELECT search_term_view.search_term, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM search_term_view WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.cost_micros DESC' \ --data-urlencode 'max_rows=200'
La consulta está en Google Ads Query Language, y todo lo que Google informa se puede pedir así: campañas, grupos de anuncios, palabras clave, anuncios, recursos, presupuestos, conversiones, audiencias, el historial de cambios. Hasta 200 filas por respuesta.
Leer lo que vuelve
- El coste va en micros: 1.000.000 de micros es una unidad de la moneda de la cuenta. Un término a 4.310.000 costó 4,31.
- Un término con gasto y sin conversiones en treinta días es lo primero que mirar, y la respuesta habitual es una palabra clave negativa y no un cambio de puja.
- El GET lleva la consulta en la URL; un POST a la misma dirección la lleva en un cuerpo, para una consulta demasiado larga para caber. Los dos solo leen.
Nada en esta receta puede alterar la cuenta. Un informe es una lectura, y la llamada que cambia algo es otra distinta, con una persona al otro lado.
Preguntas frecuentes
¿Necesito saber GAQL?
Para escribir una consulta a mano, sí, y se parece lo bastante a SQL como para leerla sin aprenderla. En la práctica, un agente de IA con esta clave escribe la consulta a partir de lo que pediste con palabras, la ejecuta y te lee las filas.
¿Por qué micros?
Es como Google informa el dinero, así que es como responde esto: un entero de millonésimas, que evita el redondeo que tendrías al pasar fracciones de una moneda de un lado a otro. Divide entre un millón para obtener la cantidad que diría una persona.
¿Puede un informe tocar la cuenta?
No. La llamada de informe rechaza todo lo que no sea un SELECT, así que no hay consulta que puedas pasar por ella que altere una cuenta — un error aquí te cuesta una respuesta confusa y nada más.