Apple Ads change history: see every bid, budget and status change on your charts
See every Apple Ads change on your charts and in Logs: bids, budgets and pauses, who made them, old and new values, even changes from the Apple Ads website.
Updated 8 min readView as Markdown
Short answer
AdsKitty shows your Apple Ads change history in two places. A small marker under each campaign, ad group and keyword chart shows the days something changed; hover over it to see what changed, who changed it and the old and new values, such as Max CPT $1.60 → $1.85. The Logs tab lists every change as a table. It includes changes made in AdsKitty and changes made anywhere else, such as on the Apple Ads website or by another API tool, read from Apple's change history: the last 90 days when you connect, then with every sync.
On this page
What Apple Ads change history is
Change history is a record of every change made to your Apple Ads campaigns: a bid raised, a budget lowered, a keyword paused, an ad group added. Each entry says what changed, who changed it, when, and the old and new values, such as "Max CPT $1.60 → $1.85".
In AdsKitty you see it in two places:
- On the charts. A small marker under a chart shows each day something changed. Hover over it and the details appear next to that day's numbers.
- In Logs. A table of every change, newest first, on each campaign, ad group and keyword page, and for the whole app.
Seeing changes next to your numbers is what makes them useful. When spend, installs or cost per acquisition move, the first question is usually "what did we change?", and the answer is right there on the same chart.
How to see changes on your Apple Ads charts
- Open a campaign, from Campaigns (manual or managed).
- Look under the chart. Each small marker is a day with at least one change.
- Hover over a marker, or move through the days with the arrow keys. The tooltip shows that day's value and lists its changes, such as
Apple Ads website: Change keyword "calorie", Max CPT $1.25 → $1.40. - Pick another metric from the chart's menu, such as installs, CPA or TTR. The markers stay, so you can check any number against the same changes.
- Open View as table under the chart for every day's numbers with a Changes column, which is easier to scan than hovering.
The markers stay when you group the chart by week or month: a week's marker covers every change in that week.
Busy days are grouped
A day with many changes would make a long tooltip, so changes of the same kind by the same person or tool are grouped, such as "Apple Ads website: 12 keywords changed". A tooltip lists a few lines and counts the rest, and the table under the chart lists them all. The Logs tab shows every change on its own row.
Change history for campaigns, ad groups and keywords
Every level has its own chart and its own Logs tab:
| Page | Its chart and Logs show |
|---|---|
| Campaign | Changes to the campaign, its ad groups and their keywords |
| Ad group | Changes to the ad group and its keywords |
| Keyword | Changes to that keyword only |
| App (the Logs page in the menu) | Every change to the app's campaigns, ad groups and keywords |
So a keyword's chart answers "what happened to this keyword?", while the campaign's chart shows everything that could have moved the campaign's numbers. Open an ad group or keyword from the tables on a campaign page to get its own chart.
What the Logs tab shows
Each row of Logs is one change, newest first:
| Column | What it holds |
|---|---|
| Time (UTC) | When the change was made |
| By | Who made it (see who made a change) |
| Action | Such as Set max CPT, Pause, Enable or Change |
| Type | Campaign, ad group, keyword or negative keyword |
| Name | The campaign, ad group or keyword |
| Change | The old and new values, such as "$1.95 → $1.70" or "Active → Paused" |
| Result | Done, or Failed with the reason, for changes made in AdsKitty |
The filter box above the table finds rows by name, and takes ^ for not, | for or and & for and, as the other tables do. A change that failed stays in Logs with its reason, but isn't marked on the charts, because nothing changed in Apple Ads.
Who made a change
The By column, and the start of each line in a chart's tooltip, says where a change came from:
- A person's name: someone in your workspace made it in AdsKitty.
- AdsKitty manager: the nightly manager made it on a managed campaign. Logs say what it changed, such as a bid or a paused keyword.
- Apple Ads website: someone made it in the Apple Ads interface.
- Another API tool: another app or script connected to your Apple Ads account through the API made it.
- Apple support: Apple's support team made it.
This is what makes the history complete. Changes made outside AdsKitty, by a colleague on the Apple Ads website or by another tool, show up on the same charts and in the same Logs as changes made in AdsKitty.
Where the history comes from
AdsKitty puts two sources together:
- Its own log. Every change you or the nightly manager make in AdsKitty is recorded as it happens, with its result.
- Apple's change history. Apple Ads keeps a history of changes for each ad account, and AdsKitty reads it through the Apple Ads API. That's where changes made on the Apple Ads website, by other tools and by Apple support come from.
AdsKitty's own changes are in Apple's history too, because AdsKitty makes them through the API. Each one is matched to AdsKitty's record of it, so it's shown once, under the name of whoever made it, not twice.
How far back it goes, and when it updates
- When you connect an Apple Ads account, AdsKitty reads the last 90 days of Apple's change history.
- After that, every sync reads what's new. Syncs run on their own through the day, and Sync now on the Apple Ads page starts one straight away.
- Changes made in AdsKitty appear in Logs at once. Changes made elsewhere appear after the next sync.
- Times in Logs and the days on the charts are in UTC, like the rest of AdsKitty's numbers.
Using change history when your numbers move
When a number jumps or drops, change history helps you find out why:
- Find the day it moved. Switch the chart to the metric that changed, such as spend or CPA, and hover over the days around the jump.
- Look for markers just before it. A bid raised, a budget lowered or a keyword paused a day or two earlier is the first thing to check. Apple Ads results often take a few days to settle after a change.
- Go one level down. If the campaign's chart has several changes that day, open the ad group or keyword and check its own chart.
- Check changes made elsewhere. If nobody in your team changed anything in AdsKitty, look for "Apple Ads website" or "Another API tool" in Logs.
A change before a jump doesn't prove it caused it: auctions, competitors and seasons move numbers too. But knowing exactly what changed, and when, turns guessing into checking.
Frequently asked questions
Does AdsKitty show changes made on the Apple Ads website?
Yes. AdsKitty reads Apple's change history for each connected ad account, so changes made in the Apple Ads interface show on the charts and in Logs as "Apple Ads website", after the next sync.
How far back does the change history go?
When you connect an account, AdsKitty reads the last 90 days of Apple's change history. From then on it keeps every change it reads, and adds new ones with each sync.
Why does a change show only once when AdsKitty made it?
AdsKitty's changes are in Apple's history too, because they're made through the Apple Ads API. AdsKitty matches each of them to its own record, so the change appears once, under the name of whoever made it.
Does change history work for managed and manual campaigns?
Yes. Both have charts with change markers and a Logs tab, on the campaign, ad group and keyword pages. On managed campaigns, Logs show what the nightly manager changed.
Are changes shown in my time zone?
No. Like all of AdsKitty's charts and reports, Logs and chart days use UTC, so a change made late in the evening in your time zone may appear on the next day.
Why isn't a change I just made on the Apple Ads website showing yet?
Changes made outside AdsKitty arrive with the next sync. Press Sync now on the Apple Ads page to read them straight away.