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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 28 minutes de lecture

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

    Important :
    Minimisez les risques de sécurité et protégez les informations en n’accordant l’accès qu’aux utilisateurs ou aux autorisations d’API nécessaires.
    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
    Extraire l’activité utilisateur Utilisateur Utilisateurs : Lecture
    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 Salesforce Marketing Cloud des informations d’identification OAuth 2.0 pour accéder aux Salesforce Marketing Cloud API.

    Avant de commencer

    Rôle requis : Salesforce Marketing Cloud admin

    Procédure

    1. Connectez-vous au Salesforce Marketing Cloud locataire.
    2. Accédez à la Page d’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 périmètres suivants pour votre intégration.
      • Utilisateurs : Lecture
      • Utilisateurs : écriture
      • Extensions de données : lecture, écriture
    12. Sélectionnez Enregistrer.
      Votre ID client, votre secret client et votre URI de base SOAP s’affichent dans le résumé de votre 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é d’affaires 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 Nombres 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 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 Nombres de contacts inclue les données de l’unité business parente et de 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 Générateur d’analyse , 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 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 de 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 Nombre 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 la 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 rapport Nombres de contacts que vous venez de créer.
      3. Dans la section Options de planification, 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 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 de 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 :
          Prenez note de 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 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. Dans l’en-tête de page de votre Salesforce Marketing Cloud instance, pointez 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 les 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 du rapport Nombres de contacts suivantes sont requis :

      Tableau 5. Champs d’attributs
      Champ Description
      Clé primaire Option pour que l’attribut inclue 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 d’attribut.
      Valeur par défaut Valeur par défaut facultative pour l’attribut.

      Pour l’attribut Flag , 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 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 pour toutes les autres colonnes du rapport 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 Nombres de contacts dans votre extension de données

    Créez une automatisation pour importer automatiquement les données du rapport Nombres 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. Dans l’en-tête de page de votre Salesforce Marketing Cloud instance, pointez 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 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émarrage 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émarrage 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 pour qu’elle s’exécute après la génération du rapport Nombres de contacts.

        Sélectionnez la même fréquence que celle que vous avez sélectionnée pendant 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émarrage 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 uniquement lorsque l’option Aucun (exécuter une fois) est sélectionnée dans Répéter.
      3. Sélectionnez Terminé.
    6. Ajoutez une activité de script pour exécuter 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 dans l’étape d’activité de script.
        La boîte de dialogue Choisir une activité de script s’ouvre.
      3. Sélectionnez Créer une nouvelle 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 façon unique l’activité de script.

        Vous pouvez entrer une clé de votre choix.
        Emplacement du dossier L’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 Contacts Counts du dossier SFTP Reports vers le dossier SFTP Import.
      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 les 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 du menu de gauche, faites glisser l’icône d’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 de fichier du rapport Nombres de contacts dont vous souhaitez extraire les 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 la variable Date et de la variable Heure .

        Ce nom doit correspondre exactement au nom de fichier du rapport Nombres 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’extraction Méthode d’extraction des données.

        Définissez ce champ sur Transfert et copie de fichiers 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 \reports\.
        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 la 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 Nombres 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 de copie ou d’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é Copie ou importation de 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. Renseignez les champs de l’étape Informations sur l’activité.
        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 façon 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 du nombre de champs non valide 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 Importer fichier
        Champ Description
        Emplacement du fichier Emplacement du rapport Nombre de contacts à partir duquel vous souhaitez importer des données. Sélectionnez ExactTarget Enhanced FTP.
        Modèle d’affectation de nom de fichier Nom de fichier du rapport Nombres de contacts à partir duquel vous souhaitez importer des données. Ce nom doit correspondre exactement au nom de fichier du rapport Nombres 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 .
        Mauvais comportement des données Option permettant d’ignorer les lignes avec des données incorrectes. Cochez la 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 de 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 Flag 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émarrage 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 Nombres de contacts

    Une fois que vous avez 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 votre rapport planifié et les tâches 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 Nombres de contacts avant le prochain rapport planifié et les prochaines tâches d’automatisation, vous pouvez exécuter ces tâches manuellement.

    Procédure

    1. Exécutez votre rapport Nombres de contacts.
      1. Dans l’en-tête de page de votre Salesforce Marketing Cloud instance, pointez 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 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 Nombre de contacts.
        Format Type de fichier et extension de fichier dans lequel vous souhaitez recevoir les résultats du rapport. Sélectionnez 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. Dans l’en-tête de page de votre Salesforce Marketing Cloud instance, pointez 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 l’extension de données , puis sélectionnez OK.
      6. À 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 Délimiteur sous forme de 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 de rapport importées et laissez la colonne Marqueur vide.
      13. Sélectionnez Suivant.
      14. Dans la boîte de dialogue Réviser et créer, saisissez l’ID d’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 Nombres 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 (com.sn_sam_saas_int) auprès du ServiceNow Store.

    Conseil :
    Pour éviter d’encourir 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

    Pourquoi et quand exécuter cette tâche

    Si vous utilisez Software Asset Workspace, 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.
      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 par défaut sur Authentification de base .
      Connexion et information d'identification Alias de connexion et d'informations d'identification pour Salesforce Marketing Cloud. Ce champ est automatiquement défini sur sn_sforce_mc_spoke. SalesforceMarketingCloudSoapConnection.
      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 Abonnement Salesforce Marketing Cloud.
      Télécharger le flux secondaire d'abonnement
      Flux secondaire Ce champ est automatiquement défini sur Abonnements au téléchargement de Salesforce Marketing Cloud.
      Vous pouvez afficher les événements effectués par des utilisateurs individuels jusqu’à un an avant la date actuelle. Pour plus d'informations, consultez Réviser une règle de réclamation de logiciel.
      Remarque :
      Gestion des actifs logiciels Extrait les événements à partir du moment où vous commencez à télécharger les abonnements utilisateur, quelle que soit la date de création du profil.
      Récupérer le flux secondaire d'abonnement
      Flux secondaire Ce champ est automatiquement défini sur Abonnement de récupération Salesforce Marketing Cloud.
      Télécharger le flux secondaire de consommation
      Flux secondaire Ce champ est automatiquement défini sur Consommation de contacts de téléchargement Salesforce Marketing Cloud.
      Attributs d’intégration
      Attributs Les attributs nom-valeur tels que la date du nombre, les contacts, les contacts d’e-mail et les contacts mobiles sont automatiquement renseignés pour le profil d’intégration.

      Vous pouvez ajouter ou supprimer les attributs en fonction de vos besoins.

      Remarque :
      Le nom de l’attribut doit correspondre à l’en-tête de colonne du 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.
    3. Sélectionnez Enregistrer.
      Votre ServiceNow instance crée une ébauche de profil d’intégration. Le profil d’intégration utilise les flux secondaires de consommation Télécharger les abonnements, Salesforce Marketing Cloud Récupérer l’abonnement Salesforce Marketing Cloud et Salesforce Marketing Cloud Télécharger les contacts pour récupérer les données utilisateur de vos Salesforce Marketing Cloud services.
    4. Ouvrez l’enregistrement des alias de connexion et d’informations d’identification en sélectionnant l’icône d’aperçu ( icône 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.
    5. 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 .
    6. 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. Entrez 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
      Nombres de contacts Extension de données Nom de l’extension de données à partir de laquelle vous souhaitez récupérer les données du rapport Nombres 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.
    7. 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 .
    8. Sélectionnez Enregistrer.
    9. Revenez au profil d’intégration et 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 utilisateur qui sont actualisés quotidiennement.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements des utilisateurs. Pour plus d'informations, consultez Réviser 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 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 de conformité de licence et pour remédier à 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 Salesforce Marketing Cloud , demandez le module d’extension Gestion des actifs logiciels - Gestion des licences SaaS (com.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

    Pourquoi et quand exécuter cette tâche

    Si vous utilisez Software Asset Workspace, 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.
      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 par défaut sur Authentification de base .
      Connexion et information d'identification Alias de connexion et d'informations d'identification pour Salesforce Marketing Cloud. Ce champ est automatiquement défini sur sn_sforce_mc_spoke. SalesforceMarketingCloudSoapConnection.
      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 Abonnement Salesforce Marketing Cloud.
      Télécharger le flux secondaire d'abonnement
      Flux secondaire Ce champ est automatiquement défini sur Abonnements au téléchargement de Salesforce Marketing Cloud.
      Vous pouvez afficher les événements effectués par des utilisateurs individuels jusqu’à un an avant la date actuelle. Pour plus d'informations, consultez Réviser une règle de réclamation de logiciel.
      Remarque :
      Gestion des actifs logiciels Extrait les événements à partir du moment où vous commencez à télécharger les abonnements utilisateur, quelle que soit la date de création du profil.
      Récupérer le flux secondaire d'abonnement
      Flux secondaire Ce champ est automatiquement défini sur Abonnement de récupération Salesforce Marketing Cloud.
      Télécharger le flux secondaire de consommation
      Flux secondaire Ce champ est automatiquement défini sur Consommation de contacts de téléchargement Salesforce Marketing Cloud.
      Attributs d’intégration
      Attributs Les attributs nom-valeur tels que la date du nombre, les contacts, les contacts d’e-mail et les contacts mobiles sont automatiquement renseignés pour le profil d’intégration.
      Vous pouvez ajouter ou supprimer les attributs en fonction de vos besoins.
      Remarque :
      Le nom de l’attribut doit correspondre à l’en-tête de colonne du 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.
    3. Sélectionnez l’icône d’aperçu ( icône d’aperçu) à côté du champ Connexion et informations d’identification pour ouvrir l’enregistrement des alias de connexion et d’informations d’identification.
    4. Sélectionnez Ouvrir l’enregistrement dans l’aperçu de l’enregistrement.
    5. 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).
    6. 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. Entrez 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
      Nombres de contacts Extension de données Nom de l’extension de données à partir de laquelle vous souhaitez récupérer les données du rapport Nombres 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.
    7. 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 .
    8. Sélectionnez Enregistrer.
    9. Revenez au profil d’intégration et 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 utilisateur qui sont actualisés quotidiennement.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements des utilisateurs. Pour plus d'informations, consultez Réviser 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 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 de conformité de licence et pour remédier à toute non-conformité.