This guide is written for someone who has never opened Orova. Every part explains the concept first, then the steps.
Orova Ads lives inside a workspace — the shared space for you and your colleagues. The tab bar at the top has 5 items: Projects, Campaigns, Conversion API, Rule Set and History.
The order here matches the order you will work in: create a project, connect ad accounts, pull data in, read the campaign table, turn on AI, write a rule set, read recommendations, then wire up the conversion data path.
One principle runs through everything: you set the rules, AI follows them. For each action you decide whether AI may only advise, or may act on your behalf.
01 · What Orova Ads is
What Orova Ads is and what it solves
Read this part before you click anything. It tells you what the tool does, what it does not do, and what you need to have ready.
Paid ads
This is when you pay Google, Meta or TikTok to put your content in front of users. Each one has its own management site and its own numbers.
Orova Ads
This is where ad data from all three platforms lands in a single table. It comes with an AI that reads that data against the goals you write out.
When you run ads in several places at once, you have to open three different management sites. Three interfaces, three naming systems, three sets of numbers that don't line up.
Every morning you add things up by hand just to know what you spent yesterday and how many orders you got. That takes time and it is easy to miss things.
Orova Ads does three things for you
- Brings everything into one table. Campaigns from Google Ads, Meta Ads and TikTok Ads sit in one list, with the same columns and the same date range.
- Lets AI read the data by your rules. You write your goals in plain words, AI compares the real numbers against those goals and recommends what to do.
- Sends order data back to the platforms. A platform can only find more customers like yours once it knows which orders were real.
What Orova Ads does NOT do
- It does not create ad accounts for you. You need an existing account on Google Ads, Meta or TikTok.
- It does not fund your ads. You still pay the platform directly for ad spend.
- It does not write your ad creative. Orova reads and adjusts the campaigns you already have.
Note
What to prepare first
Tip
02 · Screen tour
A tour of the screens
Five menu items and when each one is used. Knowing the map up front keeps the later steps simple.
Workspace
This is one company inside Orova. Every project, every quota and every member lives inside a workspace. Switching workspace switches all the data you see.
Hub
This is the main page after you sign in, where all Orova modules are listed. You enter Orova Ads from here.
Orova Ads has no separate overview page. Clicking the module takes you straight into Projects.
Open the module
- 1
Sign in and open the Hub. After signing in you are on the Hub. If you belong to several workspaces, pick the right one at the top of the page first.
- 2
Click the Orova Ads tile. The page switches to the module's
Projectssection. The module tabs sit in a bar across the top of the page, right under the header.
The five menu items of Orova Ads
| Menu item | What it is for | When you need it |
|---|---|---|
Projects | Create a project and connect ad accounts to it | At the start, and whenever you add a new account |
Campaigns | The combined data table for all three platforms, and the AI switch per campaign | Daily, when you check how things are going |
Conversion API | Wire up the data path that reports real orders back to the platforms | When you want the platforms to optimize more accurately |
Rule Set | Write your goals and choose which actions AI is allowed to take | Before you let AI run for the first time |
History | Run an analysis, read AI recommendations, review what was done | After every analysis run |
Note
Two names that are easy to mix up
Rule Set is the AI configuration page — inside the page, a few places still say assistant, it is the same thing. History is where you run an analysis and read recommendations — it is not just a log of past work.Note
03 · Create a project
Step 1 — Create a project
A project is the box that holds your ad accounts. Without a project you cannot connect any account.
Project
This is one website or one brand. A project groups several ad accounts from several platforms so you can view them together.
Project ID
This is the public code for the project, starting with prj_. You use this code when you configure the Conversion API later in this guide.
The rule for splitting projects is simple: each website or each brand is its own project.
Selling one product across three platforms is still one project with three ad accounts. Selling two different brands should be two projects, because their goals and numbers should not be mixed.
Create your first project
- 1
Open the Projects section. Click
Projectsin the tab bar at the top. If the workspace has no project yet, you see the lineNo projects yetwith a+ Create first projectbutton.
Open Projects - 2
Click Create new project. Click
+ Create first project, or theCreate new projectcard if you already have projects. There is no form. The project is created right away and the page opens the project detail screen — where you connect ad accounts in the next step.
Click Create new project - 3
Rename the project on its page. The new project starts with a default name. Click the name at the top of the project page to change it. Pick a name you will recognize later, for example the shop name plus the sales channel.
- 4
Go back to the list to check. Click
Projectsin the tab bar at the top. The project you just created is in the list, with theLinked accountscolumn at 0.
The new project shows in the list
| Button / field | What it means | Notes |
|---|---|---|
Search projects... | Filters the list by project name | Filters in place, the page does not reload |
Create new project | Creates a new project right away | It is the card with a plus sign at the start of the list |
+ Create first project | Creates the first project right away | Only shown when the workspace has no project yet |
Linked accounts | How many ad accounts are connected to the project | 0 means nothing is connected yet, so the campaign table will be empty |
Last updated | The last time the project changed | This is not the last data sync |
Project ID | The public code in the form prj_... | Used when configuring the Conversion API |
Edit | Opens the project detail screen | That is also where you connect and disconnect accounts |
Delete project | Removes the project from the workspace | There is a confirmation popup; deleting also disconnects every linked account |
Warning
Deleting a project cannot be undone
04 · Connect accounts
Step 2 — Connect your ad accounts
Give Orova permission to read and adjust the ad accounts you already own. Orova never holds your password.
Ad account
This is your real account on Google Ads, Meta or TikTok. Orova only reads and adjusts existing accounts, it does not create new ones.
Connecting (OAuth)
This is the standard way large platforms grant access. You sign in on the platform's own page, click allow, then come back to Orova. Orova receives an access pass, not your password.
You connect accounts on the project detail screen. Open Projects and click Edit on the project you want to connect.
Connect one platform
- 1
Open the Connect an ad platform block. At the top of the project detail screen there is a
Connect an ad platformblock with three cards: Google Ads, Meta Ads and TikTok Ads.
The three Connect buttons - 2
Click Connect on the card you need. Click
Connect. The browser leaves Orova and goes to that platform's own sign-in page. The address in the browser bar must be the platform's domain.
Click Connect on the platform you need - 3
Sign in and allow access. Sign in with an account that has admin access to the ad account. The permission screen lists everything Orova is asking for. Leave all of it checked and click allow — unchecking a permission can break syncing or adjustments.
- 4
Pick the accounts you want to connect. Once you allow access, you land back in Orova on the account selection screen. Tick each account, or click
Select all. ClickDeselect allif you want to start over. - 5
Click Connect selected accounts. Click
Connect selected accounts. The page returns to the project detail and the account table shows the rows you just connected. ClickingCancelon this screen connects nothing. - 6
Check the connected account table. The table has the
Platform,Account nameandConnected oncolumns. The correct status isConnected.
Connected accounts appear in the table
Note
You came back but the table is still empty
No accounts selected.. And if you granted access but have not picked accounts yet, the project shows a banner with a Select now → button that takes you back to the selection screen.The two states of an account
| Status | What it means | What you need to do |
|---|---|---|
Connected | The access pass is still valid and Orova can pull data | Nothing to do |
Connection error | The access pass expired, or you revoked access on the platform | Click Connect again on that platform card and grant access again |
Warning
Disconnecting
Disconnect button cuts the data path between Orova and that account. New data stops coming in and AI no longer acts on that account. To use it again you have to go through the whole permission flow once more.05 · Pull your data in
Step 3 — Pull your data in
Once accounts are connected, the campaign table stays empty until you run the first sync.
Sync
This is pulling data from the platform into Orova's own data store. When you open the table, Orova reads that store instead of asking the platform again.
This makes the table open very fast, even with many accounts. In exchange, the numbers you see are only current as of the last sync.
Before the first sync, the Campaigns section shows the line Never synced — click "Refresh" to pull in campaign data..
Run the first sync
- 1
Open the Campaigns section. Click
Campaignsin the tab bar at the top. If no account is connected, the page showsNo ad account connected yetwith aGo to Projects to connectbutton — go back to step 2 first.
Open Campaigns - 2
Click Refresh. Click the
Refreshbutton in the toolbar. Orova calls the platform and pulls data into the store. Wait until campaign rows appear in the table.
Click Refresh to pull fresh numbers - 3
Open the Sync management page. Click
Manage syncin the same toolbar. This is where you set the rules for every future data pull.
Storage and auto sync settings
| Button / field | What it means | Notes |
|---|---|---|
Keep data for | How long the store keeps data before clearing it | Extending this range makes Orova backfill the missing part automatically |
Default platform | The platform pre-selected when you open the campaign table | It only changes what you see first, it does not lock out other platforms |
Periodic auto update | Turn on so Orova pulls data on its own, with no clicking from you | Off means every update happens only when you click |
Update cycle | How often an automatic pull runs | Minimum 5 minutes per run |
Sync | Pull all data again right now | While it runs, the button changes to Running full sync… |
Last update | When the most recent data pull happened | Shows — none yet — when nothing has run |
Last full sync | When the most recent full pull happened | Use it to know how far back your data reaches |
Run a full sync
- 1
Click the Sync button. In the
Manual syncblock, clickSync. A progress popup appears almost immediately.
Click Sync for a full re-pull - 2
Feel free to leave the page. The popup says it clearly:
This may take a few minutes — feel free to keep working, the page updates itself when done.. The sync runs in the background, and closing the popup does not stop the data pull. - 3
Check the result. When it finishes, the popup changes to
Sync complete. If it showsSync didn't finish, please try again., clickSyncagain in a few minutes.
Note
A full sync takes a few minutes
Tip
Periodic auto update right away saves the most effort. You then only use the Refresh button when you need fresh numbers right that moment.06 · The campaign table
Step 4 — Read the Campaigns table
One table for all three platforms. This part explains every filter field and every metric column.
Campaign, Ad set, Ad
Three nested levels. The campaign sets the objective and the budget. The ad set defines who you target. The ad is the piece of creative the customer actually sees.
Results and Cost/result
Results is the action you want the customer to take: buy, leave their details, send a message. Cost/result is what you pay for each result.
The table reads from Orova's own data store and does not call the platform when you open the page. That is why the page always opens fast, and why the numbers are current as of the last sync.
Filters — seven fields
| Filter field | What it means | Notes |
|---|---|---|
Project | Show only campaigns in one project | All projects to view them together |
Platform | Filter by Google, Meta or TikTok | Leave empty to see all three combined |
Ad account | Filter by one specific ad account | All ad accounts is the default |
Status | All statuses, Active or Paused | Paused campaigns still carry their past data |
Objective | Filter by the campaign objective | Changing the objective changes the report columns with it |
Time range | Today, Yesterday, last 7 / 14 / 30 / 90 days, or Custom range… | With a custom range you fill in From date and To date |
Search by campaign name… | Quick search by name | Useful once the list gets long |
Clear filters | Drops every filter condition currently set | Use it when the table is empty and you are not sure why |
Note
Your filters are remembered
Campaigns you see those same filters, not the default state. If the table looks odd, click Clear filters.Default columns — what each one means
| Column | What it means | Notes |
|---|---|---|
Campaign name | The name you gave it on the platform | Click it to open the detail page |
Status | Active or paused | Taken from the platform |
AI | The switch that lets AI analyze this campaign | See step 5 |
Rule set | The rule set currently assigned to the campaign | Empty shows Not assigned |
Budget | The budget currently set | Daily or lifetime, depending on the campaign |
Spend | Money spent within the time range you filtered | Change the time range and the number changes |
Impressions | How many times the ad was shown | One person may see it several times |
Reach | How many different people saw it | Always lower than or equal to Impressions |
Frequency | How many times one person sees it on average | Very high usually signals a narrow audience |
Clicks | How many times the ad was clicked | — |
CTR | Clicks as a share of impressions | Measures how compelling the creative is |
CPC | Average money paid per click | — |
CPM | Money paid per 1,000 impressions | Measures the price of impressions |
Results | How many of the actions you want customers to take | Depends on the campaign objective |
Cost/result | Money paid per result | The column most often used to compare campaigns |
Conversions | Conversions recorded by the platform | — |
Conv. rate | Conversions as a share of clicks | — |
Cost/conv. | Money paid per conversion | — |
Conv. value | Total value of the conversions | You need this number to compute ROAS |
The Columns button — add columns per objective
Add columns
- 1
Click the Columns button. Click
Columnsin the toolbar. TheExtra columns for report:popup opens with a list of columns and checkboxes.
Click Columns - 2
Tick columns for the objective you are running. For sales, tick
ROAS,PurchasesandConv. value. For lead generation, tickLeads. For messaging, tickConversations. For video, tickVideo views (ThruPlay).
Tick the columns you need - 3
Save and look at the table again. Save the popup and the table redraws immediately with the new columns. Your choice is remembered for next time.

