Transferencias de Google Ads

El Servicio de transferencia de datos de BigQuery para Google Ads (antes conocido como Google AdWords) te permite programar y administrar de forma automática trabajos de carga recurrentes para los datos de informe de Google Ads.

Informes compatibles

Actualmente, el Servicio de transferencia de datos de BigQuery para Google Ads es compatible con las siguientes opciones de informes:

Para obtener información sobre cómo los informes de Google Ads se transforman en tablas y vistas de BigQuery, consulta Transformaciones de informes de Google Ads.

Para mapear los informes de Google Ads hacia lo que ves en la IU de Google Ads, consulta Cómo mapear informes a la IU de Google Ads.

Opción de informe Compatibilidad
Versión de la API compatible

v201806

Para obtener información sobre la migración de la API de Google Ads (API de AdWords), consulta la Guía de migración (v201806).

Programa

Diariamente, en el momento en que se crea por primera vez la transferencia (predeterminado)

Puedes configurar la hora del día.

Período de actualización

Últimos 7 días (predeterminado)

Configurable hasta por 30 días

Se toman instantáneas de las tablas de coincidencias una vez al día y se almacenan en la partición de la última fecha de ejecución. Las instantáneas de la tabla de coincidencias NO se actualizan para los reabastecimientos o para los días cargados a través del período de actualización. Para obtener información sobre cuáles tablas de coincidencias no se actualizan en el período de actualización, consulta Configura un reabastecimiento.

Duración máxima del reabastecimiento

Sin límite

Si bien Google Ads no tiene límites conocidos de retención de datos, el Servicio de transferencia de datos de BigQuery tiene límites sobre cuántos días se pueden solicitar en un solo reabastecimiento. Para obtener más información sobre los reabastecimientos, consulta Configura un reabastecimiento.

Número de ID de clientes por cuenta de administrador

1,000

El Servicio de transferencia de datos de BigQuery admite un máximo de 1,000 ID de clientes por cuenta de administrador (MCC) de Google Ads.

Antes de comenzar

Antes de crear una transferencia de Google Ads:

  • Verifica si completaste todas las acciones necesarias para habilitar el Servicio de transferencia de datos de BigQuery
  • Crea un conjunto de datos de BigQuery para almacenar los datos de Google Ads.
  • Asegúrate de que la persona que crea la transferencia tenga los siguientes permisos obligatorios:
    • Google Ads: Acceso de lectura del ID de cliente o la cuenta de administrador (MCC) de Google Ads utilizada en la configuración de la transferencia.
    • BigQuery: Permisos bigquery.transfers.update para crear la transferencia y permisos bigquery.datasets.update en el conjunto de datos meta. La función de IAM bigquery.admin, predefinida a nivel de proyecto, incluye los permisos bigquery.transfers.update y bigquery.datasets.update. Para obtener más información sobre las funciones de IAM en BigQuery, consulta Control de acceso.
  • Si quieres crear transferencias mediante la IU web de BigQuery, habilita las ventanas emergentes de bigquery.cloud.google.com para que puedas ver la ventana de permisos. Debes permitir que el servicio de transferencia de datos de BigQuery administre tus campañas de Google Ads para que la transferencia tenga éxito.
  • Actualmente, las notificaciones de ejecución de transferencias se encuentran en versión Alpha. Si quieres configurar las notificaciones de ejecución de transferencias para Cloud Pub/Sub, debes tener los permisos pubsub.topics.setIamPolicy. Los permisos de Cloud Pub/Sub no son obligatorios si solo configuras las notificaciones por correo electrónico. Para obtener más información, consulta Notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.

Cómo configurar una transferencia de Google Ads

Para configurar una transferencia de datos para Google Ads se requiere:

  • Un ID de cliente: Tu ID de cliente o cuenta de administrador (MCC) de Google Ads, otorgados por Google Ads. Para obtener información sobre cómo recuperar tu ID de cliente de Google Ads, consulta Encuentra tu ID de cliente.

Para crear una transferencia de datos para los informes de Google Ads:

IU web

  1. Ve a la IU web de BigQuery.

    Ir a la IU web de BigQuery

  2. Haz clic en Transfers (Transferencias).

  3. Haz clic en Add Transfer (Agregar transferencia).

  4. En la página New Transfer (Transferencia nueva):

    • En Source (Fuente), selecciona Google Ads (anteriormente AdWords).
    • En Display name (Nombre visible), ingresa un nombre para la transferencia, como por ejemplo, My Transfer. El nombre de la transferencia puede ser cualquier valor que te permita identificar fácilmente la transferencia si necesitas modificarla más tarde.
    • En Refresh window (Período de actualización), ingresa el número de días que se deben incluir en la transferencia de datos. Si ingresas 1, no hay un reabastecimiento diario. Al ingresar 0 se configura el período de actualización predeterminado de 7 días. El valor máximo es 30. Para obtener más información, consulta Cómo determinar la actualidad de tus datos.
    • En Schedule (Programa), deja el valor predeterminado (cada 24 horas al momento de la creación de la transferencia) o haz clic en Edit (Editar) y cambia la fecha/hora.

      Programa de Google Ads

    • En Destination dataset (Conjunto de datos de destino), selecciona el conjunto de datos que creaste para almacenar tus datos de Google Ads.

    • En Customer ID (ID de cliente), ingresa tu ID de cliente o cuenta de administrador.

    • Marca Exclude removed/disabled Items (Excluir elementos eliminados/inhabilitados) para evitar que se transfieran las entidades y métricas eliminadas o inhabilitadas.

      Transferencia de Google Ads

    • (Opcional) Expande la sección Advanced (Avanzado) y configura las notificaciones de ejecución para tus transferencias. Actualmente, las notificaciones de ejecución de transferencias se encuentran en versión Alpha.

      • En Cloud Pub/Sub topic (Tema de Cloud Sub/Pub), ingresa el nombre de tu tema, por ejemplo, projects/myproject/topics/mytopic.
      • Marca Send email notifications (Enviar notificaciones por correo electrónico) para permitir que se activen las notificaciones por correo electrónico de las ejecuciones de transferencia fallidas.
      • No marques Disabled (Inhabilitado) cuando configures una transferencia. Consulta Cómo trabajar con transferencias para inhabilitar transferencias existentes.

        Tema de Pub/Sub de Cloud

  5. Haz clic en Add (Agregar).

  6. Cuando se te solicite, haz clic en Allow (Permitir) para otorgarle al Servicio de transferencia de datos de BigQuery el permiso para administrar tus datos de informe de Google Ads, y para acceder y administrar los datos en BigQuery. Debes permitir las ventanas emergentes de bigquery.cloud.google.com para ver la ventana de permisos.

    Permitir transferencia

Línea de comandos

Ingresa el comando bq mk y proporciona la marca de creación de la transferencia: --transfer_config. También se requieren las siguientes marcas:

  • --data_source
  • --target_dataset
  • --display_name
  • --params

También puedes proporcionar la marca --project_id para especificar un proyecto en particular. Si no se especifica --project_id, se usa el proyecto predeterminado.

    bq mk --transfer_config --project_id=[PROJECT_ID] --target_dataset=[DATASET] --display_name=[NAME] --params='[PARAMETERS]' --data_source=[DATA_SOURCE]

Donde:

  • --project_id es el ID de tu proyecto.
  • --target_dataset es el conjunto de datos meta para la configuración de la transferencia.
  • --display_name es el nombre visible para la configuración de la transferencia. El nombre de la transferencia puede ser cualquier valor que te permita identificar fácilmente la transferencia si necesitas modificarla más tarde.
  • --params contiene los parámetros para la configuración de la transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}'. Para Google Ads, debes proporcionar el parámetro customer_id. De manera opcional, puedes configurar el parámetro exclude_removed_items en true para evitar que se transfieran las entidades y métricas eliminadas o inhabilitadas.
  • --data_source es la fuente de los datos: adwords.

Por ejemplo, el siguiente comando crea una transferencia de Google Ads llamada My Transfer mediante el ID de cliente 123-123-1234 y el conjunto de datos meta mydataset. La transferencia se crea en el proyecto predeterminado:

bq mk --transfer_config --target_dataset=mydataset --display_name='My Transfer' --params='{"customer_id":"123-123-1234","exclude_removed_items":"true"}' --data_source=adwords

La primera vez que ejecutes el comando, recibirás un mensaje como el siguiente:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Sigue las instrucciones del mensaje y pega el código de autenticación en la línea de comandos.

API

Usa el método projects.locations.transferConfigs.create y proporciona una instancia del recurso TransferConfig.

Asistencia para cuentas de administrador de Google Ads

Se recomienda a los clientes actuales que tienen múltiples transferencias de Google Ads específicas para el ID de cliente que configuren una única transferencia de Google Ads a nivel de cuenta de administrador (MCC), programen un reabastecimiento y también inhabiliten las transferencias de Google Ads individuales específicas para el ID de cliente.

El uso de cuentas de administrador de Google Ads proporciona varios beneficios sobre el uso de ID de cliente individuales:

  • Ya no necesitas administrar varias transferencias para informar sobre múltiples ID de cliente.
  • Las consultas entre clientes son mucho más sencillas de escribir porque todos los ID de cliente se almacenan en la misma tabla.
  • El uso de las MCC alivia los problemas de la cuota de carga de BigQuery porque se cargan múltiples ID de cliente en el mismo trabajo.

