Transferencias de Search Ads 360

El Servicio de transferencia de datos de BigQuery para el conector de Search Ads 360 te permite administrar y programar de manera automática trabajos de carga recurrentes para los datos de informes de Search Ads 360.

Informes compatibles

El Servicio de transferencia de datos de BigQuery para Search Ads 360 es compatible con la API de Search Ads 360 Reporting v0:

• Informes de Search Ads 360 v0

Para obtener información sobre cómo los informes de Search Ads 360 se transforman en vistas y tablas del Servicio de transferencia de datos de BigQuery, consulta la página sobre las transformaciones de informes de Search Ads 360.

Opción de informe	Asistencia
Versión de la API compatible	v0
Frecuencia de repetición	Diariamente, en el momento en que se crea por primera vez la transferencia de datos (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.
Duración máxima del reabastecimiento	Sin límite
Número de IDs de clientes por cuenta de administrador	2,000 El Servicio de transferencia de datos de BigQuery admite un máximo de 2,000 IDs de clientes para cada cuenta de administrador de Search Ads 360.

Para ver la guía de transferencia de Search Ads 360 que usa la API de informes anterior de Search Ads 360, consulta Transferencias de Search Ads 360 (obsoleta).

Transferencia de datos de transferencias de Search Ads 360

Cuando transfieres datos de Search Ads 360 a BigQuery, estos se cargan en tablas de BigQuery particionadas por fecha. La partición de la tabla en la que se cargan los datos corresponde a la fecha de la fuente de datos. Si programas varias transferencias para la misma fecha, el Servicio de transferencia de datos de BigQuery reemplaza la partición para esa fecha específica con los datos más recientes. Las transferencias múltiples en el mismo día o los reabastecimientos en ejecución no generan datos duplicados y las particiones para otras fechas no se ven afectadas.

Períodos de actualización

El período de actualización se refiere a la cantidad de días durante los cuales una transferencia de datos recupera datos cuando se produce la transferencia. Por ejemplo, si el período de actualización es de tres días y se produce una transferencia diaria, el Servicio de transferencia de datos de BigQuery recuperará todos los datos de tu tabla de origen de los últimos tres días. En este ejemplo, cuando se produce una transferencia diaria, el Servicio de transferencia de datos de BigQuery crea una nueva partición de tabla de destino de BigQuery con una copia de los datos de la tabla de origen del día actual y, luego, activa automáticamente las ejecuciones de reabastecimiento para actualizar las particiones de la tabla de destino de BigQuery con los datos de la tabla de origen de los últimos dos días. Las ejecuciones de reabastecimiento activadas automáticamente reemplazarán o actualizarán de forma incremental tu tabla de destino de BigQuery, en base a si las actualizaciones incrementales son compatibles o no con el conector del Servicio de transferencia de datos de BigQuery.

Cuando ejecutas una transferencia de datos por primera vez, la transferencia de datos recupera todos los datos de origen disponibles dentro del período de actualización. Por ejemplo, si el período de actualización es de tres días y ejecutas la transferencia de datos por primera vez, el Servicio de transferencia de datos de BigQuery recupera todos los datos de origen en un plazo de tres días.

Las ventanas de actualización se asignan al campo de API TransferConfig.data_refresh_window_days.

Para recuperar datos fuera del período de actualización, como datos históricos, o para recuperar datos de interrupciones o brechas de transferencia, puedes iniciar o programar una ejecución de reabastecimiento.

Limitaciones

• La frecuencia máxima para la que puedes configurar una transferencia de datos de Search Ads 360 es una vez cada 24 horas. De forma predeterminada, una transferencia comienza en el momento en que creas la transferencia. Sin embargo, puedes configurar la hora de inicio cuando creas la transferencia.
• El Servicio de transferencia de datos de BigQuery no admite transferencias incrementales durante una transferencia de datos de Search Ads 360. Cuando especificas una fecha para una transferencia de datos, se transfieren todos los datos disponibles para esa fecha.

Antes de comenzar

Antes de crear una transferencia de datos de Search Ads 360, haz lo siguiente:

• Verifica si completaste todas las acciones necesarias para habilitar el Servicio de transferencia de datos de BigQuery
• Crea un conjunto de datos del Servicio de transferencia de datos de BigQuery para almacenar los datos de Search Ads 360.
• Si quieres configurar las notificaciones de ejecución de transferencias para Pub/Sub, debes tener los permisos pubsub.topics.setIamPolicy. Los permisos de Pub/Sub no son necesarios si solo configuras las notificaciones por correo electrónico. Para obtener más información, consulta la sección sobre notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.
• Habilita el acceso a la API de Search Ads 360 Reporting en tu proyecto.

Permisos necesarios

Asegúrate de que el usuario que crea la transferencia de datos tenga los siguientes permisos requeridos.

• Servicio de transferencia de datos de BigQuery:

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

  El rol predefinido de IAM bigquery.admin incluye los permisos bigquery.transfers.update, bigquery.datasets.update y bigquery.datasets.get. Para obtener más información sobre los roles de IAM en el Servicio de transferencia de datos de BigQuery, consulta Control de acceso.

• Google Cloud:

  • Los permisos serviceusage.services.use para descargar datos de Search Ads 360 en el proyecto

  Los roles de IAM predefinidos editor, owner y serviceusage.serviceUsageConsumer incluyen los permisos serviceusage.services.use. Para obtener más información sobre los roles de IAM en Service Usage, consulta Referencia de control de acceso.

• Search Ads 360:

  • Acceso de lectura a la cuenta de administrador o el ID de cliente de Search Ads 360 que se usa en la configuración de la transferencia.

Crea una transferencia de datos de Search Ads 360

Si quieres crear una transferencia de datos para los informes de Search Ads 360, necesitas tu ID de cliente de Search Ads 360 o tu cuenta de administrador. Selecciona una de las opciones siguientes:

Console

1. Ve a la página Transferencia de datos en la consola de Google Cloud.

   Ir a Transferencias de datos

2. Haz clic en Crear transferencia.

3. En la sección Tipo de fuente, para Fuente, elige Search Ads 360.

4. En la sección Nombre de la configuración de transferencia (Transfer config name), en Nombre visible, ingresa el nombre de la transferencia de datos, 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.

5. En la sección Opciones de programación, haz lo siguiente:

   • En Frecuencia de repetición, elige una opción para la frecuencia con la que se ejecutará la transferencia de datos. Si seleccionas Días, proporciona una hora válida en UTC.
     • Horas
     • Días
     • A pedido
   • Si corresponde, selecciona Comenzar ahora o Comenzar a una hora determinada y proporciona una fecha de inicio y una hora de ejecución.

6. En la sección Configuración de destino, en Conjunto de datos, selecciona el conjunto de datos que creaste para almacenar tus datos.

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

   2. En ID de cliente, ingresa tu ID de cliente de Search Ads 360:

   3. Opcional: Ingresa un ID de agencia y un ID del anunciante para recuperar las tablas de asignación de ID.

   4. Opcional: En el campo Variables de Floodlight personalizadas, ingresa cualquier variable de Floodlight personalizada para incluir en la transferencia de datos. Las variables de Floodlight personalizadas deben pertenecer a la cuenta de Search Ads 360 que especifique el ID de cliente en la configuración de la transferencia. Este parámetro toma entradas de cadena en formato de array JSON y puede admitir múltiples variables personalizadas de Floodlight. En cada elemento del array JSON, se requieren los siguientes parámetros:

      • id: el ID numérico de la variable personalizada de Floodlight. Este ID se asigna cuando se crea una variable de Floodlight personalizada en Search Ads 360. Si especificaste un id, no se requiere un valor name.
      • name: Es el nombre definido por el usuario de las variables de Floodlight personalizadas en Search Ads 360. Si especificaste un name, no se requiere un id.
      • cfv_field_name: el nombre exacto del campo de la variable de Floodlight personalizada según tu caso de uso. Los valores admitidos son conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics y raw_event_conversion_dimensions.
      • destination_table_name: una lista de tablas de BigQuery en las que se incluirán las variables de Floodlight personalizadas. Cuando el Servicio de transferencia de datos de BigQuery recupera datos para estas tablas, la transferencia incluye las variables de Floodlight personalizadas en la consulta.

      • bigquery_column_name_suffix: el nombre amigable de columna definido por el usuario. El Servicio de transferencia de datos de BigQuery agrega el sufijo después del nombre del campo estándar para distinguir las diferentes variables de Floodlight personalizadas. Según el caso de uso, el Servicio de transferencia de datos de BigQuery genera un nombre de columna de BigQuery de la siguiente manera:

        	Variables personalizadas de Floodlight como métricas y segmentos	Variables personalizadas de Floodlight como atributos de evento sin procesar en el recurso de conversión
        metrics	metrics_conversion_custom_metrics_bigquery_column_name_suffix	metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
        dimension	segments_conversion_custom_dimensions_bigquery_column_name_suffix	segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

      A continuación, se incluye una entrada de ejemplo de Variable de Floodlight personalizada que especifica dos variables personalizadas de Floodlight:

      [{
        "id": "1234",
        "cfv_field_name": "raw_event_conversion_metrics",
        "destination_table_name": ["Conversion"],
        "bigquery_column_name_suffix": "suffix1"
      },{
        "name": "example name",
        "cfv_field_name": "conversion_custom_metrics",
        "destination_table_name": ["AdGroupConversionActionAndDeviceStats","CampaignConversionActionAndDeviceStats"],
        "bigquery_column_name_suffix": "suffix2"
      }]

   5. Opcional: En el campo Columnas personalizadas, ingresa cualquier columna personalizada para incluir en la transferencia de datos. Las columnas personalizadas deben pertenecer a la cuenta de Search Ads 360 que especifique el ID de cliente en la configuración de la transferencia. Este campo toma entradas de cadena en formato de array JSON y puede admitir varias columnas. En cada elemento del array JSON, se requieren los siguientes parámetros:

      • id: el ID numérico de la columna personalizada. Este ID se asigna cuando se crea una columna personalizada. Si especificaste un id, no se requiere un valor name.
      • name: el nombre definido por el usuario de la columna personalizada en Search Ads 360. Si especificaste un name, no se requiere un id.
      • destination_table_name: una lista de tablas de BigQuery en las que se incluirá la columna personalizada. Cuando el Servicio de transferencia de datos de BigQuery recupera los datos de estas tablas, la transferencia incluye el campo de columna personalizada en la consulta.
      • bigquery_column_name: el nombre amigable de columna definido por el usuario. Este es el nombre del campo de la columna personalizada en las tablas de destino especificadas en destination_table_name. El nombre de la columna debe seguir los requisitos de formato para los nombres de columnas de BigQuery y debe ser único para otros campos del esquema estándar de la tabla u otros tipos de columnas personalizadas.

      A continuación, se muestra un ejemplo de una entrada Columnas personalizadas que especifica dos columnas personalizadas:

        [{
          "id": "1234",
          "destination_table_name": ["Conversion"],
          "bigquery_column_name": "column1"
        },{
          "name": "example name",
          "destination_table_name": ["AdGroupStats","CampaignStats"],
          "bigquery_column_name": "column2"
        }]
        

   6. Opcional: En el campo Filtro de tabla, ingresa una lista de tablas separadas por comas para incluir, por ejemplo, Campaign, AdGroup. Agrega el prefijo - a esta lista para excluir ciertas tablas, por ejemplo -Campaign, AdGroup. Todas las tablas se incluyen de forma predeterminada.

   7. Opcional: En Período de actualización, ingresa un valor entre 1 y 30. Si no se configura, el período de actualización se establece de forma predeterminada en 7 días.

7. En el menú Cuenta de servicio, selecciona una cuenta de servicio de las cuentas de servicio asociadas a tu proyecto de Google Cloud. Puedes asociar una cuenta de servicio con tu transferencia en lugar de usar tus credenciales de usuario. Para obtener más información sobre el uso de cuentas de servicio con transferencias de datos, consulta Usa cuentas de servicio.

   • Si accediste con una identidad federada, se requiere una cuenta de servicio para crear una transferencia. Si accediste con una Cuenta de Google, la cuenta de servicio para la transferencia es opcional.
   • La cuenta de servicio debe tener los permisos necesarios.

8. Opcional: En la sección Opciones de notificación:

   • 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.

   • Haz clic en el botón de activación para habilitar las notificaciones de Pub/Sub. Para Selecciona un tema de Cloud Pub/Sub, elige el nombre de tu tema o haz clic en Crear un tema. Esta opción configura las notificaciones de ejecución de Pub/Sub para tu transferencia.

9. Haz clic en Guardar.

bq

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

Las siguientes marcas son opcionales:

• --project_id: Especifica qué proyecto usar. Si no se especifica la marca, se usa el proyecto predeterminado.
• --service_account_name: Especifica una cuenta de servicio que se usará para la autenticación de la transferencia de Search Ads 360 en lugar de tu cuenta de usuario.

bq mk \
--transfer_config \
--project_id=PROJECT_ID \
--target_dataset=DATASET \
--display_name=NAME \
--data_source=DATA_SOURCE \
--service_account_name=SERVICE_ACCOUNT_NAME \
--params='{PARAMETERS,"custom_columns":"[{\"id\": \"CC_ID\",\"destination_table_name\": [\"CC_DESTINATION_TABLE\"],\"bigquery_column_name\": \"CC_COLUMN\"}]","custom_floodlight_variables":"[{\"id\": \"CFV_ID\",\"cfv_field_name\": [\"CFV_FIELD_NAME\"],\"destination_table_name\": [\"CFV_DESTINATION_TABLE\"],\"bigquery_column_name_suffix\": \"CFV_COLUMN_SUFFIX\"}]"}'

Aquí:

• PROJECT_ID (Opcional): especifica qué proyecto usar. Si no se especifica la marca, se usa el proyecto predeterminado.
• DATASET es el conjunto de datos de destino para la configuración de transferencia.

• NAME es el nombre visible de la configuración de transferencia. El nombre de la transferencia de datos puede ser cualquier valor que te permita identificarla si es necesario hacerle modificaciones más tarde.

• DATA_SOURCE: La fuente de datos: search_ads.

• SERVICE_ACCOUNT_NAME (Opcional): el nombre de la cuenta de servicio que se usa para autenticar tu transferencia de datos. La cuenta de servicio debe ser propiedad del mismo project_id que se usa para crear la transferencia y debe tener todos los permisos necesarios.

• PARAMETERS son los parámetros de la configuración de transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}' Debes proporcionar el parámetro customer_id.

  • table_filter: Especifica qué tablas se deben incluir en la transferencia de datos. Si no se especifica la marca, se incluyen todas las tablas. Para incluir solo tablas específicas, usa una lista de valores separados por comas (por ejemplo, Ad, Campaign, AdGroup). Para excluir tablas específicas, agrega un prefijo a los valores excluidos con un guion (-) (por ejemplo, si usas -Ad, Campaign, AdGroup, se excluyen los tres valores).
  • custom_columns: especifica columnas personalizadas para tus informes. Este parámetro toma entradas de cadena en formato de array JSON y puede admitir varias columnas. En cada elemento del array JSON, se requieren los siguientes parámetros:
    • CC_ID: el ID numérico de la columna personalizada. Este ID se asigna cuando se crea una columna personalizada.
    • CC_DESTINATION_TABLE: una lista de tablas de BigQuery en la que se incluirá la columna personalizada. Cuando el Servicio de transferencia de datos de BigQuery recupera los datos de estas tablas, la transferencia de datos incluye el campo de columna personalizada en la consulta.
    • CC_COLUMN: el nombre amigable de columna definido por el usuario. Este es el nombre del campo de la columna personalizada en las tablas de destino especificadas en destination_table_name. El nombre de la columna debe seguir los requisitos de formato para los nombres de columnas de BigQuery y debe ser único para otros campos del esquema estándar de la tabla u otros tipos de columnas personalizadas.
  • custom_floodlight_variables: Especifica las variables de Floodlight personalizadas en tu transferencia. Este parámetro toma entradas de cadena en formato de array JSON y puede admitir múltiples variables personalizadas de Floodlight. En cada elemento del array JSON, se requieren los siguientes parámetros:
    • CFV_ID: el ID numérico de la variable personalizada de Floodlight. Este ID se asigna cuando se crea una variable de Floodlight personalizada en Search Ads 360.
    • CFV_FIELD_NAME: el nombre exacto del campo de la variable de Floodlight personalizada según tu caso de uso. Los valores admitidos son conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics y raw_event_conversion_dimensions. Para obtener más información, consulta Métricas personalizadas de Floodlight.
    • CFV_DESTINATION_TABLE: una lista de tablas de BigQuery en las que se incluirán las variables de Floodlight personalizadas. Cuando el Servicio de transferencia de datos de BigQuery recupera datos para estas tablas, la transferencia de datos incluye las variables de Floodlight personalizadas en la consulta.
    • CFV_COLUMN_SUFFIX: el nombre amigable de columna definido por el usuario. El Servicio de transferencia de datos de BigQuery agrega el sufijo después del nombre del campo estándar para distinguir las diferentes variables de Floodlight personalizadas. Según el caso de uso, el Servicio de transferencia de datos de BigQuery genera un nombre de columna de BigQuery de la siguiente manera:

  	Variables personalizadas de Floodlight como métricas y segmentos	Variables personalizadas de Floodlight como atributos de evento sin procesar en el recurso de conversión
  metrics	metrics_conversion_custom_metrics_bigquery_column_name_suffix	metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
  dimension	segments_conversion_custom_dimensions_bigquery_column_name_suffix	segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