Save the column choice
Note
Google Ads has its own column set
Impr. share (Search), Lost IS (budget) and Lost IS (rank) column group turned on. The two lost impression share columns tell you whether you are losing out on budget or on ad quality.Tip
The table is wider than the screen
Going deeper — details and the three levels
Move down a level
- 1
Click the campaign name. Click
Campaign nameto open the detail page. The page has aMetric breakdowns · Last 30 daysblock with the Results, Spend, CTR and Cost/result columns.
Click a campaign name or Details - 2
Switch to a lower level. Use the level menu at the head of the table to switch between
Campaigns,Ad setsandAds. The table then shows the children of the rows you selected.
Switch to a lower level
Note
The table is empty even though accounts are connected
Clear filters, then pick the last 30 days and try again.07 · Turning AI on
Step 5 — Turn AI on for the right campaigns
The AI only reads campaigns you have switched on. Be selective so you save quota and keep things easy to follow.
Turning AI on for a campaign
This is how you tell Orova: the AI may read this campaign's numbers. Think of it as flagging the files you want your accountant to review. Campaigns that are off are skipped entirely.
Assigning a rule set
Every campaign with AI on needs to know which rules to follow. The rule set is that rulebook. With nothing assigned, the Rule set column shows Not assigned and the AI has nothing to work from.
This screen is the Campaigns table from the previous step. Here you do two more things: turn AI on and assign a rule set. Do it once per campaign and you are done.
| Button / field | What it means | Notes |
|---|---|---|
AI column | The on/off switch for AI on that row | It applies instantly, no save needed |
Rule set column | The rule set currently applied to the campaign | Empty shows Not assigned |
Select multiple | Shows a checkbox at the start of every row | Click again to leave selection mode |
Turn AI on | Turns AI on for every ticked row | Only appears once at least one row is ticked |
Turn AI off | Turns AI off for every ticked row | Once off, the AI stops reading that campaign |
Assign rule set… | Picks one rule set for every ticked row | The list comes from the Rule Set page |
Turn AI on for a campaign
- 1
Open the Campaigns table again. Click
Campaignsin the tab bar at the top. SetTime rangetoLast 30 daysso you can see a trend — do not pickToday. - 2
Pick campaigns worth switching on. Look at the
SpendandResultscolumns. Turn AI on for campaigns that spend steadily and that you genuinely care about. Paused campaigns can wait. - 3
Flip the AI switch on the row. Click the switch in the
AIcolumn of that row. The page saves by itself, no other button needed. Flipping this switch uses no quota.
Flip the AI switch on the row - 4
Turn several campaigns on at once. Click
Select multiplein the toolbar. Every row gains a checkbox. Tick the rows you want, then clickTurn AI on. The bar above shows how many rows are selected.
Tick several campaigns at once - 5
Assign a rule set to the selected rows. Keep the rows ticked, open
Assign rule set…and pick a rule set. If you have no rule set yet, do step 8 first, then come back here.
Assign a rule set to selected rows - 6
Check the Rule set column. Reload the page. The
Rule setcolumn should show a rule set name instead ofNot assigned. That tells you the campaign is ready for the AI to read.
Check the Rule set column
Tip
How many is enough
Note
When quota is charged
08 · Rule sets
Step 6 — Write a rule set for the AI
The rule set is where you pick a goal and decide what the AI checks and does for each kind of campaign.
Rule set
A named set of rules the AI follows when it reads your numbers. Each rule set has one goal and one or more optimization groups. You do not need to know how to code.
Optimization group
A group of rules for one kind of campaign — for example General (applies to all), Google · Search or Performance Max. Each rule in a group uses data variables and action codes.
Open this page from Rule Set in the tab bar at the top. The page lists your rule sets. The toolbar has Create new rule, Template store, Guide and a Filter by name… box. A few spots still call a rule set an assistant — same thing, do not let it confuse you.
Create a rule set
- 1
Open the Rule Set page. Click
Rule Setin the tab bar at the top. You see the list of rule sets you already have. Type inFilter by name…to find one fast. - 2
Look at the Template store first. Click
Template storeto see ready-made rule sets. Take one and edit it if it fits. ClickGuideto read how rules work. - 3
Click Create new rule. Click
Create new rule. The rule editor opens.
Click Create new rule - 4
Name the rule set. The name box sits at the top of the editor. Pick a name you will recognize in the
Rule setcolumn of the Campaigns table.
The rule editor - 5
Pick the Goal. Open the
Goalmenu and pick what matters most, for exampleMaximize conversions & leads. Other choices cover CPA/CPL, ROAS, traffic, brand awareness and budget.
Pick the goal for this rule - 6
Add optimization groups. Click
Add optimization groupand pick the kind of campaign:General (applies to all), Google · Search, Performance Max and more. In each group, clickAdd rule, then pick theData variablesandAction codesit uses.
Add optimization groups and set their actions - 7
Click Save rule. Click
Save rule. ClickCancelto leave without saving. If you leave with unsaved changes, the page asks before it discards them.
Click Save rule - 8
Choose a run mode. Back on the list page, click
Run mode. The popup has four options: off and run manually only, run when campaigns sync, run every N minutes, or run on a weekly schedule. For the weekly schedule, tick the days and set the time.
Choose a run mode
| Button / field | What it means | Notes |
|---|---|---|
Create new rule | Opens a blank rule editor | On the list page |
Template store | Ready-made rule sets to copy and edit | The quickest start |
Filter by name… | Filters the list by rule set name | Filters in place |
Goal | What the AI aims for, e.g. Maximize conversions & leads | One goal per rule set |
Add optimization group | Adds a group of rules for one kind of campaign | General (applies to all) covers every campaign |
Action codes | What a rule may do | GEXE/MEXE/TEXE = Orova acts itself; GADS/MADS/TADS = advisory only |
Save rule / Cancel | Save or leave the editor | Unsaved changes are flagged before you leave |
Run mode | When the AI starts an analysis run on its own | A popup on the list page; every run is charged to your quota |
Warning
Runs cost quota, writing rules does not
Run mode.Tip
Start small
History for a few weeks, then open up gradually.09 · Reviewing recommendations
Step 7 — Run an analysis and read the recommendations
History is where you ask the AI to read your numbers, and where every recommendation is kept. It is read-only: you read, then act.
Recommendation
One thing the AI advises you to do — raise a campaign's budget or pause an ad set, for example. Every recommendation states where it applies and why.
The Advisory label
Advisory means the AI only suggests. You make the change yourself on Google Ads, Meta or TikTok.
The menu item is called History. The toolbar at the top has Project, All accounts, Search history…, Clear history and Analyze with AI. There is no approve or dismiss button — the page only records.
Run an analysis
- 1
Pick the project to analyze. Choose a project in
Project. Each project is analyzed on its own run. To narrow further, pick one account instead ofAll accounts.
Pick the project to analyze - 2
Click Analyze with AI and pick a rule set. Click
Analyze with AI, then pick the rule set that will read the numbers. Use the one you assigned to your campaigns in step 5.
Choose which rule set analyzes - 3
Click Analyze. Click
Analyze. The screen shows how much quota the run costs before it starts.
Click Analyze (uses quota) - 4
Let it run in the background. The page shows a line saying the assistant is analyzing your project data. You can leave the page — the analysis keeps running. It usually takes from a few dozen seconds to a few minutes depending on how many campaigns there are.
- 5
Read the recommendation list. When it finishes, the new recommendations show in the list. Type in
Search history…to find an older one.
Read the recommendation list - 6
Read each recommendation. Each item shows the action, the data code, the location, the rule set, the
Advisorylabel, the change and the reason. Read the change and the reason, then decide whether to act on the platform.
Read the change and reason before deciding
| Part | What it means | Notes |
|---|---|---|
| Action | The kind of job the AI advises | Comes from the action codes in your rule set |
| Data code | The numbers the AI based its conclusion on | Use these when you want to verify it |
| Location | Where it applies: Platform, Camp., Ad set or Ad | That is the platform, the campaign, the ad set and the ad |
| Rule set | The rule set that produced this recommendation | Tells you which rules are running |
Advisory | The AI only suggests | You act on the platform yourself |
| Change + reason | What to change and why | Read both before you act |
Warning
History changes nothing on the platform
History changes nothing. You still have to go into Google Ads, Meta or TikTok and do it yourself.Warning
Clearing the history cannot be undone
Clear history wipes the project's recommendation history. There is no way to get it back. Only click it when you are sure you will never need the old numbers.Note
When the AI recommends nothing
10 · Conversion API
Step 8 — Report real orders back to the platforms
Conversion API lets you send real orders back to Google, Meta and TikTok so the platforms can find more customers like those.
Conversion API
The pipe you use to tell a platform that an order was real. Only when a platform knows who bought can it learn how to find more people like them.
Webhook and secret key
The webhook is your own address. Your sales system or CRM sends order data to it. The secret key is a second lock, sent along in the X-Orova-Secret header.
Pixel, Conversion Action, Custom Audience
These are where your data lands on the platform side. Meta and TikTok call it a Pixel; Google calls it a Conversion Action. A Custom Audience is a customer list used to exclude or retarget.
This part needs whoever maintains your website or sales system. You collect the address and the key here, then hand them over. The configuration is set per project.
Set up the Conversion API
- 1
Open Conversion API. Click
Conversion APIin the tab bar at the top. The page opens with a project picker at the top and three platform blocks below it.
Open Conversion API - 2
Pick the right project. Every project has its own webhook address. Pick the wrong one and your orders land in the wrong place. If the workspace has no project yet, the page says so and you need to create one first.