Para obtener más información sobre las cuentas de administrador (MCC) de Google Ads, consulta Cómo trabajar con cuentas administradas y Acerca de la vinculación de cuentas a tu cuenta de administrador.

Ejemplo

La siguiente lista muestra los ID de cliente vinculados a cuentas particulares del administrador de Google Ads:

  • 1234567890: cuenta de administrador raíz
    • 1234: cuenta de subadministrador
      • 1111: ID de cliente
      • 2222: ID de cliente
      • 3333: ID de cliente
      • 4444: ID de cliente
      • 567: cuenta de subadministrador
        • 5555: ID de cliente
        • 6666: ID de cliente
        • 7777: ID de cliente
    • 89: cuenta de subadministrador
      • 8888: ID de cliente
      • 9999: ID de cliente
    • 0000: ID de cliente

Cada ID de cliente vinculado a una cuenta de administrador aparece en cada informe. Para obtener más información sobre la estructura de informes de Google Ads en BigQuery, consulta Transformación de informes de Google Ads.

Configuración de transferencia para el ID de cliente 1234567890

Una configuración de transferencia para la cuenta de administrador raíz (ID de cliente 1234567890) podría generar ejecuciones de transferencia que incluyan los siguientes ID de cliente:

  • 1111 (a través de la cuenta de subadministrador 1234)
  • 2222 (a través de la cuenta de subadministrador 1234)
  • 3333 (a través de la cuenta de subadministrador 1234)
  • 4444 (a través de la cuenta de subadministrador 1234)
  • 5555 (a través de la cuenta de subadministrador 567 y la cuenta de subadministrador 1234)
  • 6666 (a través de la cuenta de subadministrador 567 y de la cuenta de subadministrador 1234)
  • 7777 (a través de la cuenta de subadministrador 567 y la cuenta de subadministrador 1234)
  • 8888 (a través de la cuenta de subadministrador 1234)
  • 9999 (a través de la cuenta de subadministrador 89)
  • 0000 (D de cliente individual)

Configuración de transferencia para el ID de cliente 1234

Una configuración de transferencia para la cuenta de subadministrador 123 (ID de cliente 1234) podría generar ejecuciones de transferencia que incluyan los siguientes ID de cliente:

  • 1111
  • 2222
  • 3333
  • 4444
  • 5555 (a través de la cuenta de subadministrador 567)
  • 6666 (a través de la cuenta de subadministrador 567)
  • 7777 (a través de la cuenta de subadministrador 567)

Configuración de transferencia para el ID de cliente 567

Una configuración de transferencia para la cuenta de subadministrador 567 (ID de cliente 567) podría generar ejecuciones de transferencia que incluyan los siguientes ID de cliente:

  • 5555
  • 6666
  • 7777

Configuración de transferencia para el ID de cliente 89

Una configuración de transferencia para la cuenta de subadministrador 89 (ID de cliente 89) podría generar ejecuciones de transferencia que incluyan los siguientes ID de cliente:

  • 8888
  • 9999

Configuración de transferencia para el ID de cliente 0000

Una configuración de transferencia para el ID de cliente 0000 podría generar ejecuciones de transferencia que incluyan solo el ID de cliente individual:

  • 0000

Cómo migrar datos de Google Ads a MCC

Para migrar tus datos actuales de Google Ads en BigQuery a la estructura de MCC, puedes configurar un reabastecimiento para agregar tus datos existentes a las tablas creadas en la configuración de transferencia vinculada a la cuenta de administrador. Ten en cuenta que cuando programas un reabastecimiento, no se actualizan las tablas de coincidencias.

Solución de problemas para la configuración de transferencias de Google Ads

Si tienes problemas para configurar tu transferencia, consulta Problemas de transferencias de Google Ads en la Solución de problemas para la configuración de transferencias del Servicio de transferencia de datos de BigQuery.

Cómo consultar tus datos

Cuando tus datos se transfieren a BigQuery, los datos se escriben en tablas particionadas en tiempo de transferencia. Para obtener más información, consulta Introducción a las tablas particionadas.

Si consultas tus tablas directamente en lugar de usar las vistas generadas automáticamente, debes usar la pseudocolumna _PARTITIONTIME en tu consulta. Para obtener más información, consulta Cómo consultar tablas particionadas.

Puede utilizar las siguientes consultas de muestra de Google Ads para analizar los datos transferidos. También puedes utilizar las consultas en una herramienta de visualización como Cloud Datalab o Google Data Studio. Estas consultas se proporcionan para ayudarte a comenzar a consultar tus datos de Google Ads con BigQuery. Si tienes preguntas adicionales sobre lo que puedes hacer con estos informes, contacta a tu representante técnico de Google Ads.

