Campaign と Microsoft Dynamics 365 の連携 crm-ms-dynamics

クロスチャネル通信で CRM データをアクティブ化します。Microsoft Dynamics 365 から Adobe Campaign に連絡先を渡し、キャンペーンパフォーマンスデータ(送信、開封、クリックおよびバウンス)を Adobe Campaign に戻り Microsoft Dynamics 365 に共有する方法を学びます。

設定が完了したら、専用のワークフローアクティビティでシステム間のデータ同期を実行します。詳細情報

NOTE
サポートされている Microsoft Dynamics のバージョンについて詳しくは、Campaign の互換性マトリックスを参照してください。

次の手順に従って、Microsoft Dynamics 365 データを Adobe Campaign にインポートおよびエクスポートするための、専用の外部アカウントを設定します。

システムごとに、管理者がこれらの手順を実行する必要があります。

CAUTION
このドキュメントの手順では、権限の割り当てや管理者アクセスに関連する統合/登録の作成手順を説明します。お客様の責任として、事前に会社のポリシーに従って手順を確認し、慎重に実行する必要があります。

Microsoft Dynamics 365 の設定 config-crm-microsoft

Web API 経由で Microsoft Dynamics 365 を Adobe Campaign と連携させるには、グローバル管理者 ​資格情報を使用して、Microsoft Azure Directory にログオンし、次の手順に従います。

  1. Dynamics 365 アプリケーション(クライアント)ID を取得します。詳細情報
  2. Microsoft Dynamics 証明書キー識別子およびキー ID を生成します。詳細情報
  3. 権限を設定します。詳細情報
  4. アプリユーザーを作成します。詳細情報
  5. 秘密鍵をエンコードします。詳細情報

Dynamics 365 クライアント ID の取得 get-client-id-microsoft

アプリケーション(クライアント)ID を取得するには、Azure Active Directory にアプリを登録する必要があります。

  1. Azure Active Directory/アプリ登録 ​に移動し、「新規登録」を選択します。
  2. adobecampaign<instance identifier> など、インスタンスの識別に役立つ一意の名前を入力します。

保存すると、Microsoft Azure Directory は一意の​ アプリケーション(クライアント)ID をアプリに割り当てます。この ID は、後で Adobe Campaign で Dynamics 365 を設定する際に必要になります。

詳しくは、Microsoft Dynamics 365 ドキュメントを参照してください。

Microsoft Dynamics 証明書キー識別子およびキー ID の生成 config-certificate-key-id

証明書キー識別子(customKeyIdentifier) ​および​ キー ID(keyId) ​を取得するには、証明書をアップロードする必要があります。証明書は、トークンのリクエスト時にアプリケーションの ID を証明するための暗号鍵として使用できます。公開鍵とも呼ばれます。

以下の手順に従います。

  1. Azure Active Directory/アプリ登録 ​に移動し、以前に作成されたアプリケーションを選択します。
  2. 証明書と暗号鍵 ​を選択します。
  3. 証明書」タブで、「証明書をアップロード」をクリックします。
  4. 公開証明書をアップロードします。
  5. マニフェスト ​リンクを参照し、証明書キー識別子(customKeyIdentifier) ​と​ キー ID(keyId) ​を取得します。

証明書キー識別子(customKeyIdentifier) ​と​ キー ID(keyId) ​は、CRM O-Auth タイプ ​の証明書を使用して Microsoft Dynamics 365 CRM 外部アカウントを設定する際に Campaign で必要になります。

公開証明書の生成方法

証明書を生成するには、OpenSSL を使用します。

例:

code language-none
- openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
note note
NOTE
コードサンプルの -days 365 で日数を変更することで、証明書の有効期間を延長することができます。

次に、Base64 で証明書をエンコードする必要があります。それには、Base64 エンコーダーを利用するか、Linux の場合はコマンドライン base64 -w0 private.key を使用します。

権限の設定 config-permissions-microsoft

