@jjlmoya/utils-developer 1.4.0 → 1.6.0

package/src/tool/urlEncoderDecoder/i18n/tr.ts

@@ -0,0 +1,162 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UrlEncoderDecoderUI } from '../ui';
+
+const slug = 'url-kodlayici-ve-cozucu';
+const title = 'Çevrimiçi URL Kodlayıcı ve Çözücü';
+const description =
+  'Herhangi bir bağlantıdaki özel karakterleri güvenli formata (Percent-Encoding) dönüştürün veya anında ve yerel olarak orijinal okunabilir durumuna geri döndürün.';
+
+const faqData = [
+  {
+    question: 'Bir URL\'de hangi karakterler kodlanır?',
+    answer:
+      'URL\'ler için ASCII standardında izin verilmeyen tüm karakterler kodlanır: boşluklar, aksanlı harfler, &, =, +, #, ?, / gibi semboller ve diğerleri. Örneğin, bir boşluk %20 olur ve ñ %C3%B1 olur.',
+  },
+  {
+    question: 'encodeURI ve encodeURIComponent arasındaki fark nedir?',
+    answer:
+      'encodeURI tam bir URL\'yi kodlar ve / ve ? gibi ayrılmış karakterleri olduğu gibi bırakır. encodeURIComponent, ayrılmış karakterler dahil tüm özel karakterleri kodlar; bu da onu bireysel sorgu parametresi değerlerini kodlamak için ideal kılar.',
+  },
+  {
+    question: 'URL\'mde neden boşluk yerine %20 var?',
+    answer:
+      'HTTP protokolü URL\'lerde boşluklara izin vermez. %20, ASCII standardına göre bir boşluğun Yüzde-Kodlama (Percent-Encoding) temsilidir. Bazı sistemler alternatif olarak + işaretini kullanır, ancak %20 en evrensel ve güvenli olanıdır.',
+  },
+  {
+    question: 'Bu aracı özel URL\'lerle kullanmak güvenli mi?',
+    answer:
+      'Evet, tamamen güvenli. Tüm işlemler yerel JavaScript (encodeURIComponent/decodeURIComponent) kullanılarak tarayıcınızda gerçekleşir. URL\'lerinizin veya parametrelerinizin hiçbiri herhangi bir harici sunucuya gönderilmez.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Ham metni yapıştırın',
+    text: 'URL veya metin dizinizi üstteki "Ham Metin (Okunabilir)" alanına yazın veya yapıştırın.',
+  },
+  {
+    name: 'Kodlayın veya çözün',
+    text: 'Metni güvenli Yüzde-Kodlama formatına dönüştürmek için "URL\'yi Kodla"ya tıklayın veya kodlanmış bir URL\'yi okunabilir formuna geri döndürmek için "Çöz"e tıklayın.',
+  },
+  {
+    name: 'Sonucu kopyalayın',
+    text: 'Sonucu panonuza almak için ilgili alanın "Kopyala" düğmesini 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((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.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: UrlEncoderDecoderUI = {
+  labelRaw: 'Ham Metin (Okunabilir)',
+  labelEncoded: 'Formatlanmış URL (Kodlanmış)',
+  btnClear: 'Temizle',
+  btnCopy: 'Kopyala',
+  btnCopied: 'Kopyalandı!',
+  btnEncode: 'URL\'yi Kodla',
+  btnDecode: 'Çöz',
+  placeholderRaw: 'https://example.com/search?q=kırmızı ayakkabı&size=38',
+  placeholderEncoded: 'https%3A%2F%2Fexample.com%2Fsearch%3Fq%3Dk%C4%B1rm%C4%B1z%C4%B1%20ayakkab%C4%B1%26size%3D38',
+};
+
+export const content: ToolLocaleContent<UrlEncoderDecoderUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Sıkça Sorulan Sorular',
+  faq: faqData,
+  bibliographyTitle: 'Referanslar ve Dokümantasyon',
+  bibliography: [
+    {
+      name: 'MDN Web Docs: encodeURIComponent()',
+      url: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent',
+    },
+    {
+      name: 'IETF RFC 3986: URI Generic Syntax',
+      url: 'https://datatracker.ietf.org/doc/html/rfc3986',
+    },
+    {
+      name: 'W3C: URL Living Standard',
+      url: 'https://url.spec.whatwg.org/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'URL Kodlama Nedir?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'İnternette gezinirken veya sunuculara istek gönderirken, bir URL\'yi (Uniform Resource Locator) basitçe bir "web adresi" olarak düşünmek yaygındır. Ancak internet protokolü, URL\'lerin yalnızca çok kısıtlı bir <strong>standart ASCII</strong> karakter seti kullanılarak iletilebileceğini belirtir.',
+    },
+    {
+      type: 'paragraph',
+      html: 'URL; boşluk, aksanlı harfler veya artı (<code>+</code>) veya eşittir (<code>=</code>) işaretleri gibi özel parametreler içeriyorsa ne olur? Sistemlerin geçersiz karakterleri okumaya çalışırken çökmesini önlemek için, bunların <strong>Yüzde-Kodlama</strong> (Percent-Encoding) kullanılarak güvenli uyumlu formlarına çevrilmesi gerekir.',
+    },
+    {
+      type: 'title',
+      text: 'Yüzde-Kodlama Nasıl Çalışır?',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Bu aracı kullandığınızda, algoritma herhangi bir "güvensiz" karakteri (boşluk veya ñ gibi aksanlı bir harf gibi) alır ve onu bir yüzde işareti <code>%</code> ile ardından UTF-8 standardındaki değerine karşılık gelen iki onaltılık basamakla değiştirir.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Temel Örnek:</strong> Basit bir boşluk, güvenli eşdeğeriyle değiştirilecektir: <code>%20</code>.',
+        '<strong>Genişletilmiş Destek:</strong> <code>ğ</code> harfi <code>%C4%9F</code> olur ve <code>ş</code>, <code>%C5%9F</code> olur.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'API\'lerde ve GET İsteklerinde Önemi',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Entegrasyonlar geliştirirken tipik bir hata, URL parametrelerine ham bir dize geçirmektir. Arka ucunuza <code>tişört&mavi</code> ham dizesini eklerseniz (<code>/search?q=tişört&mavi</code>), sunucu <code>mavi</code>\'yi yeni bir parametre olarak yorumlayacak ve tüm mantığı bozacaktır.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Bu araç, yerel tarayıcınızda %100 yürütme ile temiz, otomatik hesaplamaları garanti eder. URL dizelerinizin hiçbiri üçüncü taraf sunuculara iletilmez, böylece belirteçlerinizin (token) ve analitik parametrelerinizin gizliliği sağlanır.',
+    },
+  ],
+};