En cada una de las siguientes consultas, reemplaza [DATASET] por el nombre de tu conjunto de datos. Reemplaza [CUSTOMER_ID] por tu ID de cliente de Google Ads.

Estas muestras utilizan la asistencia de BigQuery para SQL estándar. Usa la etiqueta #standardSQL para permitir que BigQuery sepa que deseas utilizar SQL estándar. Para obtener más información sobre el prefijo #standardSQL, consulta Cómo configurar un prefijo de consulta.

Si consultas tus tablas directamente en lugar de usar las vistas generadas automáticamente, debes usar la pseudocolumna _PARTITIONTIME en tu consulta. Para obtener más información, consulta Cómo consultar tablas particionadas.

Rendimiento de campañas

La siguiente consulta de muestra analiza el rendimiento de las campañas de Google Ads para los últimos 30 días.

IU web

#standardSQL
SELECT
  c.ExternalCustomerId,
  c.CampaignName,
  c.CampaignStatus,
  SUM(cs.Impressions) AS Impressions,
  SUM(cs.Interactions) AS Interactions,
  (SUM(cs.Cost) / 1000000) AS Cost
FROM
  `[DATASET].Campaign_[CUSTOMER_ID]` c
LEFT JOIN
  `[DATASET].CampaignBasicStats_[CUSTOMER_ID]` cs
ON
  (c.CampaignId = cs.CampaignId
   AND cs._DATA_DATE BETWEEN
   DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
WHERE
  c._DATA_DATE = c._LATEST_DATE
GROUP BY
  1, 2, 3
ORDER BY
  Impressions DESC

Línea de comandos

bq query --use_legacy_sql=false '
SELECT
  c.ExternalCustomerId,
  c.CampaignName,
  c.CampaignStatus,
  SUM(cs.Impressions) AS Impressions,
  SUM(cs.Interactions) AS Interactions,
  (SUM(cs.Cost) / 1000000) AS Cost
FROM
  `[DATASET].Campaign_[CUSTOMER_ID]` c
LEFT JOIN
  `[DATASET].CampaignBasicStats_[CUSTOMER_ID]` cs
ON
  (c.CampaignId = cs.CampaignId
   AND cs._DATA_DATE BETWEEN
   DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
WHERE
  c._DATA_DATE = c._LATEST_DATE
GROUP BY
  1, 2, 3
ORDER BY
  Impressions DESC'

Recuento de palabras clave

La siguiente consulta de muestra analiza las palabras clave por campaña, grupo de anuncios y estado de las palabras clave. Esta consulta utiliza la función KeywordMatchType. Los tipos de coincidencia de palabras clave te ayudan a controlar cuáles son las búsquedas que activan la publicación de tu anuncio. Para obtener más información sobre las opciones de coincidencia de palabras clave, consulta Acerca de las opciones de coincidencia de palabras clave.

IU web

#standardSQL
SELECT
  c.CampaignStatus AS CampaignStatus,
  a.AdGroupStatus AS AdGroupStatus,
  k.Status AS KeywordStatus,
  k.KeywordMatchType AS KeywordMatchType,
  COUNT(*) AS count
FROM
  `[DATASET].Keyword_[CUSTOMER_ID]` k
  JOIN
  `[DATASET].Campaign_[CUSTOMER_ID]` c
ON
  (k.CampaignId = c.CampaignId AND k.DATA_DATE = c._DATA_DATE)
JOIN
  `[DATASET].AdGroup[CUSTOMER_ID]` a
ON
  (k.AdGroupId = a.AdGroupId AND k._DATA_DATE = a._DATA_DATE)
WHERE
  k._DATA_DATE = k._LATEST_DATE
GROUP BY
  1, 2, 3, 4

Línea de comandos

bq query --use_legacy_sql=false '
SELECT
  c.CampaignStatus AS CampaignStatus,
  a.AdGroupStatus AS AdGroupStatus,
  k.Status AS KeywordStatus,
  k.KeywordMatchType AS KeywordMatchType,
  COUNT(*) AS count
FROM
  `[DATASET].Keyword_[CUSTOMER_ID]` k
JOIN
  `[DATASET].Campaign_[CUSTOMER_ID]` c
ON
  (k.CampaignId = c.CampaignId AND k._DATA_DATE = c._DATA_DATE)
JOIN
  `[DATASET].AdGroup_[CUSTOMER_ID]` a
ON
  (k.AdGroupId = a.AdGroupId AND k._DATA_DATE = a._DATA_DATE)
WHERE
  k._DATA_DATE = k._LATEST_DATE
GROUP BY
  1, 2, 3, 4'
¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.