> ## 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

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 CommonAuthSchemeBasic = ({siteName = "CData Sync", siteNameShort = "Sync", datasource = "the data source"}) => {
  return <>
      <p>ユーザー資格情報で接続するには、次のプロパティを設定します：</p>
      <ul>
        <li><strong>Auth Scheme：</strong><strong>Basic</strong> を選択。</li>
        <li><strong>User：</strong>{datasource} アカウントへの認証に使用するユーザー名を入力。</li>
        <li><strong>Password：</strong>{datasource} アカウントへの認証に使用するパスワードを入力。</li>
      </ul>
    </>;
};

export const CommonAuthSchemeOauthCustom = ({siteName = "CData Sync", siteNameShort = "Sync", datasource = "the data source"}) => {
  return <>
      <p>OAuth カスタムクレデンシャルで接続するには、次のプロパティを指定します：</p>
      <ul>
        <li><strong>Auth Scheme：</strong><strong>OAuth</strong> を選択。</li>
        <li><strong>OAuth Client Id：</strong>OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。</li>
        <li><strong>OAuth Client Secret：</strong>OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントシークレットを入力。</li>
      </ul>
    </>;
};

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" siteName={siteName} />

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

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

## Salesforce Marketing Cloud への認証

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

**Subdomain:** Enter the subdomain of your Salesforce Marketing Cloud API.

Salesforce Marketing Cloud supports two API schema types. Select your schema below to proceed to the relevant section for your schema.

* [**SOAP**](#soap-api) (default)
* [**REST**](#rest-api)

### SOAP API

To connect to Salesforce Marketing Cloud through the SOAP API, specify the following properties:

* **Schema:** Select **SOAP**.
* **Auth Scheme:** Select the [authentication method](#soap-authentication-methods) that you want to use to connect to Salesforce Marketing Cloud.
  * [**OAuth**](#oauth-soap)
  * [**OAuth Client**](#oauth-client-soap)
  * [**Basic**](#basic) (default)

### REST API

To connect to Salesforce Marketing Cloud through the REST API, specify the following properties:

* **Schema:** Select **REST**.
* **Auth Scheme:** Select the [authentication method ](#rest-authentication-methods) that you want to use to connect to Salesforce Marketing Cloud.
  * [**OAuth**](#oauth-rest) (default)
  * [**OAuth Client**](#oauth-client-rest)

## SOAP Authentication Methods

### OAuth

<CommonAuthSchemeOauthCustom siteName={siteName} />

After you specify the authentication scheme, [complete the remaining steps](#complete-your-connection) for establishing your connection.

### OAuth Client {/* oauth-client-soap */}

To connect with an OAuth client, specify the following properties:

* **Auth Scheme:** Select **OAuthClient**.
* **OAuth Client Id:** Enter the client Id that you were assigned when you registered your application with an OAuth authorization server.
* **OAuth Client Secret:** Enter the client secret that you were assigned when you registered your application with an OAuth authorization server.

After you specify the authentication scheme, [complete the remaining steps](#complete-your-connection) for establishing your connection.

### Basic

<CommonAuthSchemeBasic siteName={siteName} datasource="Salesforce Marketing Cloud" />

After you specify the authentication scheme, [complete the remaining steps](#complete-your-connection) for establishing your connection.

## REST Authentication Methods

### OAuth

<CommonAuthSchemeOauthCustom siteName={siteName} />

* **User Legacy Authentication:** Select whether you want the connection to be made to the Salesforce Marketing Cloud REST API using legacy authentication. By default, the **Enable** checkbox is not selected.

After you specify the authentication scheme, [complete the remaining steps](#complete-your-connection) for establishing your connection.

### OAuth Client {/* oauth-client-rest */}

To connect with an OAuth client, specify the following properties:

* **Auth Scheme:** Select **OAuthClient**.
* **OAuth Client Id:** Enter the client Id that you were assigned when you registered your application with an OAuth authorization server.
* **OAuth Client Secret:** Enter the client secret that you were assigned when you registered your application with an OAuth authorization server.
* **User Legacy Authentication:** Select whether you want the connection to be made to the Salesforce Marketing Cloud REST API using legacy authentication. By default, the **Enable** checkbox is not selected.

After you specify the authentication scheme, [complete the remaining steps](#complete-your-connection) for establishing your connection.

## Salesforce Marketing Cloud as a Reverse ETL Destination

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

As a reverse ETL destination, Salesforce Marketing Cloud supports all three transfer modes (**Insert**, **Upsert**, and **Update**).

### Supported Schemas

In {siteNameShort}, the Salesforce Marketing Cloud destination supports two schemas: SOAP and REST. For both of these schemas, **Insert** mode behaves the same for all tables and requires no special configuration. However, the behavior of the **Update** and **Upsert** modes differs based on schema, as explained below.

**SOAP Schema (default)**

* **Update** mode is supported for all standard and custom tables. For the AccountUser table, you must specify both primary keys as the delta snapshot key when you configure a task's column mapping. (The *delta snapshot key* is the column (or set of columns) that are used to track changes when {siteNameShort} processes data from multiple snapshots of a dataset.) For all other tables, you can specify one key from all of a table's primary keys as the delta snapshot key.
* **Upsert** mode is supported only for the standard tables Subscribers, List, Send, and Role, as well as for all custom tables and data extensions. For this transfer mode, you must specify all of the table's primary keys as the delta snapshot key when you configure a task's column mapping.

**REST Schema**

* **Update** mode is supported for all tables. You can specify one key from all of the table's primary keys as the delta snapshot key when you configure a task's column mapping.
* **Upsert** mode is supported only for the Contacts table. You can one key from all of the table's primary keys as the delta snapshot key when you configure a task's column mapping.

### Transfer-Modes Summary

**SOAP Schema**

|  Mode  | Supported                                                                                         | Key Used for Matching                                                                                 | Notes                                            |
| :----: | :------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------- | :----------------------------------------------- |
| Insert | Yes                                                                                               | N/A (always creates new records)                                                                      | Inserts new records.                             |
| Update | Yes                                                                                               | The AccountUser table requires both primary keys; other tables use any one key from all primary keys. | Updates existing records.                        |
| Upsert | Yes for the Subscribers, List, Send, and Role tables; also for all custom tables/data extensions. | All the table's primary keys must be specified as the delta snapshot key.                             | Inserts or updates records depending on a match. |

**REST Schema**

|  Mode  | Supported                         | Key Used for Matching                            | Notes                                            |
| :----: | :-------------------------------- | :----------------------------------------------- | :----------------------------------------------- |
| Insert | Yes                               | N/A (always creates new records)                 | Inserts new records.                             |
| Update | Yes                               | Any one key of the table's primary keys.         | Updates existing records.                        |
| Upsert | Yes (for the Contacts table only) | You can use any one of the table's primary keys. | Inserts or updates records depending on a match. |

For more information about reverse ETL jobs, see [Reverse ETL](../../jobs/reverse-etl).

## 接続を完了する

To complete your connection:

1. Define advanced connection settings on the **Advanced** tab. (In most cases, though, you should not need these settings.)
2. If you authenticate with OAuth, click **Connect to Salesforce Marketing Cloud** to connect to your Salesforce Marketing Cloud account.
3. Click **Create & Test** to create your connection.

## 詳細について

<CommonDatasourceMoreInformation datasource="Salesforce Marketing Cloud" advancedurl="FE" siteName={siteName} driverVersion={driverVersion} />