如何在GTM中正确调用WordPress创建的自定义分类法

返回undefined的核心原因不是Data Layer变量名写错，是WordPress默认不会把自定义分类法的值自动推送到Data Layer中。你看到的length-standard是<article>标签的CSS类名，属于DOM层面的内容，不会自动同步到Data Layer，直接用点标记法查找自然拿不到值。

步骤1：WordPress端注入Data Layer推送代码 #

将以下代码添加到当前子主题的functions.php文件中，或者使用代码片段类插件插入，避免升级主题时代码被覆盖：

// 推送文章Length自定义分类值到GTM Data Layer
add_action( 'wp_head', 'push_post_length_to_datalayer', 5 );
function push_post_length_to_datalayer() {
    // 仅在单篇文章页执行
    if ( ! is_singular( 'post' ) ) return;
    global $post;
    // 获取当前文章关联的Length分类法项
    $length_terms = get_the_terms( $post->ID, 'length' );
    $length_value = '';
    if ( ! empty( $length_terms ) && ! is_wp_error( $length_terms ) ) {
        // 单篇文章仅关联一个Length分类时，直接取第一个项的slug
        $length_value = $length_terms[0]->slug;
    }
    ?>
    <script>
    window.dataLayer = window.dataLayer || [];
    dataLayer.push({
        'postLength': '<?php echo esc_js( $length_value ); ?>'
    });
    </script>
    <?php
}

步骤2：GTM端配置Data Layer变量 #

• 进入GTM工作区，打开「变量」菜单，点击「新建用户定义变量」
• 变量类型选择Data Layer 变量
• Data Layer变量名称填写postLength（和上述PHP代码中push的键名完全一致，区分大小写）
• 保存变量，可命名为DL - Post Length

如果不方便修改WordPress代码，可以直接通过自定义JS变量从article标签的class中提取分类值：

• 新建GTM用户定义变量，类型选择自定义JavaScript
• 粘贴以下代码并保存：

function() {
  const article = document.querySelector('article[class*="length-"]');
  if (!article) return undefined;
  const lengthClass = Array.from(article.classList).find(cls => cls.startsWith('length-'));
  return lengthClass ? lengthClass.replace('length-', '') : undefined;
}

该变量会自动匹配article标签中length-开头的类名，提取后缀作为分类值，比如当前页面的length-standard会直接返回standard。

1. 开启GTM预览模式，打开任意一篇设置了Length分类的文章页
2. 在预览调试面板的「Variables」标签下，确认你创建的变量能正确返回对应的分类值，无undefined情况
3. 打开你配置的Google Analytics上报代码，将索引为5的自定义维度值绑定为上述创建的变量，保存后发布GTM容器即可。

注意：Data Layer不会自动同步DOM属性（包括标签class、id、文本内容等），所有页面上的业务数据要么主动通过代码推送到Data Layer，要么通过自定义JS/DOM变量手动抓取，不存在默认生成的和CSS类对应的Data Layer字段。

内容的提问来源于stack exchange，提问作者Ld91049