WordPress 条件标签注入 dataLayer：从设计到操作完全指南

{
  "event": "page_meta",
  "page_type": "single_post",
  "post_id": 42,
  "post_type": "post",
  "is_woo_page": false
}

<?php
/**
 * 在 <head> 最前面注入 dataLayer，必须在 GTM 代码片段之前输出。
 * 挂载到 wp_head，优先级设为 1（越小越早执行）。
 */
add_action( 'wp_head', 'mytheme_inject_datalayer', 1 );

function mytheme_inject_datalayer() {

    // 初始化默认值
    $page_type = 'other';
    $post_id   = 0;
    $post_type = '';

    // ——— 判断逻辑（顺序很重要，越具体的条件放越前面）———

    if ( is_front_page() ) {
        $page_type = 'front_page';

    } elseif ( is_home() ) {
        // is_home() 且不是 front_page，说明用了静态首页 + 独立博客列表页
        $page_type = 'blog_index';

    } elseif ( is_single() ) {
        $page_type = 'single_post';
        $post_id   = get_the_ID();
        $post_type = get_post_type();

    } elseif ( is_page() ) {
        $page_type = 'static_page';
        $post_id   = get_the_ID();

    } elseif ( is_category() ) {
        $page_type = 'category_archive';

    } elseif ( is_tag() ) {
        $page_type = 'tag_archive';

    } elseif ( is_archive() ) {
        // 兜底：其他存档页（自定义分类法、作者页、日期页等）
        $page_type = 'archive';

    } elseif ( is_search() ) {
        $page_type = 'search';

    } elseif ( is_404() ) {
        $page_type = 'error_404';
    }

    // 构建 dataLayer 数据数组
    $datalayer_data = array(
        'event'     => 'page_meta',
        'page_type' => $page_type,
        'post_id'   => $post_id,
        'post_type' => $post_type,
    );

    // 安全输出：wp_json_encode 自动处理转义
    echo '<script>';
    echo 'window.dataLayer = window.dataLayer || [];';
    echo 'dataLayer.push(' . wp_json_encode( $datalayer_data ) . ');';
    echo '</script>' . "\n";
}

add_action( 'wp_head', 'mytheme_inject_datalayer', 1 );

function mytheme_inject_datalayer() {

    $page_type   = 'other';
    $post_id     = 0;
    $post_type   = '';
    $is_woo_page = false;

    // —— WooCommerce 专项（需 WooCommerce 激活）——
    if ( function_exists( 'is_woocommerce' ) ) {

        if ( is_cart() ) {
            $page_type   = 'woo_cart';
            $is_woo_page = true;

        } elseif ( is_checkout() ) {
            // 区分订单完成页和普通结账页
            $page_type   = is_order_received_page() ? 'woo_order_received' : 'woo_checkout';
            $is_woo_page = true;

        } elseif ( is_account_page() ) {
            $page_type   = 'woo_account';
            $is_woo_page = true;

        } elseif ( is_singular( 'product' ) ) {
            $page_type   = 'woo_product';
            $post_id     = get_the_ID();
            $post_type   = 'product';
            $is_woo_page = true;

        } elseif ( is_product_category() ) {
            $page_type   = 'woo_product_category';
            $is_woo_page = true;

        } elseif ( is_shop() ) {
            $page_type   = 'woo_shop';
            $is_woo_page = true;
        }
    }

    // —— 非 WooCommerce 页面回退到通用判断 ——
    if ( $page_type === 'other' ) {

        if ( is_front_page() ) {
            $page_type = 'front_page';
        } elseif ( is_home() ) {
            $page_type = 'blog_index';
        } elseif ( is_single() ) {
            $page_type = 'single_post';
            $post_id   = get_the_ID();
            $post_type = get_post_type();
        } elseif ( is_page() ) {
            $page_type = 'static_page';
            $post_id   = get_the_ID();
        } elseif ( is_category() ) {
            $page_type = 'category_archive';
        } elseif ( is_tag() ) {
            $page_type = 'tag_archive';
        } elseif ( is_archive() ) {
            $page_type = 'archive';
        } elseif ( is_search() ) {
            $page_type = 'search';
        } elseif ( is_404() ) {
            $page_type = 'error_404';
        }
    }

    $datalayer_data = array(
        'event'       => 'page_meta',
        'page_type'   => $page_type,
        'post_id'     => $post_id,
        'post_type'   => $post_type,
        'is_woo_page' => $is_woo_page,
    );

    echo '<script>';
    echo 'window.dataLayer = window.dataLayer || [];';
    echo 'dataLayer.push(' . wp_json_encode( $datalayer_data ) . ');';
    echo '</script>' . "\n";
}

/**
 * 通过 Site Kit 的官方过滤器，向 gtag config 注入自定义维度。
 * 前提：已在 GA4 后台创建名为 page_type 的「自定义维度（事件作用域）」。
 */
add_filter( 'googlesitekit_gtag_opt', 'mytheme_sitekit_gtag_opt' );

function mytheme_sitekit_gtag_opt( $gtag_opt ) {

    $page_type = 'other';

    if ( is_front_page() )       { $page_type = 'front_page'; }
    elseif ( is_home() )         { $page_type = 'blog_index'; }
    elseif ( is_single() )       { $page_type = 'single_post'; }
    elseif ( is_page() )         { $page_type = 'static_page'; }
    elseif ( is_category() )     { $page_type = 'category_archive'; }
    elseif ( is_tag() )          { $page_type = 'tag_archive'; }
    elseif ( is_archive() )      { $page_type = 'archive'; }
    elseif ( is_search() )       { $page_type = 'search'; }
    elseif ( is_404() )          { $page_type = 'error_404'; }

    // WooCommerce 支持
    if ( function_exists( 'is_cart' ) && is_cart() ) {
        $page_type = 'woo_cart';
    } elseif ( function_exists( 'is_checkout' ) && is_checkout() ) {
        $page_type = 'woo_checkout';
    }

    // 写入自定义维度（键名需与 GA4 后台配置一致）
    $gtag_opt['custom_map'] = array(
        'dimension1' => 'page_type',  // 如果用旧式 UA 自定义维度映射
    );
    $gtag_opt['page_type'] = $page_type;

    return $gtag_opt;
}

dataLayer.filter(e => e.event === 'page_meta')

[{ "event": "page_meta", "page_type": "single_post", "post_id": 42, "post_type": "post", "is_woo_page": false }]