Skip to content
Book a demoStart free
Connectors

Mercado Ads connector

Set up the Mercado Ads connector in Kaivo: authentication, configuration, the 17 BigQuery tables it syncs, and answers to common questions.

Mercado Ads connector pricing, tier and credits on kaivo.io

Kaivo is a fully managed data platform that syncs your Mercado Ads data into a Google BigQuery warehouse and keeps it up to date automatically. There is no pipeline to build and no infrastructure to run, so you can spend your time analysing your marketing and sales data instead of moving it.

Sync your Mercado Ads data into BigQuery with Kaivo to track ad spend and performance across brand, display, and product campaigns.

CategoryMarketing & Sales
AuthenticationAPI key
SetupSelf-service

Getting started with the Mercado Ads connector

Section titled “Getting started with the Mercado Ads connector”
  1. Sign up for Kaivo and create a workspace.
  2. Connect your Mercado Ads account.
  3. Choose which tables to sync.
  4. Wait for the initial sync to finish.
  5. Query your data in BigQuery or your favourite AI or BI tool.

Authenticate with your Mercado Ads credentials. You provide:

Field Description
Client ID
Client secret
Refresh token

Prerequisites

Mercado Ads requires you to register a Mercado Libre developer application and complete the OAuth flow once to obtain a refresh token:

  1. Create an application in the Mercado Libre developer portal and note the Client ID and Client Secret.
  2. Complete the OAuth authorization flow once to obtain a Refresh Token.

Then enter those values below.

Need help, or want an easier way to connect? Reach our team via the chat in the bottom-right corner.

When you set up the connector, you provide:

Field Description
Start Date
Any data before this date will not be fetched.

|

Tables and columns synced from Mercado Ads

Section titled “Tables and columns synced from Mercado Ads”

Kaivo syncs 17 tables from Mercado Ads into a dedicated dataset in your BigQuery warehouse. Click any table to see its columns and types.

