Ad Creative Change Tracker — Delta & Longevity Engine (Vigia)

Turn your own ad exports into competitive intelligence — pay only for real creative changes.

Feed Vigia the ad data you already have (from Meta Ads Library, Google Ads Transparency Center, your own exports, or any source you're authorized to use) and get back only what changed: new creatives, changed copy/landing pages, and ended ads — plus which creatives have been running long enough to be a proven winner.

Why choose Vigia

• Only changes, only charged for changes — most ad trackers bill per ad extracted whether it changed or not. Vigia's ended ads are free, and unchanged ads generate nothing.
• "Long-running creative" signal — in monitor mode Vigia tracks how many runs each creative has survived and flags long_running_creative. A creative still live after 5+ checks is a proven winner, not a test — the same intelligence ad-spy tools charge extra for.
• Ended-ad longevity — when a creative finally rotates out, Vigia tells you how long it ran (runs_seen), so you know if your competitor's campaigns are fast-testing or committed.
• Aggregate signal — each run returns an ad_signal: new/changed/ended counts, how many long-running creatives are currently live, and the single longest-running creative that just ended.
• Fair pricing — hard maxTotalChargeUsd cap; never billed without a result.

Honest positioning

This actor does not scrape Meta, Google, or TikTok itself — it's a delta and longevity engine over ad data you already have (your own export, or output from a licensed ad-library actor). If you need the raw ad fetch too, chain this actor after a dedicated ad-library scraper, the same pattern Vigia uses for its SERP rank tracker.

Input

• currentAds / previousAds — your ad records (ad_id, creative, landing_url, ...).
• monitorEnabled / monitorId — persistent delta mode; first run is a free baseline.
• maxTotalChargeUsd — hard spend cap.

Output

One row per change: change_type (new/changed/ended), record_id, creative_fingerprint, runs_seen, long_running_creative. Plus a RUN_SUMMARY.json with the aggregate ad_signal.

FAQ

Does this actor fetch ads from Facebook/Google itself? No — see Honest positioning above. Why two separate change types (new vs changed)? So you can tell a brand-new campaign from a copy tweak on an existing one. Is monitor mode required? No, but without it you lose the longevity signal (runs_seen, long_running_creative), which needs history across runs.