作成日:
Mozilla Support の記事へのリンクは、ユーザーが必要なヘルプに直接アクセスできるようにするために不可欠です。これらのリンクを設定するには主に 2 つの方法があり、どちらの方法を選択するかはリンク元によって決まります。このガイドでは、両方の方法を順を追って説明し、ユーザーが適切なサポートコンテンツをシームレスに見つけられるように、効果的にリンクできるようにします。
目次
製品内から SUMO へのリンク
Firefox または Firefox for Android のブラウザーインターフェイス内に配置されるリンクには、特定の URL 構造を使用する必要があります。この構造により、CX コンテンツチームは Firefox 内の機能を中断することなく、リンク先を調整できます。私たちはさまざまなトピックに対して特定のターゲットを設定しており、オペレーティングシステムや Firefox のバージョンなどの要因に基づいて、ユーザーを最も関連性の高い記事に誘導できます。この柔軟性により、Firefox のコードを変更することなく、Kitsune で直接更新や変更を行うことができます。
製品内から SUMO の記事へのリンクを作成するための形式は次のとおりです:
https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC
%VERSION%/%OS%/%LOCALE%/ の部分はプレースホルダーです。エンジニアはソースコード内でこれらを動的に入力する責任があります。例:
https://support.mozilla.org/1/firefox/13.0a2/Darwin/en-US/prefs-privacy
この構造では:
%VERSION%は Firefox のバージョンを指します。%OS%はユーザーのオペレーティングシステムを表します。%LOCALE%はユーザーの言語と地域の設定を指定します。TOPICはサポート記事の主題を示し、任意のテキスト文字列を指定できます。
Firefox for Android に固有のリンクの場合、デスクトップ版向けのリンクと区別するために、URL に /1/mobile を含める必要があります。
アンカーへのリダイレクトを避ける
記事内の特定のアンカーへのリダイレクトは壊れやすく、ページの構造が変更されると簡単にリンク切れになる可能性があります。リンク切れを防ぐために、常にメインの記事ページにリンクしてください。これにより、記事の内部セクションが更新されてもリンクの有効性が保たれ、ユーザーは必要な情報にアクセスできます。
ウェブプロパティから SUMO へのリンク
Firefox の外部のウェブプロパティからリンクを作成する場合、URL のロケール部分を省略してください。これにより、SUMO システムがユーザーのブラウザー設定に基づいて記事の適切な言語版を自動的に検出し、リダイレクトできます。
したがって、例えば Firefox を最新リリースに更新するには の記事にリンクするには:
- 推奨:
https://support.mozilla.org/kb/update-firefox-latest-release - 非推奨:
https://support.mozilla.org/en-US/kb/update-firefox-latest-release
その他の場所からのリンク
Firefox やウェブサイト (アプリ、製品、メールなど) 以外からリンクする場合、(ロケール文字列なしの) URL を使用してソースを特定するとよいでしょう。
例:
https://support.mozilla.org/kb/update-firefox-latest-release?utm_source=nameofsource
mzl.la 短縮リンクの作成
mzl.la 短縮リンクを作成する方法については、How to obtain a shortened mzl.la link を参照してください。
質問
製品内リンクを設定する必要がある場合は、コンテンツリクエスト Bugzilla チケットを起票してください。ご不明な点については、こちらの サポートスレッド に投稿してください。
