Transferencias de Search Ads 360 (obsoleto)

El Servicio de transferencia de datos de BigQuery para Search Ads 360 (antes conocido como Doubleclick Search) te permite administrar y programar de forma automática la carga de trabajos recurrentes para los datos de informes de Search Ads 360.

Informes compatibles

Por el momento, el Servicio de transferencia de datos de BigQuery para Search Ads 360 admite las siguientes opciones de informes:

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	Compatibilidad
Versión de la API compatible	v2
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 Search Ads 360 no tiene límites de retención de datos conocidos, 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.

Antes de comenzar

Antes de crear una transferencia 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 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 en tu proyecto.

Permisos necesarios

Asegúrate de que la persona que crea la transferencia tenga los siguientes permisos requeridos:

Servicio de transferencia de datos de BigQuery:
- permisos bigquery.transfers.update para crear la transferencia
- Los permisos bigquery.datasets.get y bigquery.datasets.update en el conjunto de datos de destino
La función predefinida 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
Las funciones de IAM predefinidas editor, owner y serviceusage.serviceUsageConsumer incluyen los permisos serviceusage.services.use. Para obtener más información sobre las funciones de IAM en Service Usage, consulta Referencia de control de acceso.
Google Search Ads 360: acceso de lectura a los ID de agencia y de anunciante de Google Search Ads 360 que se usan en la configuración de transferencia. Para obtener más información, consulta la sección sobre cómo crear una cuenta de Google y obtener permisos SA360.

Configura una transferencia de datos de Search Ads 360

La configuración de una transferencia de datos para los informes de Search Ads 360 requiere lo siguiente:

ID de agencia: tu ID de agencia de Google Search Ads 360. Para obtener información sobre cómo recuperar tu ID de agencia de Search Ads 360, consulta la sección sobre cómo crear una cuenta de Google y obtener los permisos SA360.
ID de anunciante: tu ID de anunciante de Google Search Ads 360. Para obtener información sobre cómo recuperar tu ID de anunciante de Search Ads 360, consulta la sección sobre cómo crear una cuenta de Google y obtener los permisos SA360 .

Si quieres crear una transferencia de datos para los informes de Search Ads 360, sigue estos pasos:

Consola

Ve a la página de BigQuery en la consola de Google Cloud.

Ir a la página de BigQuery
Haz clic en Transferencias.
Haz clic en Crear transferencia.
En la página Crear transferencia:
- En la sección Tipo de fuente (Source type), para Fuente (Source), elige Search Ads 360 (antes llamado Doubleclick Search).
- 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 es necesario hacerle modificaciones más tarde.
- 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. 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.
- 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.
- En la sección Detalles de fuente de datos (Data source details), haz lo siguiente:
  - En ID de agencia, ingresa tu ID de agencia.
  - En ID de anunciante, ingresa tu ID de anunciante.
  - Marca Incluir elementos quitados (Include removed items) para incluir las entidades y métricas quitadas que se transferirán.
  - (Opcional) En Filtro de tabla (Table Filter), deja este campo vacío para cargar todas las tablas. Para importar datos de solo algunas de las tablas compatibles, enumera el prefijo de esas tablas, separadas por espacios en blanco. Ejemplo: Account AccountDeviceStats AccountFloodlightAndDeviceStats. Consulta la página sobre la transformación de informe de Search Ads 360 para obtener todos los nombres de tablas compatibles.
  - (Opcional) En Variables de Floodlight personalizadas, deja este campo en blanco para importar solo las columnas predefinidas en la página de la transformación del informe de Search Ads 360).
    Para importar las variables de Floodlight personalizadas que hayas realizado en Search Ads 360, asigna un nombre a esos campos en formato JSON, como este ejemplo:
    - ```
    [{
      "cfv_name": "variable_name",
      "cfv_type": "metric or dimension",
      "campaign_manager_type": "number or string",
      "destination_table_name": "table_name",
      "bigquery_column_name": "custom_column_name"
    },{
      "cfv_name": "variable_name_2",
      "cfv_type": "metric or dimension",
      "campaign_manager_type": "number or string",
      "destination_table_name": ["table_name_2","table_name_3"],
      "bigquery_column_name": "custom_column_name_2"
    }]
```
- Para cada elemento de la lista JSON, incluye lo siguiente:
  - cfv_name es el nombre “descriptivo” que especificaste cuando se creó la página de la variable de Floodlight personalizada en Campaign Manager. El nombre descriptivo también aparece en la IU de Search Ads 360 cuando configuras las dimensiones y métricas personalizadas.
  - cfv_type debería ser métrica o dimensión. Asegúrate de que esta información coincida con la forma en que configuras la variable personalizada de Floodlight en la IU de Search Ads 360.
  - campaign_manager_type debería ser número o string. Haz que esto coincidir con la configuración de la variable de Floodlight personalizada en la IU de Search Ads 360.
  - destination_table_name es el prefijo del nombre o una lista de prefijos de nombres de la tabla de destino a la que deseas agregar la variable de Floodlight personalizada. Ejemplo: AccountDeviceStats, [AdDeviceStats,CampaignFloodtlightAndDeviceStats].
  - bigquery_column_name es el nombre de columna que tendrá esta variable de Floodlight personalizada en la tabla de destino de BigQuery. El nombre de columna debe cumplir con los requisitos de formato para los nombres de columnas de BigQuery.
