WordPress 实战：GA4 内容分组完整配置手册（URL 匹配逻辑 + 自定义维度注册）

is_front_page()      // 首页（无论是静态首页还是文章列表）
is_home()            // 博客文章列表页（「阅读设置」中配置的文章页）
is_single()          // 单篇文章（post type = post）
is_page()            // 静态页面（post type = page）
is_singular('product') // WooCommerce 产品详情页
is_post_type_archive('product') // WooCommerce 产品列表页
is_category()        // 文章分类归档页
is_tag()             // 标签归档页
is_tax()             // 自定义分类法归档页
is_search()          // 搜索结果页
is_404()             // 404 页面
is_cart()            // WooCommerce 购物车（wc_is_checkout() 的变体）
is_checkout()        // WooCommerce 结账页
is_account_page()    // WooCommerce 账户页
is_order_received_page() // WooCommerce 订单确认页

<?php
/**
 * GA4 内容分组 - 将页面类型推送到 dataLayer
 * 添加到子主题 functions.php 或代码片段插件
 */
function push_content_group_to_datalayer() {
    // 判断内容分组
    $content_group = ga4_get_content_group();

    // 同时获取二级分组（可选，适合内容体系复杂的网站）
    $content_group2 = ga4_get_content_group2();

    // 输出到页面 <head> 内的 dataLayer
    ?>
    <script>
        window.dataLayer = window.dataLayer || [];
        window.dataLayer.push({
            'contentGroup': '<?php echo esc_js($content_group); ?>',
            'contentGroup2': '<?php echo esc_js($content_group2); ?>'
        });
    </script>
    <?php
}
// 在 <head> 最顶部、GTM/gtag 代码之前输出
add_action('wp_head', 'push_content_group_to_datalayer', 1);


/**
 * 一级内容分组：页面类型
 */
function ga4_get_content_group() {

    // ===== WooCommerce 页面（优先判断，避免被通用规则覆盖）=====
    if (function_exists('is_woocommerce')) {
        if (is_order_received_page()) return '订单确认页';
        if (is_checkout())            return '结账页';
        if (is_cart())                return '购物车';
        if (is_account_page())        return '账户中心';
        if (is_singular('product'))   return '产品详情页';
        if (is_post_type_archive('product') || is_product_category() || is_product_tag()) {
            return '产品列表页';
        }
    }

    // ===== 首页 =====
    if (is_front_page()) return '首页';

    // ===== 博客 =====
    if (is_single())    return '博客文章页';
    if (is_home())      return '博客列表页';
    if (is_category())  return '分类归档页';
    if (is_tag())       return '标签归档页';

    // ===== 静态页面（根据 slug 细分）=====
    if (is_page()) {
        $slug = get_post_field('post_name', get_the_ID());

        // 常见落地页 slug，根据你的网站实际情况修改
        $landing_pages = ['about', 'about-us', 'about-me', 'about-company'];
        $contact_pages = ['contact', 'contact-us', 'get-in-touch'];
        $service_pages = ['services', 'service', 'solutions', 'offerings'];

        if (in_array($slug, $landing_pages))  return '关于我们页';
        if (in_array($slug, $contact_pages))  return '联系我们页';
        if (in_array($slug, $service_pages))  return '服务介绍页';

        // 其他静态页面统一归类
        return '静态页面';
    }

    // ===== 特殊页面 =====
    if (is_search()) return '搜索结果页';
    if (is_404())    return '404页面';
    if (is_tax())    return '自定义分类页';
    if (is_author()) return '作者归档页';
    if (is_date())   return '日期归档页';

    return '其他';
}


/**
 * 二级内容分组：内容品类（适合博客文章和产品）
 */
function ga4_get_content_group2() {

    // 博客文章：取第一个分类名称
    if (is_single()) {
        $categories = get_the_category();
        if (!empty($categories)) {
            return $categories[0]->name;
        }
    }

    // WooCommerce 产品：取第一个产品分类
    if (function_exists('is_woocommerce') && is_singular('product')) {
        $terms = get_the_terms(get_the_ID(), 'product_cat');
        if (!empty($terms) && !is_wp_error($terms)) {
            // 过滤掉顶级分类「Uncategorized」
            foreach ($terms as $term) {
                if ($term->name !== 'Uncategorized' && $term->slug !== 'uncategorized') {
                    return $term->name;
                }
            }
        }
    }

    return '';
}

变量名称：DL - contentGroup
数据层变量名称：contentGroup
数据层版本：版本 2
默认值：其他

变量名称：DL - contentGroup2
数据层变量名称：contentGroup2
数据层版本：版本 2
默认值：（留空）

