> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesforce Marketing Cloud Account Engagement

export const CommonDatasourceMoreInformation = ({datasource = "the data source", advancedurl = "", siteName = "CData Sync", driverVersion = ""}) => {
  return <>
      <p>
        {siteName} と{datasource} の連携について、詳しくは{' '}
        <a href={`https://cdn.cdata.com/help/${advancedurl}${driverVersion}/jp/synch/default.htm`}>
          {datasource} Connector for {siteName}
        </a> を参照してください。
      </p>
    </>;
};

export const CommonAuthSchemeOauthEmbedded = ({siteName = "CData Sync", siteNameShort = "Sync", datasource = "the data source"}) => {
  return <>
      <p>
        {siteName} は、接続するための組み込みOAuth アプリケーションを提供します。アプリケーションを使用するには、<strong>Auth Scheme</strong> で<strong>OAuth</strong> を選択します。追加のプロパティは必要ありません。
      </p>
    </>;
};

export const CommonDatasourceAddConnector = ({datasource = "the data source", title = "the connector", destination = false, siteNameShort = "Sync"}) => {
  return <>
      <p>
        {siteNameShort} で{datasource} のデータを使用できるようにするには、まず以下の手順でコネクタを追加する必要があります：
      </p>
      <ol>
        <li>{siteNameShort} のダッシュボードから<strong>接続</strong>ページを開きます。</li>
        <li><strong>接続を追加</strong>をクリックして<strong>コネクタを選択</strong>ページを開きます。</li>
        <li>
          <strong>{destination ? "同期先" : "データソース"}</strong>タブをクリックして
          <strong>{title}</strong> 行に移動します。
        </li>
        <li>
          行末にある<strong>接続を設定</strong>アイコンをクリックして、<strong>新しい接続</strong>ページを開きます。この操作により、{' '}
          <strong>接続を追加</strong>ダイアログボックスが開きます。
          <br />
          <strong>Note：</strong> <strong>接続を設定</strong>アイコンが表示されない場合は、<strong>コネクタをダウンロード</strong>アイコンをクリックして {title} コネクタをインストールしてください。
        </li>
        <li><strong>接続を追加</strong>ダイアログボックスに接続名を入力します。</li>
        <li><strong>追加</strong>をクリックして、コネクタの<strong>設定</strong>タブを開きます。</li>
      </ol>
      <p>
        新しいコネクタのインストールについての詳細は、{' '}
        <a href="../connections">接続</a>を参照してください。
      </p>
    </>;
};

export const CommonDatasourceIntroDestination = ({datasource = "the data source", siteName = "CData Sync"}) => {
  return <p>
      {siteName} アプリケーションから{datasource} コネクタを使用して、サポートされている任意のデータソースから同期先の{datasource} へデータを移動できます。これを行うには、コネクタを追加し、コネクタへの認証を行い、接続を完了する必要があります。
    </p>;
};

export const driverVersion = "M";

export const siteNameShort = "Sync";

export const siteName = "CData Sync";

<CommonDatasourceIntroDestination datasource="Salesforce Marketing Cloud Account Engagement" siteName={siteName} />

## Salesforce Marketing Cloud Account Engagement コネクタを追加

<CommonDatasourceAddConnector datasource="Salesforce Marketing Cloud Account Engagement" title="Salesforce Marketing Cloud Account Engagement" destination={true} siteNameShort={siteNameShort} />

## Salesforce Marketing Cloud Account Engagement への認証

After you add the connector, you need to set the required properties.

**Business Unit ID:** Enter your business-unit identifier (Id). This Id is required when you use an authentication scheme of OAuth 2.0. Your Salesforce Marketing Cloud Account Engagement business-unit Id begins with "0Uv" and is 18 characters long. You can locate your Id from **Marketing Setup** in Salesforce.

{siteName} supports authenticating to Salesforce Marketing Cloud Account Engagement in several ways. Select your authentication method below to proceed to the relevant section that contains the authentication details.

