Escribe y ejecuta consultas

Crea una consulta

  1. Ve a la pestaña Búsquedas en el Centro de Datos de Anuncios.
  2. Haz clic en + Crear consulta. Se abrirá la página Plantillas de consulta de análisis.
  3. Opcional: Haz clic en Expandir para obtener una vista previa de la plantilla de SQL.
  4. Selecciona la plantilla que deseas utilizar haciendo clic en Usar plantilla, o bien haz clic en En blanco para comenzar desde cero.
  5. Ingresa un nombre para tu informe.
  6. Escribe o edita la consulta con SQL compatible con BigQuery. Puedes encontrar las tablas y los campos disponibles para insertarlos en tu SQL desde la pestaña Tablas de Google.
  7. Opcional: Configura los parámetros.
  8. Opcional: Configura el resumen de filas filtradas.
  9. Haz clic en Guardar.

Parámetros

Los parámetros aumentan la flexibilidad de las consultas. Por ejemplo, es posible que desees ejecutar la misma consulta en diferentes campañas. En lugar de realizar consultas duplicadas o codificar los IDs de las campañas antes de cada ejecución, puedes configurar un parámetro que acepte que se ingresen uno o más IDs de campaña desde la tarjeta Ejecutar cuando ejecutas una consulta. El uso de parámetros mantiene tu código limpio, reduce las posibilidades de introducir errores durante la edición y hace que sea posible que tu consulta se vuelva a usar sin editar. El alcance de los parámetros se establece en la consulta en la que se crean, por lo que puedes volver a usar el nombre de un parámetro en otra consulta.

Tipos de parámetros

Se permiten los siguientes tipos de parámetros:

  • int64
  • float64
  • bool
  • string
  • date
  • timestamp
  • array, de cualquiera de los tipos permitidos

Crea un parámetro

  1. Abre una consulta guardada o crea una nueva.
  2. Haz clic en Propiedades > Parámetros > Agregar parámetro.
  3. Escribe un nombre en el campo Nombre. Utilizarás este nombre para hacer referencia al parámetro en el texto de la consulta.
  4. Usa el menú desplegable para seleccionar el tipo de parámetro.
    • Si seleccionas array, aparecerá un menú desplegable adicional. Selecciona el tipo de array en el menú desplegable.
  5. Opcional: Repite los pasos 2 a 4 hasta que hayas agregado todos los parámetros que desees.
  6. Haz clic en Guardar

Usa un parámetro

En el texto de la consulta, usa el formato del parámetro de SQL estándar, que debe anteceder al nombre del parámetro por @. En el siguiente ejemplo, la consulta contiene un parámetro llamado @campaign_ids:

  /* Parameters:
  * @campaign_ids (ARRAY of INT64): A list of campaign IDs
  *   to conduct analysis on */

  WITH user_reach AS (
  SELECT 
    user_id,
    count(*) AS num_views
  FROM 
    adh.google_ads_impressions
  WHERE 
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY 
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM 
    user_reach

Cuando ejecutes la consulta, el diálogo Trabajo nuevo contendrá un campo Parámetros. Ingresa valores para cada parámetro que hayas definido.

Quita un parámetro

  1. Abre la consulta que tiene el parámetro que deseas borrar.
  2. Abre la pestaña Propiedades.
  3. En la tarjeta Parámetros, haz clic en borrar Borrar junto al parámetro que deseas borrar.
  4. Haz clic en Guardar.

Parámetros reservados

En la siguiente tabla, se enumeran los parámetros reservados por el Centro de Datos de Anuncios. Puedes usar estos parámetros en tus consultas, pero no puedes crear un parámetro con el mismo nombre que un parámetro reservado.

start_date date

La fecha de inicio (incluida) del trabajo de consulta. Los parámetros definidos por el usuario con este nombre se ignorarán y se reemplazarán por los valores establecidos en el diálogo New job.

end_date date

La fecha de finalización (incluida) del trabajo de consulta. Los parámetros definidos por el usuario con este nombre se ignorarán y se reemplazarán por los valores establecidos en el diálogo New job.

time_zone string

La zona horaria del trabajo de consulta. Los parámetros definidos por el usuario con este nombre se ignorarán y reemplazarán por los valores establecidos en el diálogo New job.

Resumen de filas filtradas

Los resúmenes de filas filtrados contabilizan los datos que se filtraron debido a verificaciones de privacidad. Los datos de las filas filtradas se suman y se agregan a una fila genérica. Si bien los datos filtrados no se pueden analizar más a fondo, proporciona un resumen de cuántos datos se filtraron de los resultados.

Cómo editar una consulta

  1. Ve a la pestaña Búsquedas en el Centro de Datos de Anuncios.
  2. Haz clic en el nombre de la consulta que deseas editar.
  3. Edita la consulta.
  4. Haz clic en Guardar.

Ejecuta una consulta

Antes de ejecutar una consulta, asegúrate de haber otorgado a la cuenta de servicio dataEditor permiso al conjunto de datos que contendrá el resultado de tus uniones. Obtén más información sobre el control de acceso en BigQuery.

  1. Navega a la pestaña Búsquedas en el Centro de Datos de Anuncios.
  2. Haz clic en el nombre de la consulta que quieres ejecutar.
  3. Haz clic en Ejecutar.
    • En la parte superior de la página, se muestra la cantidad esperada de bytes que utilizará la consulta.
  4. Selecciona un ID en el campo Datos de anuncios desde. Debe ser el ID de la cuenta asociado a los datos de anuncios que deseas consultar. (Si quieres consultar datos de la zona de pruebas, selecciona Cliente de zona de pruebas del CDA).
  5. Si usas una tabla de coincidencias, selecciona la tabla de coincidencias en el campo Match table from (Tabla de coincidencias desde).
  6. Selecciona el modo de privacidad. Obtén más información sobre los modos de privacidad.
  7. En el campo Tabla de destino, especifica en qué lugar se deben guardar los resultados de tu consulta.
  8. Ingresa fechas de inicio y finalización para determinar el período de tu búsqueda.
  9. Ingresa una zona horaria. Debe coincidir con la zona horaria del comercio.
  10. Opcional: Ingresa los valores para cualquier parámetro.
  11. Haz clic en Ejecutar.

Ve tus resultados

Cuando la consulta termina de ejecutarse, puedes obtener una vista previa de los resultados en la página “Trabajos”. También puedes explorar los datos en BigQuery, Hojas de cálculo o Data Studio.

Vista previa

Haz clic en Vista previa en el trabajo finalizado. Los primeros 20 resultados aparecerán debajo del trabajo.

BigQuery

Tus resultados se exportan a BigQuery de forma predeterminada. Haz clic en Ver tabla para abrir BigQuery en una ventana nueva.

Hojas de cálculo y Data Studio

Abre el menú desplegable Explorar y selecciona Explorar con Hojas de cálculo o Explorar con Data Studio en las opciones. Esto abrirá los datos en una ventana nueva.