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

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

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

    始める前に

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

    このタスクについて

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

    https://<instance>/<portal suffix>/<guest language>/<keywords>?id=<page id>&<page parameters>

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

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

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

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

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

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

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

    タスクの結果

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

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

    URL に人間が判読できるキーワードを含むナレッジ記事ページ

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

    • カテゴリ は FAQ
    • 簡単な説明 は「 クッキーとは?」です。

    ページは、 %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 メソッドの 1 つを使用して、ページ URL の人間が判読できるキーワードを返し、それらを正規 URL に含めます。

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