@jjlmoya/utils-developer 1.4.0 → 1.5.0

package/src/tool/utmGenerator/i18n/it.ts

@@ -0,0 +1,118 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UtmGeneratorUI } from '../ui';
+
+const slug = 'utm-generator-it';
+const title = 'Generatore di Parametri UTM per Google Analytics';
+const description = 'Crea link di tracciamento precisi per le tue campagne di marketing digitale. Ottimizzato per Google Analytics e altri strumenti di analisi.';
+
+const faqData = [
+  {
+    question: 'L\'uso dei parametri UTM è dannoso per la SEO?',
+    answer: 'No, a condizione che utilizzi i tag canonical. I motori di ricerca comprendono che i parametri UTM servono per le analisi e non creano contenuti duplicati.',
+  },
+  {
+    question: 'Dovrei usare i parametri UTM per i link interni?',
+    answer: 'No, mai. I tag UTM sui link interni interrompono la sessione utente in strumenti come Google Analytics, distorcendo i dati sul traffico.',
+  },
+  {
+    question: 'Google Analytics distingue tra maiuscole e minuscole negli UTM?',
+    answer: 'Sì. "google", "Google" e "GOOGLE" verranno trattati come sorgenti diverse. Mantieni sempre la coerenza, preferibilmente usando solo lettere minuscole.',
+  },
+];
+
+const howToData = [
+  { name: 'Inserisci l\'URL', text: 'Inserisci l\'URL completo del tuo sito web, includendo https://' },
+  { name: 'Definisci la sorgente', text: 'Specifica da dove proviene il traffico (google, facebook, newsletter, ecc.)' },
+  { name: 'Seleziona il mezzo', text: 'Scegli il tipo di canale (cpc, email, social, organic, ecc.)' },
+  { name: 'Dai un nome alla campagna', text: 'Assegna un nome identificativo per raggruppare i tuoi sforzi di marketing' },
+  { name: 'Copia e usa', text: 'Copia l\'URL generato e usalo nei tuoi post, annunci o firme email' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'it',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'URL del sito web (es. https://example.com) *',
+  labelSource: 'Sorgente campagna (es. google, newsletter) *',
+  labelMedium: 'Mezzo campagna (es. cpc, email)',
+  labelCampaign: 'Nome campagna (es. offerta_estate)',
+  labelTerm: 'Termine campagna (es. acquisto_scarpe)',
+  labelContent: 'Contenuto campagna (es. banner_superiore)',
+  labelGenerated: 'URL Generata:',
+  btnCopy: 'Copia Link',
+  btnCopied: 'Copiato!',
+  errorInvalid: 'Inserisci un URL valido',
+  errorInvalidUrl: 'URL non valido',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Domande Frequenti',
+  faq: faqData,
+  bibliographyTitle: 'Riferimenti',
+  bibliography: [
+    { name: 'Raccogliere i dati delle campagne con URL personalizzati - Guida di Google Analytics (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'Best Practices for Campaign URL Tagging - VWO Blog (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Generatore UTM: Parametri di Tracciamento per Google Analytics', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'I parametri <strong>UTM</strong> (Urchin Tracking Module) sono etichette di testo aggiunte alla fine di un URL per tracciare il traffico web. Il nostro generatore semplifica la creazione di link tracciabili per le tue campagne di marketing digitale.',
+    },
+    { type: 'title', text: 'I 5 Pilastri di un URL Tracciabile', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Sorgente Campagna:</strong> Identifica il motore di ricerca, il social network o l\'origine del traffico. Esempio: google, newsletter, facebook.',
+        '<strong>Mezzo Campagna:</strong> Si riferisce al canale di marketing. Esempio: cpc, email, social, banner, organic.',
+        '<strong>Nome Campagna:</strong> Il nome specifico della tua campagna. Esempio: offerta_estate_2025, lancio_app_v2.',
+        '<strong>Termine Campagna:</strong> Per la ricerca a pagamento, le parole chiave per cui fai un\'offerta. Esempio: acquisto_scarpe_sportive.',
+        '<strong>Contenuto Campagna:</strong> Per i test A/B. Differenzia elementi simili all\'interno di una campagna. Esempio: header_v1, sidebar_v2.',
+      ],
+    },
+    { type: 'title', text: 'Best Practice per il Tagging UTM', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Coerenza tra maiuscole e minuscole:</strong> Gli strumenti differenziano tra "Google", "GOOGLE" e "google". Usa sempre il minuscolo per evitare duplicati.',
+        '<strong>Evita gli spazi:</strong> Gli spazi diventano %20. Usa trattini (-) o underscore (_) al loro posto.',
+        '<strong>Non usare sui link interni:</strong> Il tracciamento UTM è esclusivamente per il traffico esterno. Sui link interni, interrompe la sessione e rovina le metriche chiave.',
+        '<strong>Documenta i tuoi tag:</strong> Tieni traccia di tutte le combinazioni che utilizzi per evitare incongruenze.',
+      ],
+    },
+  ],
+};
+

