SalesforceユーザーメタデータとPendoのインテグレーションの設定

最終更新日:

この記事では、Salesforceユーザーメタデータのインテグレーションを初めて設定する方法について説明します。このインテグレーションは、1つ以上のSalesforceアプリケーションでPendoを使用する場合に参考となります。まず、このインテグレーションの概要記事の「SalesforceユーザーメタデータとPendoのインテグレーション」もあわせてお読みください。

これは、異なるSalesforceオブジェクトに接続するPendoとの標準的なインテグレーションとは異なり、Salesforceアプリケーションではなく、顧客向けアプリケーションでPendoを使用したい場合に関連します。詳細については、「SalesforceとPendoのインテグレーション」をご覧ください。

サポート対象のデータ型

このインテグレーションは、以下のデータ型に対応しています。Pendoの特定のデータ型は、Salesforceの特定のデータ型にマッピングされます。これは次の場合に重要です。

  • 初期接続を作成する。Pendo訪問者IDの形式と一致するSalesforceユーザーフィールドを選択する必要があります。
  • 「プル」を設定する。Pendoのデータ型をSalesforceの特定のデータ型にマッピングして、正しいSalesforceフィールドが訪問者のメタデータとしてPendoにプルされるようにする必要があります。
Salesforceプリミティブタイプ Pendoメタデータタイプ
int 整数は、Pendoのデータマッピングページに[数値型(整数)(Number (int))]と表示されます。
string

文字列は、Pendoのデータマッピングページで[テキスト(Text)]と表示されます。

boolean booleanは、Pendoのデータマッピングのページで[ブール値(Boolean)]と表示されます。
date 日付は、Pendoのデータマッピングページで[日付(Date)]と表示されます。
datetime 日付は、Pendoのデータマッピングページで[日付(Date)]と表示されます。
double

小数は、Pendoのデータマッピングページに[数値型(小数)(Number (float))] と表示されます。

 

Salesforceフィールドタイプ Pendoメタデータタイプ
チェックボックス booleanは、Pendoのデータマッピングのページで[ブール値(Boolean)]と表示されます。
コンボボックス 文字列は、Pendoのデータマッピングページで[テキスト(Text)]と表示されます。
currency 小数は、Pendoのデータマッピングページに[数値型(小数)(Number (float))] と表示されます。
email 文字列は、Pendoのデータマッピングページで[テキスト(Text)]と表示されます。
id 文字列は、Pendoのデータマッピングページで[テキスト(Text)]と表示されます。
multipicklist 文字列は、Pendoのデータマッピングページで[テキスト(Text)]と表示されます。
percent 小数は、Pendoのデータマッピングページに[数値型(小数)(Number (float))] と表示されます。
phone 文字列は、Pendoのデータマッピングページで[テキスト(Text)]と表示されます。
picklist 文字列は、Pendoのデータマッピングページで[テキスト(Text)]と表示されます。
textarea 文字列は、Pendoのデータマッピングページで[テキスト(Text)]と表示されます。
url 文字列は、Pendoのデータマッピングページで[テキスト(Text)]と表示されます。
number 整数は、Pendoのデータマッピングページに[数値型(整数)(Number (int))]と表示されます。

一般に、Pendoで日付、整数、小数、ブール値、または文字列にマッピングできる任意のSalesforceフィールドタイプを、このインテグレーションのプルフィールドとして選択できます。

インテグレーションは、住所や場所などのSalesforce複合フィールドをサポートしていません。

ステップ1. インテグレーションを開始する

  1. Pendoで[設定(Settings)]>[インテグレーション(Integrations)]に移動します。
  2. [Salesforceユーザーメタデータ(Salesforce User Metadata)]タイルを見つけて開きます。画面右側にパネルが表示されます。
  3. [セットアップ(Set up)]を選択します。
  4. ドロップダウンメニューからアカウントを選択するか、[新規認証(New authentication)]を選択します。
    • 必要な権限を持つアカウントを使用します。詳細については、SalesforceユーザーメタデータとPendoのインテグレーションの概要記事を参照してください。
    • 個々の従業員に紐づいたユーザーレコードではなく、組織内の他の人もアクセスできる新しいユーザーを作成することをお勧めします。
    • 新しいアカウントを追加するには、Salesforceへの認証が必要です。このインテグレーションを使用するには、サンドボックスインスタンスではなく、本番環境のSalesforceインスタンスが必要です。
  5. Pendoのインテグレーションパネルで[次へ(Next)]を選択します。すると下記の「ステップ2. 接続を作成する」で記述した結合キーを選択する画面に移動します。

ステップ2. 接続を作成する

PendoとSalesforceを接続するには、Pendoの訪問者の一意の識別子(訪問者ID)が、マッピングのために選択したSalesforceユーザーフィールドと完全に一致する必要があります。

Pendo訪問者をSalesforceユーザーにマッピングするには、ドロップダウンメニューから[結合キー(Join key)]を選択します。結合キーは、Pendo訪問者とSalesforceユーザー間で共有される一意の識別子を含むSalesforceユーザーフィールドです。結合キーを選択することで、Pendoに訪問者IDを送信するSalesforceのユーザーフィールドを指示します。