Pick the right project - 3
Copy the webhook address. The
Data receiving addressblock shows a long URL. Click to copy it and pass it to whoever builds your website. That is where your system sends order data.
Copy the webhook address - 4
Generate a secret key. Click the generate button in the
Secret keyfield. The key is shown once, so copy it and store it safely. Your developer sends this key with every call, in theX-Orova-Secretheader.
Generate and keep the secret key - 5
Set up the Meta block. Pick the target Pixel and set the conversion source to Website or Offline. Switch on
Enable sending conversions. To sync customer lists as well, also switch onEnable audience sync.
Set up the Meta block - 6
Set up the Google block. Pick the target
Conversion Actionin the offline conversions block. TheAudiences (Customer Match)block is for pushing customer lists to Google.
Set up the Google block - 7
Review the TikTok block. The TikTok block covers conversions through the Events API and Custom Audiences. This part is waiting on TikTok permission approval, and the screen states the status.

Review the TikTok block - 8
Send a test. Click
Send testto fire a dummy event. Enter a test email if you like. Meta adds aTest event codefield so you can cross-check it in Test Events.
Click Send test - 9
Read the recent send log. Scroll to the bottom of the page. The log table has the Time (UTC), Platform, Event, Match key, Status and Details columns. Statuses are
Received,Sent,SkippedandError.
Open History to read the send log
Your system sends a data package to the webhook. Below are the fields most commonly used — handing this table to your developer is enough.
| Button / field | What it means | Notes |
|---|---|---|
event_name | The event name, for example a purchase or a lead | Must be one of the nine events listed below |
email / phone | The customer's email and phone number | At least one is needed for the platform to match the person |
order_id | Your own order reference | Prevents the same order being counted twice |
value / currency | The order value and its currency | Needed on purchase events if you want ROAS |
gclid | Google's click tracking id | Without it Google cannot tell which ad drove the order |
fbc / fbp | Meta's tracking ids | Read them from the cookies on your website |
ttclid | TikTok's click tracking id | The same idea as gclid, but for TikTok |
platform | Send to one specific platform | Leave it out to follow whatever configuration is switched on |
target | A specific destination | Use it when one project has several destinations |
event_source_url | The page where the event happened | Helps the platform match the source |
Purchase(a completed order) andLead(a potential customer) — the two most used events.AddToCart,InitiateCheckout,CompleteRegistration— the steps before an order closes.ViewContent,Contact,Schedule,Subscribe— other signals of interest.
Warning
Issuing a new address kills the old one immediately
Issue new address and the old webhook address dies on the spot. Every order sent to the old address is lost. Only do it if the address leaked, and tell your developer to switch straight away.Note
No connected account means an empty list
11 · Quota & roles
Quota, roles and language
No feature is locked behind a plan. Every account gets everything; plans differ only in how much quota you have.
Quota
The number of AI runs your workspace has left. Every time the AI reads your numbers it is charged against that balance. The remaining amount sits in the top bar and is shown before you click run.
Roles
Every member belongs to a role group. If a group has not been given a menu item, that item disappears from their menu. That is a setting, not a bug.
Orova Ads shares one quota wallet with the other modules in the same workspace. Orova takes no percentage of your ad budget.
| Button / field | What it means | Notes |
|---|---|---|
| Creating projects, connecting accounts | No quota | Do as much as you like |
| Syncing, filtering, reading the numbers | No quota | View it as often as you want |
Flipping the AI switch on or off | No quota | It is only a flag |
| Writing and saving a rule set | No quota | Free |
Analyze with AI | Costs quota on every run | The figure is shown before you confirm |
Runs triggered by Run mode | Costs quota on every run | A scheduled run counts the same as a manual one |
| The AI avatar generation button | Costs quota | Uploading your own image costs nothing |
Warning
Running low and running out
Note
A colleague does not see all five menu items
Tip
Changing language
12 · FAQ
Frequently asked questions and common errors
Thirteen situations new users run into in Orova Ads, with the cause and the fix.
The screen says `No ad accounts connected`.
Cause: the project has no connected account, or the table is filtered to a different project. Fix: click Go to Projects to connect and connect an account; if you already did, check the Project filter on the Campaigns table.
The Campaigns table says it has never been synced.
Cause: Orova has not pulled any numbers from the platform yet. Fix: click Refresh in the toolbar, or open Sync management and click Sync. The first run can take a few minutes.
The account is connected but the table is still empty.
Common causes: the Time range is too narrow, the status or platform filter is wrong, or the sync run has not finished. Fix: click Clear filters, choose Last 30 days again, then wait for the sync to finish and reload the page.
The accounts table shows the `Connection error` status.
Cause: the access has expired, or you changed your password or revoked the permission on the platform. Fix: open the project detail, reconnect that platform card and grant access again. Your existing numbers stay untouched.
Running an analysis says the rule set is not assigned to any campaign.
Cause: no campaign in the project has both AI switched on and this rule set assigned. Fix: go back to the Campaigns table, switch AI on for a few campaigns, then use Select multiple and Assign rule set… to assign that rule set.
The screen says the workspace is out of quota.
Cause: the workspace quota wallet hit zero, so the analysis run is blocked. Fix: top up your quota and run it again. While you wait you can still view your existing numbers and still edit rule sets.
It says the last analysis run did not complete.
Cause: usually a temporary overload at the AI provider, not a problem with your data. Fix: wait a few minutes and click Analyze with AI again. If it keeps failing, let Orova know.
The AI finished but produced no recommendations.
Cause: the assistant found no clear optimization opportunity — your numbers are fine against the goals you set. That is a normal result. To make the AI look harder, add sharper rules to the rule set, or wait a few more days for data.
A recommendation is in History but nothing changed on the platform.
Cause: History is read-only, and a recommendation with the Advisory label only suggests. Fix: make the change on the platform yourself; to let Orova act, use an auto-execute action code (GEXE/MEXE/TEXE) in the rule set.
The Conversion API webhook returns an error.
Three common causes: the payload has neither an email nor a phone number; the secret key in the X-Orova-Secret header is missing or wrong; the event name is not one of the nine accepted events. Fix: check it against the field table in part 10, correct it and click Send test to verify.
The Ads page shows a red banner about ad blocking.
Cause: your browser has an ad blocker extension on and it blocks a few elements of the Ads module by mistake. Fix: disable the extension for the Orova domain, or open the page in an incognito window, then reload.
My Ads menu is missing items my colleague has.
Cause: your role group has not been given that item, so the menu hides it. Fix: ask the workspace owner to open the roles settings and switch the item on for your group.
Reopening the Campaigns page shows the filters from last time.
Cause: Orova remembers your most recent filters so you do not have to pick them again. Fix: click Clear filters to reset, then choose the Time range and Project you need.
/ Need help?
Can't find what you need? Open the Support section in your workspace, or send us a message.
