Charger des données Salesforce Marketing Cloud dans BigQuery

Vous pouvez charger des données depuis Salesforce Marketing Cloud vers BigQuery à l'aide du connecteur du service de transfert de données BigQuery pour Salesforce Marketing Cloud. Le service de transfert de données BigQuery vous permet de planifier des jobs de transfert récurrents qui ajoutent vos dernières données Salesforce Marketing Cloud à BigQuery.

Limites

Les transferts de données Salesforce Marketing Cloud sont soumis aux limitations suivantes :

• Si votre instance de VM et votre attachement réseau configurés se trouvent dans des régions différentes, des données peuvent être transférées d'une région à une autre lorsque vous transférez des données depuis Salesforce Marketing Cloud.

Avant de commencer

Les sections suivantes décrivent la procédure à suivre avant de créer un transfert de données Salesforce Marketing Cloud.

Conditions préalables pour Salesforce Marketing Cloud

Lors de la création d'un transfert Salesforce Marketing Cloud, vous devez disposer des informations suivantes :

Les étapes suivantes vous expliquent comment obtenir les informations nécessaires à la création d'un transfert de données Salesforce Marketing Cloud :

1. Installez un package d'intégration d'API de type serveur à serveur. Notez l'ID client, le code secret du client et le sous-domaine dans la section Composants de la page des détails du package.
   • Le sous-domaine fait partie de l'URI de base. Par exemple, dans l'URI de base d'authentification https://SUBDOMAIN.auth.marketingcloudapis.com/, SUBDOMAIN est votre valeur de sous-domaine.
   • Pour en savoir plus, consultez la section Intégrations de serveur à serveur avec le type d'attribution d'identifiants client.
2. Une fois connecté à l'application Salesforce Marketing Cloud, recherchez votre instance de serveur d'API dans l'URL. La valeur de l'instance inclut s suivi d'une valeur numérique. Par exemple, dans l'URL https://mc.s4.exacttarget.com/, la valeur de l'instance est s4. Pour en savoir plus, consultez Localiser la pile d'un compte Marketing Cloud.

Vous devez également configurer les paramètres d'autorisation de champ d'application pour autoriser un transfert de données Salesforce Marketing Cloud :

1. Connectez-vous à l'application Salesforce Marketing Cloud.

2. Développez le menu déroulant de votre profil, puis cliquez sur Configuration.

   

3. Dans la barre de navigation sous Outils de plate-forme, cliquez sur Applications > Packages installés.

4. Sélectionnez un package installé pour modifier ses paramètres.

5. Dans la section Composants, cliquez sur Modifier.

6. Sélectionnez l'option Lecture pour les champs d'application suivants :

   • E-mail
   • Contenu enregistré
   • Transferts
   • Rappels
   • Campagne
   • Abonnements

7. Cliquez sur Enregistrer.

Prérequis pour BigQuery

• Vérifiez que vous avez effectué toutes les actions requises pour activer le service de transfert de données BigQuery.
• Créez un ensemble de données BigQuery pour stocker vos données.
• Si vous avez l'intention de configurer des notifications d'exécution de transfert pour Pub/Sub, assurez-vous de disposer de l'autorisation Identity and Access Management (IAM) pubsub.topics.setIamPolicy. Les autorisations Pub/Sub ne sont pas nécessaires si vous ne configurez que des notifications par e-mail. Pour plus d'informations, consultez la page Notifications d'exécution du service de transfert de données BigQuery.

Rôles BigQuery requis

Pour obtenir les autorisations nécessaires pour créer un transfert, demandez à votre administrateur de vous accorder le rôle IAM Administrateur BigQuery (roles/bigquery.admin). Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour créer un transfert. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Configurer un transfert de données Salesforce Marketing Cloud

Pour créer un transfert de données Salesforce Marketing Cloud, procédez comme suit :

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"}'

Résoudre les problèmes liés à la configuration d'un transfert

Si vous rencontrez des problèmes lors de la configuration d'un transfert de données Salesforce Marketing Cloud, essayez les étapes de dépannage suivantes :

• Assurez-vous que l'authentification configurée pour le package d'intégration d'API est configurée sur Serveur à serveur.
• Assurez-vous que l'application d'authentification est configurée avec les autorisations requises sous Champ d'application.

Messages d'erreur

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

Solution : essayez l'une des étapes suivantes :

• Activez toutes les adresses IP disponibles pour les ressources Trusted Cloud by S3NS .
• Désactivez la liste d'autorisation d'adresses IP. Pour ce faire, connectez-vous à l'application Salesforce Marketing Cloud, puis accédez à la page Configuration > Paramètres de sécurité. Cliquez sur Modifier, puis configurez le paramètre Restrict Logins by IP Address (IP Allowlisting) (Restreindre les connexions par adresse IP (liste d'autorisation d'adresses IP)) sur IP Allowlisting Disabled (Liste d'autorisation d'adresses IP désactivée).

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

Résolution : assurez-vous que les autorisations de champ d'application appropriées sont configurées dans l'application Salesforce Marketing Cloud. Pour en savoir plus, consultez la section Prérequis pour Salesforce Marketing Cloud.

Tarifs

Le transfert de données Salesforce Marketing Cloud vers BigQuery est gratuit tant que cette fonctionnalité est en version preview.

Étapes suivantes

• Pour une vue d'ensemble du service de transfert de données BigQuery, consultez la page Présentation du service de transfert de données BigQuery.
• Pour plus d'informations sur l'utilisation des transferts de données, y compris l'obtention d'informations sur une configuration de transfert, la liste des configurations de transfert et l'affichage de l'historique d'exécution d'un transfert, consultez la page Gérer les transferts.
• Découvrez comment charger des données avec des opérations multicloud.