手順 1:作成したアプリに​ 必要な権限 ​を設定する

  1. Azure Active Directory/アプリ登録 ​に移動し、以前に作成されたアプリケーションを選択します。
  2. 左上の「設定」をクリックします。
  3. 必要な権限」で、「追加」と API/Dynamics CRM オンライン ​をクリックします。
  4. 選択」をクリックし、「組織ユーザーとして Dynamics 365 にアクセス」チェックボックスを有効にして、「選択」をクリックします。
  5. 次に、アプリから​ 管理 ​メニューの下の​ マニフェスト ​を選択します。
  6. マニフェスト ​エディターで、allowPublicClient プロパティを null から true に設定し、「保存」をクリックします。

手順 2:管理者の同意を付与する

  1. Azure Active Directory/エンタープライズアプリケーション ​に移動します。
  2. テナント全体での管理者の同意を付与するアプリケーションを選択します。
  3. 左側のペインメニューから、「セキュリティ」の下の「権限」を選択します。
  4. 管理者の同意の付与」をクリックします。

詳しくは、Azure のドキュメントを参照してください。

アプリユーザーの作成 create-app-user-microsoft

NOTE
この手順は、パスワード資格情報 ​認証ではオプションです。

アプリユーザーとは、上で登録したアプリケーションで使用するユーザーです。上記の登録済みのアプリを使用して Microsoft Dynamics に対して行った変更は、このユーザーを通じて行われます。

手順 1:Azure Active Directory に非インタラクティブユーザーを作成する

  1. Azure Active Directory/ユーザー ​をクリックし、「新しいユーザー」をクリックします。
  2. 使用する適切な名前を指定し、ユーザー名はメールフォーマットにする必要があります。
  3. ディレクトリロール ​の Dynamics 365 管理者 ​を選択します。

手順 2:作成したユーザーに適切なライセンスを割り当てる

  1. Microsoft Azure から、「管理者アプリ」をクリックします。
  2. ユーザー/アクティブなユーザー ​に移動し、新しく作成したユーザーをクリックします。
  3. 製品ライセンスを編集」をクリックし、Dynamics 365 顧客エンゲージメントプラン ​を選択します。
  4. 閉じる」をクリックします。

手順 3:Dynamics CRM でアプリケーションユーザーを作成する

  1. Microsoft Azure から、設定/セキュリティ/ユーザー ​に移動します。
  2. ドロップダウンをクリックし、アプリケーションユーザー ​を選択して「新規」をクリックします。
  3. 上の Active Directory に作成されたユーザーと同じユーザー名を使用します.
  4. アプリケーション ID以前に作成したアプリケーションに割り当てます。
  5. ロールの管理」をクリックし、ユーザーに対して​ システム管理者 ​ロールを選択します。

Campaign の設定 configure-acc-for-microsoft

接続の作成 new-ms-dyn-external-account

