Ads & AI analysis
Analyze your ads
Once your ads are uploaded, adfit analyzes each file with AI: it extracts who the ad targets, what it promises and how it speaks, and suggests personalizations for your site. This guide covers starting an analysis, reading the results, re-analyzing, retrying failures, and the limits that apply.
Before you start
The analysis matches your ads against your actual website, so adfit needs to have seen your site first. adfit now asks you to connect your site before you upload ads at all: once your snippet is installed and adfit has found at least one page, both uploading and analysis unlock. Until then, the Ads section shows a note and the analyze buttons stay disabled.
- Install the snippet on your site.
- Verify your connection: once the site is Connected and adfit has seen a page, analysis unlocks on its own.
On a paused site in an account that has more sites than your plan includes, you can still upload ad files, but the analysis is locked. See Paused sites and AI features for how to unlock it.
Start an analysis
In the Ads section, every uploaded ad has an Analyze button in its row. To analyze everything at once, use Analyze all in the header of the ads list: it covers every ad that is waiting to be analyzed and every ad whose last analysis failed. A file adfit cannot read is left out: see When adfit cannot read the file. If one of these ads was analyzed before, the dialog asks for a short note first.
Both buttons open the same short dialog, Pick the pages adfit should personalize for this ad. You choose the target pages there, not at upload time, so you can upload first and decide later. When you start several ads at once, the dialog says so plainly: This applies to all {n} ads. Some pages stay out of reach: they appear disabled with the reason next to them. See Pages you cannot pick.
The dialog also tells you what the run costs before you start it, in plain numbers: This uses {n} AI tasks. One AI task per ad, and target pages cost nothing here. If this is the first analysis of your site, a second line adds Plus 1 for the first analysis of your site. And if the run does not fit into what is left, adfit says how much is left before you confirm: You have {n} AI tasks available right now.
Main page and the automatic draft
If two or more of the pages you picked can be the main page, a field Main page appears under the list, and the page it names carries the badge Main page in the list. adfit starts with the first of those pages you ticked (on a re-analysis, with the main page you used last), and you can change it at any time. With one page, that page is the main page and there is no field. Your start page appears as Homepage (/) in the list and in the field.
Under the field adfit says adfit creates a draft for this page as part of the analysis when it finds changes that fit the page. That draft costs nothing extra. The other pages you picked are not personalized yet: Extending a draft to them later uses 1 AI task per page. You take that second step whenever you like, from the draft (Extend to {n} more pages) or from Extend to other pages.
The main page must be analyzed
Only a page adfit has analyzed can be the main page, because adfit writes the draft from what it knows about that page. In the list, a page you picked that cannot be the main page says why, for example adfit has not analyzed this page yet, so it cannot be the main page. or adfit has not read this page yet, so it cannot be the main page. Under that sentence you find the way forward: To analyze it, open the page in Pages & elements and use "Ask adfit for ideas". This uses 1 AI task. If adfit finds changes, it saves them as a separate draft. For a page adfit has not read yet, it is Open the page once on your site with the snippet installed. Then open it in Pages & elements and use "Ask adfit for ideas". This uses 1 AI task.
Pages that look like checkout, cart, account, login, or legal pages can never be the main page: This page looks like a checkout, cart, account, login, or legal page, so it cannot be the main page. Such a page has no way forward, because adfit never changes it.
If none of the pages you picked can be the main page, Analyze stays off and the dialog says why: adfit has not analyzed the pages you picked yet, so none of them can be the main page. If one of them is a page that can never be the main page, it says None of the pages you picked can be the main page. Each page shows the reason. The way out: To analyze this ad now, also pick a page adfit has analyzed. If the page you chose as the main page stops being available while the dialog is open, adfit starts nothing and says adfit cannot use the main page you picked. The list now shows why. Check your selection, then try again. The list then shows the reason at the page.
The first analysis of a new site
One exception: if adfit has never analyzed your site, no page can be the main page yet, so nothing is locked. adfit schedules the analysis of your site first and your ad analysis follows it, and the dialog says so: adfit analyzes your site first. If that analysis does not include the main page, adfit creates no draft and tells you why.
That site analysis uses 1 AI task of its own, on top of one per ad. When your remaining AI tasks do not cover the site analysis and at least one ad, Analyze stays off with the reason Not enough AI tasks left for the first analysis of your site and this ad. (or Not enough AI tasks left for the first analysis of your site and these ads. for several ads). If a run has more ads than fit, adfit analyzes as many as still fit and tells you that an AI task is reserved for the first analysis of your site. See When the quota is reached and Site analysis.
If the main page is no longer available when the analysis of the ad is about to start (for example because the page was blocked in the meantime), adfit stops before it analyzes the ad, and that costs you no AI task. The ad shows The main page of this ad is no longer available, so adfit stopped before analyzing the ad. Use "Retry analysis" and pick another main page.
When the analysis is done, adfit says what it wrote, for example Your personalization is ready on /pricing. with Open draft, or Review drafts when there are several. The draft carries the mark Awaiting approval, and nothing goes live until you publish it: see Keep or discard a draft. A site can hold up to 100 drafts. When it is full, adfit creates no draft and says so in the message, and the suggestion shows Not created on the ad. Delete a draft you do not need, then create it from the ad.
A finished analysis does not always end with a draft. When adfit creates none, the message says why in one sentence, for example adfit created no draft because it did not suggest changes for /pricing. The ad itself is analyzed either way, and you can create a personalization from any suggestion yourself: see Create one from a suggestion.
While analyses run, a small status card shows the progress. It sits at the bottom right of the window (along the bottom edge on a phone) and follows you through the app. It names the step, for example Reading your site or Analyzing your ads: 2 of 5 done, with a running clock, and after two minutes it adds This can take a few minutes. Analyses run a few at a time; the rest wait as Queued and start automatically, and Cancel queued stops the ones that have not started. Details lists every task. Most files finish within a minute or two, and the page updates on its own: no reload needed.
This same card is shared by every AI task in adfit, not just analyses. When a task finishes, adfit tells you what it found with a link straight to the result, for example Your site analysis is ready. with View analysis. If the tab was in the background, the message waits in the card. Several tasks finishing together collapse into {n} tasks finished. with a link to the details.
When a task fails and nothing else is running, the card says so, for example 1 task failed. Choose Dismiss to close it. adfit does not remember that you closed it: after you reload the page the card comes back for as long as the failure is younger than 24 hours. A new failure brings the card back right away.
Each ad moves through these statuses:
- Uploaded: the file is stored and ready. It's your move: start the analysis whenever you like.
- Queued: the analysis is requested and waiting its turn.
- Analyzing: the AI is reading the file right now.
- Analyzed: the results are ready. Open View analysis or click the file name to see them.
- Failed: something went wrong. See Failed analyses below.
Pages you cannot pick
The list shows the pages adfit knows about. Legal pages are never collected, so they do not appear in it. A few of the listed pages cannot be chosen as a target. Their checkbox is off and the row names the reason:
- Pages whose address looks like checkout, cart, account, or login, such as order or payment pages: adfit never changes them.
- Pages you told adfit not to collect. Turn collecting back on in Pages.
- Pages adfit tried to read and could not: the page is empty, does not answer, or redirects somewhere else. Open the page once with the snippet installed, or check its address in Pages. Once adfit can read it, the page can be picked.
A page adfit has not read yet can still be picked. If the ad has no saved choice yet, adfit preselects one page for you. It prefers a page it has already read: the home page if that is one of them, otherwise the page with the shortest address. If adfit has read none of them, it applies the same rule to all pages you can pick.
If no page in the list can be picked, the start button stays off and the dialog offers a Go to pages link with the line None of these pages can be selected. Each page shows the reason. If a page you ticked becomes unavailable while the dialog is open, adfit starts nothing and says At least one page you picked can no longer be selected. The list now shows why. Check your selection, then try again.
What the analysis contains
Open an analyzed ad to see its results. For each ad, adfit shows a Summary card and a set of suggested personalizations:
- Summary: what the ad is about, in one short paragraph.
- Audience: who the ad targets.
- Promise: the core benefit or claim the ad makes.
- Tone: how the ad speaks (for example playful, urgent or professional).
- Persona traits: characteristics of the person the ad is written for.
- Suggested personalizations: concrete ideas for your site. Each one names the visitor group it speaks to, the hook it leads with, and suggested text changes for your pages, with a short rationale.
adfit writes in your site's language. It reads the language setting of your page and checks it against your page texts. When the texts are clearly in another language, for example a German page with an English theme default, adfit follows the texts. Setting your site's language correctly still helps screen readers and search engines. The field labels stay in English.
Turn a suggestion into a personalization
Every suggested personalization has a Create personalization button. Press it and adfit creates a draft you can review and publish: see Create one from a suggestion.
See what an ad led to
Once you create personalizations from an ad, its row in the ads list shows them, so an analyzed ad is never a dead end. Under the file details you will see the linked persona and a chip for each personalization created from that ad. Click a chip to open that personalization; if there are several, adfit shows the first couple and a +{n} more count for the rest.
The persona appears as Persona: {name}. If the ad is linked to more than one persona, adfit shows the number of personas instead of a name. An ad with no personalizations yet shows no extra line: create one from a suggestion to get started (see Create one from a suggestion). From the ads list you can also open any of them straight from Landing pages once they are live.
Link an ad to a persona you already have
When adfit analyzes an ad, it also suggests a persona for it. If you would rather use a persona you have already built, you can link the ad to it instead. This is a relabel, not a new analysis: adfit reuses the persona you pick, so it costs nothing and uses no AI.
Create a personalization first
The link applies to a personalization, so create one from a suggestion first (see Create one from a suggestion). Until then, Link to existing persona stays disabled with the hint Create a personalization first.
Link to an existing persona
On the ad's Summary card, press Link to existing persona and choose one of your personas. adfit uses that persona instead of the one it suggested, and shows Linked to the persona you picked.
adfit's own suggestion is not lost: it moves under adfit's suggested persona, where you can expand it any time. Press Switch back to return to it. To build a persona first, see Personas.
One file, several ads
A single file can contain more than one ad. This is common with CSV or XLSX exports from your ads platform (for example a Google Ads export with several ad groups). adfit detects the individual ads and analyzes each one separately: the detail page then shows one section per ad (“Ad 1 of 3”, and so on), each with its own summary and suggestions.
Variants of the same message (for example three headlines for one campaign) are treated as one ad, not three.
Up to 12 ads per file
One file can hold up to 12 ads. If a file contains more, adfit stops before it starts and tells you: This file contains more than 12 ads. Split it into files with up to 12 ads each, then upload them again. Nothing is analyzed in that case, so the run costs you no AI task.
When adfit could not read every ad in the file
Occasionally adfit reads a multi-ad file but comes back with fewer ads than the file actually holds. When that happens, adfit says so plainly: adfit analyzed {x} of {y} ads in this file. Upload the missing ad again as its own file to analyze it. The run still counts as just 1 AI task.
Re-analyze an ad
If an analysis isn't quite right, you can run it again. On an analyzed ad, press Re-analyze. One dialog asks for both things at once: a short note, What should adfit focus on this time?, so adfit knows what to change, and the pages it should personalize. The note is required: the button stays disabled until you add one.
A re-analysis also replaces the drafts adfit wrote from this ad earlier, as long as you have not changed or kept them. The dialog says so before you confirm: The new analysis replaces 1 draft from this ad that you have not changed or kept. Drafts you changed, kept, or published stay.
Your note guides this run only. adfit does not store it, and the new analysis replaces the previous one. The very first analysis of an ad doesn't ask for a note, since there is nothing yet to build on.
Like the first run, a re-analysis uses one analysis from your monthly quota, with one exception: a run that comes back with nothing usually costs you nothing. See When a run comes back with nothing.
When an upload isn't an ad
adfit works best with the creatives and copy you actually run. If a file you upload isn't a usable ad for your site, adfit tells you plainly instead of inventing a result. On the ad you will see This image doesn't look like an ad for your site with a short explanation: Upload the ad your visitors clicked to reach this page. adfit personalizes your page to match that ad.
From there, press Back to ads to upload the right file, or Re-analyze if you think adfit got it wrong. No personalization is created from a file adfit can't use as an ad.
A rejected file usually does not use up an analysis. The ad says what this run did:This analysis did not use an AI task. when it was free, or This analysis used 1 AI task. when it counted. The same limits as for any other empty run apply, so a file that keeps coming back rejected counts again from run number 3: see When a run comes back with nothing.
Failed analyses
If an analysis fails, the ad shows a Failed badge and the reason where adfit knows one. Use Retry analysis in the row or on the detail page to run it again; temporary hiccups usually succeed on the second attempt. The one exception is a file adfit cannot read (see When adfit cannot read the file): neither its row in the ads list nor its detail page offers Retry analysis, because a new attempt cannot help there. The row shows View details instead, and Analyze all leaves such a file out.
If a re-analysis fails, nothing is lost: the previous intact result stays visible below the error message until a new analysis replaces it.
For a file with a single ad (an image, a PDF, a text file, or a table with one ad), adfit tries once more on its own when the answer does not fit. If it still cannot finish, the ad shows adfit could not finish this analysis. Please try again. If your file contains many ads, split it into smaller files. Under the message, the failed analysis tells you what it cost, with This analysis did not use an AI task. or This analysis used 1 AI task.
When adfit cannot read the file
Some files cannot be opened at all: a file with no readable text, an Excel file that is damaged or unpacks to an unreasonable size, or a CSV file with a single line longer than 32,768 characters. In that case the ad shows adfit could not read this file. Export it again as CSV or Excel from your ad platform, then upload the new file. Trying the same file again cannot help, so export it again from your ad platform and upload the new file.
adfit stops before the AI starts in this case, so reading this file uses no AI task. If this was the first analysis of your site, the site analysis that runs along with it is counted on its own. The failed analysis states whether this analysis used an AI task.
Because Analyze all skips these files, it can find nothing to analyze when they are all that is left. The button then stays off and says Nothing left to analyze. Delete the ad adfit cannot read, then upload a new file. for one such file, or Nothing left to analyze. Delete the ads adfit cannot read, then upload new files. for several. The same sentence appears if you start an analysis from the dialog after every ad you sent turned out to be unreadable. Nothing is analyzed and nothing is used up in that case.
When adfit cannot work with the content
Now and then the AI stops without a result because it cannot work with what is in a file. The ad then shows adfit could not work with the content of this file. Try a different file. adfit does not retry such a file on its own, and running the same file again may end the same way, so upload a different file instead.
This run is usually free, up to your site's monthly allowance of free runs. Under the message, the failed analysis tells you which it was: This analysis did not use an AI task. or This analysis used 1 AI task. The same limits as for any other empty run apply, so a file that keeps ending this way counts again from run number 3: see When a run comes back with nothing.
Your monthly analysis quota
Every site has a monthly quota of AI analyses, depending on your plan. The header of the ads list shows a live counter (for example 8 of 50 analyses this month).
What counts toward the quota
- Every ad analysis you start, including re-analyses of the same ad. One ad, one analysis: the target pages you pick in the dialog cost nothing on top.
- Site analyses you start, including the first one that runs automatically with your first ad analysis: see Site analysis.
- Every page you extend a personalization to: one page, one AI task. See Extend to other pages.
What does not count
- The weekly automatic site re-analysis. adfit starts it, so adfit pays for it.
- An analysis that fails before the AI could process your file, and a file with more than 12 ads, which stops before the first AI call.
- A file adfit cannot use as an ad for your site. You get the honest answer and keep your analysis: see When an upload isn't an ad.
- A file with a single ad where the AI's answer still does not fit after adfit tried once more on its own (see Failed analyses), within the limits below. If that second try fails for another reason, the analysis counts like any other. The one exception is a file adfit could not work with: see When adfit cannot work with the content.
- A file adfit could not work with at all, within the limits below: see When adfit cannot work with the content.
- A run that comes back with nothing, within the limits below.
When a run comes back with nothing
For ad analysis, a run is usually free in three cases. The first is a file adfit cannot read as an ad for your site: see When an upload isn't an ad below. The second is a file with a single ad where the AI's answer still does not fit after adfit tried once more on its own: see Failed analyses. The third is a file adfit could not work with at all: see When adfit cannot work with the content. A usable ad that is analyzed is always billed, even if adfit ends up suggesting only small changes or none, because the analysis itself already ran.
Free means free up to your site's monthly allowance of free runs, never without a limit, and adfit tells you before it changes. Two limits apply. For a rejected file and for a file adfit could not work with, a repeat counter runs per file: if the same file keeps ending that way, run number 3 counts again. A single-ad file that adfit could not finish has no repeat counter, only the second limit: a site has a monthly allowance of free runs, shared by every free case. Once it is used up, further rejected, unfinished or unprocessed files count like any other.
Before you start, the dialog shows how many AI tasks the analysis uses. While the next rejected file would still be free, it adds: If adfit cannot read a file as an ad for your site, that run is free.. Once the next rejected file would count against your AI tasks, it shows a warning instead: adfit could not read this file as an ad for your site in the last 2 runs. The next run will count against your AI tasks..
When the quota is reached
The quota resets at the start of each calendar month. When a site has used its quota, the analyze buttons pause until then; uploading is not affected. If you started Analyze all with more ads than the remaining quota allows, adfit analyzes as many as still fit (oldest first) and tells you how many were skipped.
On Starter, upgrading to Growth raises the quota from 30 to 50 analyses per site each month: see Plans & pricing.
When your account has used its monthly AI tasks
The quota above is per site. If your account has more sites than your plan includes, for example after you moved to a smaller plan and kept your other sites, adfit also counts AI tasks across the whole account. The account can use as many tasks as the sites your plan includes would have together: on Starter, 1 site with 30 tasks. Accounts within their plan's site count are not affected.
Once the account has used them, you see Your account has used this month's AI tasks for the sites in your plan. in the callout above your ads, in the tooltip of the paused analyze buttons, in the cost box of the analyze and persona dialogs and on the AI tasks left card of the Overview. This happens even when this site still has tasks left, and it ends when the month resets.
- Manage sites opens your Sites list.
- Upgrade plan is offered when a larger plan is available. A larger plan includes more sites, which raises or removes this limit. Where the larger plan is arranged with us, the button reads Contact us instead.
The daily AI budget
On top of the monthly quota, a daily safety limit caps the total amount of AI work per account and day. It exists to protect you from runaway costs and is generous enough that normal use never touches it. If your analyses do reach it, they stop with the message “Daily AI budget reached. Analyses continue tomorrow.”
Nothing is lost: the affected ads simply show Failed with that message, and you can retry them the next day.