Escribir y ejecutar informes

Término clave: las consultas ahora se llaman informes. Puede que veas estos términos indistintamente en la UI y en la documentación mientras todo cambia para usar informes.

Crear un informe

Nota: No todos los usuarios pueden crear y editar informes. 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 Crea un informe.
3. Opcional: Aplica filtros a las plantillas haciendo búsquedas, seleccionando iconos y eligiendo cualesquiera de las siguientes opciones del menú desplegable.
   • Fuente de datos
   • Caso práctico
   • Inventario
   • Acreditadas por el MRC
4. Opcional: Obtén una vista previa de los detalles de la plantilla y del SQL haciendo clic en expand_content Mostrar.
5. Selecciona la plantilla que quieres usar haciendo clic en Usar plantilla o en add_circle Añadir para empezar desde cero.
6. Dale un nombre al informe.
7. Escribe o edita el informe 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.
8. Opcional: Configura parámetros.
9. Opcional: Configura el resumen de filas excluidas.
10. Haz clic en Guardar.

Parámetros

Los parámetros aportan flexibilidad a los informes. Por ejemplo, tal vez te interese ejecutar un mismo informe en varias campañas. En lugar de duplicar el informe o codificar los IDs de campaña en cada informe antes de ejecutarlo, puedes configurar un parámetro que permita introducir esos IDs desde la tarjeta Ejecutar cuando vayas a usarlo. Con los parámetros, te ahorrarás líneas innecesarias en el código, evitarás errores al editarlo y podrás reutilizar el informe sin necesidad de modificarlo. Los parámetros se aplican solo al informe en el que se han creado, por lo que puedes reutilizar el nombre de un parámetro en otro informe.

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 un informe guardado o créalo.
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 del informe.
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 del informe, usa el formato de parámetros SQL estándar, que consiste en escribir @ delante del nombre del parámetro. En el ejemplo siguiente, el informe 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 el informe que contiene 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 informes, pero no puedes ponerle esos nombres a ningún parámetro que crees.

start_date	date La fecha de inicio (incluida) del trabajo del informe. 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) del trabajo del informe. 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 Zona horaria de la tarea del informe. 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 los informes, 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 un informe

1. Accede a la pestaña Consultas del Centro de Datos de Anuncios.
2. Haz clic en el nombre del informe que quieres editar.
3. Edita el informe.
4. Haz clic en Guardar.

Ejecutar un informe

Importante: Debes escribir y probar los informes en el entorno aislado antes de ejecutarlos en datos reales. Consulta más prácticas recomendadas para escribir informes en el Centro de Datos de Anuncios.

Antes de ejecutar un informe, 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. Accede a la pestaña Consultas del Centro de Datos de Anuncios.
2. Haz clic en el nombre del informe que quieres ejecutar.
3. Haz clic en Ejecutar.
   • El número esperado de bytes que usará el informe se muestra 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 del informe en el campo Tabla de destinos.
7. Introduce las fechas de inicio y de finalización para determinar el periodo del informe.
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 los resultados

Una vez que el informe 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.