brand_advertisers (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
account_name STRING
advertiser_id FLOAT64
advertiser_name STRING
site_id STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
brand_campaigns (18 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
advertiser_campaign_id STRING
advertiser_id FLOAT64
budget__amount FLOAT64
budget__currency STRING
campaign_id FLOAT64
campaign_type STRING
cpc FLOAT64
destination_id FLOAT64
end_date STRING
headline STRING
moderation_status STRING
name STRING
official_store_id FLOAT64
site_id STRING
start_date STRING
status STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
campaign_id FLOAT64
item_id STRING
status STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
campaign_id FLOAT64
cpc FLOAT64
is_negative BOOL
match_type STRING
term STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
brand_campaigns_metrics (34 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
acos FLOAT64
advertiser_id FLOAT64
campaign_id FLOAT64
clicks FLOAT64
consumed_budget FLOAT64
cpc FLOAT64
ctr FLOAT64
currency STRING
cvr FLOAT64
date STRING
event_time__bookmark_conversions FLOAT64
event_time__cart_conversions FLOAT64
event_time__checkout_conversions FLOAT64
event_time__eshop_conversions FLOAT64
event_time__items_quantity FLOAT64
event_time__leads_im_conversions FLOAT64
event_time__leads_question_conversions FLOAT64
event_time__ppv_conversions FLOAT64
event_time__units_amount FLOAT64
event_time__units_quantity FLOAT64
prints FLOAT64
site_id STRING
touch_point__bookmark_conversions FLOAT64
touch_point__cart_conversions FLOAT64
touch_point__checkout_conversions FLOAT64
touch_point__eshop_conversions FLOAT64
touch_point__items_quantity FLOAT64
touch_point__leads_im_conversions FLOAT64
touch_point__leads_question_conversions FLOAT64
touch_point__ppv_conversions FLOAT64
touch_point__units_amount FLOAT64
touch_point__units_quantity FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
brand_items (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
advertiser_id FLOAT64
campaign_id FLOAT64
item_id STRING
status STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
brand_keywords (9 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
advertiser_id FLOAT64
campaign_id FLOAT64
cpc FLOAT64
is_negative BOOL
match_type STRING
term STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
brand_keywords_metrics (5 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
advertiser_id FLOAT64
campaign_id FLOAT64
date STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: brand_keywords_metrics__keywords

Section titled “Subtable: brand_keywords_metrics__keywords”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
acos FLOAT64
clicks FLOAT64
consumed_budget FLOAT64
cpc FLOAT64
ctr FLOAT64
currency STRING
cvr FLOAT64
event_time__bookmark_conversions FLOAT64
event_time__cart_conversions FLOAT64
event_time__checkout_conversions FLOAT64
event_time__eshop_conversions FLOAT64
event_time__items_quantity FLOAT64
event_time__leads_im_conversions FLOAT64
event_time__leads_question_conversions FLOAT64
event_time__ppv_conversions FLOAT64
event_time__units_amount FLOAT64
event_time__units_quantity FLOAT64
keyword STRING
prints FLOAT64
site_id STRING
touch_point__bookmark_conversions FLOAT64
touch_point__cart_conversions FLOAT64
touch_point__checkout_conversions FLOAT64
touch_point__eshop_conversions FLOAT64
touch_point__items_quantity FLOAT64
touch_point__leads_im_conversions FLOAT64
touch_point__leads_question_conversions FLOAT64
touch_point__ppv_conversions FLOAT64
touch_point__units_amount FLOAT64
touch_point__units_quantity FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
display_advertisers (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
account_name STRING
advertiser_id FLOAT64
advertiser_name STRING
site_id STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
display_campaigns (12 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
advertiser_campaign_id STRING
advertiser_id FLOAT64
campaign_id FLOAT64
end_date STRING
goal STRING
name STRING
site_id STRING
start_date STRING
status STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
display_campaigns_metrics (41 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
active_views FLOAT64
advertiser_id FLOAT64
average_frequency FLOAT64
campaign_id FLOAT64
clicks FLOAT64
completed_views FLOAT64
consumed_budget FLOAT64
cpc FLOAT64
cpm FLOAT64
ctr FLOAT64
currency STRING
date STRING
event_time__attribution_add_to_cart FLOAT64
event_time__attribution_bookmark FLOAT64
event_time__attribution_checkout FLOAT64
event_time__attribution_leads FLOAT64
event_time__attribution_ppv FLOAT64
event_time__cpa_order FLOAT64
event_time__cpa_ppv FLOAT64
event_time__cpl FLOAT64
event_time__direct_amount FLOAT64
event_time__direct_item_quantity FLOAT64
event_time__roas FLOAT64
event_time__units_quantity FLOAT64
prints FLOAT64
reach FLOAT64
site_id STRING
touch_point__attribution_add_to_cart FLOAT64
touch_point__attribution_bookmark FLOAT64
touch_point__attribution_checkout FLOAT64
touch_point__attribution_leads FLOAT64
touch_point__attribution_ppv FLOAT64
touch_point__cpa_order FLOAT64
touch_point__cpa_ppv FLOAT64
touch_point__cpl FLOAT64
touch_point__direct_amount FLOAT64
touch_point__direct_item_quantity FLOAT64
touch_point__roas FLOAT64
touch_point__units_quantity FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
display_creatives (9 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
advertiser_campaign_line_item_creative_id STRING
advertiser_id FLOAT64
campaign_id FLOAT64
creative_id FLOAT64
line_item_id FLOAT64
name STRING
status STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
display_line_items (11 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
advertiser_campaign_line_item_id STRING
advertiser_id FLOAT64
campaign_id FLOAT64
end_date STRING
line_item_id FLOAT64
name STRING
start_date STRING
status STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
display_line_items_metrics (42 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
active_views FLOAT64
advertiser_id FLOAT64
average_frequency FLOAT64
campaign_id FLOAT64
clicks FLOAT64
completed_views FLOAT64
consumed_budget FLOAT64
cpc FLOAT64
cpm FLOAT64
ctr FLOAT64
currency STRING
date STRING
event_time__attribution_add_to_cart FLOAT64
event_time__attribution_bookmark FLOAT64
event_time__attribution_checkout FLOAT64
event_time__attribution_leads FLOAT64
event_time__attribution_ppv FLOAT64
event_time__cpa_order FLOAT64
event_time__cpa_ppv FLOAT64
event_time__cpl FLOAT64
event_time__direct_amount FLOAT64
event_time__direct_item_quantity FLOAT64
event_time__roas FLOAT64
event_time__units_quantity FLOAT64
line_item_id FLOAT64
prints FLOAT64
reach FLOAT64
site_id STRING
touch_point__attribution_add_to_cart FLOAT64
touch_point__attribution_bookmark FLOAT64
touch_point__attribution_checkout FLOAT64
touch_point__attribution_leads FLOAT64
touch_point__attribution_ppv FLOAT64
touch_point__cpa_order FLOAT64
touch_point__cpa_ppv FLOAT64
touch_point__cpl FLOAT64
touch_point__direct_amount FLOAT64
touch_point__direct_item_quantity FLOAT64
touch_point__roas FLOAT64
touch_point__units_quantity FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_advertisers (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
account_name STRING
advertiser_id FLOAT64
advertiser_name STRING
site_id STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_campaigns (16 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
acos_target FLOAT64
acos_top_search_target FLOAT64
advertiser_campaign_id STRING
advertiser_id FLOAT64
automatic_budget BOOL
budget FLOAT64
campaign_id FLOAT64
channel STRING
date_created STRING
last_updated STRING
name STRING
salesforce_event_id FLOAT64
status STRING
strategy STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_campaigns_metrics (31 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
acos FLOAT64
acos_benchmark FLOAT64
advertiser_id FLOAT64
advertising_items_quantity FLOAT64
campaign_id FLOAT64
clicks FLOAT64
cost FLOAT64
cpc FLOAT64
ctr FLOAT64
cvr FLOAT64
date STRING
direct_amount FLOAT64
direct_items_quantity FLOAT64
direct_units_quantity FLOAT64
impression_share FLOAT64
indirect_amount FLOAT64
indirect_items_quantity FLOAT64
indirect_units_quantity FLOAT64
lost_impression_share_by_ad_rank FLOAT64
lost_impression_share_by_budget FLOAT64
organic_items_quantity FLOAT64
organic_units_amount FLOAT64
organic_units_quantity FLOAT64
prints FLOAT64
roas FLOAT64
sov FLOAT64
top_impression_share FLOAT64
total_amount FLOAT64
units_quantity FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_items (32 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
advertiser_campaign_item_id STRING
advertiser_id FLOAT64
brand_value_id STRING
brand_value_name STRING
buy_box_winner BOOL
campaign_id FLOAT64
catalog_listing BOOL
channel STRING
condition STRING
current_level STRING
date_created STRING
deferred_stock BOOL
domain_id STRING
family_id FLOAT64
family_name STRING
has_discount BOOL
image_quality STRING
item_id STRING
listing_type_id STRING
logistic_type STRING
official_store_id FLOAT64
permalink STRING
price FLOAT64
price_usd FLOAT64
recommended BOOL
status STRING
thumbnail STRING
title STRING
user_product_id STRING
user_product_name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_items_metrics (27 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
acos FLOAT64
advertiser_id FLOAT64
advertising_items_quantity FLOAT64
campaign_id FLOAT64
clicks FLOAT64
cost FLOAT64
cpc FLOAT64
ctr FLOAT64
cvr FLOAT64
date STRING
direct_amount FLOAT64
direct_items_quantity FLOAT64
direct_units_quantity FLOAT64
indirect_amount FLOAT64
indirect_items_quantity FLOAT64
indirect_units_quantity FLOAT64
item_id STRING
organic_items_quantity FLOAT64
organic_units_amount FLOAT64
organic_units_quantity FLOAT64
prints FLOAT64
roas FLOAT64
sov FLOAT64
total_amount FLOAT64
units_quantity FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where Mercado Ads supports it, each sync pulls only new and changed records so it stays fast; otherwise it refreshes the whole table. Every record keeps its original ID, so you won’t get duplicate rows.

How long does the initial sync take for Mercado Ads?

Section titled “How long does the initial sync take for Mercado Ads?”

It depends on how much history is in your Mercado Ads account. Most initial syncs finish within minutes, while large accounts can take a few hours. After that, syncs only fetch new and changed records, so they’re much faster.

Yes. You pick which tables to sync when you set up the connection and can change the selection later. Tables you don’t select are never copied to your warehouse.

What happens when Mercado Ads’s schema changes?

Section titled “What happens when Mercado Ads’s schema changes?”

New fields are never added automatically. You choose which fields to sync, so data you haven’t selected (sensitive personal data, for example) never lands in your warehouse. When a new field appears, it becomes available for you to add. What happens to removed or renamed fields depends on a table’s sync mode: full-refresh tables always match what’s currently in Mercado Ads, so dropped fields disappear, while incremental tables keep their existing columns and history, so an old field stays and newly added fields fill in over time.

How do I handle GDPR or data deletion requests?

Section titled “How do I handle GDPR or data deletion requests?”

Your data lives in your own Kaivo-managed BigQuery warehouse, so the most direct option is to delete or anonymise specific records right in BigQuery. If you delete data in Mercado Ads instead, full-refresh tables drop it on the next sync, while incremental tables keep it, so you would remove the row in BigQuery or ask us to run a full refresh. To remove everything, delete the Mercado Ads connector in Kaivo and all of its synced data is deleted with it.

Use the campaigns and metrics tables to track impressions, clicks, and conversions over time.

Compare brand, display, and product campaigns to see what drives the best return.

Join brand_keywords with their metrics to find which terms perform best.

Use Mercado Ads data in your AI and BI tools

Section titled “Use Mercado Ads data in your AI and BI tools”

Once Mercado Ads data lands in your Kaivo-managed BigQuery warehouse, you can explore it with AI tools or any BI tool that connects to BigQuery. Here’s how the most common destinations work with Mercado Ads data.

Use Kaivo’s MCP server to give Claude secure, workspace-scoped access to your data. Setup guide →

Microsoft’s BI tool with a native BigQuery connector. Supports direct query and scheduled refresh. Setup guide →

Free Google BI tool with native BigQuery support. One-click connection to your Kaivo warehouse; great for SMB teams on Google Workspace. Setup guide →

The premium analytics standard, with native BigQuery integration. Setup guide →

Use Connected Sheets to query BigQuery directly from a spreadsheet, with no SQL. Setup guide →

Connect via Power Query’s BigQuery connector. Setup guide →

Open-source BI tool with strong BigQuery support. Setup guide →

See our pricing page for Mercado Ads connector pricing and plan details.