Json-LD自定义调用标签`{% jsonLd %}`应该放置在模板的哪个位置？
安企CMS中，Json-LD自定义调用标签{% jsonLd %}应该放置在模板的哪个位置？
在当今数字营销的时代，搜索引擎优化（SEO）的重要性不言而喻。而结构化数据，尤其是Json-LD，正是提升网站在搜索结果中可见度的强大工具之一。安企CMS作为一款专为企业级内容管理和SEO优化设计的高效系统，自然也提供了完善的Json-LD支持。但对于不少模板开发者和内容运营者来说，安企CMS提供的{% jsonLd %}自定义调用标签究竟应该安放在模板的何处，才能发挥其**效果并避免潜在问题，却常常是一个值得探讨的话题。
Json-LD是什么以及安企CMS为何重视它？
Json-LD，即基于JSON的链接数据，是一种将结构化数据直接嵌入HTML页面的推荐格式。它以一种搜索引擎易于理解的方式描述页面内容，从而帮助网站在搜索结果中展示更丰富的片段（Rich Snippets），如评价星级、产品价格、事件日期等，显著提升点击率。
安企CMS在设计之初就充分考虑了SEO友好性，其内置的许多高级SEO工具（如Sitemap生成、Robots.txt配置、关键词库管理、301重定向、伪静态等）都旨在帮助用户优化网站表现。默认情况下，安企CMS在后台功能开启结构化数据后，会自动在页面中插入基础的Json-LD结构，这对于大多数网站来说已经是一个很好的起点。
深入理解安企CMS的{% jsonLd %}标签
然而，网站内容千变万化，默认的Json-LD结构可能无法满足所有精细化的SEO需求，例如你需要为特定类型的文章添加更具体的Schema属性，或者为产品详情页定义更丰富的商品信息。这时，{% jsonLd %}自定义调用标签就派上用场了。
这个标签允许你在模板中声明自己的Json-LD内容。值得注意的是，安企CMS非常智能地处理这些自定义内容：它会自动合并你定义的Json-LD与系统默认生成的Json-LD数据。这意味着，如果你自定义的字段与默认字段存在冲突，你定义的内容将会覆盖默认值，从而实现更灵活的控制。当然，前提是你自定义的Json-LD内容必须符合其官方语法规范。
{% jsonLd %}标签的**放置位置
那么，这个强大的自定义标签究竟应该放在模板的哪个位置呢？从SEO**实践和安企CMS的模板机制来看，以下是我们的建议：
Json-LD本质上是描述页面内容的元数据，虽然搜索引擎可以解析放置在HTML文档任何位置的Json-LD（无论是<head>还是<body>内），但将结构化数据放置在HTML文档的<head>部分，通常被认为是更规范和推荐的做法。这样做的好处是，搜索引擎的爬虫在解析页面时能够更早地发现并处理这些重要的元数据，从而可能更快地理解页面内容并生成富媒体搜索结果。
结合安企CMS的模板结构，我们可以将放置策略分为两种情况：
全局性或通用Json-LD（例如“Organization”或“Website”Schema）： 如果你的Json-LD是描述整个网站或公司信息的，例如你的网站名称、Logo、联系方式等，这些信息会出现在网站的每一个页面。在这种情况下，最理想的放置位置是你的主模板文件（例如
bash.html或你定义的全局布局文件）的<head>标签内部。将代码放在这里，可以确保所有继承此主模板的页面都能自动包含这些Json-LD数据，避免了在每个子页面中重复添加的麻烦。页面特定或内容特定Json-LD（例如“Article”、“Product”或“Service”Schema）： 如果你的Json-LD是针对特定类型页面内容进行优化的，例如文章详情页（Article Schema）、产品详情页（Product Schema）或单页面（WebPage Schema），那么它应该放置在对应内容模型的详细页模板文件中。比如，对于文章详情页，你可能会在
archive/detail.html模板文件的<head>标签内部使用{% jsonLd %}标签。这样可以确保Json-LD数据与页面内容高度相关，提升结构化数据的准确性和有效性。
无论哪种情况，确保你的{% jsonLd %}标签包裹着标准的<script type="application/ld+json">标签，并在其中书写你的Json-LD数据。示例如下：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>{% tdk with name="Title" siteName=true %}</title>
<meta name="keywords" content="{% tdk with name="Keywords" %}">
<meta name="description" content="{% tdk with name="Description" %}">
{%- tdk canonical with name="CanonicalUrl" %}
{%- if canonical %}
<link rel="canonical" href="{{canonical}}" />
{%- endif %}
{# 放置Json-LD自定义标签的**位置之一 #}
{% jsonLd %}
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "{{ archive.Title }}",
"image": [
"{{ archive.Logo }}"
],
"datePublished": "{{ stampToDate(archive.CreatedTime, "2006-01-02T15:04:05+08:00") }}",
"author": {
"@type": "Person",
"name": "安企CMS运营团队"
},
"publisher": {
"@type": "Organization",
"name": "{% system with name="SiteName" %}",
"logo": {
"@type": "ImageObject",
"url": "{% system with name="SiteLogo" %}"
}
}
}
</script>
{% endjsonLd %}
<!-- 其他CSS、JS等资源 -->
</head>
<body>
<!-- 页面主体内容 -->
</body>
</html>
在上面的示例中，我们利用了安企CMS模板提供的{{ archive.Title }}、{{ archive.Logo }}、{% system with name="SiteName" %}等变量，动态地填充Json-LD数据，使其能够适应不同页面内容的需求。
总结
将安企CMS的{% jsonLd %}自定义调用标签放置在模板的<head>部分是**实践，无论是全局性的bash.html，还是针对特定内容模型的detail.html。这样做不仅符合SEO规范，也能确保Json-LD数据被搜索引擎高效解析。通过灵活运用这一标签，并