OAuth 2.0 を使用した Salesforce Marketing Cloud の統合

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：37分

    • OAuth 2.0 を使用して、 ServiceNow インスタンスを Salesforce Marketing Cloud サービスと統合します。

    重要:
    必要なユーザーまたは API 権限のみにアクセス権を付与することで、セキュリティリスクを最小限に抑え、情報を保護します。
    表 : 1. 最小限のユーザー権限
    プロセス Salesforce Marketing Cloud アプリケーションで必要なユーザーロール 認証スコープ
    サブスクリプションのダウンロード ユーザー ユーザー:読み取り
    ユーザーアクティビティのプル ユーザー ユーザー:読み取り
    サブスクリプションの再利用 ユーザー ユーザー:書き込み
    ダウンロード消費 ユーザー データ拡張:読み取り、書き込み

    Salesforce Marketing Cloud OAuth 2.0 認証情報の作成

    Salesforce Marketing Cloud API にアクセスするための Salesforce Marketing Cloud OAuth 2.0 認証情報を作成します。

    始める前に

    必要なロール：Salesforce Marketing Cloud admin

    手順

    1. Salesforce Marketing Cloud テナントにログインします。
    2. 移動先 ホームのセットアップ > プラットフォームツール > アプリ > インストール済みパッケージ.
    3. [新規] を選択してパッケージを作成します。
    4. [新しいパッケージの詳細] ダイアログボックスで、[ 名前 ] フィールドと [説明] フィールドに入力します。
    5. [保存] を選択します。
    6. [コンポーネントを追加] 選択します。
    7. [API 統合] を選択して、Salesforce Marketing Cloud API をアプリケーションと統合します。
    8. [次へ] を選択します。
    9. 統合タイプとして [サーバー間 (Server-to-Server)] を選択します。
    10. [Next (次へ)] をクリックします。
    11. 統合の次のスコープを選択します。
      • ユーザー:読み取り
      • ユーザー:書き込み
      • データ拡張:読み取り、書き込み
    12. [保存] を選択します。
      クライアント ID、クライアントシークレット、および SOAP ベース URI が構成サマリーに表示されます。[コンポーネント] セクションに移動します。 セットアップ > インストール済みパッケージ > 詳細 をクリックして、クライアント ID、クライアントシークレット、および SOAP ベース URI を表示します。後で使用できるように値をコピーします。
      注:
      注: /Service.asmx を ServiceNow インスタンスに渡すときは、SOAP ベース URI に追加する必要があります。
    13. [ アクセス ] タブを選択し、事業部門が有効になっていることを確認します。

      事業部門が非アクティブな場合は、それを選択して有効にし、 [ 保存] を選択します。

    での連絡先数レポートの作成 Salesforce Marketing Cloud

    連絡先数レポートを作成して、 Salesforce Marketing Cloud アカウント内の請求可能な連絡先の合計数を取得して表示します。

    始める前に

    Salesforce Marketing Cloud 必要なロール：admin

    手順

    1. Web ブラウザーから Salesforce Marketing Cloud インスタンスに移動します。
    2. アドミン認証情報を使用してログインします。
    3. インスタンスのページヘッダーで、事業部門のプロファイルアイコンを選択し、最上位の親事業部門を選択して、連絡先数レポートに親事業部門と対応するすべての子事業部門の両方のデータが含まれるようにします。
    4. 使用可能な Salesforce Marketing Cloud アプリケーションのリストから、 Analytics Builder アプリアイコンを選択し、[ レポート] を選択します。
      レポートアプリの概要が開きます。
    5. 「レポート・カタログ」セクションで、「 カタログの表示」を選択します。
    6. [レポート カタログ] から [連絡先数 ] を検索し、[ 作成] を選択します。
      「レポートを作成」(Create Report) ダイアログボックスが開きます。
    7. ダイアログボックスで、データを取得して表示する期間を [ 日付範囲 ] リストから選択します。
      デフォルト値は [過去 30 日間] です。
      ヒント:
      レポート生成中のパフォーマンスの問題を回避するには、この値を [過去 7 日間] に設定する必要があります。
    8. [Submit (送信)] を選択します。
      Salesforce Marketing Cloudインスタンスはレポートを生成し、[結果:連絡先数] ページに結果を表示します。
    9. [結果: 連絡先数 (Results: Contacts Counts)] ページで、[ 保存] を選択します。
      「レポートを保存」(Save Report) ダイアログボックスが開きます。
    10. ダイアログボックスで、フィールドに入力します。
      表 : 2. [レポートを保存] ダイアログボックス
      フィールド 説明
      レポート名 レポートの名前。
      レポートソース レポートのソース。このフィールドは自動的に [連絡先数] に設定されます。
      説明 レポートの説明。
    11. [保存] を選択します。
    12. 連絡先数レポートを自動的に実行するスケジュールを作成します。
      1. レポート アプリのページ ヘッダーで、 概要 タブを選択して、レポート アプリの概要に戻ります。
      2. レポートのリストから、新しく作成した連絡先数レポートを開きます。
      3. [スケジュール オプション] セクションで、[ 編集] を選択します。
      4. ダイアログボックスで、フィールドに入力します。
        表 : 3. [スケジュールオプションの編集] ダイアログボックス
        フィールド 説明
        スケジュールオプション
        開始 レポートの実行を開始する日時。
        タイムゾーン レポートがスケジュールされているタイムゾーン。
        繰り返し レポートを実行する頻度。毎週日曜日に 1 回実行するようにレポートを設定します。
        終了 レポートの実行を停止する日付。
        配送オプション
        フォーマット レポート結果を受信するファイルタイプとファイル拡張子。データファイル(.csv)を選択します。
        ロケーション レポートを保存または共有する場所。このフィールドを [FTP 用にレポートを保存] に設定し、対応するフィールドに入力します。
        • レポート名:ファイル拡張子を除いたレポートのファイル名。

          レポート名に日付と時刻を含める場合は、 Reportname_YYYYMMDD_HHMMSS 形式で追加します。

          注:
          後で使用するために、このファイル名をメモしておきます。
        • 一意のオプション:SFTP で既存のレポートレコードを置き換える代わりに、レポートレコードを作成するオプション。このチェック ボックスをオフのままにします。
        • FTP の場所: Salesforce Marketing Cloud FTP ファイルの場所。「ExactTarget 拡張 FTP」を選択して、レポートを SFTP (SSH ファイル転送プロトコル) レポートフォルダーに保存します。
      5. [保存] を選択します。

    コンタクト数レポートのデータエクステンションの作成

    データエクステンションを作成して、コンタクト数レポートデータを Salesforce Marketing Cloud インスタンスに保存します。

    始める前に

    Salesforce Marketing Cloud 必要なロール：admin

    このタスクについて

    データエクステンションは、レポートデータを表す属性を含むテーブルです。ServiceNow インスタンスが Salesforce Marketing Cloud サービスに接続すると、このデータエクステンションからデータが取得されます。

    手順

    1. Salesforce Marketing Cloudインスタンスのページヘッダーで、Salesforceアイコンにカーソルを合わせると、使用可能なSalesforce Marketing Cloudアプリケーションのリストが表示されます。
    2. Audience Builder アプリアイコンを選択し、[Contact Builder] を選択します。
      Contact Builder アプリが開きます。
    3. [ データエクステンション ] タブを選択します。
    4. ポップアップ ダイアログ ボックスで、 [ 開始] を選択し、 [ 作成] を選択します。
      [新しいデータ拡張を作成 (Create New Data Extension)] ダイアログボックスが開きます。
    5. [プロパティ] ステップで、フィールドに入力します。
      表 : 4. プロパティフィールド
      フィールド 説明
      作成方法 データエクステンションを作成する方法。

      [ 新規作成] を選択します。
      名前 データ拡張の名前。
      外部キー データエクステンションを一意に識別するオプションのキー。

      任意のキーを入力できます。
      Description (説明) データ拡張の説明。
      タイプ データ拡張のタイプ。

      このフィールドは自動的に [標準] に設定されます。
      場所 データエクステンションを保存する場所。

      このフィールドは自動的に [データ拡張] に設定されます。別の場所を選択するには、[ 場所を変更 ] を選択します。
      送信可能ですか? データエクステンションを登録者に送信できるかどうかを示すオプション。
    6. [Next (次へ)] をクリックします。
    7. 「データ保持ポリシー」ステップで、「 保持設定 」フィールドを 「オフ」に設定します。
    8. [Next (次へ)] をクリックします。
    9. [属性] ステップで、データエクステンションに含める属性を追加します。
      属性は、レポートからデータエクステンションにデータをマッピングしてインポートするために使用されます。データのインポート元のレポート列ごとに属性を作成する必要があります。各属性名は、対応するレポート列名と正確に一致する必要があります。

      Salesforce Marketing Cloud統合では、次の連絡先数レポート列の属性が必要です。

      表 : 5. 属性フィールド
      フィールド 説明
      プライマリキー データエクステンションのすべてのレコードに一意の識別子を含める属性のオプション。

      このオプションは、 Count_Date 属性に対して有効にする必要があります。
      名前 属性の名前。

      この名前は、対応するレポート列名と正確に一致する必要があります。
      データタイプ 属性のデータタイプ。
      必須 属性にデータ拡張の各レコードの値が必要かどうかを示すオプション。
      長さ 属性値に許可される最大文字数。
      デフォルト値 属性のオプションのデフォルト値。

      Flag 属性のデフォルト値を 1 に設定します。

      注:
      プライマリキーとして割り当てられる属性にはデフォルト値を入力しないでください。
      名前 データ タイプ
      Count_Date テキスト
      Total_Distinct_Contacts_Count テキスト
      Total_Distinct_Email_Addresses1 テキスト
      Total_Distinct_Mobile_Addresses_Count テキスト
      フラグ テキスト
      注:
      属性を追加できますが、名前は統合属性と同じである必要があります。詳細については、「ベーシック認証を使用した Salesforce Marketing Cloud 統合プロファイルの作成」または「OAuth 2.0 を使用した Salesforce Marketing Cloud 統合プロファイルの作成」を参照してください。
      他のすべての接触者数レポート列の属性はオプションです。追加する各属性のフィールドに入力します。
    10. [完了] を選択します。
    11. [作成されたデータエクステンション (Data Extension Created)] ダイアログボックスで、[ OK] を選択します。

    データエクステンションで連絡先数レポートデータをインポートする自動化の構築

    レポートの生成後に連絡先数レポートデータをデータエクステンションに自動的にインポートする自動化を作成します。

    始める前に

    Salesforce Marketing Cloud 必要なロール：admin

    手順

    1. Salesforce Marketing Cloudインスタンスのページヘッダーで、Salesforceアイコンにカーソルを合わせると、使用可能なSalesforce Marketing Cloudアプリケーションのリストが表示されます。
    2. Journey Builder アプリアイコンを選択し、[Automation Studio] を選択します。
      Automation Studio アプリの概要が開きます。
    3. [新しい自動化] を選択します。
      新しい自動化のワークフローが開きます。
    4. 左側のメニューペインの [開始ソース] セクションからワークフローキャンバスの [開始ソース] セクションに [ スケジュール ] アイコンをドラッグして、自動化スケジュールを作成します。
    5. 自動化のスケジュールを定義します。
      1. ワークフロー キャンバスの [Starting Source] セクションで、[ Configure] を選択します。
      2. ダイアログボックスで、フィールドに入力します。
        表 : 6. [スケジュールの定義] ダイアログボックス
        フィールド 説明
        開始日 自動化の実行を開始する日付。
        開始時間 自動化の実行を開始する時刻。
        タイムゾーン 自動化がスケジュールされているタイムゾーン。
        繰り返し 自動化を実行する頻度。連絡先数レポートが生成された後に実行されるように自動化を設定します。

        選択したものと同じ周波数を選択します での連絡先数レポートの作成 Salesforce Marketing Cloud.

        ヒント:
        レポートが生成されたのと同じ日に自動化を実行するように構成する場合は、レポートの生成が完了するのに十分な時間がある開始時間を選択します。 ServiceNow では、開始時刻をレポート開始時刻の少なくとも 2 時間後にすることを推奨しています。
        終了 自動化スケジュールが終了するまでに自動化を実行できる回数。

        自動化スケジュールを終了しない場合は、このフィールドを [なし] に設定します。

        このフィールドは、[繰り返し] で [なし (1 回実行)] が選択されている場合にのみ表示されません。
      3. [完了] を選択します。
    6. スクリプト アクティビティを追加し、それを必要とするすべてのアクティビティに対してサーバー側 JavaScript を実行します。
      1. 左側のメニューペインの [アクティビティ] セクションで、[ スクリプト ] アイコンをワークフローキャンバスにドラッグします。
        スクリプトアクティビティは、自動化ワークフローの最初のステップになります。
      2. スクリプトアクティビティステップで [選択] を選択します。
        [スクリプトアクティビティを選択] ダイアログボックスが開きます。
      3. [ Create New Script Activity] を選択します。
        [Create New Script Activity] ダイアログボックスが開きます。
      4. [プロパティ] ステップで、フィールドに入力します。
        表 : 7. プロパティフィールド
        フィールド 説明
        名前 スクリプトアクティビティの名前。
        外部キー スクリプトアクティビティを一意に識別するオプションのキー。

        任意のキーを入力できます。
        フォルダーの場所 スクリプトを保存する場所。別の場所を選択するには 、[選択... ] を選択します。

        このフィールドは自動的に [スクリプト] に設定されます。
        Description (説明) スクリプトアクティビティの説明。
      5. 次のサーバーサイド JavaScript をコピーして、[サーバーサイド JavaScript] テキストボックスに貼り付けます。 
        <script runat="server"> 