package/src/tool/urlEncoderDecoder/i18n/zh.ts

@@ -0,0 +1,163 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UrlEncoderDecoderUI } from '../ui';
+
+const slug = 'url-encoder-decoder';
+const title = '在线 URL 编码器和解码器';
+const description =
+  '将任何链接中的特殊字符转换为安全格式（百分比编码），或立即在本地将其恢复为原始的可读状态。';
+
+const faqData = [
+  {
+    question: 'URL 中哪些字符会被编码？',
+    answer:
+      '所有 URL 的 ASCII 标准中不允许的字符都会被编码：空格、带重音符号的字母、符号（如 &、=、+、#、?、/ 等）等。例如，空格变为 %20，ñ 变为 %C3%B1。',
+  },
+  {
+    question: 'encodeURI 和 encodeURIComponent 之间有什么区别？',
+    answer:
+      'encodeURI 对整个 URL 进行编码，并保留保留字符（如 / 和 ?）不变。encodeURIComponent 编码包括保留字符在内的所有特殊字符，因此非常适合编码单个查询参数值。',
+  },
+  {
+    question: '为什么我的 URL 中有 %20 而不是空格？',
+    answer:
+      'HTTP 协议不允许 URL 中出现空格。根据 ASCII 标准，%20 是空格的百分比编码表示形式。有些系统使用 + 号作为替代方案，但 %20 是最通用且安全的。',
+  },
+  {
+    question: '在私有 URL 上使用此工具安全吗？',
+    answer:
+      '是的，非常安全。所有处理都在您的浏览器中使用原生 JavaScript（encodeURIComponent/decodeURIComponent）完成。您的任何 URL 或参数都不会发送到任何外部服务器。',
+  },
+];
+
+const howToData = [
+  {
+    name: '粘贴原始文本',
+    text: '在上方“原始文本（可读）”字段中输入或粘贴您的 URL 或文本字符串。',
+  },
+  {
+    name: '编码或解码',
+    text: '点击“URL 编码”将文本转换为安全的百分比编码格式，或点击“解码”将已编码的 URL 恢复为可读形式。',
+  },
+  {
+    name: '复制结果',
+    text: '使用对应字段的“复制”按钮将结果保存到剪贴板。',
+  },
+];
+
+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((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.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: UrlEncoderDecoderUI = {
+  labelRaw: '原始文本 (可读)',
+  labelEncoded: '格式化 URL (已编码)',
+  btnClear: '清除',
+  btnCopy: '复制',
+  btnCopied: '已复制！',
+  btnEncode: 'URL 编码',
+  btnDecode: '解码',
+  placeholderRaw: 'https://example.com/search?q=红色高跟鞋&size=38',
+  placeholderEncoded: 'https%3A%2F%2Fexample.com%2Fsearch%3Fq%3D%E7%BA%A2%E8%89%B2%E9%AB%98%E8%B7%9F%E9%9E%8B%26size%3D38',
+};
+
+export const content: ToolLocaleContent<UrlEncoderDecoderUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: '常见问题',
+  faq: faqData,
+  bibliographyTitle: '参考资料与文档',
+  bibliography: [
+    {
+      name: 'MDN Web Docs: encodeURIComponent()',
+      url: 'https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent',
+    },
+    {
+      name: 'IETF RFC 3986: URI Generic Syntax',
+      url: 'https://datatracker.ietf.org/doc/html/rfc3986',
+    },
+    {
+      name: 'W3C: URL Living Standard',
+      url: 'https://url.spec.whatwg.org/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: '什么是 URL 编码？',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '在浏览互联网或向服务器发送请求时，人们通常将 URL（统一资源定位符）简单地视为“网址”。然而，互联网协议规定 URL 只能使用非常有限的 <strong>标准 ASCII</strong> 字符集进行传输。',
+    },
+    {
+      type: 'paragraph',
+      html: '如果 URL 包含空格、带重音符号的字母或特殊参数（如加号 <code>+</code> 或等号 <code>=</code>）会发生什么？为了防止系统在尝试读取非法字符时崩溃，必须使用<strong>百分比编码</strong>将其转换为安全的兼容形式。',
+    },
+    {
+      type: 'title',
+      text: '百分比编码的工作原理',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '当您使用此工具时，算法会将任何“不安全”的字符（如空格或 ñ 等带重音符号的字母）替换为百分号 <code>%</code>，后跟与其在 UTF-8 标准中的值相对应的两个十六进制数字。',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>基本示例：</strong> 一个简单的空格将被其安全对应项 <code>%20</code> 替换。',
+        '<strong>扩展支持：</strong> 字母 <code>啊</code> 变为 <code>%E5%95%8A</code>。',
+      ],
+    },
+    {
+      type: 'title',
+      text: '在 API 和 GET 请求中的重要性',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '在开发集成时，一个典型的错误是将原始字符串传递给 URL 参数。如果您将 <code>shirt&blue</code> 直接插入到后端（<code>/search?q=shirt&blue</code>），服务器会将 <code>blue</code> 解释为一个新参数，从而破坏所有逻辑。',
+    },
+    {
+      type: 'paragraph',
+      html: '此工具通过在本地浏览器中 100% 执行，保证了计算的纯净和自动。您的任何 URL 字符串都不会传输到第三方服务器，从而确保了令牌和分析参数的隐私。',
+    },
+  ],
+};
+

