Marketing templates

Marketing performance investigation

A marketing performance investigation evaluates an unexpected metric shift—such as an abrupt surge in cost per acquisition, drop in conversion rates, or mismatched lead totals—by treating click and session discrepancies as initial hypotheses, auditing deployment logs, securing channel owner decisions, obtaining verified execution receipts from authorized implementers, and tracking post-remediation recovery.

Or copy into your agent
Customize this Pump Up template for me: pumpup.com/templates/marketing-performance-investigation/template.md

When to use it

Growth leads, marketing operations managers, and performance marketers managing multi-channel acquisition campaigns.

Example scenario

A paid search campaign exhibits a fictional 45% increase in cost per qualified lead over an illustrative three-day window while reported click-through rate remains steady. The agent treats the divergence between steady ad clicks and declining site analytics sessions as an initial hypothesis rather than definitive proof of tracking failure. Auditing recent repository deployment logs reveals an unannounced header script update deployed on Friday morning that delayed tag firing. The channel lead confirms no deliberate targeting changes occurred and approves a remediation work order. The authorized web developer reverts the script and submits a deployment read-back receipt. Post-fix monitoring across a 24-hour observation window verifies conversion tracking aligns with backend CRM lead creation within illustrative tolerance bounds, resolving the investigation.

Getting started

  • Configure candidate reporting exports or API credentials for active advertising networks and web analytics platforms
  • Map primary conversion goals between ad network conversion tags, analytics tracking, and backend CRM ingestion stages
  • Designate authorized implementers for ad account changes, web code deployments, and analytics configurations
  • Define illustrative anomaly variance thresholds and evaluation observation windows suited to company traffic volume

Common questions

How does the agent differentiate tracking regressions from genuine audience fatigue?

The agent treats metric divergence as a working hypothesis, comparing top-of-funnel ad clicks with destination web sessions, UTM capture logs, and site deployment histories. Tracking bugs typically correlate with abrupt code releases or zero-event drop-offs, whereas fatigue presents as gradual click-through decline across unchanged pages.

Does approval of a remediation proposal constitute verification that changes were implemented?

No. Management approval grants authority to act, but the designated authorized implementer (such as a media buyer or web developer) must provide a concrete execution receipt or read-back confirmation before post-fix monitoring begins.

What happens if candidate platform connectors or analytics tools are unavailable?

If direct API access is unconfigured or temporarily unavailable, the agent falls back to manual CSV or spreadsheet export ingestion, continuing the investigation without blocking on automated connectors.

Platform documentation

How the marketing performance investigation agent works

