クロスアプリガイドは、既存のガイドを統合することで、複数のウェブアプリケーション間でアプリ内メッセージを提供することができます。
クロスアプリガイドは、ウェブアプリケーション用のPendoインストールスクリプトと拡張アプリケーション用のPendo Launcherの両方でアクセスおよび設定できますが、これら2種類を組み合わせてクロスアプリガイドを作成することはできません。
権限
ガイドの役割には、ガイド作成者、ガイド公開者、およびガイドコンテンツ編集者という3つがあり、それぞれ権限が異なります。管理者ユーザーは以下のすべての権限を持っています。
- ガイド作成者の役割の権限を持つPendoユーザーは、ゼロからガイドを作成および編集することができます。また、公開されていない既存のガイドを編集することもできます。
- ガイド作成者またはガイドコンテンツ編集者の役割の権限を持つPendoユーザーは、レイアウトやテンプレートからガイドを作成および編集することができます。
- ガイド公開者の役割の権限を持つPendoユーザーは、ガイドを公開し、スケジュールすることができます。
- すべてのガイドの役割は、ドラフト、ステージング、無効のガイドを削除することができます。
必要に応じて、以下のガイド権限を組み合わせてカスタムユーザーの役割を作成することもできます。
- ゼロからガイドを作成、編集する。
- レイアウトからガイドを作成および編集する。
- ガイドを公開する。
- 公開ガイドを編集、削除する。
- ドラフト、ステージング、無効のガイドを削除する。
詳細については、「役割と権限」を参照してください。
前提条件
この機能は、Guides Proを含むPendoサブスクリプションで利用できます。ご利用のプランにこの機能が含まれているかどうか不明な場合、またはこの機能に関心をお持ちの場合は、Pendoのアカウント担当者にお問い合わせください。
Pendoのインストールスクリプト（スニペット）を使用している場合、クロスアプリガイドに含まれる各アプリケーションでクロスアプリCookieとローカルストレージを有効にする必要があります。有効にするには以下の手順に従います。
- ［設定］>［サブスクリプション設定］>［アプリケーション］に移動します。
- クロスアプリガイドに含めるガイドのアプリケーションを見つけて開きます。
-
［クロスアプリのCookieとローカルストレージ］をオンにします。
Pendo Launcher（拡張機能）を使用している場合、この設定はデフォルトで既に有効になっており、設定は不要です。
追加の要件は次のとおりです。
- クロスアプリガイドに含めるガイドは、すでに存在している必要があります。ガイドの作成方法については、オーバーレイガイドを作成するを参照してください。
- 各アプリケーションでガイドを表示するには、許可が必要です。特定のアプリにアクセスできない場合、そのアプリからガイドを選択することはできません。
- ガイド内のすべてのアプリケーションは、同じセカンドレベルドメイン（例：
example.com）を共有する必要があります。サブドメインは異なることがあります。例えば、123.example.comとabc.example.comは互換性があります。
クロスアプリ ガイドでは次の操作は実行できません。
- クロスアプリガイドを別のクロスアプリガイドのステップとして含めることはできません。
- リソースセンターにクロスアプリガイドを追加することはできません。
- クロスアプリガイドではガイドスロットリングを使用できません。
- クロスアプリガイドのアクティベーション方法として確認を使用することはできません。
- Pendoの直接ウェブ（インストールスクリプト）実装で作成したガイドと、Pendoのブラウザ拡張機能（Pendo Launcher）実装で作成したガイドを組み合わせることはできません。
クロスアプリガイドを作成する
クロスアプリガイドを作成するには、［Guides］>［ガイド］に移動し、次の操作を行います。
-
ガイドページの右上隅で、［ガイドの作成］の横にある矢印を選択してドロップダウンメニューを開き、［クロスアプリガイドの作成］を選択します。
-
［クロスアプリガイドの作成］ページで、クロスアプリガイドのわかりやすい名前を入力します。
-
［ガイドの選択］領域で、ドロップダウンメニューから既存のガイドを選択します。ガイドを選択すると、［ガイドの選択］テーブルには、アプリケーション、ガイドのステータス、ステップ数（#）が表示されます。選択したガイドのステータスは自動的にドラフトに移動されます。
-
［ガイド開始URL］フィールドに各ガイドの最初のステップのアプリケーションURLを入力します。
各ガイドのURLは、各アプリケーションのCookieとデータプライバシー設定のCookieドメイン値（例：github.io）と一致する必要があります。この値を確認するには：- 各アプリケーションについて、［設定］>［サブスクリプション設定］>［アプリケーション］に移動します。
- クロスアプリガイドに含めるガイドのアプリケーションを見つけて開きます。
-
［Cookieとデータプライバシー］の下にリストされているCookieドメインの値を確認してください。これは、ガイドの最初のステップがアンカーされているアプリケーションの第2レベルドメインと一致する必要があります。たとえば、ガイドが
https://123.github.ioから読み込まれる場合、クッキードメインの値はgithub.ioでなければなりません。
- クロスアプリガイドに含める追加の既存ガイドのURLを選択して追加し続けます。
- 最初に選択したガイドがPendoの直接Web（インストールスクリプト）実装用に作成されたものであれば、リストにはPendoの直接Web実装用に作成された他のガイドのみが含まれます。
- 最初に選択したガイドがPendoのブラウザ拡張機能（Pendo Launcher）の実装用に作成された場合、リストには他のブラウザ拡張機能の実装用に作成されたガイドのみが含まれます。
- 必要なガイドをすべて追加したら、ページの右下隅にある［ガイドを作成］を選択します。これによりガイドの［設定］ページが開きます。
ガイド設定を表示する
クロスアプリガイドを作成すると、自動的に［設定］ページに移動します。作成直後ではないクロスアプリガイドの設定を表示するには：
- 左側のメニューから、［ガイド（Guides）］>［ガイド］に移動します。デフォルトで［概要］タブが開きます。
- クロスアプリガイドを見つけて開きます。クロスアプリガイドは、ガイドテーブルのアプリ列にアイコンで示されます。
ガイドを開くと、デフォルトで［設定］タブが開きます。クロスアプリガイド内の各ガイドステップとアプリは、コンテンツセクションでラベル付けされています。ここから、クロスアプリガイドに含まれるガイドアプリケーションとガイドステップを閲覧できます。
［設定］ページから、以下の操作も可能です。
- ビジュアルデザインスタジオでクロスアプリガイドの内容を編集します。手順については、この記事の「クロスアプリガイドを編集する」を参照してください。
- ガイドの開始日時と終了日時をスケジュールし、有効期限を設定します。手順については、「ガイドをテストして配信する」を参照してください。
- アクティベーション方法を設定します。手順については、「ガイドのアクティベーション」を参照してください。
- クロスアプリガイドのセグメントを定義します。手順については、「ガイドをテストして配信する」を参照してください。
クロスアプリガイドを編集する
- ガイドの［設定］ページで、［アプリで編集］を選択します。
- 編集を開始するには、クロスアプリガイドの手順を選択します。
- ガイドステップのURLを入力します。
- ウィンドウ右下の［デザイナーを起動］を選択します。これにより、アプリケーション上でビジュアルデザインスタジオが新しいタブで開き、クロスアプリガイドの内容を編集できます。
- 完了したら、ツールバーの右上隅にある［保存］を選択し、次に［終了］を選択します。