- (Opcional) En la sección Opciones de notificación (Notification options), 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.
Haga clic en Save.

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

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

Aquí:

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 la transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}' Para Search Ads 360, debes proporcionar los parámetros advertiser_id y agency_id. De forma opcional, puedes establecer los siguientes parámetros:
- (Opcional) Configura table_filter para importar los datos de solo algunas de las tablas compatibles, enumera los prefijos de nombre de esas tablas separados por espacios en blanco. Ejemplo: Account AccountDeviceStats AccountFloodlightAndDeviceStats. Consulta la página sobre la transformación de informes de Search Ads 360 para obtener todos los nombres de tablas compatibles.
- (Opcional) Configura custom_floodlight_variables para importar las variables de Floodlight personalizadas que se crearon en Search Ads 360. Asigna un nombre a esos campos en formato JSON, como en este ejemplo:
  - ```
  [{
    "cfv_name": "variable_name",
    "cfv_type": "metric or dimension",
    "campaign_manager_type": "number or string",
    "destination_table_name": "table_name",
    "bigquery_column_name": "custom_column_name"
  },{
    "cfv_name": "variable_name_2",
    "cfv_type": "metric or dimension",
    "campaign_manager_type": "number or string",
    "destination_table_name": "table_name_2",
    "bigquery_column_name": "custom_column_name_2"
  }]
```
- Para cada elemento de la lista JSON, incluye lo siguiente:
  - cfv_name es el nombre “descriptivo” que especificaste cuando se creó la página de la variable de Floodlight personalizada en Campaign Manager. El nombre descriptivo también aparece en la IU de Search Ads 360 cuando configuras las dimensiones y métricas personalizadas.
  - cfv_type debería ser métrica o dimensión. Asegúrate de que esta información coincida con la forma en que configuras la variable personalizada de Floodlight en la IU de Search Ads 360.
  - campaign_manager_type debería ser número o string. Haz que esto coincidir con la configuración de la variable de Floodlight personalizada en la IU de Search Ads 360.
  - destination_table_name es el prefijo del nombre de la tabla de destino a la que deseas agregar la variable de Floodlight personalizada. Ejemplo: AccountDeviceStats.
  - bigquery_column_name es el nombre de columna que tendrá esta variable de Floodlight personalizada en la tabla de destino de BigQuery. El nombre de columna debe cumplir con los requisitos de formato para los nombres de columnas de BigQuery.
- (Opcional) Configura include_removed_entities como “verdadero” para incluir las entidades y métricas quitadas que se transferirán.
data_source es la fuente de datos: doubleclick_search.

Por ejemplo, el siguiente comando crea una transferencia de anuncios de búsquedas llamada My Transfer mediante el ID de anunciante 123, el ID de agencia 123 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='{"agency_id":"123", "advertiser_id":"123","include_removed_entities":"true"}' \
--data_source=doubleclick_search

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.

Activa una transferencia de Search Ads 360 de forma manual

Cuando activas una transferencia de forma manual 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 para la última fecha de ejecución. Cuando programas una transferencia manual, no se actualizan las instantáneas de la tabla de coincidencia para las siguientes tablas:

Cuenta
Ad
Advertiser
AdGroup
AdGroupTarget
BidStrategy
Campaign
CampaignTarget
FeedItem
FloodlightActivity
Keyword
NegativeAdGroupKeyword
NegativeAdGroupTarget
NegativeCampaignKeyword
NegativeCampaignTarget
ProductAdvertised
ProductGroup
ProductLeadAndCrossSellFloodlightStats
Video
Placement
Video

Soluciona problemas de configuración de la transferencia de Search Ads 360

Si tienes problemas para configurar tu transferencia, consulta la página sobre cómo solucionar problemas de configuración de la transferencia 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 tablas con particiones.

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 Consulta tablas particionadas.

Posibles problemas de cuotas

La API de Google 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 para otros servicios, ambos compartirán la cuota y, posiblemente, alcanzarán el límite de cuota en cualquiera de los servicios.

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

Configura un proyecto independiente para el Servicio de transferencia de datos de BigQuery.

Ejemplo de combinación de tabla de proyecto cruzado:

  #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. Para obtener más información, consulta la sección sobre cómo solicitar cuota adicional.