Salesforceインテグレーションの概要

プル（取り込み）

Salesforce Pullで、SalesforceからPendoにデータを取り込むことができます。

 

同期可能なデータ

PendoのSalesforceインテグレーションでは、Salesforceオブジェクト内に存在するすべてのデータを同期できます。必要なSalesforceのフィールドを選択すると、そのフィールドがPendoのAccount (アカウント)オブジェクトまたはVisitor (訪問者)オブジェクトに取り込まれます。2つのデータソースを接続するためには、Pendo側とSalesforce側の両方で、1対1で対応するキーが必要となります（「salesforce ID」や一致する「Visitor ID」など）。

 

どれくらいの頻度で同期されるのですか？

データの同期は1日1回です。また、PendoのData Mapping (データマッピングページ)で、いつでも手動でデータを同期できます。

 

どのように設定するのですか？

Pendoの管理者権限で、Data Mappingページにアクセスします。設定は、左下の歯車アイコンをクリックすると表示されます。アカウントでSalesforceが有効になっている場合、右側にSalesforceインテグレーションが表示されます。指示に従ってインテグレーションの設定を行ってください。

PendoのSalesforceインテグレーションを利用するには、「APIの有効化」の権限と、AccountオブジェクトとContactオブジェクトへの読み取りアクセス権を持つユーザーでSalesforceにサインインする必要があります。

 

このデータで何ができますか？

Salesforceのデータをリンクすると、Pendo全体で利用できるようになります。具体的には、Salesforceの属性に基づいたデータのスライスやフィルタリング、訪問者に向けたガイドが行えます。

 

プッシュ

Salesforce Pushでは、PendoのAccountレポートやVisitorレポートのデータを毎晩Salesforceに「プッシュ」できます。これにより、Salesforce内でPendoデータを活用して、ワークフロー、タスクの生成、通知の送信、レポート作成、サードパーティとのインテグレーションを行うことができます。次のように、Pendoを組織内で活用できます。

• アクティビティが一定量以下になると、カスタマーサクセスにタスクを作成
• PendoのデータとSalesforceの既存のサポートデータを統合して健全性スコアを作成
• サードパーティのマーケティングツールの利用

どのような仕組みですか？

Salesforce Pushは、既存の「プル」機能の、認証とオブジェクトマッピングを活用します。Pendoのアカウント用の単一Salesforceオブジェクト、もしくはPendoの訪問者用の単一Salesforceオブジェクトにマッピングするオプションがあります。一般的な設定では、SalesforceのAccountオブジェクトとContactオブジェクトの両方をマッピングしますが、カスタムオブジェクトをターゲットにすることもできます。

アウトバウンドデータの設定には、既存のPendoのAccountレポートおよびVisitorレポートを使用しています。

注意事項

1. Salesforce Enterprise、Salesforce UnlimitedへのAPIアクセス、またはAPIアクセスが追加されたSalesforce Professionalへの有償アップグレードが必要です。
2. 現在、すべてのカスタムオブジェクトと、次のSalesforce標準オブジェクトとの同期をサポートしています：Account、Asset、Contact、Lead、Opportunity
3. 現時点では、一致するレコードが存在しない場合、Salesforceレコードは作成されません。
4. 上の図が示すように、現在プル（取り込み）しているのと同じSalesforceオブジェクトにデータをプッシュする必要があります。将来的には、異なるオブジェクトへの同期を検討しています。
5. 当社のインテグレーションはAppExchangeでは入手できません。また、管理パッケージのインテグレーションではありません。管理者へのヒアリングによると、インテグレーションがシンプルであったため、問題がなかったとのことでした。
6. 問題が発生した場合は、help@pendo.ioまでご連絡ください。

 

設定概要

Salesforce管理者の援助があれば、15分で稼働可能です。

 

Pendo管理者を見つける

プッシュ設定には管理者権限が必要となります。

 

既存のインテグレーション設定が機能していることを確認する

データマッピングページ（インストール設定の下）に移動します。

• 同期が正常に行われているかどうかを確認します。3つの緑色のチェックマークが表示され、最終同期の日付が表示されます。

• Salesforceとの連携設定でお困りの場合は、サポート（help@pendo.io）までお問い合わせください。

 

