この記事では、Pendoでビジター(visitor)向けにCookie同意(cookie consent)カテゴリを設定する方法について説明します。アプリがOneTrustのような同意管理プラットフォーム(CMP)で構築されたCookie同意バナーなどをビジターに表示する場合、そのバナーはすでにCookieを「厳密に必要」「機能」「パフォーマンス」「ターゲティング」などのカテゴリに分類しています。
PendoのCookie同意設定を使用すると、それらと同じカテゴリを反映できます。その後、各カテゴリでPendoが追跡・保存する内容を管理できます。
ユースケース
Cookie同意設定は、次のような場合に使用します。
- すべてのトラッキングを許可または拒否する単一の選択肢ではなく、ビジターが安心できるCookieカテゴリのみを承諾できるようにする。
- 各同意カテゴリで許可される内容を確認し、プライバシーチームや法務チームと詳細を共有できるようにする。
仕組み
Cookie同意カテゴリは、設定を保存し、インストールスクリプト(install script)が対応するカテゴリIDを渡した後にのみビジターに影響します。これを一度も設定しない場合や、Pendoで設定してもインストールスクリプトを通じてIDを連携しない場合、Pendoは同意カテゴリを使用しません。その場合、既存のアナリティクス、ガイド、セッションリプレイ(Session Replay)の設定が引き続き適用されます。
Cookie同意カテゴリを設定することを選んだ場合、各アプリケーションには最初から4つのデフォルトの同意レベル、厳密に必要、機能、パフォーマンス、ターゲティングが用意されています。各カテゴリには、トラッキング、アナリティクス、ガイド、セッションリプレイのオプションが含まれます。これらの設定はデフォルトですべて有効になっているため、それぞれの内容を確認して調整してください。
デフォルトの4つのカテゴリに加えて、カスタムカテゴリを最大6つ追加でき、合計で10個のカテゴリを作成できます。
ビジターが複数の同意カテゴリを選択した場合、Pendoはそれらすべてのカテゴリの権限を組み合わせます。選択されたいずれかのカテゴリで有効になっている権限は適用されます。たとえば、あるカテゴリでガイドが有効になっていて、別のカテゴリでセッションリプレイが有効になっている場合、両方とも適用されます。
開始する前に
- アプリに対して、サブスクリプション管理者(subscription admin)であるか、Cookie同意の編集権限を持っている必要があります。詳細については、Cookie同意の編集カスタムロールを参照してください。
- Cookie同意設定はWebアプリケーションでのみ利用可能です。モバイルアプリケーションや拡張機能アプリケーションでは利用できません。
- アプリケーションは、インストールスクリプトでビジターの同意カテゴリをPendoに渡す必要があります。初期化オプションとランタイムAPIについては、Web SDKドキュメントを参照してください。
Cookie同意設定を開く
- 設定(Settings) > サブスクリプション設定(Subscription settings) > アプリケーション(Applications)に移動します。
- リストからアプリを選択します。
-
Cookie同意タブを選択します。
カテゴリを設定する
- Cookie同意タブの左側のパネルで、設定したいカテゴリを選択します。
- ビジタートラッキング(Visitor tracking)、Analytics、Guides、セッションリプレイについて、追跡したい内容を選択します。
- 保存を選択します。
変更したいカテゴリごとにこの手順を繰り返します。
注: 変更を保存し、インストールスクリプトが対応するカテゴリIDを渡すまで、変更はビジターに影響しません。詳細については、仕組みを参照してください。
カテゴリの追加、複製、削除
- カテゴリを追加する。 +カテゴリを追加を選択します。
-
カテゴリを複製する。 カテゴリの横にある複製アイコンを選択します。
- 複製したカテゴリを設定したら、保存を選択します。
- 複製したカテゴリを設定したら、保存を選択します。
-
カテゴリを削除する。 カテゴリを削除するには...を選択します。
注: カテゴリの削除は元に戻せません。また、インストールスクリプトからそのカテゴリのIDを削除する必要があります。
カテゴリIDの名前を変更する
デフォルトの4つのカテゴリには、あらかじめ同意カテゴリIDが入力されています。カテゴリIDの名前を変更した後は、保存する必要があります。
| カテゴリ | デフォルトID |
|---|---|
| 厳密に必要 | strictlyNecessary |
| 機能 | functional |
| パフォーマンス | performance |
| ターゲティング | targeting |
IDの名前は変更できますが、各カテゴリには一意のIDが必要です。
注: インストールスクリプトに追加した後でカテゴリIDの名前を変更した場合は、インストールスクリプト内のIDも更新する必要があります。
ビジタートラッキング
ビジタートラッキング セクションでは、同意カテゴリごとにビジターを追跡するかどうかを選択します。ビジターを追跡しないを選択すると、そのカテゴリのビジターには以下が適用されます。
- ビジターは識別されません。
- ガイド配信アナリティクスを除き、アナリティクス収集が無効になります。
- テキスト収集が無効になります。
- セッションリプレイが無効になります。
- バッジ(badge)またはターゲット要素によるアクティベーションを使用するガイドは引き続き表示されます。それ以外のアクティベーション方法を使用するガイドは表示されません。
Analytics
Analytics では、メイントグルを使用してすべてのアナリティクス収集を有効にするか、そのカテゴリで追跡したいイベントを個別に選択します。
| Analyticsイベント | 説明 |
|---|---|
| 識別 | ビジターが匿名ではないビジターID(Visitor ID)で初期化または更新されたとき、またはアカウントID(Account ID)が変更されたときに送信されます。 |
| メタ | ビジターのメタデータ(metadata)(IDや、ビジターまたはアカウント(account)のフィールドを含む)が変更されたときに送信されます。 |
| ページロード | PendoがURLの変更を検知するとイベントを送信します。URLの変更は、ページの読み込み、URLのカスタマイズ、またはPageイベントプロパティ(event properties)によって発生する場合があります。 |
| クリック |
通常はクリックに反応しない要素を含め、任意の要素へのクリックを記録します。 |
| フォーカス | ビジターがTabキーを使用して要素間を移動する場合など、要素がフォーカスを受け取ったときに記録します。 |
| フォーム送信 | フォーム要素でのsubmitイベントを記録します。 |
| フィールド変更 |
<input>、<select>、<textarea>、<button>でのchangeイベントを記録します。 |
| Track Events | エラーやAPI呼び出しなど、コードからPendoに送信されるカスタムイベントを記録します。 |
| ガイド配信 | ガイドの表示、ガイド要素の指標、ガイドのスヌーズ、ガイドの却下など、Pendoがガイドアナリティクスやガイドの配信に使用するガイドイベントを記録します。 |
| UTMパラメータ | URLのクエリ文字列内のキャンペーントラッキングタグを読み取り、訪問をビジターを送信したキャンペーンに関連付けます。 |
| プロンプト | ビジターがAIエージェントに送信したメッセージを記録します。Agent Analyticsに適用されます。 |
| エージェントの応答 | AIエージェントがビジターに返す応答を記録します。Agent Analyticsに適用されます。 |
| ユーザーの反応 | AIエージェントの応答に対するビジターのフィードバック(ポジティブまたはネガティブなど)を記録します。Agent Analyticsに適用されます。 |
| テキスト収集 | ビジターが入力したテキストを収集します。すべてのテキストを収集するか、許可リストに含まれるテキストのみに制限するかを選択します。 |
Guides
Guides設定は、この同意カテゴリに対してPendoがアプリ内ガイドを配信できるかどうかを制御します。オンにすると、Web SDKはローカルストレージを使用してガイドの進行状況、却下、スヌーズ、ランチャーの状態を記憶し、再表示を促すことなくガイダンスを適切な状態に保ちます。Guidesを同意に紐づけることで、製品内のヘルプを訪問者の選択と整合させ、プライバシーポリシーでカバーする必要があるブラウザストレージを明確にします。
セッションリプレイ
セッションリプレイ設定は、この同意カテゴリに属する訪問者について、訪問者セッションを記録して再生できるかどうかを制御します。オンになっており、訪問者トラッキングもオンの場合、Web SDKは既存のセッションリプレイ設定(サンプリング、プライバシーマスキングなど)に従ってセッションリプレイデータを取得することがあります。オフの場合、そのカテゴリに対してセッションは取得されません。
Cookie同意を編集するためのカスタムロール(custom role)の作成
カスタムロールを割り当てることで、Cookie同意を編集する権限を付与できます。カスタムロールを作成するには、サブスクリプション管理者である必要があります。
- 設定 > ユーザーとチーム(Users and teams)に移動します。
- カスタムロールタブを選択します。
-
+ カスタムロールを作成を選択します。
-
Pendo権限(Pendo Permissions) > 構成(Configuration)セクションで、Cookie同意設定の編集(Edit cookie consent settings)をオンにします。
- カスタムロールに名前を付けます。
- そのロールにユーザーを割り当てます。