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

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 30 minutes de lecture

    • Intégrez votre ServiceNow instance à Salesforce Marketing Cloud des 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 : Lecture
    Pull user activity (Transférer l’activité utilisateur) Utilisateur Utilisateurs : Lecture
    Récupérer l'abonnement Utilisateur Utilisateurs : Écrire
    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

    Procédure

    1. Connectez-vous au Salesforce Marketing Cloud locataire.
    2. Accédez à la Accueil de la configuration > Outils de 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 : Lecture
      • Utilisateurs : Écrire
      • Extensions de données : Lecture, Écriture
    12. Sélectionnez Enregistrer.
      Votre ID client, votre clé secrète client et votre URI de base SOAP sont affichés dans le résumé de la configuration. Accédez à la section Composants sous COUP MONTÉ > 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 dans l’URI de base SOAP lors de sa transmission dans votre ServiceNow instance.
    13. Sélectionnez l’onglet ACCÈS et confirmez 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 Rapports s’ouvre.
    5. Dans la section Catalogue de rapports, sélectionnez Afficher le catalogue.
    6. Dans le catalogue des 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 7 derniers jours.
    8. Sélectionnez Soumettre.
      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 Le nom du rapport.
      Source des rapports Source du rapport. Ce champ est automatiquement défini sur Nombres de contacts.
      Description La 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. Dans votre liste de rapports, ouvrez votre rapport sur le nombre de contacts nouvellement créé.
      3. Dans la section Options de 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 à exécuter le 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 livraison
        Format Type de fichier et extension de fichier dans lequel vous souhaitez recevoir les résultats du rapport. Sélectionnez 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. Ne cochez pas cette case.
        • Emplacement FTP : emplacement de vos Salesforce Marketing Cloud fichiers FTP. Sélectionnez FTP amélioré ExactTarget afin que le rapport soit enregistré dans votre dossier Rapports SFTP (SSH File Transfer Protocol).
      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 Premiers pas , puis Créer.
      La boîte de dialogue Créer une extension de données s’ouvre.
    5. Renseignez les champs de l’étape Propriétés.
      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 rétention 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 depuis 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 afin d’inclure un identificateur unique pour tous les enregistrements dans 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 de l’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 :
      Ne pas saisir 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 Salesforce Marketing Cloud à l’aide de 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 Nombre de contacts sont facultatifs. Renseignez les champs pour 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 une nouvelle automatisation.
      Le workflow pour 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épart du canevas du workflow.
    5. Définissez un calendrier pour l’automatisation.
      1. Dans la section Source de démarrage du canevas du 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 du nombre de contacts.

        Sélectionnez la même fréquence que celle que vous avez sélectionnée lorsque 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 de la génération du rapport, 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 où l’automatisation peut s’exécuter jusqu’à la fin du calendrier d’automatisation.

        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étition.
      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 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. Renseignez les champs de l’étape Propriétés.
        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é du 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 sur le nombre de contacts du dossier Rapports SFTP vers le dossier d’importation SFTP.
      L’instance Salesforce Marketing Cloud utilise le dossier d’importation SFTP pour localiser et importer des données de rapport dans vos extensions de données. Pour permettre à votre instance d’importer des données du rapport sur le nombre 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 nouvelle activité d’extraction de données.
        La boîte de dialogue Créer une activité d’extraction de données s’ouvre.
      4. Renseignez les champs de l’étape Propriétés.
        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 de 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éé dans Créer un rapport sur le nombre de contacts dans Salesforce Marketing Cloud, y compris l’extension de fichier.
        Type d’extrait 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 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 vers 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 Copie ou Importation de 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 dans 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 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é du 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 renseignez les champs.
        Tableau 11. Champs de fichier d’importation
        Champ Description
        Emplacement du fichier Emplacement du rapport Nombre de contacts depuis lequel vous souhaitez importer des données. Sélectionnez FTP amélioré ExactTarget.
        Modèle d’affectation de nom de fichier Nom de 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 Heure .

        Ce nom doit correspondre exactement au nom de fichier du rapport sur le nombre de contacts que vous avez créé dans 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 de guillemets doubles pour séparer chaque enregistrement, activez l’option Respecter les guillemets doubles (") comme délimiteur de texte .
        Comportement des données incorrectes 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. Dans l’étape Mappage, sélectionnez les options Ajouter et Mettre à jour et Mapper par ordinal dans l’en-tête 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 Marqueur non mappé.
      12. Sélectionnez Suivant.
      13. À l’étape Examiner, 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 l’automatisation de façon unique.
      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 prochains travaux de rapport et d’automatisation planifiés, vous pouvez exécuter ces travaux 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 Générateur d’analyse , puis sélectionnez Rapports.
        La vue d’ensemble de l’application 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 Télécharger).
      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électionnez 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 Nombres de contacts.
      4. Sélectionnez Importer.
      5. Dans la boîte de dialogue Confirmation de l’importation des données, sélectionnez Importer dans l’extension de données , puis sélectionnez OK.
      6. Dans l’étape Importer dans Data Extension, choisissez le fichier que vous avez téléchargé à l’étape 1 précédente.
      7. Sélectionnez Délimiteur comme virgule.
      8. Sélectionnez le type d’importation en tant qu’ajout et mise à jour.
      9. Sélectionnez Options d’importation en tant que 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’extensions de données disponibles avec les colonnes de rapport importées et laissez la colonne Marqueur vide.
      13. Sélectionnez Suivant.
      14. Dans la boîte de dialogue Examiner et créer, saisissez l’ID de l’e-mail sur lequel vous souhaitez recevoir une notification à la fin de l’importation, 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 à l’aide d’OAuth Salesforce Marketing Cloud 2.0 pour suivre les abonnements logiciels et optimiser les Salesforce Marketing Cloud licences expirées du service.

    Avant de commencer

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

    Conseil :
    Pour éviter des coûts d’abonnement supplémentaires, installez le module d’extension et créez l’intégration sur une instance de non-production.

    ServiceNow Rôle requis : sam_integrator ou admin

    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 de 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 Software Asset Workspace, l’option de création du profil d’intégration dans l’interface Salesforce Marketing Cloud utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à la Tout > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez le profil d’intégration Salesforce Marketing Cloud.
      Espace de travail des ressources logicielles
      1. Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez Salesforce Marketing Cloud dans la liste déroulante.
      4. Sélectionnez Continuer.
    2. Renseignez les champs du formulaire.
      Tableau 14. Formulaire Profil d’intégration
      Champ Description
      Nom d'affichage Nom du profil d’intégration. Par exemple, le profil d’intégration Salesforce Marketing Cloud.
      Type d'authentification Type d’authentification pour accéder Salesforce Marketing Cloud aux 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 Table des 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 au téléchargement de Salesforce Marketing Cloud.
        Remarque :
        La case Télécharger les abonnements est cochée par défaut et vous ne pouvez pas la désactiver.
      2. Dans la section Récupérer le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnement de récupération 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 de récupération n’est pas déclenché ou le processus de réclamation n’est pas initié.
      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 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 (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 nouvelle connexion et 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 SOAP SFMC.
      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 d’informations d’identification Salesforce Marketing Cloud 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.

    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éer 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 logicielles pour les modèles logiciels générés automatiquement afin de suivre les logiciels utilisés par rapport aux logiciels possédés.
    Le rapprochement s’exécute également sur vos abonnements en tant que tâche planifiée ou à la demande. Vous pouvez afficher vos résultats de 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é.

    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, demandez le module d’extension Salesforce Marketing CloudGestion des actifs logiciels - Gestion des licences SaaS (sn_sam_saas_int) auprès de ServiceNow Store

    Rôle requis : sam_integrator ou admin

    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 de 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 Software Asset Workspace, l’option de création du profil d’intégration Salesforce Marketing Cloud dans Interface utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à la Tout > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez le profil d’intégration Salesforce Marketing Cloud.
      Espace de travail des ressources logicielles
      1. Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez Salesforce Marketing Cloud dans la liste déroulante.
      4. Sélectionnez Continuer.
    2. Renseignez les champs du formulaire.
      Tableau 16. Formulaire Profil d’intégration
      Champ Description
      Nom d'affichage Nom du profil d’intégration. Par exemple, le profil d’intégration Salesforce Marketing Cloud.
      Type d'authentification Type d’authentification pour accéder Salesforce Marketing Cloud aux 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 Table des 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 au téléchargement de Salesforce Marketing Cloud.
        Remarque :
        La case Télécharger les abonnements est cochée par défaut et vous ne pouvez pas la désactiver.
      2. Dans la section Récupérer le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnement de récupération 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 de récupération n’est pas déclenché ou le processus de réclamation n’est pas initié.
      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 licences, 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 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 (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 SOAP SFMC.
      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 d’informations d’identification Salesforce Marketing Cloud 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.

    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éer 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 logicielles pour les modèles logiciels générés automatiquement afin de suivre les logiciels utilisés par rapport aux logiciels possédés.
    Le rapprochement s’exécute également sur vos abonnements en tant que tâche planifiée ou à la demande. Vous pouvez afficher vos résultats de 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é.