CRM コネクタ

CRM コネクタについて

Adobe Campaign では、Adobe Campaign プラットフォームをサードパーティのシステムにリンクするための様々な CRM コネクタが提供されています。これらの CRM コネクタにより、連絡先、アカウント、購入などを同期したり、アプリケーションを様々なサードパーティおよびビジネスアプリケーションと簡単に統合したりすることができます。

これらのコネクタを使用すると、データを迅速かつ容易に統合できます。Adobe Campaign には、CRM のテーブルを収集して選択するための専用のウィザードが用意されています。これにより、システム全体でデータを常に最新にするための双方向の同期が保証されます。

メモ

この機能は、CRM コネクタ​専用パッケージを通じて Adobe Campaign で使用できます。

CRM への接続は、専用のワークフローアクティビティを使用して実行します。これらのアクティビティについて、この節の章で詳しく説明しています。

互換性のある CRM システムと制限事項

Adobe Campaign に統合できる CRM を次に示します。

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

  • Salesforce.com

    Salesforce.com との接続を設定する方法については、この節を参照してください。

    重要

    Adobe Campaign を Salesforce.com に接続する場合の制限事項を次に示します。

    • 本番テスト用インスタンスがサポートされます。
    • 割り当てルールがサポートされます。
    • 複数選択列挙は Adobe Campaign でサポートされません。

  • Oracle On Demand

    Oracle On Demand との接続を設定する方法については、この節を参照してください。

    重要

    Adobe Campaign を Oracle On Demand に接続する場合の制限事項を次に示します。

    • Adobe Campaign は、標準の Oracle On Demand テンプレートで利用可能などのオブジェクトでも同期できます。Oracle On Demand にパーソナライズしたテーブルを追加している場合、これらのテーブルは Adobe Campaign で回復されません。
    • API バージョン v1.0 では、クエリ中にデータを並べ替えたり、フィルタリングしたりできますが、両方の操作を同時に実行することはできません。
    • Oracle On Demand から送信される日付には、タイムゾーン情報が含まれません。
    • 複数選択列挙は Adobe Campaign でサポートされません。

  • MS Dynamics CRM および MS Dynamics Online

    Microsot Dynamics との接続を設定する方法については、この節を参照してください。

    Adobe Campaign と Microsoft Dynamics の統合の使用例については、このビデオを参照してください。

    重要

    Adobe Campaign を Microsoft Dynamics に接続する場合の制限事項を次に示します。

    • プラグインをインストールすると CRM の動作が変わり、Adobe Campaign との互換性の問題が生じる可能性があります。
    • 複数選択列挙は Adobe Campaign でサポートされません。

接続の設定

Adobe Campaign で CRM コネクタを使用するには、次の手順に従います。

  1. 外部アカウントの作成
  2. CRM テーブルの収集
  3. 列挙の同期
  4. 同期ワークフローの作成
メモ

CRM コネクタはセキュア URL（https）でのみ動作します。

Salesforce.com の例

Adobe Campaign で Salesforce.com コネクタを設定するには、次の手順に従います。

  1. Adobe Campaign ツリーの​管理／プラットフォーム／外部アカウント​ノードを使用して、新しい外部アカウントを作成します。

  2. 設定ウィザードを実行し、使用可能な CRM テーブルを生成します。

    設定ウィザードでは、テーブルを収集し、対応するスキーマを作成できます。

    「開始」をクリックして実行します。

    メモ

    設定を承認するには、Adobe Campaign コンソールからログオフし、再度ログオンする必要があります。

  3. 管理／設定／データスキーマ​ノードで、Adobe Campaign で生成されたスキーマを確認します。

  4. スキーマが作成された後、CRM 経由で列挙を Adobe Campaign に自動的に同期することができます。

    そのためには、「列挙を同期しています…」リンクをクリックし、CRM 列挙に対応する Adobe Campaign の列挙を選択します。

    Adobe Campaign の列挙のすべての値を CRM の値に置き換えることができます。そのためには、置換​列の「はい」を選択します。

    「次へ」をクリックしてから「開始」をクリックし、リストのインポートを開始します。

  5. 管理／プラットフォーム／列挙​メニューで、インポートされた値を確認します。

  6. Salesforce データをインポートしたり、Adobe Campaign データを Salesforce にエクスポートしたりするには、ワークフローを作成し、「CRM コネクタ」アクティビティを使用する必要があります。

Oracle On Demand の例

