Intégrer Salesforce Marketing Cloud à l’aide d’OAuth 2.0

Intégrez votre ServiceNow instance aux Salesforce Marketing Cloud services à l’aide d’OAuth 2.0.

Important :

Minimisez les risques de sécurité et protégez les informations en accordant l’accès uniquement aux autorisations nécessaires de l’utilisateur ou de l’API.

Tableau 1. Autorisations utilisateur minimales

Processus	Rôle d’utilisateur requis dans l’application Salesforce Marketing Cloud	Périmètres d’authentification
Télécharger les abonnements	Utilisateur	Utilisateurs : Lire
Pull user activity (Transférer l’activité utilisateur)	Utilisateur	Utilisateurs : Lire
Récupérer l'abonnement	Utilisateur	Utilisateurs : Écriture
Télécharger les consommations	Utilisateur	Extensions de données : Lecture, Écriture

Créer des Salesforce Marketing Cloud informations d’identification OAuth 2.0

Créez des Salesforce Marketing Cloud informations d’identification OAuth 2.0 pour accéder aux Salesforce Marketing Cloud API.

Pourquoi et quand exécuter cette tâche

Les informations d’identification doivent être créées dans le périmètre de l’application Salesforce Marketing Cloud Spoke.

Avant de commencer

Rôle requis : Salesforce Marketing Cloud admin

Pourquoi et quand exécuter cette tâche

Pour accéder aux licences utilisateur et à l’extension de données, la configuration de la connexion doit être configurée dans l’unité business parente. Si la configuration est installée dans une unité business enfant, il est possible qu’elle ne puisse pas accéder aux données de l’unité business parente.

Procédure

1. Connectez-vous au Salesforce Marketing Cloud locataire.
2. Accédez à la Accueil de la configuration > Outils de la plateforme > Applications > Packages installés.
3. Sélectionnez Nouveau pour créer un package.
4. Dans la boîte de dialogue Détails du nouveau package, renseignez les champs Nom et Description .
5. Sélectionnez Enregistrer.
6. Sélectionnez Ajouter un composant.
7. Sélectionnez Intégration d’API pour intégrer Salesforce Marketing Cloud des API à votre application.
8. Sélectionnez Suivant.
9. Sélectionnez Serveur à serveur comme type d’intégration.
10. Sélectionnez Suivant.
11. Sélectionnez les champs d’application suivants pour votre intégration.
    • Utilisateurs : Lire
    • Utilisateurs : Écriture
    • Extensions de données : Lecture, Écriture
12. Sélectionnez Enregistrer.
    Votre ID client, votre secret client et votre URI de base SOAP sont affichés dans votre résumé de configuration. Accédez à la section Composants sous CONFIGURER > PACKAGES INSTALLÉS > DÉTAILS pour afficher l’ID client, le secret client et l’URI de base SOAP. Copiez les valeurs pour les utiliser ultérieurement.

    Remarque :

    Remarque : Vous devez ajouter /Service.asmx à l’URI de base SOAP lors de sa transmission dans votre ServiceNow instance.
13. Sélectionnez l’onglet ACCÈS et vérifiez que votre unité business est activée.

    Si votre unité business est inactive, sélectionnez-la et activez-la, puis sélectionnez Enregistrer.

Créer un rapport sur le nombre de contacts dans Salesforce Marketing Cloud

Créez un rapport sur le nombre de contacts pour récupérer et afficher le nombre total de contacts facturables dans votre Salesforce Marketing Cloud compte.

Avant de commencer

Salesforce Marketing Cloud Rôle requis : admin

Procédure

1. Depuis un navigateur Web, accédez à votre Salesforce Marketing Cloud instance.
2. Connectez-vous à l’aide de vos informations d’identification d’administrateur.
3. Dans l’en-tête de page de votre instance, sélectionnez l’icône de profil de l’unité business, puis sélectionnez l’unité business parente de niveau supérieur afin que votre rapport sur le nombre de contacts inclue des données pour l’unité business parente et toutes les unités business enfants correspondantes.
4. Dans la liste des applications disponibles Salesforce Marketing Cloud , sélectionnez l’icône de l’application Analytics Builder , puis sélectionnez Rapports.
   La vue d’ensemble de l’application Reports (Rapports) s’ouvre.
5. Dans la section Catalogue de rapports, sélectionnez Afficher le catalogue.
6. Dans le catalogue de rapports, recherchez Nombres de contacts , puis sélectionnez Créer.
   La boîte de dialogue Créer un rapport s’ouvre.
7. Dans la boîte de dialogue, sélectionnez la période pour laquelle vous souhaitez récupérer et afficher les données dans la liste Plage de dates .
   La valeur par défaut est les 30 derniers jours.

   Conseil :

   Pour éviter les problèmes de performances lors de la génération de rapports, vous devez définir cette valeur sur les 7 derniers jours.
8. Sélectionnez Envoyer.
   Votre Salesforce Marketing Cloud instance génère le rapport et affiche les résultats sur la page Résultats : nombres de contacts.
9. Sur la page Résultats : nombre de contacts, sélectionnez Enregistrer.
   La boîte de dialogue Enregistrer le rapport s’ouvre.
10. Renseignez les champs de la boîte de dialogue.

    Tableau 2. Boîte de dialogue Enregistrer le rapport

    Champ	Description
    Nom du rapport	Nom du rapport.
    Source des rapports	Source du rapport. Ce champ est automatiquement défini sur Nombres de contacts.
    Description	Description du rapport.

