mcpField
C
conversion-tracking

conversion-tracking

github.com/itallstartedwithaidea营销与增长4499 次安装29 周前更新
代码仓库

关于 conversion-tracking

conversion-tracking 是面向 Google Ads 的转化测量管理技能,供广告主配置、验证和排查追踪,并管理归因设置。它覆盖 Google tag、增强型转化和离线转化导入。

主要功能

  1. 01配置和验证转化操作
  2. 02排查 Google tag 问题
  3. 03设置增强型转化
  4. 04管理离线转化导入
  5. 05配置归因模型与转化窗口

适用场景

  1. 01调查转化未记录或数据缺失
  2. 02为第一方数据配置增强型转化
  3. 03将 CRM 离线销售导入 Google Ads
  4. 04比较并设置转化归因方式

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/itallstartedwithaidea/agent-skills --skill conversion-tracking

安装后在 Claude Code 中输入/conversion-tracking确认已加载。

详细介绍

转化跟踪

属于 Agent Skills™,由 googleadsagent.ai™ 提供

描述

转化跟踪技能提供 Google Ads 转化衡量基础设施的端到端管理。准确的转化跟踪是每项优化决策的基础——没有它,出价策略、预算分配和关键字价值评估都会失去依据。此技能涵盖整个转化技术栈的设置、验证、调试和归因建模:Google tag、增强型转化、离线转化导入和转化价值规则。

此技能涵盖完整的转化操作层级:推动出价的宏观转化(购买、潜在客户、注册),以及用于受众构建和漏斗分析的微观转化(页面浏览、加入购物车、视频播放)。它会根据业务模式要求配置转化窗口、浏览型转化设置和计数方式(每次点击一次或每次均计数)。通过第一方数据(电子邮件、电话、地址)设置增强型转化,以弥补 Cookie 弃用和隐私法规造成的衡量缺口。

归因建模是关键组成部分。此技能会评估并配置数据驱动归因(DDA),将其与末次点击及其他模型进行比较,并帮助广告主了解漏斗上层广告系列的真实价值贡献。对于销售周期涉及线下环节的企业,此技能通过 CRM 集成管理离线转化导入流程,确保收入数据回传至 Google Ads,以便准确计算 ROAS。

使用场景

  • 用户询问“转化跟踪设置”或“转化配置”
  • 用户提到“未记录转化”或“缺少转化”
  • 用户想要“调试转化跟踪”或“验证跟踪”
  • 用户询问“增强型转化”或“第一方数据”
  • 用户提到“离线转化”或“CRM 导入”
  • 用户询问“归因建模”或“数据驱动归因”
  • 用户想要“设置 Google tag”或“配置 gtag”
  • 用户提到“转化价值规则”或“转化操作”
  • 用户询问“为什么智能出价不起作用”(通常与跟踪有关)

架构

flowchart TD
    A[Conversion Strategy Definition] --> B[Conversion Action Setup]

    B --> C[Primary Conversions\nPurchase, Lead, Sign-up]
    B --> D[Secondary Conversions\nAdd-to-Cart, Page View]

    C --> E[Google Tag Implementation]
    D --> E

    E --> F[Base Tag: gtag.js]
    E --> G[Event Snippets]
    E --> H[Google Tag Manager]

    F --> I[Enhanced Conversions]
    G --> I
    I --> I1[Email Hashing]
    I --> I2[Phone Hashing]
    I --> I3[Address Matching]

    J[CRM / Backend Data] --> K[Offline Conversion Import]
    K --> K1[Click ID Matching: GCLID]
    K --> K2[Enhanced Conversions for Leads]
    K --> K3[Store Sales Import]

    I1 --> L[Conversion Validation Engine]
    I2 --> L
    I3 --> L
    K1 --> L
    K2 --> L
    K3 --> L

    L --> M{Validation Status}
    M -->|Healthy| N[Attribution Model Configuration]
    M -->|Issues Detected| O[Debugging Pipeline]

    O --> P[Tag Diagnostics]
    O --> Q[Data Discrepancy Analysis]
    O --> R[Cross-Platform Reconciliation]

    N --> S[Data-Driven Attribution]
    N --> T[Conversion Value Rules]
    N --> U[Conversion Window Optimization]

实现

转化跟踪验证和调试框架:

async function validateConversionTracking(customerId) {
  const conversionActions = await getConversionActions(customerId);
  const tagDiagnostics = await runTagDiagnostics(customerId);
  const recentConversions = await getRecentConversions(customerId, 7);

  const issues = [];

  for (const action of conversionActions) {
    if (action.status !== 'ENABLED') continue;

    const validation = {
      actionName: action.name,
      category: action.category,
      tagInstalled: tagDiagnostics[action.id]?.installed ?? false,
      firingCorrectly: tagDiagnostics[action.id]?.recentFires > 0,
      conversionCount7d: recentConversions[action.id]?.count ?? 0,
      conversionLag: calculateConversionLag(recentConversions[action.id]),
      duplicateRate: detectDuplicates(recentConversions[action.id]),
      valueAccuracy: validateConversionValues(recentConversions[action.id])
    };

    if (!validation.tagInstalled) {
      issues.push({ action: action.name, severity: 'critical', issue: 'Tag not detected on website' });
    }
    if (!validation.firingCorrectly) {
      issues.push({ action: action.name, severity: 'critical', issue: 'Tag installed but not firing' });
    }
    if (validation.duplicateRate > 0.05) {
      issues.push({ action: action.name, severity: 'high', issue: `${(validation.duplicateRate * 100).toFixed(1)}% duplicate conversion rate detected` });
    }
  }

  return { conversionActions, issues, overallHealth: issues.length === 0 ? 'healthy' : 'needs_attention' };
}