Precaución: No se puede configurar notificaciones mediante la herramienta de línea de comandos.

Por ejemplo, el siguiente comando crea una transferencia de datos de Search Ads 360 llamada My Transfer mediante el ID de cliente 6828088731 y el conjunto de datos de destino mydataset. La transferencia también especifica una variable de Floodlight personalizada. La transferencia de datos se crea en el proyecto predeterminado:

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--data_source=search_ads \
--params='{"customer_id":"6828088731", "custom_floodlight_variables":"[{\"id\": \"9876\", \"cfv_field_name\": \"raw_event_conversion_metrics\", \"destination_table_name\": [\"Conversion\"],\"bigquery_column_name_suffix\": \"suffix1\" }]"}'

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.

Precaución: Cuando creas una transferencia de datos de Search Ads 360 con la herramienta de línea de comandos, la configuración de transferencia se configura con los valores predeterminados de Programa (cada 24 horas en el momento de la creación) y Período de actualización (0: configura el período de actualización predeterminado de 7 días).

API

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

Activa una transferencia de Search Ads 360 de forma manual

Cuando activas de forma manual una transferencia para Search Ads 360, las instantáneas de las tablas de coincidencia se toman una vez al día y se almacenan en la partición de la última fecha de ejecución. Cuando activas una transferencia manual, no se actualizan las instantáneas de la tabla de coincidencia para las siguientes tablas:

• Cuenta
• Anuncio
• AdGroup
• AdGroupCriterion
• Cualquier tabla de asignación de ID
• Recurso
• BidStrategy
• Campaña
• CampaignCriterion
• ConversionAction
• Palabra clave
• NegativeAdGroupKeyword
• NegativeAdGroupCriterion
• NegativeCampaignKeyword
• NegativeCampaignCriterion
• ProductGroup

Compatibilidad con cuentas de administrador de Search Ads 360

El uso de cuentas de administrador de Search Ads 360 proporciona varios beneficios sobre el uso de IDs de cliente individual:

• No es necesario que administres varias transferencias de datos para informar sobre múltiples IDs de cliente.
• Las consultas entre clientes son más fáciles de escribir porque todos los IDs de cliente se almacenan en la misma tabla.
• El uso de cuentas de administrador alivia los problemas de cuota de carga del Servicio de transferencia de datos de BigQuery porque se cargan varios IDs de cliente en el mismo trabajo.

Para los clientes existentes que tienen varias transferencias de datos de Search Ads 360 específicas del ID de cliente, te recomendamos que cambies a una cuenta de administrador de Search Ads 360. Puedes hacerlo con los siguientes pasos:

1. Configura una sola transferencia de datos de Search Ads 360 a nivel de la cuenta de administrador o de subadministrador.
2. Programa un reabastecimiento.
3. Inhabilita las transferencias individuales de Search Ads 360 específicas de ID de cliente.