Adobe Campaign と連携するように Oracle On Demand コネクタを設定するには、次の手順に従います。

  1. Adobe Campaign ツリーの​管理／プラットフォーム／外部アカウント​ノードを使用して、新しい外部アカウントを作成します。

  2. 設定ウィザードを開きます。Oracle データモデルのテーブルが自動的に表示されます。収集するテーブルを選択します。

  3. 「次へ」をクリックし、対応するスキーマの作成を開始します。

    対応するデータスキーマが Adobe Campaign で使用可能になります。

  4. Adobe Campaign と Oracle On Demand の間の列挙の同期を開始します。

  5. Oracle On Demand データを Adobe Campaign にインポートするには、次のタイプのワークフローを作成します。

    このワークフローでは、Oracle On Demand 経由で連絡先がインポートされ、それらが既存の Adobe Campaign データと同期され、重複する連絡先は削除され、Adobe Campaign データベースが更新されます。

    「CRM コネクタ」アクティビティを、次に示すように設定する必要があります。

  6. Adobe Campaign データを Oracle On Demand にエクスポートするには、次のワークフローを作成します。

    このワークフローでは、クエリを使用して関連データが収集されてから、Oracle On Demand 連絡先テーブルにエクスポートされます。

Microsoft Dynamics の例

Adobe Campaign と連携するように Microsoft Dynamics コネクタを設定するには、次の手順に従います。

  1. Adobe Campaign ツリーの​管理／プラットフォーム／外部アカウント​ノードを使用して、新しい外部アカウントを作成します。

  2. デプロイメントタイプ​を選択します。「オンプレミス」、「Office 365」または「Web API」を、設定するコネクタに応じて選択します。

    Adobe Campaign Classic は、Dynamics 365 REST インターフェイスと OAuth プロトコルによる認証をサポートしています。

    WebAPI デプロイメントを選択している場合は、Azure Directory にアプリを登録し、Azure Directory から clientId を取得する必要があります。この登録については、このページを参照してください。

    メモ

    Adobe Campaign Classic では、redirectURL パラメーターは必須ではありません。

    clientId 値は、付与タイプのパスワードを使用してベアラートークンを取得するために、ユーザー名やパスワードとともに使用します。この方式は、リソース所有者パスワード資格情報付与（Resource Owner Password Credentials Grant）​と呼ばれます。詳しくは、このページを参照してください。

    この CRM バージョンの互換性について詳しくは、互換性マトリックスを参照してください。

  3. 設定ウィザードを開きます。Microsoft Dynamics データテンプレートからテーブルが自動的に検出されます。

  4. 収集するテーブルを選択します。

  5. 「次へ」をクリックし、対応するスキーマの作成を開始します。

    メモ

    設定を承認するには、Adobe Campaign コンソールから切断し、再接続する必要があります。

    対応するデータスキーマが Adobe Campaign で使用可能になります。

  6. Adobe Campaign と Microsoft Dynamics の間の列挙の同期を開始します。

  7. Microsoft Dynamics データを Adobe Campaign にインポートするには、次のタイプのワークフローを作成します。

    このワークフローでは、Microsoft Dynamics 経由で連絡先がインポートされ、それらが既存の Adobe Campaign データと同期され、重複する連絡先は削除され、Adobe Campaign データベースが更新されます。

    CRM コネクタ​アクティビティを、次に示すように設定する必要があります。

データの同期

Adobe Campaign と CRM の間の同期は、専用のワークフローアクティビティである「CRM コネクタ」で実行されます。

このアクティビティを使用して、次のことを実行できます。

同期対象とする CRM に対応する外部アカウントを選択し、同期するオブジェクト（アカウント、オポチュニティ、リード、連絡先など）を選択します。

このアクティビティの設定は、実行するプロセスによって異なります。次に、様々な設定について詳しく説明します。

CRM からのインポート

データを CRM 経由で Adobe Campaign にインポートするには、次のタイプのワークフローを作成する必要があります。