11. Sélectionnez Enregistrer.
12. Créez un calendrier pour exécuter automatiquement le rapport Nombres de contacts.
    1. Dans l’en-tête de page de l’application Rapports, sélectionnez l’onglet Vue d’ensemble pour revenir à la vue d’ensemble de l’application Rapports.
    2. À partir de votre liste de rapports, ouvrez votre nouveau rapport sur le nombre de contacts.
    3. Dans la section Options du calendrier, sélectionnez Modifier.
    4. Renseignez les champs de la boîte de dialogue.

       Tableau 3. Boîte de dialogue Modifier les options de calendrier

       Champ	Description
       Options de calendrier
       Début	Date et heure à partir desquelles vous souhaitez commencer l’exécution du rapport.
       Fuseau horaire	Fuseau horaire dans lequel le rapport est planifié.
       Répétition	Fréquence à laquelle vous souhaitez exécuter le rapport. Configurez le rapport pour qu’il s’exécute une fois par semaine, le dimanche.
       Fin	Date à laquelle vous souhaitez arrêter l’exécution du rapport.
       Options de remise
       Format	Type de fichier et extension de fichier dans lequel vous souhaitez recevoir les résultats du rapport. Sélectionner le fichier de données (.csv).
       Emplacement	Emplacement dans lequel vous souhaitez enregistrer ou partager le rapport. Définissez ce champ sur Enregistrer le rapport pour FTP , puis renseignez les champs correspondants : Nom du rapport : nom du fichier du rapport, à l’exclusion de l’extension de fichier. Si vous souhaitez inclure la date et l’heure dans le nom du rapport, ajoutez-les au format Reportname_YYYYMMDD_HHMMSS . Remarque : Notez ce nom de fichier pour une utilisation ultérieure. Option unique : option permettant de créer un enregistrement de rapport au lieu de remplacer l’enregistrement de rapport existant dans SFTP. Laissez cette case décochée. Emplacement FTP : emplacement de vos Salesforce Marketing Cloud fichiers FTP. Sélectionnez ExactTarget Enhanced FTP afin que le rapport soit enregistré dans votre dossier de rapports SFTP (SSH File Transfer Protocol). Remarque : Vous pouvez configurer un compte d’utilisateur SFTP pour Salesforce Marketing Cloud afficher les fichiers enregistrés à un emplacement FTP spécifique. Pour plus d'informations, consultez Configuration d’un compte d’utilisateur SFTP dans Salesforce Marketing Cloud.

    5. Sélectionnez Enregistrer.

Créer une extension de données pour votre rapport sur le nombre de contacts

Créez une extension de données pour stocker les données de votre rapport Nombres de contacts sur votre Salesforce Marketing Cloud instance.

Avant de commencer

Salesforce Marketing Cloud Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Les extensions de données sont des tables qui contiennent des attributs représentant les données de votre rapport. Lorsque votre ServiceNow instance se connecte au Salesforce Marketing Cloud service, elle récupère les données de cette extension de données.

Procédure

1. Sur l’en-tête de la page de votre Salesforce Marketing Cloud instance, passez la souris sur l’icône Salesforce pour afficher la liste des applications disponibles Salesforce Marketing Cloud .
2. Sélectionnez l’icône de l’application Générateur d’audience , puis sélectionnez Générateur de contacts.
   L’application Contact Builder s’ouvre.
3. Sélectionnez l’onglet Extensions de données .
4. Dans la boîte de dialogue contextuelle, sélectionnez Démarrer , puis Créer.
   La boîte de dialogue Créer une extension de données s’ouvre.
5. Dans l’étape Propriétés, renseignez les champs.

   Tableau 4. Champs de propriétés

   Champ	Description
   Méthode de création	Méthode dans laquelle vous souhaitez créer l’extension de données. Sélectionnez Créer à partir de nouveau.
   Nom	Nom de l’extension de données.
   Clé externe	Clé facultative qui identifie de manière unique l’extension de données. Vous pouvez entrer une clé de votre choix.
   Description	Description de l’extension de données.
   Type	Type d’extension de données. Ce champ est automatiquement défini sur Standard.
   Emplacement	Emplacement dans lequel vous souhaitez stocker l’extension de données. Ce champ est automatiquement défini sur Extensions de données. Sélectionnez Changer d’emplacement pour sélectionner un autre emplacement.
   Peut être envoyé ?	Option permettant d’indiquer si l’extension de données peut être envoyée à vos abonnés.

6. Sélectionnez Suivant.
7. À l’étape Politique de conservation des données, définissez le champ Paramètre de conservation sur Désactivé.
8. Sélectionnez Suivant.
9. Dans l’étape Attributs, ajoutez les attributs que vous souhaitez inclure dans l’extension de données.
   Les attributs sont utilisés pour mapper et importer des données d’un rapport vers une extension de données. Vous devez créer un attribut pour chaque colonne de rapport à partir de laquelle vous souhaitez importer des données. Chaque nom d’attribut doit correspondre exactement au nom de colonne de rapport correspondant.

   Pour l’intégration, les Salesforce Marketing Cloud attributs des colonnes de rapport Nombre de contacts suivantes sont nécessaires :

   Tableau 5. Champs d’attributs

   Champ	Description
   Clé primaire	Option pour l’attribut permettant d’inclure un identificateur unique pour tous les enregistrements de l’extension de données. Cette option doit être activée pour l’attribut Count_Date .
   Nom	Nom de l’attribut. Ce nom doit correspondre exactement au nom de colonne de rapport correspondant.
   Type de données	Type de données de l’attribut.
   Obligatoire	Option qui indique si l’attribut nécessite une valeur pour chaque enregistrement dans l’extension de données.
   Longueur	Nombre maximal de caractères autorisés dans la valeur d’attribut.
   Valeur par défaut	Valeur par défaut facultative pour l’attribut. Pour l’attribut Marqueur , définissez la valeur par défaut sur 1. Remarque : N’entrez pas de valeur par défaut pour les attributs qui sont affectés en tant que clé primaire.

   Nom	Type de données
   Count_Date	Texte
   Total_Distinct_Contacts_Count	Texte
   Total_Distinct_Email_Addresses1	Texte
   Total_Distinct_Mobile_Addresses_Count	Texte
   Marqueur	Texte

   Remarque :

   Vous pouvez ajouter des attributs supplémentaires et le nom doit être identique à celui des attributs d’intégration. Pour plus d'informations, voir Créer un profil d’intégration à l’aide de Salesforce Marketing Cloud l’authentification de base ou Créer un profil d’intégration Salesforce Marketing Cloud à l’aide d’OAuth 2.0.

   Les attributs de toutes les autres colonnes du rapport sur le nombre de contacts sont facultatifs. Renseignez les champs de chaque attribut que vous souhaitez ajouter.
