Salesforce

Adobe Experience Platform を使用すると、データを外部ソースから取得しながら、Experience Platform サービスを使用して、受信データの構造化、ラベル付け、拡張を行うことができます。アドビのアプリケーション、クラウドベースのストレージ、データベースなど、様々なソースからデータを取り込むことができます。

Experience Platform は、サードパーティの CRM システムからのデータ取り込みをサポートしています。CRM プロバイダーのサポートは Salesforce を含みます。

AzureでExperience PlatformのSalesforce ソースを設定する azure

AzureでExperience PlatformのSalesforce アカウントを設定する方法については、次の手順に従ってください。

AZUREに接続するためのIP アドレスの許可リスト

Azure上のExperience Platformにソースを接続する前に、リージョン固有のIP アドレスを許可リストに追加する必要があります。 地域に固有のIP アドレスをYoutube 許可リストに追加しないと、ソースを使用する際にエラーまたはパフォーマンスが低下する可能性があります。 詳しくは、IP アドレスの許可リスト ページを参照してください。

SalesforceからXDMへのフィールドマッピング

SalesforceとExperience Platformの間にソース接続を確立するには、Salesforce ソースデータフィールドをExperience Platformに取り込む前に、適切なターゲット XDM フィールドにマッピングする必要があります。

Salesforce データセットとExperience Platform間のフィールドマッピングルールについて詳しくは、次を参照してください。

Salesforce名前空間とスキーマ自動生成ユーティリティの設定

Salesforce ソースをB2B-CDPの一部として使用するには、まずPostman ユーティリティを設定してSalesforce名前空間とスキーマを自動生成する必要があります。 次のドキュメントでは、Postman ユーティリティの設定に関する追加情報を提供しています。

Experience Platform開発者コンソールとPostmanの設定が完了したら、Postman環境に適切な環境値を適用できるようになりました。

スクリプトの実行

Postman コレクションと環境を設定したら、Postman インターフェイスを使用してスクリプトを実行できるようになりました。

Postman インターフェイスで、自動生成ユーティリティのルート フォルダーを選択し、上部ヘッダーから​ Run ​を選択します。

Runner インターフェイスが表示されます。 ここから、すべてのチェックボックスが選択されていることを確認し、Run Namespaces and Schemas Autogeneration Utility​を選択します。

リクエストが成功すると、ベータ仕様に従ってB2B名前空間とスキーマが作成されます。

Amazon Web ServicesでExperience PlatformのSalesforce ソースを設定する aws

Amazon Web Services （AWS）でExperience PlatformのSalesforce アカウントを設定する方法については、次の手順に従ってください。

前提条件

Salesforce アカウントをAWS リージョンのExperience Platformに接続するには、次の条件を満たす必要があります。

AWSでの接続用IP アドレスの許可リストに加える

AWS上のExperience Platformにソースを接続する前に、リージョン固有のIP アドレスを許可リストに追加する必要があります。 詳しくは、AWS上のExperience Platformに接続するためのIP アドレスの許可リストに加えるに関するガイドを参照してください。

Salesforce Connected Appを作成

最初に、以下を使用して、PEM ファイルの証明書/キーペアを作成します。

openssl req -newkey rsa:4096 -new -nodes -x509 -days 3650 -keyout key.pem -out cert.pem

必要な権限を追加

次の権限を追加します。

権限が追加されたら、Issue JSON Web Token (JWT)-based access tokens for named user​のボックスを有効にしてください。

次に、Save、Continue、Manage Customer Details​の順に選択します。 消費者の詳細パネルを使用して、次の情報を取得します。

接続されたアプリへのSalesforce ユーザーの認証

以下の手順に従って、Connected Appを使用する認証を取得します。

JWT ベアラートークンの生成

JWT ベアラートークンを生成するには、次の手順に従います。

キーペアをpkcs12に変換

JWT ベアラートークンを生成するには、まず次のコマンドを使用して、証明書/キーペアをpkcs12形式に変換する必要があります。 この手順では、プロンプトが表示されたら、書き出しパスワード​を設定する必要もあります。

openssl pkcs12 -export -in cert.pem -inkey key.pem -name jwtcert >jwtcert.p12

pkcs12に基づくJava キーストアの作成

次に、次のコマンドを使用して、生成したpkcs12に基づいてJava キーストアを作成します。 この手順では、プロンプトが表示されたら、宛先キーストアパスワードを設定​する必要もあります。 さらに、以前の書き出しパスワードをソースキーストアパスワードとして指定する必要があります。

keytool -importkeystore -srckeystore jwtcert.p12 -destkeystore keystore.jks -srcstoretype pkcs12 -alias jwtcert

keystroke.jksにjwtcert エイリアスが含まれていることを確認します

次に、follow コマンドを使用して、keystroke.jksにjwtcert エイリアスが含まれていることを確認します。 この手順では、前の手順で生成した宛先キーストアパスワードを指定するように求められます。

keytool -keystore keystore.jks -list

署名済みトークンを生成

最後に、以下のJava クラス JWTExampleを使用して、署名済みトークンを生成します。

package org.example;

import org.apache.commons.codec.binary.Base64;

import java.io.*;
import java.security.*;
import java.text.MessageFormat;

public class Main {

    public static void main(String[] args) {

        String header = "{\"alg\":\"RS256\"}";
        String claimTemplate = "'{'\"iss\": \"{0}\", \"sub\": \"{1}\", \"aud\": \"{2}\", \"exp\": \"{3}\"'}'";

        try {
            StringBuffer token = new StringBuffer();

            //Encode the JWT Header and add it to our string to sign
            token.append(Base64.encodeBase64URLSafeString(header.getBytes("UTF-8")));

            //Separate with a period
            token.append(".");

            //Create the JWT Claims Object
            String[] claimArray = new String[5];
            claimArray[0] = "{CLIENT_ID}";
            claimArray[1] = "{AUTHORIZED_SALESFORCE_USERNAME}";
            claimArray[2] = "{SALESFORCE_LOGIN_URL}";
            claimArray[3] = Long.toString((System.currentTimeMillis() / 1000) + 2629746*4);
            MessageFormat claims;
            claims = new MessageFormat(claimTemplate);
            String payload = claims.format(claimArray);

            //Add the encoded claims object
            token.append(Base64.encodeBase64URLSafeString(payload.getBytes("UTF-8")));

            //Load the private key from a keystore
            KeyStore keystore = KeyStore.getInstance("JKS");
            keystore.load(new FileInputStream("path/to/keystore"), "keystorepassword".toCharArray());
            PrivateKey privateKey = (PrivateKey) keystore.getKey("jwtcert", "privatekeypassword".toCharArray());

            //Sign the JWT Header + "." + JWT Claims Object
            Signature signature = Signature.getInstance("SHA256withRSA");
            signature.initSign(privateKey);
            signature.update(token.toString().getBytes("UTF-8"));
            String signedPayload = Base64.encodeBase64URLSafeString(signature.sign());

            //Separate with a period
            token.append(".");

            //Add the encoded signature
            token.append(signedPayload);

            System.out.println(token.toString());

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

次の手順

Salesforce アカウントの前提条件の設定が完了したら、Salesforce アカウントをExperience Platformに接続し、CRM データを取り込みます。 詳しくは、以下のドキュメントを参照してください。

APIを使用してSalesforceをExperience Platformに接続する

以下のドキュメントでは、APIまたはユーザーインターフェイスを使用してSalesforceをExperience Platformに接続する方法について説明します。

UIを使用してSalesforceをExperience Platformに接続する