* [**OAuth**](#oauth) (default)
* [**OAuth Password**](#oauth-password)
* [**OAuth JWT**](#oauth-jwt)

### OAuth

<CommonAuthSchemeOauthEmbedded siteName={siteName} />

### OAuth Password

To connect with the Password OAuth grant type, specify the following properties:

* **Auth Scheme:** Select **OAuthPassword**.
* **User:** Enter the username that you use to authenticate to Salesforce Marketing Cloud Account Engagement.
* **Password:** Enter the password that you use to authenticate to Salesforce Marketing Cloud Account Engagement.
* **Security Token:** Enter the security token that you use to authenticate to Salesforce Marketing Cloud Account Engagement.

### OAuth JWT

To connect with Salesforce Marketing Cloud Account Engagement, specify the following properties:

* **Auth Scheme:** Select **OAuthJWT**.
* **OAuth JWT Cert:** Enter your Java web tokens (JWT) certificate store.
* **OAuth JWT Cert Type:** Enter the type of key store that contains your JWT certificate. The default type is **PEMKEY\_BLOB**.
* **OAuth JWT Issuer** – Enter the issuer of your Java web token. Typically, the issuer is either the client Id or the email address of the OAuth application.
* (Optional) **OAuth JWT Cert Password:** Enter the password for your OAuth JWT certificate.
* (Optional) **OAuth JWT Cert Subject:** Enter the subject of your OAuth JWT certificate that is used to locate a matching certificate in the store. This property supports partical matches and a wildcard operator (\*) to select the first certicate.
* (Optional) **OAuth JWT Subject:** Enter the user subject that is used to locate a matching certificate in the store. This property supports partical matches and a wildcard operator (\*) to select the first certicate.

## Salesforce Marketing Cloud Account Engagement as a Reverse ETL Destination

In the {siteNameShort} application, you can configure Salesforce Marketing Cloud Account Engagement as a reverse ETL destination so that it can receive processed data from your source database or warehouse.

Currently, the only supported object for this destination is the Prospects table, and all three transfer modes (**Insert**, **Upsert**, and **Update**) are available for that table. Other tables are not supported because the API does not provide bulk operations for them at this time.

In Salesforce Marketing Cloud Account Engagement, you can use `Email`, `ID`, or `SalesforceID` as the delta snapshot key for updates (**Update mode**) to the Prospects table. For **Upsert** mode, you can use either `Email` or `SalesforceID` as the delta snapshot key.

**Note:** If you choose to use `Email`, be aware of the implications of the Salesforce Marketing Cloud Account Engagement feature **Allow Multiple Prospects with the Same Email Address** (AMPSEA):

* AMPSEA was enabled by default since June 14, 2016, and it cannot be turned off for business units that were created after that date or when the feature is enabled by an administrator.
* When multiple prospects share the same email, operations that match on `Email` might resolve to the prospect with the most recent activity, which can lead to unexpected updates because the value for `Email` is not unique.

As a result of this behavior, <a href="https://help.salesforce.com/s/articleView?id=mktg.pardot_admin_ampsea_parent.htm&type=5" target="_blank" rel="noopener noreferrer">Salesforce recommends</a> that you use `SalesforceID` (the CRM ID) for imports whenever possible.

**Transfer-Modes Summary**

|  Mode  | Supported | Key Used for Matching                       | Notes                                                                                            |
| :----: | :-------: | :------------------------------------------ | :----------------------------------------------------------------------------------------------- |
| Insert |    Yes    | N/A (always inserts)                        | Creates new records in the Prospects table.                                                      |
| Update |    Yes    | Use either `ID`, `SalesforceID`, or `Email` | Updates existing records in the Prospects table only.                                            |
| Upsert |    Yes    | Use either `SalesforceID` or `Email`        | Updates existing records if a matching key exists. If no match exists, a new record is inserted. |

## 接続を完了する

To complete your connection:

1. Specify the following properties:
   * **Schema:** Select the Salesforce Marketing Cloud Account Engagement version that you want to use. The default version is **SalesforcePardotV5**.
   * (Optional) **Is Demo Account:** Select whether the provided account is a demo account. By default, the **Enable** checkbox is not selected.
2. Define advanced connection settings on the **Advanced** tab. (In most cases, though, you should not need these settings.)
3. If you authenticate with OAuth, click **Connect to Salesforce Marketing Cloud Account Engagement** to connect to your Salesforce Marketing Cloud Account Engagement account.
4. Click **Create & Test** to create your connection.

## 詳細について

<CommonDatasourceMoreInformation datasource="Salesforce Marketing Cloud Account Engagement" advancedurl="GP" siteName={siteName} driverVersion={driverVersion} />