10. Sélectionnez Terminer.
11. Dans la boîte de dialogue Extension de données créée, sélectionnez OK.

Créer une automatisation pour importer les données du rapport sur le nombre de contacts dans votre extension de données

Créez une automatisation pour importer automatiquement les données du rapport sur le nombre de contacts dans votre extension de données après la génération du rapport.

Avant de commencer

Salesforce Marketing Cloud Rôle requis : admin

Procédure

1. Sur l’en-tête de la page de votre Salesforce Marketing Cloud instance, passez la souris sur l’icône Salesforce pour afficher la liste des applications disponibles Salesforce Marketing Cloud .
2. Sélectionnez l’icône de l’application Journey Builder , puis sélectionnez Automation Studio.
   La vue d’ensemble de l’application Automation Studio s’ouvre.
3. Sélectionnez Nouvelle automatisation.
   Le workflow de la nouvelle automatisation s’ouvre.
4. Créez un calendrier d’automatisation en faisant glisser l’icône Calendrier de la section Sources de démarrage du volet de menu de gauche vers la section Source de démarrage du canevas de workflow.
5. Définissez un calendrier pour l’automatisation.
   1. Dans la section Source de départ du canevas de workflow, sélectionnez Configurer.
   2. Renseignez les champs de la boîte de dialogue.

      Tableau 6. Boîte de dialogue Définir la planification

      Champ	Description
      Date de début	Date à partir de laquelle vous souhaitez commencer à exécuter l’automatisation.
      Heure de début	Heure à partir de laquelle vous souhaitez commencer à exécuter l’automatisation.
      Fuseau horaire	Fuseau horaire dans lequel l’automatisation est planifiée.
      Répétition	Fréquence à laquelle vous souhaitez exécuter l’automatisation. Configurez l’automatisation à exécuter après la génération du rapport Nombre de contacts. Sélectionnez la même fréquence que celle que vous aviez sélectionnée lors de création d’un rapport sur le nombre de contacts dans Salesforce Marketing Cloud. Conseil : Si vous configurez l’automatisation pour qu’elle s’exécute le jour même où le rapport est généré, sélectionnez une heure de début qui laisse suffisamment de temps pour que la génération du rapport se termine. ServiceNow recommande une heure de début d’au moins deux heures après l’heure de début du rapport.
      Fin	Nombre de fois que l’automatisation peut s’exécuter jusqu’à ce que la planification d’automatisation se termine. Si vous ne souhaitez pas que le calendrier d’automatisation se termine, définissez ce champ sur Jamais. Ce champ n’apparaît pas seulement lorsque Aucun (exécuter une fois) est sélectionné dans Répéter.

   3. Sélectionnez Terminé.
6. Ajoutez une activité de script pour exécuter le JavaScript côté serveur pour toutes les activités qui l’exigent.
   1. Dans la section Activités du volet de menu de gauche, faites glisser l’icône de script dans le canevas du workflow.
      L’activité de script devient la première étape du workflow d’automatisation.
   2. Sélectionnez Choisir à l’étape d’activité de script.
      La boîte de dialogue Choisir une activité de script s’ouvre.
   3. Sélectionnez Créer une activité de script.
      La boîte de dialogue Créer une activité de script s’ouvre.
   4. Dans l’étape Propriétés, renseignez les champs.

      Tableau 7. Champs de propriétés

      Champ	Description
      Nom	Nom de l’activité de script.
      Clé externe	Clé facultative qui identifie de manière unique l’activité de script. Vous pouvez entrer une clé de votre choix.
      Emplacement du dossier	Emplacement dans lequel vous souhaitez stocker vos scripts. Sélectionnez Choisir... pour sélectionner un autre emplacement. Ce champ est automatiquement défini sur Scripts.
      Description	Description de l’activité de script.

   5. Copiez et collez le JavaScript côté serveur suivant dans la zone de texte JavaScript côté serveur :

      <script runat="server"> 
      var rows = Platform.Function.DeleteData('*<data-extension-name>*',['Flag'],['1']);
      </script>
      

      Le *<data-extension-name>* doit correspondre exactement au nom de fichier de l’extension de données que vous avez créée dans Créer une extension de données pour votre rapport sur le nombre de contacts.

   6. Sélectionnez Valider la syntaxe pour vérifier que la syntaxe JavaScript côté serveur est valide.
   7. Sélectionnez Suivant.
   8. À l’étape Résumé, vérifiez que la configuration de l’activité de script est correcte, puis sélectionnez Terminer.
7. Ajoutez une activité d’extraction de données pour copier le rapport du nombre de contacts du dossier Rapports SFTP vers le dossier Importation SFTP.
   L’instance Salesforce Marketing Cloud utilise le dossier d’importation SFTP pour localiser et importer les données de rapport dans vos extensions de données. Pour permettre à votre instance d’importer des données du rapport Nombres de contacts dans l’extension de données correspondante, vous devez copier le rapport dans le dossier d’importation SFTP.
   1. Dans la section Activités du volet de menu de gauche, faites glisser l’icône Extraction de données dans le canevas du workflow.
      L’activité d’extraction de données devient la deuxième étape du workflow d’automatisation.
   2. Sélectionnez Choisir à l’étape d’activité d’extraction de données.
      La boîte de dialogue Choisir une activité d’extraction de données s’ouvre.
   3. Sélectionnez Créer une activité d’extraction de données.
      La boîte de dialogue Créer une activité d’extraction de données s’ouvre.
   4. Dans l’étape Propriétés, renseignez les champs.

      Tableau 8. Champs de propriétés

      Champ	Description
      Nom	Nom de l’activité d’extraction de données.
      Clé externe	Clé facultative qui identifie de manière unique l’activité d’extraction de données. Vous pouvez entrer une clé de votre choix.
      Modèle d’affectation de nom de fichier	Le nom du fichier du rapport sur le nombre de contacts dont vous souhaitez extraire les données. Ce nom doit correspondre exactement au nom de fichier du rapport sur le nombre de contacts que vous avez créé en Créer un rapport sur le nombre de contacts dans Salesforce Marketing Cloud, y compris l’extension de fichier.
      Type d’extraction	Méthode d’extraction des données. Définissez ce champ sur Déplacement et copie de fichier FTP améliorés.
      Description	Description de l’activité d’extraction de données.

   5. Sélectionnez Suivant.
   6. Dans l’étape de configuration, renseignez les champs.

      Tableau 9. Champs de configuration

      Champ	Description
      Dossier d’entrée	Emplacement dans lequel vous avez enregistré le rapport Nombres de contacts. Entrez \rapports\.
      Dossier de sortie	Emplacement vers lequel vous souhaitez copier le rapport. Entrez \import\.
      Copier dans le dossier	Option permettant de copier au lieu de déplacer le rapport du dossier d’entrée vers le dossier de sortie. Cette option vous permet de conserver le rapport aux deux emplacements. Cochez cette case pour activer cette option.

   7. Sélectionnez Suivant.
   8. À l’étape Résumé, vérifiez que la configuration de l’activité d’extraction de données est correcte, puis sélectionnez Terminer.
