Esta página se ha traducido con Cloud Translation API.

Cargar datos de Search Ads 360 en BigQuery

Puede cargar datos de Search Ads 360 en BigQuery mediante el conector BigQuery Data Transfer Service para Search Ads 360. Con BigQuery Data Transfer Service, puedes programar tareas de transferencia periódicas que añadan tus datos más recientes de Search Ads 360 a BigQuery.

Descripción general de los conectores

BigQuery Data Transfer Service para el conector de Search Ads 360 admite las siguientes opciones para la transferencia de datos.

Opciones de transferencia de datos	Asistencia
Informes admitidos	El conector de Search Ads 360 admite la transferencia de datos de los informes de Search Ads 360 v0. Para obtener información sobre cómo se transforman los informes de Search Ads 360 en tablas y vistas de BigQuery, consulte Transformación de informes de Search Ads 360.
Frecuencia de repetición	El conector de Search Ads 360 admite transferencias de datos diarias. De forma predeterminada, las transferencias de datos se programan en el momento en que se crean. Puedes configurar la hora de la transferencia de datos cuando configures la transferencia de datos.
Ventana de actualización	Puede programar sus transferencias de datos para recuperar datos de Search Ads 360 de hasta 30 días en el momento en que se ejecute la transferencia de datos. Puede configurar la duración de la ventana de actualización al configurar la transferencia de datos. De forma predeterminada, el conector de Search Ads 360 tiene una ventana de actualización de 7 días. Para obtener más información, consulta Actualizar ventanas. Las tablas de coincidencias se registran una vez al día y se almacenan en la partición de la última fecha de ejecución. Las capturas de la tabla de coincidencias no se actualizan en las recargas ni en los días cargados mediante la ventana de actualización.
Disponibilidad de los datos de reposición	Ejecuta un rellenado automático de datos para recuperar datos que no estén incluidos en la transferencia de datos programada. Puedes recuperar datos de hace tanto tiempo como permita la política de conservación de datos de tu fuente de datos. Para obtener información sobre la política de conservación de datos de Search Ads 360, consulte Política de conservación de datos registrados.
Número de IDs de cliente por cuenta de administrador	BigQuery Data Transfer Service admite un máximo de 8000 IDs de cliente por cada cuenta de administrador de Search Ads 360.

Para consultar la guía de transferencias de Search Ads 360 que usa la antigua API Reporting de Search Ads 360, consulte Transferencias de Search Ads 360 (obsoleta).

Ingestión de datos de transferencias de Search Ads 360

Cuando transfiere datos de Search Ads 360 a BigQuery, los datos se cargan en tablas de BigQuery que están 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 programa varias transferencias para la misma fecha, BigQuery Data Transfer Service sobrescribirá la partición de esa fecha con los datos más recientes. Si se realizan varias transferencias el mismo día o se ejecutan rellenados, no se duplicarán los datos y no se verán afectadas las particiones de otras fechas.

Actualizar ventanas

Una ventana de actualización es el número de días durante los que una transferencia de datos recupera datos cuando se produce una transferencia de datos. Por ejemplo, si la ventana de actualización es de tres días y se produce una transferencia diaria, BigQuery Data Transfer Service recupera todos los datos de la tabla de origen de los últimos tres días. En este ejemplo, cuando se produce una transferencia diaria, BigQuery Data Transfer Service crea una partición de tabla de destino de BigQuery con una copia de los datos de la tabla de origen del día actual y, a continuación, activa automáticamente ejecuciones de relleno para actualizar las particiones de tabla de destino de BigQuery con los datos de la tabla de origen de los dos días anteriores. Las ejecuciones de relleno automático sobrescribirán o actualizarán de forma incremental tu tabla de destino de BigQuery, en función de si el conector de BigQuery Data Transfer Service admite o no las actualizaciones incrementales.

Cuando ejecutas una transferencia de datos por primera vez, esta recupera todos los datos de origen disponibles en la ventana de actualización. Por ejemplo, si la ventana de actualización es de tres días y ejecutas la transferencia de datos por primera vez, BigQuery Data Transfer Service recuperará todos los datos de origen en un plazo de tres días.

Los periodos de actualización se asignan al campo de la API TransferConfig.data_refresh_window_days.

Para recuperar datos que no estén dentro del periodo de actualización (por ejemplo, datos históricos) o para recuperar datos de interrupciones o brechas en la transferencia, puedes iniciar o programar una reposición.

Limitaciones