package/src/tool/utmGenerator/i18n/ja.ts

@@ -0,0 +1,118 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UtmGeneratorUI } from '../ui';
+
+const slug = 'utm-generator';
+const title = 'Googleアナリティクス用UTMパラメータ生成器';
+const description = 'デジタルマーケティングキャンペーン用の正確なトラッキングリンクを作成します。Googleアナリティクスやその他の分析ツールに最適化されています。';
+
+const faqData = [
+  {
+    question: 'UTMパラメータを使用することはSEOに悪影響を与えますか？',
+    answer: 'いいえ。カノニカル（canonical）タグを使用している限り、問題ありません。検索エンジンはUTMパラメータが分析用であることを理解しており、重複コンテンツとはなしません。',
+  },
+  {
+    question: '内部リンクにUTMパラメータを使用すべきですか？',
+    answer: 'いいえ、絶対に使用しないでください。内部リンクにUTMタグを付けると、Googleアナリティクスなどのツールでユーザーセッションが途切れてしまい、トラフィックデータが歪んでしまいます。',
+  },
+  {
+    question: 'GoogleアナリティクスはUTMの大文字と小文字を区別しますか？',
+    answer: 'はい。「google」、「Google」、「GOOGLE」は異なるソースとして扱われます。常に一貫性を保ち、できれば小文字のみを使用することをお勧めします。',
+  },
+];
+
+const howToData = [
+  { name: 'URLを入力', text: 'https:// を含むウェブサイトの完全なURLを入力します。' },
+  { name: 'ソースを定義', text: 'トラフィックの発生元を指定します（google, facebook, newsletterなど）。' },
+  { name: 'メディアを選択', text: 'チャネルの種類を選択します（cpc, email, social, organicなど）。' },
+  { name: 'キャンペーン名を指定', text: 'マーケティング活動をグループ化するための識別可能な名前を割り当てます。' },
+  { name: 'コピーして使用', text: '生成されたURLをコピーして、投稿、広告、メールの署名などで使用します。' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'ja',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'ウェブサイトのURL (例: https://example.com) *',
+  labelSource: 'キャンペーンのソース (例: google, newsletter) *',
+  labelMedium: 'キャンペーンのメディア (例: cpc, email)',
+  labelCampaign: 'キャンペーン名 (例: summer_offer)',
+  labelTerm: 'キャンペーンのキーワード (例: buy_shoes)',
+  labelContent: 'キャンペーンの内容 (例: banner_top)',
+  labelGenerated: '生成されたURL:',
+  btnCopy: 'リンクをコピー',
+  btnCopied: 'コピー完了！',
+  errorInvalid: '有効なURLを入力してください',
+  errorInvalidUrl: '無効なURLです',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'よくある質問',
+  faq: faqData,
+  bibliographyTitle: '参考文献',
+  bibliography: [
+    { name: 'カスタム URL を使用してキャンペーン データを収集する - Google アナリティクス ヘルプ (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'キャンペーン URL タグ付けのベスト プラクティス - VWO ブログ (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'UTM生成器：Googleアナリティクス用トラッキングパラメータ', level: 2 },
+    {
+      type: 'paragraph',
+      html: '<strong>UTM</strong>パラメータ（Urchin Tracking Module）は、ウェブトラフィックを追跡するためにURLの末尾に追加されるテキストラベルです。当社の生成器は、デジタルマーケティングキャンペーン用の追跡可能なリンクの作成を簡素化します。',
+    },
+    { type: 'title', text: '追跡可能なURLの5つの要素', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>キャンペーンソース：</strong>検索エンジン、ソーシャルネットワーク、またはトラフィックの発生源を特定します。例：google, newsletter, facebook。',
+        '<strong>キャンペーンメディア：</strong>マーケティングチャネルを指します。例：cpc, email, social, banner, organic。',
+        '<strong>キャンペーン名：</strong>キャンペーンの特定の名前です。例：summer_offer_2025, app_launch_v2。',
+        '<strong>キャンペーンキーワード：</strong>有料検索の場合、入札したキーワードです。例：buy_sports_shoes。',
+        '<strong>キャンペーン内容：</strong>A/Bテスト用。キャンペーン内の同様の要素を区別します。例：header_v1, sidebar_v2。',
+      ],
+    },
+    { type: 'title', text: 'UTMタグ付けのベストプラクティス', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>大文字小文字の一貫性：</strong>ツールは「Google」、「GOOGLE」、「google」を区別します。重複を避けるために、常に小文字を使用してください。',
+        '<strong>スペースを避ける：</strong>スペースは %20 になります。代わりにハイフン（-）やアンダースコア（_）を使用してください。',
+        '<strong>内部リンクに使用しない：</strong>UTMトラッキングは外部トラフィック専用です。内部リンクに使用するとセッションが切れ、主要な指標が損なわれます。',
+        '<strong>タグを記録する：</strong>不整合を防ぐために、使用したすべての組み合わせの記録を保存してください。',
+      ],
+    },
+  ],
+};
+

