hreflang generator at checker

Sinasabi ng hreflang sa search engine na ang page ay may version sa ibang wika o para sa ibang bansa. Ginagamit ng Google ang mga link na ito para ipakita ang tamang version sa bawat user: ang user sa Pilipinas ay nakakakita ng /ph/pricing na may presyo sa piso, ang user sa US ay /us/pricing na may dolyar. Hindi ranking factor: tumutulong na piliin anong URL ipapakita.

Sinusuportahan ng Google ang tatlong pantay na paraan ng markup:

Ang value ng attribute ay ISO 639-1 language code, opsyonal na sinusundan ng ISO 3166-1 alpha-2 country code pagkatapos ng hyphen: en, en-PH, tl-PH. Ang espesyal na x-default ay nagmamarka ng page para sa ibang user: language selector o pangunahing version.

Hindi kailangan ng hreflang ang site na may isang wika at isang merkado. Kailangan kapag may ilang variant ang parehong page: salin, regional version na may ibang presyo at currency, o English na site para sa Pilipinas at para sa US.

Reciprocity at self-reference

Pangunahing rule sa dokumentasyon ng Google: dapat reciprocal ang mga link. Kung nag-link ang US version sa PH version, dapat nag-link pabalik ang PH version; kung hindi, maaaring balewalain ang markup. Inililista ng bawat version ang sarili. Ang pinakasimple ay ilagay ang parehong kumpletong set sa bawat version — tulad ng binubuo ng generator.

Filipino: “fil” o “tl”?

Ang Filipino ay walang dalawang-titik na ISO 639-1 code; ang fil ay mula ISO 639-2 at itinuturing na standard sa BCP 47, at ito ang code na ipinapadala ng browser. Ngunit sinasabi ng dokumentasyon ng Google na ang value ng hreflang ay nasa ISO 639-1 format, at hindi dokumentado kung tinatanggap ang fil. Ang pinakakonserbatibong pagpipilian ay tl o tl-PH (Tagalog, ang batayan ng Filipino), na nasa ISO 639-1. Sumusunod ang tool sa dokumentasyon: minamarkahan ang fil bilang tatlong-titik na code. Kung pipiliin ang fil, gamitin nang konsistent sa buong site at sa HTML lang attribute.

Mga code

• Palaging kailangan ang wika; ang bansa ay kasama ng wika lamang. Error ang hreflang="PH" — gamitin ang en-PH o tl-PH.
• Hyphen ang separator. Lumalabas ang en_PH sa software locale at og:locale, ngunit ang tamang anyo sa hreflang ay en-PH.
• Ang wika na walang bansa ay fallback para sa lahat ng bansa. Kung may en-PH at en-US, magdagdag ng en para sa mga English speaker sa ibang lugar.

hreflang at canonical

Ang bawat version ay dapat canonical sa sarili. Karaniwang pagkakamali ang pag-point ng rel="canonical" ng PH version sa US version dahil magkahawig ang teksto: idinedeklara ito bilang duplicate, at maaaring hindi ipakita ng search engine. Ang canonical ay point sa page ng parehong variant; ang hreflang ay naglalarawan sa ugnayan. Dapat tumugma ang hreflang URL sa canonical URL: walang dagdag na parameter, parehong protocol at trailing slash.

Mga URL

Gumamit ng buong URL na may protocol at domain: https://example.com/ph/, hindi /ph/. Ang mga version ay maaaring nasa magkaibang domain (example.com.ph, example.com) — gumagana ang hreflang sa pagitan ng mga domain. Ang mga page sa set ay dapat magbalik ng 200 at hindi naka-block sa indexing.

Nakasalalay ang Google sa hreflang. Kasaysayang inirekomenda ng Bing ang HTML lang attribute o content-language meta tag at malinaw na URL structure, at nagbibigay ng mas kaunting timbang sa hreflang. Sa praktika, ilagay ang lang attribute at hreflang.

Country domain, subdomain o subfolder

Inihahambing ng gabay ng Google para sa multi-regional at multilingual na site ang mga opsyon nang ganoon:

• Country-code domain (example.com.ph, example.sg) — pinakamalinaw na signal ng bansa, ngunit ang bawat domain ay kailangang bilhin, panatilihin at palaguin nang hiwalay.
• Subdomain (ph.example.com) — madaling i-host nang hiwalay; mas hindi malinaw sa user ang ugnayan sa pangunahing site.
• Subfolder (example.com/ph/) — pinakamadaling panatilihin: isang host, shared na domain history. Para sa SaaS, karaniwang pinakapraktikal.
• URL parameter (?lang=tl) ay hindi inirerekomenda ng Google: mahirap malaman anong version nakikita ng user.

Anuman ang pinili, huwag awtomatikong i-redirect ang user ayon sa IP o wika ng browser. Maaaring hindi kailanman makita ng crawler ang ibang version, at maaaring hindi makarating ang user sa version na nais. Magpakita ng nakikitang language switcher at hayaang ituro ng hreflang ang tamang URL sa search engine.

• Walang return link. Idinagdag ang markup sa pangunahing version lamang — hindi nag-link pabalik ang ibang version.
• Walang self-reference. Inililista ng page ang lahat ng version maliban sa sarili.
• Invalid na code: en_PH, PH na walang wika, ph (hindi language code), tatlong-titik na code tulad ng eng.
• Relative URL, o URL na may tracking parameter o #fragment.
• Canonical sa ibang variant. Idinedeklara ang PH version bilang duplicate ng US version.
• Version na naka-block sa indexing sa robots.txt o gamit ang noindex — nag-point ang link sa page na hindi magagamit ng search engine.
• Isang code, dalawang URL. Dalawang magkaibang URL na may hreflang="en-PH" sa isang set.
• Page na hindi isinalin. Ang “Tagalog” version na nasa English ang nilalaman ay duplicate, hindi language version.
• Markup sa ilang lugar na hindi magkatugma: isang set sa HTML, ibang set sa sitemap.

1. Google Search Central. Tell Google about localized versions of your page — developers.google.com/search/docs/specialty/international/localized-versions.
2. Google Search Central. Managing multi-regional and multilingual sites — developers.google.com/search/docs/specialty/international/managing-multi-regional-sites.
3. ISO 639-1:2002 at ISO 639-2 (fil — Filipino; tl — Tagalog); registry — loc.gov/standards/iso639-2.
4. ISO 3166-1. Codes for the representation of names of countries — iso.org/iso-3166-country-codes.html.
5. RFC 5646 (BCP 47). Tags for Identifying Languages. IETF, 2009.
6. Sitemaps.org. Sitemap protocol — sitemaps.org/protocol.html.
7. Bing Webmaster Blog. How to optimize your content for search in multiple languages and regions — blogs.bing.com/webmaster.