ページ URL への人間が判読できるキーワードの追加

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：5分

    • ポータルページの URL に人間が判読できるキーワードを追加して、検索エンジン最適化 (SEO) とクリックスルー率を向上させ、ユーザーがページで何を期待するかを理解できるようにします。

    始める前に

    必要なロール：sp_admin または admin

    このタスクについて

    人間が判読できるキーワードは、次の形式で URL に追加されます。

    https://<instance>/<portal suffix>/<guest language>/<keywords>?id=<page id>&<page パラメーター>

    キーワードは、静的コンテンツまたは動的ページ変数を使用して入力でき、単一のスラッシュ (/) を含めることができます。動的ページ変数は、レコード内のデータに基づくキーワードをロードします。URL のページパラメーターは、使用するレコードを指定します。次の例では、ナレッジ記事のカテゴリと簡単な説明、およびカタログアイテムのカテゴリと名前がキーワードとして追加されています。

    • https://<instance>/kb/en/faq/what-is-a-cookie?id=kb_article_view&sysparm_article=KB0000007
    • https://<instance>/sp/es/hardware/developer-laptop-mac?id=sc_cat_item&sys_id=774906834fbb4200086eeed18110c737
    注:
    インスタンスに対して人間が判読できる URL をオフにするには、 glide.service_portal.enable_human_readable_urls プロパティをシステムプロパティ [sys_properties] テーブルに追加し、値を false に設定します。

    手順

    1. 次のように移動する。 All (すべて) > サービスポータル > ページ.
    2. ページを選択します。
    3. オプション: 動的ページ変数をページに追加することで、ページコンテンツに基づいて動的なキーワードを使用します。
      1. [動的ページ変数] 関連リストタブを選択します。
      2. [New (新規)] を選択します。
      3. フォームのフィールドに入力します。
        表 : 1. 動的ページ変数フォーム
        フィールド 説明
        [Name (名前)] レコードデータからページ URL のキーワードをロードする変数。変数名は % で始まる必要があり、スペースを含めることはできません。例:%short_descr。
        順序 同じ名前の複数の動的ページ変数の URL クエリパラメーターが異なる場合の、低いものから高いものへの優先順位。
        ページ 動的ページ変数を使用して URL にキーワードを含めるページ。
        URL クエリパラメーター 表示するレコードを決定するページ URL のパラメーター。
        関連するテーブル列 URL クエリパラメーターの値を含む、指定されたテーブル内の列。デフォルト値は Sys ID です。
        テーブル URL のキーワードと列に URL クエリパラメーターの値を入力するために使用されるレコードを含むテーブル。
        テーブルフィールド URL のキーワードを入力する、指定されたテーブル内のレコードのフィールド。
        クエリ条件 テーブル内のレコードをフィルタリングする条件。レコードは、適用する変数のクエリ条件を満たす必要があります。

        この例は、公開されたワークフローの番号で識別されるナレッジベース記事の簡単な説明を参照する変数の値を示しています。

        表 : 2. 動的ページ変数
        フィールド 値
        [Name (名前)] %short_descr
        ページ kb_article_view
        順序 100
        URL クエリパラメーター sysparm_article
        関連するテーブル列 [Number (番号)]
        テーブル ナレッジ[kb_knowledge]
        テーブルフィールド 簡単な説明
        クエリ条件 [ワークフロー][次の値に等しい][公開済み]
    4. [Submit (送信)] を選択します。
    5. ページレコードの [人間が判読できる URL 構造 ] フィールドで、静的コンテンツ、動的ページ変数、またはその組み合わせを使用して、ページ URL に入力するキーワードを指定します。

      キーワードには、英数字、ハイフン (‐)、1 つのスラッシュ (/)、および変数のパーセント記号 (%) を含めることができます。

      人間が判読できる URL 構造 サンプル値
      スタティックコンテンツ faq/what-is-a-cookie
      動的ページ変数 %category/%short_descr
      静的コンテンツと動的ページ変数 FAQ/%short_descr

      キーワードは、小文字のみを使用し、スペースをハイフンに置き換え、動的ページ変数によって追加された許可されていない特殊文字を削除するように自動的に書式設定されます。URL 内のキーワードが 75 文字を超える場合は、75 文字以下に切り捨てられます。

    6. [Update (更新)] を選択します。

    タスクの結果

    ユーザーが人間が判読できるキーワードのない URL を使用してページにアクセスした場合、ページの URL は次のいずれかの方法で更新されます。

    • ゲストユーザーによる最初のページロード時に、ページは人間が判読できる URL にリダイレクトされます。
    • 認証されたユーザーによる最初のページロード時に、リダイレクトなしで人間が判読できるキーワードが含まれるように URL が更新されます。
    • その後、すべてのユーザーのページが読み込まれると、リダイレクトなしで人間が判読できるキーワードが含まれるように URL が更新されます。

    URL に人間が判読できるキーワードが含まれているナレッジ記事ページ

    この例では、kb_article_viewページにナレッジ記事KB0000007が表示されています。ナレッジ記事レコードには、次のフィールドと値があります。

    • カテゴリは FAQ です
    • 簡単な説明 : Cookie とは?

    ページは、 %category/%short_descr などの動的ページ変数を使用して、これらのフィールド値に基づいてキーワードを URL に追加するように構成されています。簡単な説明の疑問符は、URL キーワードで許可されている文字ではないため、URL から自動的に削除されます。URL にある疑問符は、常にページ ID の前に含まれるクエリパラメーターです。

    ブラウザーに表示される URL は、 http://<instance>.com/kb/en/faq/what-is-a-cookie?id=kb_article_view&sysparm_article=KB0000007 のように表示されます。

    次のタスク

    正規 URL を持つページの場合、正規 URL に人間が判読できるキーワードを含める必要があります。ページの正規 URL を返す SEO スクリプトインクルードで、SPSEOUtilsSNC クラスのいずれかの getHumanReadableUrl メソッドを使用して、人間が判読可能なページ URL のキーワードを返し、正規 URL に含めます。

    正規 URL に人間が判読できるキーワードを含める方法の詳細については、次のリソースを参照してください。