var rows = Platform.Function.DeleteData('*<data-extension-name>*',['Flag'],['1']);
</script>

        *<data-extension-name>*は、コンタクト数レポートのデータエクステンションの作成で作成したデータエクステンションのファイル名と完全に一致する必要があります。

      6. [ 構文を検証 ] を選択して、サーバー側の JavaScript 構文が有効であることを確認します。
      7. [Next (次へ)] をクリックします。
      8. [ 概要 ] ステップで、スクリプトアクティビティの構成が正しいことを確認し、[ 完了] を選択します。
    7. [連絡先数] レポートを [SFTP レポート] フォルダーから [SFTP インポート] フォルダーにコピーするデータ抽出アクティビティを追加します。
      Salesforce Marketing Cloudインスタンスは、SFTP インポートフォルダーを使用してレポートデータを検索し、データエクステンションにインポートします。インスタンスで連絡先数レポートから対応するデータエクステンションにデータをインポートできるようにするには、レポートを SFTP インポートフォルダーにコピーする必要があります。
      1. 左側のメニュー ウィンドウの [アクティビティ] セクションで、[ データ抽出 ] アイコンをワークフロー キャンバスにドラッグします。
        データ抽出アクティビティは、自動化ワークフローの 2 番目のステップになります。
      2. データ抽出アクティビティステップで [選択 ] を選択します。
        [データ抽出アクティビティを選択 (Choose Data Extract Activity)] ダイアログボックスが開きます。
      3. [ Create New Data Extract Activity (新しいデータ抽出アクティビティを作成)] を選択します。
        [新しいデータ抽出アクティビティを作成 (Create New Data Extract Activity)] ダイアログボックスが開きます。
      4. [プロパティ] ステップで、フィールドに入力します。
        表 : 8. プロパティフィールド
        フィールド 説明
        名前 データ抽出アクティビティの名前。
        外部キー データ抽出アクティビティを一意に識別するオプションのキー。

        任意のキーを入力できます。
        ファイル命名パターン データを抽出する連絡先数レポートのファイル名。

        レポート名に日付と時刻を含める場合は、[日付変数] フィールドと [時刻変数] フィールドを選択して、Reportname_YYYYMMDD_HHMMSS形式で追加します。

        この名前は、 での連絡先数レポートの作成 Salesforce Marketing Cloud で作成した連絡先数レポートのファイル名 (ファイル拡張子を含む) と完全に一致する必要があります。
        抽出タイプ データ抽出方法。

        このフィールドを [拡張 FTP ファイルの移動とコピー] に設定します。
        説明 データ抽出アクティビティの説明。
      5. [Next (次へ)] をクリックします。
      6. [構成] ステップで、フィールドに入力します。
        表 : 9. 構成フィールド
        フィールド 説明
        入力フォルダー 連絡先数レポートを保存した場所。「\reports\」と入力します。
        出力フォルダー レポートのコピー先となる場所。「\Import\」と入力します。
        フォルダーにコピー 入力フォルダーから出力フォルダーにレポートを移動するのではなく、コピーするオプション。このオプションを使用すると、レポートを両方の場所に保持できます。このオプションを有効にするには、このチェックボックスをオンにします。
      7. [Next (次へ)] をクリックします。
      8. [概要] ステップで、データ抽出アクティビティの構成が正しいことを確認し、 [ 完了] を選択します。
    8. ファイルインポートアクティビティを追加して、連絡先数レポートデータをデータエクステンションにインポートします。
      1. 左側のメニューペインの [アクティビティ] セクションで、[ データのコピー] または [インポート ] アイコンをワークフローキャンバスにドラッグします。
        [データのコピーまたはインポート] アクティビティは、自動化ワークフローの 3 番目のステップになります。
      2. [Data Copy or Import (データのコピーまたはインポート)] アクティビティステップで [Choose (選択)] を選択します。
        [データのコピーまたはインポートを選択] ダイアログボックスが開きます。
      3. [ 新しいコピーまたはインポート定義の作成] を選択します。
        「新規コピーまたはインポート定義を作成」(Create New Copy or Import Definition) ダイアログボックスが開きます。
      4. [アクティビティ情報] ステップで、フィールドに入力します。
        表 : 10. アクティビティ情報フィールド
        フィールド 説明
        名前 ファイルインポートアクティビティの名前。
        説明 ファイルのインポートアクティビティの説明。
        外部キー インポートファイルアクティビティを一意に識別するオプションのキー。

        任意のキーを入力できます。
        通知メールの送信先 インポートが完了したときに通知を送信するメールアドレス。
        メールアドレスを指定すると、インポートが正常に完了したときに、挿入および更新された行の数を含む通知メールがそのアドレスに送信されます。
        重要:
        インポートされた CSV ファイルに空の行が存在するため、通知メールに無効な フィールド数の 検証エラーが含まれています。これらの空の行は、レポートを FTP に保存すると自動的に表示されます。ただし、統合には影響しません。
      5. [Next (次へ)] をクリックします。
      6. 「ソース」ステップで、「データソース」ヘッダーの 「ファイルの場所 」を選択し、フィールドに入力します。
        表 : 11. [ファイルをインポート] フィールド
        フィールド 説明
        ファイルの場所 データのインポート元の連絡先数レポートの場所。「ExactTarget 拡張 FTP」を選択します。
        ファイル命名パターン データのインポート元の連絡先数レポートのファイル名。この名前は、 での連絡先数レポートの作成 Salesforce Marketing Cloud で作成した連絡先数レポートのファイル名 (ファイル拡張子を含む) と完全に一致する必要があります。
        日付形式 レポートデータの日時を表示する形式。
        区切り文字 各レポートレコードを区切る形式。各レコードをカンマで区切るには 、カンマ を選択します。

        二重引用符を使用して各レコードを区切る場合は、[ 二重引用符 (") をテキスト区切り文字として尊重 する] オプションを有効にします。
        不適切なデータ動作 不正なデータを含む行をスキップするオプション。このオプションを有効にするには、このチェックボックスをオンにします。
      7. [Next (次へ)] をクリックします。
      8. [宛先] ステップで、 コンタクト数レポートのデータエクステンションの作成 で作成したデータエクステンションを検索して選択します。
      9. [Next (次へ)] をクリックします。
      10. [マッピング] ステップで、[データアクション] ヘッダーの [ 追加] および [更新 ] および [序 数でマップ ] オプションを選択します。
      11. プロンプトが表示されたら、[ インポートファイルに列ヘッダーがあります ] オプションを有効にし、各データ拡張属性を連絡先数レポートの対応する列番号にマッピングします。
        注:
        Flag 属性はマップしないままにします。
      12. [Next (次へ)] をクリックします。
      13. [ 確認 ] ステップで、ファイルのインポートアクティビティ構成が正しいことを確認し、[ 完了] を選択します。
    9. [保存] を選択します。
    10. ダイアログボックスで、フィールドに入力します。
      表 : 12. [自動化を保存] ダイアログボックス
      フィールド 説明
      名前 自動化の名前。
      説明 自動化の説明。
      外部キー 自動化を一意に識別するオプションのキー。
      ロケーション 自動化を保存する場所。
    11. [保存] を選択します。
    12. ワークフロー キャンバスの [開始ソース] セクションで、[ アクティブ] を選択します。
    13. [スケジュール確認のアクティブ化 (Activate Schedule Confirmation)] ダイアログボックスで、[ アクティブ化 (Activate )] を選択して自動化スケジュールをアクティブ化します。

    連絡先数レポートデータを手動で取得する

    連絡先数レポート、データエクステンション、および自動化を作成した後、これらのジョブを手動で実行することで、スケジュール済みレポートと自動化ジョブ間でレポートデータを取得できます。

    始める前に

    Salesforce Marketing Cloud 必要なロール：admin

    このタスクについて

    Salesforce Marketing Cloudインスタンスは、定義したスケジュールに基づいてレポートと自動化ジョブを自動的に実行します。次のスケジュール済みレポートおよび自動化ジョブの前に連絡先数レポートデータを取得する場合は、これらのジョブを手動で実行できます。

    手順

    1. 連絡先数レポートを実行します。
      1. Salesforce Marketing Cloudインスタンスのページヘッダーで、Salesforceアイコンにカーソルを合わせると、使用可能なSalesforce Marketing Cloudアプリケーションのリストが表示されます。
      2. Analytics Builder アプリアイコンを選択し、[レポート] を選択します。
        レポートアプリの概要が開きます。
      3. レポートのリストから、 での連絡先数レポートの作成 Salesforce Marketing Cloud で作成した連絡先数レポートを選択します。
      4. [Run (実行)] をクリックします。
        <c0/> インスタンスがレポートを生成し、結果を [結果: <report-name> ページに表示します。Salesforce Marketing Cloud
      5. [結果:<report-name> ページで、[結果のダウンロード] アイコン ( [ダウンロード] アイコン) を選択します。
      6. ダイアログボックスで、フィールドに入力します。
        表 : 13. [結果のダウンロード] ダイアログボックス
        Field (フィールド) 説明
        ファイル名 レポートのファイル名 (ファイル拡張子を除く)。
        レポートソース レポートのソース。このフィールドは自動的に [連絡先数] に設定されます。
        フォーマット レポート結果を受信するファイルタイプとファイル拡張子。データファイル(.csv)を選択します。
      7. [保存] を選択します。
      8. ファイルをシステムに保存します。
    2. データをデータエクステンションにインポートします。
      1. Salesforce Marketing Cloudインスタンスのページヘッダーで、Salesforceアイコンにカーソルを合わせると、使用可能なSalesforce Marketing Cloudアプリケーションのリストが表示されます。
      2. Audience Builder アプリアイコンを選択し、[Contact Builder] を選択します。
      3. 連絡先数レポートのデータエクステンションの作成中に作成した、最近作成したデータエクステンションを開きます。
      4. [インポート] を選択します。
      5. [データのインポートの確認] ダイアログ ボックスで、[ データ拡張にインポート ] を選択し、[ OK] を選択します。
      6. [データ拡張にインポート] ステップで、前のステップ 1 でダウンロードしたファイルを選択します。
      7. [区切り文字] をカンマとして選択します。
      8. [インポートタイプ] で [追加] および [更新] を選択します。
      9. [ インポートオプション ] で [不正なデータを含むインポートファイルの行をスキップ] を選択します。
      10. [Next (次へ)] をクリックします。
      11. [マッピングの構成] ダイアログボックスで、[ 手動でマッピング] を選択します。
      12. 利用可能なデータエクステンション列をインポートされたレポート列と照合し、[フラグ] 列は空のままにします。
      13. [Next (次へ)] をクリックします。
      14. [確認と作成] ダイアログボックスで、インポート完了時に通知するメール ID を入力し、[ 完了] を選択します。
      15. [実行の確認] ダイアログ ボックスで、[ 完了] を選択します。

    タスクの結果

    最新の接触者数レポートデータがデータエクステンションにインポートされます。

    OAuth 2.0 を使用した Salesforce Marketing Cloud 統合プロファイルの作成

    OAuth 2.0 を使用して Salesforce Marketing Cloud 統合プロファイルを作成し、ソフトウェアサブスクリプションを追跡し、 Salesforce Marketing Cloud サービスの古いライセンスを最適化します。

    始める前に

    Salesforce Marketing Cloud統合プロファイルを作成するには、ServiceNow Store から ソフトウェア資産管理SaaS ライセンス管理 プラグイン (com.sn_sam_saas_int) を要求します。

    ヒント:
    追加のサブスクリプションコストが発生しないようにするには、プラグインをインストールし、非本番インスタンスで統合をビルドします。

    ServiceNow 必要なロール:sam_integrator または admin

    Salesforce Marketing Cloud 必要なロール:sn_sforce_mc_spokeSalesforce マーケティングクラウドアドミン

    このタスクについて

    ソフトウェア資産ワークスペースを使用している場合、コア UI でSalesforce Marketing Cloud統合プロファイルを作成するオプションは無効です。

    手順

    1. 統合プロファイルに移動します。
      インターフェイスアクション
      コア UI
      1. 移動先 すべて > ソフトウェア資産 > SaaS ライセンス > 直接統合プロファイル.
      2. [新規] を選択します。
      3. [Salesforce マーケティングクラウド統合プロファイル] を選択します。
      Software Asset Workspace
      1. 移動先 ライセンス操作 > ユーザー登録 > 直接統合プロファイル.
      2. [新規] を選択します。
      3. ドロップダウンリストから [Salesforce マーケティングクラウド ] を選択します。
      4. [続行] を選択します。
    2. フォームのフィールドに入力します。
      表 : 14. 統合プロファイルフォーム
      フィールド 説明
      表示名 データ連携プロファイルの名前たとえば、Salesforce Marketing Cloud 統合プロファイルなどです。
      認証タイプ Salesforce Marketing Cloud API にアクセスするための認証のタイプ。
      • ベーシック認証
      • OAuth 2.0:この値を選択します。
      注:
      新しい Salesforce Marketing Cloud プロファイルの場合、認証タイプはデフォルトで [基本認証 ] に設定されます。
      接続と認証情報 Salesforce Marketing Cloud の接続および資格情報エイリアス。このフィールドは自動的に sn_sforce_mc_spoke に設定されます。SalesforceMarketingCloudSoapConnection
      ステータス 統合プロファイルのステータス。
      • 統合プロファイルを公開していない場合、このフィールドは自動的に [ドラフト] に設定されます。
      • 統合プロファイルを既に公開している場合、このフィールドは自動的に [公開済み] に設定されます。
      プロファイルタイプ 統合プロファイルのタイプ。この値は、 Salesforce マーケティングクラウドサブスクリプションに自動的に設定されます。
      サブスクリプションサブフローをダウンロード
      サブフロー このフィールドは、 自動的に [Salesforce マーケティングクラウドダウンロードサブスクリプション] に設定されます。
      個々のユーザーが実行したイベントは、現在の日付の 1 年前まで表示できます。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。
      注:
      ソフトウェア資産管理 は、プロファイルの作成日に関係なく、ユーザーサブスクリプションのダウンロードを開始した時点からのイベントをプルします。
      サブスクリプションサブフローの再利用
      サブフロー このフィールドは自動的に [Salesforce Marketing Cloud Reclaim Subscription] に設定されます。
      消費サブフローのダウンロード
      サブフロー このフィールドは、 自動的に [Salesforce マーケティングクラウドダウンロード連絡先の消費] に設定されます。
      統合属性
      属性 カウント日、連絡先、メール連絡先、モバイル連絡先などの名前と値の属性は、統合プロファイルに自動的に入力されます。

      要件に基づいて属性を追加または削除できます。

      注:
      属性名は、インスタンス Salesforce Marketing Cloud レポートの列ヘッダーと一致する必要があります。詳細については、「コンタクト数レポートのデータエクステンションの作成」を参照してください。
    3. [保存] を選択します。
      ServiceNowインスタンスはドラフト統合プロファイルを作成します。統合プロファイルは、 Salesforce Marketing Cloud Download Subscriptions、 Salesforce Marketing Cloud Reclaim Subscription、 Salesforce Marketing Cloud Download Contacts Consumption サブフローを使用して、 Salesforce Marketing Cloud サービスからユーザーデータを取得します。
    4. [接続および資格情報] フィールドの横にあるプレビューアイコン (プレビューアイコン)を選択し、レコードプレビューで [レコードを開く] を選択して、接続および資格情報エイリアスレコードを開きます。
    5. [接続および資格情報エイリアス] フォームで、[ 新しい接続および資格情報の作成 ] 関連リンクを選択します。
    6. ダイアログボックスで、フィールドに入力します。
      表 : 15. [接続と資格情報を作成] ダイアログボックス
      フィールド 説明
      接続情報
      接続名 接続の名前。例：SFMC SOAP 接続。
      SOAP 接続 URL SOAP 接続エンドポイントの URL。「https://<subdomain>.soap.marketingcloudapis.com/Service.asmx」と入力します。ここで、<subdomain> は Salesforce Marketing Cloud サブドメインです。
      認証情報
      OAuth クライアント ID の作成中に生成したクライアント ID Salesforce Marketing Cloud OAuth 認証情報.
      OAuth クライアントシークレット Salesforce Marketing Cloud OAuth 認証情報の作成時に取得したクライアントシークレットです。
      OAuth リダイレクト URL https://<instance_name>/oauth_redirect.do。ここで、インスタンス名は<c1/>インスタンスの名前です。ServiceNow
      後処理に使用される追加情報
      連絡先数データエクステンション (Contacts Counts Data Extension) 連絡先数のレポートデータを取得するデータエクステンションの名前。この名前は、 コンタクト数レポートのデータエクステンションの作成 で作成したデータエクステンションの名前と完全に一致する必要があります。
    7. [OAuth トークンを作成して取得] を選択します。
      注:
      この手順を実行するために必要なロールについては、「 最小限のユーザー権限 」の表を参照してください。
    8. [保存] を選択します。
    9. 統合プロファイルに戻り、 [ 公開] を選択します。

    次のタスク

    統合が接続されると、 ServiceNow インスタンスは、毎日更新されるソフトウェアモデル、再利用ルール、およびユーザーサブスクリプションを自動的に作成します。

    ユーザーサブスクリプションを再利用するには、自動的に生成されたすべての再利用ルールを確認します。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。

    自動的に生成されたソフトウェアモデルのソフトウェアエンタイトルメントを作成して、所有ソフトウェアに対して使用されたソフトウェアを追跡します。
    調整は、スケジュール済みジョブとして、またはオンデマンドでサブスクリプションに対して実行することもできます。調整結果は、ライセンスワークベンチ (クラシックアプリケーション) またはライセンス使用状況ビュー (ソフトウェア資産ワークスペース) ソフトウェア資産管理表示できます。これらの結果を使用して、ライセンスのコンプライアンス状況を判断し、コンプライアンス違反を修正します。

    追加の Salesforce Marketing Cloud 統合プロファイルの作成

    ソフトウェアサブスクリプションを追跡してライセンスを最適化する追加の Salesforce Marketing Cloud ごとに統合プロファイルを作成します。

    始める前に

    Salesforce Marketing Cloud統合プロファイルを作成するには、 から ソフトウェア資産管理 - SaaS ライセンス管理 プラグイン (com.sn_sam_saas_int) を要求します ServiceNow Store

    必要なロール:sam_integrator または admin

    Salesforce Marketing Cloud 必要なロール:sn_sforce_mc_spokeSalesforce マーケティングクラウドアドミン

    このタスクについて

    ソフトウェア資産ワークスペースを使用している場合、コア UI でSalesforce Marketing Cloud統合プロファイルを作成するオプションは無効です。

    手順

    1. 統合プロファイルに移動します。
      インターフェイスアクション
      コア UI
      1. 移動先 すべて > ソフトウェア資産 > SaaS ライセンス > 直接統合プロファイル.
      2. [新規] を選択します。
      3. [Salesforce マーケティングクラウド統合プロファイル] を選択します。
      Software Asset Workspace
      1. 移動先 ライセンス操作 > ユーザー登録 > 直接統合プロファイル.
      2. [新規] を選択します。
      3. ドロップダウンリストから [Salesforce マーケティングクラウド ] を選択します。
      4. [続行] を選択します。
    2. フォームのフィールドに入力します。
      表 : 16. 統合プロファイルフォーム
      フィールド 説明
      表示名 データ連携プロファイルの名前たとえば、Salesforce Marketing Cloud 統合プロファイルなどです。
      認証タイプ Salesforce Marketing Cloud API にアクセスするための認証のタイプ。
      • ベーシック認証
      • OAuth 2.0:この値を選択します。
      注:
      新しい Salesforce Marketing Cloud プロファイルの場合、認証タイプはデフォルトで [基本認証 ] に設定されます。
      接続と認証情報 Salesforce Marketing Cloud の接続および資格情報エイリアス。このフィールドは自動的に sn_sforce_mc_spoke に設定されます。SalesforceMarketingCloudSoapConnection
      ステータス 統合プロファイルのステータス。
      • 統合プロファイルを公開していない場合、このフィールドは自動的に [ドラフト] に設定されます。
      • 統合プロファイルを既に公開している場合、このフィールドは自動的に [公開済み] に設定されます。
      プロファイルタイプ 統合プロファイルのタイプ。この値は、 Salesforce マーケティングクラウドサブスクリプションに自動的に設定されます。
      サブスクリプションサブフローをダウンロード
      サブフロー このフィールドは、 自動的に [Salesforce マーケティングクラウドダウンロードサブスクリプション] に設定されます。
      個々のユーザーが実行したイベントは、現在の日付の 1 年前まで表示できます。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。
      注:
      ソフトウェア資産管理 は、プロファイルの作成日に関係なく、ユーザーサブスクリプションのダウンロードを開始した時点からのイベントをプルします。
      サブスクリプションサブフローの再利用
      サブフロー このフィールドは自動的に [Salesforce Marketing Cloud Reclaim Subscription] に設定されます。
      消費サブフローのダウンロード
      サブフロー このフィールドは、 自動的に [Salesforce マーケティングクラウドダウンロード連絡先の消費] に設定されます。
      統合属性
      属性 カウント日、連絡先、メール連絡先、モバイル連絡先などの名前と値の属性は、統合プロファイルに自動的に入力されます。
      要件に基づいて属性を追加または削除できます。
      注:
      属性名は、インスタンス Salesforce Marketing Cloud レポートの列ヘッダーと一致する必要があります。詳細については、「コンタクト数レポートのデータエクステンションの作成」を参照してください。
    3. [接続および資格情報] フィールドの横にあるプレビューアイコン (プレビューアイコン) を選択して、接続および資格情報エイリアスレコードを開きます。
    4. レコードプレビューで [ レコードを開く ] を選択します。
    5. [接続および資格情報エイリアス] フォームで、この統合プロファイルの接続と資格情報を一意に識別できる子エイリアスを作成します。
      作成する最初の Salesforce Marketing Cloud 統合プロファイルでは、Salesforce にデフォルト (親) 接続および資格情報エイリアスを使用します。作成する追加の Salesforce Marketing Cloud 統合プロファイルごとに、各統合プロファイル間の接続と資格情報を区別するのに役立つ一意の子エイリアスが必要です。
      1. 下のリンクを選択します 子エイリアス > Parentalias=*** 子エイリアスを追加します。
      2. [新規] を選択します。
        子エイリアスの [接続および資格情報エイリアス] フォームが開きます。
      3. [ 名前 ] フィールドに子エイリアスの名前を入力します。
      4. フォームヘッダーを右クリックし、[保存] を選択します。
      5. フォームを再ロードした後に、[新しい接続および資格情報の作成] 関連リンクを選択します。
    6. ダイアログボックスで、フィールドに入力します。
      表 : 17. [接続と資格情報を作成] ダイアログボックス
      フィールド 説明
      接続情報
      接続名 接続の名前。例：SFMC SOAP 接続。
      SOAP 接続 URL SOAP 接続エンドポイントの URL。「https://<subdomain>.soap.marketingcloudapis.com/Service.asmx」と入力します。ここで、<subdomain> は Salesforce Marketing Cloud サブドメインです。
      認証情報
      OAuth クライアント ID の作成中に生成したクライアント ID Salesforce Marketing Cloud OAuth 認証情報.
      OAuth クライアントシークレット Salesforce Marketing Cloud OAuth 認証情報の作成時に取得したクライアントシークレットです。
      OAuth リダイレクト URL https://<instance_name>/oauth_redirect.do。ここで、インスタンス名は<c1/>インスタンスの名前です。ServiceNow
      後処理に使用される追加情報
      連絡先数データエクステンション (Contacts Counts Data Extension) 連絡先数のレポートデータを取得するデータエクステンションの名前。この名前は、 コンタクト数レポートのデータエクステンションの作成 で作成したデータエクステンションの名前と完全に一致する必要があります。
    7. [OAuth トークンを作成して取得] を選択します。
      注:
      この手順を実行するために必要なロールについては、「 最小限のユーザー権限 」の表を参照してください。
    8. [保存] を選択します。
    9. 統合プロファイルに戻り、 [ 公開] を選択します。

    次のタスク

    統合が接続されると、 ServiceNow インスタンスは、毎日更新されるソフトウェアモデル、再利用ルール、およびユーザーサブスクリプションを自動的に作成します。

    ユーザーサブスクリプションを再利用するには、自動的に生成されたすべての再利用ルールを確認します。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。

    自動的に生成されたソフトウェアモデルのソフトウェアエンタイトルメントを作成して、所有ソフトウェアに対して使用されたソフトウェアを追跡します。
    調整は、スケジュール済みジョブとして、またはオンデマンドでサブスクリプションに対して実行することもできます。調整結果は、ライセンスワークベンチ (クラシックアプリケーション) またはライセンス使用状況ビュー (ソフトウェア資産ワークスペース) ソフトウェア資産管理表示できます。これらの結果を使用して、ライセンスのコンプライアンス状況を判断し、コンプライアンス違反を修正します。