まず、Microsoft Dynamics 365 外部アカウントを作成する必要があります。

  1. Campaign エクスプローラーの​ 管理/プラットフォーム/外部アカウント ​ノードを参照し、外部アカウントを作成します。

  2. タイプ」セクションの Microsoft Dynamics CRM 外部アカウントに選択します。

  3. 認証方法を「CRM O-Auth タイプ」ドロップダウンリストで選択します。

    1. Microsoft Dynamics CRM 外部アカウントを設定して Adobe Campaign と​ パスワード資格情報 ​を接続するには、次の詳細を入力します。

      • サーバー:Microsoft CRM サーバーの URL。Microsoft CRM Server URL を見つけるには、Microsoft Dynamics CRM アカウントにアクセスし、Dynamics 365 をクリックしてアプリを選択します。次に、ブラウザーのアドレスバーに Server URL が表示されます(例:https://myserver.crm.dynamics.com/)。
      • アカウント:Microsoft CRM へのログインに使用するアカウント。
      • パスワード:Microsoft CRM へのログインに使用するアカウント。
      • クライアント識別子:Microsoft Azure 管理ポータルの「コードを更新」カテゴリ、「クライアント ID」フィールドにあるアプリケーション(クライアント)ID。
      • CRM バージョン:Dynamics CRM 365 CRM バージョンを選択します。
    2. Microsoft Dynamics CRM 外部アカウントを、証明書 ​を使って Adobe Campaign に接続するには、次の詳細を入力して設定します。

      • サーバー:Microsoft CRM サーバーの URL。Microsoft CRM Server URL を見つけるには、Microsoft Dynamics CRM アカウントにアクセスし、Dynamics 365 をクリックしてアプリを選択します。次に、ブラウザーのアドレスバーに Server URL が表示されます(例:https://myserver.crm.dynamics.com/)。
      • 秘密鍵:エンコードされた Base64 で秘密鍵をコピー&ペーストします。この節で詳しく説明しています。
      • キー ID:キーはアプリケーションの「マニフェスト」タブで利用可能です。詳しくは、この節で説明しています。
      • カスタムキー識別子:アプリケーションの「マニフェスト」タブで使用できる識別子です。詳しくは、この節で説明しています。
      • クライアント識別子:Microsoft Azure 管理ポータルにあるアプリケーション(クライアント)ID です。詳しくは、この節で説明しています。
      • CRM バージョン:Dynamics CRM 365 CRM バージョンを選択します。
  4. 有効にする」オプションを選択して Campaign でアカウントを有効化します。

NOTE
設定を承認するには、Adobe Campaign クライアントコンソールからログアウトして再度ログインします。

同期するテーブルを選択 ms-dyn-create-tables

同期するテーブルを設定できるようになりました。

  1. Microsoft CRM 設定ウィザード…」をクリックします。
  2. 同期するテーブルを選択し、プロセスを開始します。
  3. 管理/設定/データスキーマ ​ノードで、Adobe Campaign で生成されたスキーマを確認します。
NOTE
サーバー URL および login.microsoftonline.com の 2 つの URL を必ず許可リストに追加してください。これを実行するには、アドビ担当者にお問い合わせください。

列挙の同期 sfdc-enum-sync

スキーマを作成したら、列挙を Dynamics 365 から Adobe Campaign に自動的に同期することができます。

  1. 列挙を同期しています…」リンクからアシスタントを開きます。
  2. Dynamics 365 列挙に一致する Adobe Campaign 列挙を選択します。
    Adobe Campaign の列挙のすべての値を CRM の値に置き換えることができます。そのためには、置換 ​列の「はい」を選択します。
  3. 次へ」をクリックしてから「開始」をクリックし、列挙のインポートを開始します。
  4. 管理/プラットフォーム/列挙 ​ノードを参照し、インポートされた値を確認します。

これで Adobe Campaign と Microsoft Dynamics 365 が接続されました。2 つのシステム間にデータの同期を設定できます。

Adobe Campaign データと Microsoft CRM の間でデータを同期させるには、ワークフローを作成し、CRM コネクタ ​アクティビティを使用します。

データの同期について詳しくは、このページを参照してください。

サポートされているフィールドデータタイプ ms-dyn-supported-types

Microsoft Dynamics 365 でサポートされる/サポートされない属性タイプは、次のとおりです。

属性タイプ
サポート対象
基本型:ブール、日時、小数、浮動小数点数、倍精度浮動小数点数、整数、bigint、文字列
はい
金額(倍精度浮動小数点数)
はい
memo、entityname、primarykey、uniqueidentifier(文字列)
はい
ステータス、ピックリスト(使用可能な値を列挙型に格納)、ステート(文字列)
はい
所有者(文字列)
はい
ルックアップ(単一のエンティティ参照ルックアップのみ)
はい
顧客
いいえ
関連
いいえ
PartyList
いいえ
ManagedProperty
いいえ
recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b