Pendo訪問者にマッピングするSalesforceユーザーフィールドを選択します。Salesforceユーザーフィールドは通常、「メール」または「ID」(IDがメールの場合)です。大文字と小文字、句読点、スペースなどが異なると、Pendoが正しいレコードと照合できなくなります。

[結合キー]を選択したら、Pendoのインテグレーションパネルで[次へ(Next)]を選択します。

ステップ3.「プル」を設定する

このステップでは、訪問者メタデータとしてSalesforceからPendoにプルするSalesforceユーザーフィールドを選択します。Pendoにプルされたメタデータはすべて、Pendoセグメントに含めることができます。パーソナライズされたガイドのターゲティングやプロダクトの使用状況分析を行うために、Pendoセグメントに含めると役立つメタデータをすべて含めます。

結合キーがプルフィールドの1つとして選択されている場合、そのキーは既にPendoに訪問者IDとして存在しているため、Pendoメタデータにプルされません。

  1. ドロップダウンメニューからSalesforceフィールドを選択して、Salesforceユーザーオブジェクトからプルします。
  2. [追加(Add)]を選択して別のフィールドを追加し、このシーケンスの最初の手順を繰り返して新しいドロップダウンメニューを作成します。
  3. [完了(Finish)]を選択してセットアップを完了します。

ステップ4. インテグレーションを有効化する

毎日の同期を開始するには、[設定とログ(Settings and logs)][インテグレーションを有効にする(Enable integration)]を選択し、インテグレーションを有効にします。プル同期はインテグレーションが有効になった直後に発生します。この処理には数分かかる場合があります。最初の実行後、データの同期を維持するためにインテグレーションは1日に1回実行されます。同期の状態は[設定とログ(Settings and logs)]で確認できます。

Pendoにプルされたデータを表示する

Salesforceからプルされた訪問者のメタデータを確認して表示するには、[設定(Settings)]>[データマッピング(Data Mappings)]のテーブルの[グループ(Group)]列で[Salesforceユーザーメタデータ(Salesforce User Metadata)]フィールドを探します。これは、顧客向けアプリケーションの標準Salesforceインテグレーションからプルされたフィールドである、青色のSalesforceグループに関連付けられたフィールドとは異なります。

トラブルシューティング

Salesforceアカウントを認証できません

組織では、デフォルトでサードパーティ製アプリをブロックするポリシーが設定されている場合があります。この場合、SalesforceアカウントでPendo Salesforceユーザーメタデータのインテグレーションアプリのブロックの解除が必要となる場合があります。

  1. Salesforceアカウントにログインします。
  2. [設定(Setup)]>[ホーム(Home)]に移動します。
  3. 左側のメニューから[プラットフォームツール(Platform Tools)]>[アプリ(Apps)]>[接続済みアプリ(Connected Apps)]>[接続済みアプリのOAuthの使用状況(Connected Apps OAuth Usage)]を開きます。
  4. Pendo Salesforceインテグレーションは、表の[接続済みアプリ(Connected Apps)]列にあります。
  5. [アクション(Actions)]列でアプリがブロックされているかどうかを確認します。ブロックされている場合は[ブロック解除(Unblock)]ボタンが表示されます。
  6. インテグレーションがブロックされている場合は、[ブロック解除(Unblock)]を選択します。これにより、このインテグレーションで使用されるアプリにアクセス権が付与されます。

Salesforceの結合キーまたはプルフィールドを選択しても、Salesforceユーザーフィールドが見つかりません

まず、Salesforceユーザーメタデータのインテグレーションで認証したユーザが、フィールドを読み取るための適切な権限を持っていることを確認します。

  1. Salesforceアカウントにサインインします。
  2. [設定(Setup)]>[ホーム(Home)]に移動します。
  3. [ユーザー(Users)]>[プロファイル(Profiles)]を開きます。
  4. ユーザーのプロファイルを選択します。
  5. [フィールドレベルセキュリティ(Field Level Security)]セクションまで下にスクロールし、ユーザーオブジェクトを選択します。
  6. Pendoにプルしようとしているフィールドで[読み取りアクセス(Read Access)]にチェックが入っていることを確認してください。

次に、Salesforceユーザーメタデータのインテグレーションで認証したユーザーのAPIが有効になっていることを確認します。

  1. Salesforceアカウントにサインインします。
  2. [設定(Setup)]>[ホーム(Home)]に移動します。
  3. [ユーザー(Users)]>[プロファイル(Profiles)]を開きます。
  4. ユーザーのプロファイルを選択します。
  5. [管理権限(Administrative Permissions)]セクションまで下にスクロールし、ユーザーオブジェクトを選択します。
  6. [API有効(Enabled)]が選択されていることを確認します。

エラーメッセージ:Salesforceクエリジョブの作成中にエラーが発生しました

このエラーは、インテグレーションの設定時にプルフィールドとして以前に選択したSalesforceのフィールドを削除した場合に発生することがあります。この場合、存在しない項目についてSalesforceにクエリを実行しようとするため、プル同期は失敗します。PendoにプルされているSalesforceのフィールドを削除する場合は、Pendoのインテグレーションパネルで設定を編集し、そのフィールドを削除してください。

この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています