@jjlmoya/utils-developer 1.3.0 → 1.5.0

package/src/tool/utmGenerator/i18n/pt.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-pt';
+const title = 'Gerador de Parâmetros UTM para o Google Analytics';
+const description = 'Crie links de rastreamento precisos para as suas campanhas de marketing digital. Otimizado para o Google Analytics e outras ferramentas de análise.';
+
+const faqData = [
+  {
+    question: 'O uso de parâmetros UTM é ruim para o SEO?',
+    answer: 'Não, desde que você use tags canônicas. Os mecanismos de busca entendem que os parâmetros UTM são para análise e não criam conteúdo duplicado.',
+  },
+  {
+    question: 'Devo usar parâmetros UTM para links internos?',
+    answer: 'Não, nunca. Tags UTM em links internos quebram a sessão do usuário em ferramentas como o Google Analytics, distorcendo os seus dados de tráfego.',
+  },
+  {
+    question: 'O Google Analytics distingue entre maiúsculas e minúsculas no UTM?',
+    answer: 'Sim. "google", "Google" e "GOOGLE" serão tratados como fontes diferentes. Mantenha sempre a consistência, de preferência usando apenas letras minúsculas.',
+  },
+];
+
+const howToData = [
+  { name: 'Insira a URL', text: 'Insira a URL completa do seu site, incluindo https://' },
+  { name: 'Defina a fonte', text: 'Especifique de onde vem o tráfego (google, facebook, newsletter, etc.)' },
+  { name: 'Selecione o meio', text: 'Escolha o tipo de canal (cpc, e-mail, social, orgânico, etc.)' },
+  { name: 'Dê um nome à sua campanha', text: 'Atribua um nome identificável para agrupar os seus esforços de marketing' },
+  { name: 'Copie e use', text: 'Copie a URL gerada e use-a nas suas postagens, anúncios ou assinaturas de 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: 'pt',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'URL do site (ex: https://example.com) *',
+  labelSource: 'Fonte da campanha (ex: google, newsletter) *',
+  labelMedium: 'Meio da campanha (ex: cpc, e-mail)',
+  labelCampaign: 'Nome da campanha (ex: oferta_verao)',
+  labelTerm: 'Termo da campanha (ex: comprar_sapatos)',
+  labelContent: 'Conteúdo da campanha (ex: banner_superior)',
+  labelGenerated: 'URL Gerada:',
+  btnCopy: 'Copiar Link',
+  btnCopied: 'Copiado!',
+  errorInvalid: 'Insira uma URL válida',
+  errorInvalidUrl: 'URL inválida',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Perguntas Frequentes',
+  faq: faqData,
+  bibliographyTitle: 'Referências',
+  bibliography: [
+    { name: 'Coletar dados de campanha com URLs personalizadas - Ajuda do Google Analytics (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'Melhores práticas para marcação de URL de campanha - Blog VWO (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Gerador UTM: Parâmetros de Rastreamento para o Google Analytics', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Os parâmetros <strong>UTM</strong> (Urchin Tracking Module) são etiquetas de texto adicionadas ao final de uma URL para rastrear o tráfego da web. Nosso gerador simplifica a criação de links rastreáveis para as suas campanhas de marketing digital.',
+    },
+    { type: 'title', text: 'Os 5 Pilares de uma URL Rastreável', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Fonte da Campanha:</strong> Identifica o mecanismo de busca, a rede social ou a origem do tráfego. Exemplo: google, newsletter, facebook.',
+        '<strong>Meio da Campanha:</strong> Refere-se ao canal de marketing. Exemplo: cpc, e-mail, social, banner, orgânico.',
+        '<strong>Nome da Campanha:</strong> O nome específico da sua campanha. Exemplo: oferta_verao_2025, lancamento_app_v2.',
+        '<strong>Termo da Campanha:</strong> Para buscas pagas, as palavras-chave pelas quais você deu um lance. Exemplo: comprar_sapatos_esportivos.',
+        '<strong>Conteúdo da Campanha:</strong> Para testes A/B. Diferencia elementos semelhantes dentro de uma campanha. Exemplo: cabecalho_v1, lateral_v2.',
+      ],
+    },
+    { type: 'title', text: 'Melhores Práticas para Marcação UTM', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Consistência de caixa:</strong> As ferramentas diferenciam entre "Google", "GOOGLE" e "google". Use sempre letras minúsculas para evitar duplicatas.',
+        '<strong>Evite espaços:</strong> Espaços tornam-se %20. Em vez disso, use hífens (-) ou sublinhados (_).',
+        '<strong>Não use em links internos:</strong> O rastreamento UTM é exclusivo para tráfego externo. Em links internos, ele quebra a sessão e prejudica as métricas principais.',
+        '<strong>Documente as suas tags:</strong> Mantenha um registro de todas as combinações que você usa para evitar inconsistências.',
+      ],
+    },
+  ],
+};
+

package/src/tool/utmGenerator/i18n/ru.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-ru';
+const title = 'Генератор параметров UTM для Google Analytics';
+const description = 'Создавайте точные ссылки для отслеживания ваших цифровых маркетинговых кампаний. Оптимизировано для Google Analytics и других инструментов аналитики.';
+
+const faqData = [
+  {
+    question: 'Вредно ли использование параметров UTM для SEO?',
+    answer: 'Нет, если вы используете канонические теги. Поисковые системы понимают, что параметры UTM предназначены для аналитики и не создают дублированного контента.',
+  },
+  {
+    question: 'Должен ли я использовать параметры UTM для внутренних ссылок?',
+    answer: 'Нет, никогда. Теги UTM на внутренних ссылках прерывают сеанс пользователя в таких инструментах, как Google Analytics, искажая данные о трафике.',
+  },
+  {
+    question: 'Различает ли Google Analytics регистр в UTM?',
+    answer: 'Да. «google», «Google» и «GOOGLE» будут рассматриваться как разные источники. Всегда соблюдайте единообразие, предпочтительно используя только строчные буквы.',
+  },
+];
+
+const howToData = [
+  { name: 'Введите URL', text: 'Введите полный URL вашего веб-сайта, включая https://' },
+  { 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: 'ru',
+};
+
+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 Analytics (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 Analytics', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Параметры <strong>UTM</strong> (Urchin Tracking Module) — это текстовые метки, добавляемые в конец URL-адреса для отслеживания веб-трафика. Наш генератор упрощает создание ссылок с отслеживанием для ваших цифровых маркетинговых кампаний.',
+    },
+    { type: 'title', text: '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/sv.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-sv';
+const title = 'UTM parametergenerator för Google Analytics';
+const description = 'Skapa exakta spårningslänkar för dina digitala marknadsföringskampanjer. Optimerad för Google Analytics och andra analysverktyg.';
+
+const faqData = [
+  {
+    question: 'Är det dåligt för SEO att använda UTM-parametrar?',
+    answer: 'Nej, så länge du använder kanoniska taggar (canonical tags). Sökmotorer förstår att UTM-parametrar är för analys och skapar inte duplicerat innehåll.',
+  },
+  {
+    question: 'Bör jag använda UTM-parametrar för interna länkar?',
+    answer: 'Nej, aldrig. UTM-taggar på interna länkar bryter användarsessionen i verktyg som Google Analytics, vilket förvränger dina trafikdata.',
+  },
+  {
+    question: 'Skiljer Google Analytics på stora och små bokstäver i UTM?',
+    answer: 'Ja. "google", "Google" och "GOOGLE" kommer att behandlas som olika källor. Var alltid konsekvent, använd helst endast små bokstäver.',
+  },
+];
+
+const howToData = [
+  { name: 'Ange URL', text: 'Ange den kompletta webbadressen till din webbplats, inklusive https://' },
+  { name: 'Definiera källan', text: 'Ange var trafiken kommer ifrån (google, facebook, nyhetsbrev, etc.)' },
+  { name: 'Välj medium', text: 'Välj typ av kanal (cpc, e-post, socialt, organiskt, etc.)' },
+  { name: 'Namnge din kampanj', text: 'Tilldela ett identifierbart namn för att gruppera dina marknadsföringsinsatser' },
+  { name: 'Kopiera och använd', text: 'Kopiera den genererade webbadressen och använd den i dina inlägg, annonser eller e-postsignaturer' },
+];
+
+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: 'sv',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'Webbplats-URL (t.ex. https://example.com) *',
+  labelSource: 'Kampanjkälla (t.ex. google, newsletter) *',
+  labelMedium: 'Kampanjmedium (t.ex. cpc, email)',
+  labelCampaign: 'Kampanjnamn (t.ex. sommar_erbjudande)',
+  labelTerm: 'Kampanjterm (t.ex. köpa_skor)',
+  labelContent: 'Kampanjinnehåll (t.ex. banner_top)',
+  labelGenerated: 'Genererad URL:',
+  btnCopy: 'Kopiera länk',
+  btnCopied: 'Kopierad!',
+  errorInvalid: 'Ange en giltig URL',
+  errorInvalidUrl: 'Ogiltig URL',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Vanliga frågor',
+  faq: faqData,
+  bibliographyTitle: 'Referenser',
+  bibliography: [
+    { name: 'Samla in kampanjdata med anpassade webbadresser - Hjälp för Google Analytics (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'Bästa praxis för taggning av kampanj-URL - VWO Blog (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'UTM-generator: Spårningsparametrar för Google Analytics', level: 2 },
+    {
+      type: 'paragraph',
+      html: '<strong>UTM</strong>-parametrar (Urchin Tracking Module) är textetiketter som läggs till i slutet av en URL för att spåra webbtrafik. Vår generator förenklar skapandet av spårbara länkar för dina digitala marknadsföringskampanjer.',
+    },
+    { type: 'title', text: 'De 5 pelarna i en spårbar URL', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Kampanjkälla:</strong> Identifierar sökmotorn, det sociala nätverket eller trafikkällan. Exempel: google, newsletter, facebook.',
+        '<strong>Kampanjmedium:</strong> Avser marknadsföringskanalen. Exempel: cpc, email, social, banner, organic.',
+        '<strong>Kampanjnamn:</strong> Det specifika namnet på din kampanj. Exempel: sommarerbjudande_2025, app_launch_v2.',
+        '<strong>Kampanjterm:</strong> För betalda sökningar, de sökord du bjuder på. Exempel: köpa_sportskor.',
+        '<strong>Kampanjinnehåll:</strong> För A/B-tester. Särskiljer liknande element inom en kampanj. Exempel: header_v1, sidebar_v2.',
+      ],
+    },
+    { type: 'title', text: 'Bästa praxis för UTM-taggning', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Konsekvent skiftläge:</strong> Verktygen skiljer på "Google", "GOOGLE" och "google". Använd alltid små bokstäver för att undvika dubbletter.',
+        '<strong>Undvik mellanslag:</strong> Mellanslag blir %20. Använd bindestreck (-) eller understreck (_) istället.',
+        '<strong>Använd inte på interna länkar:</strong> UTM-spårning är uteslutande för extern trafik. På interna länkar bryter det sessionen och förstör viktiga mätvärden.',
+        '<strong>Dokumentera dina taggar:</strong> För logg över alla kombinationer du använder för att förhindra inkonsekvenser.',
+      ],
+    },
+  ],
+};
+

package/src/tool/utmGenerator/i18n/tr.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 = 'utm-olusturucu';
+const title = 'Google Analytics için UTM Parametre Oluşturucu';
+const description = 'Dijital pazarlama kampanyalarınız için hassas izleme bağlantıları oluşturun. Google Analytics ve diğer analiz araçları için optimize edilmiştir.';
+
+const faqData = [
+  {
+    question: 'UTM parametrelerini kullanmak SEO için kötü müdür?',
+    answer: 'Hayır, kanonik (canonical) etiketler kullandığınız sürece sorun olmaz. Arama motorları UTM parametrelerinin analiz amaçlı olduğunu anlar ve yinelenen içerik oluşturmaz.',
+  },
+  {
+    question: 'Dahili bağlantılar için UTM parametreleri kullanmalı mıyım?',
+    answer: 'Hayır, asla. Dahili bağlantılardaki UTM etiketleri, Google Analytics gibi araçlarda kullanıcı oturumunu sonlandırarak trafik verilerinizi bozar.',
+  },
+  {
+    question: 'Google Analytics, UTM\'deki büyük ve küçük harfleri ayırt eder mi?',
+    answer: 'Evet. "google", "Google" ve "GOOGLE" farklı kaynaklar olarak değerlendirilecektir. Her zaman tutarlılığı koruyun, tercihen sadece küçük harf kullanın.',
+  },
+];
+
+const howToData = [
+  { name: 'URL\'yi girin', text: 'https:// dahil olmak üzere web sitenizin tam URL\'sini girin' },
+  { name: 'Kaynağı tanımlayın', text: 'Trafiğin nereden geldiğini belirtin (google, facebook, newsletter vb.)' },
+  { name: 'Mecrayı seçin', text: 'Kanal türünü seçin (cpc, e-posta, sosyal, organik vb.)' },
+  { name: 'Kampanyanızı adlandırın', text: 'Pazarlama çabalarınızı gruplandırmak için tanımlanabilir bir ad atayın' },
+  { name: 'Kopyalayın ve kullanın', text: 'Oluşturulan URL\'yi kopyalayın ve gönderilerinizde, reklamlarınızda veya e-posta imzalarınızda kullanın' },
+];
+
+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: 'tr',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'Web sitesi URL\'si (ör. https://example.com) *',
+  labelSource: 'Kampanya kaynağı (ör. google, newsletter) *',
+  labelMedium: 'Kampanya mecrası (ör. cpc, e-posta)',
+  labelCampaign: 'Kampanya adı (ör. yaz_teklifi)',
+  labelTerm: 'Kampanya terimi (ör. ayakkabi_satin_al)',
+  labelContent: 'Kampanya içeriği (ör. banner_ust)',
+  labelGenerated: 'Oluşturulan URL:',
+  btnCopy: 'Bağlantıyı Kopyala',
+  btnCopied: 'Kopyalandı!',
+  errorInvalid: 'Geçerli bir URL girin',
+  errorInvalidUrl: 'Geçersiz URL',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Sıkça Sorulan Sorular',
+  faq: faqData,
+  bibliographyTitle: 'Referanslar',
+  bibliography: [
+    { name: 'Özel URL\'lerle kampanya verilerini toplama - Google Analytics Yardımı (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'Kampanya URL Etiketleme için En İyi Uygulamalar - VWO Blog (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'UTM Oluşturucu: Google Analytics için İzleme Parametreleri', level: 2 },
+    {
+      type: 'paragraph',
+      html: '<strong>UTM</strong> parametreleri (Urchin Tracking Module), web trafiğini izlemek için bir URL\'nin sonuna eklenen metin etiketleridir. Oluşturucumuz, dijital pazarlama kampanyalarınız için izlenebilir bağlantılar oluşturmayı basitleştirir.',
+    },
+    { type: 'title', text: 'İzlenebilir Bir URL\'nin 5 Temel Taşı', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Kampanya Kaynağı:</strong> Arama motorunu, sosyal ağı veya trafik kaynağını tanımlar. Örnek: google, newsletter, facebook.',
+        '<strong>Kampanya Mecrası:</strong> Pazarlama kanalını ifade eder. Örnek: cpc, e-posta, sosyal, banner, organik.',
+        '<strong>Kampanya Adı:</strong> Kampanyanızın özel adı. Örnek: yaz_teklifi_2025, uygulama_lansmani_v2.',
+        '<strong>Kampanya Terimi:</strong> Ücretli aramalar için, teklif verdiğiniz anahtar kelimeler. Örnek: spor_ayakkabi_satin_al.',
+        '<strong>Kampanya İçeriği:</strong> A/B testleri için. Bir kampanya içindeki benzer öğeleri birbirinden ayırır. Örnek: header_v1, sidebar_v2.',
+      ],
+    },
+    { type: 'title', text: 'UTM Etiketleme için En İyi Uygulamalar', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Harf duyarlılığı tutarlılığı:</strong> Araçlar "Google", "GOOGLE" ve "google"ı farklılaştırır. Yinelenen verileri önlemek için her zaman küçük harf kullanın.',
+        '<strong>Boşluklardan kaçının:</strong> Boşluklar %20 olur. Bunun yerine tire (-) veya alt çizgi (_) kullanın.',
+        '<strong>Dahili bağlantılarda kullanmayın:</strong> UTM izleme yalnızca harici trafik içindir. Dahili bağlantılarda kullanımı oturumu sonlandırır ve temel metrikleri bozar.',
+        '<strong>Etiketlerinizi belgeleyin:</strong> Tutarsızlıkları önlemek için kullandığınız tüm kombinasyonların kaydını tutun.',
+      ],
+    },
+  ],
+};

package/src/tool/utmGenerator/i18n/zh.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 Analytics UTM 参数生成器平衡';
+const description = '为您的数字营销活动创建精确的追踪链接。针对 Google Analytics 和其他分析工具进行了优化。';
+
+const faqData = [
+  {
+    question: '使用 UTM 参数对 SEO 有影响吗？',
+    answer: '没有，只要您使用规范标签（canonical tags）即可。搜索引擎了解 UTM 参数用于分析，不会将其视为重复内容。',
+  },
+  {
+    question: '我应该在内部链接中使用 UTM 参数吗？',
+    answer: '不，绝对不要。在内部链接上使用 UTM 标签会破坏 Google Analytics 等工具中的用户会话，从而导致您的流量数据失真。',
+  },
+  {
+    question: 'Google Analytics 在 UTM 中区分大小写吗？',
+    answer: '是的。"google"、"Google" 和 "GOOGLE" 会被视为不同的来源。请始终保持一致，建议仅使用小写字母。',
+  },
+];
+
+const howToData = [
+  { name: '输入 URL', text: '输入您网站的完整 URL，包括 https://' },
+  { 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: 'zh',
+};
+
+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 Analytics 帮助 (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 Analytics 的追踪参数', 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/index.ts

@@ -6,10 +6,6 @@ import type { UtmGeneratorUI } from './ui';
 
 export type UtmGeneratorLocaleContent = ToolLocaleContent<UtmGeneratorUI>;
 
-import { content as es } from './i18n/es';
-import { content as en } from './i18n/en';
-import { content as fr } from './i18n/fr';
-
 export const utmGenerator: DeveloperToolEntry<UtmGeneratorUI> = {
   id: 'utm-generator',
   icons: {
@@ -17,9 +13,21 @@ export const utmGenerator: DeveloperToolEntry<UtmGeneratorUI> = {
     fg: 'mdi:tag-multiple',
   },
   i18n: {
-    es: async () => es,
-    en: async () => en,
-    fr: async () => fr,
+    de: async () => (await import('./i18n/de')).content,
+    en: async () => (await import('./i18n/en')).content,
+    es: async () => (await import('./i18n/es')).content,
+    fr: async () => (await import('./i18n/fr')).content,
+    id: async () => (await import('./i18n/id')).content,
+    it: async () => (await import('./i18n/it')).content,
+    ja: async () => (await import('./i18n/ja')).content,
+    ko: async () => (await import('./i18n/ko')).content,
+    nl: async () => (await import('./i18n/nl')).content,
+    pl: async () => (await import('./i18n/pl')).content,
+    pt: async () => (await import('./i18n/pt')).content,
+    ru: async () => (await import('./i18n/ru')).content,
+    sv: async () => (await import('./i18n/sv')).content,
+    tr: async () => (await import('./i18n/tr')).content,
+    zh: async () => (await import('./i18n/zh')).content,
   },
 };
 

package/src/types.ts

@@ -4,8 +4,7 @@ import type { WithContext, Thing } from 'schema-dts';
 export type { SEOSection };
 
 export type KnownLocale =
-  | 'ar' | 'da' | 'de' | 'en' | 'es' | 'fi'
-  | 'fr' | 'it' | 'ja' | 'ko' | 'nb' | 'nl'
+  | 'de' | 'en' | 'es' | 'fr' | 'id' | 'it' | 'ja' | 'ko' | 'nl'
   | 'pl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh';
 
 export interface FAQItem {