OROVA.VN — BIZ AI AGENT

/ Orova Ads guide

Use Orova Ads
one step at a time.

Walk through a full ad project: from connecting an account to AI running on the rule set you define.

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

  1. 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.
  2. 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.
  3. 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

You need a running ad account, and you need admin access to it. Without admin access the permission screen will not let you pick the account.

Tip

You can read this whole guide without an ad account yet. Every step describes exactly what you will see on screen.

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 Projects section. The module tabs sit in a bar across the top of the page, right under the header.

    Orova Ads with the five menu items at the top: Projects, Campaigns, Conversion API, Rule Set, History
    The five menu items of Orova Ads
The five menu items of Orova Ads
Menu itemWhat it is forWhen you need it
ProjectsCreate a project and connect ad accounts to itAt the start, and whenever you add a new account
CampaignsThe combined data table for all three platforms, and the AI switch per campaignDaily, when you check how things are going
Conversion APIWire up the data path that reports real orders back to the platformsWhen you want the platforms to optimize more accurately
Rule SetWrite your goals and choose which actions AI is allowed to takeBefore you let AI run for the first time
HistoryRun an analysis, read AI recommendations, review what was doneAfter 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

A missing menu item is not a bug. The menu is filtered by permissions: if your permission group has not enabled a section, that section does not appear.

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 Projects in the tab bar at the top. If the workspace has no project yet, you see the line No projects yet with a + Create first project button.

    The Projects tab highlighted in the Orova Ads menu
    Open Projects
  • 2

    Click Create new project. Click + Create first project, or the Create new project card 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.

    The Create new project button in the Projects toolbar
    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 Projects in the tab bar at the top. The project you just created is in the list, with the Linked accounts column at 0.

    Projects list with the new Lumio Coffee — Online Store row highlighted
    The new project shows in the list
The Projects screen — buttons and fields
Button / fieldWhat it meansNotes
Search projects...Filters the list by project nameFilters in place, the page does not reload
Create new projectCreates a new project right awayIt is the card with a plus sign at the start of the list
+ Create first projectCreates the first project right awayOnly shown when the workspace has no project yet
Linked accountsHow many ad accounts are connected to the project0 means nothing is connected yet, so the campaign table will be empty
Last updatedThe last time the project changedThis is not the last data sync
Project IDThe public code in the form prj_...Used when configuring the Conversion API
EditOpens the project detail screenThat is also where you connect and disconnect accounts
Delete projectRemoves the project from the workspaceThere is a confirmation popup; deleting also disconnects every linked account

Warning

Deleting a project cannot be undone

Deleting a project disconnects every ad account linked to it. To use them again you have to connect them from scratch and grant access again.

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 platform block with three cards: Google Ads, Meta Ads and TikTok Ads.

    Project page with the Connect Google Ads, Meta Ads and TikTok Ads buttons highlighted
    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.

    The Connect Meta Ads button highlighted
    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. Click Deselect all if 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. Clicking Cancel on this screen connects nothing.

  • 6

    Check the connected account table. The table has the Platform, Account name and Connected on columns. The correct status is Connected.

    Connected accounts table: Lumio Google Ads, Meta Ads and TikTok Ads with connection dates
    Connected accounts appear in the table

Note

You came back but the table is still empty

If you return from the selection screen without ticking any account, the project shows 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

Reading the status column
StatusWhat it meansWhat you need to do
ConnectedThe access pass is still valid and Orova can pull dataNothing to do
Connection errorThe access pass expired, or you revoked access on the platformClick Connect again on that platform card and grant access again

Warning

Disconnecting

The 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 Campaigns in the tab bar at the top. If no account is connected, the page shows No ad account connected yet with a Go to Projects to connect button — go back to step 2 first.

    Campaigns page with the Campaigns tab highlighted in the menu
    Open Campaigns
  • 2

    Click Refresh. Click the Refresh button in the toolbar. Orova calls the platform and pulls data into the store. Wait until campaign rows appear in the table.

    The Refresh button highlighted in the Campaigns toolbar
    Click Refresh to pull fresh numbers
  • 3

    Open the Sync management page. Click Manage sync in the same toolbar. This is where you set the rules for every future data pull.

    Sync management: Keep data for and Update cycle fields highlighted
    Storage and auto sync settings