Para obtener más información sobre las cuentas de administrador de Search Ads 360, consulta Acerca de las cuentas de administrador en la nueva experiencia de Search Ads 360 y consulta cómo se vinculan las cuentas con su cuenta de administrador.

Nota: El Servicio de transferencia de datos de BigQuery extrae informes para todos los IDs de cliente de la lista, pero es probable que no los veas en tus informes si estos no presentan actividad el día solicitado.

Ejemplo

La siguiente lista muestra los ID de cliente vinculados a las cuentas particulares de administrador de Search Ads 360:

• 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 Search Ads 360 en el Servicio de transferencia de datos de BigQuery, consulta la página sobre la transformación de informes de Search Ads 360.

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 de datos que incluyan los siguientes IDs 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 de datos que incluyan los siguientes IDs 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 de datos que incluyan los siguientes IDs 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 de datos que incluyan los siguientes IDs de cliente:

• 8888
• 9999

Configuración de transferencia para el ID de cliente 0000

Una configuración de transferencia de datos para el ID de cliente 0000 genera ejecuciones de transferencia que incluyen solo el ID de cliente individual:

• 0000

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, visita la página Consulta tablas particionadas.

Consultas de muestra de Search Ads 360

Puedes usar las siguientes consultas de muestra de Search Ads 360 para analizar los datos transferidos. También puedes ver las consultas en una herramienta de visualización, como Looker Studio.

