Cargar datos de Salesforce Marketing Cloud en BigQuery

Puede cargar datos de Salesforce Marketing Cloud en BigQuery mediante el conector de BigQuery Data Transfer Service para Salesforce Marketing Cloud. Con BigQuery Data Transfer Service, puede programar tareas de transferencia periódicas que añadan sus datos más recientes de Salesforce Marketing Cloud a BigQuery.

Limitaciones

Las transferencias de datos de Salesforce Marketing Cloud están sujetas a las siguientes limitaciones:

• Una configuración de transferencia solo puede admitir una ejecución de transferencia de datos a la vez. Si se programa una segunda transferencia de datos para que se ejecute antes de que se complete la primera, solo se completará la primera transferencia de datos y se omitirán las demás transferencias de datos que se solapen con la primera.
  • Para evitar que se omitan transferencias en una misma configuración de transferencia, le recomendamos que aumente el tiempo que transcurre entre las transferencias de grandes cantidades de datos configurando la frecuencia de repetición.
• Si la vinculación de red y la instancia de máquina virtual (VM) que has configurado se encuentran en regiones diferentes, puede que haya movimiento de datos entre regiones cuando transfieras datos desde Salesforce Marketing Cloud.

Antes de empezar

En las siguientes secciones se describen los pasos que debe seguir antes de crear una transferencia de datos de Salesforce Marketing Cloud.

Requisitos previos de Salesforce Marketing Cloud

Debe tener la siguiente información al crear una transferencia de datos de Salesforce Marketing Cloud:

En los siguientes pasos se explica cómo obtener la información necesaria para crear una transferencia de datos de Marketing Cloud de Salesforce:

1. Instala un paquete de integración de API de tipo entre servidores. Anota el ID de cliente, el secreto de cliente y el subdominio en la sección Componentes de la página de detalles del paquete.
   • El subdominio es una parte del URI base. Por ejemplo, en el URI base de autenticación https://SUBDOMAIN.auth.marketingcloudapis.com/, SUBDOMAIN es el valor de tu subdominio.
   • Para obtener más información, consulta Integraciones de servidor a servidor con el tipo de concesión de credenciales de cliente.
2. Busca la instancia de tu servidor de API en la URL después de iniciar sesión en la aplicación Salesforce Marketing Cloud. El valor de la instancia incluye s seguido de un valor numérico. Por ejemplo, en la URL https://mc.s4.exacttarget.com/, el valor de la instancia es s4. Para obtener más información, consulta Buscar la ubicación de la pila de una cuenta de Marketing Cloud.

También debe configurar los ajustes de permisos de ámbito para permitir la transferencia de datos de Salesforce Marketing Cloud:

1. Inicia sesión en la aplicación Salesforce Marketing Cloud.

2. Despliega el menú de perfil y haz clic en Configuración.

   

3. En la barra de navegación, en Herramientas de la plataforma, haga clic en Aplicaciones > Paquetes instalados.

4. Selecciona un paquete instalado para modificar sus ajustes.

5. En la sección Componentes, haz clic en Editar.

6. Selecciona la opción Leer para los siguientes ámbitos:

   • Correo electrónico
   • Contenido guardado
   • Recorridos
   • Retrollamadas
   • Campaña
   • Suscripciones

7. Haz clic en Guardar.

Requisitos previos de BigQuery

• Comprueba que has completado todas las acciones necesarias para habilitar BigQuery Data Transfer Service.
• Crea un conjunto de datos de BigQuery para almacenar tus datos.
• Si quieres configurar notificaciones de ejecuciones de transferencias para Pub/Sub, asegúrate de que tienes el permiso de pubsub.topics.setIamPolicy Gestión de Identidades y Accesos (IAM). No se necesitan permisos de Pub/Sub si solo configuras notificaciones por correo electrónico. Para obtener más información, consulta el artículo sobre las notificaciones de ejecución de BigQuery Data Transfer Service.

Roles de BigQuery necesarios

Para obtener los permisos que necesitas para crear una transferencia, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de BigQuery (roles/bigquery.admin). Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para crear una transferencia. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.

Configurar una transferencia de datos de Salesforce Marketing Cloud

Añada datos de Salesforce Marketing Cloud a BigQuery configurando una configuración de transferencia con una de las siguientes opciones:

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=DISPLAY_NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

  bq mk
      --transfer_config
      --target_dataset=mydataset
      --data_source=salesforce_marketing
      --display_name='My Transfer'
      --params='{"connector.subdomain": "abcd",
      "connector.instance": "x",
      "connector.authentication.oauth.clientId": "1234567890",
      "connector.authentication.oauth.clientSecret":"ABC12345"}'

Para ejecutar manualmente una transferencia de datos fuera de tu programación habitual, puedes iniciar una ejecución de rellenado.

Solucionar problemas de configuración de transferencias

Si tienes problemas para configurar una transferencia de datos de Salesforce Marketing Cloud, prueba a seguir estos pasos para solucionarlos:

• Asegúrate de que la autenticación configurada para el paquete de integración de la API esté configurada como De servidor a servidor.
• Asegúrate de que la aplicación de autenticación esté configurada con los permisos necesarios en Ámbito.

Mensajes de error

Error: invalid_grant. The client's IP address is unauthorized for this account. Allowlist the client's IP address in Marketing Cloud Administration.

Solución: prueba uno de los siguientes pasos:

• Habilita todas las direcciones IP disponibles para Google Cloud recursos.
• Inhabilita la lista de direcciones IP permitidas. Para ello, inicia sesión en la aplicación Salesforce Marketing Cloud y ve a la página Configuración > Configuración de seguridad. Haz clic en Editar y, a continuación, configura el ajuste Restringir inicios de sesión por dirección IP (lista de IPs permitidas) en Lista de IPs permitidas inhabilitada.

Error: INVALID_ARGUMENT. Table tableName does not exist in asset TableName

Solución: asegúrate de que tienes configurados los permisos de ámbito correctos en la aplicación Salesforce Marketing Cloud. Para obtener más información, consulte los requisitos de Salesforce Marketing Cloud.

Precios

No hay ningún coste por transferir datos de Salesforce Marketing Cloud a BigQuery mientras esta función esté en vista previa.

Siguientes pasos

• Para obtener una descripción general de BigQuery Data Transfer Service, consulta el artículo Introducción a BigQuery Data Transfer Service.
• Para obtener información sobre cómo usar las transferencias de datos, como obtener información sobre una configuración de transferencia, enumerar configuraciones de transferencia y ver el historial de ejecuciones de una transferencia, consulta Gestionar transferencias.
• Consulta cómo cargar datos con operaciones entre nubes.