Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Connexion à Salesforce Marketing Cloud Salesforce Marketing Cloud est un fournisseur de logiciels d’automatisation et d’analytique marketing pour le marketing par e-mail, mobile, réseaux sociaux et en ligne. Il propose également des services de conseil et de mise en œuvre. En tant qu'utilisateur de Salesforce Marketing Cloud, vous pouvez vous connecter AWS Glue à votre compte Salesforce Marketing Cloud. Vous pouvez ensuite utiliser Salesforce Marketing Cloud comme source de données ou comme destination dans vos tâches ETL. Exécutez ces tâches pour transférer des données entre Salesforce Marketing Cloud et les AWS services ou autres applications prises en charge. **Topics** + [AWS Glue support pour Salesforce Marketing Cloud](salesforce-marketing-cloud-support.md) + [Politiques contenant les opérations API pour la création et l’utilisation des connexions](salesforce-marketing-cloud-configuring-iam-permissions.md) + [Configuration de Salesforce Marketing Cloud](salesforce-marketing-cloud-configuring.md) + [Configuration des connexions Salesforce Marketing Cloud](salesforce-marketing-cloud-configuring-connections.md) + [Lecture à partir des entités Salesforce Marketing Cloud](salesforce-marketing-cloud-reading-from-entities.md) + [Écriture destinée aux entités Salesforce Marketing Cloud](salesforce-marketing-cloud-writing-to-entities.md) + [Options de connexion à Salesforce Marketing Cloud](salesforce-marketing-cloud-connection-options.md) + [Restrictions et remarques relatives au connecteur Salesforce Marketing Cloud](salesforce-marketing-cloud-connector-limitations.md) # AWS Glue support pour Salesforce Marketing Cloud AWS Glue prend en charge Salesforce Marketing Cloud comme suit : **Prise en charge en tant que source ?** Oui. Vous pouvez utiliser des tâches AWS Glue ETL pour interroger des données depuis Salesforce Marketing Cloud. **Prise en charge en tant que cible ?** Non. **Versions de l’API Salesforce Marketing Cloud prises en charge** Les versions suivantes de l’API Salesforce Marketing Cloud sont prises en charge : + v1 # Politiques contenant les opérations API pour la création et l’utilisation des connexions L'exemple de politique suivant décrit les autorisations AWS IAM requises pour créer et utiliser des connexions. Si vous créez un rôle, créez une politique contenant les éléments suivants : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "glue:ListConnectionTypes", "glue:DescribeConnectionType", "glue:RefreshOAuth2Tokens", "glue:ListEntities", "glue:DescribeEntity" ], "Resource": "*" } ] } ``` ------ Si vous ne voulez pas utiliser la méthode ci-dessus, vous pouvez également utiliser les politiques IAM gérées suivantes : + [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Accorde l'accès aux ressources dont AWS Glue les différents processus ont besoin pour s'exécuter en votre nom. Ces ressources incluent AWS Glue Amazon S3, IAM, CloudWatch Logs et Amazon EC2. Si vous suivez la convention de dénomination des ressources spécifiée dans cette politique, AWS Glue les processus disposent des autorisations requises. Cette politique est généralement attachée aux rôles spécifiés lorsque vous définissez les crawlers, les tâches et les points de terminaison de développement. + [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Accorde un accès complet aux AWS Glue ressources lorsqu'une identité à laquelle la politique est attachée utilise la console AWS de gestion. Si vous suivez la convention de dénomination pour les ressources spécifiées dans la politique, les utilisateurs bénéficient des capacités totales de la console. Cette politique s'applique généralement aux utilisateurs de la AWS Glue console. # Configuration de Salesforce Marketing Cloud Avant de pouvoir AWS Glue transférer des données depuis Salesforce Marketing Cloud, vous devez satisfaire aux exigences suivantes : ## Configuration requise Les exigences minimales sont les suivantes : + Vous disposez d’un compte Salesforce Marketing Cloud. Pour de plus amples informations, veuillez consulter [Création d’un compte Salesforce Marketing Cloud](#salesforce-marketing-cloud-configuring-creating-salesforce-marketing-cloud-account). + Votre compte Salesforce Marketing Cloud est activé pour accéder à l’API. L’accès à l’API est activé par défaut pour les éditions Enterprise, Unlimited, Developer et Performance. Si vous répondez à ces exigences, vous êtes prêt à vous connecter AWS Glue à votre compte Salesforce Marketing Cloud. Pour les connexions classiques, vous n’avez rien d’autre à faire dans Salesforce Marketing Cloud. ## Création d’un compte Salesforce Marketing Cloud Pour Salesforce Marketing Cloud, vous devez contacter le fournisseur pour créer un compte. Si vous ou votre entreprise êtes associé à Salesforce, contactez votre responsable de compte Salesforce pour demander une licence Salesforce Marketing Cloud. Sinon, vous pouvez demander à contacter un représentant Salesforce comme suit : 1. Accédez à https://www.salesforce.com/in/products/marketing-cloud/overview/et choisissez **S'inscrire**. 1. Cliquez sur le lien **Contactez-nous** en haut à droite de la page. 1. Saisissez les informations requises dans le formulaire et choisissez **Me contacter**. Un représentant de Salesforce vous contactera pour discuter de vos besoins. ## Création d'un projet et informations d'identification OAuth 2.0 Pour obtenir un projet et des informations d'identification OAuth 2.0 : 1. Connectez-vous à votre [instance Salesforce Marketing Cloud](https://mc.login.exacttarget.com/hub-cas/login) à l’aide de votre nom d’utilisateur et de votre mot de passe et authentifiez-vous à l’aide de votre numéro de téléphone portable enregistré. 1. Cliquez sur votre profil en haut à droite, puis sur **Configurer**. 1. Sous **Outils de plateforme**, choisissez **Applications**, puis **Packages installés**. ![\[\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/images/sfmc-platform-tools.png) 1. Sur la page **Packages installés**, cliquez sur **Nouveau** dans le coin supérieur droit. Saisissez le nom et la description du package. Enregistrez le package. Une fois le package enregistré, vous pouvez consulter les détails du package. 1. Sur la page **Détails** du package, dans la section **Composant**, choisissez **Ajouter un composant**. ![\[\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/images/sfmc-add-component.png) 1. Sélectionnez le **type de composant** « Intégration d’API » et cliquez sur **Suivant**. 1. **Sélectionnez le **type d'intégration** « Server-à-serveur » (qui possède le type d' OAuth autorisation des informations d'identification du client) et cliquez sur Suivant.** 1. Ajoutez les portées en fonction de vos besoins et cliquez sur **Enregistrer**. # Configuration des connexions Salesforce Marketing Cloud Salesforce Marketing Cloud prend en charge le type de subvention CLIENT CREDENTIALS pour OAuth2. + Ce type de subvention est considéré comme bidimensionnel OAuth 2.0 car il est utilisé par les clients pour obtenir un jeton d'accès en dehors du contexte d'un utilisateur. AWS Glue est capable d'utiliser l'ID client et le secret du client pour authentifier le Salesforce Marketing Cloud, APIs qui sont fournis par les services personnalisés que vous définissez. + Chaque service personnalisé appartient à un utilisateur régi uniquement par l’API, qui dispose d’un ensemble de rôles et d’autorisations autorisant le service à effectuer des actions spécifiques. Un jeton d’accès est associé à un seul service personnalisé. + Ce type d’autorisation donne lieu à un jeton d’accès de courte durée qui peut être renouvelé en appelant un point de terminaison d’identité. + Pour consulter la documentation publique de Salesforce Marketing Cloud pour OAuth 2.0 avec les informations d'identification du client, voir [Configurer votre environnement de développement pour les packages améliorés](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/mc-dev-setup-enhanced.html). Pour configurer une connexion Salesforce Marketing Cloud : 1. Dans AWS Secrets Manager, créez un secret avec les informations suivantes : 1. Pour l’application connectée gérée par le client, le secret doit contenir le secret du consommateur de l’application connectée avec `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` comme clé. 1. Remarque : Vous devez créer un secret pour vos connexions dans AWS Glue. 1. Dans AWS Glue Glue Studio, créez une connexion sous **Data Connections** en suivant les étapes ci-dessous : 1. Lorsque vous sélectionnez un **type de connexion**, sélectionnez Salesforce Marketing Cloud. 1. Indiquez le `Subdomain Endpoint` du Salesforce Marketing Cloud auquel vous souhaitez vous connecter. 1. Sélectionnez le rôle AWS IAM qui AWS Glue peut assumer et dispose des autorisations nécessaires pour les actions suivantes : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "secretsmanager:DescribeSecret", "secretsmanager:GetSecretValue", "secretsmanager:PutSecretValue", "ec2:CreateNetworkInterface", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface" ], "Resource": "*" } ] } ``` ------ 1. Sélectionnez celui `secretName` que vous souhaitez utiliser pour cette connexion AWS Glue afin d'y placer les jetons. 1. Sélectionnez les options réseau si vous souhaitez utiliser votre réseau. 1. Accordez au rôle IAM associé à votre AWS Glue travail l'autorisation de lire`secretName`. # Lecture à partir des entités Salesforce Marketing Cloud **Prérequis** Un objet Salesforce Marketing Cloud à partir duquel vous souhaitez lire. Vous aurez besoin du nom de l’objet, comme `Activity` ou `Campaigns`. Le tableau suivant présente les entités prises en charge. **Entités prises en charge pour la source** : | Entité | Interface | Peut être filtré | Limit prise en charge | Order by prise en charge | SELECT prise en charge\$1 | Partitionnement pris en charge | | --- | --- | --- | --- | --- | --- | --- | | Event Notification Callback | REST | Non | Non | Non | Oui | Non | | Seed-List | REST | Non | Oui | Non | Oui | Non | | Configuration | REST | Oui | Oui | Non | Oui | Non | | Vérification de domaine | REST | Oui | Oui | Oui | Oui | Non | | Objects Nested Tags | REST | Oui | Non | Non | Oui | Non | | Contact | REST | Non | Oui | Non | Oui | Non | | Event Notification Subscription | REST | Non | Non | Non | Oui | Non | | Messagerie | REST | Non | Oui | Non | Oui | Non | | Activité | SOAP | Non | Non | Non | Oui | Oui | | Bounce Event | SOAP | Non | Non | Non | Oui | Oui | | Click Event | SOAP | Non | Non | Non | Oui | Oui | | Content Area | SOAP | Non | Non | Non | Oui | Oui | | Data Extension | SOAP | Non | Oui | Non | Oui | Oui | | E-mail | SOAP | Non | Oui | Non | Oui | Oui | | Forwarded Email Event | SOAP | Non | Oui | Non | Oui | Oui | | Transférer un e-mail OptInEvent | SOAP | Non | Oui | Non | Oui | Oui | | Lien | SOAP | Non | Oui | Non | Oui | Oui | | Link Send | SOAP | Non | Oui | Non | Oui | Oui | | List | SOAP | Non | Oui | Non | Oui | Oui | | List Subscriber | SOAP | Non | Oui | Non | Oui | Oui | | Not Sent Event | SOAP | Non | Oui | Non | Oui | Oui | | Open Event | SOAP | Non | Oui | Non | Oui | Oui | | Envoyer | SOAP | Non | Oui | Non | Oui | Oui | | Sent Event | SOAP | Non | Oui | Non | Oui | Oui | | Subscriber | SOAP | Non | Oui | Non | Oui | Oui | | Survey Event | SOAP | Non | Oui | Non | Oui | Oui | | Unsub Event | SOAP | Non | Oui | Non | Oui | Oui | | Audit Events | REST | Non | Oui | Oui | Oui | Non | | Campagnes | REST | Non | Oui | Oui | Oui | Non | | Interactions | REST | Non | Oui | Oui | Oui | Non | | Content Assets | REST | Non | Oui | Oui | Oui | Non | **Exemple pour REST** : ``` salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "Campaigns", "API_VERSION": "v1", "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com" } ) ``` **Exemple pour SOAP** : ``` salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "Activity", "API_VERSION": "v1", "INSTANCE_URL": "https://**********************.soap.marketingcloudapis.com" } ) ``` **Détails des entités et des champs Salesforce Marketing Cloud** : Les tableaux ci-après décrivent les entités Salesforce Marketing Cloud. Il existe des entités REST avec des métadonnées statiques et des entités SOAP avec des métadonnées dynamiques. **Entités REST avec métadonnées statiques** : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/salesforce-marketing-cloud-reading-from-entities.html) **Entités SOAP avec métadonnées dynamiques** : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/salesforce-marketing-cloud-reading-from-entities.html) ## Requêtes de partitionnement Dans Salesforce Marketing Cloud, les champs Integer et DateTime Datatype prennent en charge le partitionnement basé sur les champs. Vous pouvez indiquer les options Spark supplémentaires `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` et `NUM_PARTITIONS` si vous souhaitez utiliser la simultanéité dans Spark. Avec ces paramètres, la requête d’origine serait divisée en `NUM_PARTITIONS` nombres de sous-requêtes pouvant être exécutées simultanément par les tâches Spark. + `PARTITION_FIELD` : le nom du champ à utiliser pour partitionner la requête. + `LOWER_BOUND` : une valeur limite inférieure **inclusive** du champ de partition choisi. Pour le champ Timestamp, nous acceptons le format d’horodatage Spark utilisé dans les requêtes SQL Spark. Exemples de valeurs valides : ``` “2024-05-07T02:03:00.00Z" ``` + `UPPER_BOUND` : une valeur limite supérieure **exclusive** du champ de partition choisi. + `NUM_PARTITIONS` : le nombre de partitions. Exemple : ``` salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "ListSubscriber", "API_VERSION": "v1", "PARTITION_FIELD": "CreatedDate", "LOWER_BOUND": "2023-09-07T02:03:00.000Z", "UPPER_BOUND": "2024-05-07T02:03:00.000Z", "NUM_PARTITIONS": "10" } ) ``` # Écriture destinée aux entités Salesforce Marketing Cloud **Conditions préalables** + Un objet Salesforce Marketing auquel vous souhaitez écrire. Vous devrez spécifier le nom de l’objet tel que `List` ou `Campaigns` ou l’une des autres entités décrites dans le tableau ci-dessous. + Le connecteur Salesforce Marketing Cloud prend en charge trois opérations d’écriture : + INSERT + UPSERT + UPDATE Lorsque vous utilisez les opérations d’écriture `UPDATE` et `UPSERT`, vous devez proposer l’option `ID_FIELD_NAMES` afin de spécifier le champ d’ID externe pour les enregistrements. **Entités prises en charge pour la destination** : | Entité | Priority | Interface (REST, SOAP, etc.) | Peut être inséré | Peut être mis à jour | Peut faire l’objet d’un upsert | | --- | --- | --- | --- | --- | --- | | Campagnes | P0 | REST | Y- Unique | Y- Unique | N | | Content Assets | P0 | REST | Y- Unique, en bloc | Y- Unique | N | | Contact | P1 | REST | Y- Unique | Y- Unique | N | | Vérification de domaine | P1 | REST | Y- Unique | Y- Unique, en bloc | N | | Event Notification Callback | P1 | REST | Y- Unique | Y- Unique | N | | Event Notification Subscription | P1 | REST | Y- Unique | Y- Unique | N | | Messagerie | P1 | REST | Y- Unique | N | N | | Object Nested Tag | P2 | REST | Y- Unique | Y- Unique | N | | Seed-List | P1 | REST | Y- Unique | Y- Unique | N | | Configuration | P1 | REST | Y- Unique | Y- Unique | N | | Data Extension | P0 | SOAP | Y- Unique | Y- Unique | Y- Unique | | E-mail | P0 | SOAP | Y- Unique | Y- Unique | N | | List | P0 | SOAP | Y- Unique | Y- Unique | N | | Envoyer | P0 | SOAP | Y- Unique | N | N | | Subscriber | P0 | SOAP | Y- Unique | Y- Unique | N | **Exemple d’opération INSERT pour REST** : ``` salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "Campaigns", "API_VERSION": "v1", "writeOperation" : "INSERT", "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com" } ) ``` **Exemple d’opération INSERT pour SOAP** : ``` salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "List", "API_VERSION": "v1", "writeOperation" : "INSERT", "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com" } ) ``` **Exemple d’opération UPDATE pour REST** : ``` salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "Campaigns", "API_VERSION": "v1", "writeOperation" : "UPDATE", "ID_FIELD_NAMES": "id", "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com" } ) ``` **Exemple d’opération UPDATE pour SOAP** : ``` salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "List", "API_VERSION": "v1", "writeOperation" : "UPDATE", "ID_FIELD_NAMES": "id", "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com" } ) ``` **Exemple d’opération UPSERT pour SOAP** : ``` salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "DataExtension/Insert-***E/6*******3", "API_VERSION": "v1", "writeOperation" : "UPSERT", "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com" } ) ``` # Options de connexion à Salesforce Marketing Cloud Les options de connexion pour Salesforce Marketing Cloud sont les suivantes : + `ENTITY_NAME`(Chaîne) - (Obligatoire) Utilisé pour la lecture. Le nom de votre objet dans Salesforce Marketing Cloud. + `API_VERSION`(Chaîne) - (Obligatoire) Utilisé pour la lecture. Version de l’API Rest et de SOAP API Salesforce Marketing Cloud que vous souhaitez utiliser. + `SELECTED_FIELDS`(Liste) - Par défaut : vide (SELECT \$1). Utilisé pour la lecture. Colonnes que vous souhaitez sélectionner pour l’objet. + `FILTER_PREDICATE`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Doit être au format SQL Spark. + `QUERY`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Requête Spark SQL complète. + `PARTITION_FIELD`(Chaîne) - Utilisé pour la lecture. Champ à utiliser pour partitionner la requête. + `LOWER_BOUND`(Chaîne) - Utilisé pour la lecture. Une valeur limite inférieure inclusive du champ de partition choisi. + `UPPER_BOUND`(Chaîne) - Utilisé pour la lecture. Une valeur limite supérieure exclusive du champ de partition choisi. + `NUM_PARTITIONS`(Entier) - Par défaut : 1. Utilisé pour la lecture. Nombre de partitions pour la lecture. + `WRITE_OPERATION`(Chaîne) - Par défaut : INSERT. Utilisé pour l’écriture La valeur doit être INSERT, UPDATE, UPSERT. + `ID_FIELD_NAMES`(Chaîne) - Valeur par défaut : null. Nécessaire pour UPDATE/UPSERT. # Restrictions et remarques relatives au connecteur Salesforce Marketing Cloud Les restrictions ou les remarques du connecteur Salesforce Marketing Cloud sont les suivantes : + Lorsque vous utilisez un filtre sur DateTime un champ de type de données, vous devez transmettre la valeur au format « yyyy-mm-dd THH:MM:SSZ ». + Dans Data Preview, la valeur Boolean Datatype apparaît sous la forme d’une valeur vide. + Pour les entités SOAP, vous pouvez définir un maximum de deux filtres, et pour les entités REST, vous ne pouvez définir qu’un seul filtre, ce qui limite les tests de partitionnement avec des filtres. + Plusieurs comportements inattendus ont été observés du côté du SaaS : le champ `Link.Alias` de l’entité `linksend` ne prend pas en charge l’opérateur CONTAINS (par exemple, `Link.Alias CONTAINS "ViewPrivacyPolicy"`), et les opérateurs de filtre pour les entités Data Extension (telles que EQUALS et GREATER THAN) ne renvoient pas les résultats attendus. + L'API ClickEvent SOAP SFMC prend du temps pour refléter les enregistrements nouvellement créés, de sorte que les enregistrements créés récemment peuvent ne pas être immédiatement disponibles dans la réponse de l'API. Exemple : Si vous créez 5 nouveaux ClickEvent enregistrements le **2025-01-10T 14:30:00** et que vous les récupérez immédiatement à l'aide de l'API SOAP, la réponse risque de ne pas inclure les 5 enregistrements. Il peut s’écouler jusqu’à cinq minutes pour que les enregistrements qui viennent d’être créés apparaissent dans la réponse de l’API. Ce délai peut également affecter à la fois la récupération des données et les exécutions planifiées. + Deux DateTime formats différents : **2025-03-11T 04:46:00 (sans millisecondes) et 2025-03-11T 04:46:00.000** Z sont pris en charge lors de l'exécution d'opérations d'**écriture en (en millisecondes).** AWS Glue + Pour l’entité Event Notification Subscription, un abonnement ne peut être créé que pour une URL de rappel vérifiée, et vous pouvez avoir jusqu’à 200 abonnements par rappel. + Pour l’entité Event Notification Callback, un maximum de 50 enregistrements peuvent être créés par compte.