Las siguientes consultas son ejemplos para comenzar a consultar tus datos de Search Ads 360 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 Search Ads 360.

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, visita la página Consulta tablas particionadas.

Rendimiento de la campaña

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

SELECT
  c.customer_id,
  c.campaign_name,
  c.campaign_status,
  SUM(cs.metrics_clicks) AS Clicks,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost,
  SUM(cs.metrics_impressions) AS Impressions
FROM
  `DATASET.sa_Campaign_CUSTOMER_ID` c
LEFT JOIN
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
ON
  (c.campaign_id = cs.campaign_id
  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

Reemplaza lo siguiente:

• DATASET: El nombre del conjunto de datos.
• CUSTOMER_ID: El ID de cliente de Search Ads 360

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.

  SELECT
    c.campaign_status AS CampaignStatus,
    a.ad_group_status AS AdGroupStatus,
    k.ad_group_criterion_status AS KeywordStatus,
    k.ad_group_criterion_keyword_match_type AS KeywordMatchType,
    COUNT(*) AS count
  FROM
    `DATASET.sa_Keyword_CUSTOMER_ID` k
    JOIN
    `DATASET.sa_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.sa_AdGroup_CUSTOMER_ID` a
  ON
    (k.ad_group_id = a.ad_group_id AND k._DATA_DATE = a._DATA_DATE)
  WHERE
    k._DATA_DATE = k._LATEST_DATE
  GROUP BY
    1, 2, 3, 4

Reemplaza lo siguiente:

• DATASET: El nombre del conjunto de datos.
• CUSTOMER_ID: El ID de cliente de Search Ads 360

Tablas de asignación de ID

Las entidades en la nueva experiencia de Search Ads 360, como los clientes, las campañas y los grupos de anuncios, tienen un espacio de ID diferente al de la versión anterior. Para los usuarios existentes de la transferencia de Search Ads 360 que deseen combinar datos de la experiencia anterior de Search Ads 360 con la nueva API de Search Ads 360, puedes usar el Servicio de transferencia de datos de BigQuery para transferir tablas de asignación de ID si proporcionas un ID de agencia y un ID de anunciante válidos en la configuración de la transferencia.

Las entidades admitidas contienen dos columnas, legacy_id y new_id, que especifican la asignación de ID para entidades en versiones anteriores y nuevas de Search Ads 360, respectivamente. Para las entidades AD, CAMPAIGN_CRITERION y CRITERION, también se proporciona un valor new_secondary_id, ya que estas entidades no tienen ID únicos a nivel global en la nueva experiencia de Search Ads 360. La siguiente es una lista de tablas de asignación de ID.

• IdMapping_AD
• IdMapping_AD_GROUP
• IdMapping_CAMPAIGN
• IdMapping_CAMPAIGN_CRITERION
• IdMapping_CAMPAIGN_GROUP
• IdMapping_CAMPAIGN_GROUP_PERFORMANCE_TARGET
• IdMapping_CRITERION
• IdMapping_CUSTOMER
• IdMapping_FEED_ITEM
• IdMapping_FEED_TABLE

Nota: Al igual que con las tablas que coinciden, las instantáneas de las tablas de asignación de ID se toman una vez al día y se almacenan en la partición para la última fecha de ejecución. Las instantáneas de la tabla de asignación de ID no se actualizan para los reabastecimientos o para los días cargados a través del período de actualización.

Consultas de ejemplo

La siguiente consulta usa las tablas de asignación de ID para agregar métricas por campaña en las tablas de transferencias de datos anteriores y nuevas de Search Ads 360 en el espacio de ID nuevo.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  cs.customer_id AS CustomerID,
  cs.campaign_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  customer_id_mapping.new_id AS CustomerID,
  campaign_id_mapping.new_id AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.accountId = customer_id_mapping.legacy_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaignId = campaign_id_mapping.legacy_id
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Reemplaza lo siguiente:

• DATASET: El nombre del conjunto de datos.
• CUSTOMER_ID: El ID de cliente de Search Ads 360
• ADVERTISER_ID: El ID del anunciante de Search Ads 360
• NEW_DATA_DATE: La fecha de los datos de la nueva tabla de Search Ads 360
• OLD_DATA_DATE: La fecha de los datos de la tabla anterior de Search Ads 360

La siguiente consulta usa las tablas de asignación de ID para agregar métricas por campaña en las tablas de transferencias de datos anteriores y nuevas de Search Ads 360 en el espacio de ID anterior.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  customer_id_mapping.legacy_id AS CustomerID,
  campaign_id_mapping.legacy_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.customer_id = customer_id_mapping.new_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaign_id = campaign_id_mapping.new_id
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  CAST(accountId AS INT) AS CustomerID,
  CAST(campaignId AS INT) AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Reemplaza lo siguiente:

• DATASET: El nombre del conjunto de datos.
• CUSTOMER_ID: El ID de cliente de Search Ads 360
• ADVERTISER_ID: El ID del anunciante de Search Ads 360
• NEW_DATA_DATE: La fecha de los datos de la nueva tabla de Search Ads 360
• OLD_DATA_DATE: La fecha de los datos de la tabla anterior de Search Ads 360

Posibles problemas de cuotas

La API de informes de Search Ads 360 asigna una cuota diaria para la cantidad de solicitudes que puede enviar el proyecto de Google. Si usas un proyecto para el Servicio de transferencia de datos de BigQuery y otros servicios, todos los servicios comparten la misma cuota y pueden alcanzar el límite de cuota en cualquier servicio.

Para evitar este posible problema sin afectar los flujos de trabajo existentes, considera estas opciones:

• Configura un proyecto independiente para el Servicio de transferencia de datos de BigQuery. Una unión de tabla entre proyectos puede tener el siguiente aspecto:

    #standardSQL
    select count(a.item1)
    from (select item1, item2 from project-A.data_set_a.table_name_a) a
    inner join
    (select item3, item4 from project-B.data_set_b.table_name_b) b
    on a.item1 = b.item3

• Comunícate con el equipo de asistencia de Search Ads 360 y solicita una cuota adicional.