Crea y ejecuta informes

En esta guía, se explica cómo crear y ejecutar informes, así como ver los resultados.

Término clave: Una consulta es el texto SQL que constituye la base de un informe. Un informe consta de varios componentes, incluidos los detalles de la consulta, la configuración de entrada y salida, el programa y los detalles de ejecución.

Crea un informe

Los analistas y los superusuarios pueden crear y editar informes. Obtén más información sobre el control de acceso en el Centro de Datos de Anuncios.

Importante: Para evitar perder los cambios, haz clic en Guardar después de realizar cualquier actualización en un informe, incluidas las programaciones.

1. En el Centro de Datos de Anuncios, abre la página Informes.
2. Haz clic en + Crear informe. Se abrirá la página Crear un informe nuevo.
   • Para filtrar plantillas, busca, selecciona íconos de productos y elige opciones desplegables.
3. Elige una plantilla y haz clic en Usar plantilla, o haz clic en SQL para comenzar desde cero.
   • Para obtener una vista previa de los detalles de la plantilla y de SQL, haz clic en expand_content Expandir.
4. Para editar el informe, haz clic en Editar consulta. Usa el editor de consultas para lo siguiente:
   • Personaliza el informe con SQL compatible con BigQuery.
   • Configura los parámetros en la pestaña Properties.
   • Consulta una lista de las tablas y los campos disponibles en la pestaña Tablas de Google.
   • Consulta una lista de las tablas propias importadas y sus esquemas en la pestaña Tablas propias.
   • Haz clic en Ejecutar para ejecutar la consulta de SQL. Ten en cuenta que las ejecuciones que se inician desde el editor de consultas de SQL no contribuyen al historial de ejecución de un informe y no estarán presentes en la sección Actividad reciente de la página Página principal.
   • Haz clic en Listo para confirmar los cambios en la consulta y volver a la página de configuración del informe.
5. Ingresa un nombre para tu informe.
6. Si corresponde, establece los valores de los parámetros en la tarjeta Configuración.
7. Configura la entrada y la salida de los trabajos que se ejecutan en este informe:
   • Selecciona una fuente de datos en el campo Datos de anuncios de. Debe ser el ID de la cuenta del Centro de Datos de Anuncios asociado con los datos de anuncios que deseas consultar. (Si deseas consultar datos de la zona de pruebas, selecciona ADH Sandbox Customer).
   • Si usas una tabla de concordancia, selecciónala en el campo Cuenta de la tabla de concordancia.
   • Selecciona un período y una zona horaria para el informe. La zona horaria del informe debe coincidir con la de la cuenta de anuncios vinculada, como una cuenta de Google Ads. Nota: El rango de fechas personalizado para las pruebas de consultas solo se admite cuando ejecutas la consulta desde la pantalla del editor de SQL.
   • Opcional: Cambia la configuración de privacidad y configura el resumen de filas filtradas.
   • Elige el proyecto, el conjunto de datos y la tabla de BigQuery en los que se deben guardar los resultados del informe.
8. Opcional: Configura el informe para que se ejecute según una programación.
9. Haz clic en Guardar.

---

Parámetros

Los parámetros te permiten especificar cómo se debe ejecutar un informe determinado. Cuando usas SQL para crear un informe (o cuando editas el SQL desde una plantilla de informe), los parámetros te permiten volver a usar el mismo código de SQL en todos los informes y establecer diferentes valores de parámetros en cada copia del informe. Por ejemplo, puedes ejecutar dos informes que comparten la misma consulta o plantilla de SQL en diferentes conjuntos de IDs de campaña configurando un parámetro y estableciendo su valor en la sección Configuración de la página de detalles del informe. El uso de parámetros mantiene limpio tu código SQL, reduce las posibilidades de introducir errores a través de la edición y permite reutilizar la misma consulta de SQL en todos los informes sin editar valores en el SQL.

En el siguiente ejemplo, el informe contiene un parámetro llamado campaign_ids, que acepta un array de IDs de campaña int64:

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

  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

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)

Cómo agregar un parámetro a un informe