function() {
  var path = window.location.pathname;

  // ===== WooCommerce 页面（越具体的规则越靠前）=====
  if (/\/checkout\/order-received/.test(path)) return '订单确认页';
  if (/\/checkout/.test(path))                 return '结账页';
  if (/\/cart/.test(path))                     return '购物车';
  if (/\/my-account/.test(path))               return '账户中心';

  // 产品详情页：/product/ 后跟产品 slug
  if (/^\/product\/[^/]+\/?$/.test(path))      return '产品详情页';

  // 产品列表：/shop/ 或 /product-category/
  if (/^\/(shop|product-category)/.test(path)) return '产品列表页';

  // ===== 首页 =====
  if (path === '/' || path === '/index.php')   return '首页';

  // ===== 博客（取决于你的固定链接格式）=====
  // 如果博客文章在 /blog/ 子目录下
  if (/^\/blog\/[^/]+\/?$/.test(path))         return '博客文章页';
  if (/^\/blog\/?$/.test(path))                return '博客列表页';

  // 如果博客文章直接在根目录（需要区分静态页面和文章，较难，建议用方案A）
  // 分类页：/category/
  if (/^\/category\//.test(path))              return '分类归档页';
  // 标签页：/tag/
  if (/^\/tag\//.test(path))                   return '标签归档页';

  // ===== 静态页面（按 slug 列举重要页面）=====
  if (/^\/(about|about-us)\/?$/.test(path))    return '关于我们页';
  if (/^\/(contact|contact-us)\/?$/.test(path))return '联系我们页';
  if (/^\/services\/?$/.test(path))            return '服务介绍页';

  // ===== 特殊页面 =====
  if (/\/\?s=/.test(window.location.search))   return '搜索结果页';

  return '其他';
}

代码名称：GA4 - page_view（含内容分组）
代码类型：Google Analytics: GA4 事件

<?php
function add_ga4_with_content_group() {
    $measurement_id = 'G-XXXXXXXXXX'; // 替换为你的测量 ID
    $content_group  = ga4_get_content_group();  // 复用上文定义的函数
    $content_group2 = ga4_get_content_group2();
    ?>
    <!-- Google tag (gtag.js) -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=<?php echo esc_attr($measurement_id); ?>"></script>
    <script>
        window.dataLayer = window.dataLayer || [];
        function gtag(){dataLayer.push(arguments);}
        gtag('js', new Date());

        // 配置 GA4，发送 page_view 时携带内容分组
        gtag('config', '<?php echo esc_js($measurement_id); ?>', {
            'content_group': '<?php echo esc_js($content_group); ?>',
            'content_group2': '<?php echo esc_js($content_group2); ?>'
        });
    </script>
    <?php
}
add_action('wp_head', 'add_ga4_with_content_group');

<?php
/**
 * 通过 Site Kit 的过滤器注入内容分组参数
 */
add_filter('googlesitekit_gtag_opt', function($gtag_opt) {
    $gtag_opt['content_group']  = ga4_get_content_group();
    $gtag_opt['content_group2'] = ga4_get_content_group2();
    return $gtag_opt;
});

GA4 管理界面（齿轮图标）
  └── 媒体资源列（中间列，确认是你的网站媒体资源）
        └── 数据显示
              └── 自定义定义
                    └── 自定义维度 标签页

GA4 管理界面
  └── 管理（齿轮）
        └── 媒体资源
              └── DebugView

✅ content_group = 产品详情页
✅ content_group2 = 运动鞋
✅ page_location = https://yoursite.com/product/nike-air-max/
✅ page_title = Nike Air Max 2024 - Your Store

// 查看 dataLayer 中的内容分组数据
window.dataLayer.filter(e => e.contentGroup)

// 预期输出示例：
// [{ contentGroup: "产品详情页", contentGroup2: "运动鞋" }]

-- 用 SQL 思维理解你要做的分析

-- Q1：各内容组的参与质量排名
SELECT content_group, sessions, engaged_sessions, engagement_rate
ORDER BY engaged_sessions DESC

-- Q2：各内容组的转化贡献
SELECT content_group, conversions, revenue
WHERE content_group IN ('产品详情页', '活动促销页')

-- Q3：用户在各内容组之间的流转
-- 用「路径探索」报告，起点选「内容分组 = 博客文章页」
-- 查看用户下一步去了哪里

// 匹配 /product/ 或 /en/product/ 或 /zh/product/
if (/^(\/[a-z]{2})?\/product\/[^/]+\/?$/.test(path)) return '产品详情页';