認証されたユーザーを確認する

• Authenticate with Salesforce (Salesforceで認証) をクリックします。
• APIにアクセスできるSalesforceユーザーを確認し、書き留めておきます。

 

マッピング設定を確認する

AccountとVisitorの両方にマッピングされているSalesforceオブジェクトを確認します。この情報にアクセスするには、Setup & Test Mapping (設定＆マッピングのテスト) をクリックします。

 

新規にPendoアカウントレポートを作成する

ほとんどのお客様が、PendoのアカウントデータをSalesforce Accountにプッシュすることを希望します。訪問者データに関しては、Salesforceでは連絡先が重複していることが多いため、プッシュするのが少々難しいかもしれません。まずはAccountレポートから始めることをお勧めします。Accountレポートにアクセスし、[Create New Report (新規レポート作成)] をクリックします。

• レポートを設定します。[Segment (セグメント] を [Everyone (全員)] に設定することをお勧めします。理由は、デモ用、テスト用、社内用のアカウントには、Salesforceのレコードが一致していない可能性があるからです。一致するものが見つからなくても、問題はありません。
• [Date Range (日付範囲)] を選ぶ際には、目的を考慮してください。昨日のデータが必要でしょうか？昨日のアクティビティに基づいて何かを始めるのなら、必要かもしれません。後でSalesforceのカスタムフィールド名に使用できるように、日付範囲をメモしておくこともお勧めします。

• レポートを作成します。
• Salesforceシステム管理者用のサンプルファイルを用意します。.CSVファイルをエクスポートして保存します。

 

簡単な設定作業をSalesforceシステム管理者に依頼する

これで、Salesforceシステム管理者に依頼を送信できます。以下がサンプルです。

[SFDCシステム管理者名] 様

使用中のツールであるPendoについて、Pendoのデータを毎晩Salesforceと同期させたいと考えています。安全性は確認済みです。以下が、この件に関する依頼事項です。

まず、次のAPIユーザーが書き込み権限を持っていることを確認する必要があります。このインテグレーションは名前空間フィールドのみで動作するため、問題が起きることはありません。[認証済みユーザーのEメールを記入]

[マッピングされたオブジェクト名を記入]オブジェクトで、3つのカスタムフィールドを作成し、それぞれのフィールド名の前に「Pendo」を付けます。問題の発生を防ぐため、インテグレーションは「Pendo」フィールドに限定されています。以下のラベルの使用をお勧めしますが、「Pendo_」さえあればフィールド名は自由に付けていただいて構いません。大文字と小文字は区別されることにご注意ください。

また、データタイプがわかるように、.csvファイルを添付しました。

ご不明な点がありましたら、help@pendo.ioまでご連絡ください。

 

プッシュを設定する

レポートページのSalesforceプッシュの横にある「Set Up (設定)」をクリックします。

• 必要なPendoのカラムをSalesforceのフィールドにマッピングします。利用可能なSalesforceのフィールドのリストは、フィールド名の前に「Pendo_」が付いているフィールドに限定されていることに注意してください。

 

同期のテストを実行する

1つのアカウントを対象としたセグメントを一時的に追加することをお勧めします。準備ができたら、Sync Now (今すぐ同期)をクリックします。

正常に動作しない場合は、セグメントをEveryoneに戻し、再度同期します。

 

よくある質問

サポート対象データタイプ

Salesforceプリミティブデータタイプ：Pendoメタデータタイプ

• "int": "integer"
• "string": "string"
• "boolean": "boolean"
• "date": "date"
• "datetime": "time"
• "double": "float"

Salesforceフィールドタイプ：Pendoメタデータタイプ

• "combobox": "string"
• "currency": "float"
• "email": "string"
• "id": "string"
• "multipicklist": "string"
• "percent": "float"
• "phone": "string"
• "picklist": "string"
• "url": "string"
• "number": "integer"

上記以外のデータタイプはサポート対象外です。

現在、PendoはLookup Type、Record Type、Address （Workaround）、Hierarchy、Content（20）、URL（255）の各オブジェクトタイプに対応していません。

どれくらいの頻度で同期されるのですか？

Salesforceインテグレーションは、24時間ごとに自動的に同期されます。データマッピングのページから、いつでも手動で同期できます。インテグレーションの設定が完了したら、すぐに強制的に同期を行い、正しく動作しているかどうかを確認することをお勧めします。手動、自動を問わず、どのような同期もSalesforceのプルとプッシュの両方を実行します。

SalesforceのサンドボックスをPendoと同期することはできますか？

はい。ただし、その前にPendoサブスクリプションの設定を変更する必要があります。サポート（help@pendo.io）までご連絡ください。

なぜSalesforceの特定のフィールドがPendoに取り込めないのですか？

「Pendoに追加するフィールドの選択」を設定する際に、Salesforceの特定のフィールドが選択できない場合は、サポートされているデータタイプであることと、フィールドが「Pendo」で始まっていないことを確認してください。「Pendo」で始まるSalesforceのフィールドはプッシュ専用なので、Pendoへのデータ取り込み（プル）には使用できません。

Salesforceへのデータプッシュとは何ですか？

Salesforceへのプッシュ機能では、Pendoの訪問者やアカウントのアクティビティデータを、SalesforceのContactやAccountオブジェクトに日次で同期できます。このデータは、Salesforceのワークフロー、レポート、アクティビティで使用できます。また、Salesforceに接続可能な他のアプリケーションからもアクセスできるようになります。

Pushを使用すると何が可能になりますか？

Pendoからの情報をSalesforceにデータプッシュすることで、組織内の他の役割やプロセスが広くアクセスできるようになります。使用例としては、まずアプリケーションで観察された行動に基づいて、アウトリーチ（メールや電話）をトリガーすることが挙げられます。例えば、特定のアカウントのログイン頻度が著しく低下した場合、サポートやカスタマーサクセスからオフラインでのフォローアップを行うきっかけとすることができます。また、複合的な顧客健全性スコアの一部としてPendoのデータを使用できます。Pendoの使用状況データを他の財務データや業務データと統合し、予測性の高い顧客スコアリングを行うことができます。 Salesforceを「情報センター」として活用し、カスタマージャーニーのさまざまな部分のデータをまとめることができます。例えば、マーケティング自動化ツールを使ってログイン／登録前のユーザーの行動をトラッキングし、Salesforceの連絡先レコードを使ってPendoのログイン後の活動と連携させることができます。

プッシュはどのような仕組みになっていますか？

プッシュ機能は、Pendoの既存のSalesforce（プル）インテグレーションとは逆の動作をします。メタデータフィールドが取り込まれる（プル） のと同じContactオブジェクトとAccountオブジェクトを使用して、Pendoから選択された情報をプッシュします。マッピングはSalesforceのプル（取り込み）と同じ認証キーを使用するため、プッシュ機能を動作させるためには、これを正しく設定して動作させる必要があります。

プッシュを動作させるためには何を設定すればよいのでしょうか？

Salesforceへのデータプッシュの有効化を完了するためには、次のようなSalesforceとのインテグレーション（プル）の設定が必要となります。プッシュ機能では、SalesforceのメタデータをPendoに取り込むことができる既存の機能と同じインテグレーション（およびSalesforceのキー）を使用します。PendoのデータをSalesforceにプッシュする前に、Pendo管理者アクセスでこの設定を正しく行う必要があります。Pendoのレポートにプッシュ機能を設定するには、Pendo管理者である必要があります。また、Salesforce（プル）とのインテグレーションを設定するには、SalesForceへの管理者権限が必要です。Pendoのカスタムフィールドからデータを受け取るSalesforceのカスタムフィールドを設定するには、Salesforce管理者（または管理者へのアクセス権）が必要になります。Pendoからのデータを受け取るためには、SalesforceのAccountオブジェクトやContactオブジェクトに特定のカスタムフィールドを設定する必要があります。

どのようなデータがSalesforceにプッシュできますか？

Pendoは、Salesforceにプッシュされるデータのベースとして、アカウントレポートおよび訪問者レポートのコンテンツを使用しています。それらのレポートの任意のフィールドを、Salesforceにプッシュできます。アカウントごとの「訪問者数」、「サイト滞在時間」、「最終訪問日」などのデータは、Salesforceのオブジェクトに追加することで活用できます。ほとんどのユーザーは、アカウントレポートに注目します。Salesforceではアカウントが重複していることが多いため、Salesforceで正しくマッピング（および後でデータを利用）することが難しくなります。

Salesforceへのプッシュは、特定のアカウントレポートや訪問者レポートに基づいて行われるため、レポートの日付範囲を考慮することが重要です。データは毎晩同期されますが、レポートの日付範囲は常に優先されます。例えば、特定のレポートを作成する際に、過去7日間と30日間のどちらのデータを同期させるのがより価値があるのかを考える必要があります。

PendoがSalesforceで書き込むフィールドはどのようなものですか？

問題を回避するために、Pendoは、Salesforceのカスタマイズされた名前空間フィールドにのみ書き込みを行います。そのため、Salesforce管理者は、プッシュを設定する前に、Pendoからのデータを保持するための特定のフィールドをAccountオブジェクトもしくはContactオブジェクト内に作成する必要があります。これらのフィールドの前には、「Pendo_」を付ける必要があります。例えば、日付範囲を「過去30日」としたレポートからの「現地時間」の推奨される出力先フィールド名は「Pendo_TimeOnSite_Last30Days」となります。正しく名称付けられた出力先フィールドのみが、Salesforceへのプッシュが設定された際にマッピング可能となります。

一致するアカウントや連絡先がSalesforceにない場合はどうなりますか？

Salesforceプッシュは、Pendoにデータを取り込むために設定されているのと同じオブジェクトに依存しています。Pendoは一致したオブジェクトに対してのみデータをプッシュします。Salesforceに新しいレコードは作成されません。一致するレコードが見つからない場合、データはSalesforceにプッシュされません。

Salesforceのプッシュレポートに空白の行があるのはなぜですか？

アカウントレポートや訪問者レポートを作成すると、レポートには、セグメントや日付範囲の条件を満たすアカウントや訪問者のデータ行のみが表示されます。Salesforceプッシュインテグレーションをレポートで使用すると、通常ではレポートに含まれない行が追加され、これらの行の値が「0」になる場合があります。

その理由は？ - データのないアカウントや訪問者はSalesforceオブジェクトと1対1でマッピングする必要があるため、これらの空白の行はSalesforceプッシュに必要です。

これを取り消すことはできますか？ - 現時点では、空白の行を削除するには、同じパラメータで新しいレポートを作成する方法しかありません。

この空白の行は、Salesforceのデータを上書きしてしまいますか？ - いいえ。当社のSalesforceプッシュインテグレーションでSalesforceに送信される空白行の値は、Salesforceに送信・保存されているデータを上書きしません。

Pendoは、Salesforce APIのユーザー名とパスワードを保存しますか？

ユーザー名とパスワードをPendoに保存するのではなく、SalesforceのOAuth 2.0認可メソッドを使って、保存されているそのユーザーのトークンを取得します。

そのトークンは、Salesforce管理者によっていつでも取り消すことができます。

SFDCのフィールドを取り込んで列として追加すると、すべて空白になるのですが？

プル（取り込み）が正常に動作していれば、特定のアカウントのアカウント詳細ページにデータがすぐに表示されますが、レポートリストに表示されるまでには1時間ほどかかることがあります。更新されているかどうか、定期的に確認してください。

Pendo側とSalesforce側の両方に、2つのデータソースを接続するための1対1で一致するキーがない場合はどうなりますか？

アカウントIDや訪問者IDなどの一意の識別子を使用することをお勧めします。ただし一意の識別子としてこれらのフィールドのみに限定されるものではありません。それぞれのプラットフォームで1つのフィールドが完全に一致している必要があります。

それぞれのプラットフォームのIDを一致させる最も簡単な方法は、PendoからアカウントIDをエクスポートし、その値を同期するSalesforceオブジェクトのフィールドにプッシュするプロセスを設定することです。Salesforceの適切なレコードを特定するために、Pendoから追加のデータを取り込む必要がある場合があります。この手順を繰り返して、訪問者IDを同期させます。これらのプロセスは定期的に実行され、Pendoで新しい訪問者IDやアカウントIDが作成される時に、Salesforceの適切なレコードにこれらの値を追加する必要があります。