Escribir y ejecutar consultas

Crear una consulta

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

1. Accede a la pestaña Consultas del Centro de Datos de Anuncios.
2. Haz clic en + Crear consulta. Se abrirá la página Plantillas de consultas de análisis.
3. Opcional: Para previsualizar el SQL de la plantilla, haz clic en Ampliar.
4. Selecciona la plantilla que quieres usar haciendo clic en Usar plantilla o en En blanco para empezar desde cero.
5. Dale un nombre al informe.
6. Escribe o edita la consulta con SQL compatible con BigQuery. Puedes encontrar las tablas y los campos disponibles e insertarlos en tu SQL desde la pestaña Tablas de Google.
7. Opcional: Configura parámetros.
8. Opcional: Configura el resumen de filas excluidas.
9. Haz clic en Guardar.

Parámetros

Los parámetros aportan flexibilidad a las consultas. Por ejemplo, tal vez te interese usar una misma consulta con varias campañas. En lugar de duplicar la consulta o codificar los IDs de campaña en cada consulta antes de ejecutarla, puedes configurar un parámetro que permita introducir esos IDs desde la tarjeta Ejecutar cuando vayas a usarla. Con los parámetros, te ahorrarás líneas innecesarias en el código, evitarás errores al editarlo y podrás reutilizar la consulta sin necesidad de modificarla. Los parámetros se aplican solo a la consulta en la que se han creado, por lo que puedes reutilizar el nombre de un parámetro en otra consulta.

Tipos de parámetro

Se pueden usar los siguientes tipos de parámetro:

• int64
• float64
• bool
• string
• date
• timestamp
• array de cualquiera de los tipos que se pueden usar

Crear un parámetro

1. Abre una consulta guardada o créala.
2. Haz clic en Propiedades > Parámetros > Añadir parámetro.
3. En el campo Nombre, escribe el nombre con el que harás referencia al parámetro en el texto de la consulta.
4. Selecciona el tipo de parámetro en el menú desplegable.
   • Si seleccionas "array" (matriz), aparecerá otro menú desplegable donde deberás elegir el tipo de matriz.
5. Opcional: Repite los pasos del 2 al 4 hasta que hayas añadido todos los parámetros que quieras.
6. Haz clic en "Guardar".

Usar un parámetro

En el texto de la consulta, usa el formato de parámetros SQL estándar, que consiste en escribir @ delante del nombre del parámetro. En el ejemplo siguiente, la consulta contiene un parámetro denominado @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 cuadro de diálogo Nueva tarea incluirá el campo Parámetros. Escribe los valores que quieras en cada parámetro que hayas definido.

Quitar un parámetro

1. Abre la consulta que contenga el parámetro que quieres eliminar.
2. Abre la pestaña Propiedades.
3. En la tarjeta Parámetros, haz clic en Eliminar junto al parámetro correspondiente.
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 usarlos en tus consultas, pero no puedes ponerle esos nombres a ningún parámetro que crees.

start_date	date La fecha de inicio (incluida) de la tarea de consulta. Si hay un parámetro definido por el usuario con este nombre, se pasará por alto y se sustituirá por los valores definidos en el cuadro de diálogo Nueva tarea.
end_date	date La fecha de finalización (incluida) de la tarea de consulta. Si hay un parámetro definido por el usuario con este nombre, se pasará por alto y se sustituirá por los valores definidos en el cuadro de diálogo Nueva tarea.
time_zone	string La zona horaria de la tarea de consulta. Si hay un parámetro definido por el usuario con este nombre, se pasará por alto y se sustituirá por los valores definidos en el cuadro de diálogo Nueva tarea. Consejo: Para evitar discrepancias al utilizar zonas horarias en las consultas, como en las cláusulas WHERE, puedes usar time_zone para que coincida con la zona horaria definida en Nueva tarea. También es importante usar la misma zona horaria que en la fuente de datos.

Resumen de filas excluidas

Los resúmenes de filas excluidas calculan los datos que se han dejado fuera debido a comprobaciones de privacidad. Los datos de las filas excluidas se suman y se añaden a una fila general. Aunque los datos excluidos no se pueden analizar más a fondo, se ve un resumen de cuántos se han excluido de los resultados.

Nota: Los requisitos de agregación también se aplican a los resúmenes de filas excluidas. Si el resumen de filas excluidas resultante no cumple los requisitos de agregación, se dejará fuera el propio resumen de filas excluidas.

Editar una consulta

1. Ve a la pestaña Consultas del Centro de Datos de Anuncios.
2. Haz clic en el nombre de la consulta que quieras modificar.
3. Edita la consulta.
4. Haz clic en Guardar.

Ejecutar una consulta

Importante: Te recomendamos que escribas y pruebes las {consultas} en el entorno aislado antes de ejecutarlas en datos reales. Consulta más prácticas recomendadas para escribir consultas en el Centro de Datos de Anuncios.

Antes de ejecutar una consulta, asegúrate de que hayas dado a la cuenta de servicio el permiso dataEditor para el conjunto de datos que contendrá el resultado de tus uniones. Más información sobre el control de acceso en BigQuery

1. Ve a la pestaña Consultas del Centro de Datos de Anuncios.
2. Haz clic en el nombre de la consulta que quieras ejecutar.
3. Haz clic en Ejecutar.
   • El número esperado de bytes que usará la consulta aparecerá en la parte superior de la página.
4. Selecciona un ID en el menú desplegable Datos sobre anuncios de. Deben ser los datos sobre anuncios del ID asociado a los datos sobre anuncios que quieres consultar. Si quieres consultar datos del entorno aislado, selecciona Cliente de CDA en entorno aislado.
5. Si usas una tabla de coincidencias, selecciónala en el menú desplegable Tabla de coincidencias de.
6. Especifica en qué lugar deben guardarse los resultados de la consulta en el campo Tabla de destino.
7. Introduce las fechas de inicio y de finalización para determinar el periodo de la consulta.
8. Introduce una zona horaria. Debe ser la misma de la plataforma publicitaria.
9. Opcional: Introduce los valores de los parámetros que quieras.
10. Haz clic en Ejecutar.

Ver tus resultados

Una vez que la consulta haya terminado de ejecutarse, podrás previsualizar los resultados en la página "Tareas". También puedes consultar los datos en BigQuery, Hojas de cálculo o Data Studio.

Vista previa

En la tarea completada, haz clic en Vista previa. Los primeros 20 resultados aparecerán debajo de la tarea.

BigQuery

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

Hojas de cálculo y Data Studio

Abre el menú desplegable Examinar y, en las opciones que aparecen, elige Examinar con Hojas de cálculo o Examinar con Data Studio. Los datos se abrirán en una ventana nueva.