La frecuencia máxima con la que puede 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 la creas. Sin embargo, puedes configurar la hora de inicio de la transferencia de datos cuando crees la transferencia.
BigQuery Data Transfer Service no admite transferencias de datos incrementales durante una transferencia de Search Ads 360. Cuando especifica una fecha para una transferencia de datos, se transfieren todos los datos disponibles para esa fecha.

Antes de empezar

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

Comprueba que hayas completado todas las acciones necesarias para habilitar BigQuery Data Transfer Service.
Crea un conjunto de datos de BigQuery Data Transfer Service para almacenar los datos de informes de Search Ads 360.
Si quieres configurar notificaciones de ejecuciones de transferencias para Pub/Sub, debes tener permisos de pubsub.topics.setIamPolicy. No se necesitan permisos de Pub/Sub si solo configura notificaciones por correo electrónico. Para obtener más información, consulta las notificaciones de ejecución de BigQuery Data Transfer Service.
Habilite el acceso a la API Reporting de Search Ads 360 en su proyecto.

Permisos obligatorios

Asegúrate de que el usuario que crea la transferencia de datos tenga los siguientes permisos obligatorios:

BigQuery Data Transfer Service:
- Permisos de 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 de gestión de identidades y accesos predefinido 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 gestión de identidades y accesos en BigQuery Data Transfer Service, consulta el artículo sobre el control de acceso.
Google Cloud:
- serviceusage.services.use permisos para descargar datos de Search Ads 360 en el proyecto.
Los roles de gestión de identidades y accesos predefinidos editor, owner y serviceusage.serviceUsageConsumer incluyen los permisos de serviceusage.services.use. Para obtener más información sobre los roles de gestión de identidades y accesos en Uso de Servicio, consulta la referencia de control de acceso.
Search Ads 360:
- Acceso de lectura al ID de cliente de Search Ads 360 o a la cuenta de gestor que se usa en la configuración de la transferencia. Para configurar el acceso de lectura de las cuentas de servicio, puede ponerse en contacto con el equipo de Asistencia de Search Ads 360.

Crear una transferencia de datos de Search Ads 360

Para crear una transferencia de datos para los informes de Search Ads 360, necesita su ID de cliente de Search Ads 360 o su cuenta de administrador. Selecciona una de las opciones siguientes:

Consola

Ve a la página Transferencias de datos de la Google Cloud consola.

Ir a Transferencias de datos
Haz clic en Crear transferencia.
En la sección Tipo de fuente, en Fuente, elija Search Ads 360.
En la sección Nombre de la configuración de transferencia, en Nombre visible, indica un nombre para la transferencia de datos; por ejemplo, My Transfer. El nombre de la transferencia puede ser cualquier valor que te permita identificar la transferencia si necesitas modificarla más adelante.
En la sección Opciones de programación:
- En Frecuencia de repetición, elige una opción para determinar la frecuencia con la que se realizará la transferencia de datos. Si seleccionas Días, indica una hora válida en UTC.
- Si procede, selecciona Empezar ahora o Empezar a una hora determinada y proporciona una fecha de inicio y un tiempo de ejecución.
En la sección Configuración de destino, en Conjunto de datos, seleccione el conjunto de datos que ha creado para almacenar sus datos.

En la sección Detalles de la fuente de datos:

En ID de cliente, introduzca su ID de cliente de Search Ads 360.
Opcional: Introduzca un ID de agencia y un ID de anunciante para obtener tablas de asignación de IDs.

Opcional: En Variables personalizadas de Floodlight, introduzca las variables personalizadas de Floodlight que quiera incluir en la transferencia de datos. Las variables de Floodlight personalizadas deben ser propiedad de la cuenta de Search Ads 360 especificada por el ID de cliente en la configuración de la transferencia. Este parámetro acepta entradas de cadena en formato de matriz JSON y puede admitir varias variables de Floodlight personalizadas. En cada elemento de la matriz JSON, se deben incluir los siguientes parámetros:

id: el ID numérico de la variable de Floodlight personalizada. Este ID se asigna cuando se crea una variable de Floodlight personalizada en Search Ads 360. Si has especificado un id, no es necesario que incluyas un name.
name: el nombre que ha asignado el usuario a las variables personalizadas de Floodlight en Search Ads 360. Si has especificado un name, no es necesario que incluyas un id.
cfv_field_name: el nombre exacto del campo de la variable personalizada de Floodlight en función de tu caso práctico. Los valores admitidos son conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics y raw_event_conversion_dimensions.
destination_table_name: lista de tablas de BigQuery en las que se incluirán las variables de Floodlight personalizadas. Cuando BigQuery Data Transfer Service obtiene datos de estas tablas, la transferencia incluye las variables de Floodlight personalizadas en la consulta.
bigquery_column_name_suffix: nombre de columna descriptivo definido por el usuario. BigQuery Data Transfer Service añade el sufijo después del nombre de campo estándar para diferenciar las distintas variables de Floodlight personalizadas. En función del caso práctico, BigQuery Data Transfer Service genera un nombre de columna de BigQuery de la siguiente manera:

	Variables de Floodlight personalizadas 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 muestra un ejemplo de entrada de variable de Floodlight personalizada que especifica dos variables de Floodlight personalizadas:

[{
"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"
}]

Opcional: En el campo Columnas personalizadas, introduzca las columnas personalizadas que quiera incluir en la transferencia de datos. Las columnas personalizadas deben ser propiedad de la cuenta de Search Ads 360 especificada en el ID de cliente de la configuración de transferencia. Este campo acepta entradas de cadena en formato de matriz JSON y puede admitir varias columnas. En cada elemento de la matriz JSON, se deben incluir los siguientes parámetros:
- id: ID numérico de la columna personalizada. Este ID se asigna cuando se crea una columna personalizada. Si has especificado un id, no es necesario que incluyas un name.
- name: nombre definido por el usuario de la columna personalizada en Search Ads 360. Si has especificado un name, no es necesario que incluyas un id.
- destination_table_name: lista de tablas de BigQuery en las que se incluirá la columna personalizada. Cuando BigQuery Data Transfer Service recupera datos de estas tablas, la transferencia incluye el campo de columna personalizado en la consulta.
- bigquery_column_name: el nombre de columna descriptivo definido por el usuario. Es el nombre del campo de la columna personalizada de las tablas de destino especificadas en destination_table_name. El nombre de la columna debe cumplir los requisitos de formato de los nombres de columna de BigQuery y ser único en comparación con otros campos del esquema estándar de la tabla u otras columnas personalizadas.
A continuación, se muestra un ejemplo de entrada de 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"
}]
```
Opcional: En el campo Filtro de tabla, introduzca una lista de tablas separadas por comas que quiera incluir. Por ejemplo, Campaign, AdGroup. Añade el prefijo - a esta lista para excluir determinadas tablas. Por ejemplo: -Campaign, AdGroup. Todas las tablas están incluidas de forma predeterminada.
Opcional: En Ventana de actualización, introduce un valor entre 1 y 30. Si no se define, la ventana de actualización será de 7 días de forma predeterminada.

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

Si has iniciado sesión con una identidad federada, se necesita una cuenta de servicio para crear una transferencia. Si has iniciado sesión con una cuenta de Google, no es obligatorio tener una cuenta de servicio para la transferencia. La cuenta de servicio debe tener los permisos necesarios.
Opcional: En la sección Opciones de notificación:
- Haz clic en el interruptor para habilitar las notificaciones por correo electrónico. Si habilitas esta opción, el administrador de las transferencias recibirá una notificación por correo cuando falle una ejecución de transferencia.
- Haz clic en el interruptor para habilitar las notificaciones de Pub/Sub. En Seleccionar un tema de Cloud Pub/Sub, elige el nombre del tema o haz clic en Crear un tema. Esta opción configura las notificaciones de Pub/Sub sobre la transferencia.
Haz clic en Guardar.

bq

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

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

Las siguientes marcas son opcionales:

--project_id: especifica el proyecto que se va a 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\"}]"}'

Donde:

PROJECT_ID (Opcional): especifica qué proyecto se va a usar. Si no se especifica la marca, se usa el proyecto predeterminado.
DATASET: el conjunto de datos de destino de la configuración de la transferencia.
NAME: el nombre visible de la configuración de la transferencia. El nombre de la transferencia de datos puede ser cualquier valor que te permita identificar la transferencia si necesitas modificarla más adelante.
DATA_SOURCE: la fuente de datos search_ads.
SERVICE_ACCOUNT_NAME (Opcional): el nombre de la cuenta de servicio que se usa para autenticar la transferencia de datos. La cuenta de servicio debe ser propiedad del mismo project_id que se usó para crear la transferencia y debe tener todos los permisos necesarios.

PARAMETERS: 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 las tablas que se incluirán en la transferencia de datos. Si no se especifica la marca, se incluyen todas las tablas. Para incluir solo tablas específicas, use una lista de valores separados por comas (por ejemplo, Ad, Campaign, AdGroup). Para excluir tablas específicas, añada un guion (-) delante de los valores excluidos (por ejemplo, -Ad, Campaign, AdGroup excluye los tres valores).
custom_columns: especifica columnas personalizadas en los informes. Este parámetro acepta entradas de cadena en formato de matriz JSON y puede admitir varias columnas. En cada elemento de la matriz JSON, se deben incluir los siguientes parámetros:
- CC_ID: ID numérico de la columna personalizada. Este ID se asigna cuando se crea una columna personalizada.
- CC_DESTINATION_TABLE: lista de tablas de BigQuery en las que se incluirá la columna personalizada. Cuando BigQuery Data Transfer Service recupera datos de estas tablas, la transferencia de datos incluye el campo de columna personalizada en la consulta.
- CC_COLUMN: el nombre de columna descriptivo definido por el usuario. Es el nombre del campo de la columna personalizada de las tablas de destino especificadas en destination_table_name. El nombre de la columna debe cumplir los requisitos de formato de los nombres de columna de BigQuery y ser único en comparación con otros campos del esquema estándar de la tabla u otras columnas personalizadas.
custom_floodlight_variables: especifica las variables de Floodlight personalizadas de su transferencia. Este parámetro acepta entradas de cadena en formato de matriz JSON y puede admitir varias variables de Floodlight personalizadas. En cada elemento de la matriz JSON, se deben incluir los siguientes parámetros:
- CFV_ID: el ID numérico de la variable de Floodlight personalizada. 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 personalizada de Floodlight en función de su caso práctico. 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, consulte el artículo Métricas de Floodlight personalizadas.
- CFV_DESTINATION_TABLE: lista de tablas de BigQuery en las que se incluirán las variables de Floodlight personalizadas. Cuando BigQuery Data Transfer Service obtiene datos de estas tablas, la transferencia de datos incluye las variables de Floodlight personalizadas en la consulta.
- CFV_COLUMN_SUFFIX: el nombre de columna descriptivo definido por el usuario. BigQuery Data Transfer Service añade el sufijo después del nombre de campo estándar para diferenciar las distintas variables de Floodlight personalizadas. En función del caso práctico, BigQuery Data Transfer Service genera un nombre de columna de BigQuery de la siguiente manera:

	Variables de Floodlight personalizadas 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`