package/src/tool/urlEncoderDecoder/index.ts

@@ -7,10 +7,6 @@ import type { UrlEncoderDecoderUI } from './ui';
 
 export type UrlEncoderDecoderLocaleContent = ToolLocaleContent<UrlEncoderDecoderUI>;
 
-import { content as es } from './i18n/es';
-import { content as en } from './i18n/en';
-import { content as fr } from './i18n/fr';
-
 export const urlEncoderDecoder: DeveloperToolEntry<UrlEncoderDecoderUI> = {
   id: 'url-encoder-decoder',
   icons: {
@@ -18,9 +14,21 @@ export const urlEncoderDecoder: DeveloperToolEntry<UrlEncoderDecoderUI> = {
     fg: 'mdi:code-brackets',
   },
   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/tool/utmGenerator/i18n/de.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-parameter-erzeuger';
+const title = 'UTM Parameter Generator für Google Analytics';
+const description = 'Erstellen Sie präzise Tracking-Links für Ihre digitalen Marketingkampagnen. Optimiert für Google Analytics und andere Analysetools.';
+
+const faqData = [
+  {
+    question: 'Ist die Verwendung von UTM-Parametern schlecht für SEO?',
+    answer: 'Nein, solange Sie Canonical-Tags verwenden. Suchmaschinen verstehen, dass UTM-Parameter für Analysen gedacht sind und keine doppelten Inhalte erzeugen.',
+  },
+  {
+    question: 'Sollte ich UTM-Parameter für interne Links verwenden?',
+    answer: 'Nein, niemals. UTM-Tags bei internen Links unterbrechen die Nutzersitzung in Tools wie Google Analytics und verfälschen Ihre Traffic-Daten.',
+  },
+  {
+    question: 'Unterscheidet Google Analytics bei UTM zwischen Groß- und Kleinschreibung?',
+    answer: 'Ja. „google“, „Google“ und „GOOGLE“ werden als unterschiedliche Quellen behandelt. Achten Sie immer auf Konsistenz, am besten verwenden Sie nur Kleinschreibung.',
+  },
+];
+
+const howToData = [
+  { name: 'URL eingeben', text: 'Geben Sie die vollständige URL Ihrer Website ein, einschließlich https://' },
+  { name: 'Quelle definieren', text: 'Geben Sie an, woher der Traffic kommt (google, facebook, newsletter usw.)' },
+  { name: 'Medium auswählen', text: 'Wählen Sie die Art des Kanals (cpc, email, social, organic usw.)' },
+  { name: 'Kampagne benennen', text: 'Geben Sie einen identifizierbaren Namen an, um Ihre Marketingaktivitäten zu gruppieren' },
+  { name: 'Kopieren und verwenden', text: 'Kopieren Sie die generierte URL und verwenden Sie sie in Ihren Beiträgen, Anzeigen oder E-Mail-Signaturen' },
+];
+
+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: 'de',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'Website-URL (z. B. https://example.com) *',
+  labelSource: 'Kampagnenquelle (z. B. google, newsletter) *',
+  labelMedium: 'Kampagnenmedium (z. B. cpc, email)',
+  labelCampaign: 'Kampagnenname (z. B. sommer_angebot)',
+  labelTerm: 'Kampagnenbegriff (z. B. schuhe_kaufen)',
+  labelContent: 'Kampagneninhalt (z. B. banner_oben)',
+  labelGenerated: 'Generierte URL:',
+  btnCopy: 'Link kopieren',
+  btnCopied: 'Kopiert!',
+  errorInvalid: 'Geben Sie eine gültige URL ein',
+  errorInvalidUrl: 'Ungültige URL',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Häufig gestellte Fragen',
+  faq: faqData,
+  bibliographyTitle: 'Referenzen',
+  bibliography: [
+    { name: 'Kampagnendaten mit benutzerdefinierten URLs erfassen - Google Analytics-Hilfe (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'Best Practices für die Kennzeichnung von Kampagnen-URLs - 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-Parameter für Google Analytics', level: 2 },
+    {
+      type: 'paragraph',
+      html: '<strong>UTM-Parameter</strong> (Urchin Tracking Module) sind Textlabels, die am Ende einer URL hinzugefügt werden, um den Web-Traffic zu verfolgen. Unser Generator vereinfacht das Erstellen von trackingfähigen Links für Ihre digitalen Marketingkampagnen.',
+    },
+    { type: 'title', text: 'Die 5 Säulen einer verfolgbaren URL', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Kampagnenquelle:</strong> Identifiziert die Suchmaschine, das soziale Netzwerk oder den Traffic-Ursprung. Beispiel: google, newsletter, facebook.',
+        '<strong>Kampagnenmedium:</strong> Bezieht sich auf den Marketingkanal. Beispiel: cpc, email, social, banner, organic.',
+        '<strong>Kampagnenname:</strong> Der spezifische Name Ihrer Kampagne. Beispiel: sommer_angebot_2025, app_launch_v2.',
+        '<strong>Kampagnenbegriff:</strong> Bei bezahlter Suche die Keywords, auf die Sie bieten. Beispiel: sportschuhe_kaufen.',
+        '<strong>Kampagneninhalt:</strong> Für A/B-Tests. Unterscheidet ähnliche Elemente innerhalb einer Kampagne. Beispiel: header_v1, sidebar_v2.',
+      ],
+    },
+    { type: 'title', text: 'Best Practices für UTM-Tagging', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Einheitliche Schreibweise:</strong> Tools unterscheiden zwischen „Google“, „GOOGLE“ und „google“. Verwenden Sie immer Kleinschreibung, um Duplikate zu vermeiden.',
+        '<strong>Leerzeichen vermeiden:</strong> Leerzeichen werden zu %20. Verwenden Sie stattdessen Bindestriche (-) oder Unterstriche (_).',
+        '<strong>Nicht bei internen Links verwenden:</strong> UTM-Tracking ist ausschließlich für externen Traffic gedacht. Bei internen Links unterbricht es die Sitzung und verfälscht wichtige Kennzahlen.',
+        '<strong>Dokumentieren Sie Ihre Tags:</strong> Führen Sie Protokoll über alle verwendeten Kombinationen, um Inkonsistenzen zu vermeiden.',
+      ],
+    },
+  ],
+};
+

