UI を使用して Salesforce アカウントをExperience Platformに接続する
このチュートリアルでは、Experience Platformユーザーインターフェイスを使用して Salesforce アカウントを接続し、CRM データをAdobe Experience Platformに取り込む手順について説明します。
はじめに
このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム：Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本：スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル：スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile：複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
認証済みの Salesforce アカウントが既にある場合は、このドキュメントの残りの部分をスキップし、CRM データのデータフローの設定に関するチュートリアルに進むことができます。
必要な資格情報の収集 gather-required-credentials
Salesforce ソースは、基本認証と OAuth2 クライアント資格情報をサポートしています。
基本認証を使用して Salesforce アカウントに接続するには、次の資格情報の値を指定する必要があります。
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| 資格情報 | 説明 |
| 環境 URL | Salesforce ソースインスタンスの URL。 環境 URL の形式は https://[domain].my.salesforce.com です。 |
| ユーザー名 | Salesforce ユーザーアカウントのユーザー名。 |
| パスワード | Salesforce ユーザーアカウントのパスワード。 |
| セキュリティトークン | Salesforce ユーザーアカウントのセキュリティ トークン。 |
| API バージョン | （オプション）使用している Salesforce インスタンスの REST API バージョン。 API バージョンの値は、10 進数でフォーマットする必要があります。 例えば、API バージョン 52 を使用している場合、値を 52.0 と入力する必要があります。 このフィールドを空白のままにすると、Experience Platformでは使用可能な最新のバージョンが自動的に使用されます。 |
認証について詳しくは、 この Salesforce 認証ガイドを参照してください。
OAuth2 クライアント資格情報を使用して Salesforce アカウントに接続するには、次の資格情報の値を指定する必要があります。
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
|---|---|
| 資格情報 | 説明 |
| 環境 URL | Salesforce ソースインスタンスの URL。 環境 URL の形式は https://[domain].my.salesforce.com です。 |
| クライアント ID | クライアント ID は、OAuth2 認証の一部として、クライアント秘密鍵と並行して使用されます。 クライアント ID とクライアント秘密鍵を一緒に使用すると、Salesforce ーザー先のアプリケーションを識別することにより、お客様のアカウントに代わってアプリケーションが動作することができます。 |
| クライアントシークレット | クライアントの秘密鍵は、クライアント ID と並行して、OAuth2 認証の一部として使用されます。 クライアント ID とクライアント秘密鍵を一緒に使用すると、Salesforce ーザー先のアプリケーションを識別することにより、お客様のアカウントに代わってアプリケーションが動作することができます。 |
| API バージョン | 使用している Salesforce インスタンスの REST API バージョン。 API バージョンの値は、10 進数でフォーマットする必要があります。 例えば、API バージョン 52 を使用している場合、値を 52.0 と入力する必要があります。 このフィールドを空白のままにすると、Experience Platformでは使用可能な最新のバージョンが自動的に使用されます。 |
Salesforce に対する OAuth の使用について詳しくは、Salesforce OAuth 認証フローのガイドを参照してください。
必要な資格情報を収集したら、次の手順に従って Salesforce アカウントをExperience Platformに接続できます。
Salesforce アカウントを接続
Platform UI の左側のナビゲーションバーで「ソース」を選択して、ソースワークスペースにアクセスします。画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。
CRM カテゴリの下の「Salesforce」を選択し、「データを追加」を選択します。
Salesforceへの接続 ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。
既存のアカウントを使用
既存のアカウントを使用するには、「既存のアカウント」を選択し、表示されるリストから使用するアカウントを選択します。 終了したら、「次へ を選択して続行します。
新しいアカウントを作成
新しいアカウントを作成するには、「新しいアカウント」を選択し、新しい Salesforce アカウントの名前と説明を入力します。
次に、新しいアカウントに使用する認証タイプを選択します。
基本認証の場合は、「基本認証 を選択し、次の資格情報の値を指定します。
- 環境 URL
- ユーザー名
- パスワード
- API バージョン （オプション）
終了したら「ソースに接続」を選択します。
「OAuth 2 クライアント資格情報」で、「OAuth2 クライアント資格情報 を選択し、次の資格情報の値を入力します。
- 環境 URL
- クライアント ID
- クライアントシークレット
- API バージョン
終了したら「ソースに接続」を選択します。
サンプルデータのプレビューをスキップ skip-preview-of-sample-data
データ選択手順で、大きなテーブルまたはファイルのデータを取り込む際にタイムアウトが発生することがあります。 データプレビューをスキップして、タイムアウトを回避し、サンプルデータがなくてもスキーマを表示できます。 データのプレビューをスキップするには、「サンプルデータのプレビューをスキップ 切替スイッチを有効 します。
残りのワークフローは変わりません。 唯一の注意点は、データのプレビューをスキップすると、マッピングステップ中に計算フィールドと必須フィールドが自動検証されない可能性があり、マッピング中にこれらのフィールドを手動で検証する必要があるということです。
次の手順
このチュートリアルでは、Salesforce アカウントとの接続を確立しました。次のチュートリアルに進み、 データをに取り込むためのデータフローの設定 Platform を行いましょう。