Por ejemplo, el siguiente comando crea una transferencia de datos de Search Ads 360 llamada My Transfer con el ID de cliente 6828088731 y el conjunto de datos de destino mydataset. En la transferencia también se 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 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.

Activar manualmente una transferencia de Search Ads 360

Cuando activa manualmente una transferencia de Search Ads 360, se hacen copias de las tablas de coincidencias 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 capturas de MatchTable de las siguientes tablas:

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

Campañas Máximo rendimiento

El conector de Search Ads 360 le permite exportar datos de campañas Máximo rendimiento. Debe marcar la casilla Incluir datos de campañas Máximo rendimiento al crear una transferencia de datos, ya que los datos de Máximo rendimiento no se exportan de forma predeterminada.

Al incluir datos de Máximo rendimiento, se eliminan campos ad_group de determinadas tablas y se incluyen otras nuevas. No puede incluir campos de ad_group porque la API Search Ads 360 filtra los datos de Máximo rendimiento.

En las siguientes tablas no se incluyen las columnas relacionadas con ad_group cuando se marca la casilla Incluir tablas de campañas Máximo rendimiento:

CartDataSalesStats
ProductAdvertised
ProductAdvertisedDeviceStats
ProductAdvertisedConversionActionAndDeviceStats

Asistencia para cuentas de administrador de Search Ads 360

Usar cuentas de administrador de Search Ads 360 ofrece varias ventajas con respecto a usar IDs de cliente individuales:

No es necesario gestionar varias transferencias de datos para generar informes sobre varios IDs de cliente.
Las consultas entre clientes son más sencillas de escribir porque todos los IDs de cliente se almacenan en la misma tabla.
El uso de cuentas de administrador reduce los problemas de cuota de carga de BigQuery Data Transfer Service, ya que se cargan varios IDs de cliente en la misma tarea.

Si ya es cliente y tiene varias transferencias de datos de Search Ads 360 específicas de un ID de cliente, le recomendamos que cambie a una cuenta de administrador de Search Ads 360. Para ello, sigue estos pasos:

Configure una única transferencia de datos de Search Ads 360 a nivel de cuenta de administrador o de subadministrador.
Programar una reposición.
Inhabilita las transferencias de Search Ads 360 específicas de un ID de cliente.

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

Ejemplo

En la siguiente lista se muestran los IDs de cliente vinculados a determinadas cuentas 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 está vinculado a una cuenta de administrador y aparece en cada informe. Para obtener más información sobre la estructura de los informes de Search Ads 360 en BigQuery Data Transfer Service, consulte Transformación de informes de Search Ads 360.

