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 los trabajos de carga recurrentes para los datos de informe de Google Ads.

Informes compatibles

Por el momento, 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 vistas y tablas del Servicio de transferencia de datos de BigQuery, consulte la página sobre transformaciones de informes de Google Ads.

Para asignar los informes de Google Ads hacia lo que ves en la IU de Google Ads, consulta la página acerca de cómo asignar informes a la IU de Google Ads.

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

v201809

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 qué 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:

Permisos necesarios

Asegúrate de que la persona que crea la transferencia tiene los siguientes permisos necesarios:

  • Servicio de transferencia de datos de BigQuery:

    • Los permisos bigquery.transfers.update para crear la transferencia
    • Los permisos bigquery.datasets.update en el conjunto de datos de destino

    La función predefinida de Cloud IAM bigquery.admin incluye los permisos bigquery.transfers.update y bigquery.datasets.update. Para obtener más información sobre las funciones de Cloud IAM en el Servicio de transferencia de datos de BigQuery, consulta Referencia de control de acceso.

  • Google Ads: acceso de lectura a la cuenta de administrador (MCC) o al ID de cliente de Google Ads usados en la configuración de la transferencia.

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 de Google Ads o la cuenta de administrador (MCC), otorgados por Google Ads. Para obtener información sobre cómo recuperar tu ID de cliente de Google Ads, consulta la página Cómo encontrar su ID de cliente.

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

Console

  1. Ve a Cloud Console.

    Ir a Cloud Console

  2. Haz clic en Transferencias.

  3. Haz clic en Crear transferencia.

  4. En la página Crear transferencia:

    • En la sección Tipo de fuente (Source type), en Fuente (Source), elige Google Ads.

      Fuente de transferencia

    • En la sección Nombre de la configuración de transferencia (Transfer config name), en Nombre visible (Display name), ingresa el nombre de la transferencia, como My Transfer. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si necesitas modificarla más tarde.

      Nombre de la transferencia

    • En la sección Opciones de programa (Schedule options), en Programa, deja el valor predeterminado, Comenzar ahora (Start now), o haz clic en Comenzar a una hora determinada (Start at a set time).

      • En Repeticiones (Repeats), selecciona una opción para la frecuencia con la que se ejecutará la transferencia.

        • Diaria (predeterminada)
        • Semanal
        • Mensual
        • Personalizada
        • A pedido
      • En Fecha de inicio y hora de ejecución (Start date and run time), ingresa la fecha y hora para iniciar la transferencia. Si seleccionas Comenzar ahora (Start now), esta opción se inhabilitará.

        Programa de la transferencia

    • En la sección Configuración de destino (Destination settings), en Conjunto de datos de destino (Destination dataset), selecciona el conjunto de datos que creaste para almacenar tus datos.

      Conjunto de datos de la transferencia

    • En la sección Detalles de fuente de datos (Data source details):

      • En ID de cliente (Customer ID), ingresa tu ID de cliente o cuenta de administrador.
      • Marca Excluir elementos quitados/inhabilitados (Exclude removed/disabled Items) para evitar que se transfieran las entidades y métricas quitadas o inhabilitadas.

        Detalles de la fuente de Google Ads

    • De forma opcional, en la sección Opciones de notificación, haz lo siguiente:

      • Haz clic en el botón de activación para habilitar las notificaciones por correo electrónico. Cuando habilitas esta opción, el administrador de transferencias recibe una notificación por correo electrónico cuando falla una ejecución de transferencia.
      • En Seleccionar un tema de Cloud Pub/Sub (Select a Cloud Pub/Sub topic), elige el nombre de tu tema o haz clic en Crear un tema (Create a topic). Con esta opción, se configuran las notificaciones de ejecución de Pub/Sub para tu transferencia.
  5. Haga clic en Save.