package/src/tool/utmGenerator/i18n/id.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 = 'pembuat-parameter-utm';
+const title = 'Generator Parameter UTM untuk Google Analytics';
+const description = 'Buat tautan pelacakan yang presisi untuk kampanye pemasaran digital Anda. Dioptimalkan untuk Google Analytics dan alat analisis lainnya.';
+
+const faqData = [
+  {
+    question: 'Apakah menggunakan parameter UTM buruk untuk SEO?',
+    answer: 'Tidak, asalkan Anda menggunakan tag kanonikal. Mesin pencari memahami bahwa parameter UTM adalah untuk analitik dan tidak membuat konten duplikat.',
+  },
+  {
+    question: 'Haruskah saya menggunakan parameter UTM untuk tautan internal?',
+    answer: 'Tidak, jangan pernah. Tag UTM pada tautan internal memutus sesi pengguna dalam alat seperti Google Analytics, sehingga mendistorsi data lalu lintas Anda.',
+  },
+  {
+    question: 'Apakah Google Analytics membedakan antara huruf besar dan huruf kecil dalam UTM?',
+    answer: 'Ya. "google", "Google" dan "GOOGLE" akan diperlakukan sebagai sumber yang berbeda. Selalu jaga konsistensi, sebaiknya gunakan huruf kecil saja.',
+  },
+];
+
+const howToData = [
+  { name: 'Masukkan URL', text: 'Masukkan URL lengkap situs web Anda, termasuk https://' },
+  { name: 'Tentukan sumber', text: 'Tentukan dari mana lalu lintas berasal (google, facebook, newsletter, dll.)' },
+  { name: 'Pilih media', text: 'Pilih jenis saluran (cpc, email, sosial, organik, dll.)' },
+  { name: 'Beri nama kampanye Anda', text: 'Tetapkan nama yang dapat diidentifikasi untuk mengelompokkan upaya pemasaran Anda' },
+  { name: 'Salin dan gunakan', text: 'Salin URL yang dihasilkan dan gunakan dalam postingan, iklan, atau tanda tangan email Anda' },
+];
+
+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: 'id',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'URL Situs Web (misal: https://example.com) *',
+  labelSource: 'Sumber kampanye (misal: google, newsletter) *',
+  labelMedium: 'Media kampanye (misal: cpc, email)',
+  labelCampaign: 'Nama kampanye (misal: penawaran_musim_panas)',
+  labelTerm: 'Istilah kampanye (misal: beli_sepatu)',
+  labelContent: 'Konten kampanye (misal: banner_atas)',
+  labelGenerated: 'URL yang Dihasilkan:',
+  btnCopy: 'Salin Tautan',
+  btnCopied: 'Tersalin!',
+  errorInvalid: 'Masukkan URL yang valid',
+  errorInvalidUrl: 'URL tidak valid',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Pertanyaan yang Sering Diajukan',
+  faq: faqData,
+  bibliographyTitle: 'Referensi',
+  bibliography: [
+    { name: 'Mengumpulkan data kampanye dengan URL kustom - Bantuan Google Analytics (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'Praktik Terbaik untuk Penandaan URL Kampanye - Blog VWO (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Generator UTM: Parameter Pelacakan untuk Google Analytics', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Parameter <strong>UTM</strong> (Urchin Tracking Module) adalah label teks yang ditambahkan ke akhir URL untuk melacak lalu lintas web. Generator kami menyederhanakan pembuatan tautan yang dapat dilacak untuk kampanye pemasaran digital Anda.',
+    },
+    { type: 'title', text: '5 Pilar Tautan yang Dapat Dilacak', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Sumber Kampanye:</strong> Mengidentifikasi mesin pencari, jejaring sosial, atau asal lalu lintas. Contoh: google, newsletter, facebook.',
+        '<strong>Media Kampanye:</strong> Mengacu pada saluran pemasaran. Contoh: cpc, email, sosial, banner, organik.',
+        '<strong>Nama Kampanye:</strong> Nama spesifik kampanye Anda. Contoh: penawaran_musim_panas_2025, peluncuran_aplikasi_v2.',
+        '<strong>Istilah Kampanye:</strong> Untuk pencarian berbayar, kata kunci yang Anda bidik. Contoh: beli_sepatu_olahraga.',
+        '<strong>Konten Kampanye:</strong> Untuk pengujian A/B. Membedakan elemen serupa dalam sebuah kampanye. Contoh: header_v1, sidebar_v2.',
+      ],
+    },
+    { type: 'title', text: 'Praktik Terbaik untuk Penandaan UTM', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Konsistensi huruf:</strong> Alat membedakan antara "Google", "GOOGLE" dan "google". Selalu gunakan huruf kecil untuk menghindari duplikat.',
+        '<strong>Hindari spasi:</strong> Spasi menjadi %20. Gunakan tanda hubung (-) atau garis bawah (_) sebagai gantinya.',
+        '<strong>Jangan gunakan pada tautan internal:</strong> Pelacakan UTM khusus untuk lalu lintas eksternal. Pada tautan internal, ini memutus sesi dan merusak metrik utama.',
+        '<strong>Dokumentasikan tag Anda:</strong> Tetap catat semua kombinasi yang Anda gunakan untuk mencegah ketidakkonsistenan.',
+      ],
+    },
+  ],
+};
+