Seatext library / BotRefund evidence

When to Update Your Evidence Collection Schema: A Readiness Checklist

Update your evidence collection schema after major site changes or when new bot patterns emerge. This keeps your detection accurate and your ad spend protected.

Built for advertisers who need clear, refund-ready traffic evidence.

You should update your evidence collection schema after major site changes—like a redesign, platform migration, or new feature launch—or when you detect new bot patterns that your current system might miss. A schema is not a static document. It must evolve as your website changes and as bots become more sophisticated. This article explains when to update, how to plan the update, and common mistakes to avoid.

Readiness Checklist for Updating Your Evidence Collection Schema

Use this checklist to decide if your schema needs attention. If you answer yes to any of these, it is time to review your evidence collection rules.

  • Site has undergone significant changes: New code, layout, or functionality can alter how bots behave or how evidence is collected. For example, a redesign that changes page structure may break existing tracking scripts.
  • New bot patterns observed: If your audit shows unfamiliar click behaviors or anomalies, your schema may need new checks. Bots constantly adapt, so what worked six months ago may not catch today's threats.
  • Security or compliance review: Regularly review your schema during policy updates to ensure it covers all required evidence types. Compliance requirements can change, and your schema must reflect that.
  • Performance metrics drop: A sudden increase in flagged false positives or missed detections signals a schema gap. If your detection rate falls, your schema is likely outdated.
  • Integration with new tools: When adding analytics or fraud prevention tools, align your schema with their data requirements. New tools may collect different signals that need to be incorporated.

Signs That Your Schema Needs an Update

Look for these indicators that your current evidence collection is falling behind:

  • Increased bot clicks without recovery: If you're seeing more invalid clicks but fewer successful refund claims, your evidence might be incomplete. This means your schema is not capturing the right signals to prove fraud.
  • Novel evasion techniques: Bots using advanced spoofing or behavior mimicry can bypass existing checks. For example, bots that simulate human mouse movement or use residential proxies can evade simple rules.
  • Feedback from ad platforms: Google or Meta rejecting claims due to insufficient evidence suggests schema weaknesses. If your refund requests are denied, your evidence does not meet their standards.
  • Changes in user traffic: Shifts in geographic, device, or network patterns can affect how bots are detected. A sudden influx of traffic from a new region may require new checks.

When to Wait Before Updating

Avoid updating your schema unnecessarily. Wait if:

  • Changes are minor: Small content edits or bug fixes rarely impact bot behavior enough to warrant a full update. A typo fix does not change how bots interact with your site.
  • No new patterns detected: If your current system is still catching most bots effectively, hold off until a clear need arises. Frequent updates can introduce errors and waste resources.
  • During peak ad campaigns: Updating mid-campaign can disrupt data collection and affect performance tracking. If you are running a high-stakes campaign, wait until it ends.
  • Insufficient data: Without enough recent evidence, changes might be based on incomplete insights. Wait until you have a solid sample size to make informed decisions.

How to Plan a Schema Update

Planning prevents mistakes. Follow these steps to prepare your update.

First, audit your current schema. List every check and signal you collect. Identify which ones are still relevant and which are outdated. This gives you a baseline.

Second, review recent bot activity. Look at your ad platform data and any bot detection reports. Note any new patterns or anomalies. This tells you what to add or modify.

Third, set clear goals. Define what you want the updated schema to achieve. For example, reduce false positives by 20% or catch a specific bot family. Goals help you measure success.

Fourth, involve your team. Get input from developers, marketers, and compliance officers. They may see issues you missed. Collaboration leads to a more robust schema.

Finally, schedule the update. Choose a low-traffic period. Avoid peak sales times. This minimizes disruption to your data collection.

Step-by-Step Update Process

Once you have a plan, execute it carefully. Here is a step-by-step process.

  1. Back up your current schema. Save a copy of your existing rules and settings. This allows you to roll back if something goes wrong.
  2. Create a staging environment. Test the updated schema on a copy of your site. This prevents issues from affecting live traffic.
  3. Implement changes incrementally. Add or modify one check at a time. This makes it easier to identify problems.
  4. Run a side-by-side comparison. Use both old and new schemas on the same traffic. Compare detection rates and false positives.
  5. Monitor performance. After deployment, watch key metrics for at least a week. Look for unexpected changes in detection accuracy or user experience.
  6. Document the update. Record what you changed and why. This helps future updates and provides a history for audits.

Exceptions and Special Cases