This playbook defines how an agent investigates an anomalous divergence in marketing metrics, cross-references performance data across delivery platforms, obtains owner context, agrees remediation with authorized implementers, and verifies execution before monitoring recovery. One run evaluates a single bounded performance anomaly identified across a designated channel, campaign, or funnel stage. The agent operates in read-only analysis and drafting mode across configured reporting tools, advertising exports, analytics platforms, and customer databases; direct API connectors are candidate integrations that fall back to manual export files if unconfigured. Budget reallocations, bid changes, creative pausing, and tracking code modifications remain under the exclusive authority of human owners, and approval alone does not constitute proof of execution.

  • Inspect the initial anomaly alert or manual reporting export to define the investigation boundary, noting the affected channel, campaign ID, evaluation timeframe, and primary divergent metrics such as cost per acquisition or lead conversion rate against company-defined illustrative tolerance baselines.
  • Retrieve campaign delivery records from candidate advertising connectors or manual CSV exports, recording gross spend, impressions, raw clicks, and delivery state changes across the anomaly window and the preceding baseline period.
  • Compare platform-reported clicks with destination site analytics sessions and UTM attribution logs; treat traffic divergences as working hypotheses rather than conclusive proof of tracking failure, auditing site release logs and tag manager version histories to determine whether discrepancy correlates with technical deployments or genuine audience drop-off.
  • Audit downstream conversion event telemetry between site analytics events and CRM contact creation timestamps to test hypotheses regarding tracking script dropouts, form validation errors, or backend ingestion delays.
  • Compile a factual discrepancy summary contrasting reported platform spend, landing page traffic, recorded conversion tags, and verified CRM pipeline records, explicitly identifying unverified assumptions and data gaps where reporting connectors or logs are unavailable.
  • Information request. Present the discrepancy summary and working hypotheses to the responsible campaign manager, requesting operational context regarding recent creative refreshes, budget alterations, targeting adjustments, or concurrent landing page changes.
  • Evaluate the channel manager's response against platform delivery logs and technical audit findings to establish whether the performance shift stems from confirmed tracking telemetry failure, intentional experimental configuration, audience saturation, or external platform volatility; if the manager provides requested adjustments, revise the diagnostic assessment accordingly.
  • Approval. If corrective intervention is warranted, submit an explicit remediation work order to the marketing lead specifying the exact proposed changes, the designated authorized implementer (such as a named media buyer or web developer), and expected post-fix performance criteria; if the lead declines the proposal, document the decision and transition the case to declined or unresolved status without applying changes.
  • Once the remediation proposal is approved, require the designated authorized implementer to submit an explicit execution receipt or system read-back (such as ad network change history logs or code deployment commit hashes) confirming the approved changes are live before initiating recovery monitoring; if receipt is unconfirmed or implementation stalls, hold the case awaiting verification rather than assuming completion.
  • Following verified implementation read-back, monitor the target channel and backend data pipeline across an illustrative post-fix observation window to verify that conversion telemetry stabilizes, spend aligns with expected targets, and CRM lead ingestion resumes normal volume.
  • Exception. If post-remediation monitoring reveals persistent variance exceeding defined tolerance thresholds, if candidate reporting tools remain unavailable, or if tracking remains broken after technical handoff, flag an escalation alert to the growth lead and technical operations owner with raw diagnostic logs, pausing automated evaluation until manual recovery is completed.
  • In a fictional acquisition campaign, the agent detects an illustrative 48% increase in cost per qualified lead over a 72-hour window while reported ad clicks remain stable. Treating the click-to-session gap as an initial hypothesis, the agent checks Google Analytics 4 sessions against HubSpot form submissions and discovers that form submissions plummeted following a Friday website header release that inadvertently stripped the form tracking container. The agent submits an information request to the paid search lead, who confirms targeting was unchanged and identifies the responsible deployment ticket. The marketing lead approves an emergency tag restoration work order assigned to the web operations lead. The web developer reverts the script and submits the deployment read-back commit hash. The agent then monitors subsequent traffic for an illustrative 24-hour observation window, verifying that form submission tracking recovers to within illustrative baseline tolerances and matches CRM lead creation.
  • Conclude the case when verified performance telemetry confirms agreed remediation has restored metrics within acceptable boundaries, or record the investigation as unresolved if underlying platform volatility, permanent market shifts, or human decision to decline intervention leaves the anomaly active, keeping campaign continuity under direct human governance.

Where your team decides

  • Channel manager evaluation of whether divergence represents deliberate tactical changes or unexplained failure
  • Marketing lead or authorized stakeholder approval, requested adjustments, or formal decline of proposed remediation
  • Team determination to close verified recovery, accept trade-offs, or record an unresolved attribution discrepancy

Example systems

Configure connections and permitted actions during setup.

  • HubSpot
  • Google Sheets
  • beehiiv
  • Kit

Checks to adapt

Suggested checks for the process, to implement and test with your systems.

  • Anomaly boundary definition

    Parses incoming metric alerts or manual exports to isolate campaign identifiers, reporting windows, target KPIs, and statistical variance from trailing performance baselines.

  • Telemetry divergence audit

    Evaluates ad platform click logs, site analytics sessions, and CRM contact creation events as working hypotheses against deployment logs to identify tracking drops, attribution misalignments, or ingestion latency.

  • Remediation follow-through monitor

    Evaluates post-correction delivery and conversion telemetry over a defined observation window following verified implementation read-back to confirm metric stabilization and flag recurring discrepancies.

Process stages

Adapt marketing performance investigation with your team

Sign up