package/src/tool/utmGenerator/i18n/ko.ts

@@ -0,0 +1,118 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UtmGeneratorUI } from '../ui';
+
+const slug = 'utm-generator';
+const title = 'Google 애널리틱스용 UTM 매개변수 생성기';
+const description = '디지털 마케팅 캠페인을 위한 정확한 추적 링크를 만드세요. Google 애널리틱스 및 기타 분석 도구에 최적화되어 있습니다.';
+
+const faqData = [
+  {
+    question: 'UTM 매개변수를 사용하는 것이 SEO에 좋지 않나요?',
+    answer: '아니요, 캐노니컬(canonical) 태그를 사용하는 한 괜찮습니다. 검색 엔진은 UTM 매개변수가 분석용임을 이해하며 중복 콘텐츠를 생성하지 않습니다.',
+  },
+  {
+    question: '내부 링크에 UTM 매개변수를 사용해야 하나요?',
+    answer: '아니요, 절대 안 됩니다. 내부 링크의 UTM 태그는 Google 애널리틱스와 같은 도구에서 사용자 세션을 끊어 트래픽 데이터를 왜곡합니다.',
+  },
+  {
+    question: 'Google 애널리틱스는 UTM에서 대소문자를 구분하나요?',
+    answer: '네. "google", "Google", "GOOGLE"은 서로 다른 소스로 처리됩니다. 항상 일관성을 유지하고 가급적 소문자만 사용하는 것이 좋습니다.',
+  },
+];
+
+const howToData = [
+  { name: 'URL 입력', text: 'https://를 포함한 웹사이트의 전체 URL을 입력합니다.' },
+  { name: '소스 정의', text: '트래픽이 어디에서 오는지 지정합니다(google, facebook, newsletter 등).' },
+  { name: '매체 선택', text: '채널 유형을 선택합니다(cpc, email, social, organic 등).' },
+  { name: '캠페인 이름 지정', text: '마케팅 활동을 그룹화하기 위해 식별 가능한 이름을 할당합니다.' },
+  { name: '복사 및 사용', text: '생성된 URL을 복사하여 게시물, 광고 또는 이메일 서명에 사용합니다.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'ko',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: '웹사이트 URL (예: https://example.com) *',
+  labelSource: '캠페인 소스 (예: google, newsletter) *',
+  labelMedium: '캠페인 매체 (예: cpc, email)',
+  labelCampaign: '캠페인 이름 (예: summer_offer)',
+  labelTerm: '캠페인 키워드 (예: buy_shoes)',
+  labelContent: '캠페인 콘텐츠 (예: banner_top)',
+  labelGenerated: '생성된 URL:',
+  btnCopy: '링크 복사',
+  btnCopied: '복사됨!',
+  errorInvalid: '유효한 URL을 입력하세요',
+  errorInvalidUrl: '잘못된 URL',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: '자주 묻는 질문',
+  faq: faqData,
+  bibliographyTitle: '참고 자료',
+  bibliography: [
+    { name: '맞춤 URL을 사용하여 캠페인 데이터 수집 - Google 애널리틱스 고객센터 (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: '캠페인 URL 태깅을 위한 모범 사례 - VWO 블로그 (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'UTM 생성기: Google 애널리틱스용 추적 매개변수', level: 2 },
+    {
+      type: 'paragraph',
+      html: '<strong>UTM</strong> 매개변수(Urchin Tracking Module)는 웹 트래픽을 추적하기 위해 URL 끝에 추가되는 텍스트 라벨입니다. 당사의 생성기는 디지털 마케팅 캠페인을 위한 추적 가능한 링크 생성을 간소화합니다.',
+    },
+    { type: 'title', text: '추적 가능한 URL의 5가지 핵심 요소', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>캠페인 소스:</strong> 검색 엔진, 소셜 네트워크 또는 트래픽 소스를 식별합니다. 예: google, newsletter, facebook.',
+        '<strong>캠페인 매체:</strong> 마케팅 채널을 나타냅니다. 예: cpc, email, social, banner, organic.',
+        '<strong>캠페인 이름:</strong> 캠페인의 특정 이름입니다. 예: summer_offer_2025, app_launch_v2.',
+        '<strong>캠페인 키워드:</strong> 유료 검색의 경우 입찰한 키워드입니다. 예: buy_sports_shoes.',
+        '<strong>캠페인 콘텐츠:</strong> A/B 테스트용입니다. 캠페인 내에서 유사한 요소를 구별합니다. 예: header_v1, sidebar_v2.',
+      ],
+    },
+    { type: 'title', text: 'UTM 태깅 모범 사례', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>대소문자 일관성:</strong> 도구는 "Google", "GOOGLE" 및 "google"을 구분합니다. 중복을 피하기 위해 항상 소문자를 사용하세요.',
+        '<strong>공백 피하기:</strong> 공백은 %20이 됩니다. 대신 하이픈(-) 또는 언더바(_)를 사용하세요.',
+        '<strong>내부 링크에 사용 금지:</strong> UTM 추적은 외부 트래픽 전용입니다. 내부 링크에 사용하면 세션이 끊기고 주요 지표가 훼손됩니다.',
+        '<strong>태그 문서화:</strong> 불일치를 방지하기 위해 사용하는 모든 조합의 기록을 보관하세요.',
+      ],
+    },
+  ],
+};
+

package/src/tool/utmGenerator/i18n/nl.ts

@@ -0,0 +1,118 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UtmGeneratorUI } from '../ui';
+
+const slug = 'utm-generator-nl';
+const title = 'UTM Parameter Generator voor Google Analytics';
+const description = 'Maak nauwkeurige tracking-links voor uw digitale marketingcampagnes. Geoptimaliseerd voor Google Analytics en andere analysetools.';
+
+const faqData = [
+  {
+    question: 'Is het gebruik van UTM-parameters slecht voor SEO?',
+    answer: 'Nee, zolang u canonical tags gebruikt. Zoekmachines begrijpen dat UTM-parameters voor analytics zijn en creëren geen dubbele inhoud.',
+  },
+  {
+    question: 'Moet ik UTM-parameters gebruiken voor interne links?',
+    answer: 'Nee, nooit. UTM-tags op interne links verbreken de gebruikerssessie in tools zoals Google Analytics, waardoor uw verkeersgegevens worden vervormd.',
+  },
+  {
+    question: 'Maakt Google Analytics onderscheid tussen hoofdletters en kleine letters in UTM?',
+    answer: 'Ja. "google", "Google" en "GOOGLE" worden als verschillende bronnen behandeld. Zorg altijd voor consistentie, bij voorkeur door alleen kleine letters te gebruiken.',
+  },
+];
+
+const howToData = [
+  { name: 'Voer de URL in', text: 'Voer de volledige URL van uw website in, inclusief https://' },
+  { name: 'Definieer de bron', text: 'Geef aan waar het verkeer vandaan komt (google, facebook, nieuwsbrief, etc.)' },
+  { name: 'Selecteer het medium', text: 'Kies het type kanaal (cpc, e-mail, social, organisch, etc.)' },
+  { name: 'Geef uw campagne een naam', text: 'Wijs een herkenbare naam toe om uw marketinginspanningen te groeperen' },
+  { name: 'Kopieer en gebruik', text: 'Kopieer de gegenereerde URL en gebruik deze in uw berichten, advertenties of e-mailhandtekeningen' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'nl',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'Website URL (bijv. https://example.com) *',
+  labelSource: 'Campagnebron (bijv. google, nieuwsbrief) *',
+  labelMedium: 'Campagnemedium (bijv. cpc, e-mail)',
+  labelCampaign: 'Campagnenaam (bijv. zomer_aanbieding)',
+  labelTerm: 'Campagneterm (bijv. schoenen_kopen)',
+  labelContent: 'Campagne-inhoud (bijv. banner_bovenaan)',
+  labelGenerated: 'Gegenereerde URL:',
+  btnCopy: 'Link kopiëren',
+  btnCopied: 'Gekopieerd!',
+  errorInvalid: 'Voer een geldige URL in',
+  errorInvalidUrl: 'Ongeldige URL',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Veelgestelde Vragen',
+  faq: faqData,
+  bibliographyTitle: 'Referenties',
+  bibliography: [
+    { name: 'Campagnegegevens verzamelen met aangepaste URL\'s - Help over Google Analytics (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'Best Practices voor Campaign URL Tagging - VWO Blog (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'UTM Generator: Tracking Parameters voor Google Analytics', level: 2 },
+    {
+      type: 'paragraph',
+      html: '<strong>UTM-parameters</strong> (Urchin Tracking Module) zijn tekstlabels die aan het einde van een URL worden toegevoegd om webverkeer te volgen. Onze generator vereenvoudigt het maken van traceerbare links voor uw digitale marketingcampagnes.',
+    },
+    { type: 'title', text: 'De 5 pijlers van een traceerbare URL', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Campagnebron:</strong> Identificeert de zoekmachine, het sociale netwerk of de herkomst van het verkeer. Voorbeeld: google, nieuwsbrief, facebook.',
+        '<strong>Campagnemedium:</strong> Verwijst naar het marketingkanaal. Voorbeeld: cpc, e-mail, social, banner, organisch.',
+        '<strong>Campagnenaam:</strong> De specifieke naam van uw campagne. Voorbeeld: zomeraanbieding_2025, app_launch_v2.',
+        '<strong>Campagneterm:</strong> Voor betaalde zoekopdrachten, de zoekwoorden waarop u biedt. Voorbeeld: sportschoenen_kopen.',
+        '<strong>Campagne-inhoud:</strong> Voor A/B-tests. Maakt onderscheid tussen vergelijkbare elementen binnen een campagne. Voorbeeld: header_v1, sidebar_v2.',
+      ],
+    },
+    { type: 'title', text: 'Best Practices voor UTM Tagging', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Consistentie in hoofdlettergebruik:</strong> Tools maken onderscheid tussen "Google", "GOOGLE" en "google". Gebruik altijd kleine letters om duplicaten te voorkomen.',
+        '<strong>Vermijd spaties:</strong> Spaties worden %20. Gebruik in plaats daarvan streepjes (-) of underscores (_).',
+        '<strong>Niet gebruiken op interne links:</strong> UTM-tracking is uitsluitend voor extern verkeer. Op interne links verbreekt het de sessie en verpest het belangrijke statistieken.',
+        '<strong>Documenteer uw tags:</strong> Houd een overzicht bij van alle combinaties die u gebruikt om inconsistenties te voorkomen.',
+      ],
+    },
+  ],
+};
+

