ウェブアプリのページとフィーチャーを一括作成および更新する

Pendoサポートと連携して、CSVファイルを使用してページタグとフィーチャータグを一括で作成または更新できます。この方法を使えば、UI上で各操作を手動で行うことなく、多数のタグを管理できます。

この記事では、一括処理リクエストを送信するタイミング、CSVファイルの構造、各列に含めるべき値について説明します。

要件

始める前に：

• 作成または更新したい値を正確に把握しておいてください。
• 必要な形式に一致するCSVファイルを作成してください。
• アプリケーションごと、アクションごとに1つのCSVファイルを作成してください。
• 一括リクエストはウェブアプリケーションにのみ適用されることを理解してください。

一括アクションリクエストを提出するタイミング

必要な変更内容がすでに決まっている場合は、サポートチームと連携して一括作成や更新依頼を行うことができます。これには、新しいタグの作成や、ルール、名前、説明の変更など、既存のページやフィーチャーの更新が含まれます。

この方法を使用するには、適用したい値を正確に定義し、適切な形式のCSVファイルで提供してください。アプリケーションごと、アクションごとに1つのCSVファイルを作成してください（ページを作成するためのファイルと、フィーチャーを更新するためのファイルなど）。

正確なルールや値がわからない場合は、代わりに以下のいずれかのオプションを使用してください。

• ビジュアルデザインスタジオを使用して、ページまたはフィーチャーに手動でタグを付けます。
• ページまたはフィーチャーの提案されたタグを使用して、使用データに基づいてタグを生成します。
• カスタムHTML属性による自動タグ付けを設定します。

ページを一括作成する

各行が1つのページタグを表すCSVファイルを作成します。列のヘッダーを正確にコピーして貼り付けてください。
 

列の定義

• ページ名。ページタグの名前。
• 包含ルール。ページにマッチさせたいURLパターン。追加のガイドラインについては「ルールのフォーマット要件」を参照してください。
• 説明。ページに関する補足説明。
• プロダクトエリア。サブスクリプションの既存のプロダクトエリアと正確に一致している必要があります。
• 除外ルール。ページから除外したいURLパターン。追加のガイドラインについては「ルールのフォーマット要件」を参照してください。

リクエストを送信する

1. ［設定（Settings）］ > ［サブスクリプション設定（Subscription Settings）］ > ［サポートアクセス（Support access）］でアクセス権を付与します。これには管理者権限が必要です。
2. サポートチケットを提出します。ガイドラインについては、テクニカルサポートチームにPendoに関する問い合わせをするを参照してください。
3. 以下の詳細を含めてください。
   • サブスクリプション名。
   • ウェブアプリケーション名。
   • CSVファイル。

フィーチャーを一括作成する

各行が1つのフィーチャータグを表すCSVファイルを作成します。列のヘッダーを正確にコピー＆ペーストしてください。

列の定義

• フィーチャー名。フィーチャー名。
• ルール。フィーチャーを識別するために使用されるセレクター。追加のガイドラインについては「ルールのフォーマット要件」を参照してください。
• 説明。このフィーチャーに関する追加のコンテキスト。
• ページ名。既存のページと完全に一致している必要があります。空白の場合は、そのフィーチャーがサイト全体に適用されます。
• プロダクトエリア。サブスクリプションの既存のプロダクトエリアと正確に一致している必要があります。

リクエストを送信する

1. ［設定（Settings）］ > ［サブスクリプション設定（Subscription Settings）］ > ［サポートアクセス（Support access）］でアクセス権を付与します。これには管理者権限が必要です。
2. サポートチケットを提出します。ガイドラインについては、テクニカルサポートチームにPendoに関する問い合わせをするを参照してください。
3. 以下の詳細を含めてください。
   • サブスクリプション名。
   • ウェブアプリケーション名。
   • CSVファイル。

ルールのフォーマット要件

Pendoに作成させたいルールを正確に入力してください。

• ページの例：//*/pricing
• フィーチャーの例：.button-primary

複数のルールはカンマとスペースで区切ってください。

• 例: //*/pricing, //*/fees

ルールを括弧や引用符で囲まないでください。

• 正しい例：//*/pricing, //*/fees
• 正しくない例：["//*/pricing", "//*/fees"]

あるルールにページパラメータが含まれている場合は、複数のルールを持つページタグを作成する際にそれを最初に配置してください。

• 正しい例：//*/pricing/*parameter*/signup, //*/pricing/**
• 正しくない例：//*/pricing/**, //*/pricing/*parameter*/signup

ページまたはフィーチャーを一括更新する

サポートチームが提供するCSVエクスポートを修正することで、既存のタグを一括更新できます。アプリケーションごと、アクションごとに1つのCSVファイルを使用してください。

このプロセスには以下のステップが含まれます。

1. 既存のページタグまたはフィーチャータグのエクスポートをリクエストします。
2. 変更内容をCSVファイルに反映させます。
3. 更新したファイルをサポート宛に返送します。

ステップ1. エクスポートをリクエストする

1. ［設定（Settings）］ > ［サブスクリプション設定（Subscription Settings）］ > ［サポートアクセス（Support access）］でアクセス権を付与します。これには管理者権限が必要です。
2. サポートチケットを提出します。ガイドラインについては、テクニカルサポートチームにPendoに関する問い合わせをするを参照してください。
3. 以下の詳細を含めてください。
   • サブスクリプション名。
   • ウェブアプリケーション名。
   • タグを一括更新したい旨を説明し、既存のページタグまたはフィーチャータグのエクスポートを依頼してください。

ステップ2. CSVを更新する

ページについては、ページ名、説明、ルールを更新できます。

ページに必要なCSV列：

• ページID
• 以下のうち少なくとも1つ：
  • 新しい名前
  • 新しい説明
  • 新しい包含ルール
  • 新しい除外ルール

フィーチャーについては、フィーチャー名、説明、ルールを更新できます。フィーチャーの関連ページを一括更新することはできません。フィーチャーのページを変更するには、UIのタグを更新してください。

フィーチャーに必須のCSV列：

• 機能ID
• 以下のうち少なくとも1つ：
  • 新しい名前
  • 新しい説明
  • 新しいルール

ステップ3. 更新したCSVファイルをサポートに送信する

ファイルを送信する前に：

• 更新したいフィーチャーまたはページに関する行のみを残してください。
• 列ヘッダー名は変更しないでください。
• 更新したくない列は、空白のままにするか削除してください。
• 複数のルールはカンマとスペースで区切ってください。
• ルールを更新すると、新しい値が既存の値に置き換わります。新しい列に、必要なルールをすべて含めてください。

たとえば、すでに1つのルールがあるタグに2つ目のルールを追加するには、新しい列に両方のルールを含めます。