Transferir la configuración del ID de cliente 1234567890

Una configuración de transferencia de la cuenta de administrador raíz (ID de cliente 1234567890) genera ejecuciones de transferencia de datos que incluyen 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 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 89)
9999 (a través de la cuenta de subadministrador 89)
0000 (ID de cliente individual)

Transferir la configuración del ID de cliente 1234

Una configuración de transferencia de la cuenta de subadministrador 123 (ID de cliente 1234) genera ejecuciones de transferencia de datos que incluyen 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 de la cuenta de subadministrador 567 (ID de cliente 567) genera ejecuciones de transferencia de datos que incluyen los siguientes IDs de cliente:

5555
6666
7777

Transferir la configuración del cliente con ID 89

Una configuración de transferencia de la cuenta de subadministrador 89 (ID de cliente 89) genera ejecuciones de transferencia de datos que incluyen los siguientes IDs de cliente:

8888
9999

Configuración de la transferencia para el ID de cliente 0000

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

0000

Consultar tus datos

Cuando tus datos se transfieren a BigQuery Data Transfer Service, se escriben en tablas con particiones por hora de ingestión. Para obtener más información, consulta el artículo 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 Consultar tablas con particiones.

Consultas de ejemplo de Search Ads 360

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

Las siguientes consultas son ejemplos para empezar a consultar sus datos de Search Ads 360 con BigQuery Data Transfer Service. Si tiene alguna pregunta más sobre lo que puede hacer con estos informes, póngase en contacto con su representante técnico de Search Ads 360.

Rendimiento de las campañas

La siguiente consulta de ejemplo analiza el rendimiento de las campañas de Search Ads 360 de 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

Haz los cambios siguientes:

DATASET: el nombre del conjunto de datos
CUSTOMER_ID: el ID de cliente de Search Ads 360

Número de palabras clave

La siguiente consulta de ejemplo analiza las palabras clave por campaña, grupo de anuncios y estado de la palabra 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

Haz los cambios siguientes:

DATASET: el nombre del conjunto de datos
CUSTOMER_ID: el ID de cliente de Search Ads 360

Tablas de asignación de IDs

Las entidades de la nueva experiencia de Search Ads 360, como los clientes, las campañas y los grupos de anuncios, tienen un espacio de IDs diferente al de la experiencia anterior. Si ya usa la transferencia de datos de Search Ads 360 y quiere combinar datos de la antigua experiencia de Search Ads 360 con la nueva API de Search Ads 360, puede usar BigQuery Data Transfer Service para transferir tablas de asignación de IDs si proporciona un ID de agencia y un ID de anunciante válidos en la configuración de la transferencia.

Entidades admitidas: contiene dos columnas, legacy_id y new_id, que especifican la asignación de IDs de las entidades de las versiones antigua y nueva de Search Ads 360, respectivamente. En el caso de las entidades AD, CAMPAIGN_CRITERION y CRITERION, también se proporciona un new_secondary_id, ya que estas entidades no tienen IDs únicos a nivel global en la nueva experiencia de Search Ads 360. A continuación se muestra una lista de tablas de asignación de IDs.

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

Consultas de ejemplo

La siguiente consulta usa tablas de asignación de IDs para agregar métricas por campaña en tablas de transferencias de datos de la experiencia anterior y de la nueva experiencia de Search Ads 360 en el nuevo espacio de IDs.

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

Haz los cambios siguientes:

DATASET: el nombre del conjunto de datos
CUSTOMER_ID: el ID de cliente de Search Ads 360
ADVERTISER_ID: el ID de 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 tablas de asignación de IDs para agregar métricas por campaña en tablas de transferencias de datos de la experiencia anterior y de la nueva de Search Ads 360 en el espacio de IDs antiguo.

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

Haz los cambios siguientes:

DATASET: el nombre del conjunto de datos
CUSTOMER_ID: el ID de cliente de Search Ads 360
ADVERTISER_ID: el ID de 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 con las cuotas

La API de informes de Search Ads 360 asigna una cuota al número de solicitudes que puede enviar el proyecto de Google. Si usa un proyecto para BigQuery Data Transfer Service 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 que afecte a los flujos de trabajo actuales, puedes hacer lo siguiente:

Usa el parámetro table_filter para cargar solo las tablas que necesites.

Configura un proyecto independiente para BigQuery Data Transfer Service. Una combinación de tablas entre proyectos podría 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

Póngase en contacto con el equipo de Asistencia de Search Ads 360 y solicite una cuota adicional.