8. Ajoutez une activité de fichier d’importation pour importer les données du rapport sur le nombre de contacts dans l’extension de données.
   1. Dans la section Activités du volet de menu de gauche, faites glisser l’icône Copier ou importer des données dans le canevas du workflow.
      L’activité de copie ou d’importation de données devient la troisième étape du workflow d’automatisation.
   2. Sélectionnez Choisir à l’étape d’activité Copier ou importer des données.
      La boîte de dialogue Choisir une copie ou une importation de données s’ouvre.
   3. Sélectionnez Créer une nouvelle définition de copie ou d’importation.
      La boîte de dialogue Créer une définition de copie ou d’importation s’ouvre.
   4. À l’étape Informations sur l’activité, renseignez les champs.

      Tableau 10. Champs d’informations sur l’activité

      Champ	Description
      Nom	Nom de l’activité de fichier d’importation.
      Description	Description de l’activité du fichier d’importation.
      Clé externe	Clé facultative qui identifie de manière unique l’activité du fichier d’importation. Vous pouvez entrer une clé de votre choix.
      Envoyer un e-mail de notification à	Adresse e-mail à laquelle vous souhaitez envoyer des notifications lorsqu’une importation est terminée. Si vous spécifiez une adresse e-mail, un e-mail de notification contenant le nombre de lignes insérées et mises à jour est envoyé à cette adresse une fois l’importation réussie. Important : L’e-mail de notification contient une erreur de validation Nombre de champs non valides en raison de la présence de lignes vides dans le fichier CSV importé. Ces lignes vides s’affichent automatiquement lorsque vous enregistrez le rapport sur FTP. Cependant, ils n’ont aucun impact sur l’intégration.

   5. Sélectionnez Suivant.
   6. À l’étape Source, sélectionnez Emplacement du fichier dans l’en-tête Source de données et remplissez les champs.

      Tableau 11. Champs de fichier d’importation

      Champ	Description
      Emplacement du fichier	Emplacement du rapport sur le nombre de contacts à partir duquel vous souhaitez importer des données. Sélectionnez le FTP amélioré ExactTarget.
      Modèle d’affectation de nom de fichier	Le nom du fichier du rapport sur le nombre de contacts à partir duquel vous souhaitez importer des données. Si vous souhaitez inclure la date et l’heure dans le nom du rapport, ajoutez-les au format Reportname_YYYYMMDD_HHMMSS en sélectionnant les champs de variable Date et de variable Heure . Ce nom doit correspondre exactement au nom de fichier du rapport sur le nombre de contacts que vous avez créé en Créer un rapport sur le nombre de contacts dans Salesforce Marketing Cloud, y compris l’extension de fichier.
      Format de date	Format dans lequel vous souhaitez afficher la date et l’heure des données du rapport.
      Délimiteur	Format dans lequel vous souhaitez séparer chaque enregistrement de rapport. Sélectionnez une virgule pour séparer chaque enregistrement par une virgule. Si vous souhaitez activer l’utilisation des guillemets doubles pour séparer chaque enregistrement, activez l’option Respecter les guillemets doubles (") comme délimiteur de texte .
      Comportement incorrect des données	Option permettant d’ignorer les lignes avec des données incorrectes. Cochez cette case pour activer cette option.

   7. Sélectionnez Suivant.
   8. À l’étape Destination, recherchez et sélectionnez l’extension de données que vous avez créée dans Créer une extension de données pour votre rapport sur le nombre de contacts.
   9. Sélectionnez Suivant.
   10. À l’étape Mappage, sélectionnez les options Ajouter et Mettre à jour et Mapper par ordinal dans l’en-tête de l’action de données.
   11. Lorsque vous y êtes invité, activez l’option Importer le fichier a des en-têtes de colonne, puis mappez chaque attribut d’extension de données au numéro de colonne correspondant dans le rapport Nombres de contacts.
       Remarque :

       Laissez l’attribut Flag non mappé.
   12. Sélectionnez Suivant.
   13. À l’étape Révision, vérifiez que la configuration de l’activité du fichier d’importation est correcte, puis sélectionnez Terminer.
9. Sélectionnez Enregistrer.
10. Renseignez les champs de la boîte de dialogue.

    Tableau 12. Boîte de dialogue Enregistrer l’automatisation

    Champ	Description
    Nom	Nom de l’automatisation.
    Description	Description de l’automatisation.
    Clé externe	Clé facultative qui identifie de manière unique l’automatisation.
    Emplacement	Emplacement dans lequel vous souhaitez enregistrer l’automatisation.

11. Sélectionnez Enregistrer.
12. Dans la section Source de départ du canevas du workflow, sélectionnez Actif.
13. Dans la boîte de dialogue Activer la confirmation du calendrier, sélectionnez Activer pour activer le calendrier d’automatisation.

Récupérer manuellement les données du rapport sur le nombre de contacts

Après avoir créé le rapport Nombres de contacts, l’extension de données et l’automatisation, vous pouvez récupérer les données de rapport entre vos tâches de rapport planifiées et d’automatisation en exécutant ces tâches manuellement.

Avant de commencer

Salesforce Marketing Cloud Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Votre Salesforce Marketing Cloud instance exécute automatiquement le rapport et les tâches d’automatisation en fonction des calendriers que vous définissez. Si vous souhaitez récupérer les données du rapport sur le nombre de contacts avant les prochaines tâches de rapport et d’automatisation planifiées, vous pouvez exécuter ces tâches manuellement.

Procédure

1. Exécutez votre rapport sur le nombre de contacts.
   1. Sur l’en-tête de la page de votre Salesforce Marketing Cloud instance, passez la souris sur l’icône Salesforce pour afficher la liste des applications disponibles Salesforce Marketing Cloud .
   2. Sélectionnez l’icône de l’application Analytics Builder , puis sélectionnez Rapports.
      La vue d’ensemble de l’application Reports (Rapports) s’ouvre.
   3. Dans votre liste de rapports, sélectionnez le rapport Nombres de contacts que vous avez créé dans Créer un rapport sur le nombre de contacts dans Salesforce Marketing Cloud.
   4. Sélectionnez Exécuter.
      Votre Salesforce Marketing Cloud instance génère le rapport et affiche les résultats sur la page Résultats : <nom-rapport>.
   5. Sur la page Résultats : <nom-rapport>, sélectionnez l’icône Télécharger les résultats ( icône ).
   6. Renseignez les champs de la boîte de dialogue.

      Tableau 13. Boîte de dialogue Télécharger les résultats

      Champ	Description
      Nom de fichier	Nom de fichier du rapport, à l’exclusion de l’extension de fichier.
      Source des rapports	Source du rapport. Ce champ est automatiquement défini sur Nombres de contacts.
      Format	Type de fichier et extension de fichier dans lequel vous souhaitez recevoir les résultats du rapport. Sélectionner le fichier de données (.csv).

   7. Sélectionnez Enregistrer.
   8. Enregistrez le fichier dans votre système.
2. Importez le fichier dans votre extension de données.
   1. Sur l’en-tête de la page de votre Salesforce Marketing Cloud instance, passez la souris sur l’icône Salesforce pour afficher la liste des applications disponibles Salesforce Marketing Cloud .
   2. Sélectionnez l’icône de l’application Générateur d’audience , puis sélectionnez Générateur de contacts.
   3. Ouvrez l’extension de données récemment créée que vous avez créée lors de la création d’une extension de données pour votre rapport sur le nombre de contacts.
   4. Sélectionnez Importer.
   5. Dans la boîte de dialogue Confirmation de l’importation des données, sélectionnez Importer dans Data Extension , puis sélectionnez OK.
   6. Dans l’étape Importer dans l’extension de données, choisissez le fichier que vous avez téléchargé à l’étape 1 précédente.
   7. Sélectionnez le délimiteur comme virgule.
   8. Sélectionnez le type d’importation comme Ajouter et mettre à jour.
   9. Sélectionnez Options d’importation comme Ignorer les lignes dans le fichier d’importation avec des données incorrectes.
   10. Sélectionnez Suivant.
   11. Dans la boîte de dialogue Configurer le mappage, sélectionnez Mapper manuellement.
   12. Faites correspondre les colonnes d’extension de données disponibles avec les colonnes du rapport importé et laissez la colonne Marqueur vide.
   13. Sélectionnez Suivant.
   14. Dans la boîte de dialogue Examiner et créer, entrez l’ID de l’e-mail sur lequel vous souhaitez recevoir une notification lorsque l’importation est terminée, puis sélectionnez Terminer.
   15. Dans la boîte de dialogue Exécuter la confirmation, sélectionnez Terminé.

Résultats

Les dernières données du rapport sur le nombre de contacts sont importées dans l’extension de données.

Créer un profil d’intégration Salesforce Marketing Cloud à l’aide d’OAuth 2.0

Créez un profil d’intégration Salesforce Marketing Cloud à l’aide d’OAuth 2.0 pour suivre les abonnements logiciels et optimiser les licences expirées pour le Salesforce Marketing Cloud service.

Avant de commencer

Pour créer un profil d’intégration Salesforce Marketing Cloud , demandez le module d’extension Gestion des actifs logiciels - Gestion des licences SaaS (sn_sam_saas_int) auprès de ServiceNow Store.

Conseil :

Pour éviter d’encourir des coûts d’abonnement supplémentaires, installez le module d’extension et générez l’intégration sur une instance de non-production.

ServiceNow Rôle requis : sam_integrator

Salesforce Marketing Cloud Rôle requis : sn_sforce_mc_spoke. Administrateur Salesforce Marketing Cloud

Important :

Vous devez cocher la case Intégration de Gestion des actifs logiciels à Salesforce Marketing Cloud pour cette intégration lors de l’installation des fonctionnalités facultatives sur la Application Manager page. Pour plus d’informations sur le choix des applications SaaS requises, reportez-vous à la section Demander le Gestion des licences SaaS.

Pourquoi et quand exécuter cette tâche

Si vous utilisez Espace de travail des actifs logiciels, l’option permettant de créer le profil d’intégration dans l’interface Salesforce Marketing Cloud utilisateur principale est inactive.

Procédure

1. Accédez au profil d’intégration.

   Interface	Action
   Interface utilisateur principale	Accédez à la Tous > Actifs Logiciels > Licence SaaS > Profils d'intégration directe. Sélectionnez Nouveau. Sélectionnez le profil d’intégration Salesforce Marketing Cloud.
   Espace de travail actifs logiciels	Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe. Sélectionnez Nouveau. Sélectionnez Salesforce Marketing Cloud dans la liste déroulante. Sélectionnez Continuer.

2. Remplissez les champs du formulaire.

   Tableau 14. Formulaire Profil d’intégration

   Champ	Description
   Nom d'affichage	Nom du profil d’intégration. Par exemple, profil d’intégration Salesforce Marketing Cloud.
   Type d'authentification	Type d’authentification pour accéder aux Salesforce Marketing Cloud API. Authentification de base OAuth 2.0 : sélectionnez cette valeur. Remarque : Pour un nouveau Salesforce Marketing Cloud profil, le type d’authentification est défini sur Authentification de base par défaut.
   Statut	État du profil d'intégration. Si vous n’avez pas publié le profil d’intégration, ce champ est automatiquement défini sur Brouillon. Si vous avez déjà publié le profil d’intégration, ce champ est automatiquement défini sur Publié.
   Type de profil	Type de profil d'intégration. Cette valeur est automatiquement définie sur l’abonnement Salesforce Marketing Cloud.

3. Examinez les rôles d’utilisateur requis ou les autorisations d’API spécifiés dans le champ de configuration du fournisseur pour chaque processus afin de minimiser les risques de sécurité et d’optimiser SaaS les licences.
   Remarque :

   Pour plus d’informations, consultez la table Autorisations utilisateur minimales .
   1. Dans la section Télécharger le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnements de téléchargement Salesforce Marketing Cloud.
      Remarque :

      La case Télécharger les abonnements est cochée par défaut et vous ne pouvez pas la décocher.
   2. Dans la section Récupérer le flux secondaire de l’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnement à la récupération de Salesforce Marketing Cloud.
      Remarque :

      La case Récupérer les abonnements est cochée par défaut. Si vous ne souhaitez pas récupérer les abonnements, vous pouvez décocher cette case. Si vous l’effacez, les candidats à la suppression sont créés, mais le flux secondaire d’abonnement à la récupération n’est pas déclenché ou le processus de réclamation n’est pas lancé.
   3. Dans la section Flux secondaire de consommation de téléchargement, vérifiez que le champ Flux secondaire est défini sur Consommation de contacts de téléchargement Salesforce Marketing Cloud.
4. Dans la section Attributs d’intégration, ajoutez ou supprimez les attributs en fonction de vos besoins.
   Les attributs nom-valeur tels que Date de décompte, Contacts, Contacts d’e-mail et Contacts mobiles sont automatiquement renseignés pour le profil d’intégration.

   Remarque :

   Le nom de l’attribut doit correspondre à l’en-tête de colonne de rapport dans Salesforce Marketing Cloud l’instance. Pour plus d'informations, consultez Créer une extension de données pour votre rapport sur le nombre de contacts.
5. Sélectionnez Enregistrer.
   Votre ServiceNow instance crée une ébauche de profil d’intégration.

   Le champ Connexion et informations d’identification s’affiche et est automatiquement défini sur sn_sforce_mc_spoke. SalesforceMarketingCloudSOAPConnection.

6. Ouvrez l’enregistrement des alias de connexion et d’informations d’identification en sélectionnant l’icône d’aperçu en regard du champ Connexion et informations d’identification , puis en sélectionnant Ouvrir l’enregistrement dans l’aperçu de l’enregistrement.
7. Dans le formulaire Alias de connexion et d’informations d’identification, sélectionnez le lien connexe Créer une connexion et des informations d’identification .
8. Renseignez les champs de la boîte de dialogue.

   Tableau 15. Boîte de dialogue Créer une connexion et des informations d’identification

   Champ	Description
   Information de connexion
   Nom de la connexion	Nom de la connexion. Par exemple, connexion SFMC SOAP.
   URL de connexion SOAP	URL de votre point de terminaison de connexion SOAP. Saisissez https://< sous-domaine >.soap.marketingcloudapis.com/Service.asmx où < sous-domaine > est votre Salesforce Marketing Cloud sous-domaine.
   Informations d'identification
   ID client OAuth	ID client que vous avez généré lors de la création d’un Salesforce Marketing Cloud Informations d'identification OAuth.
   Secret client OAuth	Secret client que vous avez récupéré lors de la création des Salesforce Marketing Cloud informations d’identification OAuth.
   URL de redirection OAuth	https://<instance_name>/oauth_redirect.do, où le nom d’instance est le nom de votre ServiceNow instance.
   Informations supplémentaires utilisées pour le post-traitement
   Extension de données du nombre de contacts	Nom de l’extension de données à partir de laquelle vous souhaitez récupérer les données du rapport sur le nombre de contacts. Ce nom doit correspondre exactement au nom de l’extension de données que vous avez créée dans Créer une extension de données pour votre rapport sur le nombre de contacts.

9. Sélectionnez Créer et obtenir un jeton OAuth.
   Remarque :

   Pour connaître le rôle requis pour effectuer cette étape, consultez la table Autorisations utilisateur minimales .
10. Sélectionnez Enregistrer.
11. Sur le formulaire de profil d’intégration, sélectionnez Valider la connexion pour vérifier les détails de connexion et d’informations d’identification de cette intégration.
    La validation de la connexion vérifie les API Télécharger les abonnements et Télécharger la consommation, mais pas les API Récupérer les abonnements.
12. Une fois la connexion vérifiée, sélectionnez Publier.

Que faire ensuite

Une fois l’intégration connectée, votre ServiceNow instance crée automatiquement des modèles logiciels, des règles de réclamation et des abonnements logiciels qui sont actualisés quotidiennement.

Après avoir créé un profil d’intégration, affichez les informations relatives au profil dans le Espace de travail des actifs logiciels en accédant à Opérations de licence > Abonnement de l'utilisateur > Profils d'intégration directe. Vous pouvez sélectionner un profil d’intégration pour afficher les listes connexes suivantes. Si toutes les listes connexes suivantes ne sont pas visibles pour un profil d’intégration dans la vue par défaut, vous pouvez sélectionner la vue d’intégration personnalisée dans l’onglet Détails :

• Modèles logiciels
• Identificateurs d'abonnement non reconnus
• Travaux planifiés
• Résultats de la tâche planifiée
• Abonnements logiciels
• Règle d'exclusion de l'identificateur d'abonnement
• Règle d'exclusion de l'utilisateur de l'abonnement

Après avoir créé un profil d’intégration, vous pouvez définir des règles d’exclusion des abonnements afin d’exclure certains abonnements du calcul des coûts de licence. Pour plus d'informations, consultez Exclusions d’abonnements pour SaaS les applications SSO et.

Si vous souhaitez configurer plusieurs profils d’intégration avec des connexions uniques, créez des alias enfants pour gérer différentes configurations et paramètres pour chaque profil d’intégration. Pour plus d'informations, consultez Créez un alias enfant pour configurer plusieurs profils d’intégration.

Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements utilisateur. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.

Créez des autorisations d’utilisation du logiciel pour les modèles logiciels générés automatiquement afin de comparer les logiciels utilisés aux logiciels possédés.

• Pour plus d’informations sur la création d’autorisations d’utilisation du logiciel dans l’interface utilisateur principale, reportez-vous Gestion des actifs logiciels à la section Créer des droits au format Gestion des actifs logiciels classique.
• Pour plus d’informations sur la création d’autorisations d’utilisation du logiciel dans Software Asset Workspace, reportez-vous à la section Créer des droits dans l’espace de travail.
• Pour plus d’informations sur la création d’autorisations d’utilisation du logiciel à l’aide du playbook, reportez-vous à la Gestion des actifs logiciels section Créer des droits à l’aide de la procédure guidée.

Le rapprochement s’exécute également sur vos abonnements en tant que tâche planifiée ou sur demande. Vous pouvez afficher les résultats de votre rapprochement dans la console de licence (Gestion des actifs logiciels application classique) ou dans la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position en matière de conformité de licence et corriger toute non-conformité.

• Pour plus d’informations sur l’exécution du rapprochement dans l’application Gestion des actifs logiciels classique, reportez-vous à la section Exécuter le rapprochement de logiciel au format Gestion des actifs logiciels classique.
• Pour plus d’informations sur l’exécution du rapprochement dans Software Asset Workspace, reportez-vous à la section Exécuter le rapprochement de logiciel dans l’espace de travail.

Créer des profils d’intégration supplémentaires Salesforce Marketing Cloud

Créez un profil d’intégration pour chaque élément supplémentaire Salesforce Marketing Cloud pour lequel vous souhaitez suivre les abonnements logiciels et optimiser la gestion des licences.

Avant de commencer

Pour créer un profil d’intégration Salesforce Marketing Cloud , demandez le module d’extension Gestion des actifs logiciels - Gestion des licences SaaS (sn_sam_saas_int) à partir de ServiceNow Store

Rôle requis : sam_integrator

Salesforce Marketing Cloud Rôle requis : sn_sforce_mc_spoke. Administrateur Salesforce Marketing Cloud

Important :

Vous devez cocher la case Intégration de Gestion des actifs logiciels à Salesforce Marketing Cloud pour cette intégration lors de l’installation des fonctionnalités facultatives sur la Application Manager page. Pour plus d’informations sur le choix des applications SaaS requises, reportez-vous à la section Demander le Gestion des licences SaaS.

Pourquoi et quand exécuter cette tâche

Si vous utilisez Espace de travail des actifs logiciels, l’option permettant de créer le profil d’intégration Salesforce Marketing Cloud dans Interface utilisateur principale est inactive.

Procédure

1. Accédez au profil d’intégration.

   Interface	Action
   Interface utilisateur principale	Accédez à la Tous > Actifs Logiciels > Licence SaaS > Profils d'intégration directe. Sélectionnez Nouveau. Sélectionnez le profil d’intégration Salesforce Marketing Cloud.
   Espace de travail actifs logiciels	Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe. Sélectionnez Nouveau. Sélectionnez Salesforce Marketing Cloud dans la liste déroulante. Sélectionnez Continuer.

2. Remplissez les champs du formulaire.

   Tableau 16. Formulaire Profil d’intégration

   Champ	Description
   Nom d'affichage	Nom du profil d’intégration. Par exemple, profil d’intégration Salesforce Marketing Cloud.
   Type d'authentification	Type d’authentification pour accéder aux Salesforce Marketing Cloud API. Authentification de base OAuth 2.0 : sélectionnez cette valeur. Remarque : Pour un nouveau Salesforce Marketing Cloud profil, le type d’authentification est défini sur Authentification de base par défaut.
   Statut	État du profil d'intégration. Si vous n’avez pas publié le profil d’intégration, ce champ est automatiquement défini sur Brouillon. Si vous avez déjà publié le profil d’intégration, ce champ est automatiquement défini sur Publié.
   Type de profil	Type de profil d'intégration. Cette valeur est automatiquement définie sur l’abonnement Salesforce Marketing Cloud.

3. Examinez les rôles d’utilisateur requis ou les autorisations d’API spécifiés dans le champ de configuration du fournisseur pour chaque processus afin de minimiser les risques de sécurité et d’optimiser SaaS les licences.
   Remarque :

   Pour plus d’informations, consultez la table Autorisations utilisateur minimales .
   1. Dans la section Télécharger le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnements de téléchargement Salesforce Marketing Cloud.
      Remarque :

      La case Télécharger les abonnements est cochée par défaut et vous ne pouvez pas la décocher.
   2. Dans la section Récupérer le flux secondaire de l’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnement à la récupération de Salesforce Marketing Cloud.
      Remarque :

      La case Récupérer les abonnements est cochée par défaut. Si vous ne souhaitez pas récupérer les abonnements, vous pouvez décocher cette case. Si vous l’effacez, les candidats à la suppression sont créés, mais le flux secondaire d’abonnement à la récupération n’est pas déclenché ou le processus de réclamation n’est pas lancé.
   3. Dans la section Flux secondaire de consommation de téléchargement, vérifiez que le champ Flux secondaire est défini sur Consommation de contacts de téléchargement Salesforce Marketing Cloud.
      La case Télécharger la consommation est cochée par défaut. Si vous ne souhaitez pas télécharger les consommations de licence, vous pouvez décocher cette case.
4. Dans la section Attributs d’intégration, ajoutez ou supprimez les attributs en fonction de vos besoins.
   Les attributs nom-valeur tels que Date de décompte, Contacts, Contacts d’e-mail et Contacts mobiles sont automatiquement renseignés pour le profil d’intégration.

   Remarque :

   Le nom de l’attribut doit correspondre à l’en-tête de colonne de rapport dans Salesforce Marketing Cloud l’instance. Pour plus d'informations, consultez Créer une extension de données pour votre rapport sur le nombre de contacts.
5. Sélectionnez Enregistrer.
   Votre ServiceNow instance crée une ébauche de profil d’intégration.

   Le champ Connexion et informations d’identification s’affiche et est automatiquement défini sur sn_sforce_mc_spoke. SalesforceMarketingCloudSOAPConnection.

6. Sélectionnez l’icône d’aperçu en regard du champ Connexion et informations d’identification pour ouvrir l’enregistrement des alias de connexion et d’informations d’identification.
7. Sélectionnez Ouvrir l’enregistrement dans l’aperçu de l’enregistrement.
8. Dans le formulaire Alias de connexion et d’informations d’identification, créez un alias enfant qui peut identifier de manière unique la connexion et les informations d’identification pour ce profil d’intégration.
   Le premier profil d'intégration Salesforce Marketing Cloud que vous créez utilise l'alias de connexion et d'informations d'identification par défaut (parent) pour Salesforce. Chaque profil d’intégration supplémentaire Salesforce Marketing Cloud que vous créez nécessite un alias enfant unique qui permet de différencier la connexion et les informations d’identification des différents profils d’intégration.
   1. Sélectionnez le lien sous Alias enfants > Parentalias=*** pour ajouter des alias enfants.
   2. Sélectionnez Nouveau.
      Le formulaire Alias de connexion et d’informations d’identification pour l’alias enfant s’ouvre.
   3. Donnez un nom à l’alias enfant dans le champ Nom .
   4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis sélectionnez Enregistrer.
   5. Une fois le formulaire rechargé, sélectionnez le lien connexe Create New Connection & Credential (Créer une connexion et des informations d'identification).
9. Renseignez les champs de la boîte de dialogue.

   Tableau 17. Boîte de dialogue Créer une connexion et des informations d’identification

   Champ	Description
   Information de connexion
   Nom de la connexion	Nom de la connexion. Par exemple, connexion SFMC SOAP.
   URL de connexion SOAP	URL de votre point de terminaison de connexion SOAP. Saisissez https://< sous-domaine >.soap.marketingcloudapis.com/Service.asmx où < sous-domaine > est votre Salesforce Marketing Cloud sous-domaine.
   Informations d'identification
   ID client OAuth	ID client que vous avez généré lors de la création d’un Salesforce Marketing Cloud Informations d'identification OAuth.
   Secret client OAuth	Secret client que vous avez récupéré lors de la création des Salesforce Marketing Cloud informations d’identification OAuth.
   URL de redirection OAuth	https://<instance_name>/oauth_redirect.do, où le nom d’instance est le nom de votre ServiceNow instance.
   Informations supplémentaires utilisées pour le post-traitement
   Extension de données du nombre de contacts	Nom de l’extension de données à partir de laquelle vous souhaitez récupérer les données du rapport sur le nombre de contacts. Ce nom doit correspondre exactement au nom de l’extension de données que vous avez créée dans Créer une extension de données pour votre rapport sur le nombre de contacts.

10. Sélectionnez Créer et obtenir un jeton OAuth.
    Remarque :

    Pour connaître le rôle requis pour effectuer cette étape, consultez la table Autorisations utilisateur minimales .
11. Sur le formulaire de profil d’intégration, sélectionnez Valider la connexion pour vérifier les détails de connexion et d’informations d’identification de cette intégration.
    La validation de la connexion vérifie les API Télécharger les abonnements et Télécharger la consommation, mais pas les API Récupérer les abonnements.
12. Une fois la connexion vérifiée, sélectionnez Publier.

Que faire ensuite

Une fois l’intégration connectée, votre ServiceNow instance crée automatiquement des modèles logiciels, des règles de réclamation et des abonnements logiciels qui sont actualisés quotidiennement.

Après avoir créé un profil d’intégration, affichez les informations relatives au profil dans le Espace de travail des actifs logiciels en accédant à Opérations de licence > Abonnement de l'utilisateur > Profils d'intégration directe. Vous pouvez sélectionner un profil d’intégration pour afficher les listes connexes suivantes. Si toutes les listes connexes suivantes ne sont pas visibles pour un profil d’intégration dans la vue par défaut, vous pouvez sélectionner la vue d’intégration personnalisée dans l’onglet Détails :

• Modèles logiciels
• Identificateurs d'abonnement non reconnus
• Travaux planifiés
• Résultats de la tâche planifiée
• Abonnements logiciels
• Règle d'exclusion de l'identificateur d'abonnement
• Règle d'exclusion de l'utilisateur de l'abonnement

Après avoir créé un profil d’intégration, vous pouvez définir des règles d’exclusion des abonnements afin d’exclure certains abonnements du calcul des coûts de licence. Pour plus d'informations, consultez Exclusions d’abonnements pour SaaS les applications SSO et.

Si vous souhaitez configurer plusieurs profils d’intégration avec des connexions uniques, créez des alias enfants pour gérer différentes configurations et paramètres pour chaque profil d’intégration. Pour plus d'informations, consultez Créez un alias enfant pour configurer plusieurs profils d’intégration.

Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements utilisateur. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.

Créez des autorisations d’utilisation du logiciel pour les modèles logiciels générés automatiquement afin de comparer les logiciels utilisés aux logiciels possédés.

• Pour plus d’informations sur la création d’autorisations d’utilisation du logiciel dans l’interface utilisateur principale, reportez-vous Gestion des actifs logiciels à la section Créer des droits au format Gestion des actifs logiciels classique.
• Pour plus d’informations sur la création d’autorisations d’utilisation du logiciel dans Software Asset Workspace, reportez-vous à la section Créer des droits dans l’espace de travail.
• Pour plus d’informations sur la création d’autorisations d’utilisation du logiciel à l’aide du playbook, reportez-vous à la Gestion des actifs logiciels section Créer des droits à l’aide de la procédure guidée.

Le rapprochement s’exécute également sur vos abonnements en tant que tâche planifiée ou sur demande. Vous pouvez afficher les résultats de votre rapprochement dans la console de licence (Gestion des actifs logiciels application classique) ou dans la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position en matière de conformité de licence et corriger toute non-conformité.

• Pour plus d’informations sur l’exécution du rapprochement dans l’application Gestion des actifs logiciels classique, reportez-vous à la section Exécuter le rapprochement de logiciel au format Gestion des actifs logiciels classique.
• Pour plus d’informations sur l’exécution du rapprochement dans Software Asset Workspace, reportez-vous à la section Exécuter le rapprochement de logiciel dans l’espace de travail.