The Sync management page — field by field
Button / fieldWhat it meansNotes
Keep data forHow long the store keeps data before clearing itExtending this range makes Orova backfill the missing part automatically
Default platformThe platform pre-selected when you open the campaign tableIt only changes what you see first, it does not lock out other platforms
Periodic auto updateTurn on so Orova pulls data on its own, with no clicking from youOff means every update happens only when you click
Update cycleHow often an automatic pull runsMinimum 5 minutes per run
SyncPull all data again right nowWhile it runs, the button changes to Running full sync…
Last updateWhen the most recent data pull happenedShows — none yet — when nothing has run
Last full syncWhen the most recent full pull happenedUse it to know how far back your data reaches

Run a full sync

  • 1

    Click the Sync button. In the Manual sync block, click Sync. A progress popup appears almost immediately.

    Manual sync card with the Sync button highlighted
    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 shows Sync didn't finish, please try again., click Sync again in a few minutes.

Note

A full sync takes a few minutes

The time depends on how many accounts you have and how long you keep data for. The first run is always the longest, later runs only pull what is new.

Tip

Turning on 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

Each filter field
Filter fieldWhat it meansNotes
ProjectShow only campaigns in one projectAll projects to view them together
PlatformFilter by Google, Meta or TikTokLeave empty to see all three combined
Ad accountFilter by one specific ad accountAll ad accounts is the default
StatusAll statuses, Active or PausedPaused campaigns still carry their past data
ObjectiveFilter by the campaign objectiveChanging the objective changes the report columns with it
Time rangeToday, 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 nameUseful once the list gets long
Clear filtersDrops every filter condition currently setUse it when the table is empty and you are not sure why

Note

Your filters are remembered

Orova remembers the filters you used last time. When you reopen Campaigns you see those same filters, not the default state. If the table looks odd, click Clear filters.

Default columns — what each one means

The columns always present in the table
ColumnWhat it meansNotes
Campaign nameThe name you gave it on the platformClick it to open the detail page
StatusActive or pausedTaken from the platform
AIThe switch that lets AI analyze this campaignSee step 5
Rule setThe rule set currently assigned to the campaignEmpty shows Not assigned
BudgetThe budget currently setDaily or lifetime, depending on the campaign
SpendMoney spent within the time range you filteredChange the time range and the number changes
ImpressionsHow many times the ad was shownOne person may see it several times
ReachHow many different people saw itAlways lower than or equal to Impressions
FrequencyHow many times one person sees it on averageVery high usually signals a narrow audience
ClicksHow many times the ad was clicked—
CTRClicks as a share of impressionsMeasures how compelling the creative is
CPCAverage money paid per click—
CPMMoney paid per 1,000 impressionsMeasures the price of impressions
ResultsHow many of the actions you want customers to takeDepends on the campaign objective
Cost/resultMoney paid per resultThe column most often used to compare campaigns
ConversionsConversions recorded by the platform—
Conv. rateConversions as a share of clicks—
Cost/conv.Money paid per conversion—
Conv. valueTotal value of the conversionsYou need this number to compute ROAS

The Columns button — add columns per objective

Add columns

  • 1

    Click the Columns button. Click Columns in the toolbar. The Extra columns for report: popup opens with a list of columns and checkboxes.

    The Columns button highlighted in the Campaigns toolbar
    Click Columns
  • 2

    Tick columns for the objective you are running. For sales, tick ROAS, Purchases and Conv. value. For lead generation, tick Leads. For messaging, tick Conversations. For video, tick Video views (ThruPlay).

    Open Columns popup listing extra report columns with checkboxes
    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.

    The apply button at the bottom of the Columns popup highlighted
    Save the column choice

Note

Google Ads has its own column set

Google campaigns come with the 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

Drag the horizontal scrollbar at the bottom of the table to see all the metric columns. Or hold Shift and scroll.

Going deeper — details and the three levels

Move down a level

  • 1

    Click the campaign name. Click Campaign name to open the detail page. The page has a Metric breakdowns · Last 30 days block with the Results, Spend, CTR and Cost/result columns.

    Campaign rows with the campaign names and Details links highlighted
    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 sets and Ads. The table then shows the children of the rows you selected.

    Level menu open with Ad sets and Ads highlighted
    Switch to a lower level

Note

The table is empty even though accounts are connected

Three common reasons: the time range you filtered has no data, the project or platform filter is narrowing things too far, or the sync has not finished. Click 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.

AI-related controls on the Campaigns table
Button / fieldWhat it meansNotes
AI columnThe on/off switch for AI on that rowIt applies instantly, no save needed
Rule set columnThe rule set currently applied to the campaignEmpty shows Not assigned
Select multipleShows a checkbox at the start of every rowClick again to leave selection mode
Turn AI onTurns AI on for every ticked rowOnly appears once at least one row is ticked
Turn AI offTurns AI off for every ticked rowOnce off, the AI stops reading that campaign
Assign rule set…Picks one rule set for every ticked rowThe list comes from the Rule Set page