1. Abre un informe guardado o crea uno nuevo.
2. Haz clic en Editar consulta.
3. En Propiedades, haz clic en Agregar parámetro.
4. Ingresa un nombre en el campo Nombre. Utilizarás este nombre para hacer referencia al parámetro en el texto del informe.
5. Usa el menú desplegable para seleccionar el tipo de parámetro.
   • Si eliges el tipo de array, aparecerá un menú desplegable adicional. Selecciona el tipo de array en este menú desplegable.
6. En la consulta de SQL, agrega el parámetro con el formato de parámetro de SQL estándar: @PARAMETER_NAME. Consulta el ejemplo que sigue estos pasos.
7. Haz clic en Listo y, luego, en Guardar.

Usa un parámetro

1. Abre un informe que tenga parámetros configurados.
2. En el panel Configuración, ingresa los valores de cada parámetro que definiste.
3. Haz clic en Guardar para conservar los valores de los parámetros.

Cómo quitar un parámetro

1. Abre un informe que tenga parámetros configurados.
2. Haz clic en Editar consulta para abrir el editor de SQL.
3. En Properties, haz clic en Borrar Delete junto al parámetro que quieres borrar.
4. Haz clic en Listo y, luego, en Guardar.

Parámetros reservados

En la siguiente tabla, se enumeran los parámetros reservados por Ads Data Hub. Puedes usar estos parámetros en tus informes, 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 informe. 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 (inclusive) del trabajo de informe. 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 Es la zona horaria del trabajo de informe. Se ignorará un parámetro definido por el usuario con este nombre y se reemplazará por los valores establecidos en el diálogo Tarea nueva. Sugerencia: Para evitar discrepancias cuando uses zonas horarias en tu informe, 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

Nota: Los resúmenes de filas filtradas no son necesarios cuando usas el modo de ruido. Obtén información sobre los beneficios de usar ruido en lugar de verificaciones de diferencias.

Los resúmenes de filas filtradas registran los datos que se filtraron debido a las verificaciones de diferencias. 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. En el caso de las consultas que usan el modo de privacidad de las verificaciones de diferencias, el Centro de Datos de Anuncios habilita y configura automáticamente un resumen de filas filtradas. A medida que edites la consulta, el Centro de Datos de Anuncios ajustará automáticamente la configuración, según las columnas seleccionadas. Para obtener más información sobre los resúmenes de filas filtradas o para configurar uno de forma manual, consulta Resumen de filas filtradas.

---

Cómo editar un informe

1. En el Centro de Datos de Anuncios, abre la página Informes.
2. Haz clic en el nombre del informe que deseas editar.
3. Realiza cambios en el informe. Por ejemplo, edita SQL, administra valores de parámetros o establece un programa.
4. Haz clic en Guardar.

---

Ejecuta un informe

Punto clave: Puedes probar las consultas en SQL 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 un informe, asegúrate de haber otorgado a la cuenta de servicio dataEditor permiso para el conjunto de datos que contendrá el resultado de tus uniones. Obtén más información sobre el control de acceso en BigQuery.

1. En el Centro de Datos de Anuncios, abre la página Informes.
2. Haz clic en el nombre del informe que deseas ejecutar.
3. Haz clic en Ejecutar.

Cómo ejecutar un informe según una programación

1. En el Centro de Datos de Anuncios, abre la página Informes.
2. Haz clic en el nombre del informe para el que deseas establecer una programación.
   • Para establecer un programa para un informe nuevo, créalo y, luego, haz clic en Guardar.
3. Haz clic en + Establecer programación.
4. En el panel Programar, haz clic en el botón de activación Programar este informe para que se ejecute con los siguientes detalles.
5. En Frecuencia, selecciona un intervalo y una hora del día y, luego, ingresa una zona horaria.
   • Para usar una expresión cron, haz clic en el botón de activación Set schedule using a cron expression a la posición de activado y, luego, ingresa la expresión en el cuadro.
6. Haz clic en Listo.
7. Haz clic en Guardar para confirmar los cambios en el informe.

Para mostrar los trabajos programados en la página Principal, selecciona Cualquier persona en la lista de filtros Propietario.

---

Ve los resultados

Cuando se termine de ejecutar el informe, puedes obtener una vista previa de los resultados en la página de detalles del informe. Para ver los resultados en otro momento, abre el informe desde la página principal. 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. Esto abrirá los datos en una ventana nueva.