インポートアクティビティの場合、「CRM コネクタ」アクティビティの設定手順は次のとおりです。

  1. 「CRM からインポート」操作を選択します。

  2. リモートオブジェクト​ドロップダウンリストに移動し、プロセスの対象となるオブジェクトを選択します。このオブジェクトは、コネクタの設定時に Adobe Campaign で作成されたテーブルのいずれかと一致します。

  3. 「リモートフィールド」セクションに移動し、インポートするフィールドを入力します。

    フィールドを追加するには、ツールバーの​追加​ボタンをクリックし、式を編集​アイコンをクリックします。

    必要に応じて、「コンバージョン」列のドロップダウンリストでデータフォーマットを変更します。使用可能なコンバージョンタイプについて詳しくは、データフォーマットを参照してください。

    重要

    CRM と Adobe Campaign のオブジェクトをリンクするには、CRM でのレコードの識別子が必須です。これは、ボックスが承認されると自動的に追加されます。

    増分データインポートの場合は、CRM 側での最終変更日も必須です。

  4. 必要に応じて、インポートするデータをフィルターすることもできます。そのためには、「フィルターを編集…」リンクをクリックします。

    次の例では、2012 年 11 月 1 日以降にアクティビティが記録された連絡先のみが Adobe Campaign によってインポートされます。

    重要

    データのフィルターモードに関連する制限について詳しくは、フィルターデータを参照してください。

  5. 「自動インデックスを使用」オプションを使用すると、CRM と Adobe Campaign の間の増分オブジェクト同期を日付と最終変更に応じて自動的に管理できます。

    詳しくは、変数管理を参照してください。

変数管理

「自動インデックス」オプションを使用すると、最後のインポート以降に変更されたオブジェクトのみを収集できます。

最後の同期の日付が、設定ウィンドウで指定したオプションに保存されます。デフォルトでは、LASTIMPORT_<%=instance.internalName%>_<%=activityName%> です。

メモ

このメモは、一般的な「CRM コネクタ」アクティビティにのみ適用されます。他の CRM アクティビティの場合、プロセスは自動です。

このオプションは、管理／プラットフォーム／オプション​を使用して手動で作成および設定する必要があります。これはテキストオプションである必要があり、その値は、yyyy/MM/dd hh:mm:ss というフォーマットに一致する必要があります。

以降のインポートではこのオプションを手動で更新する必要があります。

最新の変更を識別するために考慮するリモート CRM フィールドを指定できます。

デフォルトでは、次のフィールドが（指定した順序で）使用されます。

  • Microsoft Dynamics の場合：modifiedon。
  • Oracle On Demand の場合：LastUpdated、ModifiedDate、LastLoggedIn。
  • Salesforce.com の場合：LastModifiedDate、SystemModstamp。

「自動インデックス」オプションをオンにすると、「JavaScript コード」タイプのアクティビティによって、同期ワークフローで使用できる 3 つの変数が生成されます。これらのアクティビティは、次のとおりです。

  • vars.crmOptionName：最後のインポート日を含むオプションの名前を表します。

  • vars.crmStartImport：最後のデータ収集の開始日（この日を含む）を表します。

  • vars.crmEndDate：最後のデータ収集の終了日（この日を含まない）を表します。

    メモ

    これらの日付は、yyyy/MM/dd hh:mm:ss というフォーマットで表示されます。

フィルターデータ

様々な CRM で効率的に操作をおこなうために、次のルールを使用してフィルターを作成する必要があります。

  • 各フィルターレベルでは、1 つのタイプの演算子のみを使用できます。
  • AND NOT 演算子はサポートされていません。
  • 比較は、null 値（「空である」／「空でない」タイプ）または数値にのみ関係します。つまり、値（右側の列）が評価され、この評価の結果は数値である必要があります。したがって、JOIN タイプの比較はサポートされていません。
  • 右側の列の値は、JavaScript で評価されます。
  • JOIN 比較はサポートされていません。
  • 左側の列の式は、フィールドである必要があります。複数の式の組み合わせ、数値などは使用できません。

例えば、次のフィルター条件は、OR 演算子が AND 演算子と同じレベルに配置されているので、CRM インポートで有効になりません。

  • OR 演算子が AND 演算子と同じレベルに配置されている。
  • 比較の実行対象がテキスト文字列である。

並べ替え順

Microsoft Dynamics および Salesforce.com では、インポートされるリモートフィールドを昇順または降順で並べ替えることができます。

そのためには、「並べ替え順」リンクをクリックし、列をリストに追加します。

リストでの列の順序が、並べ替え順です。

レコード識別

CRM に含まれる（フィルターされた可能性がある）要素をインポートするのではなく、ワークフローで事前に計算された母集団を使用できます。

そのためには、「アップストリームを計算した母集団を使用」オプションを選択し、リモート識別子を含むフィールドを指定します。

次に、インポートするインバウンドの母集団のフィールドを次に示すように選択します。

CRM へのエクスポート

Adobe Campaign データを CRM にエクスポートすると、コンテンツ全体を CRM データベースにコピーできます。

データを CRM にエクスポートするには、次のタイプのワークフローを作成する必要があります。