package/src/tool/utmGenerator/i18n/pl.ts

@@ -0,0 +1,117 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UtmGeneratorUI } from '../ui';
+
+const slug = 'generator-utm';
+const title = 'Generator parametrów UTM dla Google Analytics';
+const description = 'Twórz precyzyjne linki śledzące dla swoich cyfrowych kampanii marketingowych. Zoptymalizowany dla Google Analytics i innych narzędzi analitycznych.';
+
+const faqData = [
+  {
+    question: 'Czy używanie parametrów UTM jest złe dla SEO?',
+    answer: 'Nie, o ile używasz tagów kanonicznych. Wyszukiwarki rozumieją, że parametry UTM służą do analityki i nie tworzą duplikatu treści.',
+  },
+  {
+    question: 'Czy powinienem używać parametrów UTM w linkach wewnętrznych?',
+    answer: 'Nie, nigdy. Tagi UTM w linkach wewnętrznych przerywają sesję użytkownika w narzędziach takich jak Google Analytics, zniekształcając dane o ruchu.',
+  },
+  {
+    question: 'Czy Google Analytics rozróżnia wielkość liter w UTM?',
+    answer: 'Tak. „google”, „Google” i „GOOGLE” będą traktowane jako różne źródła. Zawsze zachowuj spójność, najlepiej używając tylko małych liter.',
+  },
+];
+
+const howToData = [
+  { name: 'Wpisz adres URL', text: 'Wprowadź pełny adres URL swojej witryny, w tym https://' },
+  { name: 'Zdefiniuj źródło', text: 'Określ, skąd pochodzi ruch (google, facebook, newsletter itp.)' },
+  { name: 'Wybierz medium', text: 'Wybierz typ kanału (cpc, e-mail, social, organic itp.)' },
+  { name: 'Nazwij swoją kampanię', text: 'Przypisz identyfikowalną nazwę, aby pogrupować swoje działania marketingowe' },
+  { name: 'Skopiuj i używaj', text: 'Skopiuj wygenerowany adres URL i używaj go w swoich postach, reklamach lub podpisach e-mail' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'pl',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'Adres URL witryny (np. https://example.com) *',
+  labelSource: 'Źródło kampanii (np. google, newsletter) *',
+  labelMedium: 'Medium kampanii (np. cpc, email)',
+  labelCampaign: 'Nazwa kampanii (np. oferta_letnia)',
+  labelTerm: 'Termin kampanii (np. kup_buty)',
+  labelContent: 'Treść kampanii (np. banner_top)',
+  labelGenerated: 'Wygenerowany adres URL:',
+  btnCopy: 'Kopiuj link',
+  btnCopied: 'Skopiowano!',
+  errorInvalid: 'Wpisz prawidłowy adres URL',
+  errorInvalidUrl: 'Nieprawidłowy adres URL',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Często zadawane pytania',
+  faq: faqData,
+  bibliographyTitle: 'Referencje',
+  bibliography: [
+    { name: 'Gromadzenie danych kampanii za pomocą niestandardowych adresów URL — Pomoc Google Analytics (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'Najlepsze praktyki tagowania adresów URL kampanii — Blog VWO (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Generator UTM: parametry śledzenia dla Google Analytics', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Parametry <strong>UTM</strong> (Urchin Tracking Module) to etykiety tekstowe dodawane na końcu adresu URL w celu śledzenia ruchu w sieci. Nasz generator upraszcza tworzenie śledzonych linków dla Twoich cyfrowych kampanii marketingowych.',
+    },
+    { type: 'title', text: '5 filarów śledzonego adresu URL', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Źródło kampanii:</strong> Identyfikuje wyszukiwarkę, sieć społecznościową lub pochodzenie ruchu. Przykład: google, newsletter, facebook.',
+        '<strong>Medium kampanii:</strong> Odnosi się do kanału marketingowego. Przykład: cpc, e-mail, social, banner, organic.',
+        '<strong>Nazwa kampanii:</strong> Konkretna nazwa Twojej kampanii. Przykład: oferta_letnia_2025, app_launch_v2.',
+        '<strong>Termin kampanii:</strong> W przypadku wyszukiwania płatnego — słowa kluczowe, na które licytujesz. Przykład: kup_buty_sportowe.',
+        '<strong>Treść kampanii:</strong> Do testów A/B. Rozróżnia podobne elementy w ramach kampanii. Przykład: header_v1, sidebar_v2.',
+      ],
+    },
+    { type: 'title', text: 'Najlepsze praktyki tagowania UTM', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Spójność wielkości liter:</strong> Narzędzia rozróżniają „Google”, „GOOGLE” i „google”. Zawsze używaj małych liter, aby uniknąć duplikatów.',
+        '<strong>Unikaj spacji:</strong> Spacje zmieniają się w %20. Zamiast nich używaj łączników (-) lub podkreśleń (_).',
+        '<strong>Nie używaj w linkach wewnętrznych:</strong> Śledzenie UTM służy wyłącznie do ruchu zewnętrznego. W linkach wewnętrznych przerywa sesję i psuje kluczowe wskaźniki.',
+        '<strong>Dokumentuj swoje tagi:</strong> Prowadź rejestr wszystkich używanych kombinacji, aby zapobiec niespójnościom.',
+      ],
+    },
+  ],
+};