Transferencias de Search Ads 360

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:

Permisos necesarios

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

  • 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 IAM bigquery.admin incluye los permisos bigquery.transfers.update y bigquery.datasets.update. Para obtener más información sobre las funciones de IAM en el Servicio de transferencia de datos de BigQuery, consulta la referencia del 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:

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

Console

  1. Ve a la página de BigQuery en Cloud Console.

    Ir a la página de BigQuery

  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), para Fuente (Source), elige Search Ads 360 (antes llamado Doubleclick Search).

      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 es necesario hacerle modificaciones 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), 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.

        Detalles de la fuente de Search Ads 360

      • (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",
            "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 del Servicio de transferencia de datos de BigQuery. El nombre de la columna debe seguir los [requisitos de formato para los nombres de columna del Servicio de transferencia de datos de BigQuery](https://cloud.google.com/bigquery/docs/schemas#column_names)

        Consola de Search Ads 360 CFV

    • (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.
  5. 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 del Servicio de transferencia de datos de BigQuery. El nombre de la columna debe cumplir con los requisitos de formato para los nombres de columnas del Servicio de transferencia de datos 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_items":"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.

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