增强型转化设置:

function generateEnhancedConversionTag(config) {
  const { conversionId, conversionLabel, dataSource } = config;

  return `

<script async src="https://www.googletagmanager.com/gtag/js?id=${conversionId}"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', '${conversionId}');

  gtag('set', 'user_data', {
    'email': hashUserEmail(),
    'phone_number': hashUserPhone(),
    'address': {
      'first_name': document.getElementById('first_name')?.value,
      'last_name': document.getElementById('last_name')?.value,
      'street': document.getElementById('street')?.value,
      'city': document.getElementById('city')?.value,
      'region': document.getElementById('region')?.value,
      'postal_code': document.getElementById('postal_code')?.value,
      'country': document.getElementById('country')?.value
    }
  });

  gtag('event', 'conversion', {
    'send_to': '${conversionId}/${conversionLabel}',
    'value': getTransactionValue(),
    'currency': 'USD',
    'transaction_id': getOrderId()
  });
</script>`;
}

async function setupOfflineConversionImport(customerId, crmConfig) {
  const { crmType, conversionActionName, uploadFrequency } = crmConfig;

  const pipeline = {
    source: crmType,
    gclidCapture: {
      method: 'hidden_form_field',
      fieldName: 'gclid',
      storageMethod: 'crm_custom_field',
      expirationDays: 90
    },
    conversionMapping: {
      crmStage: crmConfig.qualifiedStage,
      googleAdsAction: conversionActionName,
      valueField: crmConfig.dealValueField
    },
    uploadSchedule: {
      frequency: uploadFrequency,
      lookbackWindow: '30_days',
      deduplication: 'gclid_plus_timestamp'
    }
  };

  return pipeline;
}

归因模型配置:

function configureAttribution(customerId, config) {
  const { preferredModel = 'DATA_DRIVEN' } = config;

  return {
    model: preferredModel,
    requirements: {
      dataDriven: {
        minConversions30d: 300,
        minClicks30d: 3000,
        eligible: config.conversions30d >= 300 && config.clicks30d >= 3000
      }
    },
    conversionValueRules: [
      { condition: 'audience_is_returning_customer', valueMultiplier: 1.5 },
      { condition: 'device_is_mobile', valueMultiplier: 0.8 },
      { condition: 'geo_is_tier1_market', valueMultiplier: 1.2 }
    ],
    conversionWindows: {
      clickThrough: config.salesCycleDays || 30,
      viewThrough: Math.min(config.salesCycleDays || 30, 30),
      engagedView: 3
    }
  };
}

与 Buddy™ Agent 集成

转化跟踪是整个 Buddy™ Agent 平台的衡量基础。在任何优化技能启用之前,Buddy™ 都会运行转化验证流程,确保数据完整性。如果检测到跟踪问题,Buddy™ 会提醒用户,并暂停优化建议,直到衡量基础恢复可靠。

Buddy™ 会持续监控转化数据是否存在异常:转化量骤降、转化率意外变化、Google Ads 与后端系统之间的价值差异,以及标签触发失败。这些异常会触发自动诊断工作流,以确定根本原因并提出修复建议。

对于包含离线转化的账户,Buddy™ 会管理自动导入流程,确保 CRM 数据按计划回传至 Google Ads,并正确匹配 GCLID。平台会跟踪导入成功率、识别匹配失败,并协调各平台之间的转化数据。

最佳实践

  1. 每月通过对比 Google Ads 数据与后端/CRM 记录,验证转化跟踪
  2. 使用增强型转化,弥补因 Cookie 限制而流失的 5-15% 转化
  3. 将转化计数设置为:潜在客户开发选择“每次”,电子商务选择“每次转化”
  4. 配置与实际销售周期长度相符的转化窗口
  5. 使用转化价值规则区分高价值细分群体,无需更改标签代码
  6. 尽可能在符合条件的事件发生后 24 小时内导入线下转化
  7. 符合条件时(每月 300 次以上转化),对大多数情况使用数据驱动归因,以最准确地分配转化功劳
  8. 建立清晰的层级:主要转化用于出价,次要转化仅用于观察
  9. 使用唯一交易 ID 对转化去重,避免报告数据虚高
  10. 每周查看 Google Ads 标签诊断页面,监控标签运行状况

平台兼容性

平台支持
Claude Code✅
Cursor✅
Codex✅
Gemini✅

相关技能

关键词

转化跟踪、Google 标签、gtag、增强型转化、线下转化、GCLID、转化导入、归因建模、数据驱动归因、转化价值规则、转化操作、转化调试、转化设置、Google Ads 转化、转化验证


© 2026 googleadsagent.ai™ | Agent Skills™ | MIT License

评论

支持 Markdown