Recursos esenciales para la migración de Scripts de Google Ads a la New Scripts Experience (GAQL)

Vamos con la sección que mayor interés puede presentar. Esta recopilación os la ofrecemos debido a la dificultad que encontramos para hallar la información adecuada durante la migración de nuestros scripts. Espero que, si estáis en el mismo proceso desesperante, os pueda resultar muy útil.

NOTA: Si los enlaces siguientes os conducen a una página de Google Service Unavailable al recargar la página ya tendréis disponible el contenido.

Para comenzar, aquí encontraréis un artículo con una buena introducción a los distintos tipos de consultas que se pueden realizar en los scritps con GAQL e incluye un par de vídeos interesantes que, además, os dirigen al canal del Youtube oficial de GAds Developers, donde se pueden encontrar otros recursos útiles :

Google Ads Query Language

Ya hablamos de ella antes, pero una página clave en la migración de Scripts a la nueva experiencia es la herramienta de migración de consultas. La siguiente herramienta se puede utilizar para traducir consultas de AWQL a GAQL. Si por alguna razón aparece como no disponible en vuestro navegador os recomiendo probar navegando en modo incógnito.

Herramienta de migración de consultas

Esta página ofrece un listado extraordinariamente útil con la equivalencia de todos los recursos disponibles en la antigua API de AdWords y en la nueva API de Google Ads. Esta página es de gran valor a la hora de transformar las antiguas Querys al nuevo lenguaje.:

Resource mappings

Aquí encontréis la lista de recursos disponibles que se pueden utilizar en las querys de los scripts en la clausula FROM (ad_group, ad_group_ad, campaign, keyword_view, bidding_strategy en suma, todos), con una descripción muy útil de cada recurso:

Google Ads Query Builder

Una herramienta muy potente es el siguiente Google Ads Query Builder, que nos permite ir construyendo las consultas para cada uno de los recursos disponibles (y que venían incluidos en el enlace de arriba) para cada uno de los campos de la Query (SELECT, WHERE, ORDER BY, LIMIT y PARAMETERS) a partir de desplegables que nos muestran exclusivamente los elementos válidos para esa consulta concreta. El siguiente enlace os conduce al recurso accessible_bidding_strategy pero en la barra lateral de la izquierda podéis encontrar el recurso que os interese.

Google Ads Query Builder

Complementario con el anterior encontramos el validador de consultas: Permite ingresar una consulta y enviarla. Si la consulta ingresada es válida, se puede continuar editando utilizando el generador de consultas interactivo. De lo contrario, se le presenta una lista de errores, que se pueden ir corrigiendo progresivamente para crear una consulta GAQL válida.

Google Ads Query Builder (Validator) 

Al igual que en la antigua experiencia de Scripts también tenemos disponibles un listado detallado de cada uno campos disponibles (métricas, segmentos y recursos) para cada uno reports. Por ejemplo, en el siguiente enlace tenemos la página equivalente al Keyword_Performance_Report, ahora Keyword_view.

En esta página, se muestran todas las métricas y los segmentos que se pueden colocar en la cláusula SELECT para un consulta keyword_view. Sin embargo, cuando se utiliza keyword_view en la cláusula FROM, algunas métricas y segmentos no se pueden usar. Utilizando el filtro que aparece bajo la información general se muestran solo los campos disponibles cuando se especifica keyword_view en la cláusula FROM.

Es clave considerar que la lista de operadores en la clausula WHERE es diferente. En el siguiente artículo se muestra una lista detallada de los operadores válidos, así como de aquellos que dejan de ser funcionales:

Querying in the Google Ads API

Esperamos que os resulten útiles estos recursos. Podéis compartir con nosotros vuestras dificultades con la migración e ir haciendo entre todas menos ardua esta tarea.