エクスポートの場合、次の設定を「CRM コネクタ」アクティビティに適用します。

  1. 「CRM にエクスポート」操作を選択します。

  2. リモートオブジェクト​ドロップダウンリストに移動し、プロセスの対象となるオブジェクトを選択します。このオブジェクトは、コネクタの設定時に Adobe Campaign で作成されたテーブルのいずれかと一致します。

    重要

    「CRM コネクタ」アクティビティのエクスポート機能では、CRM 側のフィールドを挿入または更新できます。CRM でのフィールド更新を有効にするには、リモートテーブルのプライマリキーを指定する必要があります。キーがない場合、データは（更新ではなく）挿入されます。

  3. 「マッピング」セクションで、エクスポートされるフィールドと CRM でのそれらのマッピングを指定します。

    フィールドを追加するには、ツールバーの​追加​ボタンをクリックし、式を編集​アイコンをクリックします。

    メモ

    特定のフィールドについて、CRM 側で対応が定義されていない場合は、値を更新できません。値は CRM に直接挿入されます。

    必要に応じて、「コンバージョン」列のドロップダウンリストでデータフォーマットを変更します。使用可能なコンバージョンタイプについて詳しくは、データフォーマットを参照してください。

    メモ

    エクスポートされるレコードのリストとエクスポートの結果は、ワークフローが終了または再開されるまでアクセス可能な一時ファイルに保存されます。これにより、同じレコードを複数回エクスポートしたりデータを失ったりすることなく、エラーが発生した場合にプロセスを再度開始できます。

任意の追加設定

データフォーマット

CRM へのインポートまたは CRM からのインポート中にデータフォーマットを変換できます。

そのためには、適用する変換を対応する列で選択します。

「デフォルト」モードでは、自動データ変換が適用されます。ほとんどの場合、これはデータのコピー／貼り付けと同じです。ただし、タイムゾーン管理が適用されます。

その他の使用可能な変換は、次のとおりです。

  • 日付のみ：このモードでは、日付 + 時刻タイプのフィールドは削除されます。
  • 時間オフセットなし：このモードでは、デフォルトモードで適用されるタイムゾーン管理がキャンセルされます。
  • コピー／貼り付け：このモードでは、文字列などの生データが使用されます（変換なし）。

エラー処理

データのインポートまたはエクスポートのフレームワーク内で、エラーおよび却下に対して特定のプロセスを適用できます。そのためには、「行動」タブで「却下を処理」および「エラーを処理」オプションを選択します。

これらのオプションを使用すると、対応する出力トランジションが配置されます。

次に、適用するプロセスに関連するアクティビティを配置します。

例えば、エラーを処理するために、待機ボックスを追加して再試行をスケジュールできます。

却下は、エラーコードおよび関連メッセージとともに収集されます。つまり、却下のトラッキングを設定して同期プロセスを最適化できます。

メモ

「却下を処理」オプションがオフの場合でも、却下された列ごとに警告がエラーコードおよびメッセージとともに生成されます。

「却下」出力トランジションでは、エラーメッセージおよびコードに関連する特定の列を含む出力スキーマにアクセスできます。これらの列は、次のとおりです。

  • Oracle On Demand の場合：errorLogFilename（Oracle 側でのログファイルの名前）、errorCode（エラーコード）、errorSymbol（エラーコードとは別のエラー記号）、errorMessage（エラーコンテキストの説明）。
  • Salesforce.com の場合：errorSymbol（エラーコードとは別のエラー記号）、errorMessage（エラーコンテキストの説明）。

CRM で削除されたオブジェクトのインポート

広範なデータ同期プロセスの設定を可能にするために、CRM で削除されたオブジェクトを Adobe Campaign にインポートできます。

それには、次の手順に従います。

  1. 「CRM で削除されたオブジェクトをインポート」操作を選択します。

  2. リモートオブジェクト​ドロップダウンリストに移動し、プロセスの対象となるオブジェクトを選択します。このオブジェクトは、コネクタの設定時に Adobe Campaign で作成されたテーブルのいずれかと一致します。

  3. 考慮する削除期間を「開始日」および「終了日」フィールドで指定します。これらの日付も期間に含まれます。

    重要

    要素の削除期間は、CRM に固有の制限と一致している必要があります。したがって、例えば Salesforce.com の場合、削除されてから 30 日を経過した要素は収集することができません。

CRM でのオブジェクトの削除

CRM 側でオブジェクトを削除するには、削除するリモート要素のプライマリキーを指定する必要があります。

「行動」タブで、却下の処理を有効にすることができます。このオプションを使用すると、「CRM コネクタ」アクティビティの 2 つ目の出力トランジションが生成されます。詳しくは、エラー処理を参照してください。

メモ

「却下を処理」オプションがオフの場合でも、却下された列ごとに警告が生成されます。

このページ