hreflangクラスタージェネレーター
同じページの各ロケール版について1行ずつ追加してください。URLからロケールを検出でき、各ページに任意のx-defaultを指定できます。
| hreflang | URL | x-default (任意、ページごと) | 削除 |
|---|
ロケールごとにURLテンプレートを1つ定義し、{path}をプレースホルダーとしてパスを1行に1つ貼り付けてください。
| hreflang | URL テンプレート | x-default url テンプレート (任意、ページごと) | 削除 |
|---|
CSV/TSVのlocale,url行、またはxhtml:link項目を含むsitemap.xmlを貼り付けてください。解析はすべてブラウザー内で行われます。
上にロケールとURLを追加すると、出力が表示されます。 完全にブラウザー内で実行され、貼り付けた内容はアップロードも保存もされません。 匿名化した実行単位の結果件数を集計調査に使う場合があります。URL、ドメイン、IPアドレス、識別子は含めず、100回未満の実行から統計を公開しません。
デプロイ済みのページを取得し、公開中のhreflangアノテーションを読み取ります。次に、宣言された各代替URL(最大25件)を取得して、相互リンクと自己参照を検証します。
+ で現在のサイトまたはページを保存します。保存したサイト、ページ、リストの横にある☆を使うとお気に入りに追加できます。最近のチェック履歴は下に表示されます。
名前付きリストを作成
ローカルの選択内容から対象を入力しました。
サイトパスポート この保存済みサイトのローカルコンテキスト
ローカルデータ
保存した対象、名前付きリスト、最近のチェック概要はこのブラウザ内だけに残ります。
このツールを評価
チェックは当サーバーから実行します。入力したURLは取得しますが、結果は保存しません。 匿名化した実行単位の結果件数を集計調査に使う場合があります。URL、ドメイン、IPアドレス、識別子は含めず、100回未満の実行から統計を公開しません。
ツールのサンプルレポート
米国と英国向けの英語サイトに、汎用の en フォールバックと x-default を設定すると、次のような head タグが生成されます。
<link rel="alternate" hreflang="en-US" href="https://example.com/us/" />
<link rel="alternate" hreflang="en-GB" href="https://example.com/uk/" />
<link rel="alternate" hreflang="en" href="https://example.com/us/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" /> …このクラスターを組み込み検証器で実行すると、次の結果になります。
コードは自動的に正規化されます。en-us または en-US と入力しても、ジェネレーターは地域コードを大文字形式(en-US)で出力します。
汎用の
enがあることで整います。米国と英国以外の英語話者も対象になり、一致しない状態を避けられます。詳しくは 汎用フォールバックなしの地域バリエーション を参照してください。x-defaultはそれ以外のユーザーを受け持ちます。詳しくは x-default の欠落 を参照してください。1ページのタグだけでは双方向性は見えません。しかし、セット内の各ページに同じ完全なブロックを出力するため、一覧にある各URLも自動的にこのURLへ戻る参照を持ちます。
試すには
en-ukの代わりにen-gbを貼り付けます。検証器は修正を示すエラーに変わります。詳しくは コード形式を参照してください。
使い方
ページごとに行を追加し、言語または地域ごとに列を作成して、各URLを入力します。
必要に応じて行ごとに x-default を設定し、既存のサイトマップを取り込んでクラスターを作成します。
head タグ、サイトマップ XML、または HTTP Link ヘッダーをコピーします。各ページには完全な双方向クラスターが付与されます。
公開中のマークアップを貼り付けるかURLを確認して、公開前のよくある誤りを見つけます。
仕組み(hreflang が壊れる理由も含む)
通常のウェブページの HTML テンプレートを管理している場合に使用します。
通常は最も分かりやすい方法です。各ページの head に同じ完全なクラスターを出力します。
テンプレートの変更が難しい、または多数のURLバリエーションを一元管理している場合に使用します。
xhtml:link エントリを一貫して使用し、クローラーがサイトマップにアクセスできる状態を保ちます。
代替先が PDF または HTML 以外のリソースである場合に使用します。
HTML head を持たないファイルに適した実用的な方法です。理由なく複数方式を混在させないでください。
hreflang は、ページにどの言語・地域版が存在するかを検索エンジンへ示し、検索者に適切な版を届けます。配信方法は同等の3種類です。<link rel="alternate"> タグを <head> に置く方法、XML サイトマップの xhtml:link エントリ、HTTP Link ヘッダー(PDFなどHTML以外のファイルで使える唯一の方法)です。ページごとに1方式を選んでください。混在させると競合の原因になります。
多くの実装を壊すルールは2つあります。すべてのページに自己参照エントリを含めること、そして各ペアを双方向にすることです。A が B を列挙したら、B も A を返さなければ、そのペアは無視されます。このジェネレーターは各ページに完全なクラスターを出力するため、どちらも自動的に満たされます。
汎用フォールバックなしの地域バリエーション
en-US と en-GB を公開しても単独の en がない場合、他の地域の英語話者は一致する版を見つけられず、Google が代わりに選びます。汎用の en エントリを追加してください。
x-default の欠落
x-default は、宣言した言語に一致しないユーザーへ提供するページを示します。通常は言語セレクターまたは主要版です。必須ではありませんが、アルゴリズムに任せるより明示する方が適切です。
独立した言語セレクターページにもアノテーションが必要です。同じ head タグブロックを配置し、x-default 行を自己参照にしてください。これでクラスターの双方向性が保たれます。サイトマップでは、ロケールページでないセレクターURLにも注釈付きの <url> エントリが自動的に追加されます。
x-default はページごとのアノテーションでもあります。同じクラスターのページが異なる x-default を指すこともできます。行ごとの x-default 列を使用してください。
http/https の混在と末尾スラッシュの不一致
hreflang URL は canonical URL と完全に一致する必要があります。http:// の使用や末尾スラッシュの省略によって代替先がリダイレクトを経由すると、Google に破棄されることがあります。各URLの最終的な canonical 形式を使用してください。
非推奨の言語コード
一部の ISO 639-1 コードは変更されましたが、古いコンテンツシステムのエクスポートには残っています。in → id(インドネシア語)、iw → he(ヘブライ語)、ji → yi(イディッシュ語)です。最新のコードを使用してください。
コード形式
値は言語、または言語-REGION の形式です。2文字の ISO 639-1 言語コードに、任意で ISO 3166-1 alpha-2 地域コードを加えます。典型的な誤りは en-uk です。英国の地域コードは GB です。zh-Hant / zh-Hans のようなスクリプトサブタグも有効です。アンダースコア(en_US)は使えません。
言語コードと地域コードを検索
ジェネレーターが受け付ける ISO 639-1 言語コードと ISO 3166-1 地域コードを検索できます。非推奨の言語エイリアスは置き換え先とともに表示されます。
言語 (188)
地域 (249)
方法
このツールはURLと言語ごとの行からクラスターを作り、サブコードを正規化し、自己参照を含む同じ完全な集合を各ページへ出力します。その後、コード、URL、重複、プロトコル、末尾スラッシュ、x-default、双方向性に決定論的なルールを適用します。公開チェックでは指定URLと最大25件の代替URLを取得し、戻りリンク、自己参照、canonical化を比較します。公開チェックの任意リクエスト以外はすべてブラウザー内で実行されます。
機能
自己参照を含む完全な双方向クラスターをページセットごとに生成します。
head タグ、50,000 URL超で自動分割するサイトマップ XML、HTTP Link ヘッダー、ウェブフレームワーク用スニペットを出力します。
言語・地域コードを正規化し、アンダースコア、非推奨コード、無効な地域を検出します。
重複する言語とURL、プロトコルの混在、末尾スラッシュの不一致、双方向性の欠落、x-default の欠落を確認します。
CSV/TSV 行またはサイトマップの xhtml:link エントリを取り込み、分析をブラウザー内だけで実行します。
公開された1つのURLと最大25件の代替URLで、戻りリンクと自己参照を確認します。
制限
ブラウザーで動作し、貼り付けた入力やローカル生成で検索データベースを照会することはありません。
公開URLのチェックはページに到達できることが前提で、代替URLは25件、デコード後の本文は2 MiBに制限されます。
検証器は入力内容を確認しますが、Googleのインデックス登録、非公開コンテンツ、検索エンジンが選ぶURLは確認できません。
サイトマップの分割は50,000 URLを超える生成結果に適用され、ダウンロードにはインデックスと全パートが含まれます。
よくある質問
hreflang タグは head、サイトマップ、HTTP ヘッダーのどこに置きますか?
3 つの方法はいずれも利用でき、同等です。ただし、1 ページにつき 1 つの方法を選んでください。HTML の head に <link rel="alternate"> タグを置くか、XML サイトマップに xhtml:link エントリを置くか、HTTP Link ヘッダーを使います(PDF など HTML 以外のファイルではこれが唯一の方法です)。同じページで方法を混在させると競合の原因になります。
x-default とは何ですか。必須ですか?
x-default は、指定したどのロケールにも一致しないユーザーに表示するページを示します。通常は言語セレクターまたは主要バージョンです。必須ではありませんが、アルゴリズムに任せるより明示するほうがよいため、多くのサイトで推奨されます。
hreflang タグが無視されるのはなぜですか?
ほとんどの場合、理由は 3 つのいずれかです。アノテーションが相互参照になっていない(ページ A が B を列挙しても、B が A を返していない)、自己参照のエントリがない、または URL が canonical 形式(http と https、サイトがリダイレクトする末尾スラッシュなど)と一致せずリダイレクトを経由していることです。このジェネレーターは、最初の 2 つを防ぐため、自己参照を含む完全な相互参照クラスターを出力します。
hreflang と canonical タグは競合しますか?
一致している必要があります。各言語版には自己参照 canonical(別の言語ではなく自分自身を指す canonical)を設定し、各 hreflang URL はそのページの canonical 形式にしてください。canonical ではない URL やリダイレクトする URL を指す hreflang は、しばしば無視されます。
en-uk は有効な hreflang 値ですか?
いいえ。英国の地域コードは GB なので、en-gb を使います。hreflang の値は ISO 639-1 の言語コードと、任意の ISO 3166-1 alpha-2 の地域コードで構成されます。en-uk は最もよくある間違いです。
よくある問題と修正方法
- エラー 言語コードが無効です 修正: 言語サブタグを、en、fr、deなどの有効なISO 639-1コードに置き換えてください。
- エラー 地域コードが無効です 修正: 地域サブタグを、USやGBなどの有効なISO 3166-1 alpha-2コード(大文字)に置き換えてください。
- エラー hreflangでハイフンではなくアンダースコアが使われています 修正: ロケールの区切りをアンダースコアからハイフンに変更してください(例:en_USからen-US)。
- エラー ロケールが重複しています 修正: 言語・地域の値ごとに代替URLを1つだけ残し、重複するロケール行を削除または統合してください。
- 警告 同じURLが複数のロケールに割り当てられています 修正: 各代替URLを実際のロケールに割り当て、同一のローカライズページを指す2つ目のロケールを削除してください。
- 警告 x-defaultの代替URLがありません 修正: 言語選択ページ、または一致しないユーザーに最適な既定ページを指すx-defaultの代替URLを1つ追加してください。
- エラー 代替URLが無効です 修正: 代替URLを、空白や不正な文字のない解析可能なhttp://またはhttps:// URLに修正してください。
- エラー 代替URLが絶対URLではありません 修正: 相対URLを、ホスト名とパスを含む完全なcanonical https:// URLに展開してください。