Transferencias de Search Ads 360 (obsoleto)

Console

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

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

     

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

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

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

Donde:

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