Turn AI on for a campaign

  • 1

    Open the Campaigns table again. Click Campaigns in the tab bar at the top. Set Time range to Last 30 days so you can see a trend — do not pick Today.

  • 2

    Pick campaigns worth switching on. Look at the Spend and Results columns. 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 AI column of that row. The page saves by itself, no other button needed. Flipping this switch uses no quota.

    The AI switch on a campaign row highlighted
    Flip the AI switch on the row
  • 4

    Turn several campaigns on at once. Click Select multiple in the toolbar. Every row gains a checkbox. Tick the rows you want, then click Turn AI on. The bar above shows how many rows are selected.

    Select multiple turned on with three campaign checkboxes ticked
    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.

    Bulk bar with Turn AI on, Turn AI off and Assign rule set highlighted
    Assign a rule set to selected rows
  • 6

    Check the Rule set column. Reload the page. The Rule set column should show a rule set name instead of Not assigned. That tells you the campaign is ready for the AI to read.

    Rule set column: one campaign Not assigned, two on Meta — Conversions
    Check the Rule set column

Tip

How many is enough

The more campaigns you switch on, the more quota each analysis run costs and the longer it takes. If you are new, start with a few key campaigns and expand once you are comfortable.

Note

When quota is charged

Flipping the AI switch on or off never uses quota. Quota is only charged when the AI actually reads your numbers and produces recommendations. The screen always shows the figure before you click.

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 Set in the tab bar at the top. You see the list of rule sets you already have. Type in Filter by name… to find one fast.

  • 2

    Look at the Template store first. Click Template store to see ready-made rule sets. Take one and edit it if it fits. Click Guide to read how rules work.

  • 3

    Click Create new rule. Click Create new rule. The rule editor opens.

    The Create new rule button highlighted on the Rule Set page
    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 set column of the Campaigns table.

    Rule editor for Meta — Conversions with the rule name field highlighted
    The rule editor
  • 5

    Pick the Goal. Open the Goal menu and pick what matters most, for example Maximize conversions & leads. Other choices cover CPA/CPL, ROAS, traffic, brand awareness and budget.

    Goal menu open on the rule editor toolbar
    Pick the goal for this rule
  • 6

    Add optimization groups. Click Add optimization group and pick the kind of campaign: General (applies to all), Google · Search, Performance Max and more. In each group, click Add rule, then pick the Data variables and Action codes it uses.

    Add optimization group menu open
    Add optimization groups and set their actions
  • 7

    Click Save rule. Click Save rule. Click Cancel to leave without saving. If you leave with unsaved changes, the page asks before it discards them.

    The Save rule button highlighted
    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.

    Run mode popup with Off, run on sync, interval and weekly options
    Choose a run mode
The Rule Set pages — buttons and fields
Button / fieldWhat it meansNotes
Create new ruleOpens a blank rule editorOn the list page
Template storeReady-made rule sets to copy and editThe quickest start
Filter by name…Filters the list by rule set nameFilters in place
GoalWhat the AI aims for, e.g. Maximize conversions & leadsOne goal per rule set
Add optimization groupAdds a group of rules for one kind of campaignGeneral (applies to all) covers every campaign
Action codesWhat a rule may doGEXE/MEXE/TEXE = Orova acts itself; GADS/MADS/TADS = advisory only
Save rule / CancelSave or leave the editorUnsaved changes are flagged before you leave
Run modeWhen the AI starts an analysis run on its ownA popup on the list page; every run is charged to your quota

Warning

Runs cost quota, writing rules does not

Creating and saving a rule set is free. Quota is charged each time the AI runs an analysis — by hand or through Run mode.

Tip

Start small

If you are new, start with one group, a few rules and advisory-only action codes. Read the results in 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 of All accounts.

    History page with the Project menu open on Lumio Coffee — Online Store
    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.

    Analyze with AI menu open with the rule sets Meta — Conversions and Google — Search
    Choose which rule set analyzes
  • 3

    Click Analyze. Click Analyze. The screen shows how much quota the run costs before it starts.

    The Analyze button next to the Analyze with AI menu highlighted
    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.

    Recommendation list: action, data codes, location and rule set for each item
    Read the recommendation list
  • 6

    Read each recommendation. Each item shows the action, the data code, the location, the rule set, the Advisory label, the change and the reason. Read the change and the reason, then decide whether to act on the platform.

    One recommendation with its Advisory tag and the full change and reason highlighted
    Read the change and reason before deciding
