Pendoガイドを使用してアプリケーション内から訪問者にサードパーティの体験を表示する際、訪問者のサードパーティコンテンツの利用状況をPendoの識別情報と関連付けることができます。
例えば、訪問者IDがサードパーティのアンケートリンクに追加された場合、アンケートで追加の識別手順を行わずに、サードパーティのアンケート回答を送信した訪問者に関連付けることができます。これがないと、訪問者がサードパーティのコンテンツを利用する際は匿名のままとなり、サードパーティのシステムで再度本人確認を実行する必要があります。
この記事では、サードパーティのコンテンツを共有する方法に応じて異なる識別情報を渡すために、サードパーティのURLを変更する方法について説明します。アプリケーション内のガイドを通じて訪問者にサードパーティのコンテンツを共有する方法は3つあります。
- ガイド内のリンクを通じて訪問者をサードパーティのコンテンツに誘導します。ガイドにリンクを追加する方法については、「ビルディングブロックを使用してガイドコンテンツを追加する」をご確認ください。
- ガイド内のボタンを通じて訪問者をサードパーティのコンテンツに誘導します。ガイドにボタンを追加する方法については、「ビジュアルデザインスタジオのガイドボタンアクション」を参照してください。
- コードブロックを通じてサードパーティのコンテンツをガイドに直接埋め込みます。コードブロックの詳細については、「コードでガイドをカスタマイズする」をご覧ください。
検討事項
この記事の指示はウェブアプリケーション用に書かれています。特に明記されていない限り、これはインストールスクリプトまたはPendo Launcher（ブラウザ拡張機能）を通じてPendoがインストールされたアプリケーションに適用されます。これらのウェブベースのインストールおよび構成方法についての情報は「実装オプション」を参照してください。
送信できるのはエージェントメタデータのみです。このメタデータは、直接実装の場合はPendoインストールスクリプトを通じて、ブラウザ拡張機能の実装の場合はPendo Launcherを通じて設定されます。利用可能な値を確認するにはPendoエージェントデバッガーを起動し、［構成］タブを開いてください。これには、Pendoに設定した訪問者IDとメタデータに関する情報が表示されます。希望するメタデータフィールドが表示されない場合、このユースケースでは利用できません。
このユースケースでは、Salesforce、HubSpot、カスタムのメタデータは利用できません。メタデータタイプの詳細については、訪問者とアカウントのメタデータ設定のメタデータグループの種類をご覧ください。
サードパーティのURLに追加したメタデータはユーザーとサードパーティの両方に表示されます。これには、名前やメールアドレスなど、Pendoに送信する可能性のある潜在的な個人を特定できる情報（PII）が含まれます。PIIをURLで送信することはお勧めしません。PIIに関する詳細情報については、「データ収集とコンプライアンス」を参照してください。
URLを通じて追加データが渡されることを認識させるために、サードパーティ内で追加の設定を行う必要があるかもしれません。
テキストブロック内のサードパーティのコンテンツリンクにメタデータを追加する
ガイドでサードパーティのコンテンツを共有する最も簡単な方法は、訪問者が開くURLを表示することです。テキストブロックを使用してガイドステップに外部リンクを追加し、ガイドロジックを使用してURLの末尾に追加の訪問者またはアカウントのメタデータを追加します。
例えば、ガイドに「ここをクリック」とラベル付けされたリンクがある場合、次のマークダウン形式を挿入してリンクを作成できます。
[ここをクリック](https://examplethirdparty.com/examplesurvey?visitor={visitor.id/})
リンクが選択されると、訪問者は訪問者IDが末尾に追加されたサードパーティのコンテンツURLにリダイレクトされます。
ガイドボタン内のサードパーティのコンテンツリンクにメタデータを追加する
ガイドロジックをPendoガイドボタンと組み合わせて使用することで、訪問者またはアカウントのメタデータを用いてパーソナライズされたサードパーティのコンテンツリンクに訪問者を誘導することができます。
例えば、ガイドに「ここをクリック」とラベル付けされたボタンがある場合、次のマークダウン形式を挿入できます。
https://examplethirdparty.com/examplesurvey?visitor={visitor.id/}
ボタンが選択されると、訪問者は訪問者IDが末尾に追加されたサードパーティのコンテンツURLにリダイレクトされます。
ガイドに埋め込まれたサードパーティのコンテンツにメタデータを追加する
サードパーティコンテンツをガイドステップ内にiframeとして埋め込むことも可能です。これにより、訪問者はアプリケーションを離れることなくコンテンツと対話できます。コードブロックとガイド変数を使用して、埋め込みiframe URLに目的の訪問者またはアカウントのメタデータを渡します。
このオプションは、Pendoがインストールスクリプトを通じてアプリケーションに直接インストールされているウェブアプリケーションでのみ使用できます。コードブロックは、ブラウザ拡張機能のインストールには利用できません。
ガイドステップにコードブロックを追加した後、HTMLセクションにカスタムコードを追加します。以下は、訪問者IDとアカウントIDをサードパーティに送信するコードスニペットの例です。アンケートのURLで修正する必要があります。
<iframe id="pendo-survey-frame" style="min-width:425px;height:450px;border:none" src="https://[アンケートURL]?VisitorID=<%= root.metadata.visitor.id%>&AccountID=<%= root.metadata.account.id%>">
</iframe>
警告： 上記のカスタムコードスニペットは、Pendoプロダクトの機能を拡張することを目的としたものです。しかし、これらのスニペットに対する保証やSLA、サポートはありませんので、ご注意ください。使用は無料ですが、カスタムコードのサポートはテクニカルサポートチームの責任範囲外です。新しいスニペットの作成や既存のスニペットの変更、機能のカスタマイズについてリクエストがある場合は、テクニカルサポートチームではなく、Pendoプロフェッショナルサービス（services@pendo.io）までご連絡ください。なお、これらのリクエストを遂行するには、Pendoとのカスタムサービス契約が必要になります。