Skip to content
Book a demoStart free
Connectors

Amazon Ads connector

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

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

Kaivo is a fully managed data platform that syncs your Amazon 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 Amazon Ads campaigns, ad groups, keywords, and reports into BigQuery with Kaivo to measure retail media spend and return.

CategoryMarketing & Sales
AuthenticationOAuth
SetupOn request, contact us to enable it

Getting started with the Amazon Ads connector

Section titled “Getting started with the Amazon Ads connector”
  1. Sign up for Kaivo and create a workspace.
  2. Ask us to enable the Amazon Ads connector for your workspace. You can reach our team from the chat in the app.
  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.

Connect by signing in to your Amazon Ads account. Kaivo runs the connection for you, so you never share a password.

When you set up the connector, you provide:

Field Description
Region
Region to pull data from (EU/NA/FE). See docs for more details.

| | Start Date |

Any data before this date will not be fetched.

| | Profile ID |

Profile ID you want to fetch data for. This connector supports only profiles with seller and vendor type, profiles with agency type will be ignored. See docs for more details. Note: If a Marketplace ID is also selected, the profile will be selected if it matches the Profile ID OR the Marketplace ID.

| | Marketplace ID |

Marketplace ID you want to fetch data for. Note: If a Profile ID is also selected, the profile will be selected if they match the Profile ID OR the Marketplace ID.

|

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

attribution_report_performance_adgroup (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
brand_name STRING
marketplace STRING
campaign_id STRING
product_asin STRING
product_conversion_type STRING
advertiser_name STRING
ad_group_id STRING
creative_id STRING
product_name STRING
product_category STRING
product_subcategory STRING
product_group STRING
publisher STRING
click_throughs STRING
attributed_detail_page_views_clicks14d STRING
attributed_add_to_cart_clicks14d STRING
attributed_purchases14d STRING
units_sold14d STRING
attributed_sales14d STRING
attributed_total_detail_page_views_clicks14d STRING
attributed_total_add_to_cart_clicks14d STRING
attributed_total_purchases14d STRING
total_units_sold14d STRING
… and 14 more columns
attribution_report_performance_campaign (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
brand_name STRING
marketplace STRING
campaign_id STRING
product_asin STRING
product_conversion_type STRING
advertiser_name STRING
ad_group_id STRING
creative_id STRING
product_name STRING
product_category STRING
product_subcategory STRING
product_group STRING
publisher STRING
click_throughs STRING
attributed_detail_page_views_clicks14d STRING
attributed_add_to_cart_clicks14d STRING
attributed_purchases14d STRING
units_sold14d STRING
attributed_sales14d STRING
attributed_total_detail_page_views_clicks14d STRING
attributed_total_add_to_cart_clicks14d STRING
attributed_total_purchases14d STRING
total_units_sold14d STRING
… and 14 more columns
attribution_report_performance_creative (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
brand_name STRING
marketplace STRING
campaign_id STRING
product_asin STRING
product_conversion_type STRING
advertiser_name STRING
ad_group_id STRING
creative_id STRING
product_name STRING
product_category STRING
product_subcategory STRING
product_group STRING
publisher STRING
click_throughs STRING
attributed_detail_page_views_clicks14d STRING
attributed_add_to_cart_clicks14d STRING
attributed_purchases14d STRING
units_sold14d STRING
attributed_sales14d STRING
attributed_total_detail_page_views_clicks14d STRING
attributed_total_add_to_cart_clicks14d STRING
attributed_total_purchases14d STRING
total_units_sold14d STRING
… and 14 more columns
attribution_report_products (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
brand_name STRING
marketplace STRING
campaign_id STRING
product_asin STRING
product_conversion_type STRING
advertiser_name STRING
ad_group_id STRING
creative_id STRING
product_name STRING
product_category STRING
product_subcategory STRING
product_group STRING
publisher STRING
click_throughs STRING
attributed_detail_page_views_clicks14d STRING
attributed_add_to_cart_clicks14d STRING
attributed_purchases14d STRING
units_sold14d STRING
attributed_sales14d STRING
attributed_total_detail_page_views_clicks14d STRING
attributed_total_add_to_cart_clicks14d STRING
attributed_total_purchases14d STRING
total_units_sold14d STRING
… and 14 more columns
portfolios (14 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
portfolio_id INT64
name STRING
budget__amount FLOAT64
budget__currency_code STRING
budget__policy STRING
budget__start_date STRING
budget__end_date STRING
in_budget BOOL
state STRING
creation_date INT64
last_updated_date INT64
serving_status STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
profiles (13 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
country_code STRING
currency_code STRING
daily_budget FLOAT64
timezone STRING
account_info__marketplace_string_id STRING
account_info__id STRING
account_info__type STRING
account_info__name STRING
account_info__sub_type STRING
account_info__valid_payment_method BOOL
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_brands_ad_groups (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
campaign_id STRING
ad_group_id STRING
name STRING
state STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_brands_campaigns (13 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
campaign_id STRING
name STRING
budget FLOAT64
budget_type STRING
start_date STRING
end_date STRING
state STRING
brand_entity_id STRING
portfolio_id STRING
product_location STRING
cost_type STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • sponsored_brands_campaigns__smart_default (4 columns)
sponsored_brands_keywords (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
campaign_id STRING
ad_group_id STRING
name STRING
state STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_brands_v3_report_stream (20 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
attribution_type STRING
campaign_name STRING
new_to_brand_sales14d FLOAT64
orders14d INT64
product_name STRING
sales14d FLOAT64
new_to_brand_purchases_percentage14d FLOAT64
purchased_asin STRING
new_to_brand_sales_percentage14d FLOAT64
product_category STRING
new_to_brand_purchases14d INT64
new_to_brand_units_sold_percentage14d FLOAT64
units_sold14d INT64
ad_group_name STRING
new_to_brand_units_sold14d INT64
campaign_budget_currency_code STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_brands_v3_report_stream_daily (21 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
attribution_type STRING
campaign_name STRING
new_to_brand_sales14d FLOAT64
orders14d INT64
product_name STRING
sales14d FLOAT64
new_to_brand_purchases_percentage14d FLOAT64
purchased_asin STRING
new_to_brand_sales_percentage14d FLOAT64
product_category STRING
new_to_brand_purchases14d INT64
new_to_brand_units_sold_percentage14d FLOAT64
units_sold14d INT64
ad_group_name STRING
new_to_brand_units_sold14d INT64
campaign_budget_currency_code STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_display_ad_groups (10 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
name STRING
campaign_id FLOAT64
ad_group_id FLOAT64
default_bid FLOAT64
bid_optimization STRING
state STRING
tactic STRING
creative_type STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_display_adgroups_report_stream (68 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
ad_group_id INT64
add_to_cart INT64
add_to_cart_clicks INT64
add_to_cart_rate FLOAT64
add_to_cart_views INT64
ad_group_name STRING
add_to_list INT64
add_to_list_from_clicks INT64
add_to_list_from_views INT64
qualified_borrows INT64
qualified_borrows_from_clicks INT64
qualified_borrows_from_views INT64
royalty_qualified_borrows INT64
royalty_qualified_borrows_from_clicks INT64
royalty_qualified_borrows_from_views INT64
bid_optimization STRING
branded_searches INT64
branded_searches_clicks INT64
branded_searches_views INT64
branded_search_rate FLOAT64
campaign_budget_currency_code STRING
campaign_id INT64
… and 43 more columns
sponsored_display_adgroups_report_stream_daily (67 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
ad_group_id INT64
add_to_cart INT64
add_to_cart_clicks INT64
add_to_cart_rate FLOAT64
add_to_cart_views INT64
ad_group_name STRING
add_to_list INT64
add_to_list_from_clicks INT64
add_to_list_from_views INT64
qualified_borrows INT64
qualified_borrows_from_clicks INT64
qualified_borrows_from_views INT64
royalty_qualified_borrows INT64
royalty_qualified_borrows_from_clicks INT64
royalty_qualified_borrows_from_views INT64
bid_optimization STRING
branded_searches INT64
branded_searches_clicks INT64
branded_searches_views INT64
branded_search_rate FLOAT64
campaign_budget_currency_code STRING
… and 42 more columns
sponsored_display_asins_report_stream (29 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
promoted_asin STRING
ad_group_id INT64
ad_group_name STRING
asin_brand_halo STRING
add_to_list INT64
add_to_list_from_clicks INT64
qualified_borrows_from_clicks INT64
royalty_qualified_borrows_from_clicks INT64
add_to_list_from_views INT64
qualified_borrows INT64
qualified_borrows_from_views INT64
royalty_qualified_borrows INT64
royalty_qualified_borrows_from_views INT64
campaign_budget_currency_code STRING
campaign_id INT64
campaign_name STRING
conversions_brand_halo INT64
conversions_brand_halo_clicks INT64
end_date STRING
promoted_sku STRING
sales_brand_halo INT64
sales_brand_halo_clicks INT64
… and 4 more columns
sponsored_display_asins_report_stream_daily (28 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
promoted_asin STRING
ad_group_id INT64
ad_group_name STRING
asin_brand_halo STRING
add_to_list INT64
add_to_list_from_clicks INT64
qualified_borrows_from_clicks INT64
royalty_qualified_borrows_from_clicks INT64
add_to_list_from_views INT64
qualified_borrows INT64
qualified_borrows_from_views INT64
royalty_qualified_borrows INT64
royalty_qualified_borrows_from_views INT64
campaign_budget_currency_code STRING
campaign_id INT64
campaign_name STRING
conversions_brand_halo INT64
conversions_brand_halo_clicks INT64
promoted_sku STRING
sales_brand_halo INT64
sales_brand_halo_clicks INT64
… and 3 more columns
sponsored_display_budget_rules (22 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
rule_id STRING
rule_status STRING
rule_state STRING
last_updated_date FLOAT64
created_date FLOAT64
rule_details__name STRING
rule_details__rule_type STRING
rule_details__duration__event_type_rule_duration__event_id STRING
rule_details__duration__event_type_rule_duration__end_date STRING
rule_details__duration__event_type_rule_duration__event_name STRING
rule_details__duration__event_type_rule_duration__start_date STRING
rule_details__duration__date_range_type_rule_duration__end_date STRING
rule_details__duration__date_range_type_rule_duration__start_date STRING
rule_details__budget_increase_by__type STRING
rule_details__budget_increase_by__value FLOAT64
rule_details__recurrence__type STRING
rule_details__recurrence__threshold FLOAT64
rule_details__performance_measure_condition__metric_name STRING
rule_details__performance_measure_condition__comparison_operator STRING
rule_details__performance_measure_condition__threshold FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • sponsored_display_budget_rules__rule_details__recurrence__days_of_week (4 columns)
  • sponsored_display_budget_rules__rule_details__recurrence__intra_day_schedule (5 columns)
sponsored_display_campaigns (13 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
campaign_id FLOAT64
name STRING
budget_type STRING
budget FLOAT64
start_date STRING
end_date STRING
cost_type STRING
state STRING
portfolio_id INT64
tactic STRING
delivery_profile STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_display_campaigns_report_stream (68 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
campaign_id INT64
add_to_cart INT64
add_to_cart_clicks INT64
add_to_cart_rate FLOAT64
add_to_cart_views INT64
add_to_list INT64
add_to_list_from_clicks INT64
add_to_list_from_views INT64
qualified_borrows INT64
qualified_borrows_from_clicks INT64
qualified_borrows_from_views INT64
royalty_qualified_borrows INT64
royalty_qualified_borrows_from_clicks INT64
royalty_qualified_borrows_from_views INT64
branded_searches INT64
branded_searches_clicks INT64
branded_searches_views INT64
branded_search_rate FLOAT64
campaign_budget_currency_code STRING
campaign_name STRING
clicks INT64
cost FLOAT64
… and 43 more columns
sponsored_display_campaigns_report_stream_daily (67 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
campaign_id INT64
add_to_cart INT64
add_to_cart_clicks INT64
add_to_cart_rate FLOAT64
add_to_cart_views INT64
add_to_list INT64
add_to_list_from_clicks INT64
add_to_list_from_views INT64
qualified_borrows INT64
qualified_borrows_from_clicks INT64
qualified_borrows_from_views INT64
royalty_qualified_borrows INT64
royalty_qualified_borrows_from_clicks INT64
royalty_qualified_borrows_from_views INT64
branded_searches INT64
branded_searches_clicks INT64
branded_searches_views INT64
branded_search_rate FLOAT64
campaign_budget_currency_code STRING
campaign_name STRING
clicks INT64
… and 42 more columns
sponsored_display_creatives (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
ad_group_id FLOAT64
creative_id FLOAT64
creative_type STRING
moderation_status STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_display_product_ads (8 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
state STRING
ad_id FLOAT64
campaign_id FLOAT64
ad_group_id FLOAT64
asin STRING
sku STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_display_productads_report_stream (71 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
ad_id INT64
add_to_cart INT64
add_to_cart_rate FLOAT64
add_to_cart_views INT64
add_to_cart_clicks INT64
ad_group_id INT64
ad_group_name STRING
add_to_list INT64
add_to_list_from_clicks INT64
qualified_borrows INT64
royalty_qualified_borrows INT64
add_to_list_from_views INT64
qualified_borrows_from_clicks INT64
qualified_borrows_from_views INT64
royalty_qualified_borrows_from_clicks INT64
royalty_qualified_borrows_from_views INT64
bid_optimization STRING
branded_searches INT64
branded_searches_clicks INT64
branded_searches_views INT64
branded_search_rate FLOAT64
campaign_budget_currency_code STRING
… and 46 more columns
sponsored_display_productads_report_stream_daily (70 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
ad_id INT64
add_to_cart INT64
add_to_cart_rate FLOAT64
add_to_cart_views INT64
add_to_cart_clicks INT64
ad_group_id INT64
ad_group_name STRING
add_to_list INT64
add_to_list_from_clicks INT64
qualified_borrows INT64
royalty_qualified_borrows INT64
add_to_list_from_views INT64
qualified_borrows_from_clicks INT64
qualified_borrows_from_views INT64
royalty_qualified_borrows_from_clicks INT64
royalty_qualified_borrows_from_views INT64
bid_optimization STRING
branded_searches INT64
branded_searches_clicks INT64
branded_searches_views INT64
branded_search_rate FLOAT64
… and 45 more columns
sponsored_display_targetings (8 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
target_id FLOAT64
ad_group_id FLOAT64
state STRING
expression_type STRING
bid FLOAT64
campaign_id FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • sponsored_display_targetings__expression (3 columns)
  • sponsored_display_targetings__resolved_expression (3 columns)
sponsored_display_targets_report_stream (63 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
targeting_id INT64
add_to_cart INT64
add_to_cart_clicks INT64
add_to_cart_rate FLOAT64
add_to_cart_views INT64
ad_group_id INT64
ad_group_name STRING
add_to_list INT64
add_to_list_from_clicks INT64
add_to_list_from_views INT64
qualified_borrows INT64
qualified_borrows_from_clicks INT64
qualified_borrows_from_views INT64
royalty_qualified_borrows INT64
royalty_qualified_borrows_from_clicks INT64
royalty_qualified_borrows_from_views INT64
branded_searches INT64
branded_searches_clicks INT64
branded_searches_views INT64
branded_search_rate FLOAT64
campaign_budget_currency_code STRING
campaign_id INT64
… and 38 more columns
sponsored_display_targets_report_stream_daily (61 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
targeting_id INT64
add_to_cart INT64
add_to_cart_clicks INT64
add_to_cart_rate FLOAT64
add_to_cart_views INT64
ad_group_id INT64
ad_group_name STRING
add_to_list INT64
add_to_list_from_clicks INT64
add_to_list_from_views INT64
qualified_borrows INT64
qualified_borrows_from_clicks INT64
qualified_borrows_from_views INT64
royalty_qualified_borrows INT64
royalty_qualified_borrows_from_clicks INT64
royalty_qualified_borrows_from_views INT64
branded_searches INT64
branded_searches_clicks INT64
branded_searches_views INT64
branded_search_rate FLOAT64
campaign_budget_currency_code STRING
campaign_id INT64
… and 36 more columns
sponsored_product_ad_group_bid_recommendations (5 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
ad_group_id STRING
campaign_id STRING
theme STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • sponsored_product_ad_group_bid_recommendations__bid_recommendations_for_targeting_expressions (3 columns)
  • sponsored_product_ad_group_bid_recommendations__bid_recommendations_for_targeting_expressions__bid_values (3 columns)
sponsored_product_ad_group_suggested_keywords (3 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
ad_group_id INT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • sponsored_product_ad_group_suggested_keywords__suggested_keywords (5 columns)
sponsored_product_ad_groups (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
ad_group_id STRING
name STRING
campaign_id STRING
default_bid FLOAT64
state STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_product_ads (9 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
ad_id STRING
campaign_id STRING
custom_text STRING
asin STRING
state STRING
sku STRING
ad_group_id STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_product_campaign_negative_keywords (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
keyword_id STRING
campaign_id STRING
ad_group_id FLOAT64
state STRING
keyword_text STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_product_campaigns (9 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
portfolio_id STRING
campaign_id STRING
name STRING
targeting_type STRING
state STRING
start_date STRING
end_date STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_product_keywords (8 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
keyword_id STRING
campaign_id STRING
ad_group_id STRING
state STRING
keyword_text STRING
native_language_locale STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_product_negative_keywords (8 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
keyword_id STRING
campaign_id STRING
ad_group_id STRING
state STRING
keyword_text STRING
native_language_locale STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
sponsored_product_targetings (8 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
target_id STRING
campaign_id STRING
expression_type STRING
state STRING
bid FLOAT64
ad_group_id STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • sponsored_product_targetings__expression (3 columns)
  • sponsored_product_targetings__resolved_expression (3 columns)
sponsored_products_adgroups_report_stream (35 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
ad_group_id INT64
campaign_name STRING
campaign_id INT64
ad_group_name STRING
impressions INT64
clicks INT64
cost FLOAT64
purchases1d INT64
purchases7d INT64
purchases14d INT64
purchases30d INT64
purchases_same_sku1d INT64
purchases_same_sku7d INT64
purchases_same_sku14d INT64
purchases_same_sku30d INT64
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
units_sold_clicks30d INT64
sales1d FLOAT64
sales7d FLOAT64
sales14d FLOAT64
… and 10 more columns
sponsored_products_adgroups_report_stream_daily (36 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
ad_group_id INT64
campaign_name STRING
campaign_id INT64
ad_group_name STRING
impressions INT64
clicks INT64
cost FLOAT64
purchases1d INT64
purchases7d INT64
purchases14d INT64
purchases30d INT64
purchases_same_sku1d INT64
purchases_same_sku7d INT64
purchases_same_sku14d INT64
purchases_same_sku30d INT64
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
units_sold_clicks30d INT64
sales1d FLOAT64
sales7d FLOAT64
… and 11 more columns
sponsored_products_asins_keywords_report_stream (27 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
advertised_asin STRING
campaign_name STRING
campaign_id INT64
ad_group_name STRING
ad_group_id INT64
keyword_id INT64
keyword STRING
purchased_asin STRING
advertised_sku STRING
campaign_budget_currency_code STRING
match_type STRING
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
units_sold_clicks30d INT64
units_sold_other_sku1d INT64
units_sold_other_sku7d INT64
units_sold_other_sku14d INT64
units_sold_other_sku30d INT64
sales_other_sku1d FLOAT64
sales_other_sku7d FLOAT64
sales_other_sku14d FLOAT64
… and 2 more columns
sponsored_products_asins_keywords_report_stream_daily (28 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
advertised_asin STRING
campaign_name STRING
campaign_id INT64
ad_group_name STRING
ad_group_id INT64
keyword_id INT64
keyword STRING
purchased_asin STRING
advertised_sku STRING
campaign_budget_currency_code STRING
match_type STRING
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
units_sold_clicks30d INT64
units_sold_other_sku1d INT64
units_sold_other_sku7d INT64
units_sold_other_sku14d INT64
units_sold_other_sku30d INT64
sales_other_sku1d FLOAT64
sales_other_sku7d FLOAT64
… and 3 more columns
sponsored_products_asins_targets_report_stream (28 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
advertised_asin STRING
campaign_name STRING
campaign_id INT64
ad_group_name STRING
ad_group_id INT64
purchased_asin STRING
advertised_sku STRING
campaign_budget_currency_code STRING
match_type STRING
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
units_sold_clicks30d INT64
units_sold_other_sku1d INT64
units_sold_other_sku7d INT64
units_sold_other_sku14d INT64
units_sold_other_sku30d INT64
sales_other_sku1d FLOAT64
sales_other_sku7d FLOAT64
sales_other_sku14d FLOAT64
sales_other_sku30d FLOAT64
keyword_id INT64
… and 3 more columns
sponsored_products_asins_targets_report_stream_daily (29 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
advertised_asin STRING
campaign_name STRING
campaign_id INT64
ad_group_name STRING
ad_group_id INT64
purchased_asin STRING
advertised_sku STRING
campaign_budget_currency_code STRING
match_type STRING
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
units_sold_clicks30d INT64
units_sold_other_sku1d INT64
units_sold_other_sku7d INT64
units_sold_other_sku14d INT64
units_sold_other_sku30d INT64
sales_other_sku1d FLOAT64
sales_other_sku7d FLOAT64
sales_other_sku14d FLOAT64
sales_other_sku30d FLOAT64
… and 4 more columns
sponsored_products_campaigns_report_stream (38 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
campaign_id INT64
campaign_name STRING
campaign_status STRING
campaign_budget_amount FLOAT64
campaign_rule_based_budget_amount FLOAT64
campaign_applicable_budget_rule_id STRING
campaign_applicable_budget_rule_name STRING
impressions INT64
clicks INT64
cost FLOAT64
purchases1d INT64
purchases7d INT64
purchases14d INT64
purchases30d INT64
purchases_same_sku1d INT64
purchases_same_sku7d INT64
purchases_same_sku14d INT64
purchases_same_sku30d INT64
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
units_sold_clicks30d INT64
… and 13 more columns
sponsored_products_campaigns_report_stream_daily (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
campaign_id INT64
campaign_name STRING
campaign_status STRING
campaign_budget_amount FLOAT64
campaign_rule_based_budget_amount FLOAT64
campaign_applicable_budget_rule_id STRING
campaign_applicable_budget_rule_name STRING
impressions INT64
clicks INT64
cost FLOAT64
purchases1d INT64
purchases7d INT64
purchases14d INT64
purchases30d INT64
purchases_same_sku1d INT64
purchases_same_sku7d INT64
purchases_same_sku14d INT64
purchases_same_sku30d INT64
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
… and 14 more columns
sponsored_products_keywords_report_stream (38 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
keyword_id INT64
campaign_name STRING
campaign_id INT64
ad_group_name STRING
ad_group_id INT64
keyword STRING
match_type STRING
impressions INT64
clicks INT64
cost FLOAT64
purchases1d INT64
purchases7d INT64
purchases14d INT64
purchases30d INT64
purchases_same_sku1d INT64
purchases_same_sku7d INT64
purchases_same_sku14d INT64
purchases_same_sku30d INT64
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
units_sold_clicks30d INT64
… and 13 more columns
sponsored_products_keywords_report_stream_daily (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
keyword_id INT64
campaign_name STRING
campaign_id INT64
ad_group_name STRING
ad_group_id INT64
keyword STRING
match_type STRING
impressions INT64
clicks INT64
cost FLOAT64
purchases1d INT64
purchases7d INT64
purchases14d INT64
purchases30d INT64
purchases_same_sku1d INT64
purchases_same_sku7d INT64
purchases_same_sku14d INT64
purchases_same_sku30d INT64
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
… and 14 more columns
sponsored_products_productads_report_stream (38 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
ad_id INT64
campaign_name STRING
campaign_id INT64
ad_group_name STRING
ad_group_id INT64
impressions INT64
clicks INT64
cost FLOAT64
campaign_budget_currency_code STRING
advertised_asin STRING
purchases1d INT64
purchases7d INT64
purchases14d INT64
purchases30d INT64
purchases_same_sku1d INT64
purchases_same_sku7d INT64
purchases_same_sku14d INT64
purchases_same_sku30d INT64
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
units_sold_clicks30d INT64
… and 13 more columns
sponsored_products_productads_report_stream_daily (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
ad_id INT64
campaign_name STRING
campaign_id INT64
ad_group_name STRING
ad_group_id INT64
impressions INT64
clicks INT64
cost FLOAT64
campaign_budget_currency_code STRING
advertised_asin STRING
purchases1d INT64
purchases7d INT64
purchases14d INT64
purchases30d INT64
purchases_same_sku1d INT64
purchases_same_sku7d INT64
purchases_same_sku14d INT64
purchases_same_sku30d INT64
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
… and 14 more columns
sponsored_products_targets_report_stream (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
profile_id INT64
report_date STRING
keyword_id INT64
campaign_name STRING
campaign_id INT64
ad_group_name STRING
ad_group_id INT64
keyword STRING
targeting STRING
keyword_type STRING
impressions INT64
clicks INT64
cost FLOAT64
purchases1d INT64
purchases7d INT64
purchases14d INT64
purchases30d INT64
purchases_same_sku1d INT64
purchases_same_sku7d INT64
purchases_same_sku14d INT64
purchases_same_sku30d INT64
units_sold_clicks1d INT64
units_sold_clicks7d INT64
units_sold_clicks14d INT64
… and 14 more columns
sponsored_products_targets_report_stream_daily (40 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
profile_id INT64
report_date STRING
keyword_id INT64
campaign_name STRING
campaign_id INT64
ad_group_name STRING
ad_group_id INT64
keyword STRING
targeting STRING
keyword_type STRING
impressions INT64
clicks INT64
cost FLOAT64
purchases1d INT64
purchases7d INT64
purchases14d INT64
purchases30d INT64
purchases_same_sku1d INT64
purchases_same_sku7d INT64
purchases_same_sku14d INT64
purchases_same_sku30d INT64
units_sold_clicks1d INT64
units_sold_clicks7d INT64
… and 15 more columns

After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where Amazon 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 Amazon Ads?

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

It depends on how much history is in your Amazon 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 Amazon Ads’s schema changes?

Section titled “What happens when Amazon 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 Amazon 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 Amazon 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 Amazon Ads connector in Kaivo and all of its synced data is deleted with it.

Compare spend and sales across sponsored_product_campaigns, sponsored_brands_campaigns, and sponsored_display_campaigns.

Use sponsored_product_keywords with the report streams to find terms that spend without converting.

Track portfolios and budget rules to see how each profile is pacing against its budget.

Join Amazon Ads spend with your order data in BigQuery to get advertising cost of sale by product.

Use Amazon Ads data in your AI and BI tools

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

Once Amazon 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 Amazon 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 Amazon Ads connector pricing and plan details.