What each recommendation shows
PartWhat it meansNotes
ActionThe kind of job the AI advisesComes from the action codes in your rule set
Data codeThe numbers the AI based its conclusion onUse these when you want to verify it
LocationWhere it applies: Platform, Camp., Ad set or AdThat is the platform, the campaign, the ad set and the ad
Rule setThe rule set that produced this recommendationTells you which rules are running
AdvisoryThe AI only suggestsYou act on the platform yourself
Change + reasonWhat to change and whyRead both before you act

Warning

History changes nothing on the platform

Reading a recommendation in 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

If you see a line saying the assistant found no clear optimization opportunity, that is perfectly normal. The AI read your numbers against the rule set and decided nothing needs touching.

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 API in the tab bar at the top. The page opens with a project picker at the top and three platform blocks below it.

    Conversion API page with the Conversion API tab highlighted
    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.

    Project menu open on the Conversion API page
    Pick the right project
  • 3

    Copy the webhook address. The Data receiving address block shows a long URL. Click to copy it and pass it to whoever builds your website. That is where your system sends order data.

    API tab: webhook address field highlighted, value masked
    Copy the webhook address
  • 4

    Generate a secret key. Click the generate button in the Secret key field. The key is shown once, so copy it and store it safely. Your developer sends this key with every call, in the X-Orova-Secret header.

    Secret key field highlighted, value masked
    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 on Enable audience sync.

    Meta Ads block expanded, its header highlighted
    Set up the Meta block
  • 6

    Set up the Google block. Pick the target Conversion Action in the offline conversions block. The Audiences (Customer Match) block is for pushing customer lists to Google.

    Google Ads block expanded, header highlighted: offline conversions and Customer Match
    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.

    TikTok Ads block expanded, its header highlighted
    Review the TikTok block
  • 8

    Send a test. Click Send test to fire a dummy event. Enter a test email if you like. Meta adds a Test event code field so you can cross-check it in Test Events.

    The Send test button highlighted next to the optional phone field
    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, Skipped and Error.

    Accounts, API and History tabs with History highlighted
    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.

Fields sent to the webhook
Button / fieldWhat it meansNotes
event_nameThe event name, for example a purchase or a leadMust be one of the nine events listed below
email / phoneThe customer's email and phone numberAt least one is needed for the platform to match the person
order_idYour own order referencePrevents the same order being counted twice
value / currencyThe order value and its currencyNeeded on purchase events if you want ROAS
gclidGoogle's click tracking idWithout it Google cannot tell which ad drove the order
fbc / fbpMeta's tracking idsRead them from the cookies on your website
ttclidTikTok's click tracking idThe same idea as gclid, but for TikTok
platformSend to one specific platformLeave it out to follow whatever configuration is switched on
targetA specific destinationUse it when one project has several destinations
event_source_urlThe page where the event happenedHelps the platform match the source
  • Purchase (a completed order) and Lead (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

Click 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

If Meta, Google Ads or TikTok Ads is not connected, the matching block says so and the Pixel picker is empty. Go back and connect the account first, then reload this page.

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.

What costs quota and what does not
Button / fieldWhat it meansNotes
Creating projects, connecting accountsNo quotaDo as much as you like
Syncing, filtering, reading the numbersNo quotaView it as often as you want
Flipping the AI switch on or offNo quotaIt is only a flag
Writing and saving a rule setNo quotaFree
Analyze with AICosts quota on every runThe figure is shown before you confirm
Runs triggered by Run modeCosts quota on every runA scheduled run counts the same as a manual one
The AI avatar generation buttonCosts quotaUploading your own image costs nothing

Warning

Running low and running out

When you are running low, a banner at the top of the page reminds you to top up. When you run out, every AI run is blocked and a popup points you to the wallet. Your existing numbers stay viewable.

Note

A colleague does not see all five menu items

The Ads menu is filtered by role. If their role group has not been given an item, it does not show. The workspace owner opens the roles settings and switches it on.

Tip

Changing language

The Orova interface comes in nine languages: Vietnamese, English, Spanish, Chinese, Japanese, French, Thai, Lao and Khmer. Everyone picks their own, and it does not affect anyone else.

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.

Back to top← Back to guide library

/ Need help?

Can't find what you need? Open the Support section in your workspace, or send us a message.