IU clásica

  1. Ve a la IU web clásica de BigQuery.

    Ir a la IU web clásica de BigQuery

  2. Haz clic en Transferencias.

  3. Haz clic en Agregar transferencia.

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

    • En Fuente (Source), selecciona Google Ads (antes AdWords).
    • En Nombre visible (Display name), ingresa un nombre para la transferencia, como My Transfer. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si es necesario hacerle modificaciones más tarde.
    • En Actualizar ventana (Refresh window), ingresa el número de días que se deben incluir en la transferencia de datos. Si ingresas 1, no hay un reabastecimiento diario. Si ingresas 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 la página Acerca de la actualización de sus datos.
    • En Programa (Schedule), deja el valor predeterminado (cada 24 horas al momento de la creación de la transferencia) o haz clic en Editar y cambia la hora.

      Programa de Google Ads

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

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

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

      Transferencia de Google Ads

    • De forma opcional, expande la sección Avanzado (Advanced) y configura las notificaciones de ejecución para tu transferencia.

      • En Tema Cloud Pub/Sub (Cloud Pub/sub topic), ingresa el nombre de tu tema, por ejemplo, projects/myproject/topics/mytopic.
      • Marca Enviar notificaciones por correo electrónico (Send email notifications) para activar las notificaciones por correo electrónico de las ejecuciones de transferencia con errores.
      • No debes marcar Inhabilitado (Disabled) cuando configuras una transferencia. Consulta la sección Trabaja con transferencias para inhabilitar las transferencias existentes.

        Tema de Pub/Sub

  5. Haga clic en Add.

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

    Permitir la transferencia

CLI

Ingresa el comando bq mk y suministra la marca de creación de transferencias --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
    

En el ejemplo anterior, se ilustra lo siguiente:

  • project_id es el ID del proyecto.
  • dataset es el conjunto de datos de destino para la configuración de la transferencia.
  • name es el nombre visible de la configuración de transferencia. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si necesitas modificarla más tarde.
  • parameters contiene los parámetros para la configuración de 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 como true para evitar que se transfieran entidades y métricas quitadas o inhabilitadas.
  • data_source es la fuente de datos: adwords.

Por ejemplo, el siguiente comando crea una transferencia de Google Ads llamada My Transfer mediante el ID del cliente 123-123-1234 y el conjunto de datos de destino 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 similar al 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 individual:

  • 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 MCC alivia los problemas de cuota de carga del Servicio de transferencia de datos de BigQuery porque se cargan varios ID de cliente en el mismo trabajo.

Para obtener más información sobre las cuentas de administrador (MCC) de Google Ads, consulta la página sobre 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 las cuentas particulares de 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 el Servicio de transferencia de datos de BigQuery, consulta la página sobre la 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

Migra datos de Google Ads a MCC

Para migrar tus datos existentes de Google Ads en el Servicio de transferencia de datos de BigQuery a la estructura de MCC, puedes configurar un reabastecimiento para agregar los datos existentes a las tablas creadas por 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 la sección sobre problemas de transferencias de Google Ads en la página sobre la solución de problemas para la configuración de transferencias del Servicio de  transferencia de datos de BigQuery.

Consulta tus datos

Cuando tus datos se transfieren al Servicio de transferencia de datos de 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 de manera automática, debes usar la seudocolumna _PARTITIONTIME en tu consulta. Para obtener más información, lee la sección Consulta tablas particionadas.

Puede usar las siguientes consultas de muestra de Google Ads para analizar los datos transferidos. También puedes usar las consultas en una herramienta de visualización, como Google Data Studio. Estas consultas se proporcionan para ayudarte a comenzar a consultar tus datos de Google Ads con el Servicio de transferencia de datos de 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 con tu nombre de conjunto de datos. Reemplaza customer_id con el ID del cliente de Google Ads.

Si consultas tus tablas directamente en lugar de usar las vistas generadas de manera automática, debes usar la seudocolumna _PARTITIONTIME en tu consulta. Para obtener más información, lee la sección Consulta 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.

Console

    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
    

CLI

    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 usa la función KeywordMatchType. Los tipos de concordancia 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 la página Acerca de las opciones de concordancia de palabras clave.

Console

    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
    

CLI

    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'