Escribe y ejecuta consultas

Crea una consulta

Nota: No todos los usuarios pueden crear y editar consultas. Obtén más información sobre el control de acceso en el Centro de Datos de Anuncios.

1. Navega a la pestaña Consultas 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: Para obtener una vista previa de la plantilla de SQL, haz clic en Expandir.
4. Para seleccionar la plantilla que deseas usar, haz clic en Usar plantilla o 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, y, luego, 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 hacen que las consultas sean más flexibles. 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 campaña antes de cada ejecución, puedes configurar un parámetro que acepte uno o más IDs de campaña para que se ingresen desde la tarjeta Ejecutar cuando ejecutes una consulta. El uso de parámetros mantiene tu código limpio, reduce las posibilidades de introducir errores a través de la edición y permite que tu consulta se vuelva a usar sin editar. Los parámetros se limitan a la consulta en la que se crean, por lo que puedes volver a usar un nombre de 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 Properties > Parameters > Add parameter.
3. Ingresa un nombre en el campo Nombre. Usará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 del 2 al 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 de parámetro de SQL estándar, que consiste en anteponer el nombre del parámetro con @. 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 New job contendrá un campo Parameters. Ingresa valores para cada parámetro que definiste.

Cómo quitar un parámetro

1. Abre la consulta que tiene el parámetro que quieres borrar.
2. Abre la pestaña Propiedades.
3. En la tarjeta Parameters, 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 Es la fecha de inicio (incluida) del trabajo de consulta. Se ignorará un parámetro definido por el usuario con este nombre y se reemplazará por los valores establecidos en el diálogo New job.
end_date	date Es la fecha de finalización (incluida) de la tarea de consulta. Se ignorará un parámetro definido por el usuario con este nombre y se reemplazará por los valores establecidos en el diálogo New job.
time_zone	string La zona horaria del trabajo de consulta. Se ignorará un parámetro definido por el usuario con este nombre y se reemplazará por los valores establecidos en el diálogo New job. Sugerencia: Para evitar discrepancias cuando uses zonas horarias en tu búsqueda, como en las cláusulas WHERE, puedes usar time_zone para que coincida con la zona horaria establecida en Trabajo nuevo. También es importante usar la misma zona horaria que la fuente de datos.

Resumen de filas filtradas

Los resúmenes de filas filtradas registran los datos que se filtraron debido a las verificaciones de privacidad. Los datos de las filas filtradas se suman y se agregan a una fila de captura general. Si bien los datos filtrados no se pueden analizar más, proporcionan un resumen de la cantidad de datos que se filtraron de los resultados.

Nota: Los requisitos de agregación se aplican a los resúmenes de filas filtradas. Si el resumen de filas filtradas resultante no cumple con los requisitos de agregación, se filtrará el resumen de filas filtradas.

Cómo editar una consulta

1. Navega a la pestaña Consultas 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

Punto clave: Debes escribir y probar tus consultas con la zona de pruebas antes de ejecutarlas en datos reales. Más información sobre las prácticas recomendadas para escribir consultas en el Centro de Datos de Anuncios

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

1. Navega a la pestaña Consultas en el Centro de Datos de Anuncios.
2. Haz clic en el nombre de la consulta que deseas ejecutar.
3. Haz clic en Ejecutar.
   • La cantidad esperada de bytes que usará la consulta se muestra en la parte superior de la página.
4. Selecciona un ID en el campo Datos de anuncios de. Debe ser el ID de la cuenta asociado con los datos de anuncios que deseas consultar. (Si deseas consultar los datos de la zona de pruebas, selecciona ADH Sandbox Customer).
5. Si usas una tabla de coincidencias, selecciónala en el campo Tabla de coincidencias.
6. Selecciona el modo de privacidad. Obtén más información sobre los modos de privacidad.
7. Especifica dónde se deben guardar los resultados de tu consulta en el campo Tabla de destino.
8. Ingresa las fechas de inicio y finalización para determinar el período de tu consulta.
9. Ingresa una zona horaria. Debe coincidir con la zona horaria de la puerta de compra.
10. Opcional: Ingresa valores para los parámetros.
11. Haz clic en Ejecutar.

Ve los resultados

Una vez que se termine de ejecutar la consulta, puedes obtener una vista previa de los resultados en la página “Jobs”. 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 terminado. 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 entre las opciones. Se abrirán los datos en una ventana nueva.