Planifier un transfert Salesforce Marketing Cloud

Le service de transfert de données BigQuery pour le connecteur Salesforce Marketing Cloud vous permet de planifier et de gérer automatiquement les tâches de chargement récurrentes de Salesforce Marketing Cloud dans BigQuery.

Avant de commencer

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

Prérequis pour Salesforce Marketing Cloud

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

Nom du paramètre	Description
`subdomain`	Le sous-domaine de l'API
`instance`	L'instance de serveur d'API
`clientId`	L'ID client d'intégration d'application
`clientSecret`	Code secret du client d'intégration d'application

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

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.
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 la section Rechercher l'emplacement de la pile pour un compte Marketing Cloud.

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

Connectez-vous à l'application Salesforce Marketing Cloud.
Développez le menu déroulant de votre profil, puis cliquez sur Configuration.
Dans la barre de navigation sous Outils de plate-forme, cliquez sur Applications > Packages installés.
Sélectionnez un package installé pour modifier ses paramètres.
Dans la section Composants, cliquez sur Modifier.
Sélectionnez l'option Lecture pour les champs d'application suivants :
- Adresse e-mail
- Contenu enregistré
- Transferts
- Rappels
- Campaign
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 section Gérer les accès.

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 :

Autorisations requises

Les autorisations suivantes sont requises pour créer un transfert :

bigquery.transfers.update sur l'utilisateur
bigquery.datasets.get sur l'ensemble de données cible
bigquery.datasets.update sur l'ensemble de données cible

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:

Console

Accédez à la page "BigQuery" de la console Google Cloud.

Accéder à la page "BigQuery"
Dans le volet de navigation, cliquez sur Transferts de données > Créer un transfert.
Dans le champ Source de la section Source type (Type de source), sélectionnez Salesforce Marketing Cloud.
Dans la section Nom de la configuration de transfert, sous Nom à afficher, saisissez le nom du transfert.
Dans la section Options de programmation, procédez comme suit :
- Dans la liste Fréquence de répétition, sélectionnez une option pour spécifier la fréquence d'exécution de ce transfert. Pour spécifier une fréquence de répétition personnalisée, sélectionnez Personnalisée. Si vous sélectionnez À la demande, ce transfert s'exécute lorsque vous déclenchez manuellement le transfert.
- Le cas échéant, sélectionnez Commencer ou Commencer à l'heure définie, puis indiquez une date de début et une heure d'exécution.
Dans la section Paramètres de destination, pour le champ Ensemble de données de destination, choisissez l'ensemble de données que vous avez créé pour stocker vos données.
Dans la section Data source details (Détails de la source de données), procédez comme suit :
- Dans le champ API Subdomain (Sous-domaine de l'API), saisissez le sous-domaine de l'API.
- Dans le champ Instance d'API, saisissez la valeur de l'instance d'API.
- Sous ID client, saisissez l'ID client d'intégration de l'application.
- Dans le champ Code secret du client, saisissez le code secret du client d'intégration d'application.
Dans le menu Compte de service, sélectionnez un compte de service associé à votre projet Google Cloud. Le compte de service sélectionné doit disposer des rôles requis pour exécuter ce transfert.

Si vous vous êtes connecté avec une identité fédérée, vous devez disposer d'un compte de service pour créer un transfert. Si vous vous êtes connecté avec un compte Google, un compte de service pour le transfert est facultatif.

Pour en savoir plus sur l'utilisation des comptes de service avec des transferts de données, consultez la page Utiliser des comptes de service.
Facultatif : dans la section Options de notification, procédez comme suit :
- Pour activer les notifications par e-mail, cliquez sur le bouton Notification par e-mail. Lorsque vous activez cette option, l'administrateur de transfert reçoit une notification par e-mail en cas d'échec de l'exécution du transfert.
- Pour activer les notifications d'exécution de transfert Pub/Sub pour ce transfert, cliquez sur le bouton Notifications Pub/Sub. Vous pouvez sélectionner le nom de votre sujet ou cliquer sur Créer un sujet pour en créer un.
Cliquez sur Enregistrer.

Lorsque ce transfert s'exécute, le service de transfert de données BigQuery renseigne automatiquement les tables suivantes en fonction de l'interface REST.

Campaigns
Categories
EventDefinitions
Journeys
JourneyActivities
SendDefinitions
Subscriptions

bq

Saisissez la commande bq mk, puis spécifiez l'indicateur de création de transfert --transfer_config.

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

Remplacez les éléments suivants :

PROJECT_ID (Facultatif) ID de votre projet Google Cloud. Si vous ne fournissez pas de --project_id afin de spécifier un projet particulier, le projet par défaut est utilisé.
DATA_SOURCE : source de données (par exemple, saphana).
DISPLAY_NAME : nom à afficher de la configuration de transfert. Ce nom peut correspondre à toute valeur permettant d'identifier le transfert si vous devez le modifier ultérieurement.
DATASET : ensemble de données cible de la configuration de transfert.
PARAMETERS correspond aux paramètres de la configuration de transfert créée, au format JSON. Exemple : --params='{"param":"param_value"}'. Voici les paramètres d'un transfert Salesforce Marketing Cloud :
- connector.subdomain: sous-domaine de l'API.
- connector.instance: valeur de l'instance d'API.
- connector.authentication.oauth.clientId: nom d'ID de l'application pour le client OAuth.
- connector.authentication.oauth.clientSecret: code secret de l'application pour le client OAuth.

Par exemple, la commande suivante crée un transfert Salesforce Marketing Cloud dans le projet par défaut avec tous les paramètres requis:

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

API

Utilisez la méthode projects.locations.transferConfigs.create et fournissez une instance de la ressource TransferConfig.

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

Tarification

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

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