Some scenarios don't follow the general rules:

  • Very small ad spends: For budgets under $10,000/month, the cost of frequent schema updates may outweigh benefits. Focus on basic protection first. You can rely on simpler checks and update less often.
  • Non-ad fraud contexts: Evidence collection for security audits or compliance has different triggers—like regulatory changes rather than bot patterns. If you are collecting evidence for legal purposes, update when laws or standards change.
  • Automated schema updates: Some systems offer dynamic adjustments, but these require careful monitoring to avoid errors. Automated updates can be convenient, but they may introduce false positives if not tuned properly.

What Is an Evidence Collection Schema?

An evidence collection schema is the structured set of rules and checks a system uses to gather data that distinguishes human activity from automated bot behavior. It defines what signals are collected—like click timing, mouse movements, and session duration—and how they are validated to prove or disprove ad fraud. A well-designed schema is comprehensive and adaptable. It covers multiple types of evidence to avoid relying on a single signal that can be spoofed.

How BotRefund Handles Evidence Collection

BotRefund uses over 100 independent checks to build a reliable picture of whether a visit is human or automated. For example, it monitors behaviors like ghost click detection, honeypot trap interactions, and unnatural mouse movements. When you update your schema, BotRefund's system can adapt by incorporating new signals, but it requires integration with your website to function effectively. BotRefund also cross-checks signals to achieve 99% accuracy. This means a single anomaly is not enough to flag a user; the system looks for corroborating evidence.

Key Facts About Evidence Collection with BotRefund

FactDetail
Number of checksBotRefund uses 106 independent checks to collect evidence.
Setup timeAdd BotRefund to your website in about one minute.
Platform supportWorks with Google Ads and Meta ad platforms for refund claims.
AccuracyAchieves 99% accuracy by cross-checking signals.

Common Mistakes to Avoid

Many teams make avoidable errors when updating their schema. Here are the most common ones.

  • Updating too frequently. Constant changes can destabilize your detection system. Stick to a schedule unless there is a clear need.
  • Ignoring false positives. If your update increases false positives, you may block real users. Always monitor this metric.
  • Not testing thoroughly. Skipping staging tests can lead to broken tracking or missed bots. Always test in a safe environment.
  • Relying on a single signal. Bots can spoof one behavior. Use multiple independent checks to build a robust case.
  • Forgetting to document. Without documentation, you lose track of why changes were made. This complicates future updates.

Limitations of This Advice

This guidance applies primarily to ad fraud prevention and bot detection. It may not suit other evidence collection needs, such as legal or compliance audits, where triggers differ. Always consider your specific context and tools before making changes. For example, a legal audit may require evidence that meets court standards, which is different from ad fraud evidence.

Terminology

  • Evidence collection schema: The framework for gathering and validating data to identify bot activity.
  • Bot patterns: Automated behaviors that mimic human actions, often used to commit ad fraud.
  • Site changes: Modifications to website code, design, or functionality that could affect bot detection.
  • False positive: A legitimate user incorrectly flagged as a bot.
  • Cross-checking: Comparing multiple independent signals to confirm a conclusion.

Frequently Asked Questions

Why should I update my evidence collection schema regularly?

Regular updates help keep pace with evolving bot tactics. Without them, your detection system may miss new fraud, leading to wasted ad spend. Bots change quickly, and your schema must change too.

How do I know if new bot patterns have emerged?

Monitor your ad metrics for anomalies like sudden spikes in clicks without conversions, or review audit reports from tools like BotRefund that highlight unusual behaviors. Also, watch for feedback from ad platforms about rejected claims.

What does it cost to update an evidence collection schema?

Costs vary based on your system. Using BotRefund starts with a free bot audit; subsequent updates may involve technical time, but the service itself is designed for quick integration. The main cost is usually developer hours.

Should I compare different evidence collection tools before updating?

Yes, compare tools based on their detection methods, ease of integration, and support for ad platforms. For example, BotRefund focuses on behavior-based checks and refund claims. Look for tools that offer multiple independent checks and high accuracy.

Can I update my schema without downtime?

Many updates can be rolled out gradually. Test changes in a staging environment first to ensure they don't disrupt data collection. You can also use feature flags to enable new checks for a subset of traffic.

How often should I review my evidence collection schema?

Review it quarterly or after any major site change. Set a schedule to avoid missing critical updates. If you run high-budget campaigns, consider monthly reviews.

What are the risks of not updating my schema?

You may miss new bot tactics, leading to more invalid clicks and wasted ad spend. Your refund claims may be rejected due to insufficient evidence. Over time, your detection accuracy drops, and you lose money.

For more detailed help, consider a free bot audit to assess your current evidence collection needs.

Further reading and comparison sources

These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.

Further reading and comparison sources

These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.

Learn more

Visit the website for more information.

Learn more