{"sources":[{"id":"57a0cb319c10a395853afc0671579bf7ef0ff45d8a40c88ed9d2a5f61b4169a4","name":"Profit by SKU & Date","tableName":"amazon_profit_by_sku_and_date","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":"Date of the profit calculation in the local timezone of the marketplace. Each combination of marketplace, connection, child ASIN, SKU and date has a single row."},{"name":"parent_asin","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"profit","type":"NUMBER","nullable":false,"description":"Net profit after subtracting sales_tax once. refund_cost is signed: cash outflows are negative and fee reversals are positive. Refunded tax is excluded.","definition":"amazon_profit_by_sku_and_date.total_sales - amazon_profit_by_sku_and_date.sales_tax - amazon_profit_by_sku_and_date.total_fees - amazon_profit_by_sku_and_date.cogs_total - amazon_profit_by_sku_and_date.ad_spend + amazon_profit_by_sku_and_date.refund_cost"},{"name":"total_cost","type":"NUMBER","nullable":false,"description":"Sales tax included in prices, fees, COGS and ad spend, minus signed refund_cost.","definition":"amazon_profit_by_sku_and_date.sales_tax + amazon_profit_by_sku_and_date.total_fees + amazon_profit_by_sku_and_date.cogs_total + amazon_profit_by_sku_and_date.ad_spend - amazon_profit_by_sku_and_date.refund_cost"},{"name":"acos","type":"NUMBER","nullable":false,"description":"Advertising Cost of Sales as a percentage.","definition":"amazon_profit_by_sku_and_date.ad_sales === 0 ? null : amazon_profit_by_sku_and_date.ad_spend / amazon_profit_by_sku_and_date.ad_sales * 100"},{"name":"tacos","type":"NUMBER","nullable":false,"description":"Total Advertising Cost of Sales as a percentage.","definition":"amazon_profit_by_sku_and_date.total_sales === 0 ? null : amazon_profit_by_sku_and_date.ad_spend / amazon_profit_by_sku_and_date.total_sales * 100"},{"name":"roi","type":"NUMBER","nullable":false,"description":"Return on Investment as a percentage.","definition":"amazon_profit_by_sku_and_date.total_cost === 0 ? null : amazon_profit_by_sku_and_date.profit / amazon_profit_by_sku_and_date.total_cost * 100"},{"name":"total_sales","type":"NUMBER","nullable":false,"description":"Sales from shipped order items. Includes tax where Amazon reports prices with tax; see sales_tax.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' ? (amazon_order_items_with_cogs.item_price_value ?? 0) + (amazon_order_items_with_cogs.item_shipping_price_value ?? 0) - (amazon_order_items_with_cogs.item_ship_promotion_discount_value ?? 0) : 0)"},{"name":"sales_tax","type":"NUMBER","nullable":false,"description":"Positive tax amount on shipped item and buyer-paid shipping prices for marketplaces whose selling prices include tax (all supported marketplaces except the US and Canada). Subtracted once from profit. Excludes gift-wrap tax; the P&L API uses item and gift-wrap tax while its shipping cost offsets buyer-paid shipping tax, so its sales_tax can differ.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && [\"A1AM78C64UM0Y8\",\"A2Q3Y263D00KWC\",\"A28R8C7NBKEWEA\",\"A1RKKUPIHCS9HS\",\"A1F83G8C2ARO7P\",\"A13V1IB3VIYZZH\",\"AMEN7PMS3EDWL\",\"A1805IZSGTT6HS\",\"A1PA6795UKMFR9\",\"APJ6JRA9NG5V4\",\"A2NODRKZP88ZB9\",\"AE08WJ6YKNBMC\",\"A1C3SOZRARQ6R3\",\"ARBP9OOSHTCHU\",\"A33AVAJ2PDY3EV\",\"A17E79C6D8DWNP\",\"A2VIGQ35RCS4UG\",\"A21TJRUUN4KGV\",\"A19VAU5U5O7RUS\",\"A39IBJ37TRP1C6\",\"A1VC38T7YXB528\"].includes(amazon_order_items_with_cogs.marketplace_id) ? (amazon_order_items_with_cogs.item_tax_value ?? 0) + (amazon_order_items_with_cogs.item_shipping_tax_value ?? 0) : 0)"},{"name":"sales_tax_missing_items","type":"NUMBER","nullable":false,"description":"Number of shipped order items with a non-zero item price and no item tax, or a net shipping charge and no shipping tax, for marketplaces whose selling prices include tax (all supported marketplaces except the US and Canada). A positive count means sales_tax may be incomplete.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && [\"A1AM78C64UM0Y8\",\"A2Q3Y263D00KWC\",\"A28R8C7NBKEWEA\",\"A1RKKUPIHCS9HS\",\"A1F83G8C2ARO7P\",\"A13V1IB3VIYZZH\",\"AMEN7PMS3EDWL\",\"A1805IZSGTT6HS\",\"A1PA6795UKMFR9\",\"APJ6JRA9NG5V4\",\"A2NODRKZP88ZB9\",\"AE08WJ6YKNBMC\",\"A1C3SOZRARQ6R3\",\"ARBP9OOSHTCHU\",\"A33AVAJ2PDY3EV\",\"A17E79C6D8DWNP\",\"A2VIGQ35RCS4UG\",\"A21TJRUUN4KGV\",\"A19VAU5U5O7RUS\",\"A39IBJ37TRP1C6\",\"A1VC38T7YXB528\"].includes(amazon_order_items_with_cogs.marketplace_id) && ((amazon_order_items_with_cogs.item_price_value !== 0 && amazon_order_items_with_cogs.item_tax_value == null) || (amazon_order_items_with_cogs.item_shipping_price_value > (amazon_order_items_with_cogs.item_ship_promotion_discount_value ?? 0) && amazon_order_items_with_cogs.item_shipping_tax_value == null)) ? 1 : 0)"},{"name":"total_sales_b2b","type":"NUMBER","nullable":false,"description":"Total sales from shipped B2B order items (order_is_business=true). Included in total_sales, not additive.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && amazon_order_items_with_cogs.order_is_business ? (amazon_order_items_with_cogs.item_price_value ?? 0) + (amazon_order_items_with_cogs.item_shipping_price_value ?? 0) - (amazon_order_items_with_cogs.item_ship_promotion_discount_value ?? 0) : 0)"},{"name":"total_sales_b2c","type":"NUMBER","nullable":false,"description":"Total sales from shipped B2C order items (order_is_business=false). Included in total_sales, not additive.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && !(amazon_order_items_with_cogs.order_is_business ?? false) ? (amazon_order_items_with_cogs.item_price_value ?? 0) + (amazon_order_items_with_cogs.item_shipping_price_value ?? 0) - (amazon_order_items_with_cogs.item_ship_promotion_discount_value ?? 0) : 0)"},{"name":"unshipped_sales","type":"NUMBER","nullable":false,"description":"Sales from order items with one of unshipped statuses. Not included in total_sales.","definition":"sum(String(amazon_order_items_with_cogs.item_status).toLowerCase().includes('unshipped') ? (amazon_order_items_with_cogs.item_price_value ?? 0) + (amazon_order_items_with_cogs.item_shipping_price_value ?? 0) - (amazon_order_items_with_cogs.item_ship_promotion_discount_value ?? 0) : 0)"},{"name":"total_units_b2b","type":"NUMBER","nullable":false,"description":"Ordered units from order line items where order_is_business is true, excluding canceled items. Includes unshipped. Not the same as total_units_sold_b2b, which counts shipped units only.","definition":"sum((amazon_order_items_with_cogs.item_status == null || !String(amazon_order_items_with_cogs.item_status).toLowerCase().includes('cancel')) && amazon_order_items_with_cogs.order_is_business ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_units_b2c","type":"NUMBER","nullable":false,"description":"Ordered units from order line items where order_is_business is false, excluding canceled items. Includes unshipped.","definition":"sum((amazon_order_items_with_cogs.item_status == null || !String(amazon_order_items_with_cogs.item_status).toLowerCase().includes('cancel')) && !(amazon_order_items_with_cogs.order_is_business ?? false) ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_units_sold","type":"NUMBER","nullable":false,"description":"Total quantity sold from shipped order items.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_units_sold_b2b","type":"NUMBER","nullable":false,"description":"Shipped units from order line items where order_is_business is true. Included in total_units_sold, not additive.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && amazon_order_items_with_cogs.order_is_business ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_units_sold_b2c","type":"NUMBER","nullable":false,"description":"Shipped units from order line items where order_is_business is false. Included in total_units_sold, not additive.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && !(amazon_order_items_with_cogs.order_is_business ?? false) ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_orders","type":"NUMBER","nullable":false,"description":"Distinct shipped orders this item appeared in.","definition":"countDistinct(amazon_order_items_with_cogs.item_status === 'Shipped' ? amazon_order_items_with_cogs.amazon_order_id : null)"},{"name":"refund_count","type":"NUMBER","nullable":false,"description":"Count of settlement_type REFUND financial events on posted date. Not SUM(quantity). A day can exist here with no sales if refunds posted that day.","definition":"count(amazon_settlements_with_cogs.settlement_type === 'REFUND')"},{"name":"refund_cost","type":"NUMBER","nullable":false,"description":"Refund principal and fee reversals on the settlement posting date. Excludes refunded item, shipping and promotion tax. Return COGS is added on the return date. Not part of total_fees.","definition":"(sum(amazon_settlements_with_cogs.settlement_type === 'REFUND' ? (amazon_settlements_with_cogs.refunded_amount ?? 0) + (amazon_settlements_with_cogs.refunded_referral_fee ?? 0) + (amazon_settlements_with_cogs.refund_commission ?? 0) + (amazon_settlements_with_cogs.refund_shipping ?? 0) + (amazon_settlements_with_cogs.refund_shipping_promotion ?? 0) + (amazon_settlements_with_cogs.refund_digital_services_fee ?? 0) : 0)) + (sum(amazon_returns.amazon_return_detailed_disposition != null && String(amazon_returns.amazon_return_detailed_disposition).toUpperCase() === 'SELLABLE' ? (amazon_returns.cogs_total_value ?? 0) : 0)) + (sum(amazon_returns.amazon_return_detailed_disposition != null && String(amazon_returns.amazon_return_detailed_disposition).toUpperCase() !== 'SELLABLE' ? 0 - (amazon_returns.cogs_total_value ?? 0) : 0))"},{"name":"return_units","type":"NUMBER","nullable":false,"description":"Returned units from amazon_returns on return receipt/request date, not payout date.","definition":"sum((amazon_returns.quantity ?? 0))"},{"name":"return_cogs","type":"NUMBER","nullable":false,"description":"Item cost of returned units from amazon_returns on return receipt/request date. Not part of profit.","definition":"sum((amazon_returns.cogs_total_value ?? 0))"},{"name":"cogs_item","type":"NUMBER","nullable":false,"description":"Total item COGS from shipped order items.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' ? amazon_order_items_with_cogs.cogs_item_value : 0)"},{"name":"cogs_shipping","type":"NUMBER","nullable":false,"description":"Total shipping COGS from shipped order items.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' ? amazon_order_items_with_cogs.cogs_shipping_value : 0)"},{"name":"lost_damaged_by_amazon","type":"NUMBER","nullable":false,"description":"Lost or damaged inventory reimbursements and charges on settlement posted date. Stored as a positive cost (settlement cash-flow sign flipped). Included in cogs_total, not in total_fees.","definition":"sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.warehouse_lost ?? 0) + (amazon_settlements_with_cogs.warehouse_lost_manual ?? 0)) : 0)"},{"name":"missing_returns","type":"NUMBER","nullable":false,"description":"Missing-from-inbound inventory on settlement posted date. Stored as a positive cost (settlement cash-flow sign flipped). Included in cogs_total, not in total_fees.","definition":"sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.missing_from_inbound ?? 0) + (amazon_settlements_with_cogs.missing_from_inbound_clawback ?? 0)) : 0)"},{"name":"cogs_total","type":"NUMBER","nullable":false,"description":"Shipped-order COGS plus lost_damaged_by_amazon and missing_returns on posted date.","definition":"(sum(amazon_order_items_with_cogs.item_status === 'Shipped' ? amazon_order_items_with_cogs.cogs_total_value : 0)) + (sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.warehouse_lost ?? 0) + (amazon_settlements_with_cogs.warehouse_lost_manual ?? 0)) : 0)) + (sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.missing_from_inbound ?? 0) + (amazon_settlements_with_cogs.missing_from_inbound_clawback ?? 0)) : 0))"},{"name":"cogs_present","type":"LOGIC","nullable":true,"description":"True when every shipped order item and return in this profit row has an applicable uploaded COGS record. False if any is missing; null when neither contributes."},{"name":"total_fees","type":"NUMBER","nullable":false,"description":"Positive cost (settlement cash-flow sign flipped). Order fees use the order date when available; inbound, storage and similar fees use the posting date. Advertising is in ad_spend, inventory adjustments in cogs_total and refunds in refund_cost. Seller-retained sales tax on items, shipping and gift-wrap is excluded before the sign flip, accounting for withheld tax and marketplace-facilitator VAT. promotion_tax_discount remains included in fees. Do not add this to amazon_settlements_with_cogs.total_non_principal_amount, which also includes non-fee payments.","definition":"(sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.total_fees ?? 0) - (amazon_settlements_with_cogs.cost_of_advertising ?? 0) - ((amazon_settlements_with_cogs.fba_inbound_convenience_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_program_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_placement_service_fee ?? 0) + (amazon_settlements_with_cogs.fba_storage_fee ?? 0) + (amazon_settlements_with_cogs.long_term_storage_fee ?? 0) + (amazon_settlements_with_cogs.fba_disposal_fee ?? 0) + (amazon_settlements_with_cogs.removal_complete ?? 0) + (amazon_settlements_with_cogs.subscription_fee ?? 0) + (amazon_settlements_with_cogs.compensated_clawback ?? 0) + (amazon_settlements_with_cogs.warehouse_damage ?? 0) + (amazon_settlements_with_cogs.reversal_reimbursement ?? 0) + (amazon_settlements_with_cogs.free_replacement_refund_items ?? 0) + (amazon_settlements_with_cogs.liquidations_revenue ?? 0) + (amazon_settlements_with_cogs.liquidations_other ?? 0) + (amazon_settlements_with_cogs.liquidations_brokerage_fee ?? 0) + (amazon_settlements_with_cogs.fba_inventory_reimbursement_re_evaluation ?? 0) + (amazon_settlements_with_cogs.warehouse_lost ?? 0) + (amazon_settlements_with_cogs.warehouse_lost_manual ?? 0) + (amazon_settlements_with_cogs.missing_from_inbound ?? 0) + (amazon_settlements_with_cogs.missing_from_inbound_clawback ?? 0)) - ((amazon_settlements_with_cogs.item_tax ?? 0) + (amazon_settlements_with_cogs.item_shipping_tax ?? 0) + (amazon_settlements_with_cogs.item_gift_wrap_tax ?? 0) + (amazon_settlements_with_cogs.item_withheld_tax ?? 0) + (amazon_settlements_with_cogs.marketplace_facilitator_vat ?? 0) + (amazon_settlements_with_cogs.refund_tax ?? 0) + (amazon_settlements_with_cogs.refund_shipping_tax ?? 0) + (amazon_settlements_with_cogs.refund_item_withheld_tax ?? 0) + (amazon_settlements_with_cogs.refund_marketplace_facilitator_vat ?? 0))) : 0)) + (sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.fba_inbound_convenience_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_program_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_placement_service_fee ?? 0) + (amazon_settlements_with_cogs.fba_storage_fee ?? 0) + (amazon_settlements_with_cogs.long_term_storage_fee ?? 0) + (amazon_settlements_with_cogs.fba_disposal_fee ?? 0) + (amazon_settlements_with_cogs.removal_complete ?? 0) + (amazon_settlements_with_cogs.subscription_fee ?? 0) + (amazon_settlements_with_cogs.compensated_clawback ?? 0) + (amazon_settlements_with_cogs.warehouse_damage ?? 0) + (amazon_settlements_with_cogs.reversal_reimbursement ?? 0) + (amazon_settlements_with_cogs.free_replacement_refund_items ?? 0) + (amazon_settlements_with_cogs.liquidations_revenue ?? 0) + (amazon_settlements_with_cogs.liquidations_other ?? 0) + (amazon_settlements_with_cogs.liquidations_brokerage_fee ?? 0) + (amazon_settlements_with_cogs.fba_inventory_reimbursement_re_evaluation ?? 0)) : 0))"},{"name":"total_selling_fees","type":"NUMBER","nullable":false,"description":"Referral fee on non-REFUND settlements. Refunded referral fee and refund commission are in refund_cost, not here. Stored as a positive cost. Subtract from sales.","definition":"sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - (amazon_settlements_with_cogs.total_selling_fees ?? 0) : 0)"},{"name":"fba_fees","type":"NUMBER","nullable":false,"description":"Per-unit and other order-tied FBA fees use COALESCE(order_date, posted date); inbound, storage, LTSF and disposal use posted date. Stored as a positive cost. Subtract from sales.","definition":"sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.fba_per_unit_fulfillment_fee ?? 0) + (amazon_settlements_with_cogs.fba_transportation_fee ?? 0) + (amazon_settlements_with_cogs.fba_customer_return_per_unit_fee ?? 0) + (amazon_settlements_with_cogs.fba_other ?? 0)) : 0) + sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.fba_storage_fee ?? 0) + (amazon_settlements_with_cogs.fba_disposal_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_convenience_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_placement_service_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_program_fee ?? 0) + (amazon_settlements_with_cogs.fba_inventory_reimbursement_re_evaluation ?? 0) + (amazon_settlements_with_cogs.long_term_storage_fee ?? 0)) : 0)"},{"name":"awd_fees","type":"NUMBER","nullable":false,"description":"AWD fees from Amazon settlements. Stored as a positive cost. Subtract from sales.","definition":"sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.awd_processing_fee ?? 0) + (amazon_settlements_with_cogs.awd_transportation_fee ?? 0) + (amazon_settlements_with_cogs.awd_storage_fee ?? 0) + (amazon_settlements_with_cogs.awd_processing_fee_discount ?? 0) + (amazon_settlements_with_cogs.awd_storage_fee_discount ?? 0) + (amazon_settlements_with_cogs.awd_transportation_fee_discount ?? 0)) : 0)"},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":"Ad spend attributed to this SKU. Sponsored Products and Sponsored Display use advertised-product reports. Sponsored Brands and Amazon DSP spend is estimated. Sponsored Brands spend uses eligible ad-creative ASINs, with same-day ad cost rescaled to campaign cost. Remaining spend uses campaign purchased-product shares. Without purchased-product data, it uses Seller Central sales, orders and sessions, or an even split among known campaign ASINs. Sales and orders allocate campaign totals by purchased-product shares, with the same fallback signals. ASIN spend and sales are split across available SKUs by same-day order-sales shares; orders use order-count shares. A zero total uses an even split for that measure. With no SKU rows, sku is null. Campaigns without any ASIN signal remain account-only. Amazon DSP line item spend is allocated by each ASIN's share of total product sales (including brand halo) on that day. Without positive sales, it uses purchases, then an even split among reported ASINs. Spend and promoted sales use same-day SKU order-sales shares; promoted orders and units use order-count shares. A zero total uses an even split for that measure. With no SKU rows, sku is null. Line items with no ASIN conversion rows remain account-only. Amazon DSP spend is DSP totalCost: supply cost plus Amazon fees, excluding third-party fees paid by the agency. Sponsored Television has no SKU allocation and appears only in amazon_profit_by_date.ad_spend. Unallocated DSP spend also appears only in amazon_profit_by_date.ad_spend.","definition":"sum(amazon_ads_performance_by_child_asin_and_date.ad_spend) + sum(refined_ads_estimated_dsp_performance_by_asin.estimatedCost)"},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed ad sales of this SKU only (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Excludes brand halo; Sponsored Brands has no same-SKU sales. Includes Amazon DSP (14d attribution) for the promoted ASIN only, excluding brand halo.","definition":"sum(amazon_ads_performance_by_child_asin_and_date.ad_sales_same_sku) + sum(refined_ads_estimated_dsp_performance_by_asin.salesPromoted)"},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Click-attributed orders of the advertised or promoted product for Sponsored Products and Sponsored Display (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Sponsored Brands and Sponsored Television contribute no SKU orders. Includes Amazon DSP (14d attribution) for the promoted ASIN only, excluding brand halo.","definition":"sum(amazon_ads_performance_by_child_asin_and_date.ad_orders_same_sku) + sum(refined_ads_estimated_dsp_performance_by_asin.ordersPromoted)"},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Sponsored Products same-SKU click-attributed units (7d) plus Sponsored Display total click-attributed units (14d, may include other products). Sponsored Brands and Sponsored Television contribute no SKU units. Includes Amazon DSP (14d attribution) for the promoted ASIN only, excluding brand halo.","definition":"sum(amazon_ads_performance_by_child_asin_and_date.ad_units_sold_same_sku) + sum(refined_ads_estimated_dsp_performance_by_asin.unitsSoldPromoted)"},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Attributed ad clicks. Excludes Sponsored Brands, Sponsored Television and Amazon DSP (not available per ASIN).","definition":"sum(amazon_ads_performance_by_child_asin_and_date.ad_clicks)"},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Attributed ad impressions. Excludes Sponsored Brands, Sponsored Television and Amazon DSP (not available per ASIN).","definition":"sum(amazon_ads_performance_by_child_asin_and_date.ad_impressions)"},{"name":"avg_buybox_percentage","type":"NUMBER","nullable":false,"description":"Buy box percentage for the child ASIN on this date. Buy box percentage is the share of page views where the buy box (add to cart) appeared for your offers. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"amazon_sales_and_traffic_with_cogs.buybox_percentage"},{"name":"avg_buybox_percentage_b2b","type":"NUMBER","nullable":false,"description":"B2B buy box percentage for the child ASIN on this date, from Amazon Sales and Traffic buyBoxPercentageB2B. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"amazon_sales_and_traffic_with_cogs.buybox_percentage_b2b"},{"name":"avg_buybox_percentage_b2c","type":"NUMBER","nullable":false,"description":"B2C buy box percentage for the child ASIN on this date. Amazon does not publish B2C buy box; reconstructed from overall and B2B buy box weighted by page views. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"((amazon_sales_and_traffic_with_cogs.buybox_percentage ?? 0) * (amazon_sales_and_traffic_with_cogs.page_views ?? 0) - (amazon_sales_and_traffic_with_cogs.buybox_percentage_b2b ?? 0) * (amazon_sales_and_traffic_with_cogs.page_views_b2b ?? 0)) / ((amazon_sales_and_traffic_with_cogs.page_views ?? 0) - (amazon_sales_and_traffic_with_cogs.page_views_b2b ?? 0))"},{"name":"total_sessions","type":"NUMBER","nullable":false,"description":"Sessions for the child ASIN on this date. A session is a visit to your Amazon product detail pages via browser or mobile app. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(amazon_sales_and_traffic_with_cogs.session)"},{"name":"sessions_b2b","type":"NUMBER","nullable":false,"description":"B2B sessions for the child ASIN on this date, from Amazon Sales and Traffic sessionsB2B. Included in total_sessions, not additive. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(amazon_sales_and_traffic_with_cogs.sessions_b2b)"},{"name":"sessions_b2c","type":"NUMBER","nullable":false,"description":"B2C sessions for the child ASIN on this date, calculated as total_sessions minus sessions_b2b. Amazon does not publish a B2C sessions field. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(Math.max((amazon_sales_and_traffic_with_cogs.session ?? 0) - (amazon_sales_and_traffic_with_cogs.sessions_b2b ?? 0), 0))"},{"name":"total_page_views","type":"NUMBER","nullable":false,"description":"Page views for the child ASIN on this date. Page views count visits to your Amazon product detail pages via browser or mobile app. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(amazon_sales_and_traffic_with_cogs.page_views)"},{"name":"page_views_b2b","type":"NUMBER","nullable":false,"description":"B2B page views for the child ASIN on this date, from Amazon Sales and Traffic pageViewsB2B. Included in total_page_views, not additive. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(amazon_sales_and_traffic_with_cogs.page_views_b2b)"},{"name":"page_views_b2c","type":"NUMBER","nullable":false,"description":"B2C page views for the child ASIN on this date, calculated as total_page_views minus page_views_b2b. Amazon does not publish a B2C page views field. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(Math.max((amazon_sales_and_traffic_with_cogs.page_views ?? 0) - (amazon_sales_and_traffic_with_cogs.page_views_b2b ?? 0), 0))"},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"product_brand","type":"TEXT","nullable":false,"description":null},{"name":"product_category_root","type":"TEXT","nullable":false,"description":null},{"name":"product_category_node","type":"TEXT","nullable":false,"description":null},{"name":"product_image_url","type":"TEXT","nullable":false,"description":null},{"name":"product_url","type":"TEXT","nullable":false,"description":null},{"name":"currency","type":"TEXT","nullable":false,"description":null}],"userManaged":false,"isPremium":true,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Daily profit and cost breakdown per SKU and child ASIN from shipped orders, settlement fees, COGS and ad spend. Prefer this table for SKU and child-ASIN profit drill-down instead of calculating manually from other tables. Sponsored Products and Sponsored Display use reported advertised-product spend, sales and orders. Display units include all click-attributed purchases, not just the promoted product. Sponsored Brands contributes estimated spend but no same-SKU conversions. Amazon DSP (estimated spend) contributes promoted-ASIN sales, orders and units. Sponsored Brands spend uses eligible ad-creative ASINs, with same-day ad cost rescaled to campaign cost. Remaining spend uses campaign purchased-product shares. Without purchased-product data, it uses Seller Central sales, orders and sessions, or an even split among known campaign ASINs. Sales and orders allocate campaign totals by purchased-product shares, with the same fallback signals. ASIN spend and sales are split across available SKUs by same-day order-sales shares; orders use order-count shares. A zero total uses an even split for that measure. With no SKU rows, sku is null. Campaigns without any ASIN signal remain account-only. Amazon DSP line item spend is allocated by each ASIN's share of total product sales (including brand halo) on that day. Without positive sales, it uses purchases, then an even split among reported ASINs. Spend and promoted sales use same-day SKU order-sales shares; promoted orders and units use order-count shares. A zero total uses an even split for that measure. With no SKU rows, sku is null. Line items with no ASIN conversion rows remain account-only. Sponsored Television is account-only because its campaign report has no product allocation. Missing or delayed estimates can understate SKU ad spend and overstate SKU profit. Use amazon_profit_by_date for account-level P&L; SUM of SKU profit is not the account profit number.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"10am, 1pm, 4pm"},"sources":["connections","raw_ads_api_report_advertised_products_sd","raw_ads_api_report_advertised_products_sp","raw_ads_api_report_legacy_campaign_sb_all","raw_ads_api_report_purchased_products_sb","raw_ads_api_report_legacy_ad_sb_all","raw_ads_api_export_ads","refined_ads_estimated_sb_performance_by_asin","raw_ads_api_report_campaign_ad_creative_dsp","raw_ads_api_report_product_dsp","raw_amazon_cogs","raw_sp_api_report_listings_data","raw_sp_api_report_orders","raw_sp_api_report_sales_and_traffic","raw_sp_api_report_fba_fulfillment_customer_returns","raw_sp_api_report_flat_file_returns_data_by_return_date","refined_ads_estimated_dsp_performance_by_asin","refined_sp_api_finances_transactions","refined_products_by_child_asin"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["pnl","p&l","net profit","sku profit","contribution margin","margin","sessions","buy box","buybox"]},{"id":"b24cd69c061d107e5d5897d6fd06f95cd0432b3ed51b04b4ad8207e601da964c","name":"Profit by Date","tableName":"amazon_profit_by_date","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"currency","type":"TEXT","nullable":false,"description":null},{"name":"date","type":"DATE","nullable":false,"description":"Date of the profit calculation in the marketplace timezone. Each organization, store, marketplace, seller, currency and date has one row."},{"name":"total_sales","type":"NUMBER","nullable":false,"description":"Sales from shipped order items. Includes tax where Amazon reports prices with tax; see sales_tax.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' ? (amazon_order_items_with_cogs.item_price_value ?? 0) + (amazon_order_items_with_cogs.item_shipping_price_value ?? 0) - (amazon_order_items_with_cogs.item_ship_promotion_discount_value ?? 0) : 0)"},{"name":"sales_tax","type":"NUMBER","nullable":false,"description":"Positive tax amount on shipped item and buyer-paid shipping prices for marketplaces whose selling prices include tax (all supported marketplaces except the US and Canada). Subtracted once from profit. Excludes gift-wrap tax; the P&L API uses item and gift-wrap tax while its shipping cost offsets buyer-paid shipping tax, so its sales_tax can differ.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && [\"A1AM78C64UM0Y8\",\"A2Q3Y263D00KWC\",\"A28R8C7NBKEWEA\",\"A1RKKUPIHCS9HS\",\"A1F83G8C2ARO7P\",\"A13V1IB3VIYZZH\",\"AMEN7PMS3EDWL\",\"A1805IZSGTT6HS\",\"A1PA6795UKMFR9\",\"APJ6JRA9NG5V4\",\"A2NODRKZP88ZB9\",\"AE08WJ6YKNBMC\",\"A1C3SOZRARQ6R3\",\"ARBP9OOSHTCHU\",\"A33AVAJ2PDY3EV\",\"A17E79C6D8DWNP\",\"A2VIGQ35RCS4UG\",\"A21TJRUUN4KGV\",\"A19VAU5U5O7RUS\",\"A39IBJ37TRP1C6\",\"A1VC38T7YXB528\"].includes(amazon_order_items_with_cogs.marketplace_id) ? (amazon_order_items_with_cogs.item_tax_value ?? 0) + (amazon_order_items_with_cogs.item_shipping_tax_value ?? 0) : 0)"},{"name":"sales_tax_missing_items","type":"NUMBER","nullable":false,"description":"Number of shipped order items with a non-zero item price and no item tax, or a net shipping charge and no shipping tax, for marketplaces whose selling prices include tax (all supported marketplaces except the US and Canada). A positive count means sales_tax may be incomplete.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && [\"A1AM78C64UM0Y8\",\"A2Q3Y263D00KWC\",\"A28R8C7NBKEWEA\",\"A1RKKUPIHCS9HS\",\"A1F83G8C2ARO7P\",\"A13V1IB3VIYZZH\",\"AMEN7PMS3EDWL\",\"A1805IZSGTT6HS\",\"A1PA6795UKMFR9\",\"APJ6JRA9NG5V4\",\"A2NODRKZP88ZB9\",\"AE08WJ6YKNBMC\",\"A1C3SOZRARQ6R3\",\"ARBP9OOSHTCHU\",\"A33AVAJ2PDY3EV\",\"A17E79C6D8DWNP\",\"A2VIGQ35RCS4UG\",\"A21TJRUUN4KGV\",\"A19VAU5U5O7RUS\",\"A39IBJ37TRP1C6\",\"A1VC38T7YXB528\"].includes(amazon_order_items_with_cogs.marketplace_id) && ((amazon_order_items_with_cogs.item_price_value !== 0 && amazon_order_items_with_cogs.item_tax_value == null) || (amazon_order_items_with_cogs.item_shipping_price_value > (amazon_order_items_with_cogs.item_ship_promotion_discount_value ?? 0) && amazon_order_items_with_cogs.item_shipping_tax_value == null)) ? 1 : 0)"},{"name":"total_sales_b2b","type":"NUMBER","nullable":false,"description":"Total sales from shipped B2B order items (order_is_business=true). Included in total_sales, not additive.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && amazon_order_items_with_cogs.order_is_business ? (amazon_order_items_with_cogs.item_price_value ?? 0) + (amazon_order_items_with_cogs.item_shipping_price_value ?? 0) - (amazon_order_items_with_cogs.item_ship_promotion_discount_value ?? 0) : 0)"},{"name":"total_sales_b2c","type":"NUMBER","nullable":false,"description":"Total sales from shipped B2C order items (order_is_business=false). Included in total_sales, not additive.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && !(amazon_order_items_with_cogs.order_is_business ?? false) ? (amazon_order_items_with_cogs.item_price_value ?? 0) + (amazon_order_items_with_cogs.item_shipping_price_value ?? 0) - (amazon_order_items_with_cogs.item_ship_promotion_discount_value ?? 0) : 0)"},{"name":"unshipped_sales","type":"NUMBER","nullable":false,"description":"Sales from order items with one of unshipped statuses. Not included in total_sales.","definition":"sum(String(amazon_order_items_with_cogs.item_status).toLowerCase().includes('unshipped') ? (amazon_order_items_with_cogs.item_price_value ?? 0) + (amazon_order_items_with_cogs.item_shipping_price_value ?? 0) - (amazon_order_items_with_cogs.item_ship_promotion_discount_value ?? 0) : 0)"},{"name":"total_units_b2b","type":"NUMBER","nullable":false,"description":"Ordered units from order line items where order_is_business is true, excluding canceled items. Includes unshipped. Not the same as total_units_sold_b2b, which counts shipped units only.","definition":"sum((amazon_order_items_with_cogs.item_status == null || !String(amazon_order_items_with_cogs.item_status).toLowerCase().includes('cancel')) && amazon_order_items_with_cogs.order_is_business ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_units_b2c","type":"NUMBER","nullable":false,"description":"Ordered units from order line items where order_is_business is false, excluding canceled items. Includes unshipped.","definition":"sum((amazon_order_items_with_cogs.item_status == null || !String(amazon_order_items_with_cogs.item_status).toLowerCase().includes('cancel')) && !(amazon_order_items_with_cogs.order_is_business ?? false) ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_units_sold","type":"NUMBER","nullable":false,"description":"Total quantity sold from shipped order items.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_units_sold_b2b","type":"NUMBER","nullable":false,"description":"Shipped units from order line items where order_is_business is true. Included in total_units_sold, not additive.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && amazon_order_items_with_cogs.order_is_business ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_units_sold_b2c","type":"NUMBER","nullable":false,"description":"Shipped units from order line items where order_is_business is false. Included in total_units_sold, not additive.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && !(amazon_order_items_with_cogs.order_is_business ?? false) ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_orders","type":"NUMBER","nullable":false,"description":"Distinct shipped orders this item appeared in.","definition":"countDistinct(amazon_order_items_with_cogs.item_status === 'Shipped' ? amazon_order_items_with_cogs.amazon_order_id : null)"},{"name":"refund_count","type":"NUMBER","nullable":false,"description":"Count of settlement_type REFUND financial events on posted date. Not SUM(quantity). A day can exist here with no sales if refunds posted that day.","definition":"count(amazon_settlements_with_cogs.settlement_type === 'REFUND')"},{"name":"refund_cost","type":"NUMBER","nullable":false,"description":"Refund principal and fee reversals on the settlement posting date. Excludes refunded item, shipping and promotion tax. Return COGS is added on the return date. Not part of total_fees.","definition":"(sum(amazon_settlements_with_cogs.settlement_type === 'REFUND' ? (amazon_settlements_with_cogs.refunded_amount ?? 0) + (amazon_settlements_with_cogs.refunded_referral_fee ?? 0) + (amazon_settlements_with_cogs.refund_commission ?? 0) + (amazon_settlements_with_cogs.refund_shipping ?? 0) + (amazon_settlements_with_cogs.refund_shipping_promotion ?? 0) + (amazon_settlements_with_cogs.refund_digital_services_fee ?? 0) : 0)) + (sum(amazon_returns.amazon_return_detailed_disposition != null && String(amazon_returns.amazon_return_detailed_disposition).toUpperCase() === 'SELLABLE' ? (amazon_returns.cogs_total_value ?? 0) : 0)) + (sum(amazon_returns.amazon_return_detailed_disposition != null && String(amazon_returns.amazon_return_detailed_disposition).toUpperCase() !== 'SELLABLE' ? 0 - (amazon_returns.cogs_total_value ?? 0) : 0))"},{"name":"return_units","type":"NUMBER","nullable":false,"description":"Returned units from amazon_returns on return receipt/request date, not payout date.","definition":"sum((amazon_returns.quantity ?? 0))"},{"name":"return_cogs","type":"NUMBER","nullable":false,"description":"Item cost of returned units from amazon_returns on return receipt/request date. Not part of profit.","definition":"sum((amazon_returns.cogs_total_value ?? 0))"},{"name":"cogs_item","type":"NUMBER","nullable":false,"description":"Total item COGS from shipped order items.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' ? amazon_order_items_with_cogs.cogs_item_value : 0)"},{"name":"cogs_shipping","type":"NUMBER","nullable":false,"description":"Total shipping COGS from shipped order items.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' ? amazon_order_items_with_cogs.cogs_shipping_value : 0)"},{"name":"lost_damaged_by_amazon","type":"NUMBER","nullable":false,"description":"Lost or damaged inventory reimbursements and charges on settlement posted date. Stored as a positive cost (settlement cash-flow sign flipped). Included in cogs_total, not in total_fees.","definition":"sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.warehouse_lost ?? 0) + (amazon_settlements_with_cogs.warehouse_lost_manual ?? 0)) : 0)"},{"name":"missing_returns","type":"NUMBER","nullable":false,"description":"Missing-from-inbound inventory on settlement posted date. Stored as a positive cost (settlement cash-flow sign flipped). Included in cogs_total, not in total_fees.","definition":"sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.missing_from_inbound ?? 0) + (amazon_settlements_with_cogs.missing_from_inbound_clawback ?? 0)) : 0)"},{"name":"cogs_total","type":"NUMBER","nullable":false,"description":"Shipped-order COGS plus lost_damaged_by_amazon and missing_returns on posted date.","definition":"(sum(amazon_order_items_with_cogs.item_status === 'Shipped' ? amazon_order_items_with_cogs.cogs_total_value : 0)) + (sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.warehouse_lost ?? 0) + (amazon_settlements_with_cogs.warehouse_lost_manual ?? 0)) : 0)) + (sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.missing_from_inbound ?? 0) + (amazon_settlements_with_cogs.missing_from_inbound_clawback ?? 0)) : 0))"},{"name":"cogs_present","type":"LOGIC","nullable":true,"description":"True when every shipped order item and return in this profit row has an applicable uploaded COGS record. False if any is missing; null when neither contributes."},{"name":"total_fees","type":"NUMBER","nullable":false,"description":"Positive cost (settlement cash-flow sign flipped). Order fees use the order date when available; inbound, storage and similar fees use the posting date. Advertising is in ad_spend, inventory adjustments in cogs_total and refunds in refund_cost. Seller-retained sales tax on items, shipping and gift-wrap is excluded before the sign flip, accounting for withheld tax and marketplace-facilitator VAT. promotion_tax_discount remains included in fees. Do not add this to amazon_settlements_with_cogs.total_non_principal_amount, which also includes non-fee payments.","definition":"(sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.total_fees ?? 0) - (amazon_settlements_with_cogs.cost_of_advertising ?? 0) - ((amazon_settlements_with_cogs.fba_inbound_convenience_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_program_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_placement_service_fee ?? 0) + (amazon_settlements_with_cogs.fba_storage_fee ?? 0) + (amazon_settlements_with_cogs.long_term_storage_fee ?? 0) + (amazon_settlements_with_cogs.fba_disposal_fee ?? 0) + (amazon_settlements_with_cogs.removal_complete ?? 0) + (amazon_settlements_with_cogs.subscription_fee ?? 0) + (amazon_settlements_with_cogs.compensated_clawback ?? 0) + (amazon_settlements_with_cogs.warehouse_damage ?? 0) + (amazon_settlements_with_cogs.reversal_reimbursement ?? 0) + (amazon_settlements_with_cogs.free_replacement_refund_items ?? 0) + (amazon_settlements_with_cogs.liquidations_revenue ?? 0) + (amazon_settlements_with_cogs.liquidations_other ?? 0) + (amazon_settlements_with_cogs.liquidations_brokerage_fee ?? 0) + (amazon_settlements_with_cogs.fba_inventory_reimbursement_re_evaluation ?? 0) + (amazon_settlements_with_cogs.warehouse_lost ?? 0) + (amazon_settlements_with_cogs.warehouse_lost_manual ?? 0) + (amazon_settlements_with_cogs.missing_from_inbound ?? 0) + (amazon_settlements_with_cogs.missing_from_inbound_clawback ?? 0)) - ((amazon_settlements_with_cogs.item_tax ?? 0) + (amazon_settlements_with_cogs.item_shipping_tax ?? 0) + (amazon_settlements_with_cogs.item_gift_wrap_tax ?? 0) + (amazon_settlements_with_cogs.item_withheld_tax ?? 0) + (amazon_settlements_with_cogs.marketplace_facilitator_vat ?? 0) + (amazon_settlements_with_cogs.refund_tax ?? 0) + (amazon_settlements_with_cogs.refund_shipping_tax ?? 0) + (amazon_settlements_with_cogs.refund_item_withheld_tax ?? 0) + (amazon_settlements_with_cogs.refund_marketplace_facilitator_vat ?? 0))) : 0)) + (sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.fba_inbound_convenience_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_program_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_placement_service_fee ?? 0) + (amazon_settlements_with_cogs.fba_storage_fee ?? 0) + (amazon_settlements_with_cogs.long_term_storage_fee ?? 0) + (amazon_settlements_with_cogs.fba_disposal_fee ?? 0) + (amazon_settlements_with_cogs.removal_complete ?? 0) + (amazon_settlements_with_cogs.subscription_fee ?? 0) + (amazon_settlements_with_cogs.compensated_clawback ?? 0) + (amazon_settlements_with_cogs.warehouse_damage ?? 0) + (amazon_settlements_with_cogs.reversal_reimbursement ?? 0) + (amazon_settlements_with_cogs.free_replacement_refund_items ?? 0) + (amazon_settlements_with_cogs.liquidations_revenue ?? 0) + (amazon_settlements_with_cogs.liquidations_other ?? 0) + (amazon_settlements_with_cogs.liquidations_brokerage_fee ?? 0) + (amazon_settlements_with_cogs.fba_inventory_reimbursement_re_evaluation ?? 0)) : 0))"},{"name":"total_selling_fees","type":"NUMBER","nullable":false,"description":"Referral fee on non-REFUND settlements. Refunded referral fee and refund commission are in refund_cost, not here. Stored as a positive cost. Subtract from sales.","definition":"sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - (amazon_settlements_with_cogs.total_selling_fees ?? 0) : 0)"},{"name":"fba_fees","type":"NUMBER","nullable":false,"description":"Per-unit and other order-tied FBA fees use COALESCE(order_date, posted date); inbound, storage, LTSF and disposal use posted date. Stored as a positive cost. Subtract from sales.","definition":"sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.fba_per_unit_fulfillment_fee ?? 0) + (amazon_settlements_with_cogs.fba_transportation_fee ?? 0) + (amazon_settlements_with_cogs.fba_customer_return_per_unit_fee ?? 0) + (amazon_settlements_with_cogs.fba_other ?? 0)) : 0) + sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.fba_storage_fee ?? 0) + (amazon_settlements_with_cogs.fba_disposal_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_convenience_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_placement_service_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_fee ?? 0) + (amazon_settlements_with_cogs.fba_inbound_transportation_program_fee ?? 0) + (amazon_settlements_with_cogs.fba_inventory_reimbursement_re_evaluation ?? 0) + (amazon_settlements_with_cogs.long_term_storage_fee ?? 0)) : 0)"},{"name":"awd_fees","type":"NUMBER","nullable":false,"description":"AWD fees from Amazon settlements. Stored as a positive cost. Subtract from sales.","definition":"sum(amazon_settlements_with_cogs.settlement_type !== 'REFUND' ? 0 - ((amazon_settlements_with_cogs.awd_processing_fee ?? 0) + (amazon_settlements_with_cogs.awd_transportation_fee ?? 0) + (amazon_settlements_with_cogs.awd_storage_fee ?? 0) + (amazon_settlements_with_cogs.awd_processing_fee_discount ?? 0) + (amazon_settlements_with_cogs.awd_storage_fee_discount ?? 0) + (amazon_settlements_with_cogs.awd_transportation_fee_discount ?? 0)) : 0)"},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":"Ad spend of all campaign types: Sponsored Products, Sponsored Brands, Sponsored Display, Sponsored Television and Amazon DSP. Amazon DSP spend is DSP totalCost: supply cost plus Amazon fees, excluding third-party fees paid by the agency. Includes all Sponsored Television spend and all DSP spend, including spend with no ASIN allocation. Use this for account advertising cost; it can exceed SUM(amazon_profit_by_sku_and_date.ad_spend).","definition":"sum(amazon_ads_performance_by_campaign_by_date.ad_spend) + sum(amazon_ads_dsp_performance_by_creative_by_date.ad_spend)"},{"name":"sponsored_tv_ad_spend","type":"NUMBER","nullable":false,"description":"Sponsored Television campaign spend, included once in ad_spend and deducted once in profit. Account-only: the campaign report does not support SKU attribution. Do not add this amount to ad_spend or deduct it from profit again.","definition":"sum(amazon_ads_performance_by_campaign_by_date.ad_campaign_type === 'SPONSORED_TELEVISION' ? (amazon_ads_performance_by_campaign_by_date.ad_spend ?? 0) : 0)"},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed ad sales (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Includes Amazon DSP (14d attribution) with promoted ASINs plus brand halo, like Sponsored Brands and Sponsored Display sales.","definition":"sum(amazon_ads_performance_by_campaign_by_date.ad_sales) + sum(amazon_ads_dsp_performance_by_creative_by_date.ad_sales)"},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed ad orders (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Includes Amazon DSP (14d attribution) with promoted ASINs plus brand halo, like Sponsored Brands and Sponsored Display sales.","definition":"sum(amazon_ads_performance_by_campaign_by_date.ad_orders) + sum(amazon_ads_dsp_performance_by_creative_by_date.ad_orders)"},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed ad units sold (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Includes Amazon DSP (14d attribution) with promoted ASINs plus brand halo, like Sponsored Brands and Sponsored Display sales.","definition":"sum(amazon_ads_performance_by_campaign_by_date.ad_units_sold) + sum(amazon_ads_dsp_performance_by_creative_by_date.ad_units_sold)"},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Attributed ad clicks, including Amazon DSP click-throughs.","definition":"sum(amazon_ads_performance_by_campaign_by_date.ad_clicks) + sum(amazon_ads_dsp_performance_by_creative_by_date.ad_clicks)"},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Attributed ad impressions, including Amazon DSP impressions.","definition":"sum(amazon_ads_performance_by_campaign_by_date.ad_impressions) + sum(amazon_ads_dsp_performance_by_creative_by_date.ad_impressions)"},{"name":"ad_target_reported_spend","type":"NUMBER","nullable":false,"description":"Target-report spend on this click date. Can differ from account ad_spend because report scopes differ. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_target_and_date.ad_spend) by marketplace, seller, currency and date"},{"name":"ad_target_reported_sales","type":"NUMBER","nullable":false,"description":"Sales attributed to targets on this click date. Sponsored Products uses seven days and Sponsored Brands uses 14 days. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_target_and_date.ad_sales) by marketplace, seller, currency and date"},{"name":"ad_target_count","type":"NUMBER","nullable":false,"description":"Number of target report rows on this date, including rows with spend and no sales. Null when no matching summary exists.","definition":"count(amazon_ads_profit_by_target_and_date rows) by marketplace, seller, currency and date"},{"name":"ad_target_costed_sales","type":"NUMBER","nullable":false,"description":"Target sales from exactly the rows with a non-null profit estimate. Includes provisional rows and excludes partly costed rows. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_target_and_date.ad_sales where estimated_profit_after_ads is not null)"},{"name":"ad_target_costed_spend","type":"NUMBER","nullable":false,"description":"Target spend from exactly the rows with a non-null profit estimate, including provisional and spend-only rows. Compare costed profit with this spend. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_target_and_date.ad_spend where estimated_profit_after_ads is not null)"},{"name":"ad_target_unsupported_sales","type":"NUMBER","nullable":false,"description":"Target sales from ad types without product attribution for profit estimation. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_target_and_date.unsupported_sales)"},{"name":"ad_target_missing_cost_sales","type":"NUMBER","nullable":false,"description":"Target Sponsored Products sales on rows without a profit estimate because the Seller Central connection, costs or reconciliation are incomplete. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_target_and_date.missing_cost_sales)"},{"name":"ad_target_costed_estimated_profit_after_ads","type":"NUMBER","nullable":false,"description":"Sum of available target profit estimates, including provisional and spend-only rows, excluding refunds. Use ad_target_costed_sales and ad_target_costed_spend for the matching scope. Null when no estimate is available. Overlaps the other ad summary and must not be added to account P&L.","definition":"sum(amazon_ads_profit_by_target_and_date.estimated_profit_after_ads)"},{"name":"ad_target_mature_spend_without_sales","type":"NUMBER","nullable":false,"description":"Target spend with no attributed sales after the report attribution window has passed. Null when no matching summary exists.","definition":"sum(coalesce(amazon_ads_profit_by_target_and_date.mature_spend_without_sales, 0))"},{"name":"ad_search_term_reported_spend","type":"NUMBER","nullable":false,"description":"Search-term report spend on this click date. This overlaps target spend. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_search_term_and_date.ad_spend) by marketplace, seller, currency and date"},{"name":"ad_search_term_reported_sales","type":"NUMBER","nullable":false,"description":"Sales attributed to search terms on this click date. This overlaps target sales. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_search_term_and_date.ad_sales) by marketplace, seller, currency and date"},{"name":"ad_search_term_count","type":"NUMBER","nullable":false,"description":"Number of search-term report rows on this date. Null when no matching summary exists.","definition":"count(amazon_ads_profit_by_search_term_and_date rows) by marketplace, seller, currency and date"},{"name":"ad_search_term_costed_sales","type":"NUMBER","nullable":false,"description":"Search-term sales from exactly the rows with a non-null profit estimate. Includes provisional rows and excludes partly costed rows. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_search_term_and_date.ad_sales where estimated_profit_after_ads is not null)"},{"name":"ad_search_term_costed_spend","type":"NUMBER","nullable":false,"description":"Search-term spend from exactly the rows with a non-null profit estimate, including provisional and spend-only rows. Compare costed profit with this spend. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_search_term_and_date.ad_spend where estimated_profit_after_ads is not null)"},{"name":"ad_search_term_unsupported_sales","type":"NUMBER","nullable":false,"description":"Search-term sales from ad types without product attribution for profit estimation. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_search_term_and_date.unsupported_sales)"},{"name":"ad_search_term_missing_cost_sales","type":"NUMBER","nullable":false,"description":"Search-term Sponsored Products sales on rows without a profit estimate because the Seller Central connection, parent target, costs or reconciliation are incomplete. Null when no matching summary exists.","definition":"sum(amazon_ads_profit_by_search_term_and_date.missing_cost_sales)"},{"name":"ad_search_term_costed_estimated_profit_after_ads","type":"NUMBER","nullable":false,"description":"Sum of available search-term profit estimates, including provisional and spend-only rows, excluding refunds. Use ad_search_term_costed_sales and ad_search_term_costed_spend for the matching scope. Null when no estimate is available. Overlaps the other ad summary and must not be added to account P&L.","definition":"sum(amazon_ads_profit_by_search_term_and_date.estimated_profit_after_ads)"},{"name":"ad_search_term_mature_spend_without_sales","type":"NUMBER","nullable":false,"description":"Search-term spend with no attributed sales after the report attribution window has passed. Null when no matching summary exists.","definition":"sum(coalesce(amazon_ads_profit_by_search_term_and_date.mature_spend_without_sales, 0))"},{"name":"avg_buybox_percentage","type":"NUMBER","nullable":false,"description":"Average buy box percentage across child ASINs for the day. Buy box percentage is the share of page views where the buy box (add to cart) appeared for your offers. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"avg(amazon_sales_and_traffic_with_cogs.buybox_percentage)"},{"name":"avg_buybox_percentage_b2b","type":"NUMBER","nullable":false,"description":"Average B2B buy box percentage across child ASINs for the day, from Amazon Sales and Traffic buyBoxPercentageB2B. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"avg(amazon_sales_and_traffic_with_cogs.buybox_percentage_b2b)"},{"name":"avg_buybox_percentage_b2c","type":"NUMBER","nullable":false,"description":"Average B2C buy box percentage across child ASINs for the day. Amazon does not publish B2C buy box; reconstructed from overall and B2B buy box weighted by page views. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"avg(((amazon_sales_and_traffic_with_cogs.buybox_percentage ?? 0) * (amazon_sales_and_traffic_with_cogs.page_views ?? 0) - (amazon_sales_and_traffic_with_cogs.buybox_percentage_b2b ?? 0) * (amazon_sales_and_traffic_with_cogs.page_views_b2b ?? 0)) / ((amazon_sales_and_traffic_with_cogs.page_views ?? 0) - (amazon_sales_and_traffic_with_cogs.page_views_b2b ?? 0)))"},{"name":"total_sessions","type":"NUMBER","nullable":false,"description":"Total sessions across all child ASINs for the day. A session is a visit to your Amazon product detail pages via browser or mobile app. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(amazon_sales_and_traffic_with_cogs.session)"},{"name":"sessions_b2b","type":"NUMBER","nullable":false,"description":"B2B sessions across all child ASINs for the day, from Amazon Sales and Traffic sessionsB2B. Included in total_sessions, not additive. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(amazon_sales_and_traffic_with_cogs.sessions_b2b)"},{"name":"sessions_b2c","type":"NUMBER","nullable":false,"description":"B2C sessions across all child ASINs for the day, calculated as total_sessions minus sessions_b2b. Amazon does not publish a B2C sessions field. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(Math.max((amazon_sales_and_traffic_with_cogs.session ?? 0) - (amazon_sales_and_traffic_with_cogs.sessions_b2b ?? 0), 0))"},{"name":"total_page_views","type":"NUMBER","nullable":false,"description":"Total page views across all child ASINs for the day. Page views count visits to your Amazon product detail pages via browser or mobile app. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(amazon_sales_and_traffic_with_cogs.page_views)"},{"name":"page_views_b2b","type":"NUMBER","nullable":false,"description":"B2B page views across all child ASINs for the day, from Amazon Sales and Traffic pageViewsB2B. Included in total_page_views, not additive. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(amazon_sales_and_traffic_with_cogs.page_views_b2b)"},{"name":"page_views_b2c","type":"NUMBER","nullable":false,"description":"B2C page views across all child ASINs for the day, calculated as total_page_views minus page_views_b2b. Amazon does not publish a B2C page views field. From Amazon Sales and Traffic report. Data may be delayed by up to 3 days and may remain incomplete or be revised for up to 30 days after the row date due to Amazon reporting limitations.","definition":"sum(Math.max((amazon_sales_and_traffic_with_cogs.page_views ?? 0) - (amazon_sales_and_traffic_with_cogs.page_views_b2b ?? 0), 0))"},{"name":"profit","type":"NUMBER","nullable":false,"description":"Net profit after subtracting sales_tax once. refund_cost is signed: cash outflows are negative and fee reversals are positive. Refunded tax is excluded.","definition":"amazon_profit_by_date.total_sales - amazon_profit_by_date.sales_tax - amazon_profit_by_date.total_fees - amazon_profit_by_date.cogs_total - amazon_profit_by_date.ad_spend + amazon_profit_by_date.refund_cost"},{"name":"total_cost","type":"NUMBER","nullable":false,"description":"Sales tax included in prices, fees, COGS and ad spend, minus signed refund_cost.","definition":"amazon_profit_by_date.sales_tax + amazon_profit_by_date.total_fees + amazon_profit_by_date.cogs_total + amazon_profit_by_date.ad_spend - amazon_profit_by_date.refund_cost"},{"name":"acos","type":"NUMBER","nullable":false,"description":"Advertising Cost of Sales as a percentage.","definition":"amazon_profit_by_date.ad_sales === 0 ? null : amazon_profit_by_date.ad_spend / amazon_profit_by_date.ad_sales * 100"},{"name":"tacos","type":"NUMBER","nullable":false,"description":"Total Advertising Cost of Sales as a percentage.","definition":"amazon_profit_by_date.total_sales === 0 ? null : amazon_profit_by_date.ad_spend / amazon_profit_by_date.total_sales * 100"},{"name":"roi","type":"NUMBER","nullable":false,"description":"Return on Investment as a percentage.","definition":"amazon_profit_by_date.total_cost === 0 ? null : amazon_profit_by_date.profit / amazon_profit_by_date.total_cost * 100"}],"userManaged":false,"isPremium":true,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Daily profit and cost breakdown from shipped orders, settlement fees, COGS and ads spend. Prefer this table for account-level P&L instead of calculating manually from other tables. Target and search-term columns are separate Amazon Ads attribution summaries; their estimated profits are not included in account profit and must not be added together. Ads include Sponsored Products, Sponsored Brands, Sponsored Display, Sponsored Television and Amazon DSP. sponsored_tv_ad_spend isolates Television spend already included once in ad_spend and profit. Television has no SKU attribution. Amazon DSP spend is DSP totalCost and DSP ad sales, orders and units include promoted ASINs plus brand halo, consistent with Sponsored Brands and Sponsored Display sales. Unallocated and account-level fees and ads spend land here, including all DSP spend, so ad_spend can exceed SUM(amazon_profit_by_sku_and_date.ad_spend). Do not expect this profit to equal SUM(amazon_profit_by_sku_and_date.profit).","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"10am, 1pm, 4pm"},"sources":["connections","raw_ads_api_export_targets","raw_ads_api_report_campaign_ad_creative_dsp","raw_ads_api_report_campaign_sd","raw_ads_api_report_campaign_sp","raw_ads_api_report_campaign_st","raw_ads_api_report_advertised_products_sp","raw_ads_api_report_purchased_products_sp","raw_ads_api_report_search_term_sp","raw_ads_api_report_targeting_sp","raw_ads_api_report_gross_and_invalid_traffic_sb","raw_ads_api_report_gross_and_invalid_traffic_sd","raw_ads_api_report_gross_and_invalid_traffic_sp","raw_ads_api_report_legacy_campaign_sb_all","raw_amazon_cogs","raw_sp_api_report_listings_data","raw_sp_api_report_orders","raw_sp_api_report_sales_and_traffic","raw_sp_api_report_fba_fulfillment_customer_returns","raw_sp_api_report_flat_file_returns_data_by_return_date","refined_sp_api_finances_transactions","refined_products_by_child_asin"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["pnl","p&l","net profit","account profit","fees","margin","sessions","buy box","buybox"]},{"id":"401ffcd7e50c1ea9a18cacf221ddf99858db20a0f31eff65fc22a8e8140c7e1b","name":"Sales & Traffic by ASIN & Date","tableName":"amazon_sales_and_traffic_with_cogs","type":"SELLER_CENTRAL","columns":[{"name":"date","type":"DATE","nullable":false,"description":"Single date may occur multiple times."},{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"parent_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"buybox_percentage","type":"NUMBER","nullable":false,"description":"Share of page views where this offer won the Featured Offer (Buy Box). Amazon percentage on a 0–100 scale (report examples are values such as 98.54, not 0.9854)."},{"name":"buybox_percentage_b2b","type":"NUMBER","nullable":false,"description":"B2B buy box percentage. Amazon percentage on a 0–100 scale (report examples are values such as 98.54, not 0.9854). Amazon Business subset of the matching total. Included in that total; do not add the two columns."},{"name":"units_session_percentage","type":"NUMBER","nullable":false,"description":"Units ordered divided by sessions. Amazon percentage on a 0–100 scale (report examples are values such as 98.54, not 0.9854). Can exceed 100 when a session buys more than one unit."},{"name":"page_views","type":"NUMBER","nullable":false,"description":"Page views from a browser or the mobile app. A page view is a visit, not a session. browser_page_views and mobile_page_views can count the same visit on both devices, so they can sum to more than page_views. B2B page views are the Amazon Business subset."},{"name":"page_views_b2b","type":"NUMBER","nullable":false,"description":"B2B page views. Amazon Business subset of the matching total. Included in that total; do not add the two columns."},{"name":"browser_page_views","type":"NUMBER","nullable":false,"description":"Page views from a browser. The same visit can also appear in mobile_page_views, so the two columns can sum to more than page_views."},{"name":"mobile_session","type":"NUMBER","nullable":false,"description":"Mobile-app sessions. A session is all visits by one user within 24 hours. browser_session and mobile_session can both count the same user, so they can sum to more than session."},{"name":"mobile_page_views","type":"NUMBER","nullable":false,"description":"Page views from the mobile app."},{"name":"session","type":"NUMBER","nullable":false,"description":"Sessions from browser or mobile app. A session is all visits by one user within 24 hours. browser_session and mobile_session can both count the same user, so they can sum to more than session."},{"name":"sessions_b2b","type":"NUMBER","nullable":false,"description":"B2B sessions. Amazon Business subset of the matching total. Included in that total; do not add the two columns. A session is all visits by one user within 24 hours. browser_session and mobile_session can both count the same user, so they can sum to more than session."},{"name":"browser_session","type":"NUMBER","nullable":false,"description":"Browser sessions. A session is all visits by one user within 24 hours. browser_session and mobile_session can both count the same user, so they can sum to more than session."},{"name":"total_sales","type":"NUMBER","nullable":false,"description":"Ordered product sales (price × units ordered), not shipped sales. B2B sales are included."},{"name":"total_units","type":"NUMBER","nullable":false,"description":"Units ordered. One order of 2 copies is 2 units. B2B units are included. Not shipped units."},{"name":"total_units_b2b","type":"NUMBER","nullable":false,"description":"B2B units ordered. Amazon Business subset of the matching total. Included in that total; do not add the two columns."},{"name":"total_orders","type":"NUMBER","nullable":false,"description":"Order items ordered, not orders and not units. B2B order items are included."},{"name":"shipped_product_sales","type":"NUMBER","nullable":false,"description":"Product sales Amazon has shipped. Not ordered sales (total_sales). B2B shipped sales are included."},{"name":"shipped_product_sales_b2b","type":"NUMBER","nullable":false,"description":"B2B shipped product sales. Amazon Business subset of the matching total. Included in that total; do not add the two columns."},{"name":"units_shipped","type":"NUMBER","nullable":false,"description":"Units shipped from the Sales and Traffic report."},{"name":"units_shipped_b2b","type":"NUMBER","nullable":false,"description":"B2B units shipped from the Sales and Traffic report."},{"name":"orders_shipped","type":"NUMBER","nullable":false,"description":"Orders shipped from the Sales and Traffic report."},{"name":"orders_shipped_b2b","type":"NUMBER","nullable":false,"description":"B2B orders shipped from the Sales and Traffic report."},{"name":"units_refunded","type":"NUMBER","nullable":false,"description":"Units refunded from the Sales and Traffic report."},{"name":"units_refunded_b2b","type":"NUMBER","nullable":false,"description":"B2B units refunded from the Sales and Traffic report."},{"name":"refund_rate","type":"NUMBER","nullable":false,"description":"Amazon refundRate. Amazon percentage on a 0–100 scale (report examples are values such as 98.54, not 0.9854). Stored values can exceed 100 when refunded units exceed ordered units in the period. The schema text divides units ordered by units refunded, which is the inverse of a refund rate; use this column as Amazon sent it and do not recompute."},{"name":"refund_rate_b2b","type":"NUMBER","nullable":false,"description":"B2B refundRate. Amazon percentage on a 0–100 scale (report examples are values such as 98.54, not 0.9854). Amazon Business subset of the matching total. Included in that total; do not add the two columns. Stored values can exceed 100. Do not recompute it."},{"name":"cogs_item_value","type":"NUMBER","nullable":true,"description":"Unit item cost from amazon_cogs for this child ASIN on this date."},{"name":"cogs_shipping_value","type":"NUMBER","nullable":true,"description":"Unit shipping cost from amazon_cogs for this child ASIN on this date."},{"name":"cogs_total_value","type":"NUMBER","nullable":true,"description":"Unit item cost plus unit shipping cost, multiplied by units ordered (total_units).","definition":"((amazon_cogs.cost_item_value ?? 0) + (amazon_cogs.cost_item_shipping_value ?? 0)) * (amazon_sales_and_traffic_with_cogs.total_units ?? 0)"},{"name":"cogs_present","type":"LOGIC","nullable":false,"description":"True when an uploaded COGS record applies to this row. Zero cost can still be valid."},{"name":"cogs_currency","type":"TEXT","nullable":true,"description":"Currency code for COGS."},{"name":"item_supplier_name","type":"TEXT","nullable":true,"description":"Supplier name for the item COGS, if provided in COGS upload."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"[deprecated, see `issues` for more details] Sales and traffic metrics per child ASIN and date from Amazon sales & traffic business report. Ordered columns are orders placed; shipped columns are units Amazon has shipped. B2B columns are the Amazon Business subset of the matching total. Sessions are 24-hour visits, not page views. Percentages are 0-100. Data may be delayed by up to 14 days. If you do not explicitly need data from this table use the `amazon_order_items_with_cogs` table instead.","requiresDatePeriod":true,"issues":[{"title":"This table is deprecated and should not be used","description":"The 'Sales & Traffic by ASIN & Date' table is deprecated and may contain incomplete data because of Amazon's sales and traffic data limitations. For sales, traffic, and profitability data, use the 'Profit by SKU & Date' and 'Profit by Date' tables. For detailed sales analysis, use the 'Order Line Items' table. For the underlying sales and traffic rows, use this table's raw source. We will remove this table in the future."}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":35},{"type":"RECURRING_DAILY","numberOfDays":4},{"type":"RECURRING_MONTHLY","numberOfDays":30,"shiftDays":4}],"sources":["connections","raw_amazon_cogs","raw_sp_api_report_sales_and_traffic","refined_products_by_child_asin"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["revenue","page views","conversion"]},{"id":"89b27535d27c2a94db5ae39af4717f542624ff4df7802fd633e16c78674a1778","name":"Order Line Items","tableName":"amazon_order_items_with_cogs","type":"SELLER_CENTRAL","columns":[{"name":"date","type":"DATE","nullable":false,"description":"Date of the purchase in the local timezone of the marketplace."},{"name":"order_purchased_at_utc","type":"DATE","nullable":false,"description":"Date and time of purchase in UTC timezone. May be different than the timezone of the marketplace or of the user."},{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_order_id","type":"TEXT","nullable":false,"description":null},{"name":"amazon_order_item_id","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":true,"description":"May be null for orders placed in the last 4h."},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":true,"description":"May be null for orders placed in the last 4h."},{"name":"line_item_number","type":"NUMBER","nullable":false,"description":null},{"name":"merchant_order_id","type":"TEXT","nullable":true,"description":"May be null for orders placed in the last 4h."},{"name":"amazon_order_updated_at","type":"DATE","nullable":true,"description":null},{"name":"amazon_order_status","type":"TEXT","nullable":false,"description":"Pending/Unshipped/Shipped/Canceled; some Unshipped and Shipped statuses have marketplace specific values which have `Unshipped` or `Shipped` prefix."},{"name":"fulfillment_channel","type":"TEXT","nullable":false,"description":"'Amazon' or 'Merchant'"},{"name":"sales_channel","type":"TEXT","nullable":true,"description":"Sales channel the order was placed through, e.g. 'Amazon.com' for native Amazon orders or a non-Amazon value for Multi-Channel Fulfillment (MCF) orders placed on other platforms (e.g. Shopify) and fulfilled by Amazon. May be null for orders placed in the last 4h."},{"name":"amazon_order_channel","type":"TEXT","nullable":false,"description":"Amazon order channel: MOBILEAPP maps from ClientAppOrderChannel, WEBSITE from WebsiteOrderChannel, and OTHER from any other or missing source value. OTHER is a fallback, not a separate marketplace or an off-Amazon sales channel. Use sales_channel to identify where the order was sold."},{"name":"ship_service_level","type":"TEXT","nullable":true,"description":"May be null for orders placed in the last 4h."},{"name":"item_status","type":"TEXT","nullable":true,"description":"Unshipped/Shipping/Shipped/Canceled; may be null for orders placed in the last 4h, for such orders amazon_order_status has current status"},{"name":"quantity","type":"NUMBER","nullable":false,"description":"Units purchased on this order line item."},{"name":"item_price_value","type":"NUMBER","nullable":true,"description":"Line item price. Excludes buyer shipping. May be null for orders placed in the last 4h."},{"name":"item_price_currency","type":"TEXT","nullable":true,"description":"Currency code. May be null for orders placed in the last 4h."},{"name":"item_tax_value","type":"NUMBER","nullable":true,"description":"Item tax collected on this line item. Positive number or zero. May be null for orders placed in the last 4h."},{"name":"item_shipping_price_value","type":"NUMBER","nullable":true,"description":"Buyer shipping charged on this line item. May be null for orders placed in the last 4h."},{"name":"item_shipping_tax_value","type":"NUMBER","nullable":true,"description":"Tax on buyer shipping for this line item. May be null for orders placed in the last 4h."},{"name":"item_ship_promotion_discount_value","type":"NUMBER","nullable":true,"description":"Shipping promotion discount on this line item. May be null for orders placed in the last 4h."},{"name":"gift_wrap_price_value","type":"NUMBER","nullable":true,"description":"May be null for orders placed in the last 4h."},{"name":"gift_wrap_tax_value","type":"NUMBER","nullable":true,"description":"May be null for orders placed in the last 4h."},{"name":"address_city","type":"TEXT","nullable":true,"description":"May be null for orders placed in the last 4h."},{"name":"address_state","type":"TEXT","nullable":true,"description":"May be null for orders placed in the last 4h."},{"name":"address_country","type":"TEXT","nullable":true,"description":"May be null for orders placed in the last 4h."},{"name":"address_postal_code","type":"TEXT","nullable":false,"description":null},{"name":"order_is_business","type":"LOGIC","nullable":false,"description":"When TRUE, the order is a B2B order. When FALSE, the order is a B2C order."},{"name":"purchase_order_number","type":"TEXT","nullable":true,"description":"May be null for orders placed in the last 4h."},{"name":"cogs_item_value","type":"NUMBER","nullable":true,"description":"Item COGS for this order line: unit item cost from amazon_cogs as of the order date, times quantity.","definition":"(amazon_cogs.cost_item_value ?? 0) * (amazon_order_items_with_cogs.quantity ?? 0)"},{"name":"cogs_shipping_value","type":"NUMBER","nullable":true,"description":"Shipping COGS for this order line: unit shipping cost from amazon_cogs as of the order date, times quantity.","definition":"(amazon_cogs.cost_item_shipping_value ?? 0) * (amazon_order_items_with_cogs.quantity ?? 0)"},{"name":"cogs_total_value","type":"NUMBER","nullable":true,"description":"Sum of cogs_item_value and cogs_shipping_value.","definition":"((amazon_cogs.cost_item_value ?? 0) + (amazon_cogs.cost_item_shipping_value ?? 0)) * (amazon_order_items_with_cogs.quantity ?? 0)"},{"name":"cogs_present","type":"LOGIC","nullable":false,"description":"True when an uploaded COGS record applies to this row. Zero cost can still be valid."},{"name":"cogs_currency","type":"TEXT","nullable":true,"description":"Currency code for COGS."},{"name":"item_supplier_name","type":"TEXT","nullable":true,"description":"Supplier name for the item COGS, if provided in COGS upload."},{"name":"order_date","type":"DATE","nullable":false,"description":"Duplicate of date column. Prefer to use date column for date filtering."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Log of all orders per order id and order item. Aggregate this table to get order level data and sales per product or date.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ORDERS_CANCEL","relation":"writes"},{"type":"AMAZON_ORDERS_CONFIRM_SHIPMENT","relation":"writes"},{"type":"AMAZON_ORDERS_CREATE_SHIPMENT","relation":"writes"},{"type":"AMAZON_ORDERS_CANCEL_SHIPMENT","relation":"writes"},{"type":"AMAZON_ORDERS_GET_SHIPPING_RATES","relation":"live"},{"type":"AMAZON_ORDERS_GET_SHIPMENT_DOCS","relation":"live"}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":730},{"type":"RECURRING_DAILY","numberOfDays":28}],"dataAvailability":{"type":"REAL_TIME","description":"Orders are available up to 1 hour after being placed.","refreshAt":"10am, 1pm, 4pm, 7pm"},"sources":["connections","raw_amazon_cogs","raw_sp_api_report_orders"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["orders","order lines","line items","units sold"]},{"id":"6ea445cdc459f9fbb9517c5c009384da60ef31a1e70d4de9187ea3d4c28535c4","name":"Listings (Raw JSON)","tableName":"amazon_listings_raw","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"parent_asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"amazon_product_type","type":"TEXT","nullable":false,"description":null},{"name":"product_type","type":"TEXT","nullable":false,"description":null},{"name":"summaries","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"attributes","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"classifications","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"dimensions","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"identifiers","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"images","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"sales_ranks","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"offers","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"fulfillment_availability","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"issues","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"relationships","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"title_differentiation","type":"TEXT","nullable":true,"description":"Item highlight shown in search results, extracted from the listing title_differentiation attribute."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Raw listings payload per SKU and marketplace. Recommended for advanced use cases. For most use cases, use the \"amazon_listings_with_cogs\" table instead. For AI agents: each row from this table has a lot of data, consider downloading it to file and not directly to the context.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_LISTINGS_CREATE","relation":"writes"},{"type":"AMAZON_LISTINGS_UPDATE","relation":"writes"},{"type":"AMAZON_LISTINGS_PRICING_UPDATE","relation":"writes"},{"type":"AMAZON_LISTINGS_DETAILS_UPDATE","relation":"writes"},{"type":"AMAZON_LISTINGS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_listings_items","refined_products_by_child_asin"],"containsPii":false,"initialLoadProgress":null},{"id":"e6af85f774f72dc9bd7e23c3fbfd5b1f6c89a2e96622bbb4ca106572bebe46f3","name":"Promotions","tableName":"amazon_promotions","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"promotion_id","type":"TEXT","nullable":false,"description":null},{"name":"tracking_id","type":"TEXT","nullable":true,"description":null},{"name":"promotion_title","type":"TEXT","nullable":true,"description":null},{"name":"promotion_type","type":"TEXT","nullable":true,"description":null},{"name":"coupon_type","type":"TEXT","nullable":true,"description":null},{"name":"status","type":"TEXT","nullable":true,"description":null},{"name":"start_date","type":"DATE","nullable":true,"description":null},{"name":"end_date","type":"DATE","nullable":true,"description":null},{"name":"event_id","type":"TEXT","nullable":true,"description":null},{"name":"budget_type","type":"TEXT","nullable":true,"description":null},{"name":"budget_value","type":"NUMBER","nullable":true,"description":null},{"name":"budget_currency","type":"TEXT","nullable":true,"description":null},{"name":"selection_id","type":"TEXT","nullable":true,"description":null},{"name":"selection_revision_id","type":"NUMBER","nullable":true,"description":null},{"name":"selection_type","type":"TEXT","nullable":true,"description":null},{"name":"benefit_discount_type","type":"TEXT","nullable":true,"description":null},{"name":"benefit_percent_off","type":"NUMBER","nullable":true,"description":"Percent points off list price when the discount type is a percent. Not a 0–1 fraction. Unused when the discount is a currency amount."},{"name":"benefit_amount_off","type":"NUMBER","nullable":true,"description":null},{"name":"benefit_currency","type":"TEXT","nullable":true,"description":null},{"name":"benefit_per_customer_uses","type":"NUMBER","nullable":true,"description":null},{"name":"benefit_stacking","type":"TEXT","nullable":true,"description":null},{"name":"benefit_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"purchase_req_quantity_type","type":"TEXT","nullable":true,"description":null},{"name":"purchase_req_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"claim_code_type","type":"TEXT","nullable":true,"description":null},{"name":"claim_code_value","type":"TEXT","nullable":true,"description":null},{"name":"display_on_website","type":"TEXT","nullable":true,"description":null},{"name":"upfront_fee_amount","type":"NUMBER","nullable":true,"description":null},{"name":"upfront_fee_currency","type":"TEXT","nullable":true,"description":null},{"name":"upfront_fee_frequency","type":"TEXT","nullable":true,"description":null},{"name":"variable_fee_pct","type":"NUMBER","nullable":true,"description":null},{"name":"variable_fee_cap_amount","type":"NUMBER","nullable":true,"description":null},{"name":"variable_fee_cap_currency","type":"TEXT","nullable":true,"description":null},{"name":"latest_revision_status","type":"TEXT","nullable":true,"description":null},{"name":"created_date","type":"DATE","nullable":true,"description":null},{"name":"last_updated_date","type":"DATE","nullable":true,"description":null},{"name":"last_synced_at","type":"DATE","nullable":false,"description":null},{"name":"issues","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"customer_segments","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"additional_tiers","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Promotion configuration per promotion, including schedule, benefit, budget, fees, and selection metadata. Complements amazon_promotion_performance, which contains historical performance metrics.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_promotions"],"containsPii":false,"initialLoadProgress":null},{"id":"d16e37cdf85c425f65883fc9e1303d58bfc55d5a3708e04d680544f09a8a3c70","name":"Promotion Items","tableName":"amazon_promotion_items","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"promotion_id","type":"TEXT","nullable":false,"description":null},{"name":"asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"benefit_type","type":"TEXT","nullable":true,"description":null},{"name":"benefit_discount_type","type":"TEXT","nullable":true,"description":null},{"name":"benefit_percent_off","type":"NUMBER","nullable":true,"description":"Percent points off list price when the discount type is a percent. Not a 0–1 fraction. Unused when the discount is a currency amount."},{"name":"benefit_amount_off","type":"NUMBER","nullable":true,"description":null},{"name":"benefit_discount_currency","type":"TEXT","nullable":true,"description":null},{"name":"benefit_fixed_price","type":"NUMBER","nullable":true,"description":null},{"name":"benefit_fixed_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"benefit_per_customer_uses","type":"NUMBER","nullable":true,"description":null},{"name":"budget_type","type":"TEXT","nullable":true,"description":null},{"name":"budget_value","type":"NUMBER","nullable":true,"description":null},{"name":"budget_currency","type":"TEXT","nullable":true,"description":null},{"name":"issues","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"last_synced_at","type":"DATE","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Item-level promotion configuration for ITEMS selections, including per-ASIN/SKU benefits and budgets.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_promotion_items"],"containsPii":false,"initialLoadProgress":null},{"id":"ba689c05d7f7cee1a1690990c28995680a0654b7ed258230f4173d61bbcd1ab3","name":"Listings","tableName":"amazon_listings_with_cogs","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"listing_id","type":"TEXT","nullable":false,"description":"Unique identifier for the listing, not the SKU."},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"title_differentiation","type":"TEXT","nullable":true,"description":"Item highlight shown in search results, extracted from the listing title_differentiation attribute."},{"name":"listing_condition","type":"TEXT","nullable":false,"description":"Condition enum values."},{"name":"listing_name","type":"TEXT","nullable":false,"description":null},{"name":"listing_price_value","type":"NUMBER","nullable":false,"description":null},{"name":"listing_estimated_per_item_referral_fee","type":"NUMBER","nullable":true,"description":"Estimated referral fee per item."},{"name":"listing_price_currency","type":"TEXT","nullable":false,"description":"Currency code."},{"name":"listing_current_quantity","type":"NUMBER","nullable":false,"description":null},{"name":"listing_pending_quantity","type":"NUMBER","nullable":false,"description":null},{"name":"fba_quantity_available","type":"NUMBER","nullable":false,"description":"Fulfillable units at Amazon now. Already inside fba_inventory_supply_at_fba when that column is set."},{"name":"fba_quantity_pending_removal","type":"NUMBER","nullable":false,"description":"Units pending removal. Not available to sell."},{"name":"fba_quantity_inbound","type":"NUMBER","nullable":false,"description":"Units inbound to FBA. Not yet available to sell."},{"name":"fba_quantity_reserved","type":"NUMBER","nullable":false,"description":"Units reserved for orders, transfers, or processing. Not available to sell."},{"name":"fba_quantity_fc_transfer","type":"NUMBER","nullable":true,"description":"Units in transfer between fulfillment centers."},{"name":"fba_inventory_supply_at_fba","type":"NUMBER","nullable":true,"description":"Total FBA supply quantity for the listing."},{"name":"fba_has_stranded_inventory","type":"LOGIC","nullable":false,"description":"True when at least one FBA stranded inventory row exists for this SKU."},{"name":"awd_total_inbound_quantity","type":"NUMBER","nullable":true,"description":"Units inbound to AWD. Not FBA inbound."},{"name":"awd_total_onhand_quantity","type":"NUMBER","nullable":true,"description":"Units on hand in AWD. Not FBA available."},{"name":"awd_available_distributable_quantity","type":"NUMBER","nullable":true,"description":"AWD units Amazon can distribute to FBA. Not FBA available."},{"name":"awd_replenishment_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"awd_reserved_distributable_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"awd_next_expiration_at","type":"DATE","nullable":true,"description":"Earliest known expiration timestamp for this SKU in AWD. Additional expirations can exist."},{"name":"awd_next_expiration_quantity","type":"NUMBER","nullable":true,"description":"On-hand quantity associated with the earliest known expiration in AWD. Additional expirations can exist."},{"name":"awd_expirations","type":"JSON","nullable":true,"description":"All expiration buckets for this SKU in AWD. Available only in direct BigQuery integration.","bigQueryOnly":true},{"name":"listing_fulfillment_channel","type":"TEXT","nullable":false,"description":"Enum of: DEFAULT / AMAZON_NA / AMAZON_EU / (null). DEFAULT means FBM, other means FBA."},{"name":"listing_open_date","type":"DATE","nullable":false,"description":null},{"name":"listing_status","type":"TEXT","nullable":false,"description":"Active / Inactive / Incomplete"},{"name":"cogs_item_value","type":"NUMBER","nullable":true,"description":"Current unit item cost from amazon_cogs."},{"name":"cogs_shipping_value","type":"NUMBER","nullable":true,"description":"Current unit shipping cost from amazon_cogs."},{"name":"cogs_total_value","type":"NUMBER","nullable":true,"description":"Per-unit snapshot: current unit item cost plus current unit shipping cost.","definition":"(amazon_cogs.cost_item_value ?? 0) + (amazon_cogs.cost_item_shipping_value ?? 0)"},{"name":"cogs_present","type":"LOGIC","nullable":false,"description":"True when an uploaded COGS record applies to this row. Zero cost can still be valid."},{"name":"cogs_currency","type":"TEXT","nullable":true,"description":"Currency code for COGS."},{"name":"item_current_supplier_name","type":"TEXT","nullable":true,"description":"Current supplier name for the item COGS, if provided in COGS upload. Reflects the latest COGS row for the listing, not a date-effective value."}],"userManaged":false,"isPremium":true,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Current listing snapshot per SKU, including price, FBA inventory, and Amazon Warehousing and Distribution (AWD) inventory. FBA available, reserved, inbound, and pending-removal quantities are separate buckets; fba_inventory_supply_at_fba is the FBA total when Amazon sends it, so do not add the buckets to it. AWD quantities are not FBA.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_LISTINGS_CREATE","relation":"writes"},{"type":"AMAZON_LISTINGS_UPDATE","relation":"writes"},{"type":"AMAZON_LISTINGS_PRICING_UPDATE","relation":"writes"},{"type":"AMAZON_LISTINGS_DETAILS_UPDATE","relation":"writes"},{"type":"AMAZON_LISTINGS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"10am, 1pm, 4pm"},"sources":["connections","raw_amazon_cogs","raw_sp_api_awd_inventory","raw_sp_api_listings_items","raw_sp_api_report_fba_inventory_planning","raw_sp_api_report_listings_data","raw_sp_api_report_referral_fee_preview","raw_sp_api_report_stranded_inventory_ui_data"],"containsPii":false,"initialLoadProgress":null},{"id":"d190d57b0176fb9854685bb58b4cb2ef782c03000eec9d33d773721f74bf8dba","name":"AWD Inbound Shipments","tableName":"amazon_awd_inbound_shipments","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"awd_inbound_shipment_id","type":"TEXT","nullable":false,"description":null},{"name":"awd_inbound_order_id","type":"TEXT","nullable":true,"description":null},{"name":"external_reference_id","type":"TEXT","nullable":true,"description":null},{"name":"awd_inbound_shipment_status","type":"TEXT","nullable":true,"description":null},{"name":"carrier_code_type","type":"TEXT","nullable":true,"description":null},{"name":"carrier_code_value","type":"TEXT","nullable":true,"description":null},{"name":"awd_inbound_shipment_tracking_id","type":"TEXT","nullable":true,"description":null},{"name":"ship_by","type":"DATE","nullable":true,"description":null},{"name":"destination_region","type":"TEXT","nullable":true,"description":null},{"name":"warehouse_reference_id","type":"TEXT","nullable":true,"description":null},{"name":"shipment_container_quantities","type":"JSON","nullable":true,"description":null},{"name":"received_quantity","type":"JSON","nullable":true,"description":null},{"name":"destination_address_name","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_address_line1","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_address_line2","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_address_line3","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_city","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_county","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_district","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_state_or_region","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_postal_code","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_country_code","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_phone_number","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_name","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_address_line1","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_address_line2","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_address_line3","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_city","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_county","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_district","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_state_or_region","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_postal_code","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_country_code","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_phone_number","type":"TEXT","nullable":true,"description":null},{"name":"created_at","type":"DATE","nullable":true,"description":null},{"name":"updated_at","type":"DATE","nullable":true,"description":null},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null},{"name":"date","type":"DATE","nullable":false,"description":"Date the shipment was created."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"AWD inbound shipments by shipment id.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_awd_inbound_shipments"],"containsPii":false,"initialLoadProgress":null},{"id":"18bbce497127e8eecc6ab435fdbcaa72cf6dd66b313517749f4d33c0ad0169b1","name":"Replenishment Metrics by Date (SnS)","tableName":"amazon_replenishment_metrics_by_date","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":"ISO calendar day of the Subscribe & Save PERFORMANCE metric from SP-API Replenishment. Not order date or ship date."},{"name":"period_start_date","type":"DATE","nullable":false,"description":"Start of the Amazon metric time interval (same calendar day for DAY aggregation)."},{"name":"period_end_date","type":"DATE","nullable":false,"description":"End of the Amazon metric time interval (same calendar day for DAY aggregation)."},{"name":"amazon_replenishment_program_type","type":"TEXT","nullable":false,"description":"Always SUBSCRIBE_AND_SAVE."},{"name":"amazon_replenishment_time_period_type","type":"TEXT","nullable":false,"description":"Always PERFORMANCE (historical metrics, not forecast)."},{"name":"amazon_replenishment_aggregation_frequency","type":"TEXT","nullable":false,"description":"Always DAY."},{"name":"currency_code","type":"TEXT","nullable":false,"description":null},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null},{"name":"not_delivered_due_to_oos","type":"NUMBER","nullable":false,"description":"Share of Subscribe & Save items not shipped because of out of stock, relative to shipped subscription units for the metric day (Amazon notDeliveredDueToOOS)."},{"name":"total_subscriptions_revenue","type":"NUMBER","nullable":false,"description":"Subscribe & Save subscription revenue for the metric day. Amazon does not label this as ordered or shipped sales; it is program revenue over the aggregation period. Use shipped_subscription_units for shipped units."},{"name":"shipped_subscription_units","type":"NUMBER","nullable":false,"description":"Subscribe & Save units shipped to subscribers during the metric day. This is the shipped-units metric; total_subscriptions_revenue is not documented as shipped dollars."},{"name":"active_subscriptions","type":"NUMBER","nullable":false,"description":"Number of active Subscribe & Save subscriptions at the end of the metric day."},{"name":"subscriber_average_revenue","type":"NUMBER","nullable":false,"description":"Average revenue per Subscribe & Save subscriber over the past 12 months for sellers and 6 months for vendors."},{"name":"non_subscriber_average_revenue","type":"NUMBER","nullable":false,"description":"Average revenue per non-subscriber over the past 12 months for sellers and 6 months for vendors."},{"name":"lost_revenue_due_to_oos","type":"NUMBER","nullable":false,"description":"Subscribe & Save revenue that would have been generated if the offer had not been out of stock."},{"name":"subscriber_average_reorders","type":"NUMBER","nullable":false,"description":"Average reorders per Subscribe & Save subscriber over the past 12 months."},{"name":"non_subscriber_average_reorders","type":"NUMBER","nullable":false,"description":"Average reorders per non-subscriber over the past 12 months."},{"name":"coupons_revenue_penetration","type":"NUMBER","nullable":false,"description":"Percentage of revenue from ASINs with coupons out of total revenue from all ASINs (0-100)."},{"name":"revenue_from_subscriptions_with_multiple_deliveries","type":"NUMBER","nullable":false,"description":"Subscribe & Save revenue from subscriptions with more than two deliveries over the past 12 months."},{"name":"revenue_from_active_subscriptions_with_single_delivery","type":"NUMBER","nullable":false,"description":"Subscribe & Save revenue from active subscriptions with one delivery over the past 12 months."},{"name":"revenue_from_cancelled_subscriptions_after_single_delivery","type":"NUMBER","nullable":false,"description":"Subscribe & Save revenue from subscriptions cancelled after one delivery over the past 12 months."},{"name":"subscriber_retention_for_30_days","type":"NUMBER","nullable":false,"description":"Percentage of subscriptions retained 30 days after subscription creation (0-100)."},{"name":"subscriber_retention_for_90_days","type":"NUMBER","nullable":false,"description":"Percentage of subscriptions retained 90 days after subscription creation (0-100)."},{"name":"revenue_penetration_for_0_percent_seller_funding","type":"NUMBER","nullable":false,"description":"Percentage of Subscribe & Save revenue from offers with 0% seller-funded discount over the past 12 months (0-100)."},{"name":"revenue_penetration_for_5_percent_seller_funding","type":"NUMBER","nullable":false,"description":"Seller-only. Percentage of Subscribe & Save revenue from offers with 5% seller-funded discount over the past 12 months (0-100)."},{"name":"revenue_penetration_for_10_percent_seller_funding","type":"NUMBER","nullable":false,"description":"Seller-only. Percentage of Subscribe & Save revenue from offers with 10% seller-funded discount over the past 12 months (0-100)."},{"name":"revenue_penetration_for_5_plus_percent_seller_funding","type":"NUMBER","nullable":false,"description":"Vendor-only. Percentage of Subscribe & Save revenue from offers with 5% or higher seller-funded discount over the past 12 months (0-100)."},{"name":"share_of_coupon_subscriptions","type":"NUMBER","nullable":false,"description":"Percentage of new Subscribe & Save subscriptions that came from coupons (0-100)."},{"name":"non_subscriber_lifetime_value_from_otp","type":"NUMBER","nullable":false,"description":"Revenue from one-time purchases by customers who have never subscribed to products in this catalog."},{"name":"lost_subscriber_lifetime_value_from_otp","type":"NUMBER","nullable":false,"description":"One-time purchase revenue from customers who previously subscribed but currently have no active subscriptions in this catalog."},{"name":"lost_subscriber_lifetime_value_from_sns","type":"NUMBER","nullable":false,"description":"Subscribe & Save revenue from customers who previously subscribed but currently have no active subscriptions in this catalog."},{"name":"growing_subscriber_lifetime_value_from_otp","type":"NUMBER","nullable":false,"description":"One-time purchase revenue from customers whose first subscription in this catalog started in the past 12 months."},{"name":"growing_subscriber_lifetime_value_from_sns","type":"NUMBER","nullable":false,"description":"Subscribe & Save revenue from customers whose first subscription in this catalog started in the past 12 months."},{"name":"established_subscriber_lifetime_value_from_otp","type":"NUMBER","nullable":false,"description":"One-time purchase revenue from customers with an active subscription in this catalog for more than 12 months."},{"name":"established_subscriber_lifetime_value_from_sns","type":"NUMBER","nullable":false,"description":"Subscribe & Save revenue from customers with an active subscription in this catalog for more than 12 months."},{"name":"signup_conversion_for_0_percent_seller_funding","type":"NUMBER","nullable":false,"description":"Percentage of new subscriptions from offers with 0% seller-funded discount out of new orders over the past 12 months (0-100)."},{"name":"signup_conversion_for_5_percent_seller_funding","type":"NUMBER","nullable":false,"description":"Seller-only. Percentage of new subscriptions from offers with 5% seller-funded discount out of new orders over the past 12 months (0-100)."},{"name":"signup_conversion_for_10_percent_seller_funding","type":"NUMBER","nullable":false,"description":"Seller-only. Percentage of new subscriptions from offers with 10% seller-funded discount out of new orders over the past 12 months (0-100)."},{"name":"signup_conversion_for_5_plus_percent_seller_funding","type":"NUMBER","nullable":false,"description":"Vendor-only. Percentage of new subscriptions from offers with 5% or higher seller-funded discount out of new orders over the past 12 months (0-100)."},{"name":"revenue_penetration","type":"NUMBER","nullable":false,"description":"Subscribe & Save program revenue as a percentage of total product revenue for the same grain and day (0-100). Denominator is total product revenue (SnS plus non-SnS), not total seller revenue."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Subscribe & Save PERFORMANCE metrics by calendar day. Date is the metric aggregation day, not order date or ship date. total_subscriptions_revenue is SnS program revenue for that day; Amazon does not label it as ordered or shipped sales. shipped_subscription_units is the shipped-units metric. revenue_penetration is SnS program revenue as a percentage of total product revenue.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_replenishment_metrics_by_date"],"containsPii":false,"initialLoadProgress":null},{"id":"e00006360d84f9b881db981cb543cef7226448931a82d9641d88562edeafb214","name":"Replenishment Metrics by SKU & Date","tableName":"amazon_replenishment_metrics_by_sku_and_date","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":"ISO calendar day of the Subscribe & Save PERFORMANCE metric from SP-API Replenishment. Not order date or ship date."},{"name":"period_start_date","type":"DATE","nullable":false,"description":"Start of the Amazon metric time interval (same calendar day for DAY aggregation)."},{"name":"period_end_date","type":"DATE","nullable":false,"description":"End of the Amazon metric time interval (same calendar day for DAY aggregation)."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"amazon_replenishment_program_type","type":"TEXT","nullable":false,"description":"Always SUBSCRIBE_AND_SAVE."},{"name":"amazon_replenishment_time_period_type","type":"TEXT","nullable":false,"description":"Always PERFORMANCE (historical metrics, not forecast)."},{"name":"amazon_replenishment_aggregation_frequency","type":"TEXT","nullable":false,"description":"Always DAY."},{"name":"amazon_replenishment_fulfillment_channel_type","type":"TEXT","nullable":false,"description":"Seller-only fulfillment channel for the offer: AMAZON (FBA) or MERCHANT (MFN). Not populated for vendors."},{"name":"currency_code","type":"TEXT","nullable":false,"description":null},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null},{"name":"not_delivered_due_to_oos","type":"NUMBER","nullable":false,"description":"Share of Subscribe & Save items not shipped because of out of stock, relative to shipped subscription units for the metric day (Amazon notDeliveredDueToOOS)."},{"name":"total_subscriptions_revenue","type":"NUMBER","nullable":false,"description":"Subscribe & Save subscription revenue for the metric day. Amazon does not label this as ordered or shipped sales; it is program revenue over the aggregation period. Use shipped_subscription_units for shipped units."},{"name":"shipped_subscription_units","type":"NUMBER","nullable":false,"description":"Subscribe & Save units shipped to subscribers during the metric day. This is the shipped-units metric; total_subscriptions_revenue is not documented as shipped dollars."},{"name":"active_subscriptions","type":"NUMBER","nullable":false,"description":"Number of active Subscribe & Save subscriptions at the end of the metric day."},{"name":"revenue_penetration","type":"NUMBER","nullable":false,"description":"Subscribe & Save program revenue as a percentage of total product revenue for the same grain and day (0-100). Denominator is total product revenue (SnS plus non-SnS), not total seller revenue."},{"name":"lost_revenue_due_to_oos","type":"NUMBER","nullable":false,"description":"Subscribe & Save revenue that would have been generated if the offer had not been out of stock."},{"name":"coupons_revenue_penetration","type":"NUMBER","nullable":false,"description":"Percentage of revenue from ASINs with coupons out of total revenue from all ASINs (0-100)."},{"name":"share_of_coupon_subscriptions","type":"NUMBER","nullable":false,"description":"Percentage of new Subscribe & Save subscriptions that came from coupons (0-100)."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Subscribe & Save PERFORMANCE metrics by SKU and calendar day. Date is the metric aggregation day, not order date or ship date. total_subscriptions_revenue is SnS program revenue for that SKU and day; Amazon does not label it as ordered or shipped sales. shipped_subscription_units is the shipped-units metric. revenue_penetration is SnS program revenue as a percentage of total product revenue for that offer.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_replenishment_metrics_by_sku_and_date"],"containsPii":false,"initialLoadProgress":null},{"id":"7290b1c5846a68e57a8841eb300452dd1902c591770b99f8164af5de3fa70dfc","name":"Replenishment Offers","tableName":"amazon_replenishment_offers","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"amazon_replenishment_program_type","type":"TEXT","nullable":false,"description":"Always SUBSCRIBE_AND_SAVE."},{"name":"amazon_replenishment_program_eligibility","type":"TEXT","nullable":false,"description":"Whether the offer is eligible for Subscribe & Save."},{"name":"amazon_replenishment_fulfillment_network_id_type","type":"TEXT","nullable":false,"description":"Fulfillment network identifier for the Subscribe & Save offer."},{"name":"price","type":"NUMBER","nullable":false,"description":null},{"name":"price_currency_code","type":"TEXT","nullable":false,"description":null},{"name":"inventory","type":"JSON","nullable":true,"description":null},{"name":"subscriptions","type":"JSON","nullable":true,"description":null},{"name":"stock_risk","type":"TEXT","nullable":true,"description":null},{"name":"vendor_codes","type":"JSON","nullable":true,"description":null},{"name":"offer_program_configuration","type":"JSON","nullable":true,"description":null},{"name":"deliveries_conditions","type":"JSON","nullable":true,"description":null},{"name":"forecast_deliveries","type":"JSON","nullable":true,"description":null},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Current Amazon Subscribe & Save offer snapshot by SKU (eligibility, configuration, inventory, subscriptions). Not a sales time series; use the replenishment metrics tables for SnS revenue and shipped units.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_replenishment_offers"],"containsPii":false,"initialLoadProgress":null},{"id":"6b7ef5513e5d6b0a846b8f1fad328fbc9b6f6b36c64ce1ae33ce4abad6171fe5","name":"Item Offers","tableName":"amazon_item_offers","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"asin","type":"TEXT","nullable":false,"description":null},{"name":"item_condition","type":"TEXT","nullable":false,"description":null},{"name":"status","type":"TEXT","nullable":true,"description":null},{"name":"sku","type":"TEXT","nullable":true,"description":null},{"name":"summary","type":"JSON","nullable":true,"description":"Amazon Summary object: TotalOfferCount, LowestPrices, BuyBoxPrices, etc. Same shape as SP-API."},{"name":"offers","type":"JSON","nullable":true,"description":"Amazon Offers array: per-seller offer, price, Buy Box/FBA flags, seller feedback, etc. Same shape as SP-API."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Competitive offers (Buy Box, seller offers, listing/shipping/landed price) by ASIN and item condition.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_item_offers"],"containsPii":false,"initialLoadProgress":null},{"id":"b7080fc32e526ffca1cb68908342409ce533b6ffd9c4b4bc2807dc56b98ec5a7","name":"AWD Inbound Shipment Line Items","tableName":"amazon_awd_inbound_shipment_line_items","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"awd_inbound_shipment_id","type":"TEXT","nullable":false,"description":null},{"name":"line_item_no","type":"NUMBER","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":true,"description":null},{"name":"expected_quantity","type":"JSON","nullable":true,"description":null},{"name":"received_quantity","type":"JSON","nullable":true,"description":null},{"name":"line_item_data","type":"JSON","nullable":true,"description":null,"bigQueryOnly":true},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null},{"name":"date","type":"DATE","nullable":false,"description":"Date the shipment line item was last seen."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"AWD inbound shipment line items by shipment id and line item number.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_awd_inbound_shipment_line_items"],"containsPii":false,"initialLoadProgress":null},{"id":"cedb25975382c4cbae7e2d8a5a58b19b12fa947bd64218476e2b6f4d530128d2","name":"AWD Replenishment Orders","tableName":"amazon_awd_replenishment_orders","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"awd_replenishment_order_id","type":"TEXT","nullable":false,"description":null},{"name":"awd_replenishment_order_status","type":"TEXT","nullable":true,"description":null},{"name":"confirmed_on","type":"DATE","nullable":true,"description":null},{"name":"created_at","type":"DATE","nullable":true,"description":null},{"name":"updated_at","type":"DATE","nullable":true,"description":null},{"name":"distribution_ineligible_reasons","type":"JSON","nullable":true,"description":null},{"name":"outbound_shipments","type":"JSON","nullable":true,"description":null},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null},{"name":"date","type":"DATE","nullable":false,"description":"Date the order was created."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"AWD replenishment orders by order id.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_awd_replenishment_orders"],"containsPii":false,"initialLoadProgress":null},{"id":"85aeada68a63908d0ecefff13badd6dd677923b18955c53bcb9edb8d991198d3","name":"AWD Replenishment Order Line Items","tableName":"amazon_awd_replenishment_order_line_items","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"awd_replenishment_order_id","type":"TEXT","nullable":false,"description":null},{"name":"line_item_source","type":"TEXT","nullable":false,"description":null},{"name":"line_item_no","type":"NUMBER","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":true,"description":null},{"name":"quantity","type":"NUMBER","nullable":true,"description":null},{"name":"awd_replenishment_shipment_id","type":"TEXT","nullable":true,"description":null},{"name":"awd_replenishment_shipment_status","type":"TEXT","nullable":true,"description":null},{"name":"failure_code","type":"TEXT","nullable":true,"description":null},{"name":"failure_reasons","type":"JSON","nullable":true,"description":null},{"name":"attributes","type":"JSON","nullable":true,"description":null,"bigQueryOnly":true},{"name":"line_item_data","type":"JSON","nullable":true,"description":null,"bigQueryOnly":true},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null},{"name":"order_updated_at","type":"DATE","nullable":true,"description":"updated_at of the parent AWD replenishment order."},{"name":"date","type":"DATE","nullable":false,"description":"Date the order line item was last seen."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"AWD replenishment order line items by order id and line item number.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_awd_replenishment_order_line_items"],"containsPii":false,"initialLoadProgress":null},{"id":"d760539058fdb2a0cb8dd5c4a0eae7f37b88740e0ee42bffa2227bd9f47b4e18","name":"AWD Outbound Orders","tableName":"amazon_awd_outbound_orders","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"awd_outbound_order_id","type":"TEXT","nullable":false,"description":null},{"name":"awd_outbound_order_status","type":"TEXT","nullable":true,"description":"Amazon OutboundStatus: DRAFT, VALIDATING, ELIGIBLE, INELIGIBLE, CONFIRMED, EXECUTING, INVENTORY_OUTBOUND, SUCCESS, or FAILURE. ELIGIBLE is the only status that can be confirmed. Shipments appear at INVENTORY_OUTBOUND. SUCCESS means every shipment was received at the destination channel."},{"name":"awd_outbound_order_confirmed_on","type":"DATE","nullable":true,"description":"When the outbound order was confirmed. Empty until confirmation. Not the created timestamp."},{"name":"awd_outbound_order_created_at_utc","type":"DATE","nullable":true,"description":null},{"name":"awd_outbound_order_updated_at_utc","type":"DATE","nullable":true,"description":null},{"name":"order_preferences","type":"JSON","nullable":true,"description":"Array of orderPreference and orderPreferenceValue. The only preference is PARTIAL_ORDER, and its value is SET or UNSET."},{"name":"execution_errors","type":"JSON","nullable":true,"description":"Validation failures: failureCode, failureReasons (list of strings), and optional sku. Populated when the order failed validation (INELIGIBLE)."},{"name":"eligible_products_to_outbound","type":"JSON","nullable":true,"description":"Each item has sku and quantity, plus optional attributes, expiration, and prepDetails. Amazon marked this list eligible to outbound. Not the requested list and not the shipped list."},{"name":"products_to_outbound","type":"JSON","nullable":true,"description":"Each item has sku and quantity, plus optional attributes, expiration, and prepDetails. Requested to outbound. Not eligible_products_to_outbound and not shipped_outbound_products."},{"name":"shipped_outbound_products","type":"JSON","nullable":true,"description":"Each item has sku and quantity, plus optional attributes, expiration, and prepDetails. Shipped after confirmation, once execution has completed. Not the requested quantity."},{"name":"date","type":"DATE","nullable":false,"description":"Date the outbound order was created."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"AWD outbound orders: inventory leaving AWD for a destination channel, one row per order id. Not amazon_awd_replenishment_orders (AWD to FBA) and not amazon_awd_inbound_shipments. Shipments are amazon_awd_outbound_shipments. Product arrays are separate stages; do not add them.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_awd_outbound_orders"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["awd outbound","destination channel"]},{"id":"a0dfe9c7223026550b6aac49db39f93a611f80ec787cc738558ffc991195b0a5","name":"AWD Outbound Shipments","tableName":"amazon_awd_outbound_shipments","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"awd_outbound_shipment_id","type":"TEXT","nullable":false,"description":null},{"name":"awd_outbound_order_id","type":"TEXT","nullable":true,"description":"Parent AWD outbound order. Join key to amazon_awd_outbound_orders."},{"name":"awd_outbound_shipment_status","type":"TEXT","nullable":true,"description":"Amazon OutboundShipmentStatus: CREATED, IN_TRANSIT, DELIVERED, RECEIVING, RECEIVED, CLOSED, CANCELLED, or FAILED. DELIVERED means the carrier reported arrival and the destination has not acknowledged it. RECEIVING means the destination acknowledged arrival. CLOSED, CANCELLED, and FAILED are final."},{"name":"shipment_product_quantities","type":"JSON","nullable":true,"description":"Each item has sku and quantity, plus optional attributes, expiration, and prepDetails, for this shipment. Not the order-level products_to_outbound list."},{"name":"destination_address_name","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_address_line1","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_address_line2","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_address_line3","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_city","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_county","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_district","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_state_or_region","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_postal_code","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_country_code","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_phone_number","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_name","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_address_line1","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_address_line2","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_address_line3","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_city","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_county","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_district","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_state_or_region","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_postal_code","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_country_code","type":"TEXT","nullable":true,"description":null},{"name":"origin_address_phone_number","type":"TEXT","nullable":true,"description":null},{"name":"awd_outbound_shipment_created_at_utc","type":"DATE","nullable":true,"description":null},{"name":"awd_outbound_shipment_updated_at_utc","type":"DATE","nullable":true,"description":null},{"name":"date","type":"DATE","nullable":false,"description":"Date the outbound shipment was created."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"AWD outbound shipments for an amazon_awd_outbound_orders row, with origin and destination addresses. One row per shipment id. Quantities on this row are this shipment only.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_awd_outbound_shipments"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["awd outbound shipment"]},{"id":"21f4ad2c83f8adcdeb969dd9bae51fdd1a88f7a34c474f14298d3c09a9814938","name":"AWD Outbound Shipment Packages","tableName":"amazon_awd_outbound_shipment_packages","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"awd_outbound_order_id","type":"TEXT","nullable":false,"description":null},{"name":"awd_outbound_shipment_id","type":"TEXT","nullable":false,"description":"Shipment id for shipment_package_quantities. Order-level sources (eligible_packages_to_outbound, packages_to_outbound, shipped_outbound_packages) store __EMPTY__."},{"name":"package_source","type":"TEXT","nullable":false,"description":"Which Amazon array this row came from: eligible_packages_to_outbound, packages_to_outbound, shipped_outbound_packages, or shipment_package_quantities. Do not sum count across package_source."},{"name":"line_item_no","type":"NUMBER","nullable":false,"description":null},{"name":"count","type":"NUMBER","nullable":true,"description":"Number of cases or pallets with this package configuration. Not the unit quantity. Units per package are in contents."},{"name":"package_type","type":"TEXT","nullable":true,"description":"Amazon DistributionPackageType: CASE or PALLET. PALLET is in the enum and is not supported."},{"name":"contents","type":"JSON","nullable":true,"description":"One package configuration. CASE rows use contents.products (sku, quantity, and optional attributes, expiration, and prepDetails). PALLET rows use nested contents.packages, and PALLET is not supported. Total units on a CASE row are count times the sum of contents.products[].quantity."},{"name":"measurements","type":"JSON","nullable":true,"description":"Weight of one package, plus optional dimensions and volume. Each measure includes its unit. Weight is required by Amazon."},{"name":"line_item_data","type":"JSON","nullable":true,"description":null,"bigQueryOnly":true},{"name":"date","type":"DATE","nullable":false,"description":"Created date of the parent record: the outbound order for eligible_packages_to_outbound, packages_to_outbound, and shipped_outbound_packages; the shipment for shipment_package_quantities."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"AWD outbound distribution packages exploded from the order and from each shipment. One row per package configuration. Filter package_source before summing; the same configuration can appear in more than one source array.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_awd_outbound_shipment_packages"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["distribution package","awd carton"]},{"id":"8bc6f4bd0931e728b80b9d18abd92bbc7dfe2aeb3c05f290c731d9fb195db3bf","name":"FBA Inbound Shipments","tableName":"amazon_fba_inbound_shipments","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"inbound_plan_id","type":"TEXT","nullable":false,"description":null},{"name":"fba_inbound_shipment_id","type":"TEXT","nullable":false,"description":null},{"name":"seller_sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"quantity","type":"NUMBER","nullable":false,"description":null},{"name":"expiration","type":"DATE","nullable":true,"description":null},{"name":"label_owner","type":"TEXT","nullable":false,"description":null},{"name":"manufacturing_lot_code","type":"TEXT","nullable":true,"description":null},{"name":"prep_instructions","type":"JSON","nullable":false,"description":null},{"name":"shipment_name","type":"TEXT","nullable":true,"description":null},{"name":"fba_inbound_shipment_status","type":"TEXT","nullable":false,"description":null},{"name":"shipment_confirmation_id","type":"TEXT","nullable":true,"description":null},{"name":"amazon_reference_id","type":"TEXT","nullable":true,"description":null},{"name":"destination_warehouse_id","type":"TEXT","nullable":true,"description":null},{"name":"destination_type","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_name","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_address_line1","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_address_line2","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_city","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_company_name","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_country_code","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_district_or_county","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_email","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_phone_number","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_postal_code","type":"TEXT","nullable":true,"description":null},{"name":"destination_address_state_or_province_code","type":"TEXT","nullable":true,"description":null},{"name":"source_address_name","type":"TEXT","nullable":true,"description":null},{"name":"source_address_address_line1","type":"TEXT","nullable":true,"description":null},{"name":"source_address_address_line2","type":"TEXT","nullable":true,"description":null},{"name":"source_address_city","type":"TEXT","nullable":true,"description":null},{"name":"source_address_company_name","type":"TEXT","nullable":true,"description":null},{"name":"source_address_country_code","type":"TEXT","nullable":true,"description":null},{"name":"source_address_district_or_county","type":"TEXT","nullable":true,"description":null},{"name":"source_address_email","type":"TEXT","nullable":true,"description":null},{"name":"source_address_phone_number","type":"TEXT","nullable":true,"description":null},{"name":"source_address_postal_code","type":"TEXT","nullable":true,"description":null},{"name":"source_address_state_or_province_code","type":"TEXT","nullable":true,"description":null},{"name":"ready_to_ship_window_start","type":"DATE","nullable":true,"description":null},{"name":"ready_to_ship_window_end","type":"DATE","nullable":true,"description":null},{"name":"selected_delivery_window_start","type":"DATE","nullable":true,"description":null},{"name":"selected_delivery_window_end","type":"DATE","nullable":true,"description":null},{"name":"placement_option_id","type":"TEXT","nullable":true,"description":null},{"name":"plan_name","type":"TEXT","nullable":true,"description":null},{"name":"plan_status","type":"TEXT","nullable":true,"description":null},{"name":"plan_created_at","type":"DATE","nullable":true,"description":null},{"name":"plan_last_updated_at","type":"DATE","nullable":true,"description":null},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"FBA inbound shipment line items from inbound plans with shipment status, destination and source addresses, and plan metadata.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_fba_inbound_shipments"],"containsPii":false,"initialLoadProgress":null},{"id":"705516b99d12eae4bbe684c371f9408595f6325b5e52ef3ae9c4d293d0da7dad","name":"FBA Shipments","tableName":"amazon_fba_shipments","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"shipment_item_id","type":"TEXT","nullable":false,"description":null},{"name":"amazon_order_id","type":"TEXT","nullable":false,"description":null},{"name":"merchant_order_id","type":"TEXT","nullable":true,"description":null},{"name":"shipment_id","type":"TEXT","nullable":false,"description":null},{"name":"amazon_order_item_id","type":"TEXT","nullable":false,"description":null},{"name":"merchant_order_item_id","type":"TEXT","nullable":true,"description":null},{"name":"purchase_date","type":"DATE","nullable":true,"description":null},{"name":"payments_date","type":"DATE","nullable":true,"description":null},{"name":"shipment_date","type":"DATE","nullable":true,"description":null},{"name":"reporting_date","type":"DATE","nullable":true,"description":null},{"name":"buyer_email","type":"TEXT","nullable":true,"description":null},{"name":"buyer_name","type":"TEXT","nullable":true,"description":null},{"name":"buyer_phone_number","type":"TEXT","nullable":true,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"quantity_shipped","type":"NUMBER","nullable":true,"description":null},{"name":"currency","type":"TEXT","nullable":true,"description":null},{"name":"item_price","type":"NUMBER","nullable":true,"description":null},{"name":"item_tax","type":"NUMBER","nullable":true,"description":null},{"name":"shipping_price","type":"NUMBER","nullable":true,"description":null},{"name":"shipping_tax","type":"NUMBER","nullable":true,"description":null},{"name":"gift_wrap_price","type":"NUMBER","nullable":true,"description":null},{"name":"gift_wrap_tax","type":"NUMBER","nullable":true,"description":null},{"name":"ship_service_level","type":"TEXT","nullable":true,"description":null},{"name":"recipient_name","type":"TEXT","nullable":true,"description":null},{"name":"ship_address_1","type":"TEXT","nullable":true,"description":null},{"name":"ship_address_2","type":"TEXT","nullable":true,"description":null},{"name":"ship_address_3","type":"TEXT","nullable":true,"description":null},{"name":"ship_city","type":"TEXT","nullable":true,"description":null},{"name":"ship_state","type":"TEXT","nullable":true,"description":null},{"name":"ship_postal_code","type":"TEXT","nullable":true,"description":null},{"name":"ship_country","type":"TEXT","nullable":true,"description":null},{"name":"ship_phone_number","type":"TEXT","nullable":true,"description":null},{"name":"bill_address_1","type":"TEXT","nullable":true,"description":null},{"name":"bill_address_2","type":"TEXT","nullable":true,"description":null},{"name":"bill_address_3","type":"TEXT","nullable":true,"description":null},{"name":"bill_city","type":"TEXT","nullable":true,"description":null},{"name":"bill_state","type":"TEXT","nullable":true,"description":null},{"name":"bill_postal_code","type":"TEXT","nullable":true,"description":null},{"name":"bill_country","type":"TEXT","nullable":true,"description":null},{"name":"item_promotion_discount","type":"NUMBER","nullable":true,"description":null},{"name":"ship_promotion_discount","type":"NUMBER","nullable":true,"description":null},{"name":"carrier","type":"TEXT","nullable":true,"description":null},{"name":"fba_shipment_tracking_number","type":"TEXT","nullable":true,"description":null},{"name":"estimated_arrival_date","type":"DATE","nullable":true,"description":null},{"name":"fulfillment_center_id","type":"TEXT","nullable":true,"description":null},{"name":"fulfillment_channel","type":"TEXT","nullable":true,"description":null},{"name":"sales_channel","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon-fulfilled shipment line items with order, item, pricing, and shipping address details.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":28},{"type":"RECURRING_DAILY","numberOfDays":21}],"sources":["connections","raw_sp_api_report_afn_shipments"],"containsPii":true,"initialLoadProgress":null},{"id":"5a6dd198558a83b086709f9416ec8c7c0b3696bb5eddee008f53ab322c8082c1","name":"FBA Removal Orders","tableName":"amazon_fba_removal_orders","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"request_date","type":"DATE","nullable":true,"description":null},{"name":"fba_removal_order_id","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"disposition","type":"TEXT","nullable":true,"description":null},{"name":"last_updated_date","type":"DATE","nullable":true,"description":null},{"name":"fba_removal_order_source","type":"TEXT","nullable":true,"description":null},{"name":"fba_removal_order_type","type":"TEXT","nullable":true,"description":null},{"name":"service_speed","type":"TEXT","nullable":true,"description":null},{"name":"fba_removal_order_status","type":"TEXT","nullable":true,"description":null},{"name":"requested_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"cancelled_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"disposed_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"shipped_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"in_process_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"removal_fee","type":"NUMBER","nullable":true,"description":null},{"name":"currency","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"FBA removal order line items with quantities, fees, and status.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_FBA_REMOVAL_ORDERS_ADD","relation":"writes"}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":730},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_sp_api_report_fba_removal_orders"],"containsPii":false,"initialLoadProgress":null},{"id":"23ed787fe0ac5ce848ae049fdcea14a0dc94d74792aa62ed49afe332ea6ed19e","name":"FBA Recommended Removals","tableName":"amazon_fba_removal_recommended","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"snapshot_date","type":"DATE","nullable":true,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"condition","type":"TEXT","nullable":true,"description":null},{"name":"sellable_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"sellable_121_180_days","type":"NUMBER","nullable":true,"description":null},{"name":"sellable_181_270_days","type":"NUMBER","nullable":true,"description":null},{"name":"sellable_271_365_days","type":"NUMBER","nullable":true,"description":null},{"name":"sellable_365_plus_days","type":"NUMBER","nullable":true,"description":null},{"name":"sellable_removal_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"unsellable_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"unsellable_0_7_days","type":"NUMBER","nullable":true,"description":null},{"name":"unsellable_8_60_days","type":"NUMBER","nullable":true,"description":null},{"name":"unsellable_61_90_days","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Recommended FBA removal quantities by SKU with sellable and unsellable inventory age buckets.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"sources":["connections","raw_sp_api_report_fba_recommended_removal"],"containsPii":false,"initialLoadProgress":null},{"id":"a4d08771c8d67c28bcedd7cd3685ceb96a632b13b3e242a25312314a1062aede","name":"FBA Stranded Inventory","tableName":"amazon_fba_stranded_inventory","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"primary_action","type":"TEXT","nullable":true,"description":"Primary action Amazon recommends for this stranded inventory."},{"name":"date_stranded","type":"DATE","nullable":true,"description":"Date the inventory became stranded."},{"name":"date_to_take_auto_removal","type":"DATE","nullable":true,"description":"Date Amazon will automatically remove the inventory if no action is taken."},{"name":"status_primary","type":"TEXT","nullable":true,"description":null},{"name":"status_secondary","type":"TEXT","nullable":true,"description":null},{"name":"error_message","type":"TEXT","nullable":true,"description":null},{"name":"stranded_reason","type":"TEXT","nullable":true,"description":"Reason the inventory is stranded."},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"condition","type":"TEXT","nullable":true,"description":null},{"name":"fulfilled_by","type":"TEXT","nullable":true,"description":null},{"name":"fulfillable_qty","type":"NUMBER","nullable":true,"description":null},{"name":"your_price","type":"NUMBER","nullable":true,"description":null},{"name":"unfulfillable_qty","type":"NUMBER","nullable":true,"description":null},{"name":"reserved_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"inbound_shipped_qty","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"FBA stranded inventory that is in Amazon fulfillment centers but not available for sale, with recommended actions, status, and quantities. Updated daily by replacing the full snapshot.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"sources":["connections","raw_sp_api_report_stranded_inventory_ui_data"],"containsPii":false,"initialLoadProgress":null},{"id":"fd04a82a3af4ab17ca4fb9fd36516f332366f26a385e7af6ecaa38adfb96a337","name":"FBA Removal Shipments","tableName":"amazon_fba_removal_shipments","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"fba_removal_order_id","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"fba_removal_shipment_tracking_number","type":"TEXT","nullable":true,"description":null},{"name":"shipment_date","type":"DATE","nullable":true,"description":null},{"name":"request_date","type":"DATE","nullable":true,"description":null},{"name":"removal_shipment_no","type":"NUMBER","nullable":true,"description":null},{"name":"shipped_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"carrier","type":"TEXT","nullable":true,"description":null},{"name":"removal_order_type","type":"TEXT","nullable":true,"description":null},{"name":"disposition","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"FBA removal shipment details linked to removal orders.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":730},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_sp_api_report_fba_removal_shipments"],"containsPii":false,"initialLoadProgress":null},{"id":"2e123a1fcf957a35cc86a54d45a9a922a60e1bc4eda669f60f8b8da625ffce3e","name":"FBA Replacement Shipments","tableName":"amazon_fba_replacement_shipments","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"replacement_amazon_order_id","type":"TEXT","nullable":false,"description":null},{"name":"original_amazon_order_id","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"shipment_replacement_no","type":"NUMBER","nullable":true,"description":null},{"name":"shipment_date","type":"DATE","nullable":true,"description":null},{"name":"fulfillment_center_id","type":"TEXT","nullable":true,"description":null},{"name":"original_fulfillment_center_id","type":"TEXT","nullable":true,"description":null},{"name":"replacement_reason_code","type":"TEXT","nullable":true,"description":null},{"name":"quantity","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"FBA replacement shipments with original and replacement order references.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":730},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_sp_api_report_fba_shipment_replacement"],"containsPii":false,"initialLoadProgress":null},{"id":"542b4c4b4e2d6a223d2af0ce839a7666a32fb3e5338a0731610ef9658cb7935c","name":"FBA Restock Recommendations","tableName":"amazon_fba_restock_recommendations","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":"Snapshot date."},{"name":"country","type":"TEXT","nullable":true,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"condition","type":"TEXT","nullable":true,"description":null},{"name":"supplier","type":"TEXT","nullable":true,"description":null},{"name":"supplier_part_no","type":"TEXT","nullable":true,"description":null},{"name":"currency_code","type":"TEXT","nullable":true,"description":null},{"name":"price","type":"NUMBER","nullable":true,"description":null},{"name":"sales_last_30_days","type":"NUMBER","nullable":true,"description":null},{"name":"units_sold_last_30_days","type":"NUMBER","nullable":true,"description":null},{"name":"total_units","type":"NUMBER","nullable":true,"description":null},{"name":"inbound","type":"NUMBER","nullable":true,"description":null},{"name":"available","type":"NUMBER","nullable":true,"description":null},{"name":"fc_transfer","type":"NUMBER","nullable":true,"description":null},{"name":"fc_processing","type":"NUMBER","nullable":true,"description":null},{"name":"customer_order","type":"NUMBER","nullable":true,"description":null},{"name":"unfulfillable","type":"NUMBER","nullable":true,"description":null},{"name":"working","type":"NUMBER","nullable":true,"description":null},{"name":"shipped","type":"NUMBER","nullable":true,"description":null},{"name":"receiving","type":"NUMBER","nullable":true,"description":null},{"name":"fulfilled_by","type":"TEXT","nullable":true,"description":null},{"name":"total_days_of_supply_including_units_from_open_shipments","type":"NUMBER","nullable":true,"description":null},{"name":"days_of_supply_at_amazon_fulfillment_network","type":"NUMBER","nullable":true,"description":null},{"name":"alert","type":"TEXT","nullable":true,"description":null},{"name":"recommended_replenishment_qty","type":"NUMBER","nullable":true,"description":null},{"name":"recommended_ship_date","type":"DATE","nullable":true,"description":null},{"name":"unit_storage_size","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"FBA restock recommendations with inventory levels, sales velocity, and replenishment guidance stored as daily snapshots.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"1pm"},"sources":["connections","raw_sp_api_report_restock_inventory"],"containsPii":false,"initialLoadProgress":null},{"id":"2a81389e421f7abeecb076466834cc274a5d085d28697c344e901d995ca2a432","name":"FBA Inventory by ASIN & Country","tableName":"amazon_fba_inventory_by_asin_by_country","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"country_code","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"condition_type","type":"TEXT","nullable":false,"description":"Condition enum values."},{"name":"quantity_for_local_fulfillment","type":"NUMBER","nullable":false,"description":null},{"name":"date","type":"DATE","nullable":false,"description":"Single date may occur multiple times."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Daily inventory data snapshot for all FBA listings per country.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"RECURRING_DAILY","numberOfDays":1}],"sources":["connections","refined_amazon_fba_inventory_by_asin_by_country"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["fba stock","inventory"]},{"id":"44fc5ba0ce81a7807601f6d7a9b8b7aaec64be4c7e046ea30dc6864d1a4aa823","name":"FBA Inventory Health","tableName":"amazon_fba_inventory_health","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":"Daily snapshot. Not additive across dates."},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"condition","type":"TEXT","nullable":false,"description":"New / Used / or empty"},{"name":"available","type":"NUMBER","nullable":false,"description":null},{"name":"pending_removal_quantity","type":"NUMBER","nullable":false,"description":null},{"name":"inv_age_0_to_90_days","type":"NUMBER","nullable":false,"description":"Sellable units aged 0–90 days. Already includes inv_age_0_to_30_days, inv_age_31_to_60_days, and inv_age_61_to_90_days. Do not add those columns to this one."},{"name":"inv_age_91_to_180_days","type":"NUMBER","nullable":false,"description":null},{"name":"inv_age_181_to_270_days","type":"NUMBER","nullable":false,"description":null},{"name":"inv_age_271_to_365_days","type":"NUMBER","nullable":false,"description":null},{"name":"currency","type":"TEXT","nullable":false,"description":null},{"name":"units_shipped_t7","type":"NUMBER","nullable":false,"description":null},{"name":"units_shipped_t30","type":"NUMBER","nullable":false,"description":null},{"name":"units_shipped_t60","type":"NUMBER","nullable":false,"description":null},{"name":"units_shipped_t90","type":"NUMBER","nullable":false,"description":null},{"name":"alert","type":"TEXT","nullable":false,"description":null},{"name":"your_price","type":"NUMBER","nullable":true,"description":null},{"name":"sales_price","type":"NUMBER","nullable":true,"description":null},{"name":"lowest_price_new_plus_shipping","type":"NUMBER","nullable":true,"description":null},{"name":"lowest_price_used","type":"NUMBER","nullable":true,"description":null},{"name":"recommended_action","type":"TEXT","nullable":true,"description":null},{"name":"recommended_sales_price","type":"NUMBER","nullable":false,"description":null},{"name":"recommended_sale_duration_days","type":"NUMBER","nullable":false,"description":null},{"name":"recommended_removal_quantity","type":"NUMBER","nullable":false,"description":null},{"name":"estimated_cost_savings_of_recommended_actions","type":"NUMBER","nullable":false,"description":null},{"name":"sell_through","type":"NUMBER","nullable":true,"description":"Units shipped in the trailing 90 days divided by average on-hand units. Not a 0–1 or 0–100 percentage."},{"name":"item_volume","type":"NUMBER","nullable":false,"description":null},{"name":"volume_unit_measurement","type":"TEXT","nullable":true,"description":"cubic feet / or empty"},{"name":"storage_type","type":"TEXT","nullable":false,"description":"Other / Footwear / Apparel / Standard / or empty"},{"name":"storage_volume","type":"NUMBER","nullable":false,"description":null},{"name":"marketplace","type":"TEXT","nullable":false,"description":"Marketplace enum values."},{"name":"product_group","type":"TEXT","nullable":false,"description":"gl_home_improvement / gl_drugstore / gl_home / gl_personal_care_appliances / gl_biss / gl_beauty / gl_sports / gl_apparel / gl_pet_products / gl_office_product / gl_kitchen / gl_toy / gl_shoes / gl_electronics"},{"name":"sales_rank","type":"NUMBER","nullable":false,"description":null},{"name":"days_of_supply","type":"NUMBER","nullable":false,"description":"Estimated days the current FBA inventory will last at recent sales. A snapshot, not a unit count to sum across dates."},{"name":"estimated_excess_quantity","type":"NUMBER","nullable":false,"description":null},{"name":"weeks_of_cover_t30","type":"NUMBER","nullable":false,"description":null},{"name":"weeks_of_cover_t90","type":"NUMBER","nullable":false,"description":null},{"name":"featuredoffer_price","type":"NUMBER","nullable":false,"description":null},{"name":"sales_shipped_last_7_days","type":"NUMBER","nullable":false,"description":null},{"name":"sales_shipped_last_30_days","type":"NUMBER","nullable":false,"description":null},{"name":"sales_shipped_last_60_days","type":"NUMBER","nullable":false,"description":null},{"name":"sales_shipped_last_90_days","type":"NUMBER","nullable":false,"description":null},{"name":"inv_age_0_to_30_days","type":"NUMBER","nullable":false,"description":null},{"name":"inv_age_31_to_60_days","type":"NUMBER","nullable":false,"description":null},{"name":"inv_age_61_to_90_days","type":"NUMBER","nullable":false,"description":null},{"name":"inv_age_181_to_330_days","type":"NUMBER","nullable":false,"description":null},{"name":"inv_age_331_to_365_days","type":"NUMBER","nullable":false,"description":null},{"name":"estimated_storage_cost_next_month","type":"NUMBER","nullable":false,"description":null},{"name":"inbound_quantity","type":"NUMBER","nullable":false,"description":"Total quantity of units in inbound shipments. Sum of inbound_working, inbound_shipped, and inbound_received."},{"name":"inbound_working","type":"NUMBER","nullable":false,"description":null},{"name":"inbound_shipped","type":"NUMBER","nullable":false,"description":null},{"name":"inbound_received","type":"NUMBER","nullable":false,"description":null},{"name":"no_sale_last_6_months","type":"NUMBER","nullable":false,"description":null},{"name":"total_reserved_quantity","type":"NUMBER","nullable":false,"description":null},{"name":"unfulfillable_quantity","type":"NUMBER","nullable":false,"description":null},{"name":"quantity_to_be_charged_ais_181_210_days","type":"NUMBER","nullable":false,"description":null},{"name":"estimated_ais_181_210_days","type":"NUMBER","nullable":false,"description":null},{"name":"quantity_to_be_charged_ais_211_240_days","type":"NUMBER","nullable":false,"description":null},{"name":"estimated_ais_211_240_days","type":"NUMBER","nullable":false,"description":null},{"name":"quantity_to_be_charged_ais_241_270_days","type":"NUMBER","nullable":false,"description":null},{"name":"estimated_ais_241_270_days","type":"NUMBER","nullable":false,"description":null},{"name":"quantity_to_be_charged_ais_271_300_days","type":"NUMBER","nullable":false,"description":null},{"name":"estimated_ais_271_300_days","type":"NUMBER","nullable":false,"description":null},{"name":"quantity_to_be_charged_ais_301_330_days","type":"NUMBER","nullable":false,"description":null},{"name":"estimated_ais_301_330_days","type":"NUMBER","nullable":false,"description":null},{"name":"quantity_to_be_charged_ais_331_365_days","type":"NUMBER","nullable":false,"description":null},{"name":"estimated_ais_331_365_days","type":"NUMBER","nullable":false,"description":null},{"name":"historical_days_of_supply","type":"NUMBER","nullable":false,"description":null},{"name":"fba_minimum_inventory_level","type":"NUMBER","nullable":false,"description":null},{"name":"fba_inventory_level_health_status","type":"TEXT","nullable":false,"description":"FBA inventory level health status enum values."},{"name":"recommended_ship_in_quantity","type":"NUMBER","nullable":false,"description":null},{"name":"recommended_ship_in_date","type":"DATE","nullable":false,"description":null},{"name":"last_updated_date_for_historical_days_of_supply","type":"DATE","nullable":false,"description":null},{"name":"exempted_from_low_inventory_level_fee","type":"LOGIC","nullable":false,"description":null},{"name":"low_inventory_level_fee_applied_in_current_week","type":"LOGIC","nullable":false,"description":null},{"name":"short_term_historical_days_of_supply","type":"NUMBER","nullable":false,"description":null},{"name":"long_term_historical_days_of_supply","type":"NUMBER","nullable":false,"description":null},{"name":"inventory_age_snapshot_date","type":"DATE","nullable":false,"description":null},{"name":"inventory_supply_at_fba","type":"NUMBER","nullable":false,"description":"Total on-hand inventory at FBA fulfillment centers, including available and FC transfer units."},{"name":"reserved_fc_transfer","type":"NUMBER","nullable":true,"description":null},{"name":"reserved_fc_processing","type":"NUMBER","nullable":false,"description":null},{"name":"reserved_customer_order","type":"NUMBER","nullable":false,"description":null},{"name":"reserved_staging","type":"NUMBER","nullable":true,"description":"Reserved staging units from the Reserved Inventory snapshot for the same date and product. NULL when the snapshot or a valid quantity is unavailable."},{"name":"total_days_of_supply_including_units_from_open_shipments","type":"NUMBER","nullable":false,"description":null},{"name":"supplier","type":"TEXT","nullable":false,"description":null},{"name":"inv_age_366_to_455_days","type":"NUMBER","nullable":true,"description":"Units of inventory that have been in an Amazon fulfillment center for 366 to 455 days."},{"name":"inv_age_456_plus_days","type":"NUMBER","nullable":true,"description":"Units of inventory that have been in an Amazon fulfillment center for 456 days or more."},{"name":"quantity_to_be_charged_ais_366_455_days","type":"NUMBER","nullable":true,"description":"Units subject to the aged inventory surcharge for the 366-455 day aging bucket."},{"name":"estimated_ais_366_455_days","type":"NUMBER","nullable":true,"description":"Estimated aged inventory surcharge for units in the 366-455 day aging bucket."},{"name":"quantity_to_be_charged_ais_456_plus_days","type":"NUMBER","nullable":true,"description":"Units subject to the aged inventory surcharge for the 456+ day aging bucket."},{"name":"estimated_ais_456_plus_days","type":"NUMBER","nullable":true,"description":"Estimated aged inventory surcharge for units in the 456+ day aging bucket."},{"name":"mfn_listing_exists","type":"LOGIC","nullable":true,"description":"Whether a merchant-fulfilled listing exists for this SKU."},{"name":"mfn_fulfillable_quantity","type":"NUMBER","nullable":true,"description":"Units in the merchant-fulfilled (non-FBA) network that are ready for picking and shipping."},{"name":"afn_listing_exists","type":"LOGIC","nullable":true,"description":"Whether an FBA (Amazon-fulfilled) listing exists for this SKU."},{"name":"afn_warehouse_quantity","type":"NUMBER","nullable":true,"description":"Units for this SKU in Amazon fulfillment centers, combining fulfillable, unsellable, and reserved quantities."},{"name":"afn_fulfillable_quantity","type":"NUMBER","nullable":true,"description":"Units for this SKU in Amazon fulfillment centers that are pickable and available to sell."},{"name":"afn_unsellable_quantity","type":"NUMBER","nullable":true,"description":"Units for this SKU in Amazon fulfillment centers that are damaged or otherwise not sellable."},{"name":"afn_reserved_quantity","type":"NUMBER","nullable":true,"description":"Units for this SKU in Amazon fulfillment centers reserved for pending orders, inbound transfers, or processing."},{"name":"afn_total_quantity","type":"NUMBER","nullable":true,"description":"Total units for this SKU across all Amazon fulfillment center statuses."},{"name":"per_unit_volume","type":"NUMBER","nullable":true,"description":"Volume of a single unit, in cubic feet."},{"name":"afn_inbound_working_quantity","type":"NUMBER","nullable":true,"description":"Units in an inbound shipment to Amazon that are still being prepared for shipping."},{"name":"afn_inbound_shipped_quantity","type":"NUMBER","nullable":true,"description":"Units in an inbound shipment to Amazon that have been shipped but not yet received."},{"name":"afn_inbound_receiving_quantity","type":"NUMBER","nullable":true,"description":"Units in an inbound shipment to Amazon that have arrived and are being checked in."},{"name":"afn_researching_quantity","type":"NUMBER","nullable":true,"description":"Units at Amazon fulfillment centers under investigation for an inventory discrepancy."},{"name":"afn_reserved_future_supply","type":"NUMBER","nullable":true,"description":"Units reserved for future customer orders not yet ready to ship."},{"name":"afn_future_supply_buyable","type":"NUMBER","nullable":true,"description":"Units of future inbound supply that are currently buyable."},{"name":"afn_onhand_buyable_quantity","type":"NUMBER","nullable":true,"description":"Units in Amazon fulfillment centers that are processed, available, and actively buyable by customers. Distinct from in-transit FC transfer units."}],"userManaged":false,"isPremium":true,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Consolidated daily FBA inventory health snapshot across sales windows (7, 30, 60, and 90 days), inbound shipment statuses (working, received, and shipped), estimated storage and long-term storage fees, aged and excess units, and recommended actions. One row per SKU and date; not additive across dates. inv_age_0_to_90_days already includes inv_age_0_to_30_days, inv_age_31_to_60_days, and inv_age_61_to_90_days. The planning-report-sourced columns are not available in the MX marketplace.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"10am, 1pm, 4pm"},"sources":["connections","raw_sp_api_report_fba_inventory_planning","raw_sp_api_report_restock_inventory","raw_sp_api_myi_unsuppressed_inventory_data","raw_sp_api_report_reserved_inventory"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["fba stock","inventory","warehouse","aged inventory"]},{"id":"d7716dee8fd10ff00f94a9d7fd4a0b0f74d6b6759e29a4ffca6ef4a0cb4816d9","name":"FBA Overage Fee Charges","tableName":"amazon_fba_overage_fees","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"charged_date","type":"DATE","nullable":false,"description":null},{"name":"country_code","type":"TEXT","nullable":false,"description":null},{"name":"storage_type","type":"TEXT","nullable":false,"description":"Storage type enum values."},{"name":"charge_rate","type":"TEXT","nullable":false,"description":"Charge rate enum values."},{"name":"storage_usage_volume","type":"NUMBER","nullable":false,"description":null},{"name":"storage_limit_volume","type":"NUMBER","nullable":false,"description":null},{"name":"overage_volume","type":"NUMBER","nullable":false,"description":null},{"name":"volume_unit","type":"TEXT","nullable":false,"description":"Volume unit enum values."},{"name":"charged_fee_amount","type":"NUMBER","nullable":false,"description":null},{"name":"currency","type":"TEXT","nullable":false,"description":"Currency code."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily overage fee charges based on FBA storage usage limits.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"sources":["connections","raw_sp_api_report_fba_overage_fee_charges"],"containsPii":false,"initialLoadProgress":null},{"id":"829e34f54e72ade58cb032ae2db770cf70c863a5897fefda93c4dbae9bb38ad0","name":"FBA Ledger Summary","tableName":"amazon_fba_ledger_summary","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"msku","type":"TEXT","nullable":false,"description":null},{"name":"title","type":"TEXT","nullable":false,"description":null},{"name":"disposition","type":"TEXT","nullable":false,"description":"DEFECTIVE / SELLABLE / CUSTOMER_DAMAGED"},{"name":"starting_warehouse_balance","type":"NUMBER","nullable":false,"description":null},{"name":"in_transit_between_warehouses","type":"NUMBER","nullable":false,"description":null},{"name":"receipts","type":"NUMBER","nullable":false,"description":null},{"name":"customer_shipments","type":"NUMBER","nullable":false,"description":null},{"name":"customer_returns","type":"NUMBER","nullable":false,"description":null},{"name":"vendor_returns","type":"NUMBER","nullable":false,"description":null},{"name":"warehouse_transfer_in_out","type":"NUMBER","nullable":false,"description":null},{"name":"found","type":"NUMBER","nullable":false,"description":null},{"name":"lost","type":"NUMBER","nullable":false,"description":null},{"name":"damaged","type":"NUMBER","nullable":false,"description":null},{"name":"disposed","type":"NUMBER","nullable":false,"description":null},{"name":"other_events","type":"NUMBER","nullable":false,"description":null},{"name":"ending_warehouse_balance","type":"NUMBER","nullable":false,"description":null},{"name":"unknown_events","type":"NUMBER","nullable":false,"description":null},{"name":"location","type":"TEXT","nullable":false,"description":"Amazon warehouse code."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily FBA ledger summary by fulfillment center. Quantities are signed: receipts and customer returns increase inventory, customer shipments and disposals decrease it. starting_warehouse_balance plus the movement columns equals ending_warehouse_balance for that location. Do not sum locations without grouping by fnsku.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":540},{"type":"RECURRING_DAILY","numberOfDays":7}],"sources":["connections","raw_sp_api_report_fba_ledger_summary"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["inventory ledger","warehouse balance"]},{"id":"6a6e14526df6972c97b2a5cb55649855f91181832cd2899cfebc3cc5bb54bbf0","name":"FBA Ledger Details","tableName":"amazon_fba_ledger_details","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"msku","type":"TEXT","nullable":false,"description":null},{"name":"title","type":"TEXT","nullable":false,"description":null},{"name":"event_type","type":"TEXT","nullable":false,"description":"Adjustments / CustomerReturns / Receipts / Shipments / VendorReturns / WhseTransfers"},{"name":"reference_id","type":"TEXT","nullable":false,"description":null},{"name":"quantity","type":"NUMBER","nullable":false,"description":null},{"name":"fulfillment_center","type":"TEXT","nullable":false,"description":null},{"name":"disposition","type":"TEXT","nullable":false,"description":"CARRIER_DAMAGED  / CUSTOMER_DAMAGED / DEFECTIVE / DISTRIBUTOR_DAMAGED / EXPIRED / SELLABLE / WAREHOUSE_DAMAGED"},{"name":"reason","type":"TEXT","nullable":false,"description":null},{"name":"country","type":"TEXT","nullable":false,"description":"ISO country code"},{"name":"reconciled_quantity","type":"NUMBER","nullable":false,"description":null},{"name":"unreconciled_quantity","type":"NUMBER","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily FBA ledger details with per-event inventory movements, references, and reconciliation quantities.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":540},{"type":"RECURRING_DAILY","numberOfDays":7}],"sources":["connections","raw_sp_api_report_fba_ledger_detail"],"containsPii":false,"initialLoadProgress":null},{"id":"316ea56bca9b5c665b2aa835c861b634d7cada971aa3814abf8f872b7e3f469e","name":"FBA Storage Fee Charges","tableName":"amazon_fba_storage_fees","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"fulfillment_center","type":"TEXT","nullable":false,"description":null},{"name":"country_code","type":"TEXT","nullable":false,"description":null},{"name":"longest_side","type":"NUMBER","nullable":false,"description":null},{"name":"median_side","type":"NUMBER","nullable":false,"description":null},{"name":"shortest_side","type":"NUMBER","nullable":false,"description":null},{"name":"measurement_units","type":"TEXT","nullable":false,"description":"centimeters"},{"name":"weight","type":"NUMBER","nullable":false,"description":null},{"name":"weight_units","type":"TEXT","nullable":false,"description":"kilograms"},{"name":"item_volume","type":"NUMBER","nullable":false,"description":null},{"name":"volume_units","type":"TEXT","nullable":false,"description":"cubic feet / cubic meters"},{"name":"product_size_tier","type":"TEXT","nullable":false,"description":"Oversize / Standard-Size"},{"name":"average_quantity_on_hand","type":"NUMBER","nullable":false,"description":null},{"name":"average_quantity_pending_removal","type":"NUMBER","nullable":false,"description":null},{"name":"estimated_total_item_volume","type":"NUMBER","nullable":false,"description":null},{"name":"month_of_charge","type":"DATE","nullable":false,"description":"First day of the month this charge refers to."},{"name":"storage_rate","type":"NUMBER","nullable":false,"description":null},{"name":"currency","type":"TEXT","nullable":false,"description":"Currency code."},{"name":"estimated_monthly_storage_fee","type":"NUMBER","nullable":false,"description":null},{"name":"dangerous_goods_storage_type","type":"TEXT","nullable":false,"description":"Dangerous goods storage type enum values."},{"name":"eligible_for_inventory_discount","type":"LOGIC","nullable":false,"description":null},{"name":"qualifies_for_inventory_discount","type":"LOGIC","nullable":false,"description":null},{"name":"total_incentive_fee_amount","type":"NUMBER","nullable":false,"description":null},{"name":"breakdown_incentive_fee_amount","type":"NUMBER","nullable":false,"description":null},{"name":"average_quantity_customer_orders","type":"NUMBER","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily FBA storage fee charges with historical data.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":-1},{"type":"RECURRING_DAILY","numberOfDays":1}],"sources":["connections","raw_sp_api_report_fba_storage_fee_charges"],"containsPii":false,"initialLoadProgress":null},{"id":"4e67eb700fbd05a0840c41a5157bf77dd47f12a41696db34f058ed20dd432aac","name":"FBA Long-Term Storage Fee Charges","tableName":"amazon_fba_long_term_storage_fees","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"snapshot_date","type":"DATE","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"condition","type":"TEXT","nullable":false,"description":"Used / New / No Listing"},{"name":"per_unit_volume","type":"NUMBER","nullable":false,"description":null},{"name":"currency","type":"TEXT","nullable":false,"description":"Currency code."},{"name":"volume_unit","type":"TEXT","nullable":false,"description":"cubic_meters / cubic_feet"},{"name":"country","type":"TEXT","nullable":false,"description":"ISO country code"},{"name":"qty_charged","type":"NUMBER","nullable":false,"description":null},{"name":"amount_charged","type":"NUMBER","nullable":false,"description":null},{"name":"surcharge_age_tier","type":"TEXT","nullable":false,"description":null},{"name":"rate_surcharge","type":"NUMBER","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily long-term FBA storage fee charges with historical data.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":730},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_sp_api_report_fba_fulfillment_longterm_storage_fee_charges"],"containsPii":false,"initialLoadProgress":null},{"id":"13b0fdeaffb6d9c697e0e9942aabc1b0a2ed409ba611860e0beb9776b9e54f2d","name":"FBA Reimbursements","tableName":"amazon_fba_reimbursements","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"approval_date","type":"DATE","nullable":false,"description":null},{"name":"reimbursement_id","type":"TEXT","nullable":false,"description":null},{"name":"case_id","type":"TEXT","nullable":false,"description":null},{"name":"amazon_order_id","type":"TEXT","nullable":false,"description":null},{"name":"reason","type":"TEXT","nullable":false,"description":"GeneralAdjustment / Lost_Outbound / Payment_Retraction / Damaged_Warehouse / FeeCorrection / CustomerReturn / Reimbursement_Reversal / Lost_Warehouse  / Lost_Inbound / or empty"},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"condition","type":"TEXT","nullable":false,"description":"NewItem / UsedGood / UsedVeryGood / UsedAcceptable / UsedPoor / UsedLikeNew"},{"name":"currency_unit","type":"TEXT","nullable":false,"description":"Currency code. Single Seller may have reimbursements in multiple currencies."},{"name":"amount_per_unit","type":"NUMBER","nullable":false,"description":null},{"name":"amount_total","type":"NUMBER","nullable":false,"description":null},{"name":"quantity_reimbursed_cash","type":"NUMBER","nullable":false,"description":null},{"name":"quantity_reimbursed_inventory","type":"NUMBER","nullable":false,"description":null},{"name":"quantity_reimbursed_total","type":"NUMBER","nullable":false,"description":null},{"name":"original_reimbursement_id","type":"TEXT","nullable":false,"description":null},{"name":"original_reimbursement_type","type":"TEXT","nullable":true,"description":"Damaged_Warehouse / Lost_Inbound / CustomerReturn / Lost_Warehouse / or empty"}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily FBA reimbursements with historical data.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":730},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_sp_api_report_fba_reimbursements"],"containsPii":false,"initialLoadProgress":null},{"id":"27c6fc0ec69648b5fed4612dbd9ccdfdeaaca6787f8f985c01266e4dc11f9038","name":"Returns (FBA & FBM)","tableName":"amazon_returns","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_return_tracking_id","type":"TEXT","nullable":true,"description":"Available only for FBM returns."},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":true,"description":"Fulfillment Network SKU. Available only for FBA returns."},{"name":"product_name","type":"TEXT","nullable":true,"description":"Product name from the returns report. FBA uses product-name. FBM uses item-name."},{"name":"fba_customer_comments","type":"TEXT","nullable":true,"description":"Customer comments. Available only for FBA returns."},{"name":"amazon_order_id","type":"TEXT","nullable":false,"description":null},{"name":"order_date","type":"DATE","nullable":true,"description":"Available only for FBM returns."},{"name":"date","type":"DATE","nullable":false,"description":"FBA: return/receipt date at the fulfillment center (return-date). FBM: return request date."},{"name":"amazon_return_request_status","type":"TEXT","nullable":false,"description":"Return request status. FBM values: 'Approved', 'Closed', 'PendingApproval'. FBA values: 'Unit returned to inventory', 'Reimbursed', 'Repackaged Successfully', 'IMMEDIATE_DISPOSAL', 'IMMEDIATE_DONATION', 'IMMEDIATE_LIQUIDATION'."},{"name":"amazon_return_rmaid","type":"TEXT","nullable":true,"description":"Available only for FBM returns."},{"name":"amazon_return_seller_rmaid","type":"TEXT","nullable":true,"description":"Available only for FBM returns."},{"name":"amazon_return_label_cost","type":"NUMBER","nullable":true,"description":"Available only for FBM returns."},{"name":"amazon_return_carrier","type":"TEXT","nullable":true,"description":"Available only for FBM returns."},{"name":"amazon_return_label_to_be_paid_by","type":"TEXT","nullable":true,"description":"'Seller' or 'Customer'."},{"name":"amazon_order_is_prime","type":"LOGIC","nullable":true,"description":"Available only for FBM returns (is-prime on the FBM returns report)."},{"name":"amazon_return_refunded_amount","type":"NUMBER","nullable":true,"description":"Available only for FBM returns."},{"name":"amazon_return_reason","type":"TEXT","nullable":false,"description":"Amazon return reason code. FBA uses the reason field from its customer returns report; common values include UNWANTED_ITEM and NOT_AS_DESCRIBED. FBM uses Return Reason from its returns report; common values include CR-UNWANTED_ITEM and AMZ-PG-BAD-DESC. These codes are not normalized: CR-UNWANTED_ITEM matches UNWANTED_ITEM, while AMZ-PG-BAD-DESC matches NOT_AS_DESCRIBED. Some codes do not follow these prefixes. Use amazon_fulfillment_channel and map equivalent codes before combining FBA and FBM reasons."},{"name":"amazon_return_detailed_disposition","type":"TEXT","nullable":true,"description":"FBA only: condition assigned to a returned item by Amazon, separate from the customer's return reason. Observed values include SELLABLE, CUSTOMER_DAMAGED, DEFECTIVE, CARRIER_DAMAGED, and DAMAGED. Null for FBM returns. Only SELLABLE is treated as sellable in profit-table refund_cost."},{"name":"amazon_fulfillment_channel","type":"TEXT","nullable":false,"description":"'FBA' or 'FBM'"},{"name":"amazon_fulfillment_channel_id","type":"TEXT","nullable":true,"description":"Available only for FBA returns."},{"name":"amazon_license_plate_number","type":"TEXT","nullable":false,"description":null},{"name":"quantity","type":"NUMBER","nullable":false,"description":"Returned units on this event."},{"name":"cogs_item_value","type":"NUMBER","nullable":true,"description":"Item COGS for returned units: unit item cost from amazon_cogs as of the return date, times quantity.","definition":"(amazon_cogs.cost_item_value ?? 0) * (amazon_returns.quantity ?? 0)"},{"name":"cogs_shipping_value","type":"NUMBER","nullable":true,"description":"Shipping COGS for returned units: unit shipping cost from amazon_cogs as of the return date, times quantity.","definition":"(amazon_cogs.cost_item_shipping_value ?? 0) * (amazon_returns.quantity ?? 0)"},{"name":"cogs_total_value","type":"NUMBER","nullable":true,"description":"Sum of cogs_item_value and cogs_shipping_value.","definition":"((amazon_cogs.cost_item_value ?? 0) + (amazon_cogs.cost_item_shipping_value ?? 0)) * (amazon_returns.quantity ?? 0)"},{"name":"cogs_present","type":"LOGIC","nullable":false,"description":"True when an uploaded COGS record applies to this row. Zero cost can still be valid."},{"name":"cogs_currency","type":"TEXT","nullable":true,"description":"Currency code for COGS."},{"name":"item_supplier_name","type":"TEXT","nullable":true,"description":"Supplier name for the item COGS, if provided in COGS upload."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Physical return events, not payout refunds. FBA rows are items received at a fulfillment center; date is return/receipt date. FBM rows are return requests by return-request date. quantity is returned units. fnsku and fba_customer_comments are FBA only. product_name is the name on the returns report (FBA product-name, FBM item-name). amazon_return_detailed_disposition is FBA only (SELLABLE, CUSTOMER_DAMAGED, DEFECTIVE, etc.). cogs_* is unit cost as of the return date, times quantity. For payout refunds use amazon_settlements_with_cogs where settlement_type is REFUND.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":60},{"type":"RECURRING_DAILY","numberOfDays":60}],"sources":["connections","raw_amazon_cogs","raw_sp_api_report_fba_fulfillment_customer_returns","raw_sp_api_report_flat_file_returns_data_by_return_date"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["refunds","customer returns"]},{"id":"fdde8da48f90ec8317748b3c026903f1c5dc6c00af91e10c953822dd3c51e424","name":"Account Status Changed Notifications","tableName":"amazon_notifications_account_status_changed","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: ACCOUNT_STATUS_CHANGED."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API ACCOUNT_STATUS_CHANGED notifications for seller account health and performance status changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_account_status_changed"],"containsPii":false,"initialLoadProgress":null},{"id":"095dfac030ff2d0571cb15508a91725efb8878327c5b906d07e1b3afa284ff2d","name":"Any Offer Changed Notifications","tableName":"amazon_notifications_any_offer_changed","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: ANY_OFFER_CHANGED."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API ANY_OFFER_CHANGED notifications for competitive offer and Buy Box changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_any_offer_changed"],"containsPii":false,"initialLoadProgress":null},{"id":"1c2586c1960ba09e592efdcee52a7d7e5c6f8e70880af3d7544e79674b7bfa12","name":"B2B Any Offer Changed Notifications","tableName":"amazon_notifications_b2b_any_offer_changed","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: B2B_ANY_OFFER_CHANGED."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API B2B_ANY_OFFER_CHANGED notifications for B2B competitive offer changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_b2b_any_offer_changed"],"containsPii":false,"initialLoadProgress":null},{"id":"aec3d5976911a7a80110c08801a741e4f0a25dd997d639f5d918284d905a4758","name":"Branded Item Content Change Notifications","tableName":"amazon_notifications_branded_item_content_change","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: BRANDED_ITEM_CONTENT_CHANGE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API BRANDED_ITEM_CONTENT_CHANGE notifications for A+ content changes on brand-registered ASINs.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_branded_item_content_change"],"containsPii":false,"initialLoadProgress":null},{"id":"7f3aeb3af8ce6fd83a9167de473791995624da9c850a8b55e117f3e75f671902","name":"Detail Page Traffic Event Notifications","tableName":"amazon_notifications_detail_page_traffic_event","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: DETAIL_PAGE_TRAFFIC_EVENT."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API DETAIL_PAGE_TRAFFIC_EVENT notifications for detail page traffic events.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_detail_page_traffic_event"],"containsPii":false,"initialLoadProgress":null},{"id":"b464da18dc8c33507a432fcbc3ce5139ef1c5509b59466d6bc7e547265a7b263","name":"FBA Inventory Availability Changes Notifications","tableName":"amazon_notifications_fba_inventory_availability_changes","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: FBA_INVENTORY_AVAILABILITY_CHANGES."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API FBA_INVENTORY_AVAILABILITY_CHANGES notifications for FBA inventory availability changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_fba_inventory_availability_changes"],"containsPii":false,"initialLoadProgress":null},{"id":"172eed3bd2d9f32b049d0bc1fde08d7927dc4c38482135846f0d9311d5075ba4","name":"FBA Outbound Shipment Status Notifications","tableName":"amazon_notifications_fba_outbound_shipment_status","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: FBA_OUTBOUND_SHIPMENT_STATUS."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API FBA_OUTBOUND_SHIPMENT_STATUS notifications for FBA outbound shipment status updates.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_fba_outbound_shipment_status"],"containsPii":false,"initialLoadProgress":null},{"id":"6d430c429d28f8f347636033aba261baeca5dd97557966f675de204384708269","name":"Fee Promotion Notifications","tableName":"amazon_notifications_fee_promotion","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: FEE_PROMOTION."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API FEE_PROMOTION notifications for Amazon fee promotion events.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_fee_promotion"],"containsPii":false,"initialLoadProgress":null},{"id":"396c89528b23c903698c416c307e557466179399f927e1634c2b1b4fcad395dd","name":"Item Inventory Event Change Notifications","tableName":"amazon_notifications_item_inventory_event_change","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: ITEM_INVENTORY_EVENT_CHANGE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API ITEM_INVENTORY_EVENT_CHANGE notifications for item inventory event changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_item_inventory_event_change"],"containsPii":false,"initialLoadProgress":null},{"id":"f92d95d23d43c861ee9fe7141c1c7a15634d44e701cfdd8664b553a82c7eabda","name":"Item Product Type Change Notifications","tableName":"amazon_notifications_item_product_type_change","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: ITEM_PRODUCT_TYPE_CHANGE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API ITEM_PRODUCT_TYPE_CHANGE notifications for listing product type definition changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_item_product_type_change"],"containsPii":false,"initialLoadProgress":null},{"id":"beccb6e0943f1044e2742864470769d8770186196fcd4f434c6d50e898ba2645","name":"Item Sales Event Change Notifications","tableName":"amazon_notifications_item_sales_event_change","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: ITEM_SALES_EVENT_CHANGE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API ITEM_SALES_EVENT_CHANGE notifications for item sales event changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_item_sales_event_change"],"containsPii":false,"initialLoadProgress":null},{"id":"f6118edb9e783fab664f796adc86a2f52f937aa6977555c488f8581af5f63385","name":"Listings Item Issues Change Notifications","tableName":"amazon_notifications_listings_item_issues_change","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: LISTINGS_ITEM_ISSUES_CHANGE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API LISTINGS_ITEM_ISSUES_CHANGE notifications for listing quality and issue changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_listings_item_issues_change"],"containsPii":false,"initialLoadProgress":null},{"id":"2d4b42e19b2b969e7de568af0d7112574b74bcd72741cb147ad75fefc71c12ef","name":"Listings Item MFN Quantity Change Notifications","tableName":"amazon_notifications_listings_item_mfn_quantity_change","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: LISTINGS_ITEM_MFN_QUANTITY_CHANGE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API LISTINGS_ITEM_MFN_QUANTITY_CHANGE notifications for MFN listing quantity changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_listings_item_mfn_quantity_change"],"containsPii":false,"initialLoadProgress":null},{"id":"08515c2f60d358f04dfcb0a1f57e67301c3d232d1e16016a7bcdd6524822d993","name":"Listings Item Status Change Notifications","tableName":"amazon_notifications_listings_item_status_change","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: LISTINGS_ITEM_STATUS_CHANGE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API LISTINGS_ITEM_STATUS_CHANGE notifications for listing status changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_listings_item_status_change"],"containsPii":false,"initialLoadProgress":null},{"id":"c97da5f92306b062e09114cc6a6cc7b4c76ecf1043ab81d1d038b8389d0446b6","name":"Pricing Health Notifications","tableName":"amazon_notifications_pricing_health","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: PRICING_HEALTH."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API PRICING_HEALTH notifications for Featured Offer ineligibility caused by an uncompetitive price.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_pricing_health"],"containsPii":false,"initialLoadProgress":null},{"id":"7b2b86a4e0742970ee831e78341826ea29b351b91ee0ba88b2f86fbb7a9c27cf","name":"Shipment Tracking Milestone Changed Notifications","tableName":"amazon_notifications_shipment_tracking_milestone_changed","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: SHIPMENT_TRACKING_MILESTONE_CHANGED."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API SHIPMENT_TRACKING_MILESTONE_CHANGED notifications for Amazon Tracking API shipment milestone updates.","requiresDatePeriod":false,"issues":[],"prerequisites":"Amazon requires a subscription for each tracking identifier (US Tracking API). Use the AMAZON_SHIPMENT_TRACKING_SUBSCRIBE Action to send tracking IDs. DataDoe does not subscribe automatically.","relatedActions":[{"type":"AMAZON_SHIPMENT_TRACKING_SUBSCRIBE","relation":"prerequisite"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_shipment_tracking_milestone_changed"],"containsPii":false,"initialLoadProgress":null},{"id":"85c2c092ad2a1fdbe670b90e4729c418de0ca89e72019a21d6fc4072d4dba3c0","name":"Transaction Update Notifications","tableName":"amazon_notifications_transaction_update","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: TRANSACTION_UPDATE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API TRANSACTION_UPDATE notifications for financial transaction updates.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_transaction_update"],"containsPii":false,"initialLoadProgress":null},{"id":"3119e997a14f1392c5e02cec402d98c45ed7c053f27db737bf97cf3f841e19fe","name":"Order Change Notifications","tableName":"amazon_notifications_order_change","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: ORDER_CHANGE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"amazon_order_id","type":"TEXT","nullable":false,"description":null},{"name":"order_status","type":"TEXT","nullable":true,"description":"Current order status. Enum values: UpComing / Pending / Unshipped / PartiallyShipped / Shipped / Canceled / Unfulfillable / InvoiceUnconfirmed / PendingAvailability."},{"name":"order_change_type","type":"TEXT","nullable":true,"description":"Reason this ORDER_CHANGE notification was sent. Enum values: BuyerRequestedChange / OrderStatusChange."},{"name":"order_change_time_utc","type":"DATE","nullable":true,"description":"UTC time of the change that caused the notification (from order_change_trigger.TimeOfOrderChange)."},{"name":"order_purchased_at_utc","type":"DATE","nullable":true,"description":"UTC purchase timestamp from the notification summary."},{"name":"order_fulfillment_channel","type":"TEXT","nullable":true,"description":"Fulfillment channel from the notification summary. Enum values: Amazon / Merchant."},{"name":"order_items_raw","type":"JSON","nullable":true,"description":"Raw order_items payload from the ORDER_CHANGE notification."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API ORDER_CHANGE notifications for order status and buyer-requested changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"Order change notifications are available shortly after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_order_change"],"containsPii":false,"initialLoadProgress":null},{"id":"2610a531e0170a7857c3edbc1d5b3dd5a7abf63ba7fbbb1997fce3e9a7421438","name":"Seller Feedback","tableName":"amazon_seller_feedback","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":"Date the feedback was left."},{"name":"amazon_order_id","type":"TEXT","nullable":false,"description":null},{"name":"buyer_rating","type":"NUMBER","nullable":false,"description":"Buyer star rating from 1 to 5."},{"name":"buyer_comments","type":"TEXT","nullable":true,"description":null},{"name":"buyer_email","type":"TEXT","nullable":true,"description":null},{"name":"seller_response","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Negative and neutral (one to three stars) feedback left for the seller by buyers, including star rating, comments, and optional seller response.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":60},{"type":"RECURRING_DAILY","numberOfDays":60}],"sources":["connections","raw_sp_api_report_seller_feedback_data"],"containsPii":false,"initialLoadProgress":null},{"id":"57036be081231374d01a690532d8353061bcc494ec29bae1397d55678688ef81","name":"Seller Account Health Metrics","tableName":"amazon_seller_performance","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"seller_account_status","type":"TEXT","nullable":true,"description":null},{"name":"seller_late_shipping_rate_30d_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_late_shipping_rate_30d_value","type":"NUMBER","nullable":false,"description":"Amazon Account Health rate for the window in the column name. Same scale as the matching target column. A rate, not a count. Do not recompute it from the count columns."},{"name":"seller_late_shipping_rate_30d_target_less_than","type":"NUMBER","nullable":false,"description":null},{"name":"seller_late_shipping_rate_30d_order_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_invoice_defect_rate_7d_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_invoice_defect_rate_7d_value","type":"NUMBER","nullable":false,"description":null},{"name":"seller_invoice_defect_rate_7d_target_less_than","type":"NUMBER","nullable":false,"description":null},{"name":"seller_invoice_defect_rate_7d_invoice_defect_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_invoice_defect_rate_7d_invoice_defect_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_invoice_defect_rate_7d_missing_invoice_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_invoice_defect_rate_7d_missing_invoice_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_invoice_defect_rate_7d_late_invoice_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_invoice_defect_rate_7d_late_invoice_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_invoice_defect_rate_7d_order_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fba_60d_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_order_defect_rate_fba_60d_value","type":"NUMBER","nullable":false,"description":"FBA order defect rate (defects, claims, chargebacks, and negative feedback). Amazon Account Health rate for the window in the column name. Same scale as the matching target column. A rate, not a count. Do not recompute it from the count columns."},{"name":"seller_order_defect_rate_fba_60d_target_less_than","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fba_60d_order_with_defects_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_order_defect_rate_fba_60d_order_with_defects_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fba_60d_claims_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_order_defect_rate_fba_60d_claims_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fba_60d_chargebacks_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_order_defect_rate_fba_60d_chargeback_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fba_60d_negative_feedback_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_order_defect_rate_fba_60d_negative_feedback_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fba_60d_order_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fbm_60d_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_order_defect_rate_fbm_60d_value","type":"NUMBER","nullable":false,"description":"Merchant-fulfilled order defect rate. Amazon Account Health rate for the window in the column name. Same scale as the matching target column. A rate, not a count. Do not recompute it from the count columns."},{"name":"seller_order_defect_rate_fbm_60d_target_less_than","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fbm_60d_order_with_defects_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_order_defect_rate_fbm_60d_order_with_defects_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fbm_60d_claims_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_order_defect_rate_fbm_60d_claims_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fbm_60d_chargebacks_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_order_defect_rate_fbm_60d_chargeback_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fbm_60d_negative_feedback_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_order_defect_rate_fbm_60d_negative_feedback_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_order_defect_rate_fbm_60d_order_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_on_time_delivery_rate_30d_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_on_time_delivery_rate_30d_value","type":"NUMBER","nullable":false,"description":null},{"name":"seller_on_time_delivery_rate_30d_target_greater_than","type":"NUMBER","nullable":false,"description":null},{"name":"seller_on_time_delivery_rate_30d_shipment_count_with_valid_tracking","type":"NUMBER","nullable":false,"description":null},{"name":"seller_on_time_delivery_rate_30d_on_time_delivery_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_valid_tracking_rate_30d_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_valid_tracking_rate_30d_value","type":"NUMBER","nullable":false,"description":null},{"name":"seller_valid_tracking_rate_30d_target_greater_than","type":"NUMBER","nullable":false,"description":null},{"name":"seller_valid_tracking_rate_30d_shipment_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_valid_tracking_rate_30d_valid_tracking_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_pre_fulfillment_cancellation_rate_7d_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_pre_fulfillment_cancellation_rate_7d_value","type":"NUMBER","nullable":false,"description":null},{"name":"seller_pre_fulfillment_cancellation_rate_7d_target_less_than","type":"NUMBER","nullable":false,"description":null},{"name":"seller_pre_fulfillment_cancellation_rate_7d_order_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_pre_fulfillment_cancellation_rate_7d_cancellation_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_account_health_rating_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_account_health_rating_6m_score","type":"NUMBER","nullable":false,"description":"Account Health Rating score from 0 to 1000. Not a percentage and not the status."},{"name":"seller_listing_policy_violations_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_listing_policy_violations_6m_target_equals","type":"NUMBER","nullable":false,"description":null},{"name":"seller_listing_policy_violations_6m_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_product_authenticity_customer_complaints_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_product_authenticity_customer_complaints_6m_target_equals","type":"NUMBER","nullable":false,"description":null},{"name":"seller_product_authenticity_customer_complaints_6m_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_product_condition_customer_complaints_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_product_condition_customer_complaints_6m_target_equals","type":"NUMBER","nullable":false,"description":null},{"name":"seller_product_condition_customer_complaints_6m_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_product_safety_customer_complaints_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_product_safety_customer_complaints_6m_target_equals","type":"NUMBER","nullable":false,"description":null},{"name":"seller_product_safety_customer_complaints_6m_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_received_intellectual_property_complaints_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_received_intellectual_property_complaints_6m_target_equals","type":"NUMBER","nullable":false,"description":null},{"name":"seller_received_intellectual_property_complaints_6m_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_restricted_product_policy_violations_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_restricted_product_policy_violations_6m_target_equals","type":"NUMBER","nullable":false,"description":null},{"name":"seller_restricted_product_policy_violations_6m_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_suspected_intellectual_property_policy_violations_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_suspected_intellectual_property_policy_violations_6m_target_equals","type":"NUMBER","nullable":false,"description":null},{"name":"seller_suspected_intellectual_property_policy_violations_6m_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_food_and_product_safety_issues_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_food_and_product_safety_issues_6m_target_equals","type":"NUMBER","nullable":false,"description":null},{"name":"seller_food_and_product_safety_issues_6m_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_customer_product_reviews_policy_violations_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_customer_product_reviews_policy_violations_6m_target_equals","type":"NUMBER","nullable":false,"description":null},{"name":"seller_customer_product_reviews_policy_violations_6m_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_other_policy_violations_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_other_policy_violations_6m_target_equals","type":"NUMBER","nullable":false,"description":null},{"name":"seller_other_policy_violations_6m_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_documents_requests_6m_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_documents_requests_6m_target_equals","type":"NUMBER","nullable":false,"description":null},{"name":"seller_documents_requests_6m_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_policy_violations_6m_warning_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_unit_on_time_delivery_rate_14d_status","type":"TEXT","nullable":false,"description":null},{"name":"seller_unit_on_time_delivery_rate_14d_value","type":"NUMBER","nullable":false,"description":null},{"name":"seller_unit_on_time_delivery_rate_14d_target_greater_than","type":"NUMBER","nullable":false,"description":null},{"name":"seller_unit_on_time_delivery_rate_14d_on_time_delivery_count","type":"NUMBER","nullable":false,"description":null},{"name":"seller_unit_on_time_delivery_rate_14d_total_unit_count","type":"NUMBER","nullable":false,"description":null},{"name":"date","type":"DATE","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Seller Central Account Health from GET_V2_SELLER_PERFORMANCE_REPORT. The latest date is the current snapshot; Amazon does not return history for older requested dates. Column windows are 7 days, 14 days, 30 days, 60 days, or 6 months. *_value and *_target_* columns are rates. *_count columns are counts. *_status is the health status. seller_account_health_rating_6m_score is the Account Health Rating score (0–1000), not a percentage. Amazon Account Health rate for the window in the column name. Same scale as the matching target column. A rate, not a count. Do not recompute it from the count columns.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"1pm"},"sources":["connections","raw_sp_api_report_v2_seller_performance"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["account health","order defect rate","odr"]},{"id":"8772614caff9e14bdbe33f4631877f4ac921e84eecbc49a38497840122ae1ab5","name":"Search Engagement by ASIN (Monthly)","tableName":"amazon_child_product_search_performance_per_month","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"search_impression_count","type":"NUMBER","nullable":false,"description":"Search-results impressions for this ASIN across queries, including sponsored results."},{"name":"search_impression_median_price_value","type":"NUMBER","nullable":false,"description":null},{"name":"search_impression_median_price_currency","type":"TEXT","nullable":false,"description":"Currency code."},{"name":"search_click_count","type":"NUMBER","nullable":false,"description":"Clicks on this ASIN from search results."},{"name":"search_click_rate","type":"NUMBER","nullable":false,"description":"Clicks divided by impressions for this ASIN, between 0 and 1. Multiply by 100 for a percentage. A rate, not a click count."},{"name":"search_clicked_median_price","type":"NUMBER","nullable":false,"description":null},{"name":"search_cart_add_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_cart_added_median_price_value","type":"NUMBER","nullable":false,"description":null},{"name":"search_cart_added_median_price_currency","type":"TEXT","nullable":false,"description":"Currency code."},{"name":"search_purchase_count","type":"NUMBER","nullable":false,"description":"Purchases of this ASIN attributed to search results."},{"name":"search_search_traffic_sales_value","type":"NUMBER","nullable":false,"description":null},{"name":"search_search_traffic_sales_currency","type":"TEXT","nullable":false,"description":"Currency code."},{"name":"search_conversion_rate","type":"NUMBER","nullable":false,"description":"Purchases divided by clicks for this ASIN, between 0 and 1. Multiply by 100 for a percentage. A rate, not an order count. Not units per session."},{"name":"search_purchase_median_price_value","type":"NUMBER","nullable":false,"description":null},{"name":"search_purchase_median_price_currency","type":"TEXT","nullable":false,"description":"Currency code."},{"name":"search_one_day_shipping_impression_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_two_day_shipping_impression_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_one_day_shipping_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_two_day_shipping_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_one_day_shipping_cart_add_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_two_day_shipping_cart_add_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_one_day_shipping_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_two_day_shipping_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"date","type":"DATE","nullable":false,"description":"First day of the month the data refers to. Represents an aggregated monthly snapshot. Data availability can lag, so use MAX(date) for the most recent month."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Monthly Search Catalog Performance per child ASIN (GET_BRAND_ANALYTICS_SEARCH_CATALOG_PERFORMANCE_REPORT). Impressions, clicks, cart adds, and purchases from search results, including sponsored results. search_click_rate is clicks divided by impressions. search_conversion_rate is purchases divided by clicks. Both rates are 0-1 fractions (Amazon examples are 0.1 and 0.05). Not Search Query Performance; that is amazon_child_product_organic_search_ranks_per_week and amazon_child_product_organic_search_ranks_per_month.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":365},{"type":"RECURRING_WEEKLY","numberOfDays":90}],"sources":["connections","raw_sp_api_report_brand_analytics_search_catalog_performance"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["search catalog","search engagement"]},{"id":"732dac689a6545697c2f2e36c61b2c9e93187053bcce2999914183c6f490df27","name":"Settlements & P&L Components","tableName":"amazon_settlements_with_cogs","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":"Marketplace-local date of the winning transaction posted time (America/Los_Angeles for US and CA). Once released this is the Transaction Release Date; while deferred it is the local date of the deferred posting. It can be one day earlier than the UTC posted timestamp near midnight, and it may differ from the order date. This column is used for the from/to filters on Export creation."},{"name":"transaction_posted_date","type":"DATE","nullable":false,"description":"Marketplace local date on which Amazon first posted the transaction (deferred posting time for deferred transactions). Matches the date/time column of the Amazon Transaction report. For deferred orders this is earlier than date. US and CA use America/Los_Angeles."},{"name":"transaction_release_date","type":"DATE","nullable":false,"description":"Marketplace local date on which Amazon released the transaction. Matches the Transaction Release Date column of the Amazon Transaction report and equals date once released. Empty while the transaction is still deferred. US and CA use America/Los_Angeles."},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"settlement_type","type":"TEXT","nullable":false,"description":"ORDER, REFUND or OTHER. REFUND is a payout refund money event, not a warehouse return."},{"name":"transaction_status","type":"TEXT","nullable":false,"description":"Amazon transaction status: RELEASED, DEFERRED or DEFERRED_RELEASED. Missing or blank status is treated as RELEASED. A deferred hold and its later release count as one row."},{"name":"amazon_order_id","type":"TEXT","nullable":false,"description":null},{"name":"merchant_order_id","type":"TEXT","nullable":false,"description":"Private seller order id."},{"name":"order_fulfillment_channel","type":"TEXT","nullable":false,"description":"The fulfillment channel of the order (Amazon or Merchant)."},{"name":"financial_event_group_id","type":"TEXT","nullable":true,"description":"Amazon financial event group identifier when available."},{"name":"settlement_id","type":"TEXT","nullable":true,"description":"Amazon settlement identifier when available."},{"name":"order_date","type":"DATE","nullable":false,"description":"Date of the order if the row is related to an order. This it prefered column for calculating profit over period of time. May be the same or up to 30 days later than the date of the settlement date.","definition":"min(raw_sp_api_report_orders.amazonOrderId === amazon_settlements_with_cogs.amazon_order_id && raw_sp_api_report_orders.sku === amazon_settlements_with_cogs.sku ? raw_sp_api_report_orders.date : null)"},{"name":"quantity","type":"NUMBER","nullable":false,"description":"Do not SUM(quantity) on REFUND rows as monthly refunded units. For warehouse returns use amazon_returns. For refunded units on the sales-performance timeline use amazon_sales_and_traffic_with_cogs.units_refunded.","definition":"amazon_settlements_with_cogs.settlement_type === 'REFUND' ? (raw_sp_api_report_fba_fulfillment_customer_returns.quantity ?? 0) + (raw_sp_api_report_flat_file_returns_data_by_return_date.returnQuantity ?? 0) : (raw_sp_api_report_orders.quantity ?? 0)"},{"name":"currency","type":"TEXT","nullable":false,"description":"Currency code."},{"name":"total_fees","type":"NUMBER","nullable":false,"description":"Deprecated, will be removed on 2026-10-31. total_non_principal_amount holds the same value.","definition":"(amazon_settlements_with_cogs.total ?? 0) - (amazon_settlements_with_cogs.item_price ?? 0)"},{"name":"total_non_principal_amount","type":"NUMBER","nullable":false,"description":"total minus item_price, in the payout sign: negative means money to Amazon. Includes customer-paid shipping, tax, promotions, reimbursements, advertising, and lost or missing inventory, not only fees.","definition":"(amazon_settlements_with_cogs.total ?? 0) - (amazon_settlements_with_cogs.item_price ?? 0)"},{"name":"total_selling_fees","type":"NUMBER","nullable":false,"description":"Referral fee plus refund commission plus refunded referral fee, in the payout sign. Negative on ORDER rows. REFUND rows add the refunded referral fee (positive, credited back) and the refund commission (negative). amazon_profit_by_date and amazon_profit_by_sku_and_date total_selling_fees use only non-REFUND rows, with the sign flipped.","definition":"(amazon_settlements_with_cogs.referral_fee ?? 0) + (amazon_settlements_with_cogs.refund_commission ?? 0) + (amazon_settlements_with_cogs.refunded_referral_fee ?? 0)"},{"name":"total","type":"NUMBER","nullable":false,"description":"Sum of all amounts in the row. May be a negative number."},{"name":"fba_per_unit_fulfillment_fee","type":"NUMBER","nullable":false,"description":null},{"name":"referral_fee","type":"NUMBER","nullable":false,"description":null},{"name":"fba_storage_fee","type":"NUMBER","nullable":false,"description":null},{"name":"missing_from_inbound_clawback","type":"NUMBER","nullable":false,"description":null},{"name":"long_term_storage_fee","type":"NUMBER","nullable":false,"description":null},{"name":"coupon_redemption_fee","type":"NUMBER","nullable":false,"description":"Amazon fee charged per coupon redemption. This is a fee, not the discount given to customers (see promotion_item_price). Distinct from coupon_performance_fee."},{"name":"coupon_performance_fee","type":"NUMBER","nullable":false,"description":"Amazon coupon performance-based fee. This is a fee, not the discount given to customers (see promotion_item_price). Distinct from coupon_redemption_fee."},{"name":"coupon_participation_fee","type":"NUMBER","nullable":false,"description":"Amazon coupon participation fee. This is a fee, not the discount given to customers (see promotion_item_price)."},{"name":"deal_performance_fee","type":"NUMBER","nullable":false,"description":"Deal performance-based fee."},{"name":"deal_participation_fee","type":"NUMBER","nullable":false,"description":"Deal participation fee, including Lightning Deal and Best Deal amounts. Finances does not distinguish Lightning from Best Deal."},{"name":"liquidations_brokerage_fee","type":"NUMBER","nullable":false,"description":null},{"name":"compensated_clawback","type":"NUMBER","nullable":false,"description":null},{"name":"customer_return_hrr_unit_fee","type":"NUMBER","nullable":false,"description":null},{"name":"fba_disposal_fee","type":"NUMBER","nullable":false,"description":null},{"name":"subscription_fee","type":"NUMBER","nullable":false,"description":null},{"name":"warehouse_damage_exception","type":"NUMBER","nullable":false,"description":null},{"name":"adjustment_fba_per_unit_fulfillment_fee","type":"NUMBER","nullable":false,"description":null},{"name":"free_replacement_refund_items","type":"NUMBER","nullable":false,"description":null},{"name":"warehouse_lost","type":"NUMBER","nullable":false,"description":null},{"name":"removal_order_lost","type":"NUMBER","nullable":false,"description":"FBA inventory reimbursement when a removal order is marked lost."},{"name":"warehouse_damage","type":"NUMBER","nullable":false,"description":null},{"name":"liquidations_revenue","type":"NUMBER","nullable":false,"description":null},{"name":"reversal_reimbursement","type":"NUMBER","nullable":false,"description":null},{"name":"missing_from_inbound","type":"NUMBER","nullable":false,"description":null},{"name":"item_price","type":"NUMBER","nullable":false,"description":null},{"name":"points_granted","type":"NUMBER","nullable":false,"description":"Japan marketplace Amazon Points granted on the order. Other marketplaces are 0."},{"name":"item_shipping_fee","type":"NUMBER","nullable":false,"description":null},{"name":"item_tax","type":"NUMBER","nullable":false,"description":"Item tax on the sale. Also receives the VAT portion when UK/EU Finances other-transaction inbound fees are split ex-VAT in the integrated view (gross minus gross/1.20). Settlement-report Tax on fee lines for inbound also map here."},{"name":"item_shipping_tax","type":"NUMBER","nullable":false,"description":null},{"name":"item_gift_wrap_tax","type":"NUMBER","nullable":false,"description":null},{"name":"item_shipping_chargeback","type":"NUMBER","nullable":false,"description":"FBA ShippingChargeback from Finances ItemFees: Amazon charges back outbound shipping cost to the seller."},{"name":"item_digital_services_fee","type":"NUMBER","nullable":false,"description":"Digital Services Fee on the original sale (Digital Services Fee / DigitalServicesFee ItemFees). Percentage surcharge Amazon applies to Selling on Amazon and FBA fees to recover digital services taxes in some countries."},{"name":"item_gift_wrap_fee","type":"NUMBER","nullable":false,"description":null},{"name":"item_gift_wrap_chargeback","type":"NUMBER","nullable":false,"description":null},{"name":"fba_inbound_convenience_fee","type":"NUMBER","nullable":false,"description":"FBA inbound convenience fee. Finances breakdown paths that include InboundConvenienceCharge are placement fees and are not stored here."},{"name":"warehouse_lost_manual","type":"NUMBER","nullable":false,"description":null},{"name":"fee_adjustment","type":"NUMBER","nullable":false,"description":"Fulfillment fee adjustments from Finances ServiceFee FulfillmentAdjustment, and settlement transaction type Fee Adjustment. Expenses are negative."},{"name":"a_to_z_guarantee_refunds","type":"NUMBER","nullable":false,"description":null},{"name":"amazon_fees","type":"NUMBER","nullable":false,"description":"Sum of all other Amazon account fees."},{"name":"commingling_vat","type":"NUMBER","nullable":false,"description":null},{"name":"marketplace_facilitator_vat","type":"NUMBER","nullable":false,"description":"EU/UK MarketplaceFacilitatorVAT-* ItemWithheldTax withheld by Amazon as marketplace facilitator VAT on the sale. US MarketplaceFacilitatorTax-* stays in item_withheld_tax."},{"name":"liquidations_other","type":"NUMBER","nullable":false,"description":null},{"name":"digital_services_fee","type":"NUMBER","nullable":false,"description":"Digital Services Fee when the Finances/settlement triple is not a typed Order or Refund ItemFees line (catch-all for DigitalServicesFee). Prefer item_digital_services_fee / refund_digital_services_fee when those are populated."},{"name":"fba_transportation_fee","type":"NUMBER","nullable":false,"description":null},{"name":"item_withheld_tax","type":"NUMBER","nullable":false,"description":"ItemWithheldTax on the sale, including US MarketplaceFacilitatorTax-*. EU/UK MarketplaceFacilitatorVAT-* is in marketplace_facilitator_vat."},{"name":"promotion_item_price","type":"NUMBER","nullable":false,"description":"Item and coupon discount on orders (Promotion/Principal). Negative. This is money given to the customer, not an Amazon fee. Refunds of it are in promotion."},{"name":"promotion_tax_discount","type":"NUMBER","nullable":false,"description":null},{"name":"promotion_shipping","type":"NUMBER","nullable":false,"description":null},{"name":"promotion_fee","type":"NUMBER","nullable":false,"description":"Deprecated name for shipping_promotion_rebate: the order shipping promotion (Promotion/Shipping, ShippingDiscount). Despite the name it is a customer rebate, not an Amazon fee. Use shipping_promotion_rebate. The Amazon promotion fee is in promotion_shipping."},{"name":"shipping_promotion_rebate","type":"NUMBER","nullable":false,"description":"Order shipping promotion (Promotion/Shipping, ShippingDiscount) given to the customer, for example free shipping. Negative. Not an Amazon fee. Same values as promotion_fee. Refunds of it are in refund_shipping_promotion."},{"name":"order_other","type":"NUMBER","nullable":false,"description":null},{"name":"order_retrocharge","type":"NUMBER","nullable":false,"description":null},{"name":"cost_of_advertising","type":"NUMBER","nullable":false,"description":null},{"name":"refund_retrocharge","type":"NUMBER","nullable":false,"description":null},{"name":"refund_item_withheld_tax","type":"NUMBER","nullable":false,"description":"ItemWithheldTax on a refund, including US MarketplaceFacilitatorTax-*. EU/UK MarketplaceFacilitatorVAT-* refunds are in refund_marketplace_facilitator_vat."},{"name":"refund_marketplace_facilitator_vat","type":"NUMBER","nullable":false,"description":"EU/UK MarketplaceFacilitatorVAT-* ItemWithheldTax refunded by Amazon. US MarketplaceFacilitatorTax-* stays in refund_item_withheld_tax."},{"name":"refund_shipping","type":"NUMBER","nullable":false,"description":null},{"name":"refund_shipping_promotion","type":"NUMBER","nullable":false,"description":"Refund of the order shipping promotion (shipping_promotion_rebate). Positive when the discount is given back on a refund."},{"name":"refund_tax","type":"NUMBER","nullable":false,"description":null},{"name":"refund_shipping_tax","type":"NUMBER","nullable":false,"description":null},{"name":"refund_promotion_tax_discount","type":"NUMBER","nullable":false,"description":null},{"name":"refund_remote_fulfillment_credit","type":"NUMBER","nullable":false,"description":null},{"name":"refund_restocking_fee","type":"NUMBER","nullable":false,"description":null},{"name":"refund_item_gift_wrap_fee","type":"NUMBER","nullable":false,"description":null},{"name":"refund_digital_services_fee","type":"NUMBER","nullable":false,"description":"Digital Services Fee reversed on a refund (Refund + Digital Services Fee / DigitalServicesFee + ItemFees)."},{"name":"refund_other","type":"NUMBER","nullable":false,"description":null},{"name":"refunded_amount","type":"NUMBER","nullable":false,"description":null},{"name":"refunded_referral_fee","type":"NUMBER","nullable":false,"description":null},{"name":"refund_commission","type":"NUMBER","nullable":false,"description":null},{"name":"points_returned","type":"NUMBER","nullable":false,"description":"Japan marketplace Amazon Points returned on a refund. Other marketplaces are 0."},{"name":"points_fee","type":"NUMBER","nullable":false,"description":"Japan marketplace Amazon Points fee on a refund. Other marketplaces are 0."},{"name":"shipping_label_purchase","type":"NUMBER","nullable":false,"description":"Merchant-fulfilled Buy Shipping / Amazon label purchase. From Finances Adjustment LabmanLabelPurchase (ShippingServiceCharges / PostageBilling_Postage) and settlement-report “Shipping label purchase”. Expenses are negative. Not delivery_label_amazon_shipping_charges."},{"name":"shipping_label_purchase_for_return","type":"NUMBER","nullable":false,"description":"Return-label postage purchased through Amazon. From Finances Adjustment LabmanLabelReturn (Other / ReturnPostageBilling_Postage) and settlement-report “Shipping label purchase for return”. Expenses are negative."},{"name":"removal_complete","type":"NUMBER","nullable":false,"description":null},{"name":"fba_inventory_reimbursement_re_evaluation","type":"NUMBER","nullable":false,"description":null},{"name":"fba_inbound_placement_service_fee","type":"NUMBER","nullable":false,"description":"FBA inbound placement service fee. Includes Finances ServiceFee rows on InboundConvenienceCharge > FBAInboundConvenienceFee, and settlement transaction type FBA Inbound Placement Service Fee. Expenses are negative."},{"name":"fba_customer_return_per_unit_fee","type":"NUMBER","nullable":false,"description":"Returns processing / FBA customer return per-unit fee."},{"name":"fba_inbound_transportation_fee","type":"NUMBER","nullable":false,"description":"FBA inbound transportation / Amazon-Partnered Carrier (APC) shipment fee, ex-VAT base. From Finances FBAFees or settlement-report Base fee. When Finances other-transaction inbound is VAT-inclusive (UK/EU), stored as gross/1.20."},{"name":"fba_inbound_transportation_program_fee","type":"NUMBER","nullable":false,"description":"FBA Inbound Transportation Program Fee ex-VAT base (and tax-on-fee variants routed to item_tax). When Finances other-transaction inbound is VAT-inclusive (UK/EU), stored as gross/1.20."},{"name":"awd_processing_fee","type":"NUMBER","nullable":false,"description":null},{"name":"awd_storage_fee","type":"NUMBER","nullable":false,"description":null},{"name":"awd_transportation_fee","type":"NUMBER","nullable":false,"description":null},{"name":"awd_processing_fee_discount","type":"NUMBER","nullable":false,"description":null},{"name":"awd_storage_fee_discount","type":"NUMBER","nullable":false,"description":null},{"name":"awd_transportation_fee_discount","type":"NUMBER","nullable":false,"description":null},{"name":"fba_other","type":"NUMBER","nullable":false,"description":null},{"name":"sales_tax_service_fee","type":"NUMBER","nullable":false,"description":"India Sales Tax Service Fee from settlement report ItemFees."},{"name":"shipping_hb","type":"NUMBER","nullable":false,"description":"India ShippingHB (handling/shipping) amount from the settlement report."},{"name":"product_tax","type":"NUMBER","nullable":false,"description":"Product tax collected on the sale (India and similar marketplaces)."},{"name":"product_tax_discount","type":"NUMBER","nullable":false,"description":"Product tax discount / promotion against product_tax."},{"name":"fixed_closing_fee","type":"NUMBER","nullable":false,"description":"Fixed closing fee charged on the order (common on Amazon.in)."},{"name":"fixed_closing_fee_cgst","type":"NUMBER","nullable":false,"description":"CGST on the fixed closing fee (India GST split)."},{"name":"fixed_closing_fee_sgst","type":"NUMBER","nullable":false,"description":"SGST on the fixed closing fee (India GST split)."},{"name":"fixed_closing_fee_igst","type":"NUMBER","nullable":false,"description":"IGST on the fixed closing fee (India GST split)."},{"name":"variable_closing_fee","type":"NUMBER","nullable":false,"description":"Variable closing fee on the order (Finances Variable closing fee)."},{"name":"tds_section_194o","type":"NUMBER","nullable":false,"description":"India TDS under Income Tax Act section 194-O withheld by Amazon on e-commerce payments."},{"name":"tcs_igst","type":"NUMBER","nullable":false,"description":"India TCS IGST collected by Amazon as e-commerce operator."},{"name":"tcs_cgst","type":"NUMBER","nullable":false,"description":"India TCS CGST collected by Amazon as e-commerce operator."},{"name":"tcs_sgst","type":"NUMBER","nullable":false,"description":"India TCS SGST collected by Amazon as e-commerce operator."},{"name":"technology_fee","type":"NUMBER","nullable":false,"description":"Amazon technology / closing technology fee on the order (India)."},{"name":"technology_fee_igst","type":"NUMBER","nullable":false,"description":"IGST on the Amazon technology fee (India)."},{"name":"shipping_tax","type":"NUMBER","nullable":false,"description":"Tax on shipping charged to the buyer on the settlement line."},{"name":"shipping_discount","type":"NUMBER","nullable":false,"description":"Shipping discount on the settlement line."},{"name":"shipping_tax_discount","type":"NUMBER","nullable":false,"description":"Tax discount related to a shipping promotion."},{"name":"commission_igst","type":"NUMBER","nullable":false,"description":"IGST on Amazon referral/commission (India)."},{"name":"promo_rebates","type":"NUMBER","nullable":false,"description":"Promo rebates credited on the settlement."},{"name":"regulatory_fee","type":"NUMBER","nullable":false,"description":"Regulatory fee charged by Amazon (marketplace-specific)."},{"name":"prime_fulfillment_fee","type":"NUMBER","nullable":false,"description":"Prime fulfillment fee on seller-fulfilled Prime orders."},{"name":"prime_service_fee","type":"NUMBER","nullable":false,"description":"Amazon Prime service fee charged to the seller."},{"name":"flexible_customer_financing_fee","type":"NUMBER","nullable":false,"description":"Fee for Amazon flexible customer financing / installment programs."},{"name":"get_paid_faster_fee","type":"NUMBER","nullable":false,"description":"Fee for Amazon Get Paid Faster / early disbursement."},{"name":"low_value_goods_tax_principal","type":"NUMBER","nullable":false,"description":"Low-value goods (import) tax on the item principal, typically EU IOSS / similar schemes."},{"name":"low_value_goods_tax_shipping","type":"NUMBER","nullable":false,"description":"Low-value goods tax allocated to shipping."},{"name":"fba_weight_handling_fee","type":"NUMBER","nullable":false,"description":"FBA weight handling fee (India FBA fulfillment component)."},{"name":"fba_weight_handling_fee_cgst","type":"NUMBER","nullable":false,"description":"CGST on FBA weight handling fee."},{"name":"fba_weight_handling_fee_sgst","type":"NUMBER","nullable":false,"description":"SGST on FBA weight handling fee."},{"name":"fba_pick_and_pack_fee","type":"NUMBER","nullable":false,"description":"FBA pick and pack fee (India FBA fulfillment component)."},{"name":"fba_pick_and_pack_fee_cgst","type":"NUMBER","nullable":false,"description":"CGST on FBA pick and pack fee."},{"name":"fba_pick_and_pack_fee_sgst","type":"NUMBER","nullable":false,"description":"SGST on FBA pick and pack fee."},{"name":"fba_inbound_pickup_service_fee","type":"NUMBER","nullable":false,"description":"FBA inbound pickup service fee for Amazon-collected inbound freight."},{"name":"fba_prep_fee_labeling","type":"NUMBER","nullable":false,"description":"FBA prep fee for labeling services at the fulfillment center."},{"name":"fba_prep_fee_polybagging","type":"NUMBER","nullable":false,"description":"FBA prep fee for polybagging services at the fulfillment center."},{"name":"fba_grade_and_resell_fee","type":"NUMBER","nullable":false,"description":"FBA Grade and Resell program fee on returned inventory."},{"name":"fba_customer_return_fee","type":"NUMBER","nullable":false,"description":"FBA customer return processing fee (ASIN-specific or non per-unit return fee lines). Distinct from fba_customer_return_per_unit_fee."},{"name":"fba_international_freight_shipping_charge","type":"NUMBER","nullable":false,"description":"FBA international freight shipping charge on inbound inventory."},{"name":"fba_international_freight_duties_and_taxes_charge","type":"NUMBER","nullable":false,"description":"Duties and taxes on FBA international inbound freight."},{"name":"fba_inbound_defect_fee","type":"NUMBER","nullable":false,"description":"Fee for inbound shipment defects / noncompliance."},{"name":"fba_warehouse_prep_fee","type":"NUMBER","nullable":false,"description":"FBA warehouse prep fee not covered by labeling/polybagging columns."},{"name":"fba_removal_complete_cgst","type":"NUMBER","nullable":false,"description":"CGST on FBA removal order completion fees."},{"name":"fba_removal_complete_sgst","type":"NUMBER","nullable":false,"description":"SGST on FBA removal order completion fees."},{"name":"fba_storage_billing_cgst","type":"NUMBER","nullable":false,"description":"CGST on FBA storage billing."},{"name":"fba_storage_billing_sgst","type":"NUMBER","nullable":false,"description":"SGST on FBA storage billing."},{"name":"fba_fulfillment_fee_refund_weight_handling","type":"NUMBER","nullable":false,"description":"Refund of FBA weight handling fulfillment fee."},{"name":"fba_fulfillment_fee_refund_weight_handling_cgst","type":"NUMBER","nullable":false,"description":"CGST refund on FBA weight handling fulfillment fee."},{"name":"fba_fulfillment_fee_refund_weight_handling_sgst","type":"NUMBER","nullable":false,"description":"SGST refund on FBA weight handling fulfillment fee."},{"name":"fba_fulfillment_fee_refund_pick_pack","type":"NUMBER","nullable":false,"description":"Refund of FBA pick and pack fulfillment fee."},{"name":"fba_fulfillment_fee_refund_pick_pack_cgst","type":"NUMBER","nullable":false,"description":"CGST refund on FBA pick and pack fulfillment fee."},{"name":"fba_fulfillment_fee_refund_pick_pack_sgst","type":"NUMBER","nullable":false,"description":"SGST refund on FBA pick and pack fulfillment fee."},{"name":"fba_fulfillment_fee_refund_technology_fee","type":"NUMBER","nullable":false,"description":"Refund of FBA technology fee component of fulfillment fees."},{"name":"fba_fulfillment_fee_refund_technology_fee_igst","type":"NUMBER","nullable":false,"description":"IGST refund on FBA technology fee."},{"name":"fba_inbound_carrier_damage_reimbursement","type":"NUMBER","nullable":false,"description":"Reimbursement when Amazon inbound carrier damages inventory."},{"name":"fba_cs_error_items_reimbursement","type":"NUMBER","nullable":false,"description":"Reimbursement for customer-service error items."},{"name":"fba_removal_order_damaged_reimbursement","type":"NUMBER","nullable":false,"description":"Reimbursement when a removal order unit is damaged."},{"name":"fba_prep_fee_refund","type":"NUMBER","nullable":false,"description":"Refund of previously charged FBA prep fees."},{"name":"awd_mcd_transportation_fee","type":"NUMBER","nullable":false,"description":"Amazon Warehousing and Distribution multi-channel distribution transportation fee."},{"name":"refund_shipping_chargeback","type":"NUMBER","nullable":false,"description":"ShippingChargeback reversed on a refund."},{"name":"refund_product_tax","type":"NUMBER","nullable":false,"description":"Product tax refunded to the buyer."},{"name":"refund_tcs_igst","type":"NUMBER","nullable":false,"description":"India TCS IGST reversed on a refund."},{"name":"refund_fixed_closing_fee","type":"NUMBER","nullable":false,"description":"Fixed closing fee reversed on a refund."},{"name":"refund_commission_igst","type":"NUMBER","nullable":false,"description":"IGST on referral/commission reversed on a refund."},{"name":"vine_enrollment_fee","type":"NUMBER","nullable":false,"description":"Amazon Vine enrollment fee."},{"name":"vine_enrollment_fee_tax","type":"NUMBER","nullable":false,"description":"Tax on Amazon Vine enrollment fee."},{"name":"deal_participation_fee_tax","type":"NUMBER","nullable":false,"description":"Tax on Deal participation fee."},{"name":"deal_performance_fee_tax","type":"NUMBER","nullable":false,"description":"Tax on Deal performance-based fee."},{"name":"coupon_participation_fee_tax","type":"NUMBER","nullable":false,"description":"Tax on Coupon participation fee."},{"name":"coupon_performance_fee_tax","type":"NUMBER","nullable":false,"description":"Tax on Coupon performance-based fee."},{"name":"amazon_easy_ship_charges","type":"NUMBER","nullable":false,"description":"Amazon Easy Ship postage and related charges for merchant-fulfilled orders."},{"name":"amazon_easy_ship_weight_handling_reversal","type":"NUMBER","nullable":false,"description":"Reversal of Easy Ship weight handling charges."},{"name":"amazon_easy_ship_weight_handling_reversal_igst","type":"NUMBER","nullable":false,"description":"IGST on Easy Ship weight handling reversal."},{"name":"advertising_refund","type":"NUMBER","nullable":false,"description":"Advertising credit or refund posted in Finances (not campaign-dated ad spend)."},{"name":"delivery_label_amazon_shipping_charges","type":"NUMBER","nullable":false,"description":"Delivery label purchased through Amazon (settlement-report Amazon Shipping Charges). Not Buy Shipping LabmanLabelPurchase, which is shipping_label_purchase."},{"name":"shipping_charge_adjustment","type":"NUMBER","nullable":false,"description":"Adjustment to previously posted shipping charges, including Buy Shipping LabmanLabelChargeBack net (not a second copy of shipping_label_purchase)."},{"name":"settlement_adjustment","type":"NUMBER","nullable":false,"description":"Miscellaneous settlement adjustment posted by Amazon."},{"name":"mfn_postage_purchase_igst","type":"NUMBER","nullable":false,"description":"IGST on merchant-fulfilled postage purchased through Amazon."},{"name":"payable_to_amazon","type":"NUMBER","nullable":false,"description":"Amount payable to Amazon (debt / invoice) on the settlement."},{"name":"safe_t_reimbursement","type":"NUMBER","nullable":false,"description":"Amazon A-to-z / SAFE-T claim reimbursement to the seller."},{"name":"buyer_recharge","type":"NUMBER","nullable":false,"description":"Buyer recharge collected after a prior refund or adjustment."},{"name":"paid_services_fee","type":"NUMBER","nullable":false,"description":"Amazon paid services fee (account-level services)."},{"name":"digital_services_fee_adjustment","type":"NUMBER","nullable":false,"description":"Adjustment to a previously posted Digital Services Fee (not the sale/refund line)."},{"name":"incentive_disbursement","type":"NUMBER","nullable":false,"description":"Incentive or rebate disbursement credited by Amazon."},{"name":"promotion_fee_special","type":"NUMBER","nullable":false,"description":"Special promotion fee not mapped to promotion_fee / coupon / deal columns."},{"name":"transfer_micro_deposit","type":"NUMBER","nullable":false,"description":"Bank-account verification micro-deposit related to disbursement setup."},{"name":"cross_account_debt_adjustment","type":"NUMBER","nullable":false,"description":"Cross-account debt transfer or adjustment between Amazon seller accounts."},{"name":"chargeback_refund_principal","type":"NUMBER","nullable":false,"description":"Payment chargeback refund of item principal."},{"name":"chargeback_refund_commission","type":"NUMBER","nullable":false,"description":"Payment chargeback refund of referral/commission."},{"name":"chargeback_refund_tax","type":"NUMBER","nullable":false,"description":"Payment chargeback refund of tax."},{"name":"chargeback_refund_commission_fee","type":"NUMBER","nullable":false,"description":"Payment chargeback refund of commission-related fee."},{"name":"chargeback_refund_withheld_tax","type":"NUMBER","nullable":false,"description":"Payment chargeback refund of withheld tax."},{"name":"chargeback_refund_shipping","type":"NUMBER","nullable":false,"description":"Payment chargeback refund of shipping."},{"name":"chargeback_refund_shipping_tax","type":"NUMBER","nullable":false,"description":"Payment chargeback refund of shipping tax."},{"name":"promotion","type":"NUMBER","nullable":false,"description":"Refund of the item and coupon discount (Refund Promotion/Principal). Positive on refunds. The original discount is in promotion_item_price."},{"name":"goodwill","type":"NUMBER","nullable":false,"description":null},{"name":"other","type":"NUMBER","nullable":false,"description":null},{"name":"cogs_item_value","type":"NUMBER","nullable":false,"description":"Item COGS for this settlement row, stored negative. ORDER: order quantity × unit cost as of order date. REFUND: returned quantity × unit cost as of return receipt date (0 if no matching return).","definition":"0 - ((amazon_cogs.cost_item_value ?? 0) * (amazon_settlements_with_cogs.quantity ?? 0))"},{"name":"cogs_shipping_value","type":"NUMBER","nullable":false,"description":"Shipping COGS for this settlement row, stored negative, using the same quantity and lookup date as cogs_item_value.","definition":"0 - ((amazon_cogs.cost_item_shipping_value ?? 0) * (amazon_settlements_with_cogs.quantity ?? 0))"},{"name":"cogs_total_value","type":"NUMBER","nullable":false,"description":"Sum of cogs_item_value and cogs_shipping_value (negative).","definition":"0 - (((amazon_cogs.cost_item_value ?? 0) + (amazon_cogs.cost_item_shipping_value ?? 0)) * (amazon_settlements_with_cogs.quantity ?? 0))"},{"name":"cogs_present","type":"LOGIC","nullable":false,"description":"True when an uploaded COGS record applies to this row. Zero cost can still be valid."},{"name":"cogs_currency","type":"TEXT","nullable":false,"description":"Currency code for COGS."},{"name":"item_supplier_name","type":"TEXT","nullable":true,"description":"Supplier name for the item COGS, if provided in COGS upload."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Financial events from Amazon Finances. date is the marketplace-local date of the winning transaction posted time (America/Los_Angeles for US and CA). Once released it matches Transaction Release Date; while still deferred it is the local date of the deferred posting, and it can be one day earlier than the UTC posted timestamp near midnight. transaction_posted_date matches the Amazon Transaction report date/time column and is earlier than date for deferred orders. transaction_release_date matches Transaction Release Date and equals date once released. shipping_promotion_rebate is the order shipping promotion, a rebate to the customer and not an Amazon fee; promotion_fee holds the same values and is kept for backward compatibility. settlement_type REFUND is a money event, not a warehouse return. ORDER rows use order-date COGS; REFUND rows use return-receipt-date COGS (0 when no return). COGS is stored negative. All columns other than \"total\" express a single type of cost/fee/income. Expenses are negative values (standardize this when comparing with other tables). total_non_principal_amount is total minus item_price in the payout sign. total_fees holds the same value and will be removed on 2026-10-31. marketplace_facilitator_vat / refund_marketplace_facilitator_vat are MarketplaceFacilitatorVAT-* ItemWithheldTax lines (EU/UK); US MarketplaceFacilitatorTax-* stays in item_withheld_tax / refund_item_withheld_tax. fba_inbound_transportation_fee and fba_inbound_transportation_program_fee are ex-VAT base amounts; when Finances lands VAT-inclusive gross on other-transaction inbound rows (UK/EU), the integrated view splits gross/1.20 into the fee column and the remainder into item_tax. Settlement-report FBAFees Base/Tax triples are already ex-VAT on the fee column. There is no dedicated Lightning Deal Fee column because Finances does not distinguish Lightning from Best Deal; those amounts are in deal_participation_fee. Refund Customer Return - Not Received is not available from Finances. Merchant-fulfilled Buy Shipping label fees (LabmanLabelPurchase / LabmanLabelReturn / LabmanLabelChargeBack) attach to the order SKU when that order has a single SKU.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":365},{"type":"RECURRING_DAILY","numberOfDays":21}],"sources":["connections","raw_amazon_cogs","raw_sp_api_report_fba_fulfillment_customer_returns","raw_sp_api_report_flat_file_returns_data_by_return_date","raw_sp_api_report_listings_data","raw_sp_api_report_orders","refined_sp_api_finances_transactions"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["fees","payout","settlement","disbursement"]},{"id":"81aa5b4cc248bb70de405b9ff9d51290b9232f84570d76ba2a1289b67b6595fb","name":"Search Query Performance (SQP) by ASIN (Weekly)","tableName":"amazon_child_product_organic_search_ranks_per_week","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"date","type":"DATE","nullable":false,"description":"First day of the week the data refers to. Represents an aggregated weekly snapshot. Data availability can lag, so use MAX(date) for the most recent week."},{"name":"search_query","type":"TEXT","nullable":false,"description":null},{"name":"search_query_volume","type":"NUMBER","nullable":false,"description":"Total search volume for this search query across all ASINs. Each row for the same date and search query will have the same value. Do not sum it for the same date."},{"name":"search_query_total_impression_count","type":"NUMBER","nullable":false,"description":"Total impression count for this search query across all ASINs. Each row for the same date and search query will have the same value. Do not sum it for the same date."},{"name":"child_asin_organic_search_rank","type":"NUMBER","nullable":false,"description":"Deprecated name for child_asin_search_query_score. Contains the same Amazon Search Query Score, not the ASIN's position in Amazon search results. Retained for existing integrations. This name should not be used for new queries; use child_asin_search_query_score instead."},{"name":"child_asin_impression_count","type":"NUMBER","nullable":false,"description":null},{"name":"child_asin_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"child_asin_median_click_price_value","type":"NUMBER","nullable":false,"description":null},{"name":"child_asin_median_click_price_currency","type":"TEXT","nullable":false,"description":null},{"name":"child_asin_add_to_cart_count","type":"NUMBER","nullable":false,"description":null},{"name":"child_asin_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_purchase_rate","type":"NUMBER","nullable":false,"description":"Purchases of any ASIN divided by search query volume. Amazon schema examples are 0–1 fractions (0.1 means 10%). A published report mismatch has returned 0–100 instead; do not multiply by 100 when values are already below 1. Query-level value repeated on every ASIN row for the same date and search_query. Do not sum it across ASINs."},{"name":"search_query_total_same_day_shipping_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_one_day_shipping_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_two_day_shipping_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_click_rate","type":"NUMBER","nullable":false,"description":"Clicks on any ASIN divided by search query volume. Amazon schema examples are 0–1 fractions (0.1 means 10%). A published report mismatch has returned 0–100 instead; do not multiply by 100 when values are already below 1. Query-level value repeated on every ASIN row for the same date and search_query. Do not sum it across ASINs."},{"name":"search_query_total_same_day_shipping_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_one_day_shipping_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_two_day_shipping_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_cart_add_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_cart_add_rate","type":"NUMBER","nullable":false,"description":"Cart adds of any ASIN divided by search query volume. Amazon schema examples are 0–1 fractions (0.1 means 10%). A published report mismatch has returned 0–100 instead; do not multiply by 100 when values are already below 1. Query-level value repeated on every ASIN row for the same date and search_query. Do not sum it across ASINs."},{"name":"search_query_total_same_day_shipping_cart_add_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_one_day_shipping_cart_add_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_two_day_shipping_cart_add_count","type":"NUMBER","nullable":false,"description":null},{"name":"child_asin_search_query_score","type":"NUMBER","nullable":false,"description":"Amazon Search Query Score (searchQueryScore) ranks this search query against other queries for the same child ASIN based on overall performance. A score of 1 is the highest-performing query for that ASIN. This is not the ASIN's position in Amazon search results."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Weekly Search Query Performance (SQP) per child ASIN and search query (GET_BRAND_ANALYTICS_SEARCH_QUERY_PERFORMANCE_REPORT). child_asin_* columns are this ASIN. search_query_total_* and search_query_volume are the whole query and repeat on every ASIN row. Rates follow Amazon schema examples of 0–1. Only configured SQP ASINs are included.","requiresDatePeriod":true,"issues":[{"title":"SQP data is available only for selected ASINs","description":"DataDoe downloads SQP data only for ASINs you configure. Open your Sellers & Vendors list in the app, select a Seller in a supported marketplace, then choose SQP ASINs to add up to 216 ASINs per connection. SQP is not available for Vendor accounts or some Amazon stores. If the list is empty, no SQP data is downloaded for that Seller."},{"title":"SQP is available only for Seller Central in supported Amazon stores","description":"Amazon Search Query Performance reports are available only for Seller Central accounts in North America (all stores), Far East (all stores), and these European stores: Spain, United Kingdom, France, Netherlands, Germany, Italy, Sweden, Turkey, Saudi Arabia, United Arab Emirates, and India. Vendor accounts and other stores cannot download SQP data."}],"prerequisites":"DataDoe downloads SQP data only for ASINs you configure. Open your Sellers & Vendors list in the app, select a Seller in a supported Amazon store, then choose SQP ASINs to add up to 216 ASINs per connection. If the list is empty, no SQP data is downloaded for that Seller.","fetchPeriods":[{"type":"INITIAL","numberOfDays":21},{"type":"RECURRING_WEEKLY","numberOfDays":7,"shiftDays":7}],"sources":["connections","raw_sp_api_report_brand_analytics_search_query_weekly"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["sqp","search query performance"]},{"id":"df4160ff8e1add239172a69ebd6c8abfec7116ee4a17720983757b1b55599830","name":"Search Query Performance (SQP) by ASIN (Monthly)","tableName":"amazon_child_product_organic_search_ranks_per_month","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":"First day of the month the data refers to. Represents an aggregated monthly snapshot. Data availability can lag, so use MAX(date) for the most recent month."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"search_query","type":"TEXT","nullable":false,"description":null},{"name":"search_query_volume","type":"NUMBER","nullable":false,"description":"Total search volume for this search query across all ASINs. Each row for the same date and search query will have the same value. Do not sum it for the same date."},{"name":"search_query_total_impression_count","type":"NUMBER","nullable":false,"description":"Total impression count for this search query across all ASINs. Each row for the same date and search query will have the same value. Do not sum it for the same date."},{"name":"child_asin_organic_search_rank","type":"NUMBER","nullable":false,"description":"Deprecated name for child_asin_search_query_score. Contains the same Amazon Search Query Score, not the ASIN's position in Amazon search results. Retained for existing integrations. This name should not be used for new queries; use child_asin_search_query_score instead."},{"name":"child_asin_impression_count","type":"NUMBER","nullable":false,"description":null},{"name":"child_asin_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"child_asin_median_click_price_value","type":"NUMBER","nullable":false,"description":null},{"name":"child_asin_median_click_price_currency","type":"TEXT","nullable":false,"description":null},{"name":"child_asin_add_to_cart_count","type":"NUMBER","nullable":false,"description":null},{"name":"child_asin_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_purchase_rate","type":"NUMBER","nullable":false,"description":"Purchases of any ASIN divided by search query volume. Amazon schema examples are 0–1 fractions (0.1 means 10%). A published report mismatch has returned 0–100 instead; do not multiply by 100 when values are already below 1. Query-level value repeated on every ASIN row for the same date and search_query. Do not sum it across ASINs."},{"name":"search_query_total_same_day_shipping_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_one_day_shipping_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_two_day_shipping_purchase_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_click_rate","type":"NUMBER","nullable":false,"description":"Clicks on any ASIN divided by search query volume. Amazon schema examples are 0–1 fractions (0.1 means 10%). A published report mismatch has returned 0–100 instead; do not multiply by 100 when values are already below 1. Query-level value repeated on every ASIN row for the same date and search_query. Do not sum it across ASINs."},{"name":"search_query_total_same_day_shipping_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_one_day_shipping_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_two_day_shipping_click_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_cart_add_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_cart_add_rate","type":"NUMBER","nullable":false,"description":"Cart adds of any ASIN divided by search query volume. Amazon schema examples are 0–1 fractions (0.1 means 10%). A published report mismatch has returned 0–100 instead; do not multiply by 100 when values are already below 1. Query-level value repeated on every ASIN row for the same date and search_query. Do not sum it across ASINs."},{"name":"search_query_total_same_day_shipping_cart_add_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_one_day_shipping_cart_add_count","type":"NUMBER","nullable":false,"description":null},{"name":"search_query_total_two_day_shipping_cart_add_count","type":"NUMBER","nullable":false,"description":null},{"name":"child_asin_search_query_score","type":"NUMBER","nullable":false,"description":"Amazon Search Query Score (searchQueryScore) ranks this search query against other queries for the same child ASIN based on overall performance. A score of 1 is the highest-performing query for that ASIN. This is not the ASIN's position in Amazon search results."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Monthly Search Query Performance (SQP) per child ASIN and search query (GET_BRAND_ANALYTICS_SEARCH_QUERY_PERFORMANCE_REPORT). child_asin_* columns are this ASIN. search_query_total_* and search_query_volume are the whole query and repeat on every ASIN row. Rates follow Amazon schema examples of 0–1. Only configured SQP ASINs are included. Not amazon_child_product_search_performance_per_month (catalog-level search engagement).","requiresDatePeriod":true,"issues":[{"title":"SQP data is available only for selected ASINs","description":"DataDoe downloads SQP data only for ASINs you configure. Open your Sellers & Vendors list in the app, select a Seller in a supported marketplace, then choose SQP ASINs to add up to 216 ASINs per connection. SQP is not available for Vendor accounts or some Amazon stores. If the list is empty, no SQP data is downloaded for that Seller."},{"title":"SQP is available only for Seller Central in supported Amazon stores","description":"Amazon Search Query Performance reports are available only for Seller Central accounts in North America (all stores), Far East (all stores), and these European stores: Spain, United Kingdom, France, Netherlands, Germany, Italy, Sweden, Turkey, Saudi Arabia, United Arab Emirates, and India. Vendor accounts and other stores cannot download SQP data."}],"prerequisites":"DataDoe downloads SQP data only for ASINs you configure. Open your Sellers & Vendors list in the app, select a Seller in a supported Amazon store, then choose SQP ASINs to add up to 216 ASINs per connection. If the list is empty, no SQP data is downloaded for that Seller.","fetchPeriods":[{"type":"INITIAL","numberOfDays":60,"shiftDays":30},{"type":"RECURRING_MONTHLY","numberOfDays":30,"shiftDays":30}],"sources":["connections","raw_sp_api_report_brand_analytics_search_query_performance"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["sqp","search query performance"]},{"id":"8723a9f82b37438b5224867ac182d2e773bea12532b9f5ad2930811a6f219f90","name":"Repeat Purchase Performance","tableName":"amazon_repeat_purchase_report","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"number_of_orders","type":"NUMBER","nullable":false,"description":"Orders that contained the child ASIN in the month. An order can include multiple units, so this is not ordered units."},{"name":"number_of_unique_customers","type":"NUMBER","nullable":false,"description":"Unique customers who placed an order containing the child ASIN in the month."},{"name":"repeat_customers_score_total","type":"NUMBER","nullable":false,"description":"Fraction of unique customers that are repeat customers in the month, between 0 and 1. A value of 1.00 is common on low-volume ASINs; filter by number_of_orders or number_of_unique_customers before ranking."},{"name":"repeat_purchase_revenue_amount","type":"NUMBER","nullable":false,"description":"Ordered revenue from repeat customers in the month. Returns are excluded."},{"name":"repeat_purchase_revenue_currency","type":"TEXT","nullable":false,"description":"ISO 4217 currency of repeat_purchase_revenue_amount."},{"name":"repeat_purchase_revenue_score_total","type":"NUMBER","nullable":false,"description":"Fraction of repeat-purchase revenue versus total revenue for the child ASIN in the month, between 0 and 1."},{"name":"date","type":"DATE","nullable":false,"description":"First day of the month the data refers to. This table stores the MONTH Brand Analytics period."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Monthly Brand Analytics repeat purchase report per child ASIN for Brand Registry sellers and vendors. One row per child ASIN and month. repeat_customers_score_total and repeat_purchase_revenue_score_total are 0-1 rates. Repeat revenue is ordered revenue and excludes returns.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":365},{"type":"RECURRING_WEEKLY","numberOfDays":90}],"sources":["connections","raw_sp_api_report_brand_analytics_repeat_purchase"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["repeat customers","customer retention","brand analytics"]},{"id":"21aa739348f0c2d2dcebd1215736d082e346ef9cdd69b6ef509464f1cd249b0b","name":"Market Basket Co-Purchase (Monthly)","tableName":"amazon_market_basket_by_child_asin","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"purchased_with_child_asin","type":"TEXT","nullable":false,"description":"ASIN purchased in the same customer order as child_asin. It may be outside your catalog."},{"name":"purchased_with_rank","type":"NUMBER","nullable":false,"description":"How often this pair is bought together. 1 is the most common ASIN purchased with child_asin."},{"name":"purchased_with_combination_score","type":"NUMBER","nullable":false,"description":"Share of multi-item orders that contain both ASINs, between 0 and 1. The denominator is customer orders with at least two different items that include child_asin. Multiply by 100 for a percentage."},{"name":"date","type":"DATE","nullable":false,"description":"First day of the month the data refers to. This table stores the MONTH Brand Analytics period."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Monthly Brand Analytics market basket report of products frequently bought together. One row per child ASIN and co-purchased ASIN. The co-purchased ASIN can belong to another brand. purchased_with_combination_score is a 0-1 share of multi-item orders.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":365},{"type":"RECURRING_WEEKLY","numberOfDays":90}],"sources":["connections","raw_sp_api_report_brand_analytics_market_basket_by_month"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["frequently bought together","co-purchase","market basket"]},{"id":"d8f74544e6a856dfb6ab916ae57310fa11a74d237c00c0b20a72bfd8d0a26ce8","name":"Brand Analytics Search Terms (Daily)","tableName":"amazon_brand_analytics_search_terms_daily","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"date","type":"DATE","nullable":false,"description":"Reporting date for the daily snapshot. Data availability can lag, so use MAX(date) for the most recent day."},{"name":"start_date","type":"DATE","nullable":true,"description":"Brand Analytics report period start. May be null. Use date for filtering."},{"name":"end_date","type":"DATE","nullable":true,"description":"Brand Analytics report period end. May be null. Use date for filtering."},{"name":"department_name","type":"TEXT","nullable":false,"description":"Amazon search department the term was searched in, such as Amazon.com or Beauty. Rank and share metrics are scoped to this department."},{"name":"search_term","type":"TEXT","nullable":false,"description":"Customer search keyword."},{"name":"search_frequency_rank","type":"NUMBER","nullable":true,"description":"Rank of the search term by search frequency inside department_name. 1 is the most searched term in that department."},{"name":"clicked_asin","type":"TEXT","nullable":false,"description":"ASIN customers clicked after this search term. Any catalog ASIN, including products you do not sell. Amazon returns the top three clicked ASINs per term and department."},{"name":"click_share_rank","type":"NUMBER","nullable":true,"description":"Rank of clicked_asin by click share for this search term and department. 1 has the highest click share."},{"name":"click_share","type":"NUMBER","nullable":true,"description":"Fraction of clicks this ASIN received versus all clicks for the search term in the department, between 0 and 1. Multiply by 100 for a percentage."},{"name":"conversion_share","type":"NUMBER","nullable":true,"description":"Fraction of conversions this ASIN received versus all conversions from the search term in the department, between 0 and 1. Multiply by 100 for a percentage."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":false,"description":"Daily marketplace Brand Analytics search terms: top clicked ASINs by customer keyword and department, with search frequency rank, click share, and conversion share. Shares are 0-1 fractions. Marketplace-wide, so clicked ASINs are often competitors. For your own ASIN search query performance use amazon_child_product_organic_search_ranks_per_week or amazon_child_product_organic_search_ranks_per_month. Data can lag; use MAX(date).","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":14},{"type":"RECURRING_DAILY","numberOfDays":1}],"sources":["connections","raw_sp_api_report_brand_analytics_search_terms_daily"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["top search terms","search frequency rank","click share","brand analytics"]},{"id":"e49e59add0303062bc38d972142c4d156b59e8deb3ce05526e8cce827095e1ba","name":"Brand Analytics Search Terms (Weekly)","tableName":"amazon_brand_analytics_search_terms_weekly","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"date","type":"DATE","nullable":false,"description":"First day of the week the data refers to. Represents an aggregated weekly snapshot. Data availability can lag, so use MAX(date) for the most recent week."},{"name":"start_date","type":"DATE","nullable":true,"description":"Brand Analytics report period start. May be null. Use date for filtering."},{"name":"end_date","type":"DATE","nullable":true,"description":"Brand Analytics report period end. May be null. Use date for filtering."},{"name":"department_name","type":"TEXT","nullable":false,"description":"Amazon search department the term was searched in, such as Amazon.com or Beauty. Rank and share metrics are scoped to this department."},{"name":"search_term","type":"TEXT","nullable":false,"description":"Customer search keyword."},{"name":"search_frequency_rank","type":"NUMBER","nullable":true,"description":"Rank of the search term by search frequency inside department_name. 1 is the most searched term in that department."},{"name":"clicked_asin","type":"TEXT","nullable":false,"description":"ASIN customers clicked after this search term. Any catalog ASIN, including products you do not sell. Amazon returns the top three clicked ASINs per term and department."},{"name":"click_share_rank","type":"NUMBER","nullable":true,"description":"Rank of clicked_asin by click share for this search term and department. 1 has the highest click share."},{"name":"click_share","type":"NUMBER","nullable":true,"description":"Fraction of clicks this ASIN received versus all clicks for the search term in the department, between 0 and 1. Multiply by 100 for a percentage."},{"name":"conversion_share","type":"NUMBER","nullable":true,"description":"Fraction of conversions this ASIN received versus all conversions from the search term in the department, between 0 and 1. Multiply by 100 for a percentage."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":false,"description":"Weekly marketplace Brand Analytics search terms: top clicked ASINs by customer keyword and department, with search frequency rank, click share, and conversion share. Shares are 0-1 fractions. Marketplace-wide, so clicked ASINs are often competitors. For your own ASIN search query performance use amazon_child_product_organic_search_ranks_per_week or amazon_child_product_organic_search_ranks_per_month. Data can lag; use MAX(date).","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_WEEKLY","numberOfDays":7,"shiftDays":7}],"sources":["connections","raw_sp_api_report_brand_analytics_search_terms_weekly"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["top search terms","search frequency rank","click share","brand analytics"]},{"id":"ac6a07d258e44bd72f5ce8edc55d715650607617a4ed42b1459a416e6fb5e412","name":"Brand Analytics Search Terms (Monthly)","tableName":"amazon_brand_analytics_search_terms_monthly","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"date","type":"DATE","nullable":false,"description":"First day of the month the data refers to. Represents an aggregated monthly snapshot. Data availability can lag, so use MAX(date) for the most recent month."},{"name":"start_date","type":"DATE","nullable":true,"description":"Brand Analytics report period start. May be null. Use date for filtering."},{"name":"end_date","type":"DATE","nullable":true,"description":"Brand Analytics report period end. May be null. Use date for filtering."},{"name":"department_name","type":"TEXT","nullable":false,"description":"Amazon search department the term was searched in, such as Amazon.com or Beauty. Rank and share metrics are scoped to this department."},{"name":"search_term","type":"TEXT","nullable":false,"description":"Customer search keyword."},{"name":"search_frequency_rank","type":"NUMBER","nullable":true,"description":"Rank of the search term by search frequency inside department_name. 1 is the most searched term in that department."},{"name":"clicked_asin","type":"TEXT","nullable":false,"description":"ASIN customers clicked after this search term. Any catalog ASIN, including products you do not sell. Amazon returns the top three clicked ASINs per term and department."},{"name":"click_share_rank","type":"NUMBER","nullable":true,"description":"Rank of clicked_asin by click share for this search term and department. 1 has the highest click share."},{"name":"click_share","type":"NUMBER","nullable":true,"description":"Fraction of clicks this ASIN received versus all clicks for the search term in the department, between 0 and 1. Multiply by 100 for a percentage."},{"name":"conversion_share","type":"NUMBER","nullable":true,"description":"Fraction of conversions this ASIN received versus all conversions from the search term in the department, between 0 and 1. Multiply by 100 for a percentage."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":false,"description":"Monthly marketplace Brand Analytics search terms: top clicked ASINs by customer keyword and department, with search frequency rank, click share, and conversion share. Shares are 0-1 fractions. Marketplace-wide, so clicked ASINs are often competitors. For your own ASIN search query performance use amazon_child_product_organic_search_ranks_per_week or amazon_child_product_organic_search_ranks_per_month. Data can lag; use MAX(date).","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":365},{"type":"RECURRING_MONTHLY","numberOfDays":30,"shiftDays":30}],"sources":["connections","raw_sp_api_report_brand_analytics_search_terms_monthly"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["top search terms","search frequency rank","click share","brand analytics"]},{"id":"68d2de238e8d1a47bc56a981a99d54558507b0bafb1e09f1b3e95fb7750a17a8","name":"Product Catalog by ASIN","tableName":"amazon_products_by_child_asin","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"parent_asin","type":"TEXT","nullable":true,"description":"First parent ASIN from Catalog Items relationships. Empty for parent and standalone ASINs."},{"name":"amazon_product_type","type":"TEXT","nullable":false,"description":"Variation role derived from the Catalog Items browse classification tree: PARENT, CHILD, or SINGLE. The Amazon product type template, such as LUGGAGE, is product_type on amazon_products_raw."},{"name":"product_name","type":"TEXT","nullable":true,"description":null},{"name":"product_root_category_name","type":"TEXT","nullable":true,"description":"Display name of the top browse classification, walking parent nodes to the root."},{"name":"product_node_category_name","type":"TEXT","nullable":true,"description":"Display name of the ASIN browse node (the first catalog classification)."},{"name":"product_root_best_selling_rank","type":"NUMBER","nullable":true,"description":"Best Seller Rank in the website display group (Catalog salesRanks displayGroupRanks). 1 is the top seller in that group. This rank is separate from the browse-node rank."},{"name":"product_node_best_selling_rank","type":"NUMBER","nullable":true,"description":"Best Seller Rank in the browse node that matches product_node_category_name. 1 is the top seller in that node."},{"name":"product_brand","type":"TEXT","nullable":true,"description":null},{"name":"product_color","type":"TEXT","nullable":true,"description":null},{"name":"product_model_number","type":"TEXT","nullable":true,"description":null},{"name":"product_release_date","type":"DATE","nullable":true,"description":"Catalog release date from the item summary."},{"name":"product_size","type":"TEXT","nullable":true,"description":null},{"name":"product_style","type":"TEXT","nullable":true,"description":null},{"name":"product_bullet_point_1","type":"TEXT","nullable":true,"description":"First listing bullet from Catalog attributes.bullet_point. Only the first five bullets are stored."},{"name":"product_bullet_point_2","type":"TEXT","nullable":true,"description":null},{"name":"product_bullet_point_3","type":"TEXT","nullable":true,"description":null},{"name":"product_bullet_point_4","type":"TEXT","nullable":true,"description":null},{"name":"product_bullet_point_5","type":"TEXT","nullable":true,"description":null},{"name":"product_description","type":"TEXT","nullable":true,"description":"Catalog product_description attribute. A+ content and other enhanced content are not included."},{"name":"product_image_url","type":"TEXT","nullable":true,"description":"MAIN catalog image closest to 500 by 500 pixels."},{"name":"product_url","type":"TEXT","nullable":true,"description":"Marketplace product detail page URL for the child ASIN."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Catalog Items snapshot per child ASIN and marketplace: title, brand, bullets, description, browse node, and best seller rank. amazon_product_type is PARENT, CHILD, or SINGLE. For the catalog product type template and raw JSON attributes, classifications, images, and sales ranks, use amazon_products_raw.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["refined_products_by_child_asin"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["catalog","bsr","best seller rank","browse node"]},{"id":"0e1ea34395ebb2b2658f4636d7fbdb9381d985eabeaea87aafa49335a92ff551","name":"Product Catalog by ASIN (Raw JSON)","tableName":"amazon_products_raw","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"parent_asin","type":"TEXT","nullable":true,"description":"First parent ASIN from Catalog Items relationships. Empty for parent and standalone ASINs."},{"name":"amazon_product_type","type":"TEXT","nullable":false,"description":"Variation role derived from the Catalog Items browse classification tree: PARENT, CHILD, or SINGLE. The Amazon product type template, such as LUGGAGE, is product_type on amazon_products_raw."},{"name":"attributes","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"classifications","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"dimensions","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"identifiers","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"images","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"product_type","type":"TEXT","nullable":true,"description":"Amazon catalog product type template for this marketplace, such as LUGGAGE. Distinct from amazon_product_type, which is PARENT, CHILD, or SINGLE."},{"name":"sales_ranks","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"summaries","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"relationships","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Raw Catalog Items payload per child ASIN and marketplace: attributes, classifications, dimensions, identifiers, images, sales ranks, summaries, and relationships. amazon_product_type is PARENT, CHILD, or SINGLE; product_type is the Amazon product type template. Prefer amazon_products_by_child_asin for titles, bullets, and best seller rank. Rows are large; download them to a file instead of loading them into context.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["refined_products_by_child_asin"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["catalog attributes","product type"]},{"id":"7076aeafd23f0805afb91c4ecef994d7a0d2e796e06852391bc28de680e71aaa","name":"Coupon Performance","tableName":"amazon_coupon_performance","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"campaign_id","type":"TEXT","nullable":false,"description":"Vendor coupon campaign id. Empty string on seller coupons, which have no campaign."},{"name":"campaign_name","type":"TEXT","nullable":true,"description":"Vendor coupon campaign name. Empty on seller coupons."},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Amazon vendor code on the coupon campaign. Empty on seller coupons."},{"name":"is_subscribe_and_save","type":"LOGIC","nullable":true,"description":"Whether the vendor campaign is a Subscribe and Save offer. Empty on seller coupons."},{"name":"budget_type","type":"TEXT","nullable":true,"description":"Vendor campaign budget allocation: PER_INDIVIDUAL_COUPON or SHARED_BUDGET. Empty on seller coupons."},{"name":"campaign_total_clips","type":"NUMBER","nullable":true,"description":"Sum of clips across coupons in the vendor campaign. Campaign-level value repeated on every coupon and ASIN row. Aggregate by campaign_id before summing."},{"name":"campaign_total_redemptions","type":"NUMBER","nullable":true,"description":"Sum of redemptions across coupons in the vendor campaign. Campaign-level value repeated on every coupon and ASIN row. Aggregate by campaign_id before summing."},{"name":"currency_code","type":"TEXT","nullable":true,"description":"ISO 4217 currency of the coupon amounts."},{"name":"coupon_id","type":"TEXT","nullable":false,"description":null},{"name":"coupon_name","type":"TEXT","nullable":true,"description":null},{"name":"website_message","type":"TEXT","nullable":true,"description":"Message displayed with the coupon on the product page."},{"name":"start_date_time","type":"DATE","nullable":true,"description":"Coupon start in UTC. Use this column for date filtering; the table has no date column."},{"name":"end_date_time","type":"DATE","nullable":true,"description":"Coupon end in UTC."},{"name":"is_once_per_customer","type":"LOGIC","nullable":true,"description":"Whether a vendor coupon can be redeemed once per customer account. Empty on seller coupons."},{"name":"customer_segment","type":"TEXT","nullable":true,"description":"Customers who can clip the coupon. Examples: All (Default), Amazon Prime, Amazon Student."},{"name":"clips","type":"NUMBER","nullable":true,"description":"Times customers applied the coupon on the product page. Coupon-level value repeated on every ASIN row of the coupon. Aggregate by coupon_id before summing."},{"name":"redemptions","type":"NUMBER","nullable":true,"description":"Times the coupon was used for a purchase, including returned and cancelled orders. Coupon-level value repeated on every ASIN row of the coupon. Aggregate by coupon_id before summing."},{"name":"budget","type":"NUMBER","nullable":true,"description":"Budget allocated to the coupon for discounts and clip or redemption fees. Present for seller coupons and for vendor campaigns with PER_INDIVIDUAL_COUPON. Empty when the vendor campaign uses SHARED_BUDGET."},{"name":"total_discount","type":"NUMBER","nullable":true,"description":"Amount customers saved with the coupon, including returned and cancelled orders. Coupon-level value repeated on every ASIN row of the coupon. Aggregate by coupon_id before summing."},{"name":"budget_spent","type":"NUMBER","nullable":true,"description":"Amount spent on the coupon, including clip fees and redemption fees, and including returned and cancelled orders. Coupon-level value repeated on every ASIN row of the coupon. Aggregate by coupon_id before summing."},{"name":"budget_remaining","type":"NUMBER","nullable":true,"description":"budget minus budget_spent. Empty when the vendor campaign uses SHARED_BUDGET."},{"name":"budget_percentage_used","type":"NUMBER","nullable":true,"description":"Percent of allocated budget spent, on a 0-100 scale. A value of 0.4 means 0.4 percent. For a shared vendor budget this is versus the campaign budget."},{"name":"sales","type":"NUMBER","nullable":true,"description":"Seller coupon revenue after the discount, including returned and cancelled orders. Empty on vendor coupons. Coupon-level value repeated on every ASIN row of the coupon. Aggregate by coupon_id before summing."},{"name":"merchant_id","type":"TEXT","nullable":true,"description":"Seller merchant customer id. Empty on vendor coupons."},{"name":"promotions_api_mapping_id","type":"TEXT","nullable":true,"description":"Identifier for joining this coupon to amazon_promotions."},{"name":"asin","type":"TEXT","nullable":false,"description":"Child ASIN included in the coupon. One row per ASIN."},{"name":"discount_type","type":"TEXT","nullable":true,"description":"PERCENT_OFF_LIST_PRICE or AMOUNT_OFF_LIST_PRICE for this ASIN."},{"name":"discount_amount","type":"NUMBER","nullable":true,"description":"Customer discount on this ASIN. A percent of list price when discount_type is PERCENT_OFF_LIST_PRICE (10 means 10 percent). A currency amount when discount_type is AMOUNT_OFF_LIST_PRICE."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Seller and vendor coupon performance, one row per coupon and ASIN. Includes clips, redemptions, budget, and the ASIN discount. Campaign and coupon totals repeat on every ASIN row. Vendor rows carry campaign, vendor code, and Subscribe and Save; sales is seller coupon revenue. Filter on start_date_time. Join amazon_promotions on promotions_api_mapping_id.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":714,"shiftDays":1},{"type":"RECURRING_DAILY","numberOfDays":714,"shiftDays":1}],"sources":["connections","raw_sp_api_report_coupon_performance"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["coupons","clips","redemptions"]},{"id":"8a1c593aeb0211c8ded1c3d073639d15e6a0a88c63076d3894502f2d585a1eae","name":"Promotion Performance","tableName":"amazon_promotion_performance","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"promotion_id","type":"TEXT","nullable":false,"description":null},{"name":"promotion_name","type":"TEXT","nullable":true,"description":"Customer-facing promotion name."},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code on the promotion funding agreement. Empty for sellers."},{"name":"merchant_id","type":"TEXT","nullable":true,"description":"Seller merchant customer id on the funding agreement. Empty for vendors."},{"name":"promotions_api_mapping_id","type":"TEXT","nullable":true,"description":"Identifier for joining this promotion to amazon_promotions."},{"name":"promotion_type","type":"TEXT","nullable":true,"description":"BEST_DEAL, LIGHTNING_DEAL, PRICE_DISCOUNT, DEAL_OF_THE_DAY, SALES_DISCOUNT, COUPON, or PROMO_CODE. Vendors commonly use Best Deal, Lightning Deal, and Price Discount. Sellers commonly use Best Deal and Lightning Deal."},{"name":"promotion_status","type":"TEXT","nullable":true,"description":"APPROVED, PENDING_APPROVAL, NEEDS_YOUR_ATTENTION, or CANCELED."},{"name":"funding_agreement_id","type":"TEXT","nullable":true,"description":"Vendor funding agreement id. Empty for sellers."},{"name":"glance_views","type":"NUMBER","nullable":true,"description":"Detail-page views across all ASINs in the promotion. Promotion-level value repeated on every ASIN row. Use the product_ columns for this ASIN, and aggregate by promotion_id before summing promotion totals."},{"name":"units_sold","type":"NUMBER","nullable":true,"description":"Units sold across all ASINs in the promotion. Promotion-level value repeated on every ASIN row. Use the product_ columns for this ASIN, and aggregate by promotion_id before summing promotion totals."},{"name":"amount_spent","type":"NUMBER","nullable":true,"description":"Vendor funding across the promotion. Empty for sellers. Promotion-level value repeated on every ASIN row. Use the product_ columns for this ASIN, and aggregate by promotion_id before summing promotion totals."},{"name":"amount_spent_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of amount_spent."},{"name":"revenue","type":"NUMBER","nullable":true,"description":"Revenue across all ASINs in the promotion. For sellers this matches Seller Central sales. Promotion-level value repeated on every ASIN row. Use the product_ columns for this ASIN, and aggregate by promotion_id before summing promotion totals."},{"name":"revenue_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of revenue."},{"name":"start_date_time","type":"DATE","nullable":true,"description":"Promotion start in UTC. Use this column for date filtering; the table has no date column."},{"name":"end_date_time","type":"DATE","nullable":true,"description":"Promotion end in UTC."},{"name":"created_date_time","type":"DATE","nullable":true,"description":"When the promotion was created, in UTC."},{"name":"last_updated_date_time","type":"DATE","nullable":true,"description":"When Amazon last updated the promotion, in UTC. Can lag the current time by about a day."},{"name":"asin","type":"TEXT","nullable":false,"description":"Child ASIN included in the promotion. One row per ASIN."},{"name":"product_name","type":"TEXT","nullable":true,"description":null},{"name":"product_glance_views","type":"NUMBER","nullable":true,"description":"Detail-page views for this ASIN during the promotion."},{"name":"product_units_sold","type":"NUMBER","nullable":true,"description":"Units of this ASIN sold at the promotional price."},{"name":"product_amount_spent","type":"NUMBER","nullable":true,"description":"Vendor funding for this ASIN. Empty for sellers."},{"name":"product_amount_spent_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of product_amount_spent."},{"name":"product_revenue","type":"NUMBER","nullable":true,"description":"Revenue for this ASIN. For sellers this matches Seller Central sales."},{"name":"product_revenue_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of product_revenue."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Seller and vendor promotion performance for Best Deal, Lightning Deal, Price Discount, and related deal types. One row per promotion and ASIN. Glance views, units, funding, and revenue at promotion level repeat on every ASIN row; use the product_ columns for the ASIN. amount_spent is vendor funding. Seller revenue matches Seller Central sales. Configuration lives on amazon_promotions.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":714,"shiftDays":1},{"type":"RECURRING_DAILY","numberOfDays":714,"shiftDays":1}],"sources":["connections","raw_sp_api_report_promotion_performance"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["lightning deal","best deal","price discount"]},{"id":"6cdde992a36bdedb6fbd17bbcd294941dbf55ac504302db9b232dc0887f1598a","name":"Sellers & Vendors Context","tableName":"amazon_sellers_and_vendors_context","type":"SELLER_CENTRAL","columns":[{"name":"connection_context_id","type":"TEXT","nullable":false,"description":"DataDoe connection context id, or the connection id when no context is set. Same value as seller_or_vendor_id. Not a unique row key when one context has several connections or DSP advertisers."},{"name":"connection_context_name","type":"TEXT","nullable":false,"description":"Context display name. Same value as seller_or_vendor_name. Falls back to the connection name, then the connection id. DSP rows use the mapped context name."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"Same value as connection_context_id. DataDoe account id used by MCP and API calls (sellers_and_vendors_list, exports). Not unique on this table: repeated for each connection and each DSP advertiser in the context. Fact tables copy this value into their seller_or_vendor_id."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"Same value as connection_context_name. DataDoe display name for the seller or vendor context."},{"name":"ads_dsp_connection_id","type":"TEXT","nullable":true,"description":"DataDoe Amazon Ads connection id of the account Amazon DSP is run from. One agency connection can be shared by several sellers or vendors. Null on non-DSP rows. Join DSP facts on organization_id, store_id, ads_dsp_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser identifier mapped to this seller or vendor. One advertiser maps to one context. If an advertiser is reassigned, only the latest mapping is kept. Null on non-DSP rows."},{"name":"selling_partner_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id from the connection (connection_seller_id). Same value as marketplace_seller_id. This is the Amazon id, not seller_or_vendor_id. Null on DSP advertiser rows and when the connection has no seller id."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Same value as selling_partner_id: Amazon connection_seller_id. Null on DSP advertiser rows and when the connection has no seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile id. Set on Amazon Ads connections and on DSP advertiser rows. Null on Seller Central and Vendor Central rows."},{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":false,"description":"Lookup of DataDoe Amazon accounts for Seller Central, Vendor Central, Amazon Ads, and Amazon DSP. One row per connection, plus one row per Amazon DSP advertiser mapped to a seller or vendor on a shared agency Ads account. A DSP-only agency seat is not its own seller. seller_or_vendor_id equals connection_context_id and is not unique: one context can have a Seller Central row, an Amazon Ads row, and one row per DSP advertiser. Join Seller Central and Vendor Central facts on sp_connection_id or vendor_connection_id. Attribute DSP facts on organization_id, store_id, ads_dsp_connection_id, and dsp_advertiser_id.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[],"sources":["connections","raw_connection_dsp_advertisers"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["connection mapping","selling partner id","dsp advertiser","ads profile"]},{"id":"8dd5813be06d8679ce99c1e0b09a998c8332efda20a2abc9eaa8787f81c2a064","name":"Cost of Goods Sold (COGS)","tableName":"amazon_cogs","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"from","type":"DATE","nullable":false,"description":null},{"name":"cost_item_value","type":"NUMBER","nullable":false,"description":null},{"name":"cost_item_shipping_value","type":"NUMBER","nullable":false,"description":null},{"name":"cost_currency","type":"TEXT","nullable":false,"description":null},{"name":"item_supplier_name","type":"TEXT","nullable":true,"description":"Supplier name for the item COGS, if provided in COGS upload."}],"userManaged":true,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Detailed data about cost of goods sold (COGS) per SKU. COGS are managed by the user via form in the Sellers & Vendors page.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[],"sources":["connections","raw_amazon_cogs"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["landed cost","product cost"]},{"id":"88e554542fab92541ca2423f3a230813ad57bb3e156207038fb3f7169b9e879d","name":"Order Details PII","tableName":"amazon_orders_details","type":"SELLER_CENTRAL","columns":[{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_order_id","type":"TEXT","nullable":false,"description":null},{"name":"buyer_email","type":"TEXT","nullable":true,"description":"Hashed email address of the buyer. Same value across all orders from the same buyer; NULL for FBA orders. Non-null values are a safe grouping key for customer identity, retention, repeat purchase and CLV analysis."},{"name":"buyer_name","type":"TEXT","nullable":true,"description":null},{"name":"buyer_company_name","type":"TEXT","nullable":true,"description":null},{"name":"buyer_purchase_order_number","type":"TEXT","nullable":true,"description":null},{"name":"recipient_name","type":"TEXT","nullable":true,"description":null},{"name":"recipient_company_name","type":"TEXT","nullable":true,"description":null},{"name":"recipient_address_line1","type":"TEXT","nullable":true,"description":null},{"name":"recipient_address_line2","type":"TEXT","nullable":true,"description":null},{"name":"recipient_address_line3","type":"TEXT","nullable":true,"description":null},{"name":"recipient_city","type":"TEXT","nullable":true,"description":null},{"name":"recipient_district_or_county","type":"TEXT","nullable":true,"description":null},{"name":"recipient_state_or_region","type":"TEXT","nullable":true,"description":null},{"name":"recipient_municipality","type":"TEXT","nullable":true,"description":null},{"name":"recipient_postal_code","type":"TEXT","nullable":true,"description":null},{"name":"recipient_country_code","type":"TEXT","nullable":true,"description":null},{"name":"recipient_phone","type":"TEXT","nullable":true,"description":null},{"name":"recipient_address_type","type":"TEXT","nullable":true,"description":null},{"name":"recipient_extended_fields","type":"JSON","nullable":true,"description":null},{"name":"order_items_gift_messages","type":"JSON","nullable":true,"description":null},{"name":"order_items_customized_urls","type":"JSON","nullable":true,"description":null},{"name":"order_date","type":"DATE","nullable":false,"description":"Duplicate of date column. Prefer to use date column for date filtering."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Order-level customer and shipping PII details. An extension of `amazon_order_items_with_cogs` table.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"Data is available up to 1 hour after the order is fetched."},"sources":["connections","raw_sp_api_orders_details_pii"],"containsPii":true,"initialLoadProgress":null},{"id":"8723a9f82b37438b5224867ac182d2e773bea12532b9f5ad2930811a6f219f90","name":"Repeat Purchase Performance","tableName":"amazon_repeat_purchase_report","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"number_of_orders","type":"NUMBER","nullable":false,"description":"Orders that contained the child ASIN in the month. An order can include multiple units, so this is not ordered units."},{"name":"number_of_unique_customers","type":"NUMBER","nullable":false,"description":"Unique customers who placed an order containing the child ASIN in the month."},{"name":"repeat_customers_score_total","type":"NUMBER","nullable":false,"description":"Fraction of unique customers that are repeat customers in the month, between 0 and 1. A value of 1.00 is common on low-volume ASINs; filter by number_of_orders or number_of_unique_customers before ranking."},{"name":"repeat_purchase_revenue_amount","type":"NUMBER","nullable":false,"description":"Ordered revenue from repeat customers in the month. Returns are excluded."},{"name":"repeat_purchase_revenue_currency","type":"TEXT","nullable":false,"description":"ISO 4217 currency of repeat_purchase_revenue_amount."},{"name":"repeat_purchase_revenue_score_total","type":"NUMBER","nullable":false,"description":"Fraction of repeat-purchase revenue versus total revenue for the child ASIN in the month, between 0 and 1."},{"name":"date","type":"DATE","nullable":false,"description":"First day of the month the data refers to. This table stores the MONTH Brand Analytics period."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Monthly Brand Analytics repeat purchase report per child ASIN for Brand Registry sellers and vendors. One row per child ASIN and month. repeat_customers_score_total and repeat_purchase_revenue_score_total are 0-1 rates. Repeat revenue is ordered revenue and excludes returns.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":365},{"type":"RECURRING_WEEKLY","numberOfDays":90}],"sources":["connections","raw_sp_api_report_brand_analytics_repeat_purchase"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["repeat customers","customer retention","brand analytics"]},{"id":"21aa739348f0c2d2dcebd1215736d082e346ef9cdd69b6ef509464f1cd249b0b","name":"Market Basket Co-Purchase (Monthly)","tableName":"amazon_market_basket_by_child_asin","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"purchased_with_child_asin","type":"TEXT","nullable":false,"description":"ASIN purchased in the same customer order as child_asin. It may be outside your catalog."},{"name":"purchased_with_rank","type":"NUMBER","nullable":false,"description":"How often this pair is bought together. 1 is the most common ASIN purchased with child_asin."},{"name":"purchased_with_combination_score","type":"NUMBER","nullable":false,"description":"Share of multi-item orders that contain both ASINs, between 0 and 1. The denominator is customer orders with at least two different items that include child_asin. Multiply by 100 for a percentage."},{"name":"date","type":"DATE","nullable":false,"description":"First day of the month the data refers to. This table stores the MONTH Brand Analytics period."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Monthly Brand Analytics market basket report of products frequently bought together. One row per child ASIN and co-purchased ASIN. The co-purchased ASIN can belong to another brand. purchased_with_combination_score is a 0-1 share of multi-item orders.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":365},{"type":"RECURRING_WEEKLY","numberOfDays":90}],"sources":["connections","raw_sp_api_report_brand_analytics_market_basket_by_month"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["frequently bought together","co-purchase","market basket"]},{"id":"d8f74544e6a856dfb6ab916ae57310fa11a74d237c00c0b20a72bfd8d0a26ce8","name":"Brand Analytics Search Terms (Daily)","tableName":"amazon_brand_analytics_search_terms_daily","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"date","type":"DATE","nullable":false,"description":"Reporting date for the daily snapshot. Data availability can lag, so use MAX(date) for the most recent day."},{"name":"start_date","type":"DATE","nullable":true,"description":"Brand Analytics report period start. May be null. Use date for filtering."},{"name":"end_date","type":"DATE","nullable":true,"description":"Brand Analytics report period end. May be null. Use date for filtering."},{"name":"department_name","type":"TEXT","nullable":false,"description":"Amazon search department the term was searched in, such as Amazon.com or Beauty. Rank and share metrics are scoped to this department."},{"name":"search_term","type":"TEXT","nullable":false,"description":"Customer search keyword."},{"name":"search_frequency_rank","type":"NUMBER","nullable":true,"description":"Rank of the search term by search frequency inside department_name. 1 is the most searched term in that department."},{"name":"clicked_asin","type":"TEXT","nullable":false,"description":"ASIN customers clicked after this search term. Any catalog ASIN, including products you do not sell. Amazon returns the top three clicked ASINs per term and department."},{"name":"click_share_rank","type":"NUMBER","nullable":true,"description":"Rank of clicked_asin by click share for this search term and department. 1 has the highest click share."},{"name":"click_share","type":"NUMBER","nullable":true,"description":"Fraction of clicks this ASIN received versus all clicks for the search term in the department, between 0 and 1. Multiply by 100 for a percentage."},{"name":"conversion_share","type":"NUMBER","nullable":true,"description":"Fraction of conversions this ASIN received versus all conversions from the search term in the department, between 0 and 1. Multiply by 100 for a percentage."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":false,"description":"Daily marketplace Brand Analytics search terms: top clicked ASINs by customer keyword and department, with search frequency rank, click share, and conversion share. Shares are 0-1 fractions. Marketplace-wide, so clicked ASINs are often competitors. For your own ASIN search query performance use amazon_child_product_organic_search_ranks_per_week or amazon_child_product_organic_search_ranks_per_month. Data can lag; use MAX(date).","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":14},{"type":"RECURRING_DAILY","numberOfDays":1}],"sources":["connections","raw_sp_api_report_brand_analytics_search_terms_daily"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["top search terms","search frequency rank","click share","brand analytics"]},{"id":"e49e59add0303062bc38d972142c4d156b59e8deb3ce05526e8cce827095e1ba","name":"Brand Analytics Search Terms (Weekly)","tableName":"amazon_brand_analytics_search_terms_weekly","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"date","type":"DATE","nullable":false,"description":"First day of the week the data refers to. Represents an aggregated weekly snapshot. Data availability can lag, so use MAX(date) for the most recent week."},{"name":"start_date","type":"DATE","nullable":true,"description":"Brand Analytics report period start. May be null. Use date for filtering."},{"name":"end_date","type":"DATE","nullable":true,"description":"Brand Analytics report period end. May be null. Use date for filtering."},{"name":"department_name","type":"TEXT","nullable":false,"description":"Amazon search department the term was searched in, such as Amazon.com or Beauty. Rank and share metrics are scoped to this department."},{"name":"search_term","type":"TEXT","nullable":false,"description":"Customer search keyword."},{"name":"search_frequency_rank","type":"NUMBER","nullable":true,"description":"Rank of the search term by search frequency inside department_name. 1 is the most searched term in that department."},{"name":"clicked_asin","type":"TEXT","nullable":false,"description":"ASIN customers clicked after this search term. Any catalog ASIN, including products you do not sell. Amazon returns the top three clicked ASINs per term and department."},{"name":"click_share_rank","type":"NUMBER","nullable":true,"description":"Rank of clicked_asin by click share for this search term and department. 1 has the highest click share."},{"name":"click_share","type":"NUMBER","nullable":true,"description":"Fraction of clicks this ASIN received versus all clicks for the search term in the department, between 0 and 1. Multiply by 100 for a percentage."},{"name":"conversion_share","type":"NUMBER","nullable":true,"description":"Fraction of conversions this ASIN received versus all conversions from the search term in the department, between 0 and 1. Multiply by 100 for a percentage."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":false,"description":"Weekly marketplace Brand Analytics search terms: top clicked ASINs by customer keyword and department, with search frequency rank, click share, and conversion share. Shares are 0-1 fractions. Marketplace-wide, so clicked ASINs are often competitors. For your own ASIN search query performance use amazon_child_product_organic_search_ranks_per_week or amazon_child_product_organic_search_ranks_per_month. Data can lag; use MAX(date).","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_WEEKLY","numberOfDays":7,"shiftDays":7}],"sources":["connections","raw_sp_api_report_brand_analytics_search_terms_weekly"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["top search terms","search frequency rank","click share","brand analytics"]},{"id":"ac6a07d258e44bd72f5ce8edc55d715650607617a4ed42b1459a416e6fb5e412","name":"Brand Analytics Search Terms (Monthly)","tableName":"amazon_brand_analytics_search_terms_monthly","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"date","type":"DATE","nullable":false,"description":"First day of the month the data refers to. Represents an aggregated monthly snapshot. Data availability can lag, so use MAX(date) for the most recent month."},{"name":"start_date","type":"DATE","nullable":true,"description":"Brand Analytics report period start. May be null. Use date for filtering."},{"name":"end_date","type":"DATE","nullable":true,"description":"Brand Analytics report period end. May be null. Use date for filtering."},{"name":"department_name","type":"TEXT","nullable":false,"description":"Amazon search department the term was searched in, such as Amazon.com or Beauty. Rank and share metrics are scoped to this department."},{"name":"search_term","type":"TEXT","nullable":false,"description":"Customer search keyword."},{"name":"search_frequency_rank","type":"NUMBER","nullable":true,"description":"Rank of the search term by search frequency inside department_name. 1 is the most searched term in that department."},{"name":"clicked_asin","type":"TEXT","nullable":false,"description":"ASIN customers clicked after this search term. Any catalog ASIN, including products you do not sell. Amazon returns the top three clicked ASINs per term and department."},{"name":"click_share_rank","type":"NUMBER","nullable":true,"description":"Rank of clicked_asin by click share for this search term and department. 1 has the highest click share."},{"name":"click_share","type":"NUMBER","nullable":true,"description":"Fraction of clicks this ASIN received versus all clicks for the search term in the department, between 0 and 1. Multiply by 100 for a percentage."},{"name":"conversion_share","type":"NUMBER","nullable":true,"description":"Fraction of conversions this ASIN received versus all conversions from the search term in the department, between 0 and 1. Multiply by 100 for a percentage."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":false,"description":"Monthly marketplace Brand Analytics search terms: top clicked ASINs by customer keyword and department, with search frequency rank, click share, and conversion share. Shares are 0-1 fractions. Marketplace-wide, so clicked ASINs are often competitors. For your own ASIN search query performance use amazon_child_product_organic_search_ranks_per_week or amazon_child_product_organic_search_ranks_per_month. Data can lag; use MAX(date).","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":365},{"type":"RECURRING_MONTHLY","numberOfDays":30,"shiftDays":30}],"sources":["connections","raw_sp_api_report_brand_analytics_search_terms_monthly"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["top search terms","search frequency rank","click share","brand analytics"]},{"id":"68d2de238e8d1a47bc56a981a99d54558507b0bafb1e09f1b3e95fb7750a17a8","name":"Product Catalog by ASIN","tableName":"amazon_products_by_child_asin","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"parent_asin","type":"TEXT","nullable":true,"description":"First parent ASIN from Catalog Items relationships. Empty for parent and standalone ASINs."},{"name":"amazon_product_type","type":"TEXT","nullable":false,"description":"Variation role derived from the Catalog Items browse classification tree: PARENT, CHILD, or SINGLE. The Amazon product type template, such as LUGGAGE, is product_type on amazon_products_raw."},{"name":"product_name","type":"TEXT","nullable":true,"description":null},{"name":"product_root_category_name","type":"TEXT","nullable":true,"description":"Display name of the top browse classification, walking parent nodes to the root."},{"name":"product_node_category_name","type":"TEXT","nullable":true,"description":"Display name of the ASIN browse node (the first catalog classification)."},{"name":"product_root_best_selling_rank","type":"NUMBER","nullable":true,"description":"Best Seller Rank in the website display group (Catalog salesRanks displayGroupRanks). 1 is the top seller in that group. This rank is separate from the browse-node rank."},{"name":"product_node_best_selling_rank","type":"NUMBER","nullable":true,"description":"Best Seller Rank in the browse node that matches product_node_category_name. 1 is the top seller in that node."},{"name":"product_brand","type":"TEXT","nullable":true,"description":null},{"name":"product_color","type":"TEXT","nullable":true,"description":null},{"name":"product_model_number","type":"TEXT","nullable":true,"description":null},{"name":"product_release_date","type":"DATE","nullable":true,"description":"Catalog release date from the item summary."},{"name":"product_size","type":"TEXT","nullable":true,"description":null},{"name":"product_style","type":"TEXT","nullable":true,"description":null},{"name":"product_bullet_point_1","type":"TEXT","nullable":true,"description":"First listing bullet from Catalog attributes.bullet_point. Only the first five bullets are stored."},{"name":"product_bullet_point_2","type":"TEXT","nullable":true,"description":null},{"name":"product_bullet_point_3","type":"TEXT","nullable":true,"description":null},{"name":"product_bullet_point_4","type":"TEXT","nullable":true,"description":null},{"name":"product_bullet_point_5","type":"TEXT","nullable":true,"description":null},{"name":"product_description","type":"TEXT","nullable":true,"description":"Catalog product_description attribute. A+ content and other enhanced content are not included."},{"name":"product_image_url","type":"TEXT","nullable":true,"description":"MAIN catalog image closest to 500 by 500 pixels."},{"name":"product_url","type":"TEXT","nullable":true,"description":"Marketplace product detail page URL for the child ASIN."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Catalog Items snapshot per child ASIN and marketplace: title, brand, bullets, description, browse node, and best seller rank. amazon_product_type is PARENT, CHILD, or SINGLE. For the catalog product type template and raw JSON attributes, classifications, images, and sales ranks, use amazon_products_raw.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["refined_products_by_child_asin"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["catalog","bsr","best seller rank","browse node"]},{"id":"0e1ea34395ebb2b2658f4636d7fbdb9381d985eabeaea87aafa49335a92ff551","name":"Product Catalog by ASIN (Raw JSON)","tableName":"amazon_products_raw","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"parent_asin","type":"TEXT","nullable":true,"description":"First parent ASIN from Catalog Items relationships. Empty for parent and standalone ASINs."},{"name":"amazon_product_type","type":"TEXT","nullable":false,"description":"Variation role derived from the Catalog Items browse classification tree: PARENT, CHILD, or SINGLE. The Amazon product type template, such as LUGGAGE, is product_type on amazon_products_raw."},{"name":"attributes","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"classifications","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"dimensions","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"identifiers","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"images","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"product_type","type":"TEXT","nullable":true,"description":"Amazon catalog product type template for this marketplace, such as LUGGAGE. Distinct from amazon_product_type, which is PARENT, CHILD, or SINGLE."},{"name":"sales_ranks","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"summaries","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"relationships","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Raw Catalog Items payload per child ASIN and marketplace: attributes, classifications, dimensions, identifiers, images, sales ranks, summaries, and relationships. amazon_product_type is PARENT, CHILD, or SINGLE; product_type is the Amazon product type template. Prefer amazon_products_by_child_asin for titles, bullets, and best seller rank. Rows are large; download them to a file instead of loading them into context.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["refined_products_by_child_asin"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["catalog attributes","product type"]},{"id":"7076aeafd23f0805afb91c4ecef994d7a0d2e796e06852391bc28de680e71aaa","name":"Coupon Performance","tableName":"amazon_coupon_performance","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"campaign_id","type":"TEXT","nullable":false,"description":"Vendor coupon campaign id. Empty string on seller coupons, which have no campaign."},{"name":"campaign_name","type":"TEXT","nullable":true,"description":"Vendor coupon campaign name. Empty on seller coupons."},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Amazon vendor code on the coupon campaign. Empty on seller coupons."},{"name":"is_subscribe_and_save","type":"LOGIC","nullable":true,"description":"Whether the vendor campaign is a Subscribe and Save offer. Empty on seller coupons."},{"name":"budget_type","type":"TEXT","nullable":true,"description":"Vendor campaign budget allocation: PER_INDIVIDUAL_COUPON or SHARED_BUDGET. Empty on seller coupons."},{"name":"campaign_total_clips","type":"NUMBER","nullable":true,"description":"Sum of clips across coupons in the vendor campaign. Campaign-level value repeated on every coupon and ASIN row. Aggregate by campaign_id before summing."},{"name":"campaign_total_redemptions","type":"NUMBER","nullable":true,"description":"Sum of redemptions across coupons in the vendor campaign. Campaign-level value repeated on every coupon and ASIN row. Aggregate by campaign_id before summing."},{"name":"currency_code","type":"TEXT","nullable":true,"description":"ISO 4217 currency of the coupon amounts."},{"name":"coupon_id","type":"TEXT","nullable":false,"description":null},{"name":"coupon_name","type":"TEXT","nullable":true,"description":null},{"name":"website_message","type":"TEXT","nullable":true,"description":"Message displayed with the coupon on the product page."},{"name":"start_date_time","type":"DATE","nullable":true,"description":"Coupon start in UTC. Use this column for date filtering; the table has no date column."},{"name":"end_date_time","type":"DATE","nullable":true,"description":"Coupon end in UTC."},{"name":"is_once_per_customer","type":"LOGIC","nullable":true,"description":"Whether a vendor coupon can be redeemed once per customer account. Empty on seller coupons."},{"name":"customer_segment","type":"TEXT","nullable":true,"description":"Customers who can clip the coupon. Examples: All (Default), Amazon Prime, Amazon Student."},{"name":"clips","type":"NUMBER","nullable":true,"description":"Times customers applied the coupon on the product page. Coupon-level value repeated on every ASIN row of the coupon. Aggregate by coupon_id before summing."},{"name":"redemptions","type":"NUMBER","nullable":true,"description":"Times the coupon was used for a purchase, including returned and cancelled orders. Coupon-level value repeated on every ASIN row of the coupon. Aggregate by coupon_id before summing."},{"name":"budget","type":"NUMBER","nullable":true,"description":"Budget allocated to the coupon for discounts and clip or redemption fees. Present for seller coupons and for vendor campaigns with PER_INDIVIDUAL_COUPON. Empty when the vendor campaign uses SHARED_BUDGET."},{"name":"total_discount","type":"NUMBER","nullable":true,"description":"Amount customers saved with the coupon, including returned and cancelled orders. Coupon-level value repeated on every ASIN row of the coupon. Aggregate by coupon_id before summing."},{"name":"budget_spent","type":"NUMBER","nullable":true,"description":"Amount spent on the coupon, including clip fees and redemption fees, and including returned and cancelled orders. Coupon-level value repeated on every ASIN row of the coupon. Aggregate by coupon_id before summing."},{"name":"budget_remaining","type":"NUMBER","nullable":true,"description":"budget minus budget_spent. Empty when the vendor campaign uses SHARED_BUDGET."},{"name":"budget_percentage_used","type":"NUMBER","nullable":true,"description":"Percent of allocated budget spent, on a 0-100 scale. A value of 0.4 means 0.4 percent. For a shared vendor budget this is versus the campaign budget."},{"name":"sales","type":"NUMBER","nullable":true,"description":"Seller coupon revenue after the discount, including returned and cancelled orders. Empty on vendor coupons. Coupon-level value repeated on every ASIN row of the coupon. Aggregate by coupon_id before summing."},{"name":"merchant_id","type":"TEXT","nullable":true,"description":"Seller merchant customer id. Empty on vendor coupons."},{"name":"promotions_api_mapping_id","type":"TEXT","nullable":true,"description":"Identifier for joining this coupon to amazon_promotions."},{"name":"asin","type":"TEXT","nullable":false,"description":"Child ASIN included in the coupon. One row per ASIN."},{"name":"discount_type","type":"TEXT","nullable":true,"description":"PERCENT_OFF_LIST_PRICE or AMOUNT_OFF_LIST_PRICE for this ASIN."},{"name":"discount_amount","type":"NUMBER","nullable":true,"description":"Customer discount on this ASIN. A percent of list price when discount_type is PERCENT_OFF_LIST_PRICE (10 means 10 percent). A currency amount when discount_type is AMOUNT_OFF_LIST_PRICE."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Seller and vendor coupon performance, one row per coupon and ASIN. Includes clips, redemptions, budget, and the ASIN discount. Campaign and coupon totals repeat on every ASIN row. Vendor rows carry campaign, vendor code, and Subscribe and Save; sales is seller coupon revenue. Filter on start_date_time. Join amazon_promotions on promotions_api_mapping_id.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":714,"shiftDays":1},{"type":"RECURRING_DAILY","numberOfDays":714,"shiftDays":1}],"sources":["connections","raw_sp_api_report_coupon_performance"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["coupons","clips","redemptions"]},{"id":"8a1c593aeb0211c8ded1c3d073639d15e6a0a88c63076d3894502f2d585a1eae","name":"Promotion Performance","tableName":"amazon_promotion_performance","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"promotion_id","type":"TEXT","nullable":false,"description":null},{"name":"promotion_name","type":"TEXT","nullable":true,"description":"Customer-facing promotion name."},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code on the promotion funding agreement. Empty for sellers."},{"name":"merchant_id","type":"TEXT","nullable":true,"description":"Seller merchant customer id on the funding agreement. Empty for vendors."},{"name":"promotions_api_mapping_id","type":"TEXT","nullable":true,"description":"Identifier for joining this promotion to amazon_promotions."},{"name":"promotion_type","type":"TEXT","nullable":true,"description":"BEST_DEAL, LIGHTNING_DEAL, PRICE_DISCOUNT, DEAL_OF_THE_DAY, SALES_DISCOUNT, COUPON, or PROMO_CODE. Vendors commonly use Best Deal, Lightning Deal, and Price Discount. Sellers commonly use Best Deal and Lightning Deal."},{"name":"promotion_status","type":"TEXT","nullable":true,"description":"APPROVED, PENDING_APPROVAL, NEEDS_YOUR_ATTENTION, or CANCELED."},{"name":"funding_agreement_id","type":"TEXT","nullable":true,"description":"Vendor funding agreement id. Empty for sellers."},{"name":"glance_views","type":"NUMBER","nullable":true,"description":"Detail-page views across all ASINs in the promotion. Promotion-level value repeated on every ASIN row. Use the product_ columns for this ASIN, and aggregate by promotion_id before summing promotion totals."},{"name":"units_sold","type":"NUMBER","nullable":true,"description":"Units sold across all ASINs in the promotion. Promotion-level value repeated on every ASIN row. Use the product_ columns for this ASIN, and aggregate by promotion_id before summing promotion totals."},{"name":"amount_spent","type":"NUMBER","nullable":true,"description":"Vendor funding across the promotion. Empty for sellers. Promotion-level value repeated on every ASIN row. Use the product_ columns for this ASIN, and aggregate by promotion_id before summing promotion totals."},{"name":"amount_spent_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of amount_spent."},{"name":"revenue","type":"NUMBER","nullable":true,"description":"Revenue across all ASINs in the promotion. For sellers this matches Seller Central sales. Promotion-level value repeated on every ASIN row. Use the product_ columns for this ASIN, and aggregate by promotion_id before summing promotion totals."},{"name":"revenue_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of revenue."},{"name":"start_date_time","type":"DATE","nullable":true,"description":"Promotion start in UTC. Use this column for date filtering; the table has no date column."},{"name":"end_date_time","type":"DATE","nullable":true,"description":"Promotion end in UTC."},{"name":"created_date_time","type":"DATE","nullable":true,"description":"When the promotion was created, in UTC."},{"name":"last_updated_date_time","type":"DATE","nullable":true,"description":"When Amazon last updated the promotion, in UTC. Can lag the current time by about a day."},{"name":"asin","type":"TEXT","nullable":false,"description":"Child ASIN included in the promotion. One row per ASIN."},{"name":"product_name","type":"TEXT","nullable":true,"description":null},{"name":"product_glance_views","type":"NUMBER","nullable":true,"description":"Detail-page views for this ASIN during the promotion."},{"name":"product_units_sold","type":"NUMBER","nullable":true,"description":"Units of this ASIN sold at the promotional price."},{"name":"product_amount_spent","type":"NUMBER","nullable":true,"description":"Vendor funding for this ASIN. Empty for sellers."},{"name":"product_amount_spent_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of product_amount_spent."},{"name":"product_revenue","type":"NUMBER","nullable":true,"description":"Revenue for this ASIN. For sellers this matches Seller Central sales."},{"name":"product_revenue_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of product_revenue."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Seller and vendor promotion performance for Best Deal, Lightning Deal, Price Discount, and related deal types. One row per promotion and ASIN. Glance views, units, funding, and revenue at promotion level repeat on every ASIN row; use the product_ columns for the ASIN. amount_spent is vendor funding. Seller revenue matches Seller Central sales. Configuration lives on amazon_promotions.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":714,"shiftDays":1},{"type":"RECURRING_DAILY","numberOfDays":714,"shiftDays":1}],"sources":["connections","raw_sp_api_report_promotion_performance"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["lightning deal","best deal","price discount"]},{"id":"abafd926794c204dea3a7ff75f430f27a7285cabdb2651a34a4c2cdd89f531c6","name":"Invoices","tableName":"amazon_invoices","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":"UTC calendar day of the invoice issue date. Use for date filtering."},{"name":"invoice_identifier","type":"TEXT","nullable":false,"description":"Unique invoice identifier. For AP-Inventory invoices this is InvoiceNumber~PayeeCode."},{"name":"invoice_number","type":"TEXT","nullable":true,"description":null},{"name":"invoice_status","type":"TEXT","nullable":true,"description":"IN_PROGRESS, REJECTED, PARTIALLY_PAID, PARTIALLY_DEDUCTED, PAID, or DEDUCTED. PARTIALLY_DEDUCTED and DEDUCTED are accounts-receivable states."},{"name":"invoice_type","type":"TEXT","nullable":true,"description":"AP_INVENTORY (accounts payable inventory) or OTHER."},{"name":"billing_period_start_date","type":"DATE","nullable":true,"description":null},{"name":"billing_period_end_date","type":"DATE","nullable":true,"description":null},{"name":"payee_partner_id","type":"TEXT","nullable":true,"description":"Payee partner id. For a vendor this is the vendor group id."},{"name":"payee_partner_type","type":"TEXT","nullable":true,"description":"SELLER, VENDOR, or AMAZON."},{"name":"payee_partner_name","type":"TEXT","nullable":true,"description":null},{"name":"payee_partner_entities","type":"JSON","nullable":true,"description":"JSON list of entity codes for the payee, such as vendor codes."},{"name":"payee_partner_address","type":"TEXT","nullable":true,"description":null},{"name":"payee_tax_registration_number","type":"TEXT","nullable":true,"description":null},{"name":"payer_partner_id","type":"TEXT","nullable":true,"description":"Payer partner id. AMAZON is the payer on an accounts-payable invoice."},{"name":"payer_partner_type","type":"TEXT","nullable":true,"description":"SELLER, VENDOR, or AMAZON."},{"name":"payer_partner_name","type":"TEXT","nullable":true,"description":null},{"name":"payer_partner_entities","type":"JSON","nullable":true,"description":"JSON list of entity codes for the payer."},{"name":"payer_partner_address","type":"TEXT","nullable":true,"description":null},{"name":"payer_tax_registration_number","type":"TEXT","nullable":true,"description":null},{"name":"issue_date","type":"DATE","nullable":true,"description":"Invoice issue timestamp. date is the UTC calendar day of this value."},{"name":"due_date","type":"DATE","nullable":true,"description":null},{"name":"payment_terms","type":"TEXT","nullable":true,"description":"Payment terms text from the invoice."},{"name":"invoice_amount","type":"NUMBER","nullable":true,"description":null},{"name":"invoice_amount_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of invoice_amount."},{"name":"invoice_amount_breakdowns","type":"JSON","nullable":true,"description":"JSON amount breakdowns. breakdownType values: Total, InvoiceAmountWithoutTax, TaxAmount, MiscCharges, Other."},{"name":"invoice_settlement_breakdowns","type":"JSON","nullable":true,"description":"JSON settlement breakdowns. breakdownType values: AmountPaid, QueuedForPayment, QuickPayDiscount, QuantityVarianceAmount, PriceVariance, Other."},{"name":"related_identifiers","type":"JSON","nullable":true,"description":"JSON related business identifiers. relatedIdentifierName values: PAYEE_CODE, PURCHASE_ORDER_IDS, SHORTAGE_INVOICE_IDS, ASN_IDS, RETURN_IDS, AGREEMENT_IDS, PRODUCT_LINE, VENDOR_CODE, UNIQUE_PAYMENT_IDS, WAREHOUSE_ID."},{"name":"creation_date","type":"DATE","nullable":true,"description":null},{"name":"last_updated_date","type":"DATE","nullable":true,"description":null},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last received this row from the SP-API Invoices getInvoice operation."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Accounts payable invoice headers for Vendor Central. One row per invoice. invoice_status is IN_PROGRESS, REJECTED, PARTIALLY_PAID, PARTIALLY_DEDUCTED, PAID, or DEDUCTED. invoice_type is AP_INVENTORY or OTHER. Join amazon_invoice_items on invoice_identifier. date is the UTC day of issue_date.","requiresDatePeriod":true,"issues":[],"prerequisites":"Vendor Central only. Amazon does not offer the Invoices API to Seller Central accounts, so sellers get no rows. The Invoices API needs the Finance and Accounting role. If your Vendor Central account was added to DataDoe before October 1, 2026, this table has no data until you re-authorize the connection on the Sellers & Vendors page.","fetchPeriods":[{"type":"INITIAL","numberOfDays":90},{"type":"RECURRING_DAILY","numberOfDays":2}],"sources":["connections","raw_sp_api_invoices"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["accounts payable","vendor invoice","remittance"]},{"id":"225e7ddc71dc18c0eac1cc5c4ece2f974e0c737590d39ca89543d8566a0dfc5f","name":"Invoice Items","tableName":"amazon_invoice_items","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":"UTC calendar day of the parent invoice issue date. Use for date filtering."},{"name":"invoice_identifier","type":"TEXT","nullable":false,"description":"Parent invoice identifier. Join amazon_invoices on this column."},{"name":"line_item_id","type":"TEXT","nullable":false,"description":null},{"name":"unit_cost_amount","type":"NUMBER","nullable":true,"description":null},{"name":"unit_cost_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of unit_cost_amount."},{"name":"quantity","type":"NUMBER","nullable":true,"description":"Invoiced units on the line."},{"name":"tax_rate_codes","type":"JSON","nullable":true,"description":"JSON list of country and tax rate strings, such as DE 19."},{"name":"total_amount","type":"NUMBER","nullable":true,"description":null},{"name":"total_amount_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of total_amount."},{"name":"total_amount_breakdown","type":"JSON","nullable":true,"description":"JSON line amount breakdowns. breakdownType values: ItemCostWithoutTax, ItemTaxAmount, Other."},{"name":"line_item_type","type":"TEXT","nullable":true,"description":"GOODS, SERVICES, or OTHERS."},{"name":"item_description","type":"TEXT","nullable":true,"description":null},{"name":"service_charge_type","type":"TEXT","nullable":true,"description":"Service charge kind: DAMAGE_ALLOWANCE, PRICE_PROTECTION, FBA_INVENTORY_STORAGE_FEE, or OTHER. Set on service lines."},{"name":"service_charge_period_start_date","type":"DATE","nullable":true,"description":null},{"name":"service_charge_period_end_date","type":"DATE","nullable":true,"description":null},{"name":"asin","type":"TEXT","nullable":true,"description":"ASIN identifier when the line has one. Service lines often have no ASIN."},{"name":"sku","type":"TEXT","nullable":true,"description":"SKU identifier when the line has one."},{"name":"external_id","type":"TEXT","nullable":true,"description":"External identifier Amazon stores for the ASIN."},{"name":"upc","type":"TEXT","nullable":true,"description":null},{"name":"ean","type":"TEXT","nullable":true,"description":null},{"name":"isbn","type":"TEXT","nullable":true,"description":null},{"name":"item_identifiers","type":"JSON","nullable":true,"description":"Full JSON identifier list. Flattened values are also in asin, sku, external_id, upc, ean, and isbn."},{"name":"matched_quantity","type":"NUMBER","nullable":true,"description":"Quantity Amazon matched against the expected purchase order or receipt."},{"name":"matched_amount","type":"NUMBER","nullable":true,"description":"Amount Amazon matched against the expected purchase order or receipt."},{"name":"matched_amount_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of matched_amount."},{"name":"paid_quantity","type":"NUMBER","nullable":true,"description":"Quantity Amazon has paid."},{"name":"paid_amount","type":"NUMBER","nullable":true,"description":"Amount Amazon has paid."},{"name":"paid_amount_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of paid_amount."},{"name":"quantity_variance","type":"NUMBER","nullable":true,"description":"Difference between expected and actual quantity (Amazon quantityVariance)."},{"name":"price_variance_amount","type":"NUMBER","nullable":true,"description":"Difference between expected and invoiced price (Amazon priceVariance)."},{"name":"price_variance_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of price_variance_amount."},{"name":"variance_reasons","type":"JSON","nullable":true,"description":"JSON variance reasons. varianceType is PQV (purchase quantity variance), PPV (purchase price variance), or OTHER. defectTypes name the cause, such as SHORTAGES_IN_TRANSIT, OVERBILLING, DUPLICATE_INVOICE_DEFECT, PRODUCT_COST_NOT_ACTIVE, or DEALBUY."},{"name":"related_item_identifiers","type":"JSON","nullable":true,"description":"JSON related business identifiers. relatedIdentifierName values: PAYEE_CODE, PURCHASE_ORDER_IDS, SHORTAGE_INVOICE_IDS, ASN_IDS, RETURN_IDS, AGREEMENT_IDS, PRODUCT_LINE, VENDOR_CODE, UNIQUE_PAYMENT_IDS, WAREHOUSE_ID."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last received this row from the SP-API Invoices getInvoice operation."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Invoice line items for Vendor Central. One row per line. Goods, services, and other charges, with matched quantity, price and quantity variances, and ASIN, SKU, UPC, EAN, or ISBN identifiers. Join amazon_invoices on invoice_identifier. date is the UTC day of the parent invoice issue date.","requiresDatePeriod":true,"issues":[],"prerequisites":"Vendor Central only. Amazon does not offer the Invoices API to Seller Central accounts, so sellers get no rows. The Invoices API needs the Finance and Accounting role. If your Vendor Central account was added to DataDoe before October 1, 2026, this table has no data until you re-authorize the connection on the Sellers & Vendors page.","fetchPeriods":[{"type":"INITIAL","numberOfDays":90},{"type":"RECURRING_DAILY","numberOfDays":2}],"sources":["connections","raw_sp_api_invoice_items"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["invoice lines","price variance","quantity variance"]},{"id":"7f3aeb3af8ce6fd83a9167de473791995624da9c850a8b55e117f3e75f671902","name":"Detail Page Traffic Event Notifications","tableName":"amazon_notifications_detail_page_traffic_event","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: DETAIL_PAGE_TRAFFIC_EVENT."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API DETAIL_PAGE_TRAFFIC_EVENT notifications for detail page traffic events.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_detail_page_traffic_event"],"containsPii":false,"initialLoadProgress":null},{"id":"396c89528b23c903698c416c307e557466179399f927e1634c2b1b4fcad395dd","name":"Item Inventory Event Change Notifications","tableName":"amazon_notifications_item_inventory_event_change","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: ITEM_INVENTORY_EVENT_CHANGE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API ITEM_INVENTORY_EVENT_CHANGE notifications for item inventory event changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_item_inventory_event_change"],"containsPii":false,"initialLoadProgress":null},{"id":"beccb6e0943f1044e2742864470769d8770186196fcd4f434c6d50e898ba2645","name":"Item Sales Event Change Notifications","tableName":"amazon_notifications_item_sales_event_change","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: ITEM_SALES_EVENT_CHANGE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API ITEM_SALES_EVENT_CHANGE notifications for item sales event changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_item_sales_event_change"],"containsPii":false,"initialLoadProgress":null},{"id":"f6118edb9e783fab664f796adc86a2f52f937aa6977555c488f8581af5f63385","name":"Listings Item Issues Change Notifications","tableName":"amazon_notifications_listings_item_issues_change","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: LISTINGS_ITEM_ISSUES_CHANGE."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API LISTINGS_ITEM_ISSUES_CHANGE notifications for listing quality and issue changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_listings_item_issues_change"],"containsPii":false,"initialLoadProgress":null},{"id":"7b2b86a4e0742970ee831e78341826ea29b351b91ee0ba88b2f86fbb7a9c27cf","name":"Shipment Tracking Milestone Changed Notifications","tableName":"amazon_notifications_shipment_tracking_milestone_changed","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon SP-API notification identifier."},{"name":"sp_api_notification_type","type":"TEXT","nullable":false,"description":"Notification type. Expected value: SHIPMENT_TRACKING_MILESTONE_CHANGED."},{"name":"event_time","type":"DATE","nullable":false,"description":"Time when Amazon published the notification (ISO-8601 / UTC)."},{"name":"notification_metadata","type":"JSON","nullable":false,"description":"Amazon SP-API notification metadata payload."},{"name":"payload","type":"JSON","nullable":false,"description":"Raw SP-API notification payload."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time Amazon SP-API SHIPMENT_TRACKING_MILESTONE_CHANGED notifications for Amazon Tracking API shipment milestone updates.","requiresDatePeriod":false,"issues":[],"prerequisites":"Amazon requires a subscription for each tracking identifier (US Tracking API). Use the AMAZON_SHIPMENT_TRACKING_SUBSCRIBE Action to send tracking IDs. DataDoe does not subscribe automatically.","relatedActions":[{"type":"AMAZON_SHIPMENT_TRACKING_SUBSCRIBE","relation":"prerequisite"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"SP-API notifications are available within about 2 hours after Amazon publishes them."},"sources":["connections","raw_sp_api_notifications_shipment_tracking_milestone_changed"],"containsPii":false,"initialLoadProgress":null},{"id":"bf46cebb6096ccea5e10bf9348a70f5fe0c9d9fb4544b7e92f2dddb4924d9645","name":"Vendor Codes","tableName":"amazon_vendor_codes","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":true,"description":"Child ASIN this vendor code was uploaded for. Exactly one of child_asin or sku is set."},{"name":"sku","type":"TEXT","nullable":true,"description":"SKU this vendor code was uploaded for. Exactly one of child_asin or sku is set."},{"name":"vendor_code","type":"TEXT","nullable":false,"description":"Vendor code assigned by Amazon for this ASIN or SKU."}],"userManaged":true,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Vendor codes assigned by Amazon, uploaded per ASIN or SKU. Each row has exactly one of child_asin or sku set.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[],"sources":["connections","raw_amazon_vendor_codes"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["vendor code","asin vendor code"]},{"id":"e7d9ab8919024276fa7f14e706889a59126bff5c019e21d6ff9d645ccd566de4","name":"Vendor Listings","tableName":"amazon_vendor_listings","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"vendor_code","type":"TEXT","nullable":false,"description":"Vendor code used to read this listing. A connection can have more than one vendor code."},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":true,"description":"Child ASIN from the listing summary. Null when Amazon has not assigned one."},{"name":"parent_asin","type":"TEXT","nullable":true,"description":"Parent ASIN from the product catalog, when the child ASIN is known."},{"name":"listing_name","type":"TEXT","nullable":true,"description":"Item name from the listing summary."},{"name":"title_differentiation","type":"TEXT","nullable":true,"description":"Item highlight shown in search results, extracted from the listing title_differentiation attribute."},{"name":"amazon_product_type","type":"TEXT","nullable":true,"description":"Amazon product type for the listing."},{"name":"brand","type":"TEXT","nullable":true,"description":"Brand from the listing attributes."},{"name":"model_number","type":"TEXT","nullable":true,"description":"Model number from the listing attributes."},{"name":"external_product_id","type":"TEXT","nullable":true,"description":"External product id from the listing attributes, such as a UPC or EAN. This is not the listing SKU."},{"name":"external_product_id_type","type":"TEXT","nullable":true,"description":"Type of external_product_id, such as upc or ean."},{"name":"main_image_url","type":"TEXT","nullable":true,"description":"Main image link from the listing summary."},{"name":"listing_is_buyable","type":"LOGIC","nullable":true,"description":"True when the listing summary status includes BUYABLE."},{"name":"listing_is_discoverable","type":"LOGIC","nullable":true,"description":"True when the listing summary status includes DISCOVERABLE."},{"name":"listing_created_at","type":"DATE","nullable":true,"description":"When Amazon created the listing."},{"name":"listing_last_updated_at","type":"DATE","nullable":true,"description":"When Amazon last updated the listing. Issue-only changes may not move this timestamp."},{"name":"vendor_cost_price_value","type":"NUMBER","nullable":true,"description":"Unit cost Amazon pays the vendor, from procurement cost price."},{"name":"vendor_cost_price_currency","type":"TEXT","nullable":true,"description":"Currency of vendor_cost_price_value."},{"name":"list_price_value","type":"NUMBER","nullable":true,"description":"List price from the listing attributes, excluding tax."},{"name":"list_price_with_tax_value","type":"NUMBER","nullable":true,"description":"List price from the listing attributes, including tax."},{"name":"list_price_currency","type":"TEXT","nullable":true,"description":"Currency of the list price."},{"name":"issues_error_count","type":"NUMBER","nullable":true,"description":"Number of listing issues with severity ERROR."},{"name":"issues_warning_count","type":"NUMBER","nullable":true,"description":"Number of listing issues with severity WARNING."},{"name":"listing_is_suppressed","type":"LOGIC","nullable":true,"description":"True when a listing issue enforcement action is LISTING_SUPPRESSED."},{"name":"issues","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"relationships","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"attributes","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."},{"name":"cogs_item_value","type":"NUMBER","nullable":true,"description":"Item COGS for this SKU and child ASIN. Zero when no COGS row matches."},{"name":"cogs_shipping_value","type":"NUMBER","nullable":true,"description":"Shipping COGS for this SKU and child ASIN. Zero when no COGS row matches."},{"name":"cogs_total_value","type":"NUMBER","nullable":true,"description":"cogs_item_value plus cogs_shipping_value."},{"name":"cogs_currency","type":"TEXT","nullable":true,"description":"Currency code for COGS."},{"name":"item_current_supplier_name","type":"TEXT","nullable":true,"description":"Current supplier name for the item COGS, if provided in COGS upload. Reflects the latest COGS row for the listing, not a date-effective value."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"When DataDoe last received this listing. Rows older than three days behind the latest sweep for the vendor code are omitted."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Vendor Central listings from the Listings Items API, one row per connection, marketplace, vendor code, and SKU. Cost price is what Amazon pays the vendor. Offers and fulfillment availability are not published for vendors.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_LISTINGS_CREATE","relation":"writes"},{"type":"AMAZON_LISTINGS_UPDATE","relation":"writes"},{"type":"AMAZON_LISTINGS_DETAILS_UPDATE","relation":"writes"},{"type":"AMAZON_LISTINGS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_vendor_listings_items","refined_products_by_child_asin","raw_amazon_cogs"],"containsPii":false,"initialLoadProgress":null},{"id":"38bf00dd3a174c214a8450350ce9ec8cc27e612b2f699575787106f6a21db5b2","name":"Weekly Customer Demand","tableName":"amazon_vendor_forecasting","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code assigned by Amazon, uploaded per ASIN or SKU."},{"name":"start_forecasting_date","type":"TEXT","nullable":false,"description":"Start of the forecast week, stored as STRING YYYY-MM-DD, not DATE."},{"name":"end_forecasting_date","type":"TEXT","nullable":false,"description":"End of the forecast week, stored as STRING YYYY-MM-DD, not DATE."},{"name":"selling_program","type":"TEXT","nullable":false,"description":"The selling program associated with the ASIN. Available values: RETAIL"},{"name":"weekly_forecast_mean_expected_customer_demand_units","type":"NUMBER","nullable":true,"description":"Mean forecasted customer-demand units for the week. Does not include safety stock."},{"name":"weekly_forecast_70_confidence_level_customer_demand_units","type":"NUMBER","nullable":true,"description":"P70 customer-demand units: Amazon estimates demand will be at or below this value 70% of the time. Not a 0–1 probability."},{"name":"weekly_forecast_80_confidence_level_customer_demand_units","type":"NUMBER","nullable":true,"description":"P80 customer-demand units: Amazon estimates demand will be at or below this value 80% of the time. Not a 0–1 probability."},{"name":"weekly_forecast_90_confidence_level_customer_demand_units","type":"NUMBER","nullable":true,"description":"P90 customer-demand units: Amazon estimates demand will be at or below this value 90% of the time. Not a 0–1 probability."},{"name":"date","type":"DATE","nullable":false,"description":"Forecast-generation snapshot date (when DataDoe fetched the report). Filter to MAX(date) per child_asin and forecast week for the latest Amazon forecast."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Weekly forward customer-demand forecast per child ASIN from Amazon Vendor Forecasting. Amazon exposes only the latest forecast per request; DataDoe stores each fetch as a snapshot keyed by date (forecast generation date). Each snapshot has about twelve forward weeks (start_forecasting_date/end_forecasting_date); the same week can appear on multiple dates — filter to MAX(date) per child_asin and week for the current forecast. Rows are not additive across date snapshots.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_report_vendor_forecasting_retail","raw_amazon_vendor_codes"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["customer demand","p70","weekly forecast"]},{"id":"875ac0f7400a8a3932ec8141e6b6c226a156ef2cedf3a1779e8f81781c0dd00a","name":"Sales, Traffic & Inventory by ASIN & Date","tableName":"amazon_vendor_sales_traffic_and_inventory_by_child_and_date","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code assigned by Amazon, uploaded per ASIN or SKU."},{"name":"glance_views","type":"NUMBER","nullable":true,"description":"Glance views where Retail wins the Featured Offer (Buy Box). Manufacturing traffic only; the sourcing view has no glance views. Daily Retail Analytics, not amazon_vendor_real_time_traffic (all detail-page views)."},{"name":"net_pure_product_margin","type":"NUMBER","nullable":true,"description":"Amazon Net Pure Product Margin on these products (Amazon's retail margin). Not the vendor's manufacturing or sourcing margin. Alias of manufacturing_retail_net_ppm — both columns read the same Data Kiosk manufacturing net_ppm value. Do not cross-check them as independent sources."},{"name":"lost_featured_offer","type":"NUMBER","nullable":true,"description":"Share of detail-page views where the vendor offer loses the Featured Offer (Buy Box): lost glance views / total glance views. Manufacturing traffic only."},{"name":"manufacturing_retail_customer_returns","type":"NUMBER","nullable":true,"description":"Manufacturing view. Units customers returned, from the Customer Returns transaction table. Not revenue and not units Amazon returned to the vendor."},{"name":"manufacturing_retail_shipped_cogs","type":"NUMBER","nullable":true,"description":"Manufacturing view. Price Amazon paid the vendor for shipped units. This is Amazon's COGS and the vendor's Amazon revenue, not the vendor's production cost."},{"name":"manufacturing_retail_shipped_cogs_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_shipped_revenue","type":"NUMBER","nullable":true,"description":"Manufacturing view. Amazon customer retail revenue from shipped units. This is Amazon's top line, not the vendor's invoice to Amazon."},{"name":"manufacturing_retail_shipped_revenue_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_shipped_units","type":"NUMBER","nullable":true,"description":"Manufacturing view. Units shipped to Amazon customers. Manufacturing and sourcing views often return the same shippedOrders; do not sum the prefixes."},{"name":"manufacturing_retail_vendor_confirmation_rate","type":"NUMBER","nullable":true,"description":"Manufacturing view. Amazon Data Kiosk Sourcing.vendorConfirmationRate stored as-is for procurable ASINs. FLOAT64 between 0 and 1 (often 0 or 1 on daily rows), not a yes/no flag. Amazon defines it as Confirmed Units / Submitted Units, but that identity does not hold on a daily row; do not recompute from confirmed_units / most_recent_submitted."},{"name":"manufacturing_retail_net_received_inventory_cost","type":"NUMBER","nullable":true,"description":"Manufacturing view. Cost of net purchase-order units received by Amazon in the selected time frame. Same grain as net_received_inventory_units, not confirmed_units."},{"name":"manufacturing_retail_net_received_inventory_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_net_received_inventory_units","type":"NUMBER","nullable":true,"description":"Manufacturing view. Net purchase-order units received by Amazon in the selected time frame after subtracting units returned to the supplier. Not the same grain as confirmed_units; do not divide by confirmed_units to recompute received_fill_rate."},{"name":"manufacturing_retail_open_purchase_order_units","type":"NUMBER","nullable":true,"description":"Manufacturing view. Confirmed purchase-order units Amazon has not received yet. End-of-period snapshot; not additive across days. Not unfilled customer orders (unfilled_customer_ordered_units)."},{"name":"manufacturing_retail_average_vendor_lead_time_days","type":"NUMBER","nullable":true,"description":"Manufacturing view. Days from the vendor receiving a purchase order until Amazon receives the inventory at a fulfillment center (overallVendorLeadTime)."},{"name":"manufacturing_retail_sell_through_rate","type":"NUMBER","nullable":true,"description":"Manufacturing view. Amazon sell-through rate: (shipped units − customer returns) / (sellable on-hand units + net received units). A rate, not a unit count."},{"name":"manufacturing_retail_unfilled_customer_ordered_units","type":"NUMBER","nullable":true,"description":"Customer-ordered units that have not shipped yet. Not open purchase-order units (open_purchase_order_units). Manufacturing view only."},{"name":"manufacturing_retail_sellable_on_hand_inventory_cost","type":"NUMBER","nullable":true,"description":"Manufacturing view. Cost of sellable units in Amazon fulfillment centers on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"manufacturing_retail_sellable_on_hand_inventory_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_sellable_on_hand_inventory_units","type":"NUMBER","nullable":true,"description":"Manufacturing view. Sellable units in Amazon fulfillment centers on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"manufacturing_retail_unsellable_on_hand_inventory_cost","type":"NUMBER","nullable":true,"description":"Manufacturing view. Cost of unsellable units in Amazon fulfillment centers on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"manufacturing_retail_unsellable_on_hand_inventory_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_unsellable_on_hand_inventory_units","type":"NUMBER","nullable":true,"description":"Manufacturing view. Unsellable units in Amazon fulfillment centers on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"manufacturing_retail_aged_90_plus_days_sellable_inventory_cost","type":"NUMBER","nullable":true,"description":"Manufacturing view. Cost of sellable units at least 90 days old on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"manufacturing_retail_aged_90_plus_days_sellable_inventory_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_aged_90_plus_days_sellable_inventory_units","type":"NUMBER","nullable":true,"description":"Manufacturing view. Sellable units at least 90 days old on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"manufacturing_retail_unhealthy_inventory_cost","type":"NUMBER","nullable":true,"description":"Manufacturing view. Cost of excess units versus forecasted demand on the last day of the period. Amazon does not provide this metric for daily selections, so daily rows are often null."},{"name":"manufacturing_retail_unhealthy_inventory_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_unhealthy_inventory_units","type":"NUMBER","nullable":true,"description":"Manufacturing view. Excess units versus forecasted demand on the last day of the period. Amazon does not provide this metric for daily selections, so daily rows are often null."},{"name":"sourcing_retail_customer_returns","type":"NUMBER","nullable":true,"description":"Sourcing view. Units customers returned, from the Customer Returns transaction table. Not revenue and not units Amazon returned to the vendor."},{"name":"sourcing_retail_shipped_cogs","type":"NUMBER","nullable":true,"description":"Sourcing view. Price Amazon paid the vendor for shipped units. This is Amazon's COGS and the vendor's Amazon revenue, not the vendor's production cost."},{"name":"sourcing_retail_shipped_cogs_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_shipped_revenue","type":"NUMBER","nullable":true,"description":"Sourcing view. Amazon customer retail revenue from shipped units. This is Amazon's top line, not the vendor's invoice to Amazon."},{"name":"sourcing_retail_shipped_revenue_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_shipped_units","type":"NUMBER","nullable":true,"description":"Sourcing view. Units shipped to Amazon customers. Manufacturing and sourcing views often return the same shippedOrders; do not sum the prefixes."},{"name":"sourcing_retail_vendor_confirmation_rate","type":"NUMBER","nullable":true,"description":"Sourcing view. Amazon Data Kiosk Sourcing.vendorConfirmationRate stored as-is for procurable ASINs. FLOAT64 between 0 and 1 (often 0 or 1 on daily rows), not a yes/no flag. Amazon defines it as Confirmed Units / Submitted Units, but that identity does not hold on a daily row; do not recompute from confirmed_units / most_recent_submitted."},{"name":"sourcing_retail_net_received_inventory_cost","type":"NUMBER","nullable":true,"description":"Sourcing view. Cost of net purchase-order units received by Amazon in the selected time frame. Same grain as net_received_inventory_units, not confirmed_units."},{"name":"sourcing_retail_net_received_inventory_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_net_received_inventory_units","type":"NUMBER","nullable":true,"description":"Sourcing view. Net purchase-order units received by Amazon in the selected time frame after subtracting units returned to the supplier. Not the same grain as confirmed_units; do not divide by confirmed_units to recompute received_fill_rate."},{"name":"sourcing_retail_open_purchase_order_units","type":"NUMBER","nullable":true,"description":"Sourcing view. Confirmed purchase-order units Amazon has not received yet. End-of-period snapshot; not additive across days. Not unfilled customer orders (unfilled_customer_ordered_units)."},{"name":"sourcing_retail_average_vendor_lead_time_days","type":"NUMBER","nullable":true,"description":"Sourcing view. Days from the vendor receiving a purchase order until Amazon receives the inventory at a fulfillment center (overallVendorLeadTime)."},{"name":"sourcing_retail_sell_through_rate","type":"NUMBER","nullable":true,"description":"Sourcing view. Amazon sell-through rate: (shipped units − customer returns) / (sellable on-hand units + net received units). A rate, not a unit count."},{"name":"sourcing_retail_sellable_on_hand_inventory_cost","type":"NUMBER","nullable":true,"description":"Sourcing view. Cost of sellable units in Amazon fulfillment centers on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"sourcing_retail_sellable_on_hand_inventory_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_sellable_on_hand_inventory_units","type":"NUMBER","nullable":true,"description":"Sourcing view. Sellable units in Amazon fulfillment centers on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"sourcing_retail_unsellable_on_hand_inventory_cost","type":"NUMBER","nullable":true,"description":"Sourcing view. Cost of unsellable units in Amazon fulfillment centers on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"sourcing_retail_unsellable_on_hand_inventory_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_unsellable_on_hand_inventory_units","type":"NUMBER","nullable":true,"description":"Sourcing view. Unsellable units in Amazon fulfillment centers on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"sourcing_retail_aged_90_plus_days_sellable_inventory_cost","type":"NUMBER","nullable":true,"description":"Sourcing view. Cost of sellable units at least 90 days old on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"sourcing_retail_aged_90_plus_days_sellable_inventory_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_aged_90_plus_days_sellable_inventory_units","type":"NUMBER","nullable":true,"description":"Sourcing view. Sellable units at least 90 days old on the last day of the period. End-of-period snapshot in Amazon fulfillment centers. Not additive across days."},{"name":"sourcing_retail_unhealthy_inventory_cost","type":"NUMBER","nullable":true,"description":"Sourcing view. Cost of excess units versus forecasted demand on the last day of the period. Amazon does not provide this metric for daily selections, so daily rows are often null."},{"name":"sourcing_retail_unhealthy_inventory_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_unhealthy_inventory_units","type":"NUMBER","nullable":true,"description":"Sourcing view. Excess units versus forecasted demand on the last day of the period. Amazon does not provide this metric for daily selections, so daily rows are often null."},{"name":"manufacturing_retail_average_selling_price_amount","type":"NUMBER","nullable":true,"description":"Manufacturing view. Average selling price of shipped items excluding sales tax and VAT (shipped revenue / shipped units). Amazon customer price, not the price Amazon pays the vendor."},{"name":"manufacturing_retail_average_selling_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_sales_discount_amount","type":"NUMBER","nullable":true,"description":"Manufacturing view. Amazon checkout promotions on shipped units (promo codes, gift cards, employee discount, bounceback, loyalty). Not amazon_coupon_performance or amazon_promotion_performance."},{"name":"manufacturing_retail_sales_discount_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_average_sales_discount_amount","type":"NUMBER","nullable":true,"description":"Manufacturing view. Sales discount divided by shipped quantity. Same Amazon checkout promotions as sales_discount_amount."},{"name":"manufacturing_retail_average_sales_discount_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_contra_cogs_amount","type":"NUMBER","nullable":true,"description":"Manufacturing view. Amazon Vendor-Funded Contra-COGS (vendor terms such as co-op). Retail Analytics reports this as an Amazon estimate, not actual remittance deductions."},{"name":"manufacturing_retail_contra_cogs_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_contra_cogs_per_unit_amount","type":"NUMBER","nullable":true,"description":"Manufacturing view. Estimated contra-COGS per shipped unit. Amazon Retail Analytics estimate, not actual remittance deductions."},{"name":"manufacturing_retail_contra_cogs_per_unit_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_net_ppm","type":"NUMBER","nullable":true,"description":"Manufacturing view. Amazon Net Pure Product Margin on these products, not the vendor's own margin. Net PPM = (shipped revenue - shipped COGS + contra-COGS - sales discount) / shipped revenue. Contra-COGS in this formula is an Amazon estimate. On this table, manufacturing_retail_net_ppm is identical to net_pure_product_margin."},{"name":"manufacturing_retail_net_ordered_gms_amount","type":"NUMBER","nullable":true,"description":"Net gross merchandise sales for customer orders on this day. Manufacturing orders view only."},{"name":"manufacturing_retail_net_ordered_gms_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_net_shipment_gms_amount","type":"NUMBER","nullable":true,"description":"Net gross merchandise sales for units shipped on this day. Manufacturing orders view only."},{"name":"manufacturing_retail_net_shipment_gms_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_ordered_units","type":"NUMBER","nullable":true,"description":"Units ordered by Amazon customers (retail demand), with return and cancellation adjustments. Not Amazon-to-vendor purchase-order quantity; that is amazon_vendor_purchase_orders.ordered_quantity. Manufacturing view only."},{"name":"manufacturing_retail_ordered_revenue_amount","type":"NUMBER","nullable":true,"description":"Revenue from units ordered by Amazon customers (OPS = product price × ordered units), with return and cancellation adjustments. Not purchase-order value. Manufacturing view only."},{"name":"manufacturing_retail_ordered_revenue_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_retail_ultra_fast_track","type":"NUMBER","nullable":true,"description":"Manufacturing view. Ultra Fast Track: share of time the ASIN was available to ship Prime from a fulfillment center versus the selection Amazon intended, weighted by customer importance. An availability rate, not a unit count."},{"name":"manufacturing_retail_sourceable_roos","type":"NUMBER","nullable":true,"description":"Manufacturing view. Sourceable replenishment out-of-stock (sourceableROOS). Amazon describes it as the percentage of retail available for ASINs with a sourceable retail vendor. A rate, not a unit count."},{"name":"manufacturing_retail_sellable_in_transit_inventory","type":"NUMBER","nullable":true,"description":"Manufacturing view. Sellable units in transit to Amazon at the end of the period. Snapshot, not additive across days."},{"name":"manufacturing_retail_unsellable_in_transit_inventory","type":"NUMBER","nullable":true,"description":"Manufacturing view. Unsellable units in transit to Amazon at the end of the period. Snapshot, not additive across days."},{"name":"manufacturing_retail_received_fill_rate","type":"NUMBER","nullable":true,"description":"Manufacturing view. Amazon Data Kiosk Sourcing.receivedFillRate stored as-is for procurable ASINs. Amazon defines Fill Rate as Net Received Units / Confirmed Units, but that identity does not hold on a daily row: net_received_inventory_units is receipts in the selected time frame, confirmed_units has no selected time frame, and this column is Amazon's own number — not same-row received/confirmed. Do not recompute from other columns."},{"name":"manufacturing_retail_procurable_product_oos","type":"NUMBER","nullable":true,"description":"Manufacturing view. Procurable product out-of-stock (procurableProductOOS): out-of-stock glance views on procurable ASINs divided by total glance views. Procurable means Amazon can promise delivery from known vendor supply. A rate, not a unit count."},{"name":"manufacturing_retail_confirmed_units","type":"NUMBER","nullable":true,"description":"Manufacturing view. Purchase-order units confirmed by the vendor. Amazon does not apply a selected time frame to this metric. Conceptual input to vendor_confirmation_rate and received_fill_rate; those rates are Amazon-provided and are not same-row arithmetic on a daily row."},{"name":"manufacturing_retail_most_recent_submitted","type":"NUMBER","nullable":true,"description":"Manufacturing view. Units Amazon ordered in the most recent purchase orders of the week (Data Kiosk mostRecentSubmitted). Conceptual denominator for vendor_confirmation_rate; do not treat vendor_confirmation_rate as same-row confirmed_units / most_recent_submitted."},{"name":"sourcing_retail_average_selling_price_amount","type":"NUMBER","nullable":true,"description":"Sourcing view. Average selling price of shipped items excluding sales tax and VAT (shipped revenue / shipped units). Amazon customer price, not the price Amazon pays the vendor."},{"name":"sourcing_retail_average_selling_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_sales_discount_amount","type":"NUMBER","nullable":true,"description":"Sourcing view. Amazon checkout promotions on shipped units (promo codes, gift cards, employee discount, bounceback, loyalty). Not amazon_coupon_performance or amazon_promotion_performance."},{"name":"sourcing_retail_sales_discount_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_average_sales_discount_amount","type":"NUMBER","nullable":true,"description":"Sourcing view. Sales discount divided by shipped quantity. Same Amazon checkout promotions as sales_discount_amount."},{"name":"sourcing_retail_average_sales_discount_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_contra_cogs_amount","type":"NUMBER","nullable":true,"description":"Sourcing view. Amazon Vendor-Funded Contra-COGS (vendor terms such as co-op). Retail Analytics reports this as an Amazon estimate, not actual remittance deductions."},{"name":"sourcing_retail_contra_cogs_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_contra_cogs_per_unit_amount","type":"NUMBER","nullable":true,"description":"Sourcing view. Estimated contra-COGS per shipped unit. Amazon Retail Analytics estimate, not actual remittance deductions."},{"name":"sourcing_retail_contra_cogs_per_unit_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_retail_net_ppm","type":"NUMBER","nullable":true,"description":"Sourcing view. Amazon Net Pure Product Margin on these products, not the vendor's own margin. Net PPM = (shipped revenue - shipped COGS + contra-COGS - sales discount) / shipped revenue. Contra-COGS in this formula is an Amazon estimate. On this table, manufacturing_retail_net_ppm is identical to net_pure_product_margin."},{"name":"sourcing_retail_ultra_fast_track","type":"NUMBER","nullable":true,"description":"Sourcing view. Ultra Fast Track: share of time the ASIN was available to ship Prime from a fulfillment center versus the selection Amazon intended, weighted by customer importance. An availability rate, not a unit count."},{"name":"sourcing_retail_sourceable_roos","type":"NUMBER","nullable":true,"description":"Sourcing view. Sourceable replenishment out-of-stock (sourceableROOS). Amazon describes it as the percentage of retail available for ASINs with a sourceable retail vendor. A rate, not a unit count."},{"name":"sourcing_retail_sellable_in_transit_inventory","type":"NUMBER","nullable":true,"description":"Sourcing view. Sellable units in transit to Amazon at the end of the period. Snapshot, not additive across days."},{"name":"sourcing_retail_unsellable_in_transit_inventory","type":"NUMBER","nullable":true,"description":"Sourcing view. Unsellable units in transit to Amazon at the end of the period. Snapshot, not additive across days."},{"name":"sourcing_retail_received_fill_rate","type":"NUMBER","nullable":true,"description":"Sourcing view. Amazon Data Kiosk Sourcing.receivedFillRate stored as-is for procurable ASINs. Amazon defines Fill Rate as Net Received Units / Confirmed Units, but that identity does not hold on a daily row: net_received_inventory_units is receipts in the selected time frame, confirmed_units has no selected time frame, and this column is Amazon's own number — not same-row received/confirmed. Do not recompute from other columns."},{"name":"sourcing_retail_procurable_product_oos","type":"NUMBER","nullable":true,"description":"Sourcing view. Procurable product out-of-stock (procurableProductOOS): out-of-stock glance views on procurable ASINs divided by total glance views. Procurable means Amazon can promise delivery from known vendor supply. A rate, not a unit count."},{"name":"sourcing_retail_confirmed_units","type":"NUMBER","nullable":true,"description":"Sourcing view. Purchase-order units confirmed by the vendor. Amazon does not apply a selected time frame to this metric. Conceptual input to vendor_confirmation_rate and received_fill_rate; those rates are Amazon-provided and are not same-row arithmetic on a daily row."},{"name":"sourcing_retail_most_recent_submitted","type":"NUMBER","nullable":true,"description":"Sourcing view. Units Amazon ordered in the most recent purchase orders of the week (Data Kiosk mostRecentSubmitted). Conceptual denominator for vendor_confirmation_rate; do not treat vendor_confirmation_rate as same-row confirmed_units / most_recent_submitted."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Daily sales, traffic and inventory metrics per child ASIN. Columns prefixed manufacturing_retail_ are Amazon manufacturing-view metrics for all ASINs the vendor manufactures. Columns prefixed sourcing_retail_ are Amazon sourcing-view metrics for ASINs this vendor sourced directly to Amazon (distributor view). DataDoe fetches both views and joins them onto one ASIN-day; the prefixes are overlapping views, not two independent facts and not additive — never sum them or revenue and units double-count. Shipped units/revenue often match because Amazon returns the same shippedOrders in both views; matching is expected, not a copied row. Ordered units/revenue exist only under manufacturing. Contra-COGS is typically populated only under sourcing. Use manufacturing_retail_ for glance views, customer-ordered units/revenue (retail demand, not purchase orders), and net PPM. Use sourcing_retail_ for purchase-order fill metrics (vendor_confirmation_rate, received_fill_rate) and contra-COGS. Amazon-to-vendor purchase-order quantity is amazon_vendor_purchase_orders.ordered_quantity. Either prefix alone is valid for shipped revenue/COGS — pick one view per analysis, not both. Shipped COGS, shipped revenue, contra-COGS, and Net PPM measure Amazon retail economics, not the vendor's own product margin. net_pure_product_margin is a convenience alias of manufacturing_retail_net_ppm (both read manufacturing net_ppm); do not cross-check them as independent series. On-hand, aged, unhealthy, in-transit, and open purchase-order units are end-of-period snapshots and are not additive across days.","requiresDatePeriod":true,"issues":[{"title":"Daily inventory and open purchase-order units are snapshots","description":"Do not sum on-hand, aged, unhealthy, in-transit, or open purchase-order units across dates. For a monthly balance, use the latest available date in the month, then aggregate across ASINs if needed."}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":720,"shiftDays":4},{"type":"RECURRING_DAILY","numberOfDays":14,"shiftDays":4}],"sources":["connections","raw_sp_api_dk_vendor_analytics_manufacturing","raw_sp_api_dk_vendor_analytics_sourcing","raw_sp_api_dk_vendor_product_availability_manufacturing","raw_sp_api_dk_vendor_product_availability_sourcing","raw_amazon_vendor_codes"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["pos","vendor sales","vendor traffic","net ppm","glance views"]},{"id":"6deb661209df982eaba69d8624bbd9b31d112a67163fc45f02bb3bc1958a9ca7","name":"Real-Time Sales by ASIN & Hour","tableName":"amazon_vendor_real_time_sales","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"asin","type":"TEXT","nullable":false,"description":null},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code assigned by Amazon, uploaded per ASIN or SKU."},{"name":"start_time","type":"DATE","nullable":false,"description":"Start of the hourly reporting window."},{"name":"end_time","type":"DATE","nullable":false,"description":"End of the hourly reporting window."},{"name":"date","type":"DATE","nullable":false,"description":"UTC calendar day of start_time. Use for date filtering."},{"name":"ordered_units","type":"NUMBER","nullable":false,"description":"Units ordered by Amazon customers in this hour. Not Amazon-to-vendor purchase-order quantity."},{"name":"ordered_revenue","type":"NUMBER","nullable":false,"description":"Revenue from units ordered by Amazon customers in this hour. Not purchase-order value."},{"name":"ordered_revenue_currency","type":"TEXT","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Hourly units and revenue ordered by Amazon customers per ASIN (GET_VENDOR_REAL_TIME_SALES_REPORT). Not Amazon-to-vendor purchase-order quantity. Not the daily manufacturing_retail_ordered_units series.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":28,"shiftDays":4},{"type":"RECURRING_DAILY","numberOfDays":3,"shiftDays":4},{"type":"RECURRING_MONTHLY","numberOfDays":28,"shiftDays":4}],"sources":["connections","raw_sp_api_report_vendor_real_time_sales","raw_amazon_vendor_codes"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["pos","vendor sales","hourly sales"]},{"id":"25b8d04247fe4b4c096d3f58bbb577fd41c23c4c9da93bd232134a468c2fde9d","name":"Real-Time Traffic by ASIN & Hour","tableName":"amazon_vendor_real_time_traffic","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"asin","type":"TEXT","nullable":false,"description":null},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code assigned by Amazon, uploaded per ASIN or SKU."},{"name":"start_time","type":"DATE","nullable":false,"description":"Start of the hourly reporting window."},{"name":"end_time","type":"DATE","nullable":false,"description":"End of the hourly reporting window."},{"name":"date","type":"DATE","nullable":false,"description":"UTC calendar day of start_time. Use for date filtering."},{"name":"glance_views","type":"NUMBER","nullable":false,"description":"Customer views of the ASIN detail page in this hour. Not daily glance_views, which count only Featured Offer (Buy Box) wins."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Hourly detail-page views per ASIN (GET_VENDOR_REAL_TIME_TRAFFIC_REPORT). All customer views of the detail page, not the daily glance_views column (Featured Offer wins only).","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":28,"shiftDays":4},{"type":"RECURRING_DAILY","numberOfDays":3,"shiftDays":4},{"type":"RECURRING_MONTHLY","numberOfDays":28,"shiftDays":4}],"sources":["connections","raw_sp_api_report_vendor_real_time_traffic","raw_amazon_vendor_codes"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["glance views","hourly traffic"]},{"id":"a56e22527075e070599d6d314d30eba4a0ad7474192df1b61ce74ba424d19b7f","name":"Real-Time Inventory by ASIN & Hour","tableName":"amazon_vendor_real_time_inventory","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"asin","type":"TEXT","nullable":false,"description":null},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code assigned by Amazon, uploaded per ASIN or SKU."},{"name":"start_time","type":"DATE","nullable":false,"description":"Start of the hourly reporting window."},{"name":"end_time","type":"DATE","nullable":false,"description":"End of the hourly reporting window."},{"name":"date","type":"DATE","nullable":false,"description":"UTC calendar day of start_time. Use for date filtering."},{"name":"highly_available_inventory_units","type":"NUMBER","nullable":false,"description":"Units available to sell: sellable units in Amazon fulfillment centers minus units in carts or otherwise bound (for example known Subscribe & Save). Not sellable_on_hand_inventory_units."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Hourly highly available inventory per ASIN (GET_VENDOR_REAL_TIME_INVENTORY_REPORT). Units Amazon can still sell, not on-hand sellable inventory from the daily table.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":28,"shiftDays":4},{"type":"RECURRING_DAILY","numberOfDays":3,"shiftDays":4},{"type":"RECURRING_MONTHLY","numberOfDays":28,"shiftDays":4}],"sources":["connections","raw_sp_api_report_vendor_real_time_inventory","raw_amazon_vendor_codes"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["vendor inventory","highly available"]},{"id":"42ec2de94b0a2f37d37649cef2ce1c458d348cac50c76c1e1dc7011deba88c9e","name":"Vendor Direct Fulfillment Orders","tableName":"amazon_vendor_df_orders","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":true,"description":"Calendar day of the Direct Fulfillment order date (orderDate)."},{"name":"purchase_order_number","type":"TEXT","nullable":false,"description":"Amazon Direct Fulfillment purchase order number."},{"name":"item_sequence_number","type":"TEXT","nullable":false,"description":"Line number within the purchase order. Grain key with purchase_order_number."},{"name":"customer_order_number","type":"TEXT","nullable":true,"description":"Shopper's Amazon order id. Not purchase_order_number."},{"name":"order_status","type":"TEXT","nullable":true,"description":"Amazon orderStatus: NEW, SHIPPED, ACCEPTED, or CANCELLED."},{"name":"ship_method","type":"TEXT","nullable":true,"description":"Ship method name Amazon assigned for this order."},{"name":"is_priority_shipment","type":"LOGIC","nullable":true,"description":"Amazon flagged this order as a priority shipment."},{"name":"is_scheduled_delivery_shipment","type":"LOGIC","nullable":true,"description":"Amazon flagged this order as a scheduled-delivery shipment."},{"name":"is_pslip_required","type":"LOGIC","nullable":true,"description":"A packing slip must ship with the order."},{"name":"is_gift","type":"LOGIC","nullable":true,"description":"The order contains a gift."},{"name":"has_customizable_items","type":"LOGIC","nullable":true,"description":"The order contains customizable items."},{"name":"required_ship_date","type":"DATE","nullable":true,"description":"Latest time the vendor must ship the order."},{"name":"promised_delivery_date","type":"DATE","nullable":true,"description":"Delivery time Amazon promised the customer."},{"name":"selling_party_id","type":"TEXT","nullable":true,"description":"Vendor party id Amazon assigned on the order."},{"name":"ship_from_party_id","type":"TEXT","nullable":true,"description":"Warehouse party id the vendor ships from."},{"name":"bill_to_party_id","type":"TEXT","nullable":true,"description":"Amazon bill-to party id."},{"name":"order_tax_total_amount","type":"NUMBER","nullable":true,"description":null},{"name":"order_tax_total_currency","type":"TEXT","nullable":true,"description":null},{"name":"asin","type":"TEXT","nullable":true,"description":null},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code assigned by Amazon, uploaded per ASIN or SKU."},{"name":"vendor_product_identifier","type":"TEXT","nullable":true,"description":null},{"name":"title","type":"TEXT","nullable":true,"description":null},{"name":"ordered_quantity","type":"NUMBER","nullable":true,"description":"Units the customer ordered on this Direct Fulfillment line. Not amazon_vendor_purchase_orders.ordered_quantity (often Cases)."},{"name":"ordered_quantity_unit_of_measure","type":"TEXT","nullable":true,"description":"Unit of measure for ordered_quantity, usually Each."},{"name":"net_price_amount","type":"NUMBER","nullable":true,"description":"Price Amazon pays the vendor per unit. Not the customer price."},{"name":"net_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"total_price_amount","type":"NUMBER","nullable":true,"description":"Line amount Amazon pays the vendor (net price × ordered quantity)."},{"name":"total_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"item_tax_amount","type":"NUMBER","nullable":true,"description":null},{"name":"item_tax_currency","type":"TEXT","nullable":true,"description":null},{"name":"gift_wrap_id","type":"TEXT","nullable":true,"description":null},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last received this row from the Vendor API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Vendor Direct Fulfillment order line items (vendor ships to the customer). One row per line item with order header fields repeated. purchase_order_number is the DF purchase order; customer_order_number is the shopper order.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":30},{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"Orders are available up to 1 hour after being placed.","refreshAt":"10am, 1pm, 4pm, 7pm"},"sources":["connections","raw_sp_api_vendor_df_orders","raw_amazon_vendor_codes"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["direct fulfillment","df orders"]},{"id":"792f66c5f986e44bdc7b530f98d1fc3ce3d7c62dcaa8f24b1c028620fdaed265","name":"Vendor Direct Fulfillment Orders PII","tableName":"amazon_vendor_df_orders_pii","type":"VENDOR_CENTRAL","columns":[{"name":"date","type":"DATE","nullable":false,"description":"Calendar day of the Direct Fulfillment order date (orderDate)."},{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"purchase_order_number","type":"TEXT","nullable":false,"description":"Direct Fulfillment purchase order number. Join key to amazon_vendor_df_orders."},{"name":"data_fetched_at","type":"DATE","nullable":true,"description":"When DataDoe fetched this PII payload."},{"name":"recipient_name","type":"TEXT","nullable":true,"description":null},{"name":"recipient_attention","type":"TEXT","nullable":true,"description":null},{"name":"recipient_address_line1","type":"TEXT","nullable":true,"description":null},{"name":"recipient_address_line2","type":"TEXT","nullable":true,"description":null},{"name":"recipient_address_line3","type":"TEXT","nullable":true,"description":null},{"name":"recipient_city","type":"TEXT","nullable":true,"description":null},{"name":"recipient_county","type":"TEXT","nullable":true,"description":null},{"name":"recipient_district","type":"TEXT","nullable":true,"description":null},{"name":"recipient_state_or_region","type":"TEXT","nullable":true,"description":null},{"name":"recipient_postal_code","type":"TEXT","nullable":true,"description":null},{"name":"recipient_country_code","type":"TEXT","nullable":true,"description":null},{"name":"recipient_phone","type":"TEXT","nullable":true,"description":null},{"name":"message_to_customer","type":"TEXT","nullable":true,"description":null},{"name":"order_items_gift_messages","type":"JSON","nullable":true,"description":"Gift messages keyed by line item. JSON, not a single string."},{"name":"order_items_customized_urls","type":"JSON","nullable":true,"description":"Customization URLs keyed by line item. JSON, not a single string."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Vendor Direct Fulfillment customer and shipping PII. One row per purchase order. Join amazon_vendor_df_orders on purchase_order_number. Restricted and off by default.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":30},{"type":"CONTINUOUS"}],"dataAvailability":{"type":"REAL_TIME","description":"Data is available up to 1 hour after the order is fetched."},"sources":["connections","raw_sp_api_vendor_df_orders_pii"],"containsPii":true,"initialLoadProgress":null,"searchAliases":["direct fulfillment pii","shipping address"]},{"id":"6f9b8159d659a68c2274cdf881f4c18cdbf917e32a0b853f6b01ed7f106e4a06","name":"Vendor Purchase Orders","tableName":"amazon_vendor_purchase_orders","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":true,"description":"Calendar day of purchase_order_date. Use for date filtering."},{"name":"purchase_order_number","type":"TEXT","nullable":false,"description":null},{"name":"item_sequence_number","type":"TEXT","nullable":false,"description":"Line number within the purchase order. Grain key with purchase_order_number."},{"name":"purchase_order_state","type":"TEXT","nullable":true,"description":"Amazon purchaseOrderState: New, Acknowledged, or Closed."},{"name":"purchase_order_type","type":"TEXT","nullable":true,"description":"Amazon purchaseOrderType: RegularOrder, ConsignedOrder, NewProductIntroduction, or RushOrder."},{"name":"payment_method","type":"TEXT","nullable":true,"description":"Amazon paymentMethod: Invoice, Consignment, CreditCard, or Prepaid."},{"name":"deal_code","type":"TEXT","nullable":true,"description":"Deal code when the purchase order is tied to a special deal."},{"name":"purchase_order_date","type":"DATE","nullable":true,"description":"When Amazon created the purchase order."},{"name":"purchase_order_changed_date","type":"DATE","nullable":true,"description":"When Amazon last changed the purchase order."},{"name":"purchase_order_state_changed_date","type":"DATE","nullable":true,"description":"When purchase_order_state last changed."},{"name":"ship_window","type":"TEXT","nullable":true,"description":"Amazon ship window as start--end timestamps. The vendor must ship inside this window. Not a single date."},{"name":"delivery_window","type":"TEXT","nullable":true,"description":"Amazon delivery window as start--end timestamps. Not a single date and not ship_window."},{"name":"selling_party_id","type":"TEXT","nullable":true,"description":"Vendor party id."},{"name":"buying_party_id","type":"TEXT","nullable":true,"description":"Amazon buying party id."},{"name":"ship_to_party_id","type":"TEXT","nullable":true,"description":"Amazon fulfillment center the vendor ships to."},{"name":"bill_to_party_id","type":"TEXT","nullable":true,"description":"Amazon bill-to party id."},{"name":"asin","type":"TEXT","nullable":true,"description":null},{"name":"vendor_product_identifier","type":"TEXT","nullable":true,"description":null},{"name":"ordered_quantity","type":"NUMBER","nullable":true,"description":"Quantity Amazon ordered from the vendor on this purchase-order line. Not customer retail demand; that is manufacturing_retail_ordered_units. Read with ordered_quantity_unit_of_measure (often Cases) and ordered_quantity_unit_size."},{"name":"ordered_quantity_unit_of_measure","type":"TEXT","nullable":true,"description":"Unit of measure for ordered_quantity, such as Cases or Eaches. Do not sum Cases with customer-ordered units."},{"name":"ordered_quantity_unit_size","type":"NUMBER","nullable":true,"description":"Case size when ordered_quantity_unit_of_measure is Cases."},{"name":"is_back_order_allowed","type":"LOGIC","nullable":true,"description":"Amazon allows the vendor to backorder this line."},{"name":"net_cost_amount","type":"NUMBER","nullable":true,"description":"Cost Amazon pays the vendor per unit. Not list_price_amount."},{"name":"net_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"list_price_amount","type":"NUMBER","nullable":true,"description":"List price on the purchase order. Not the net cost Amazon pays."},{"name":"list_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last received this row from the Vendor API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Vendor Retail Procurement purchase order line items. One row per line item with purchase order header fields repeated. ordered_quantity is Amazon-to-vendor PO quantity, not customer retail demand (manufacturing_retail_ordered_units). Acknowledgement and Amazon fulfillment-center received quantity are on amazon_vendor_purchase_orders_status.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":30},{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_vendor_purchase_orders"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["purchase order","po quantity"]},{"id":"0da50243561a87284b103b3a527f88eed9048e306c86ed6a0114933717af9ad7","name":"Vendor Purchase Order Status","tableName":"amazon_vendor_purchase_orders_status","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"date","type":"DATE","nullable":true,"description":"Calendar day of purchase_order_date. Use for date filtering."},{"name":"purchase_order_number","type":"TEXT","nullable":false,"description":"Amazon Retail Procurement purchase order number. Join amazon_vendor_purchase_orders on purchase_order_number and item_sequence_number."},{"name":"item_sequence_number","type":"TEXT","nullable":false,"description":"Line number within the purchase order. The first line is 1. Grain key with purchase_order_number."},{"name":"purchase_order_status","type":"TEXT","nullable":true,"description":"Amazon purchaseOrderStatus: OPEN (Amazon has not received every unit) or CLOSED (Amazon has received every unit). Not purchase_order_state on amazon_vendor_purchase_orders."},{"name":"purchase_order_date","type":"DATE","nullable":true,"description":"When Amazon placed the purchase order."},{"name":"last_updated_date","type":"DATE","nullable":true,"description":"When Amazon last updated this purchase order status."},{"name":"selling_party_id","type":"TEXT","nullable":true,"description":"Vendor party id."},{"name":"ship_to_party_id","type":"TEXT","nullable":true,"description":"Amazon fulfillment center the vendor ships to."},{"name":"asin","type":"TEXT","nullable":true,"description":"Buyer product identifier (ASIN)."},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code assigned by Amazon, uploaded per ASIN or SKU."},{"name":"vendor_product_identifier","type":"TEXT","nullable":true,"description":"Vendor-selected product identifier for the line."},{"name":"net_cost_amount","type":"NUMBER","nullable":true,"description":"Net cost Amazon pays the vendor per each or weight unit. Not list_price_amount."},{"name":"net_cost_currency","type":"TEXT","nullable":true,"description":null},{"name":"list_price_amount","type":"NUMBER","nullable":true,"description":"List price per each or weight unit. Not the net cost Amazon pays."},{"name":"list_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"ordered_quantity","type":"NUMBER","nullable":true,"description":"Quantity Amazon ordered from the vendor on this line. Not customer retail demand; that is manufacturing_retail_ordered_units. Read with ordered_quantity_unit_of_measure (often Cases) and ordered_quantity_unit_size. Not received_quantity."},{"name":"ordered_quantity_unit_of_measure","type":"TEXT","nullable":true,"description":"Unit of measure for ordered_quantity, such as Cases or Eaches. Do not sum Cases with customer-ordered units."},{"name":"ordered_quantity_unit_size","type":"NUMBER","nullable":true,"description":"Case size when ordered_quantity_unit_of_measure is Cases."},{"name":"ordered_quantity_details","type":"JSON","nullable":true,"description":"History of ordered and cancelled quantity for this line. Nested JSON, not the current ordered_quantity."},{"name":"confirmation_status","type":"TEXT","nullable":true,"description":"Vendor acknowledgement confirmationStatus: ACCEPTED, PARTIALLY_ACCEPTED, REJECTED, or UNCONFIRMED. Not purchase_order_status."},{"name":"accepted_quantity","type":"NUMBER","nullable":true,"description":"Quantity the vendor accepted to ship. Read with accepted_quantity_unit_of_measure. Not ordered_quantity or received_quantity."},{"name":"accepted_quantity_unit_of_measure","type":"TEXT","nullable":true,"description":"Unit of measure for accepted_quantity, such as Cases or Eaches."},{"name":"accepted_quantity_unit_size","type":"NUMBER","nullable":true,"description":"Case size when accepted_quantity_unit_of_measure is Cases."},{"name":"rejected_quantity","type":"NUMBER","nullable":true,"description":"Quantity the vendor rejected. Read with rejected_quantity_unit_of_measure."},{"name":"rejected_quantity_unit_of_measure","type":"TEXT","nullable":true,"description":"Unit of measure for rejected_quantity, such as Cases or Eaches."},{"name":"rejected_quantity_unit_size","type":"NUMBER","nullable":true,"description":"Case size when rejected_quantity_unit_of_measure is Cases."},{"name":"acknowledgement_status_details","type":"JSON","nullable":true,"description":"History of confirmed quantity for this line. Nested JSON, not only confirmation_status."},{"name":"receive_status","type":"TEXT","nullable":true,"description":"Amazon fulfillment-center receiveStatus: NOT_RECEIVED, PARTIALLY_RECEIVED, or RECEIVED."},{"name":"received_quantity","type":"NUMBER","nullable":true,"description":"Total quantity the Amazon fulfillment center has received so far. Read with received_quantity_unit_of_measure. Not ordered_quantity, accepted_quantity, or Retail Analytics net_received_inventory_units."},{"name":"received_quantity_unit_of_measure","type":"TEXT","nullable":true,"description":"Unit of measure for received_quantity, such as Cases or Eaches."},{"name":"received_quantity_unit_size","type":"NUMBER","nullable":true,"description":"Case size when received_quantity_unit_of_measure is Cases."},{"name":"last_receive_date","type":"DATE","nullable":true,"description":"When the Amazon fulfillment center last received units for this line."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last received this row from the Vendor API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Vendor Retail Procurement purchase order item status (getPurchaseOrdersStatus). One row per line item, same grain as amazon_vendor_purchase_orders (purchase_order_number and item_sequence_number). Holds vendor acknowledgement and Amazon fulfillment-center receiving. ordered_quantity is Amazon-to-vendor PO quantity, not customer retail demand (manufacturing_retail_ordered_units). Rows appear after the matching purchase order is synced.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":30},{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_vendor_purchase_orders_status","raw_amazon_vendor_codes"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["po status","received quantity","acknowledgement"]},{"id":"01ad15aa5f4d263147296c1eea1d99e68ea655854b60d567423d921ab2875b42","name":"Vendor Shipments","tableName":"amazon_vendor_shipments","type":"VENDOR_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"vendor_shipment_identifier","type":"TEXT","nullable":false,"description":"Vendor's shipment id. Grain of this table."},{"name":"transaction_type","type":"TEXT","nullable":true,"description":"Amazon transactionType: New or Cancel."},{"name":"buyer_reference_number","type":"TEXT","nullable":true,"description":"Amazon Reference Number (ARN) when Amazon assigned one."},{"name":"transaction_date","type":"DATE","nullable":true,"description":"When this shipment transaction was submitted."},{"name":"current_shipment_status","type":"TEXT","nullable":true,"description":"Amazon currentShipmentStatus: Created, TransportationRequested, CarrierAssigned, or Shipped."},{"name":"current_shipment_status_date","type":"DATE","nullable":true,"description":"When current_shipment_status was set."},{"name":"shipment_create_date","type":"DATE","nullable":true,"description":null},{"name":"shipment_confirm_date","type":"DATE","nullable":true,"description":null},{"name":"package_label_create_date","type":"DATE","nullable":true,"description":null},{"name":"shipment_freight_term","type":"TEXT","nullable":true,"description":"Amazon shipmentFreightTerm: Collect (WePay) or Prepaid."},{"name":"selling_party_id","type":"TEXT","nullable":true,"description":"Vendor party id."},{"name":"ship_from_party_id","type":"TEXT","nullable":true,"description":"Warehouse party id the vendor ships from."},{"name":"ship_to_party_id","type":"TEXT","nullable":true,"description":"Amazon fulfillment center this shipment goes to."},{"name":"ship_mode","type":"TEXT","nullable":true,"description":"How the freight is packed: SmallParcel, LTL, or TL. Not transportation_mode."},{"name":"transportation_mode","type":"TEXT","nullable":true,"description":"How the freight moves: Road, Air, or Ocean. Not ship_mode."},{"name":"shipped_date","type":"DATE","nullable":true,"description":null},{"name":"estimated_delivery_date","type":"DATE","nullable":true,"description":null},{"name":"shipment_delivery_date","type":"DATE","nullable":true,"description":null},{"name":"bill_of_lading_number","type":"TEXT","nullable":true,"description":null},{"name":"carrier_name","type":"TEXT","nullable":true,"description":null},{"name":"carrier_code","type":"TEXT","nullable":true,"description":null},{"name":"purchase_orders","type":"JSON","nullable":true,"description":"Purchase orders on this shipment. Nested JSON, not one row per PO."},{"name":"containers","type":"JSON","nullable":true,"description":"Cartons and container contents. Nested JSON."},{"name":"shipment_measurements","type":"JSON","nullable":true,"description":"Weight and volume of the shipment. Nested JSON."},{"name":"shipment_status_details","type":"JSON","nullable":true,"description":"Status history and details. Nested JSON, not only current_shipment_status."},{"name":"import_details","type":"JSON","nullable":true,"description":"Import details when the shipment is international. Nested JSON."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last received this row from the Vendor API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"WePay/collect Vendor Retail Procurement shipments (submitted or requested for routing; does not include shipments created in Vendor Central). One row per shipment with nested purchase orders, containers, and status details. Amazon does not return shipments created only in Vendor Central (Orders > Shipments / appointments).","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":30},{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_vendor_shipments"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["arn","collect shipment","wepay"]},{"id":"6cdde992a36bdedb6fbd17bbcd294941dbf55ac504302db9b232dc0887f1598a","name":"Sellers & Vendors Context","tableName":"amazon_sellers_and_vendors_context","type":"VENDOR_CENTRAL","columns":[{"name":"connection_context_id","type":"TEXT","nullable":false,"description":"DataDoe connection context id, or the connection id when no context is set. Same value as seller_or_vendor_id. Not a unique row key when one context has several connections or DSP advertisers."},{"name":"connection_context_name","type":"TEXT","nullable":false,"description":"Context display name. Same value as seller_or_vendor_name. Falls back to the connection name, then the connection id. DSP rows use the mapped context name."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"Same value as connection_context_id. DataDoe account id used by MCP and API calls (sellers_and_vendors_list, exports). Not unique on this table: repeated for each connection and each DSP advertiser in the context. Fact tables copy this value into their seller_or_vendor_id."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"Same value as connection_context_name. DataDoe display name for the seller or vendor context."},{"name":"ads_dsp_connection_id","type":"TEXT","nullable":true,"description":"DataDoe Amazon Ads connection id of the account Amazon DSP is run from. One agency connection can be shared by several sellers or vendors. Null on non-DSP rows. Join DSP facts on organization_id, store_id, ads_dsp_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser identifier mapped to this seller or vendor. One advertiser maps to one context. If an advertiser is reassigned, only the latest mapping is kept. Null on non-DSP rows."},{"name":"selling_partner_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id from the connection (connection_seller_id). Same value as marketplace_seller_id. This is the Amazon id, not seller_or_vendor_id. Null on DSP advertiser rows and when the connection has no seller id."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Same value as selling_partner_id: Amazon connection_seller_id. Null on DSP advertiser rows and when the connection has no seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile id. Set on Amazon Ads connections and on DSP advertiser rows. Null on Seller Central and Vendor Central rows."},{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":false,"description":"Lookup of DataDoe Amazon accounts for Seller Central, Vendor Central, Amazon Ads, and Amazon DSP. One row per connection, plus one row per Amazon DSP advertiser mapped to a seller or vendor on a shared agency Ads account. A DSP-only agency seat is not its own seller. seller_or_vendor_id equals connection_context_id and is not unique: one context can have a Seller Central row, an Amazon Ads row, and one row per DSP advertiser. Join Seller Central and Vendor Central facts on sp_connection_id or vendor_connection_id. Attribute DSP facts on organization_id, store_id, ads_dsp_connection_id, and dsp_advertiser_id.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[],"sources":["connections","raw_connection_dsp_advertisers"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["connection mapping","selling partner id","dsp advertiser","ads profile"]},{"id":"d0017e92fb089c2c8c3fe65f81d08666ecb4fe937ffbce9969ce2fc7d28c805c","name":"Ad Performance by ASIN & Date","tableName":"amazon_ads_performance_by_child_asin_and_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"child_asin","type":"TEXT","nullable":true,"description":null},{"name":"sku","type":"TEXT","nullable":true,"description":null},{"name":"date","type":"DATE","nullable":false,"description":"Single date may repeat."},{"name":"product_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"SPONSORED_DISPLAY / SPONSORED_PRODUCTS / SPONSORED_BRANDS"},{"name":"ad_portfolio_id","type":"TEXT","nullable":true,"description":"Portfolio ID for SPONSORED_PRODUCTS campaigns. Null for SPONSORED_DISPLAY and SPONSORED_BRANDS."},{"name":"ad_portfolio_name","type":"TEXT","nullable":true,"description":"Portfolio name for SPONSORED_PRODUCTS campaigns. Null for SPONSORED_DISPLAY and SPONSORED_BRANDS."},{"name":"ad_sales","type":"NUMBER","nullable":true,"description":"Products: same-SKU click sales (7d). Display: promoted-product click sales (14d). Brands: estimated share of campaign sales (14d), including brand halo. Use ad_sales_same_sku for the product-only scope.","definition":"amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_PRODUCTS' ? raw_ads_api_report_advertised_products_sp.attributedSalesSameSku7d : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_DISPLAY' ? raw_ads_api_report_advertised_products_sd.salesPromotedClicks : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_TELEVISION' ? null : refined_ads_estimated_sb_performance_by_asin.estimatedSales14d"},{"name":"ad_orders","type":"NUMBER","nullable":true,"description":"Products: same-SKU click orders (7d). Display: promoted-product click orders (14d). Brands: estimated share of campaign orders (14d), including brand halo. Use ad_orders_same_sku for the product-only scope.","definition":"amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_PRODUCTS' ? raw_ads_api_report_advertised_products_sp.purchasesSameSku7d : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_DISPLAY' ? raw_ads_api_report_advertised_products_sd.purchasesPromotedClicks : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_TELEVISION' ? null : refined_ads_estimated_sb_performance_by_asin.estimatedOrders14d"},{"name":"ad_sales_same_sku","type":"NUMBER","nullable":true,"description":"Attributed sales of the advertised SKU only (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Excludes brand-halo purchases of other SKUs. Not total ad sales; campaign totals are amazon_ads_performance_by_campaign_by_date.ad_sales. Null for Sponsored Brands.","definition":"amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_PRODUCTS' ? raw_ads_api_report_advertised_products_sp.attributedSalesSameSku7d : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_DISPLAY' ? raw_ads_api_report_advertised_products_sd.salesPromotedClicks : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_TELEVISION' ? null : null"},{"name":"ad_clicks","type":"NUMBER","nullable":true,"description":"Clicks after Amazon removed invalid traffic. Gross clicks, including invalid traffic, are ad_gross_click_throughs. Null for Sponsored Brands."},{"name":"ad_impressions","type":"NUMBER","nullable":true,"description":"Times the ad was displayed after Amazon removed invalid traffic. Gross impressions, including invalid traffic, are ad_gross_impressions. Null for Sponsored Brands."},{"name":"ad_spend","type":"NUMBER","nullable":true,"description":"Reported Products and Display spend, or estimated Brands spend allocated to this ASIN and SKU. Sponsored Brands spend uses eligible ad-creative ASINs, with same-day ad cost rescaled to campaign cost. Remaining spend uses campaign purchased-product shares. Without purchased-product data, it uses Seller Central sales, orders and sessions, or an even split among known campaign ASINs. Sales and orders allocate campaign totals by purchased-product shares, with the same fallback signals. ASIN spend and sales are split across available SKUs by same-day order-sales shares; orders use order-count shares. A zero total uses an even split for that measure. With no SKU rows, sku is null. Campaigns without any ASIN signal remain account-only. Attribution windows do not apply to spend."},{"name":"ad_units_sold_same_sku","type":"NUMBER","nullable":true,"description":"Products: same-SKU click-attributed units (7d), excluding brand halo. Display: total click-attributed units (14d), which can include purchases of other products despite the column name. Null for Brands.","definition":"amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_PRODUCTS' ? raw_ads_api_report_advertised_products_sp.unitsSoldSameSku7d : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_DISPLAY' ? raw_ads_api_report_advertised_products_sd.unitsSoldClicks : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_TELEVISION' ? null : null"},{"name":"ad_orders_same_sku","type":"NUMBER","nullable":true,"description":"Attributed orders of the advertised SKU only (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Excludes brand-halo orders of other SKUs. Null for Sponsored Brands.","definition":"amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_PRODUCTS' ? raw_ads_api_report_advertised_products_sp.purchasesSameSku7d : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_DISPLAY' ? raw_ads_api_report_advertised_products_sd.purchasesPromotedClicks : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_TELEVISION' ? null : null"},{"name":"ad_campaign_budget_amount","type":"NUMBER","nullable":true,"description":"Campaign budget repeated on every row of the campaign. Do not sum it across ASINs, keywords, placements, or dates. ad_campaign_budget_type is DAILY_BUDGET or LIFETIME_BUDGET. Available for Sponsored Products. Null for Sponsored Display and Sponsored Brands."},{"name":"ad_campaign_budget_type","type":"TEXT","nullable":true,"description":"DAILY_BUDGET / LIFETIME_BUDGET or NULL."},{"name":"ad_campaign_budget_currency","type":"TEXT","nullable":true,"description":"Currency code for Sponsored Products and Sponsored Display. Null for Sponsored Brands."},{"name":"ad_id","type":"TEXT","nullable":true,"description":"Ad ID for Sponsored Products and Sponsored Display. Null for Sponsored Brands."},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":"Ad group ID for Sponsored Products and Sponsored Display. Null for Sponsored Brands."},{"name":"ad_campaign_id","type":"TEXT","nullable":true,"description":"Campaign ID for SPONSORED_PRODUCTS, SPONSORED_DISPLAY and SPONSORED_BRANDS."},{"name":"ad_campaign_name","type":"TEXT","nullable":true,"description":"Campaign name for SPONSORED_PRODUCTS, SPONSORED_DISPLAY and SPONSORED_BRANDS."},{"name":"ad_campaign_status","type":"TEXT","nullable":true,"description":"Campaign status for SPONSORED_PRODUCTS. Null for SPONSORED_DISPLAY and SPONSORED_BRANDS."},{"name":"is_estimated","type":"LOGIC","nullable":false,"description":"TRUE for SPONSORED_BRANDS rows, whose ASIN-level metrics are estimated by allocating campaign-level totals down to ASINs (Amazon does not expose true SB ASIN-level data). FALSE for SPONSORED_PRODUCTS / SPONSORED_DISPLAY rows, which are reported directly."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Ads performance by product, ad or campaign, and date for Sponsored Products, Sponsored Display, and Sponsored Brands. Multiple rows can exist for the same ASIN, SKU and date. Products and Display report advertised/promoted-product sales and orders; Display units include all click-attributed purchases. Brands ad_sales and ad_orders are estimated shares of campaign totals, including brand halo; Brands same-SKU columns, clicks and impressions are null. Sponsored Brands spend uses eligible ad-creative ASINs, with same-day ad cost rescaled to campaign cost. Remaining spend uses campaign purchased-product shares. Without purchased-product data, it uses Seller Central sales, orders and sessions, or an even split among known campaign ASINs. Sales and orders allocate campaign totals by purchased-product shares, with the same fallback signals. ASIN spend and sales are split across available SKUs by same-day order-sales shares; orders use order-count shares. A zero total uses an even split for that measure. With no SKU rows, sku is null. Campaigns without any ASIN signal remain account-only. Estimates can lag the campaign report and are revised as inputs arrive. Prefer amazon_ads_performance_by_campaign_by_date for total campaign data. Sponsored Television and Amazon DSP are not included here.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_ADS_ADD","relation":"writes"},{"type":"AMAZON_ADS_ADS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_ADS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_ADS_FIND","relation":"live"}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":60},{"type":"RECURRING_DAILY","numberOfDays":21},{"type":"RECURRING_MONTHLY","numberOfDays":49}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"10am, 1pm, 4pm"},"sources":["connections","raw_ads_api_report_advertised_products_sd","raw_ads_api_report_advertised_products_sp","raw_ads_api_report_purchased_products_sb","raw_ads_api_report_legacy_campaign_sb_all","raw_ads_api_report_legacy_ad_sb_all","raw_ads_api_export_ads","raw_sp_api_report_orders","raw_sp_api_report_sales_and_traffic","refined_ads_estimated_sb_performance_by_asin","refined_products_by_child_asin"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["ppc","sponsored ads","asin ads","same sku"]},{"id":"08cdc77d3dc24a7651553e2e926f598188c66172f64cd6512265900af6073a6c","name":"Ad Performance by Campaign & Date","tableName":"amazon_ads_performance_by_campaign_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"SPONSORED_DISPLAY / SPONSORED_PRODUCTS / SPONSORED_BRANDS / SPONSORED_TELEVISION."},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Clicks after Amazon removed invalid traffic. Gross clicks, including invalid traffic, are ad_gross_click_throughs."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed ad sales (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS).","definition":"amazon_ads_performance_by_campaign_by_date.ad_campaign_type === 'SPONSORED_PRODUCTS' ? raw_ads_api_report_campaign_sp.sales7d : amazon_ads_performance_by_campaign_by_date.ad_campaign_type === 'SPONSORED_DISPLAY' ? raw_ads_api_report_campaign_sd.sales : amazon_ads_performance_by_campaign_by_date.ad_campaign_type === 'SPONSORED_TELEVISION' ? raw_ads_api_report_campaign_st.sales : raw_ads_api_report_legacy_campaign_sb_all.attributedSales14d"},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed after Amazon removed invalid traffic. Gross impressions, including invalid traffic, are ad_gross_impressions."},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":"Ad spend."},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed ad units sold (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS).","definition":"amazon_ads_performance_by_campaign_by_date.ad_campaign_type === 'SPONSORED_PRODUCTS' ? raw_ads_api_report_campaign_sp.unitsSoldClicks7d : amazon_ads_performance_by_campaign_by_date.ad_campaign_type === 'SPONSORED_DISPLAY' ? raw_ads_api_report_campaign_sd.unitsSoldClicks : amazon_ads_performance_by_campaign_by_date.ad_campaign_type === 'SPONSORED_TELEVISION' ? raw_ads_api_report_campaign_st.unitsSold : Math.max((raw_ads_api_report_legacy_campaign_sb_all.attributedConversions14d ?? 0), Math.round(((raw_ads_api_report_legacy_campaign_sb_all.attributedUnitsOrderedNewToBrand14d ?? 0) / (raw_ads_api_report_legacy_campaign_sb_all.attributedUnitsOrderedNewToBrandPercentage14d || 100)) * 100))"},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed ad orders (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS).","definition":"amazon_ads_performance_by_campaign_by_date.ad_campaign_type === 'SPONSORED_PRODUCTS' ? raw_ads_api_report_campaign_sp.purchases7d : amazon_ads_performance_by_campaign_by_date.ad_campaign_type === 'SPONSORED_DISPLAY' ? raw_ads_api_report_campaign_sd.purchases : amazon_ads_performance_by_campaign_by_date.ad_campaign_type === 'SPONSORED_TELEVISION' ? raw_ads_api_report_campaign_st.purchases : raw_ads_api_report_legacy_campaign_sb_all.attributedConversions14d"},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":"Campaign identifier."},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":"Campaign name."},{"name":"ad_campaign_status","type":"TEXT","nullable":true,"description":"Campaign status."},{"name":"ad_campaign_budget_amount","type":"NUMBER","nullable":false,"description":"Campaign budget repeated on every row of the campaign. Do not sum it across ASINs, keywords, placements, or dates. ad_campaign_budget_type is DAILY_BUDGET or LIFETIME_BUDGET."},{"name":"ad_campaign_budget_type","type":"TEXT","nullable":true,"description":"DAILY_BUDGET / LIFETIME_BUDGET or NULL."},{"name":"ad_campaign_budget_currency","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_rule_based_budget_amount","type":"NUMBER","nullable":true,"description":"Rule-based campaign budget reported for this date for Sponsored Products, in ad_campaign_budget_currency. Repeated across placements; do not sum across placements or dates. Null when Amazon omits it and for other campaign types.","definition":"campaignRuleBasedBudgetAmount from the Sponsored Products report"},{"name":"ad_campaign_applicable_budget_rule_id","type":"TEXT","nullable":true,"description":"Identifier of the budget rule Amazon reports as applicable to the Sponsored Products campaign on this date. Null when Amazon omits it and for other campaign types. Does not expose the rule definition or execution history.","definition":"campaignApplicableBudgetRuleId from the Sponsored Products report"},{"name":"ad_campaign_applicable_budget_rule_name","type":"TEXT","nullable":true,"description":"Name of the budget rule Amazon reports as applicable to the Sponsored Products campaign on this date. Null when Amazon omits it and for other campaign types. Read-only report value; does not support rule edits.","definition":"campaignApplicableBudgetRuleName from the Sponsored Products report"},{"name":"ad_gross_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed, including invalid traffic (fraudulent, non-human, and other illegitimate impressions). ad_impressions excludes that traffic."},{"name":"ad_invalid_impressions","type":"NUMBER","nullable":false,"description":"Impressions removed by the traffic quality filter. Not included in ad_impressions."},{"name":"ad_invalid_impression_rate","type":"NUMBER","nullable":true,"description":"Invalid impressions divided by gross impressions. A rate, not an impression count."},{"name":"ad_gross_click_throughs","type":"NUMBER","nullable":false,"description":"Times the ad was clicked, including invalid traffic. ad_clicks excludes that traffic."},{"name":"ad_invalid_click_throughs","type":"NUMBER","nullable":false,"description":"Clicks removed by the traffic quality filter. Not included in ad_clicks."},{"name":"ad_invalid_click_through_rate","type":"NUMBER","nullable":true,"description":"Invalid clicks divided by gross clicks. A rate, not a click count."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Ads performance per campaign and date for Sponsored Products, Sponsored Brands, Sponsored Display, and Sponsored Television. Use this table for total sponsored ads campaign spend and sales. ad_impressions and ad_clicks exclude invalid traffic; gross and invalid columns are the traffic-quality reconciliation. Amazon DSP is not included; use amazon_ads_dsp_performance_by_creative_by_date for Amazon DSP.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_CAMPAIGNS_ADD","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_FIND","relation":"live"}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":21},{"type":"RECURRING_MONTHLY","numberOfDays":49}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"10am, 1pm, 4pm"},"sources":["connections","raw_ads_api_report_campaign_sd","raw_ads_api_report_campaign_sp","raw_ads_api_report_campaign_st","raw_ads_api_report_gross_and_invalid_traffic_sb","raw_ads_api_report_gross_and_invalid_traffic_sd","raw_ads_api_report_gross_and_invalid_traffic_sp","raw_ads_api_report_legacy_campaign_sb_all"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["ppc","sponsored ads","acos","roas","cpc","cpm","tacos","ad spend"]},{"id":"46b72faac2b2f5032bd49c71c94665218c2fd9ac0cb1e162bb3e890f2d216b43","name":"DSP Performance by Creative & Date","tableName":"amazon_ads_dsp_performance_by_creative_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon marketplace of the DataDoe DSP slot the advertiser is fetched for."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe account identifier the DSP advertiser is mapped to, used by MCP/API calls (sellers_and_vendors_list, exports). Null when the advertiser is not mapped to a seller or vendor."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name of the mapped seller or vendor. Null when the advertiser is not mapped."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id of the mapped seller. Null for vendors, unmapped advertisers, and contexts without a seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":false,"description":"Amazon DSP advertiser identifier. Join amazon_sellers_and_vendors_context on organization_id, store_id, ads_dsp_connection_id = ads_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_name","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser name."},{"name":"date","type":"DATE","nullable":false,"description":"Report date (Amazon DSP daily report)."},{"name":"dt_created","type":"DATE","nullable":false,"description":"Timestamp when DataDoe first stored this row."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last updated this row."},{"name":"dsp_order_id","type":"TEXT","nullable":false,"description":"Amazon DSP order identifier. An order is a campaign in the new Amazon DSP naming."},{"name":"dsp_order_name","type":"TEXT","nullable":true,"description":"Amazon DSP order (campaign) name."},{"name":"dsp_order_budget","type":"NUMBER","nullable":true,"description":"Order budget repeated on every row of the order. Do not sum it across line items, creatives, or dates. In ad_currency."},{"name":"dsp_order_start_date","type":"TEXT","nullable":true,"description":"Order start date as delivered by Amazon DSP."},{"name":"dsp_order_end_date","type":"TEXT","nullable":true,"description":"Order end date as delivered by Amazon DSP."},{"name":"dsp_order_external_id","type":"TEXT","nullable":true,"description":"Advertiser-defined external identifier of the order."},{"name":"dsp_line_item_id","type":"TEXT","nullable":false,"description":"Amazon DSP line item identifier. A line item is an ad group in the new Amazon DSP naming."},{"name":"dsp_line_item_name","type":"TEXT","nullable":true,"description":"Amazon DSP line item (ad group) name."},{"name":"dsp_line_item_type","type":"TEXT","nullable":true,"description":"Amazon DSP line item type as reported by Amazon."},{"name":"dsp_line_item_budget","type":"NUMBER","nullable":true,"description":"Line item budget repeated on every row of the line item. Do not sum it across creatives or dates. In ad_currency."},{"name":"dsp_line_item_start_date","type":"TEXT","nullable":true,"description":"Line item start date as delivered by Amazon DSP."},{"name":"dsp_line_item_end_date","type":"TEXT","nullable":true,"description":"Line item end date as delivered by Amazon DSP."},{"name":"dsp_creative_id","type":"TEXT","nullable":false,"description":"Amazon DSP creative identifier."},{"name":"dsp_creative_name","type":"TEXT","nullable":true,"description":"Amazon DSP creative name."},{"name":"dsp_creative_type","type":"TEXT","nullable":true,"description":"Amazon DSP creative type as reported by Amazon."},{"name":"dsp_creative_size","type":"TEXT","nullable":true,"description":"Amazon DSP creative size as reported by Amazon."},{"name":"ad_currency","type":"TEXT","nullable":true,"description":"Currency of all monetary Amazon DSP values in the row (order currency)."},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Amazon DSP impressions after Amazon removed invalid traffic. Gross impressions, including invalid traffic, are ad_gross_impressions."},{"name":"ad_viewable_impressions","type":"NUMBER","nullable":false,"description":"Impressions that met the Amazon DSP viewability standard."},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Amazon DSP click-throughs after Amazon removed invalid traffic."},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":"Amazon DSP totalCost: supply cost plus Amazon fees (ad_supply_cost + ad_fees_total), excluding third-party fees paid by the agency. In ad_currency."},{"name":"ad_supply_cost","type":"NUMBER","nullable":false,"description":"Amazon DSP media supply (inventory) cost, without fees. Included in ad_spend. In ad_currency."},{"name":"ad_fees_total","type":"NUMBER","nullable":false,"description":"Sum of all Amazon DSP fees. Included in ad_spend. In ad_currency."},{"name":"ad_agency_fee","type":"NUMBER","nullable":false,"description":"Agency fee reported by Amazon DSP. In ad_currency."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed sales (DSP totalSales). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_sales_promoted","type":"NUMBER","nullable":false,"description":"Attributed sales (DSP sales). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed purchases (DSP totalPurchases). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_orders_promoted","type":"NUMBER","nullable":false,"description":"Attributed purchases (DSP purchases). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed units sold (DSP totalUnitsSold). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_units_sold_promoted","type":"NUMBER","nullable":false,"description":"Attributed units sold (DSP unitsSold). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_sales_new_to_brand","type":"NUMBER","nullable":false,"description":"New-to-brand sales (DSP totalNewToBrandSales): sales to customers who did not buy the brand in the past 12 months. Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_sales_new_to_brand_promoted","type":"NUMBER","nullable":false,"description":"New-to-brand sales (DSP newToBrandProductSales). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_orders_new_to_brand","type":"NUMBER","nullable":false,"description":"New-to-brand purchases (DSP totalNewToBrandPurchases). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_orders_new_to_brand_promoted","type":"NUMBER","nullable":false,"description":"New-to-brand purchases (DSP newToBrandPurchases). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_detail_page_views","type":"NUMBER","nullable":false,"description":"Attributed detail page views (DSP totalDetailPageView). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_detail_page_views_promoted","type":"NUMBER","nullable":false,"description":"Attributed detail page views (DSP detailPageViews). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_add_to_cart","type":"NUMBER","nullable":false,"description":"Attributed add-to-cart events (DSP totalAddToCart). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_add_to_cart_promoted","type":"NUMBER","nullable":false,"description":"Attributed add-to-cart events (DSP addToCart). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_gross_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed, including invalid traffic (fraudulent, non-human, and other illegitimate impressions). ad_impressions excludes that traffic."},{"name":"ad_invalid_impressions","type":"NUMBER","nullable":false,"description":"Impressions removed by the traffic quality filter. Not included in ad_impressions."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP performance per advertiser, date, order, line item, and creative. Amazon DSP only (DataDoe DSP slot of a seller or vendor), refreshed once a day, not intraday. Rows map to a seller or vendor through seller_or_vendor_id, which is null when the DSP advertiser is not mapped. DSP order = campaign and line item = ad group in the new Amazon DSP naming. Use this table for total Amazon DSP spend and sales; it is the DSP source of amazon_profit_by_date. ad_sales, ad_orders, and ad_units_sold include brand halo; the _promoted columns cover promoted ASINs only. Order and line item budgets repeat on every creative row, so do not sum them.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":28},{"type":"RECURRING_MONTHLY","numberOfDays":56}],"sources":["connections","raw_ads_api_report_campaign_ad_creative_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","programmatic","display dsp","dsp spend","dsp creative"]},{"id":"be347b80ff1c743a2224a42354339da91db167b98871e7b75bc40e71a00fd6fe","name":"DSP Product Conversions by ASIN & Date","tableName":"amazon_ads_dsp_performance_by_asin_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon marketplace of the DataDoe DSP slot the advertiser is fetched for."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe account identifier the DSP advertiser is mapped to, used by MCP/API calls (sellers_and_vendors_list, exports). Null when the advertiser is not mapped to a seller or vendor."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name of the mapped seller or vendor. Null when the advertiser is not mapped."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id of the mapped seller. Null for vendors, unmapped advertisers, and contexts without a seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":false,"description":"Amazon DSP advertiser identifier. Join amazon_sellers_and_vendors_context on organization_id, store_id, ads_dsp_connection_id = ads_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_name","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser name."},{"name":"date","type":"DATE","nullable":false,"description":"Report date (Amazon DSP daily report)."},{"name":"dt_created","type":"DATE","nullable":false,"description":"Timestamp when DataDoe first stored this row."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last updated this row."},{"name":"dsp_order_id","type":"TEXT","nullable":false,"description":"Amazon DSP order identifier. An order is a campaign in the new Amazon DSP naming."},{"name":"dsp_order_name","type":"TEXT","nullable":true,"description":"Amazon DSP order (campaign) name."},{"name":"dsp_line_item_id","type":"TEXT","nullable":false,"description":"Amazon DSP line item identifier. A line item is an ad group in the new Amazon DSP naming."},{"name":"dsp_line_item_name","type":"TEXT","nullable":true,"description":"Amazon DSP line item (ad group) name."},{"name":"child_asin","type":"TEXT","nullable":false,"description":"ASIN that converted (child ASIN)."},{"name":"parent_asin","type":"TEXT","nullable":true,"description":"Parent ASIN of child_asin."},{"name":"featured_asin","type":"TEXT","nullable":true,"description":"Featured ASIN reported by Amazon DSP for the conversion."},{"name":"product_name","type":"TEXT","nullable":true,"description":null},{"name":"brand_name","type":"TEXT","nullable":true,"description":null},{"name":"product_group","type":"TEXT","nullable":true,"description":null},{"name":"product_category","type":"TEXT","nullable":true,"description":null},{"name":"product_subcategory","type":"TEXT","nullable":true,"description":null},{"name":"dsp_conversion_type","type":"TEXT","nullable":false,"description":"PROMOTED (ASIN promoted by the line item) or BRAND_HALO (other ASIN of the same brands)."},{"name":"ad_currency","type":"TEXT","nullable":true,"description":"Currency of all monetary Amazon DSP values in the row (order currency)."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed sales of this ASIN within dsp_conversion_type. Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed purchases of this ASIN within dsp_conversion_type. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed units sold of this ASIN within dsp_conversion_type. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_sales_new_to_brand","type":"NUMBER","nullable":false,"description":"New-to-brand sales of this ASIN within dsp_conversion_type: sales to customers who did not buy the brand in the past 12 months. Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_orders_new_to_brand","type":"NUMBER","nullable":false,"description":"New-to-brand purchases of this ASIN within dsp_conversion_type. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_detail_page_views","type":"NUMBER","nullable":false,"description":"Attributed detail page views of this ASIN within dsp_conversion_type. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_add_to_cart","type":"NUMBER","nullable":false,"description":"Attributed add-to-cart events of this ASIN within dsp_conversion_type. Amazon DSP 14-day attribution after an ad view or click."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP product conversions per advertiser, date, order, line item, child ASIN, and conversion type. Amazon DSP only (DataDoe DSP slot of a seller or vendor), refreshed once a day, not intraday. Rows map to a seller or vendor through seller_or_vendor_id, which is null when the DSP advertiser is not mapped. DSP order = campaign and line item = ad group in the new Amazon DSP naming. dsp_conversion_type PROMOTED rows are conversions of ASINs promoted by the line item; BRAND_HALO rows are conversions of other ASINs of the same brands. Sum PROMOTED and BRAND_HALO for total product sales as in the Amazon DSP console. Amazon reports no cost, impressions, or clicks at ASIN level; spend is in amazon_ads_dsp_performance_by_creative_by_date. Amazon limits the report to the top 500 ASINs of the past 65 days, so totals can be slightly below the creative table.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":28},{"type":"RECURRING_MONTHLY","numberOfDays":56}],"sources":["connections","raw_ads_api_report_product_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","dsp product","dsp brand halo"]},{"id":"c5e669002482c32ecbaff6eb3410de72886a9fc46e02077e92b0867bbae514c7","name":"DSP Performance by City & Date","tableName":"amazon_ads_dsp_performance_by_city_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon marketplace of the DataDoe DSP slot the advertiser is fetched for."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe account identifier the DSP advertiser is mapped to, used by MCP/API calls (sellers_and_vendors_list, exports). Null when the advertiser is not mapped to a seller or vendor."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name of the mapped seller or vendor. Null when the advertiser is not mapped."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id of the mapped seller. Null for vendors, unmapped advertisers, and contexts without a seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":false,"description":"Amazon DSP advertiser identifier. Join amazon_sellers_and_vendors_context on organization_id, store_id, ads_dsp_connection_id = ads_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_name","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser name."},{"name":"date","type":"DATE","nullable":false,"description":"Report date (Amazon DSP daily report)."},{"name":"dt_created","type":"DATE","nullable":false,"description":"Timestamp when DataDoe first stored this row."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last updated this row."},{"name":"dsp_order_id","type":"TEXT","nullable":false,"description":"Amazon DSP order identifier. An order is a campaign in the new Amazon DSP naming."},{"name":"dsp_order_name","type":"TEXT","nullable":true,"description":"Amazon DSP order (campaign) name."},{"name":"dsp_line_item_id","type":"TEXT","nullable":false,"description":"Amazon DSP line item identifier. A line item is an ad group in the new Amazon DSP naming."},{"name":"dsp_line_item_name","type":"TEXT","nullable":true,"description":"Amazon DSP line item (ad group) name."},{"name":"city","type":"TEXT","nullable":true,"description":"City name as reported by Amazon DSP, without region or country. Not unique across regions. Null when Amazon could not attribute the city."},{"name":"ad_currency","type":"TEXT","nullable":true,"description":"Currency of all monetary Amazon DSP values in the row (order currency)."},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Amazon DSP impressions after Amazon removed invalid traffic. Gross impressions, including invalid traffic, are ad_gross_impressions."},{"name":"ad_viewable_impressions","type":"NUMBER","nullable":false,"description":"Impressions that met the Amazon DSP viewability standard."},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Amazon DSP click-throughs after Amazon removed invalid traffic."},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":"Amazon DSP totalCost: supply cost plus Amazon fees (ad_supply_cost + ad_fees_total), excluding third-party fees paid by the agency. In ad_currency."},{"name":"ad_agency_fee","type":"NUMBER","nullable":false,"description":"Agency fee reported by Amazon DSP. In ad_currency."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed sales (DSP totalSales). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_sales_promoted","type":"NUMBER","nullable":false,"description":"Attributed sales (DSP sales). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed purchases (DSP totalPurchases). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_orders_promoted","type":"NUMBER","nullable":false,"description":"Attributed purchases (DSP purchases). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed units sold (DSP totalUnitsSold). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_units_sold_promoted","type":"NUMBER","nullable":false,"description":"Attributed units sold (DSP unitsSold). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_sales_new_to_brand","type":"NUMBER","nullable":false,"description":"New-to-brand sales (DSP totalNewToBrandSales): sales to customers who did not buy the brand in the past 12 months. Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_sales_new_to_brand_promoted","type":"NUMBER","nullable":false,"description":"New-to-brand sales (DSP newToBrandProductSales). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_orders_new_to_brand","type":"NUMBER","nullable":false,"description":"New-to-brand purchases (DSP totalNewToBrandPurchases). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_orders_new_to_brand_promoted","type":"NUMBER","nullable":false,"description":"New-to-brand purchases (DSP newToBrandPurchases). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_detail_page_views","type":"NUMBER","nullable":false,"description":"Attributed detail page views (DSP totalDetailPageView). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_detail_page_views_promoted","type":"NUMBER","nullable":false,"description":"Attributed detail page views (DSP detailPageViews). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_add_to_cart","type":"NUMBER","nullable":false,"description":"Attributed add-to-cart events (DSP totalAddToCart). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_add_to_cart_promoted","type":"NUMBER","nullable":false,"description":"Attributed add-to-cart events (DSP addToCart). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_gross_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed, including invalid traffic (fraudulent, non-human, and other illegitimate impressions). ad_impressions excludes that traffic."},{"name":"ad_invalid_impressions","type":"NUMBER","nullable":false,"description":"Impressions removed by the traffic quality filter. Not included in ad_impressions."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP performance per advertiser, date, order, line item, and city. Amazon DSP only (DataDoe DSP slot of a seller or vendor), refreshed once a day, not intraday. Rows map to a seller or vendor through seller_or_vendor_id, which is null when the DSP advertiser is not mapped. DSP order = campaign and line item = ad group in the new Amazon DSP naming. city is a bare city name (for example Columbus) and is not unique across regions; the country is the marketplace country. Large table: always filter by date.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":28},{"type":"RECURRING_DAILY","numberOfDays":7},{"type":"RECURRING_MONTHLY","numberOfDays":28}],"sources":["connections","raw_ads_api_report_geo_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","dsp geo","dsp city"]},{"id":"fced2c0c7c2b0182dae4267106841845d7546cdc64d8a73efc205977b0042aa2","name":"DSP Performance by Audience & Date","tableName":"amazon_ads_dsp_performance_by_audience_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon marketplace of the DataDoe DSP slot the advertiser is fetched for."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe account identifier the DSP advertiser is mapped to, used by MCP/API calls (sellers_and_vendors_list, exports). Null when the advertiser is not mapped to a seller or vendor."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name of the mapped seller or vendor. Null when the advertiser is not mapped."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id of the mapped seller. Null for vendors, unmapped advertisers, and contexts without a seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":false,"description":"Amazon DSP advertiser identifier. Join amazon_sellers_and_vendors_context on organization_id, store_id, ads_dsp_connection_id = ads_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_name","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser name."},{"name":"date","type":"DATE","nullable":false,"description":"Report date (Amazon DSP daily report)."},{"name":"dt_created","type":"DATE","nullable":false,"description":"Timestamp when DataDoe first stored this row."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last updated this row."},{"name":"dsp_order_id","type":"TEXT","nullable":false,"description":"Amazon DSP order identifier. An order is a campaign in the new Amazon DSP naming."},{"name":"dsp_order_name","type":"TEXT","nullable":true,"description":"Amazon DSP order (campaign) name."},{"name":"dsp_line_item_id","type":"TEXT","nullable":false,"description":"Amazon DSP line item identifier. A line item is an ad group in the new Amazon DSP naming."},{"name":"dsp_line_item_name","type":"TEXT","nullable":true,"description":"Amazon DSP line item (ad group) name."},{"name":"dsp_line_item_type","type":"TEXT","nullable":true,"description":"Amazon DSP line item type as reported by Amazon."},{"name":"dsp_segment_id","type":"TEXT","nullable":true,"description":"Amazon DSP audience segment identifier."},{"name":"dsp_segment_name","type":"TEXT","nullable":true,"description":"Amazon DSP audience segment name."},{"name":"dsp_segment_type","type":"TEXT","nullable":true,"description":"Audience segment type as reported by Amazon DSP."},{"name":"dsp_segment_source","type":"TEXT","nullable":true,"description":"Audience segment source as reported by Amazon DSP."},{"name":"dsp_segment_class_code","type":"TEXT","nullable":true,"description":"Audience segment class code as reported by Amazon DSP."},{"name":"dsp_segment_marketplace_id","type":"TEXT","nullable":true,"description":"Amazon marketplace id of the audience segment."},{"name":"dsp_targeting_method","type":"TEXT","nullable":true,"description":"How the line item targets the segment, as reported by Amazon DSP."},{"name":"ad_currency","type":"TEXT","nullable":true,"description":"Currency of all monetary Amazon DSP values in the row (order currency)."},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Amazon DSP impressions after Amazon removed invalid traffic. Gross impressions, including invalid traffic, are ad_gross_impressions."},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Amazon DSP click-throughs after Amazon removed invalid traffic."},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":"Amazon DSP totalCost: supply cost plus Amazon fees (ad_supply_cost + ad_fees_total), excluding third-party fees paid by the agency. In ad_currency."},{"name":"ad_supply_cost","type":"NUMBER","nullable":false,"description":"Amazon DSP media supply (inventory) cost, without fees. Included in ad_spend. In ad_currency."},{"name":"ad_orders_promoted","type":"NUMBER","nullable":false,"description":"Attributed purchases (DSP purchases). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_orders_new_to_brand_promoted","type":"NUMBER","nullable":false,"description":"New-to-brand purchases (DSP newToBrandPurchases). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_detail_page_views_promoted","type":"NUMBER","nullable":false,"description":"Attributed detail page views (DSP detailPageViews). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_add_to_cart_promoted","type":"NUMBER","nullable":false,"description":"Attributed add-to-cart events (DSP addToCart). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_gross_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed, including invalid traffic (fraudulent, non-human, and other illegitimate impressions). ad_impressions excludes that traffic."},{"name":"ad_invalid_impressions","type":"NUMBER","nullable":false,"description":"Impressions removed by the traffic quality filter. Not included in ad_impressions."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP performance per advertiser, date, order, line item, and audience segment. Amazon DSP only (DataDoe DSP slot of a seller or vendor), refreshed once a day, not intraday. Rows map to a seller or vendor through seller_or_vendor_id, which is null when the DSP advertiser is not mapped. DSP order = campaign and line item = ad group in the new Amazon DSP naming. Amazon does not report sales, units, or brand halo metrics in this report; conversion columns cover promoted ASINs only. A line item can target several segments, so do not sum segment rows to get line item totals; use amazon_ads_dsp_performance_by_creative_by_date for totals.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":28},{"type":"RECURRING_MONTHLY","numberOfDays":56}],"sources":["connections","raw_ads_api_report_audience_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","dsp audience","audience segment"]},{"id":"4a082fae0e12500cdf4d2da96abe52613a348185d3ce76473494f115d2853a7d","name":"DSP Performance by Device & Date","tableName":"amazon_ads_dsp_performance_by_device_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon marketplace of the DataDoe DSP slot the advertiser is fetched for."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe account identifier the DSP advertiser is mapped to, used by MCP/API calls (sellers_and_vendors_list, exports). Null when the advertiser is not mapped to a seller or vendor."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name of the mapped seller or vendor. Null when the advertiser is not mapped."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id of the mapped seller. Null for vendors, unmapped advertisers, and contexts without a seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":false,"description":"Amazon DSP advertiser identifier. Join amazon_sellers_and_vendors_context on organization_id, store_id, ads_dsp_connection_id = ads_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_name","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser name."},{"name":"date","type":"DATE","nullable":false,"description":"Report date (Amazon DSP daily report)."},{"name":"dt_created","type":"DATE","nullable":false,"description":"Timestamp when DataDoe first stored this row."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last updated this row."},{"name":"dsp_order_id","type":"TEXT","nullable":false,"description":"Amazon DSP order identifier. An order is a campaign in the new Amazon DSP naming."},{"name":"dsp_order_name","type":"TEXT","nullable":true,"description":"Amazon DSP order (campaign) name."},{"name":"dsp_line_item_id","type":"TEXT","nullable":false,"description":"Amazon DSP line item identifier. A line item is an ad group in the new Amazon DSP naming."},{"name":"dsp_line_item_name","type":"TEXT","nullable":true,"description":"Amazon DSP line item (ad group) name."},{"name":"dsp_device_type","type":"TEXT","nullable":true,"description":"Device type the ad was served on, as reported by Amazon DSP."},{"name":"ad_currency","type":"TEXT","nullable":true,"description":"Currency of all monetary Amazon DSP values in the row (order currency)."},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Amazon DSP impressions after Amazon removed invalid traffic. Gross impressions, including invalid traffic, are ad_gross_impressions."},{"name":"ad_viewable_impressions","type":"NUMBER","nullable":false,"description":"Impressions that met the Amazon DSP viewability standard."},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Amazon DSP click-throughs after Amazon removed invalid traffic."},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":"Amazon DSP totalCost: supply cost plus Amazon fees (ad_supply_cost + ad_fees_total), excluding third-party fees paid by the agency. In ad_currency."},{"name":"ad_agency_fee","type":"NUMBER","nullable":false,"description":"Agency fee reported by Amazon DSP. In ad_currency."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed sales (DSP totalSales). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_sales_promoted","type":"NUMBER","nullable":false,"description":"Attributed sales (DSP sales). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_orders_promoted","type":"NUMBER","nullable":false,"description":"Attributed purchases (DSP purchases). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_units_sold_promoted","type":"NUMBER","nullable":false,"description":"Attributed units sold (DSP unitsSold). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_sales_new_to_brand_promoted","type":"NUMBER","nullable":false,"description":"New-to-brand sales (DSP newToBrandProductSales). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_orders_new_to_brand_promoted","type":"NUMBER","nullable":false,"description":"New-to-brand purchases (DSP newToBrandPurchases). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_detail_page_views_promoted","type":"NUMBER","nullable":false,"description":"Attributed detail page views (DSP detailPageViews). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_add_to_cart_promoted","type":"NUMBER","nullable":false,"description":"Attributed add-to-cart events (DSP addToCart). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_gross_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed, including invalid traffic (fraudulent, non-human, and other illegitimate impressions). ad_impressions excludes that traffic."},{"name":"ad_invalid_impressions","type":"NUMBER","nullable":false,"description":"Impressions removed by the traffic quality filter. Not included in ad_impressions."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP performance per advertiser, date, order, line item, and device type. Amazon DSP only (DataDoe DSP slot of a seller or vendor), refreshed once a day, not intraday. Rows map to a seller or vendor through seller_or_vendor_id, which is null when the DSP advertiser is not mapped. DSP order = campaign and line item = ad group in the new Amazon DSP naming. ad_sales includes brand halo; all other conversion columns cover promoted ASINs only, because Amazon does not report their brand halo totals in this report.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":28},{"type":"RECURRING_MONTHLY","numberOfDays":56}],"sources":["connections","raw_ads_api_report_tech_devicetype_order_lineitem_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","dsp device"]},{"id":"df5510ac92fcb5cea50d739af440a9cc98e3555d80806a4de67f21994a25652a","name":"DSP Performance by Supply Source & Date","tableName":"amazon_ads_dsp_performance_by_supply_source_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon marketplace of the DataDoe DSP slot the advertiser is fetched for."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe account identifier the DSP advertiser is mapped to, used by MCP/API calls (sellers_and_vendors_list, exports). Null when the advertiser is not mapped to a seller or vendor."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name of the mapped seller or vendor. Null when the advertiser is not mapped."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id of the mapped seller. Null for vendors, unmapped advertisers, and contexts without a seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":false,"description":"Amazon DSP advertiser identifier. Join amazon_sellers_and_vendors_context on organization_id, store_id, ads_dsp_connection_id = ads_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_name","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser name."},{"name":"date","type":"DATE","nullable":false,"description":"Report date (Amazon DSP daily report)."},{"name":"dt_created","type":"DATE","nullable":false,"description":"Timestamp when DataDoe first stored this row."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last updated this row."},{"name":"dsp_supply_source","type":"TEXT","nullable":true,"description":"Supply source (inventory exchange or publisher) as reported by Amazon DSP."},{"name":"ad_currency","type":"TEXT","nullable":true,"description":"Always null: Amazon does not return a currency in this report. Monetary values are in the currency of the marketplace."},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Amazon DSP impressions after Amazon removed invalid traffic. Gross impressions, including invalid traffic, are ad_gross_impressions."},{"name":"ad_viewable_impressions","type":"NUMBER","nullable":false,"description":"Impressions that met the Amazon DSP viewability standard."},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Amazon DSP click-throughs after Amazon removed invalid traffic."},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":"Amazon DSP totalCost: supply cost plus Amazon fees (ad_supply_cost + ad_fees_total), excluding third-party fees paid by the agency. In ad_currency."},{"name":"ad_supply_cost","type":"NUMBER","nullable":false,"description":"Amazon DSP media supply (inventory) cost, without fees. Included in ad_spend. In ad_currency."},{"name":"ad_fees_total","type":"NUMBER","nullable":false,"description":"Sum of all Amazon DSP fees. Included in ad_spend. In ad_currency."},{"name":"ad_agency_fee","type":"NUMBER","nullable":false,"description":"Agency fee reported by Amazon DSP. In ad_currency."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed sales (DSP totalSales). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_sales_promoted","type":"NUMBER","nullable":false,"description":"Attributed sales (DSP sales). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed purchases (DSP totalPurchases). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_orders_promoted","type":"NUMBER","nullable":false,"description":"Attributed purchases (DSP purchases). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed units sold (DSP totalUnitsSold). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_units_sold_promoted","type":"NUMBER","nullable":false,"description":"Attributed units sold (DSP unitsSold). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_sales_new_to_brand","type":"NUMBER","nullable":false,"description":"New-to-brand sales (DSP totalNewToBrandSales): sales to customers who did not buy the brand in the past 12 months. Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_sales_new_to_brand_promoted","type":"NUMBER","nullable":false,"description":"New-to-brand sales (DSP newToBrandProductSales). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click. In ad_currency."},{"name":"ad_orders_new_to_brand","type":"NUMBER","nullable":false,"description":"New-to-brand purchases (DSP totalNewToBrandPurchases). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_orders_new_to_brand_promoted","type":"NUMBER","nullable":false,"description":"New-to-brand purchases (DSP newToBrandPurchases). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_detail_page_views","type":"NUMBER","nullable":false,"description":"Attributed detail page views (DSP totalDetailPageView). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_detail_page_views_promoted","type":"NUMBER","nullable":false,"description":"Attributed detail page views (DSP detailPageViews). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_add_to_cart","type":"NUMBER","nullable":false,"description":"Attributed add-to-cart events (DSP totalAddToCart). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_add_to_cart_promoted","type":"NUMBER","nullable":false,"description":"Attributed add-to-cart events (DSP addToCart). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_gross_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed, including invalid traffic (fraudulent, non-human, and other illegitimate impressions). ad_impressions excludes that traffic."},{"name":"ad_invalid_impressions","type":"NUMBER","nullable":false,"description":"Impressions removed by the traffic quality filter. Not included in ad_impressions."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP performance per advertiser, date, and supply source (inventory exchange or publisher). Amazon DSP only (DataDoe DSP slot of a seller or vendor), refreshed once a day, not intraday. Rows map to a seller or vendor through seller_or_vendor_id, which is null when the DSP advertiser is not mapped. Advertiser level: there is no order or line item breakdown. ad_currency is null because Amazon does not return a currency in this report; monetary values are in the currency of the marketplace.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_WEEKLY","numberOfDays":28},{"type":"RECURRING_MONTHLY","numberOfDays":56}],"sources":["connections","raw_ads_api_report_inventory_supplysource_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","dsp inventory","supply source"]},{"id":"e12169f83e0710ddfe562e55ea62c32e0aa83f1accfc31eae1ee1e84befb8747","name":"DSP Reach & Frequency","tableName":"amazon_ads_dsp_reach_and_frequency","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon marketplace of the DataDoe DSP slot the advertiser is fetched for."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe account identifier the DSP advertiser is mapped to, used by MCP/API calls (sellers_and_vendors_list, exports). Null when the advertiser is not mapped to a seller or vendor."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name of the mapped seller or vendor. Null when the advertiser is not mapped."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id of the mapped seller. Null for vendors, unmapped advertisers, and contexts without a seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":false,"description":"Amazon DSP advertiser identifier. Join amazon_sellers_and_vendors_context on organization_id, store_id, ads_dsp_connection_id = ads_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_name","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser name."},{"name":"date","type":"DATE","nullable":false,"description":"Start of the requested report period. Same value as period_start_date. Not a daily date: rows are summaries of the whole period."},{"name":"dt_created","type":"DATE","nullable":false,"description":"Timestamp when DataDoe first stored this row."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last updated this row."},{"name":"period_start_date","type":"DATE","nullable":false,"description":"First day of the requested report period. Same value as date."},{"name":"period_end_date","type":"DATE","nullable":true,"description":"Last day of the requested report period. May be null for rows fetched before DataDoe stored the period end."},{"name":"period_days","type":"NUMBER","nullable":true,"description":"Number of days in the requested report period, including both ends. Null when period_end_date is null."},{"name":"ad_reach","type":"NUMBER","nullable":false,"description":"Unique users reached by the advertiser in the period. Not additive across rows or periods."},{"name":"ad_frequency_average","type":"NUMBER","nullable":false,"description":"Average number of impressions per reached user in the period. Not additive across rows or periods."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP reach and average frequency per advertiser and report period. Amazon DSP only (DataDoe DSP slot of a seller or vendor), refreshed once a day, not intraday. Rows map to a seller or vendor through seller_or_vendor_id, which is null when the DSP advertiser is not mapped. Each row summarizes one period (period_start_date to period_end_date): a 30-day window on the first fetch, then 1-day windows. Periods can overlap. Reach and frequency are not additive: never sum or average them across rows or periods; pick one period.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":30},{"type":"RECURRING_DAILY","numberOfDays":4}],"sources":["connections","raw_ads_api_report_reach_frequency_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","reach","frequency"]},{"id":"a03385aa42d3fd21789cdb562ad070e5562f54c7a08fed28721e26493e56f5c6","name":"DSP Brand Suitability","tableName":"amazon_ads_dsp_brand_suitability","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon marketplace of the DataDoe DSP slot the advertiser is fetched for."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe account identifier the DSP advertiser is mapped to, used by MCP/API calls (sellers_and_vendors_list, exports). Null when the advertiser is not mapped to a seller or vendor."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name of the mapped seller or vendor. Null when the advertiser is not mapped."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id of the mapped seller. Null for vendors, unmapped advertisers, and contexts without a seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":false,"description":"Amazon DSP advertiser identifier. Join amazon_sellers_and_vendors_context on organization_id, store_id, ads_dsp_connection_id = ads_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_name","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser name."},{"name":"date","type":"DATE","nullable":false,"description":"Start of the requested report period. Same value as period_start_date. Not a daily date: rows are summaries of the whole period."},{"name":"dt_created","type":"DATE","nullable":false,"description":"Timestamp when DataDoe first stored this row."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last updated this row."},{"name":"period_start_date","type":"DATE","nullable":false,"description":"First day of the requested report period. Same value as date."},{"name":"period_end_date","type":"DATE","nullable":true,"description":"Last day of the requested report period. May be null for rows fetched before DataDoe stored the period end."},{"name":"period_days","type":"NUMBER","nullable":true,"description":"Number of days in the requested report period, including both ends. Null when period_end_date is null."},{"name":"dsp_order_id","type":"TEXT","nullable":false,"description":"Amazon DSP order identifier. An order is a campaign in the new Amazon DSP naming."},{"name":"dsp_order_name","type":"TEXT","nullable":true,"description":"Amazon DSP order (campaign) name."},{"name":"dsp_line_item_id","type":"TEXT","nullable":false,"description":"Amazon DSP line item identifier. A line item is an ad group in the new Amazon DSP naming."},{"name":"dsp_line_item_name","type":"TEXT","nullable":true,"description":"Amazon DSP line item (ad group) name."},{"name":"dsp_brand_suitability_dimension","type":"TEXT","nullable":false,"description":"Breakdown of the row: INVENTORY_TIER, CONTENT_CATEGORY, or SUPPLY_SOURCE. Filter to one dimension; each dimension splits the same impressions."},{"name":"dsp_brand_suitability_value","type":"TEXT","nullable":true,"description":"Inventory tier, content category, or supply source name, depending on dsp_brand_suitability_dimension."},{"name":"dsp_supply_source_id","type":"TEXT","nullable":true,"description":"Supply source identifier. Only for SUPPLY_SOURCE rows, null otherwise."},{"name":"dsp_line_item_active_start_date","type":"TEXT","nullable":true,"description":"Start of the line item delivery within the period, as delivered by Amazon DSP. Not the requested period start."},{"name":"dsp_line_item_active_end_date","type":"TEXT","nullable":true,"description":"End of the line item delivery within the period, as delivered by Amazon DSP. Not the requested period end."},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Amazon DSP impressions in the period for this dimension value. Not additive across periods."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP brand suitability: impressions per advertiser, order, line item, and report period, broken down by inventory tier, content category, or supply source. Amazon DSP only (DataDoe DSP slot of a seller or vendor), refreshed once a day, not intraday. Rows map to a seller or vendor through seller_or_vendor_id, which is null when the DSP advertiser is not mapped. DSP order = campaign and line item = ad group in the new Amazon DSP naming. Rows are rolling 7-day summaries starting every day: never sum across different periods (summing all dates overcounts about 7 times); pick one period and one dsp_brand_suitability_dimension.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":28},{"type":"RECURRING_MONTHLY","numberOfDays":56}],"sources":["connections","raw_ads_api_report_brand_suitability_content_category_dsp","raw_ads_api_report_brand_suitability_inventory_tier_dsp","raw_ads_api_report_brand_suitability_supply_source_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","brand suitability","brand safety"]},{"id":"d2ebcf1754f977f0b40374d21137db21cb9c7771dbdd4b873f6c61420154e3a3","name":"DSP Performance by Content","tableName":"amazon_ads_dsp_performance_by_content","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon marketplace of the DataDoe DSP slot the advertiser is fetched for."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe account identifier the DSP advertiser is mapped to, used by MCP/API calls (sellers_and_vendors_list, exports). Null when the advertiser is not mapped to a seller or vendor."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name of the mapped seller or vendor. Null when the advertiser is not mapped."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id of the mapped seller. Null for vendors, unmapped advertisers, and contexts without a seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":false,"description":"Amazon DSP advertiser identifier. Join amazon_sellers_and_vendors_context on organization_id, store_id, ads_dsp_connection_id = ads_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_name","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser name."},{"name":"date","type":"DATE","nullable":false,"description":"Start of the requested report period. Same value as period_start_date. Not a daily date: rows are summaries of the whole period."},{"name":"dt_created","type":"DATE","nullable":false,"description":"Timestamp when DataDoe first stored this row."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last updated this row."},{"name":"period_start_date","type":"DATE","nullable":false,"description":"First day of the requested report period. Same value as date."},{"name":"period_end_date","type":"DATE","nullable":true,"description":"Last day of the requested report period. May be null for rows fetched before DataDoe stored the period end."},{"name":"period_days","type":"NUMBER","nullable":true,"description":"Number of days in the requested report period, including both ends. Null when period_end_date is null."},{"name":"dsp_order_id","type":"TEXT","nullable":false,"description":"Amazon DSP order identifier. An order is a campaign in the new Amazon DSP naming."},{"name":"dsp_order_name","type":"TEXT","nullable":true,"description":"Amazon DSP order (campaign) name."},{"name":"dsp_line_item_id","type":"TEXT","nullable":false,"description":"Amazon DSP line item identifier. A line item is an ad group in the new Amazon DSP naming."},{"name":"dsp_line_item_name","type":"TEXT","nullable":true,"description":"Amazon DSP line item (ad group) name."},{"name":"dsp_creative_id","type":"TEXT","nullable":false,"description":"Amazon DSP creative identifier."},{"name":"dsp_creative_name","type":"TEXT","nullable":true,"description":"Amazon DSP creative name."},{"name":"dsp_supply_source","type":"TEXT","nullable":true,"description":"Supply source (inventory exchange or publisher) as reported by Amazon DSP."},{"name":"dsp_supply_source_id","type":"TEXT","nullable":true,"description":"Supply source identifier as reported by Amazon DSP."},{"name":"dsp_content_show_title","type":"TEXT","nullable":true,"description":"Title of the show or content the ad ran in, as reported by Amazon DSP."},{"name":"dsp_content_rating","type":"TEXT","nullable":true,"description":"Content rating of the show, as reported by Amazon DSP."},{"name":"dsp_content_type","type":"TEXT","nullable":true,"description":"Content type of the show, as reported by Amazon DSP."},{"name":"dsp_content_genre","type":"TEXT","nullable":true,"description":"Content genre of the show, as reported by Amazon DSP. Often null because Amazon does not report a genre for every content."},{"name":"dsp_line_item_active_start_date","type":"TEXT","nullable":true,"description":"First day this content row delivered within the period, as delivered by Amazon DSP. Not the requested period start."},{"name":"dsp_line_item_active_end_date","type":"TEXT","nullable":true,"description":"Last day this content row delivered within the period, as delivered by Amazon DSP. Not the requested period end."},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Amazon DSP impressions in the period for this content row, after Amazon removed invalid traffic. Not additive across periods."},{"name":"ad_gross_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed, including invalid traffic (fraudulent, non-human, and other illegitimate impressions). ad_impressions excludes that traffic."},{"name":"ad_invalid_impressions","type":"NUMBER","nullable":false,"description":"Impressions removed by the traffic quality filter. Not included in ad_impressions."},{"name":"ad_cost_per_thousand_impressions","type":"NUMBER","nullable":true,"description":"Cost per thousand impressions reported by Amazon DSP, in the order currency. A rate: weight by ad_impressions when combining rows, never sum it."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP audio and video delivery (streaming TV, online video, audio) per advertiser, report period, order, line item, creative, supply source, and content (show title, rating, type, genre). Amazon DSP only (DataDoe DSP slot of a seller or vendor), refreshed once a day, not intraday. Rows map to a seller or vendor through seller_or_vendor_id, which is null when the DSP advertiser is not mapped. DSP order = campaign and line item = ad group in the new Amazon DSP naming. Impressions and cost per thousand impressions only: Amazon does not report cost totals or conversions in this report. Rows are rolling 7-day summaries starting every day: never sum across different periods (summing all dates overcounts about 7 times); pick one period.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":28},{"type":"RECURRING_MONTHLY","numberOfDays":56}],"sources":["connections","raw_ads_api_report_audio_and_video_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","streaming tv","online video","audio ads","show title"]},{"id":"60db932e1e7da5b17a2a0c7449493ab48ca4806fe8e5f2fddad31e9c93d77e83","name":"DSP Bid Adjustments by Date","tableName":"amazon_ads_dsp_bid_adjustments_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon marketplace of the DataDoe DSP slot the advertiser is fetched for."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe account identifier the DSP advertiser is mapped to, used by MCP/API calls (sellers_and_vendors_list, exports). Null when the advertiser is not mapped to a seller or vendor."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name of the mapped seller or vendor. Null when the advertiser is not mapped."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id of the mapped seller. Null for vendors, unmapped advertisers, and contexts without a seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":false,"description":"Amazon DSP advertiser identifier. Join amazon_sellers_and_vendors_context on organization_id, store_id, ads_dsp_connection_id = ads_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_name","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser name."},{"name":"date","type":"DATE","nullable":false,"description":"Report date (Amazon DSP daily report)."},{"name":"dt_created","type":"DATE","nullable":false,"description":"Timestamp when DataDoe first stored this row."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last updated this row."},{"name":"dsp_order_id","type":"TEXT","nullable":false,"description":"Amazon DSP order identifier. An order is a campaign in the new Amazon DSP naming."},{"name":"dsp_order_name","type":"TEXT","nullable":true,"description":"Amazon DSP order (campaign) name."},{"name":"dsp_line_item_id","type":"TEXT","nullable":false,"description":"Amazon DSP line item identifier. A line item is an ad group in the new Amazon DSP naming."},{"name":"dsp_line_item_name","type":"TEXT","nullable":true,"description":"Amazon DSP line item (ad group) name."},{"name":"dsp_bid_adjustment_rule_id","type":"TEXT","nullable":false,"description":"Amazon DSP bid adjustment rule identifier."},{"name":"dsp_bid_adjustment_rule_name","type":"TEXT","nullable":true,"description":"Bid adjustment rule as reported by Amazon DSP."},{"name":"dsp_bid_adjustment_rule_version_id","type":"TEXT","nullable":true,"description":"Version of the bid adjustment rule that was applied."},{"name":"dsp_bid_adjustment_matched_term_ids","type":"TEXT","nullable":true,"description":"Identifiers of the rule terms the bids matched, as one value reported by Amazon DSP."},{"name":"dsp_bid_adjustment_matched_terms","type":"TEXT","nullable":true,"description":"Rule terms the bids matched, as reported by Amazon DSP."},{"name":"dsp_bid_adjustment","type":"NUMBER","nullable":true,"description":"Bid adjustment applied by the rule, as reported by Amazon DSP."},{"name":"ad_bids","type":"NUMBER","nullable":true,"description":"Number of bids placed with this rule and matched terms. A count."},{"name":"ad_win_rate","type":"NUMBER","nullable":true,"description":"Share of the bids that won the auction, as reported by Amazon DSP. A rate, not additive."},{"name":"ad_match_rate","type":"NUMBER","nullable":true,"description":"Match rate of the rule terms, as reported by Amazon DSP. A rate, not additive."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP bid adjustment rule activity per advertiser, date, line item, bid adjustment rule, and matched terms. Amazon DSP only (DataDoe DSP slot of a seller or vendor), refreshed once a day, not intraday. Rows map to a seller or vendor through seller_or_vendor_id, which is null when the DSP advertiser is not mapped. DSP order = campaign and line item = ad group in the new Amazon DSP naming. Only line items that use bid adjustment rules have rows; the table is empty for advertisers without bid adjustments. ad_win_rate and ad_match_rate are rates: never sum them across rows.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":28},{"type":"RECURRING_MONTHLY","numberOfDays":56}],"sources":["connections","raw_ads_api_report_bid_adjustment_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","bid adjustment","bid multiplier"]},{"id":"60fb0eb8c4c040e11ee7624db6165e0ff1c4435dee09dc7d64c74dd534e1270e","name":"Ads Brand Metrics","tableName":"amazon_ads_brand_metrics","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"brand_name","type":"TEXT","nullable":false,"description":null},{"name":"brand_id","type":"TEXT","nullable":true,"description":"Resolved at import time by joining brand_name against the report brandsInfo array; NULL if no match found."},{"name":"category_node_tree_name","type":"TEXT","nullable":false,"description":"Short catalog identifier, e.g. uk-hpc, uk-beauty."},{"name":"category_node_name","type":"TEXT","nullable":false,"description":"Slash-delimited category path, e.g. /Categories/Bath & Body."},{"name":"date","type":"DATE","nullable":false,"description":"Metrics computation date."},{"name":"lookback_period","type":"TEXT","nullable":false,"description":"Shopper window used to compute the metrics: 1w (one week), 1m (one month), or 1cm (one calendar month). Not an ads attribution window."},{"name":"awareness_index","type":"NUMBER","nullable":true,"description":"Awareness index. Percentile of this brand versus peers in the category. Not a 0–1 rate and not a shopper count. Brand Metrics covers all on-Amazon shopping, not only ad-attributed events."},{"name":"consideration_index","type":"NUMBER","nullable":true,"description":"Consideration index. Percentile of this brand versus peers in the category. Not a 0–1 rate and not a shopper count. Brand Metrics covers all on-Amazon shopping, not only ad-attributed events."},{"name":"sales_index","type":"NUMBER","nullable":true,"description":"Sales index. Percentile of this brand versus peers in the category. Not a 0–1 rate and not a shopper count. Brand Metrics covers all on-Amazon shopping, not only ad-attributed events."},{"name":"add_to_carts","type":"NUMBER","nullable":true,"description":"Shoppers who added this brand to cart in the category and lookback. A shopper count, not ad-attributed add-to-carts."},{"name":"add_to_carts_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"add_to_carts_category_performers","type":"NUMBER","nullable":true,"description":null},{"name":"add_to_carts_roe_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"add_to_carts_roe_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"add_to_carts_return_on_engagement","type":"NUMBER","nullable":true,"description":"Return on engagement: average sales over the following year from shoppers who were in this funnel state 12 months ago. A currency amount, not a rate, and not ad-attributed sales."},{"name":"brand_customers","type":"NUMBER","nullable":true,"description":"Shoppers who purchased and account for the bottom 90% of this brand’s sales in the category and lookback. High-value customers are the top 10%."},{"name":"brand_customers_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"brand_customers_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"brand_customers_roe_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"brand_customers_roe_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"brand_customers_return_on_engagement","type":"NUMBER","nullable":true,"description":"Return on engagement: average sales over the following year from shoppers who were in this funnel state 12 months ago. A currency amount, not a rate, and not ad-attributed sales."},{"name":"branded_searches_and_detail_page_views","type":"NUMBER","nullable":true,"description":"Shoppers who searched the brand and viewed a detail page in the category and lookback. A shopper count, not ad impressions."},{"name":"branded_searches_and_detail_page_views_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"branded_searches_and_detail_page_views_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"branded_searches_and_detail_page_views_roe_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"branded_searches_and_detail_page_views_roe_cat_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"branded_searches_and_detail_page_views_return_on_engagement","type":"NUMBER","nullable":true,"description":"Return on engagement: average sales over the following year from shoppers who were in this funnel state 12 months ago. A currency amount, not a rate, and not ad-attributed sales."},{"name":"branded_searches_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"branded_searches_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"branded_searches_only","type":"NUMBER","nullable":true,"description":"Shoppers who searched the brand and did not engage further or purchase in the category and lookback."},{"name":"customer_conversion_rate","type":"NUMBER","nullable":true,"description":"Share of shoppers who moved from considering this brand to purchasing in the lookback. A percentage, not an order count."},{"name":"customer_conversion_rate_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"customer_conversion_rate_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"engaged_shopper_rate_category_median_lower_bound","type":"NUMBER","nullable":true,"description":null},{"name":"engaged_shopper_rate_category_median_upper_bound","type":"NUMBER","nullable":true,"description":null},{"name":"engaged_shopper_rate_category_top_performers_lower_bound","type":"NUMBER","nullable":true,"description":null},{"name":"engaged_shopper_rate_category_top_performers_upper_bound","type":"NUMBER","nullable":true,"description":null},{"name":"engaged_shopper_rate_lower_bound","type":"NUMBER","nullable":true,"description":"Lower bound of engaged-shopper rate: unique shoppers this brand engaged or who purchased, divided by unique shoppers with at least one detail-page view in the category. A percentage bound, not a shopper count."},{"name":"engaged_shopper_rate_upper_bound","type":"NUMBER","nullable":true,"description":"Upper bound of the same engaged-shopper rate. Read with engaged_shopper_rate_lower_bound."},{"name":"high_value_customers","type":"NUMBER","nullable":true,"description":"Top 10% of shoppers by sales contribution for this brand in the category and lookback. brand_customers is the other 90%."},{"name":"high_value_customers_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"high_value_customers_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"high_value_customers_roe_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"high_value_customers_roe_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"high_value_customers_return_on_engagement","type":"NUMBER","nullable":true,"description":"Return on engagement: average sales over the following year from shoppers who were in this funnel state 12 months ago. A currency amount, not a rate, and not ad-attributed sales."},{"name":"new_to_brand_customer_rate","type":"NUMBER","nullable":true,"description":"Share of customers who had not purchased this brand in the prior 12 months and did purchase in the lookback. A percentage, not a customer count."},{"name":"new_to_brand_customer_rate_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"new_to_brand_customer_rate_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"new_to_brand_sns_customers_rate","type":"NUMBER","nullable":true,"description":"Share of new-to-brand customers who are Subscribe & Save customers. A percentage, not a customer count."},{"name":"new_to_brand_sns_customers_rate_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"new_to_brand_sns_customers_rate_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"total_sns_customers","type":"NUMBER","nullable":true,"description":"Subscribe & Save customers of this brand in the category and lookback. A customer count."},{"name":"total_sns_customers_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"total_sns_customers_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"viewed_detail_page_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"viewed_detail_page_category_top_performers","type":"NUMBER","nullable":true,"description":null},{"name":"viewed_detail_page_only","type":"NUMBER","nullable":true,"description":"Shoppers who viewed a detail page and did not engage further or purchase in the category and lookback."},{"name":"viewed_detail_page_only_return_on_engagement","type":"NUMBER","nullable":true,"description":"Return on engagement: average sales over the following year from shoppers who were in this funnel state 12 months ago. A currency amount, not a rate, and not ad-attributed sales."},{"name":"viewed_detail_page_roe_category_median","type":"NUMBER","nullable":true,"description":null},{"name":"viewed_detail_page_roe_category_top_performers","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Ads Brand Metrics: brand-level awareness, consideration, and sales indices plus the shopping funnel (branded searches, detail-page views, add-to-carts, brand customers, high-value customers, return on engagement), by brand, category node, computation date, and lookback. Indices are percentiles versus peers, not 0–1 rates. This is all on-Amazon shopping, not ad-attributed performance. Sparse — most metric columns are NULL for a given row. Columns ending in _category_median are the peer median. Columns ending in _category_top_performers or _category_performers are the average of the 95th–99th percentile of peers. Columns ending in _return_on_engagement, or containing _roe_, are return on engagement (currency), not rates.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":95},{"type":"RECURRING_WEEKLY","numberOfDays":95}],"sources":["connections","raw_ads_api_report_brand_metrics"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["awareness index","consideration","brand funnel"]},{"id":"8a25dd3f6a89b7294ac0a23803daa286c57e566258e2b823d8c44b40d4403812","name":"Ads Attribution Performance by Creative","tableName":"amazon_ads_attribution_performance_by_creative_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":"Date the off-Amazon click or attributed on-Amazon event occurred. Attribution is 14-day last-click via Amazon Attribution tags, not a Sponsored Ads attribution window."},{"name":"campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"creative_id","type":"TEXT","nullable":false,"description":"Amazon Attribution creative / tagged link identifier."},{"name":"publisher","type":"TEXT","nullable":false,"description":"Off-Amazon publisher that served the tagged link."},{"name":"advertiser_name","type":"TEXT","nullable":true,"description":null},{"name":"click_throughs","type":"NUMBER","nullable":true,"description":"Clicks on the Attribution tag. Rows with fewer than 10 lifetime clicks are masked (metrics 0)."},{"name":"attributed_detail_page_views_clicks_14d","type":"NUMBER","nullable":true,"description":"14-day last-click attributed detail page views for promoted products from off-Amazon traffic."},{"name":"attributed_add_to_cart_clicks_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_purchases_14d","type":"NUMBER","nullable":true,"description":null},{"name":"units_sold_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_sales_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_total_detail_page_views_clicks_14d","type":"NUMBER","nullable":true,"description":"Promoted plus brand-halo 14-day last-click attributed detail page views."},{"name":"attributed_total_add_to_cart_clicks_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_total_purchases_14d","type":"NUMBER","nullable":true,"description":null},{"name":"total_units_sold_14d","type":"NUMBER","nullable":true,"description":null},{"name":"total_attributed_sales_14d","type":"NUMBER","nullable":true,"description":null},{"name":"kindle_edition_normalized_pages_read_14d","type":"NUMBER","nullable":true,"description":null},{"name":"kindle_edition_normalized_pages_royalties_14d","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Attribution Performance by Creative: off-Amazon traffic measured by Amazon Attribution tags (14-day last-click), not Sponsored Ads conversion windows. One row per date, campaign, ad group, creative, and publisher. Use amazon_ads_attribution_performance_by_ad_group_by_date for totals and Brand Referral Bonus. Never sum creative rows up to ad-group or campaign level — Amazon masks rows with fewer than 10 lifetime clicks (metrics are 0) and creative totals will not match ad-group totals.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":395},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_ads_api_report_attribution_performance_creative"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["amazon attribution","off-amazon","external traffic","publisher","attribution tag"]},{"id":"47e100b3b3342182eb17ce4cad2825200bb14d9bb5455de84b1a3f01ac189d88","name":"Ads Attribution Performance by Ad Group","tableName":"amazon_ads_attribution_performance_by_ad_group_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":"Date the off-Amazon click or attributed on-Amazon event occurred. Attribution is 14-day last-click via Amazon Attribution tags, not a Sponsored Ads attribution window."},{"name":"campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"publisher","type":"TEXT","nullable":false,"description":"Off-Amazon publisher that served the tagged link."},{"name":"advertiser_name","type":"TEXT","nullable":true,"description":null},{"name":"click_throughs","type":"NUMBER","nullable":true,"description":"Clicks on the Attribution tag. Rows with fewer than 10 lifetime clicks are masked (metrics 0)."},{"name":"attributed_detail_page_views_clicks_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_add_to_cart_clicks_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_purchases_14d","type":"NUMBER","nullable":true,"description":null},{"name":"units_sold_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_sales_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_total_detail_page_views_clicks_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_total_add_to_cart_clicks_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_total_purchases_14d","type":"NUMBER","nullable":true,"description":null},{"name":"total_units_sold_14d","type":"NUMBER","nullable":true,"description":null},{"name":"total_attributed_sales_14d","type":"NUMBER","nullable":true,"description":null},{"name":"brb_bonus_amount","type":"NUMBER","nullable":true,"description":"Estimated ad-attributed Brand Referral Bonus credit in local currency. Only at ad-group level, only when the seller is enrolled in BRB; otherwise NULL."},{"name":"kindle_edition_normalized_pages_read_14d","type":"NUMBER","nullable":true,"description":null},{"name":"kindle_edition_normalized_pages_royalties_14d","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Attribution Performance by Ad Group: off-Amazon traffic measured by Amazon Attribution tags (14-day last-click), not Sponsored Ads conversion windows. Use this table for ad-group or campaign totals and for Brand Referral Bonus (brb_bonus_amount). Do not sum amazon_ads_attribution_performance_by_creative_by_date to this grain. BRB is present only for enrolled sellers and only at ad-group level. Rows with fewer than 10 lifetime clicks are masked (metrics 0).","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":395},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_ads_api_report_attribution_performance_ad_group"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["amazon attribution","off-amazon","external traffic","publisher","attribution tag","brand referral bonus","brb"]},{"id":"a9d3ab27839f888bac306295dad8c65ea2c95491d72738a8d5e512e26a510b70","name":"Ads Attribution Products","tableName":"amazon_ads_attribution_products_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":"Date the off-Amazon click or attributed on-Amazon event occurred. Attribution is 14-day last-click via Amazon Attribution tags, not a Sponsored Ads attribution window."},{"name":"campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"publisher","type":"TEXT","nullable":false,"description":"Off-Amazon publisher that served the tagged link."},{"name":"advertiser_name","type":"TEXT","nullable":true,"description":null},{"name":"brand_name","type":"TEXT","nullable":true,"description":null},{"name":"marketplace","type":"TEXT","nullable":true,"description":null},{"name":"product_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":true,"description":null},{"name":"product_group","type":"TEXT","nullable":true,"description":null},{"name":"product_category","type":"TEXT","nullable":true,"description":null},{"name":"product_subcategory","type":"TEXT","nullable":true,"description":null},{"name":"product_conversion_type","type":"TEXT","nullable":false,"description":"Whether the conversion happened on a promoted or brand-halo ASIN."},{"name":"attributed_detail_page_views_clicks_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_add_to_cart_clicks_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_purchases_14d","type":"NUMBER","nullable":true,"description":null},{"name":"units_sold_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_sales_14d","type":"NUMBER","nullable":true,"description":null},{"name":"brand_halo_detail_page_views_clicks_14d","type":"NUMBER","nullable":true,"description":null},{"name":"brand_halo_attributed_add_to_cart_clicks_14d","type":"NUMBER","nullable":true,"description":null},{"name":"brand_halo_attributed_purchases_14d","type":"NUMBER","nullable":true,"description":null},{"name":"brand_halo_units_sold_14d","type":"NUMBER","nullable":true,"description":null},{"name":"brand_halo_attributed_sales_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_new_to_brand_purchases_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_new_to_brand_units_sold_14d","type":"NUMBER","nullable":true,"description":null},{"name":"attributed_new_to_brand_sales_14d","type":"NUMBER","nullable":true,"description":null},{"name":"brand_halo_new_to_brand_purchases_14d","type":"NUMBER","nullable":true,"description":null},{"name":"brand_halo_new_to_brand_units_sold_14d","type":"NUMBER","nullable":true,"description":null},{"name":"brand_halo_new_to_brand_sales_14d","type":"NUMBER","nullable":true,"description":null},{"name":"kindle_edition_normalized_pages_read_14d","type":"NUMBER","nullable":true,"description":null},{"name":"kindle_edition_normalized_pages_royalties_14d","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Attribution Products: off-Amazon traffic measured by Amazon Attribution tags (14-day last-click), not Sponsored Ads conversion windows. Top 100 products per campaign, always at ad-group grain. Use amazon_ads_attribution_performance_by_ad_group_by_date for totals and BRB. Rows with fewer than 10 lifetime clicks are masked (metrics 0). History is last 90 days.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":89},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_ads_api_report_attribution_products"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["amazon attribution","off-amazon","external traffic","publisher","attribution tag"]},{"id":"bbba3d213ac78ccbaf22cfa68eecb3f475641f49da26d51d1ac36446310051e3","name":"Keyword Targeting Performance","tableName":"amazon_ads_targeting_by_campaign_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"ad_targeting_text","type":"TEXT","nullable":false,"description":"Targeting expression text. For keywords this matches ad_keyword. Not the customer search query."},{"name":"ad_targeting_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_keyword_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_keyword","type":"TEXT","nullable":false,"description":"Keyword text, or a representation of the product-target expression. Not the customer search query."},{"name":"ad_keyword_expression","type":"TEXT","nullable":false,"description":"Raw targeting expression when the target is not a plain keyword."},{"name":"ad_keyword_status","type":"TEXT","nullable":false,"description":null},{"name":"ad_match_type","type":"TEXT","nullable":false,"description":"Keyword match type BROAD, PHRASE, or EXACT. Product targets use TARGETING_EXPRESSION or TARGETING_EXPRESSION_PREDEFINED."},{"name":"ad_matched_target_asin","type":"TEXT","nullable":false,"description":"ASIN of the product target that matched, when the target is a product. Null for keyword targets."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":null},{"name":"ad_portfolio_id","type":"TEXT","nullable":true,"description":"Portfolio ID for SPONSORED_PRODUCTS and SPONSORED_TELEVISION campaigns. For SPONSORED_BRANDS and SPONSORED_DISPLAY this field is always NULL."},{"name":"ad_portfolio_name","type":"TEXT","nullable":true,"description":"Portfolio name for SPONSORED_PRODUCTS and SPONSORED_TELEVISION campaigns. For SPONSORED_BRANDS and SPONSORED_DISPLAY this field is always NULL."},{"name":"ad_campaign_status","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_budget_amount","type":"NUMBER","nullable":false,"description":"Campaign budget repeated on every row of the campaign. Do not sum it across ASINs, keywords, placements, or dates. ad_campaign_budget_type is DAILY_BUDGET or LIFETIME_BUDGET."},{"name":"ad_campaign_budget_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_budget_currency","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed ad orders (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_orders_same_sku","type":"NUMBER","nullable":false,"description":"Attributed orders of the advertised SKU only (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Excludes brand-halo orders of other SKUs."},{"name":"ad_units_sold_click","type":"NUMBER","nullable":false,"description":"Units sold attributed to a click. Excludes view-through units. Sponsored Brands uses 14 days."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed ad sales (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":null},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed after Amazon removed invalid traffic. Gross impressions, including invalid traffic, are ad_gross_impressions."},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Clicks after Amazon removed invalid traffic. Gross clicks, including invalid traffic, are ad_gross_click_throughs."},{"name":"ad_top_of_search_impression_share","type":"NUMBER","nullable":false,"description":"Top-of-search impression share: top-of-search impressions earned divided by the top-of-search impressions the target was eligible for. A percentage, not an impression count. Sponsored Products and Sponsored Brands use a 90-day lookback."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Keyword and product-target performance per target and date for Sponsored Products, Sponsored Brands, Sponsored Display, and Sponsored Television. ad_keyword is the target; the customer query that matched it is amazon_ads_search_terms_by_campaign_by_date.ad_search_term. Do not sum this table into campaign totals.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_TARGETS_ADD","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_FIND","relation":"live"}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":21},{"type":"RECURRING_MONTHLY","numberOfDays":49}],"sources":["connections","raw_ads_api_report_legacy_targeting_sb_all","raw_ads_api_report_targeting_sd","raw_ads_api_report_targeting_sp","raw_ads_api_report_targeting_st"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["keyword","keywords","product target","match type"]},{"id":"e94e9671989ce4aa2814ac729807c7ddcc1cc47a71ebcd75d9fe661ed80335be","name":"Search Term Performance (Ads)","tableName":"amazon_ads_search_terms_by_campaign_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"ad_targeting_text","type":"TEXT","nullable":false,"description":null},{"name":"ad_keyword_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_keyword","type":"TEXT","nullable":false,"description":"Keyword or product target the customer query matched. Not the query itself."},{"name":"ad_keyword_status","type":"TEXT","nullable":false,"description":null},{"name":"ad_search_term","type":"TEXT","nullable":false,"description":"Search query the customer typed. Not the keyword or target."},{"name":"ad_search_term_no","type":"TEXT","nullable":false,"description":"Identifier for de-duplication of search terms."},{"name":"ad_match_type","type":"TEXT","nullable":false,"description":"Keyword match type BROAD, PHRASE, or EXACT. Product targets use TARGETING_EXPRESSION or TARGETING_EXPRESSION_PREDEFINED."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"SPONSORED_BRANDS or SPONSORED_PRODUCTS."},{"name":"ad_portfolio_id","type":"TEXT","nullable":true,"description":"Portfolio ID for SPONSORED_PRODUCTS campaigns. For SPONSORED_BRANDS this field is always NULL."},{"name":"ad_portfolio_name","type":"TEXT","nullable":true,"description":"Portfolio name for SPONSORED_PRODUCTS campaigns. For SPONSORED_BRANDS this field is always NULL."},{"name":"ad_campaign_status","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_budget_amount","type":"NUMBER","nullable":false,"description":null},{"name":"ad_campaign_budget_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_budget_currency","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_units_sold_click","type":"NUMBER","nullable":false,"description":"Units sold attributed to a click. Excludes view-through units. Sponsored Brands uses 14 days."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed ad sales (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed ad orders (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_orders_same_sku","type":"NUMBER","nullable":false,"description":"Attributed orders of the advertised SKU only (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Excludes brand-halo orders of other SKUs."},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":null},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed after Amazon removed invalid traffic. Gross impressions, including invalid traffic, are ad_gross_impressions."},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Clicks after Amazon removed invalid traffic. Gross clicks, including invalid traffic, are ad_gross_click_throughs."},{"name":"ad_click_through_rate","type":"NUMBER","nullable":false,"description":"Clicks divided by impressions. A rate, not a click count."},{"name":"ad_keyword_bid","type":"NUMBER","nullable":false,"description":"Bid on the keyword or targeting expression. Not spend."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer search queries that matched an advertised keyword or product target, for Sponsored Products and Sponsored Brands. ad_search_term is the shopper query; ad_keyword is the target it matched. Not Brand Analytics search terms and not Search Query Performance.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_TARGETS_ADD","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_FIND","relation":"live"}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":60},{"type":"RECURRING_DAILY","numberOfDays":21},{"type":"RECURRING_MONTHLY","numberOfDays":49}],"sources":["connections","raw_ads_api_report_legacy_search_term_sb_all","raw_ads_api_report_search_term_sp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["search term report","customer query"]},{"id":"37428539177e40d6d5da3b1af0589cb8b1042624ebf676242e680b1e01974bde","name":"Ad Profit by Target and Date","tableName":"amazon_ads_profit_by_target_and_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"currency","type":"TEXT","nullable":false,"description":"Reported currency, falling back to the marketplace currency when missing or blank. Used for ad metrics and cost matching.","definition":"resolveCurrency(target report ad_campaign_budget_currency, marketplace_id)"},{"name":"date","type":"DATE","nullable":false,"description":"Amazon Ads report click date in the marketplace timezone.","definition":"target report date"},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"Sponsored Products, Brands, Display or Television campaign type.","definition":"target report ad_campaign_type"},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":"Amazon Ads campaign ID. Use with ad_group_id and the target ID for Actions.","definition":"target report ad_campaign_id"},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":"Amazon Ads ad group ID.","definition":"target report ad_group_id"},{"name":"ad_group_name","type":"TEXT","nullable":false,"description":null},{"name":"target_entity_type","type":"TEXT","nullable":false,"description":"KEYWORD, PRODUCT_OR_AUTO_TARGET, BRANDS_TARGET, DISPLAY_TARGET or TELEVISION_TARGET. Distinguishes a bid target from a shopper query.","definition":"campaign type and target match type"},{"name":"ad_target_id","type":"TEXT","nullable":false,"description":"Amazon target ID for non-keyword targets; null for Sponsored Products keyword targets. Use action_target_id with campaign and ad group IDs for Actions.","definition":"non-keyword target identifier from the targeting report"},{"name":"ad_keyword_id","type":"TEXT","nullable":false,"description":"Amazon keyword ID for Sponsored Products keyword targets; null for product or automatic targets.","definition":"targeting report keywordId when match type is BROAD, EXACT or PHRASE"},{"name":"ad_keyword","type":"TEXT","nullable":false,"description":"Keyword text or target expression. This is not a shopper search term."},{"name":"ad_targeting_text","type":"TEXT","nullable":false,"description":"Targeting expression reported by Amazon Ads."},{"name":"ad_match_type","type":"TEXT","nullable":false,"description":"Keyword match type BROAD, PHRASE, or EXACT. Product targets use TARGETING_EXPRESSION or TARGETING_EXPRESSION_PREDEFINED."},{"name":"action_target_id","type":"TEXT","nullable":false,"description":"Keyword or target ID to pass as targetId to target Actions, with the Ads connection, campaign and ad group IDs. For search terms this is the parent entity ID, never the shopper query.","definition":"target report: coalesce(ad_targeting_id, ad_keyword_id); search-term report: ad_keyword_id"},{"name":"ad_keyword_status","type":"TEXT","nullable":false,"description":"Keyword or target status carried from the performance report, when available."},{"name":"ad_campaign_status","type":"TEXT","nullable":false,"description":"Campaign status carried from the performance report, when available."},{"name":"ad_portfolio_id","type":"TEXT","nullable":false,"description":"Portfolio ID carried from the performance report, when available."},{"name":"ad_portfolio_name","type":"TEXT","nullable":false,"description":"Portfolio name matched by Ads connection and portfolio ID, when available."},{"name":"ad_keyword_bid","type":"NUMBER","nullable":false,"description":"Bid recorded in the performance report. This historical value can differ from the latest target bid.","definition":"Sponsored Products targeting keywordBid, or search-term report ad_keyword_bid; null when unavailable"},{"name":"ad_target_bid","type":"NUMBER","nullable":false,"description":"Latest fetched target or keyword bid from the existing target export. Null when no matching exported target is available. Refresh with target Actions before changing a bid.","definition":"amazon_ads_targets_raw.ad_target_bid matched by Organization, Store, marketplace, Ads connection, campaign type, campaign, ad group and action_target_id"},{"name":"ad_target_state","type":"TEXT","nullable":false,"description":"Latest fetched target state from the target export; null when unavailable.","definition":"matched amazon_ads_targets_raw.ad_target_state"},{"name":"ad_target_updated_at_utc","type":"DATE","nullable":false,"description":"Amazon update time for the exported target whose bid and state are shown.","definition":"matched amazon_ads_targets_raw.ad_target_updated_at_utc"},{"name":"attribution_window_days","type":"NUMBER","nullable":false,"description":"Click attribution window: seven days for Sponsored Products, 14 for Sponsored Brands; null when unavailable.","definition":"ad_campaign_type === 'SPONSORED_PRODUCTS' ? 7 : ad_campaign_type === 'SPONSORED_BRANDS' ? 14 : null"},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":"Spend reported for this target or search term on the click date.","definition":"source targeting or search-term report cost"},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Sales attributed to clicks on this date within the report attribution window. This is not shipped-order revenue.","definition":"source targeting or search-term report attributed sales"},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Purchases attributed to clicks within the report attribution window.","definition":"source targeting or search-term report purchases"},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Units attributed to clicks, when the source report supplies them.","definition":"source targeting or search-term report units sold from clicks"},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Impressions reported for this target or search term.","definition":"source targeting or search-term report impressions"},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Clicks reported for this target or search term.","definition":"source targeting or search-term report clicks"},{"name":"ad_sales_same_sku","type":"NUMBER","nullable":false,"description":"Sponsored Products attributed sales of the advertised SKU within seven days. Null for other ad types.","definition":"raw Sponsored Products attributedSalesSameSku7d"},{"name":"ad_sales_other_sku","type":"NUMBER","nullable":false,"description":"Sponsored Products attributed sales of SKUs other than the advertised SKU within seven days.","definition":"raw Sponsored Products salesOtherSku7d"},{"name":"ad_units_same_sku","type":"NUMBER","nullable":false,"description":"Sponsored Products units of the advertised SKU attributed within seven days.","definition":"raw Sponsored Products unitsSoldSameSku7d"},{"name":"ad_units_other_sku","type":"NUMBER","nullable":false,"description":"Sponsored Products units of other SKUs attributed within seven days.","definition":"raw Sponsored Products unitsSoldOtherSku7d"},{"name":"purchased_product_other_sku_sales","type":"NUMBER","nullable":false,"description":"Target-level sum of seven-day other-SKU sales from the purchased-products report. Null for search terms and unsupported ad types.","definition":"sum(raw Sponsored Products purchased-products salesOtherSku7d) by target and date"},{"name":"purchased_product_sales_delta","type":"NUMBER","nullable":false,"description":"Target other-SKU sales minus purchased-product other-SKU sales. The difference remains visible even when it is within the accepted tolerance.","definition":"ad_sales_other_sku - coalesce(purchased_product_other_sku_sales, 0)"},{"name":"estimated_cogs_same_sku","type":"NUMBER","nullable":false,"description":"Estimated COGS for same-SKU sales. Target rows use ad-group advertised-product unit mix; search-term rows inherit the parent target cost per same-SKU sale.","definition":"same-SKU units times promoted-product unit COGS mix, or search-term same-SKU sales times parent same-SKU COGS divided by parent same-SKU sales"},{"name":"estimated_cogs_other_sku","type":"NUMBER","nullable":false,"description":"Estimated COGS for other-SKU sales. Target rows use purchased ASIN units and scale costs to reported other-SKU sales within the reconciliation tolerance. Search-term rows inherit the parent target cost per other-SKU sale.","definition":"target: sum(purchased ASIN units * estimated unit COGS) * ad_sales_other_sku / purchased_product_other_sku_sales; search term: other-SKU sales * parent other-SKU COGS / parent other-SKU sales"},{"name":"estimated_variable_fees_same_sku","type":"NUMBER","nullable":false,"description":"Estimated same-SKU order fees from the advertised-product mix and preceding 90 days of SKU ORDER settlements. Uses the account profit fee definition; excludes refunds.","definition":"same-SKU units times historical per-unit fee mix, or search-term same-SKU sales times parent fees divided by parent same-SKU sales"},{"name":"estimated_variable_fees_other_sku","type":"NUMBER","nullable":false,"description":"Estimated other-SKU order fees from purchased ASINs and preceding 90 days of SKU ORDER settlements, scaled within the reconciliation tolerance. Excludes refunds.","definition":"target: sum(purchased ASIN units * historical unit fees) * ad_sales_other_sku / purchased_product_other_sku_sales; search term: other-SKU sales * parent other-SKU fees / parent other-SKU sales"},{"name":"estimated_cogs","type":"NUMBER","nullable":false,"description":"Sum of estimated same- and other-SKU COGS. Null when either sold component cannot be costed.","definition":"estimated_cogs_same_sku + estimated_cogs_other_sku when all sold components are costed"},{"name":"cogs_present","type":"LOGIC","nullable":true,"description":"True when positive Sponsored Products sales match the same- and other-SKU split within 0.01 and every positive component has a COGS estimate. False if the split or an estimate is missing or the split does not match; null when reported sales are not positive or this campaign type does not support cost estimates."},{"name":"estimated_variable_fees","type":"NUMBER","nullable":false,"description":"Estimated order fees, net of order credits, using the same fee families as account profit: referral, closing, digital services, fulfillment (including handling, pick and pack, transportation and order-level return charges), technology and seller-funded promotions. Excludes refunds, advertising, seller-retained tax and posted-date fees such as storage, subscription, inbound and disposal. Null without sufficient history.","definition":"estimated_variable_fees_same_sku + estimated_variable_fees_other_sku; per-SKU unit fee = orderDateTotalFeesSum(ORDER settlements in preceding 90 days) / sum(order-SKU quantities counted once across split settlement rows), scoped to seller connection, marketplace and currency"},{"name":"estimated_contribution_before_ads","type":"NUMBER","nullable":false,"description":"Attributed sales less estimated COGS and variable fees, before ad spend. Null for incomplete costs.","definition":"ad_sales - estimated_cogs - estimated_variable_fees"},{"name":"estimated_profit_after_ads","type":"NUMBER","nullable":false,"description":"Attributed contribution less reported spend, excluding refunds. Recent rows are provisional until attribution matures and remain in daily profit summaries. This estimate must not be added to account P&L.","definition":"estimated_contribution_before_ads - coalesce(ad_spend, 0)"},{"name":"estimated_break_even_acos","type":"NUMBER","nullable":false,"description":"Maximum ad spend divided by attributed sales that leaves estimated contribution after ads at zero. Ratio, not percent; null with no sales or incomplete costs.","definition":"estimated_contribution_before_ads / ad_sales"},{"name":"acos","type":"NUMBER","nullable":false,"description":"Reported ad spend divided by attributed sales. Ratio, not percent; null with no sales.","definition":"ad_spend / ad_sales"},{"name":"costed_sales","type":"NUMBER","nullable":false,"description":"Attributed sales from rows with a non-null profit estimate, including provisional rows.","definition":"estimated_profit_after_ads is not null ? ad_sales : 0"},{"name":"unsupported_sales","type":"NUMBER","nullable":false,"description":"Attributed sales from ad types without product attribution for estimating profit.","definition":"ad_campaign_type !== 'SPONSORED_PRODUCTS' ? ad_sales : 0"},{"name":"missing_cost_sales","type":"NUMBER","nullable":false,"description":"Sponsored Products sales on rows without a profit estimate because costs, parent target data or reconciliation are incomplete. Includes the whole row, even if one sales component has costs.","definition":"ad_campaign_type === 'SPONSORED_PRODUCTS' && ad_sales > 0 && estimated_profit_after_ads is null ? ad_sales : 0"},{"name":"cost_coverage_rate","type":"NUMBER","nullable":false,"description":"Share of same- and other-SKU sales components with COGS and fee estimates. May include a component of a row whose total profit is null. Ratio, not percent.","definition":"sum(same- and other-SKU sales components with COGS and fee estimates) / ad_sales"},{"name":"cost_assignment_method","type":"TEXT","nullable":false,"description":"Method used to assign product costs. Target costs use promoted-product and purchased-ASIN mix; search terms inherit parent target mix.","definition":"target: 'AD_GROUP_PROMOTED_MIX_AND_TARGET_PURCHASED_ASIN'; search term: 'PARENT_TARGET_SALES_MIX'; otherwise 'UNAVAILABLE'"},{"name":"profit_status","type":"TEXT","nullable":false,"description":"PENDING_ATTRIBUTION while a known attribution window is still open. Otherwise ESTIMATED, SPEND_ONLY, ATTRIBUTION_UNAVAILABLE, SELLER_CENTRAL_CONNECTION_UNAVAILABLE, MISSING_PRODUCT_COST_OR_FEE, PARENT_TARGET_UNAVAILABLE or PRODUCT_ATTRIBUTION_UNAVAILABLE. Pending rows can have provisional profit values.","definition":"pending attribution takes precedence; then campaign type, reported sales availability, parent availability, Seller Central connection and missing costs determine status"},{"name":"profitability_flag","type":"TEXT","nullable":false,"description":"Business reading of this daily estimate: PROFITABLE (at or above break-even), BELOW_BREAK_EVEN, NO_SALES_MATURE or INSUFFICIENT_DATA. Pending attribution is insufficient for a final decision. A single no-sales day is not a recommendation to pause a target.","definition":"immature: INSUFFICIENT_DATA; mature with zero sales and positive spend: NO_SALES_MATURE; null profit: INSUFFICIENT_DATA; positive sales and profit >= 0: PROFITABLE; negative profit: BELOW_BREAK_EVEN; otherwise INSUFFICIENT_DATA"},{"name":"excludes_refunds","type":"LOGIC","nullable":false,"description":"Always true. Estimates exclude refund revenue reversals, refund fees and returned-product cost recovery. Break-even ACoS is before the cost of refunds.","definition":"true"},{"name":"purchased_asin_cost_method","type":"TEXT","nullable":false,"description":"How purchased-ASIN unit costs are assigned: SINGLE_SKU, SHARED_SKU_COST, RECENT_ORDER_UNIT_MIX or MIXED across purchased ASINs. Search terms inherit this from the parent. Null without a purchased mix.","definition":"Within the seller connection, marketplace and currency, use a common unit cost when all known SKUs agree; otherwise weight available SKU costs by order quantities from the preceding 90 days. Require costs for every SKU with positive order weight; no supported weights means null costs. The SKU set comes from effective COGS and recent ORDER settlements."},{"name":"is_attribution_mature","type":"LOGIC","nullable":false,"description":"Whether the full report attribution window has elapsed since the click date in the marketplace timezone.","definition":"date <= marketplace current date - attribution_window_days"},{"name":"mature_spend_without_sales","type":"NUMBER","nullable":false,"description":"Reported spend with zero attributed sales after the attribution window has elapsed. Null otherwise.","definition":"is_attribution_mature && ad_sales === 0 ? ad_spend : null"}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"One row per target present in the collected reports and click date. Includes Sponsored Products keywords and product or automatic targets, Sponsored Brands product targets (excludes Brands keywords), and reported Display and Television targets. This is partial report coverage, not all account advertising. Spend and attributed sales are reported metrics. Sponsored Products COGS and fees are estimates from uploaded COGS, purchased ASINs, advertised-product mix and preceding 90 days of Seller Central ORDER settlements. For purchased ASINs with several SKUs, use shared unit costs or recent order quantities as weights within the seller connection. Accept purchased sales and units within max(2% of the target value, 0.01), and scale costs by target other-SKU sales / purchased sales. Other campaign types keep reported metrics but have null profit estimates. Refund costs are excluded and recent profit is provisional. This is an ad decision view; its profit does not add to amazon_profit_by_date.profit.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_TARGETS_FIND","relation":"live"},{"type":"AMAZON_ADS_TARGETS_UPDATE","relation":"writes"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_export_targets","raw_ads_api_report_targeting_sp","raw_ads_api_report_targeting_sd","raw_ads_api_report_targeting_st","raw_ads_api_report_legacy_targeting_sb_all","raw_ads_api_report_advertised_products_sp","raw_ads_api_report_purchased_products_sp","raw_amazon_cogs","raw_sp_api_report_orders","refined_sp_api_finances_transactions"],"containsPii":false,"initialLoadProgress":null},{"id":"68584bc4d0ab286c8125c768751f38c5e5e9e2692dd061e3d6d2d9ab7fb6a4e5","name":"Ad Profit by Search Term and Date","tableName":"amazon_ads_profit_by_search_term_and_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"currency","type":"TEXT","nullable":false,"description":"Reported currency, falling back to the marketplace currency when missing or blank.","definition":"resolveCurrency(search-term report ad_campaign_budget_currency, marketplace_id)"},{"name":"date","type":"DATE","nullable":false,"description":"Amazon Ads report click date in the marketplace timezone.","definition":"search-term report date"},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"SPONSORED_PRODUCTS or SPONSORED_BRANDS."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_name","type":"TEXT","nullable":false,"description":null},{"name":"target_entity_type","type":"TEXT","nullable":false,"description":"KEYWORD for Sponsored Brands, derived directly from its keyword search-term report. Sponsored Products inherits the matched parent type; null without a match.","definition":"Sponsored Brands: KEYWORD; otherwise parent amazon_ads_profit_by_target_and_date.target_entity_type"},{"name":"ad_target_id","type":"TEXT","nullable":false,"description":"Parent non-keyword target ID when the parent target can be matched.","definition":"parent amazon_ads_profit_by_target_and_date.ad_target_id"},{"name":"ad_keyword_id","type":"TEXT","nullable":false,"description":"Parent keyword ID from the Sponsored Brands search-term row or a matched Sponsored Products keyword. Use action_target_id for Actions.","definition":"search-term report keywordId for Sponsored Brands or matched Sponsored Products keyword targets"},{"name":"ad_keyword","type":"TEXT","nullable":false,"description":"Matched advertiser keyword or targeting expression, not the shopper query."},{"name":"ad_targeting_text","type":"TEXT","nullable":false,"description":null},{"name":"ad_match_type","type":"TEXT","nullable":false,"description":"Keyword match type BROAD, PHRASE, or EXACT. Product targets use TARGETING_EXPRESSION or TARGETING_EXPRESSION_PREDEFINED."},{"name":"action_target_id","type":"TEXT","nullable":false,"description":"Keyword or target ID to pass as targetId to target Actions, with the Ads connection, campaign and ad group IDs. For search terms this is the parent entity ID, never the shopper query.","definition":"target report: coalesce(ad_targeting_id, ad_keyword_id); search-term report: ad_keyword_id"},{"name":"ad_keyword_status","type":"TEXT","nullable":false,"description":"Keyword or target status carried from the performance report, when available."},{"name":"ad_campaign_status","type":"TEXT","nullable":false,"description":"Campaign status carried from the performance report, when available."},{"name":"ad_portfolio_id","type":"TEXT","nullable":false,"description":"Portfolio ID carried from the performance report, when available."},{"name":"ad_portfolio_name","type":"TEXT","nullable":false,"description":"Portfolio name matched by Ads connection and portfolio ID, when available."},{"name":"ad_keyword_bid","type":"NUMBER","nullable":false,"description":"Bid recorded in the performance report. This historical value can differ from the latest target bid.","definition":"Sponsored Products targeting keywordBid, or search-term report ad_keyword_bid; null when unavailable"},{"name":"ad_target_bid","type":"NUMBER","nullable":false,"description":"Latest fetched target or keyword bid from the existing target export. Null when no matching exported target is available. Refresh with target Actions before changing a bid.","definition":"amazon_ads_targets_raw.ad_target_bid matched by Organization, Store, marketplace, Ads connection, campaign type, campaign, ad group and action_target_id"},{"name":"ad_target_state","type":"TEXT","nullable":false,"description":"Latest fetched target state from the target export; null when unavailable.","definition":"matched amazon_ads_targets_raw.ad_target_state"},{"name":"ad_target_updated_at_utc","type":"DATE","nullable":false,"description":"Amazon update time for the exported target whose bid and state are shown.","definition":"matched amazon_ads_targets_raw.ad_target_updated_at_utc"},{"name":"attribution_window_days","type":"NUMBER","nullable":false,"description":"Click attribution window: seven days for Sponsored Products, 14 for Sponsored Brands; null when unavailable.","definition":"ad_campaign_type === 'SPONSORED_PRODUCTS' ? 7 : ad_campaign_type === 'SPONSORED_BRANDS' ? 14 : null"},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":"Spend reported for this target or search term on the click date.","definition":"source targeting or search-term report cost"},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Sales attributed to clicks on this date within the report attribution window. This is not shipped-order revenue.","definition":"source targeting or search-term report attributed sales"},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Purchases attributed to clicks within the report attribution window.","definition":"source targeting or search-term report purchases"},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Units attributed to clicks, when the source report supplies them.","definition":"source targeting or search-term report units sold from clicks"},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Impressions reported for this target or search term.","definition":"source targeting or search-term report impressions"},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Clicks reported for this target or search term.","definition":"source targeting or search-term report clicks"},{"name":"ad_sales_same_sku","type":"NUMBER","nullable":false,"description":"Sponsored Products attributed sales of the advertised SKU within seven days. Null for other ad types.","definition":"raw Sponsored Products attributedSalesSameSku7d"},{"name":"ad_sales_other_sku","type":"NUMBER","nullable":false,"description":"Sponsored Products attributed sales of SKUs other than the advertised SKU within seven days.","definition":"raw Sponsored Products salesOtherSku7d"},{"name":"ad_units_same_sku","type":"NUMBER","nullable":false,"description":"Sponsored Products units of the advertised SKU attributed within seven days.","definition":"raw Sponsored Products unitsSoldSameSku7d"},{"name":"ad_units_other_sku","type":"NUMBER","nullable":false,"description":"Sponsored Products units of other SKUs attributed within seven days.","definition":"raw Sponsored Products unitsSoldOtherSku7d"},{"name":"purchased_product_other_sku_sales","type":"NUMBER","nullable":false,"description":"Target-level sum of seven-day other-SKU sales from the purchased-products report. Null for search terms and unsupported ad types.","definition":"sum(raw Sponsored Products purchased-products salesOtherSku7d) by target and date"},{"name":"purchased_product_sales_delta","type":"NUMBER","nullable":false,"description":"Target other-SKU sales minus purchased-product other-SKU sales. The difference remains visible even when it is within the accepted tolerance.","definition":"ad_sales_other_sku - coalesce(purchased_product_other_sku_sales, 0)"},{"name":"estimated_cogs_same_sku","type":"NUMBER","nullable":false,"description":"Estimated COGS for same-SKU sales. Target rows use ad-group advertised-product unit mix; search-term rows inherit the parent target cost per same-SKU sale.","definition":"same-SKU units times promoted-product unit COGS mix, or search-term same-SKU sales times parent same-SKU COGS divided by parent same-SKU sales"},{"name":"estimated_cogs_other_sku","type":"NUMBER","nullable":false,"description":"Estimated COGS for other-SKU sales. Target rows use purchased ASIN units and scale costs to reported other-SKU sales within the reconciliation tolerance. Search-term rows inherit the parent target cost per other-SKU sale.","definition":"target: sum(purchased ASIN units * estimated unit COGS) * ad_sales_other_sku / purchased_product_other_sku_sales; search term: other-SKU sales * parent other-SKU COGS / parent other-SKU sales"},{"name":"estimated_variable_fees_same_sku","type":"NUMBER","nullable":false,"description":"Estimated same-SKU order fees from the advertised-product mix and preceding 90 days of SKU ORDER settlements. Uses the account profit fee definition; excludes refunds.","definition":"same-SKU units times historical per-unit fee mix, or search-term same-SKU sales times parent fees divided by parent same-SKU sales"},{"name":"estimated_variable_fees_other_sku","type":"NUMBER","nullable":false,"description":"Estimated other-SKU order fees from purchased ASINs and preceding 90 days of SKU ORDER settlements, scaled within the reconciliation tolerance. Excludes refunds.","definition":"target: sum(purchased ASIN units * historical unit fees) * ad_sales_other_sku / purchased_product_other_sku_sales; search term: other-SKU sales * parent other-SKU fees / parent other-SKU sales"},{"name":"estimated_cogs","type":"NUMBER","nullable":false,"description":"Sum of estimated same- and other-SKU COGS. Null when either sold component cannot be costed.","definition":"estimated_cogs_same_sku + estimated_cogs_other_sku when all sold components are costed"},{"name":"cogs_present","type":"LOGIC","nullable":true,"description":"True when positive Sponsored Products sales match the same- and other-SKU split within 0.01 and every positive component has a COGS estimate. False if the split or an estimate is missing or the split does not match; null when reported sales are not positive or this campaign type does not support cost estimates."},{"name":"estimated_variable_fees","type":"NUMBER","nullable":false,"description":"Estimated order fees, net of order credits, using the same fee families as account profit: referral, closing, digital services, fulfillment (including handling, pick and pack, transportation and order-level return charges), technology and seller-funded promotions. Excludes refunds, advertising, seller-retained tax and posted-date fees such as storage, subscription, inbound and disposal. Null without sufficient history.","definition":"estimated_variable_fees_same_sku + estimated_variable_fees_other_sku; per-SKU unit fee = orderDateTotalFeesSum(ORDER settlements in preceding 90 days) / sum(order-SKU quantities counted once across split settlement rows), scoped to seller connection, marketplace and currency"},{"name":"estimated_contribution_before_ads","type":"NUMBER","nullable":false,"description":"Attributed sales less estimated COGS and variable fees, before ad spend. Null for incomplete costs.","definition":"ad_sales - estimated_cogs - estimated_variable_fees"},{"name":"estimated_profit_after_ads","type":"NUMBER","nullable":false,"description":"Attributed contribution less reported spend, excluding refunds. Recent rows are provisional until attribution matures and remain in daily profit summaries. This estimate must not be added to account P&L.","definition":"estimated_contribution_before_ads - coalesce(ad_spend, 0)"},{"name":"estimated_break_even_acos","type":"NUMBER","nullable":false,"description":"Maximum ad spend divided by attributed sales that leaves estimated contribution after ads at zero. Ratio, not percent; null with no sales or incomplete costs.","definition":"estimated_contribution_before_ads / ad_sales"},{"name":"acos","type":"NUMBER","nullable":false,"description":"Reported ad spend divided by attributed sales. Ratio, not percent; null with no sales.","definition":"ad_spend / ad_sales"},{"name":"costed_sales","type":"NUMBER","nullable":false,"description":"Attributed sales from rows with a non-null profit estimate, including provisional rows.","definition":"estimated_profit_after_ads is not null ? ad_sales : 0"},{"name":"unsupported_sales","type":"NUMBER","nullable":false,"description":"Attributed sales from ad types without product attribution for estimating profit.","definition":"ad_campaign_type !== 'SPONSORED_PRODUCTS' ? ad_sales : 0"},{"name":"missing_cost_sales","type":"NUMBER","nullable":false,"description":"Sponsored Products sales on rows without a profit estimate because costs, parent target data or reconciliation are incomplete. Includes the whole row, even if one sales component has costs.","definition":"ad_campaign_type === 'SPONSORED_PRODUCTS' && ad_sales > 0 && estimated_profit_after_ads is null ? ad_sales : 0"},{"name":"cost_coverage_rate","type":"NUMBER","nullable":false,"description":"Share of same- and other-SKU sales components with COGS and fee estimates. May include a component of a row whose total profit is null. Ratio, not percent.","definition":"sum(same- and other-SKU sales components with COGS and fee estimates) / ad_sales"},{"name":"cost_assignment_method","type":"TEXT","nullable":false,"description":"Method used to assign product costs. Target costs use promoted-product and purchased-ASIN mix; search terms inherit parent target mix.","definition":"target: 'AD_GROUP_PROMOTED_MIX_AND_TARGET_PURCHASED_ASIN'; search term: 'PARENT_TARGET_SALES_MIX'; otherwise 'UNAVAILABLE'"},{"name":"profit_status","type":"TEXT","nullable":false,"description":"PENDING_ATTRIBUTION while a known attribution window is still open. Otherwise ESTIMATED, SPEND_ONLY, ATTRIBUTION_UNAVAILABLE, SELLER_CENTRAL_CONNECTION_UNAVAILABLE, MISSING_PRODUCT_COST_OR_FEE, PARENT_TARGET_UNAVAILABLE or PRODUCT_ATTRIBUTION_UNAVAILABLE. Pending rows can have provisional profit values.","definition":"pending attribution takes precedence; then campaign type, reported sales availability, parent availability, Seller Central connection and missing costs determine status"},{"name":"profitability_flag","type":"TEXT","nullable":false,"description":"Business reading of this daily estimate: PROFITABLE (at or above break-even), BELOW_BREAK_EVEN, NO_SALES_MATURE or INSUFFICIENT_DATA. Pending attribution is insufficient for a final decision. A single no-sales day is not a recommendation to pause a target.","definition":"immature: INSUFFICIENT_DATA; mature with zero sales and positive spend: NO_SALES_MATURE; null profit: INSUFFICIENT_DATA; positive sales and profit >= 0: PROFITABLE; negative profit: BELOW_BREAK_EVEN; otherwise INSUFFICIENT_DATA"},{"name":"excludes_refunds","type":"LOGIC","nullable":false,"description":"Always true. Estimates exclude refund revenue reversals, refund fees and returned-product cost recovery. Break-even ACoS is before the cost of refunds.","definition":"true"},{"name":"purchased_asin_cost_method","type":"TEXT","nullable":false,"description":"How purchased-ASIN unit costs are assigned: SINGLE_SKU, SHARED_SKU_COST, RECENT_ORDER_UNIT_MIX or MIXED across purchased ASINs. Search terms inherit this from the parent. Null without a purchased mix.","definition":"Within the seller connection, marketplace and currency, use a common unit cost when all known SKUs agree; otherwise weight available SKU costs by order quantities from the preceding 90 days. Require costs for every SKU with positive order weight; no supported weights means null costs. The SKU set comes from effective COGS and recent ORDER settlements."},{"name":"is_attribution_mature","type":"LOGIC","nullable":false,"description":"Whether the full report attribution window has elapsed since the click date in the marketplace timezone.","definition":"date <= marketplace current date - attribution_window_days"},{"name":"mature_spend_without_sales","type":"NUMBER","nullable":false,"description":"Reported spend with zero attributed sales after the attribution window has elapsed. Null otherwise.","definition":"is_attribution_mature && ad_sales === 0 ? ad_spend : null"},{"name":"ad_search_term","type":"TEXT","nullable":false,"description":"Shopper query or ASIN that matched the parent target. Not an Amazon Ads target entity ID.","definition":"search-term report searchTerm or query"},{"name":"search_term_kind","type":"TEXT","nullable":false,"description":"ASIN when the reported term has an ASIN-like shape; QUERY otherwise. This is a text classification.","definition":"ad_search_term matches /^B0[A-Z0-9]{8}$/i ? 'ASIN' : 'QUERY'"},{"name":"parent_target_id","type":"TEXT","nullable":false,"description":"Parent target or keyword ID for target Actions. Never use the shopper query itself as an entity ID.","definition":"coalesce(parent ad_target_id, search-term report keywordId)"},{"name":"cost_estimation_method","type":"TEXT","nullable":false,"description":"PARENT_TARGET_SAME_AND_OTHER_SKU_COST_PER_SALE for Sponsored Products; UNAVAILABLE otherwise.","definition":"campaign type determines whether parent target cost ratios can be used"}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"One row per reported shopper search term, parent target and click date for Sponsored Products and Brands. The report identifies the query and parent keyword or target but not the ASIN purchased for that query. Sponsored Products profit estimates inherit the parent target product mix and cost per same- or other-SKU sale. Sponsored Brands keeps spend, sales and keyword identity with null profit. Recent estimates are provisional and all estimates exclude refunds. Search-term totals overlap target totals and are not account P&L.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_TARGETS_FIND","relation":"live"},{"type":"AMAZON_ADS_TARGETS_UPDATE","relation":"writes"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_export_targets","raw_ads_api_report_search_term_sp","raw_ads_api_report_legacy_search_term_sb_all","raw_ads_api_report_targeting_sp","raw_ads_api_report_advertised_products_sp","raw_ads_api_report_purchased_products_sp","raw_amazon_cogs","raw_sp_api_report_orders","refined_sp_api_finances_transactions"],"containsPii":false,"initialLoadProgress":null},{"id":"3d720918e6b132db7d3b6edfb912428256b79d3cfba20f5bd2617037bf0cc5ef","name":"Ad Placement Performance (Sponsored Brands and Sponsored Products)","tableName":"amazon_ads_placement_by_campaign_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"SPONSORED_BRANDS or SPONSORED_PRODUCTS"},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_status","type":"TEXT","nullable":false,"description":null},{"name":"ad_placement_classification","type":"TEXT","nullable":false,"description":"Page location where the ad appeared, such as Top of Search, Rest of Search, or Product pages."},{"name":"ad_campaign_site","type":"TEXT","nullable":false,"description":"ALL or AMAZON_BUSINESS. Sponsored Products rows are split by site; Sponsored Brands rows use ALL."},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed after Amazon removed invalid traffic. Gross impressions, including invalid traffic, are ad_gross_impressions."},{"name":"ad_viewable_impressions","type":"NUMBER","nullable":false,"description":"Impressions Amazon counted as viewable. A count, not a rate."},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Clicks after Amazon removed invalid traffic. Gross clicks, including invalid traffic, are ad_gross_click_throughs."},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":null},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed ad sales (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_sales_same_sku","type":"NUMBER","nullable":false,"description":"Attributed sales of the advertised SKU only (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Excludes brand-halo purchases of other SKUs. Not total ad sales; campaign totals are amazon_ads_performance_by_campaign_by_date.ad_sales."},{"name":"ad_sales_new_to_brand_14d","type":"NUMBER","nullable":false,"description":"Sales from first-time customers of the brand in a 12-month lookback, within 14 days of an ad click or view. A currency amount, not a rate. Not available for book vendors."},{"name":"ad_sales_new_to_brand_14d_percentage","type":"NUMBER","nullable":false,"description":"Share of the matching total that is new-to-brand. Amazon reports this as a percentage, not a unit count. Not available for book vendors."},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed ad units sold (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_units_sold_new_to_brand_14d","type":"NUMBER","nullable":false,"description":"Units in new-to-brand orders within 14 days of an ad click or view. A count, not a rate. Not available for book vendors."},{"name":"ad_units_sold_new_to_brand_14d_percentage","type":"NUMBER","nullable":false,"description":"Share of the matching total that is new-to-brand. Amazon reports this as a percentage, not a unit count. Not available for book vendors."},{"name":"ad_campaign_budget_amount","type":"NUMBER","nullable":false,"description":null},{"name":"ad_campaign_budget_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_budget_currency","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_rule_based_budget_amount","type":"NUMBER","nullable":true,"description":"Rule-based campaign budget reported for this date for Sponsored Products, in ad_campaign_budget_currency. Repeated across placements; do not sum across placements or dates. Null when Amazon omits it and for other campaign types.","definition":"campaignRuleBasedBudgetAmount from the Sponsored Products report"},{"name":"ad_campaign_applicable_budget_rule_id","type":"TEXT","nullable":true,"description":"Identifier of the budget rule Amazon reports as applicable to the Sponsored Products campaign on this date. Null when Amazon omits it and for other campaign types. Does not expose the rule definition or execution history.","definition":"campaignApplicableBudgetRuleId from the Sponsored Products report"},{"name":"ad_campaign_applicable_budget_rule_name","type":"TEXT","nullable":true,"description":"Name of the budget rule Amazon reports as applicable to the Sponsored Products campaign on this date. Null when Amazon omits it and for other campaign types. Read-only report value; does not support rule edits.","definition":"campaignApplicableBudgetRuleName from the Sponsored Products report"},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed ad orders (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_orders_clicks_only","type":"NUMBER","nullable":false,"description":"Orders attributed to a click only. Excludes view-through orders. Not ad_orders when that column includes views."},{"name":"ad_orders_same_sku","type":"NUMBER","nullable":false,"description":"Attributed orders of the advertised SKU only (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Excludes brand-halo orders of other SKUs."},{"name":"ad_orders_new_to_brand_14d","type":"NUMBER","nullable":false,"description":"First-time orders of the brand in a 12-month lookback, within 14 days of an ad click or view. A count, not a rate. Not available for book vendors."},{"name":"ad_orders_new_to_brand_14d_percentage","type":"NUMBER","nullable":false,"description":"Share of the matching total that is new-to-brand. Amazon reports this as a percentage, not a unit count. Not available for book vendors."},{"name":"ad_orders_new_to_brand_14d_rate","type":"NUMBER","nullable":false,"description":"Share of the matching total that is new-to-brand. Amazon reports this as a percentage, not a unit count. Not available for book vendors."},{"name":"ad_viewability_rate","type":"NUMBER","nullable":false,"description":"Amazon viewabilityRate: views divided by impressions. A rate, not a view count."},{"name":"ad_view_click_through_rate","type":"NUMBER","nullable":false,"description":"Clicks divided by views. A rate, not a click count."},{"name":"ad_video_complete_views","type":"NUMBER","nullable":false,"description":"Impressions where the shopper watched the video to completion."},{"name":"ad_video_first_quartile_views","type":"NUMBER","nullable":false,"description":"25% playback. Impressions that reached this video playback quartile. A view count, not a rate."},{"name":"ad_branded_searches","type":"NUMBER","nullable":false,"description":"Branded searches attributed to the ad. Not Brand Analytics search volume."},{"name":"ad_video5_second_views","type":"NUMBER","nullable":false,"description":"Impressions where the shopper watched the complete video or 5 seconds, whichever is shorter."},{"name":"ad_branded_searches_clicks","type":"NUMBER","nullable":false,"description":"Branded searches attributed to a click. Excludes view-through."},{"name":"ad_video_unmutes","type":"NUMBER","nullable":false,"description":"Times a shopper unmuted the video."},{"name":"ad_video_third_quartile_views","type":"NUMBER","nullable":false,"description":"75% playback. Impressions that reached this video playback quartile. A view count, not a rate."},{"name":"ad_detail_page_views_clicks","type":"NUMBER","nullable":false,"description":"Detail-page views attributed to a click. Excludes view-through."},{"name":"ad_video_midpoint_views","type":"NUMBER","nullable":false,"description":"50% playback. Impressions that reached this video playback quartile. A view count, not a rate."},{"name":"ad_video_5_second_view_rate","type":"NUMBER","nullable":false,"description":"Share of impressions where the shopper watched the complete video or 5 seconds, whichever is shorter. A rate, not a view count."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Placement performance for SPONSORED_BRANDS and SPONSORED_PRODUCTS campaigns, including Amazon Business placement breakdown for Sponsored Products.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_CAMPAIGNS_ADD","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_FIND","relation":"live"}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":28},{"type":"RECURRING_MONTHLY","numberOfDays":56}],"sources":["connections","raw_ads_api_report_campaign_placement_sp","raw_ads_api_report_campaign_placement_sp_amazon_business","raw_ads_api_report_legacy_placement_sb_all"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["top of search","placement"]},{"id":"0dd6cbf08cefd9a67f6dd262de499b5cc512e1440da09091eaa47a07db879795","name":"Sponsored Brands Ad Performance","tableName":"amazon_ads_sponsored_brands_by_ad_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"ad_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":"Times the ad was displayed after Amazon removed invalid traffic. Gross impressions, including invalid traffic, are ad_gross_impressions."},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":null},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed ad sales (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_sales_same_sku","type":"NUMBER","nullable":false,"description":"Attributed sales of the advertised SKU only (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Excludes brand-halo purchases of other SKUs. Not total ad sales; campaign totals are amazon_ads_performance_by_campaign_by_date.ad_sales."},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed ad units sold (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Clicks after Amazon removed invalid traffic. Gross clicks, including invalid traffic, are ad_gross_click_throughs."},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed ad orders (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_orders_same_sku","type":"NUMBER","nullable":false,"description":"Attributed orders of the advertised SKU only (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS). Excludes brand-halo orders of other SKUs."},{"name":"ad_campaign_budget_amount","type":"NUMBER","nullable":false,"description":"Campaign budget repeated on every row of the campaign. Do not sum it across ASINs, keywords, placements, or dates. ad_campaign_budget_type is DAILY_BUDGET or LIFETIME_BUDGET."},{"name":"ad_campaign_budget_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_budget_currency","type":"TEXT","nullable":false,"description":null},{"name":"ad_new_to_brand_sales_clicks","type":"NUMBER","nullable":false,"description":"New-to-brand sales attributed to a click only. Excludes view-through. A currency amount."},{"name":"ad_viewability_rate","type":"NUMBER","nullable":false,"description":"Amazon viewabilityRate: views divided by impressions. A rate, not a view count."},{"name":"ad_new_to_brand_sales_percentage","type":"NUMBER","nullable":false,"description":"Share of the matching total that is new-to-brand. Amazon reports this as a percentage, not a unit count. Not available for book vendors."},{"name":"ad_campaign_status","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_new_to_brand_purchases_percentage","type":"NUMBER","nullable":false,"description":"Share of the matching total that is new-to-brand. Amazon reports this as a percentage, not a unit count. Not available for book vendors."},{"name":"ad_video_complete_views","type":"NUMBER","nullable":false,"description":"Impressions where the shopper watched the video to completion."},{"name":"ad_video_first_quartile_views","type":"NUMBER","nullable":false,"description":"25% playback. Impressions that reached this video playback quartile. A view count, not a rate."},{"name":"ad_new_to_brand_purchases_rate","type":"NUMBER","nullable":false,"description":"Share of the matching total that is new-to-brand. Amazon reports this as a percentage, not a unit count. Not available for book vendors."},{"name":"ad_video5_second_views","type":"NUMBER","nullable":false,"description":"Impressions where the shopper watched the complete video or 5 seconds, whichever is shorter."},{"name":"ad_new_to_brand_purchases","type":"NUMBER","nullable":false,"description":"First-time orders of the brand in a 12-month lookback, within 14 days of an ad click or view. A count, not a rate. Not available for book vendors."},{"name":"ad_branded_searches_clicks","type":"NUMBER","nullable":false,"description":"Branded searches attributed to a click. Excludes view-through."},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_new_to_brand_sales","type":"NUMBER","nullable":false,"description":"Sales from first-time customers of the brand in a 12-month lookback, within 14 days of an ad click or view. A currency amount, not a rate. Not available for book vendors."},{"name":"ad_video_unmutes","type":"NUMBER","nullable":false,"description":"Times a shopper unmuted the video."},{"name":"ad_video_third_quartile_views","type":"NUMBER","nullable":false,"description":"75% playback. Impressions that reached this video playback quartile. A view count, not a rate."},{"name":"ad_new_to_brand_units_sold","type":"NUMBER","nullable":false,"description":"Units in new-to-brand orders within 14 days of an ad click or view. A count, not a rate. Not available for book vendors."},{"name":"ad_viewable_impressions","type":"NUMBER","nullable":false,"description":"Impressions Amazon counted as viewable. A count, not a rate."},{"name":"ad_detail_page_views_clicks","type":"NUMBER","nullable":false,"description":"Detail-page views attributed to a click. Excludes view-through."},{"name":"ad_video_midpoint_views","type":"NUMBER","nullable":false,"description":"50% playback. Impressions that reached this video playback quartile. A view count, not a rate."},{"name":"ad_video_5_second_view_rate","type":"NUMBER","nullable":false,"description":"Share of impressions where the shopper watched the complete video or 5 seconds, whichever is shorter. A rate, not a view count."},{"name":"ad_new_to_brand_units_sold_percentage","type":"NUMBER","nullable":false,"description":"Share of the matching total that is new-to-brand. Amazon reports this as a percentage, not a unit count. Not available for book vendors."},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Sponsored Brands performance per ad and date. Attribution is 14 days. Same-SKU columns exclude brand halo. New-to-brand columns use a 12-month first-purchase lookback. Do not sum this table into campaign totals.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_ADS_ADD","relation":"writes"},{"type":"AMAZON_ADS_ADS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_ADS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_ADS_FIND","relation":"live"}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":21},{"type":"RECURRING_MONTHLY","numberOfDays":49}],"sources":["connections","raw_ads_api_report_legacy_ad_sb_all"],"containsPii":false,"initialLoadProgress":null},{"id":"c1673079cde1e7c0ced22310f3b5c99c8c5c96953e71f6db06f41ac30259a786","name":"Video Ad Extension Performance","tableName":"amazon_ads_video_ad_extensions_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_creative_extension_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_creative_extension_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_video_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_advertised_asin","type":"TEXT","nullable":true,"description":null},{"name":"ad_advertised_sku","type":"TEXT","nullable":true,"description":null},{"name":"ad_portfolio_name","type":"TEXT","nullable":true,"description":null},{"name":"currency_code","type":"TEXT","nullable":true,"description":null},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":null},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":null},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":null},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed ad orders (purchases14d)."},{"name":"ad_orders_same_sku","type":"NUMBER","nullable":false,"description":"Attributed same-SKU ad orders (purchasesSameSku14d)."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed ad sales (sales14d)."},{"name":"ad_sales_same_sku","type":"NUMBER","nullable":false,"description":"Attributed same-SKU ad sales (attributedSalesSameSku14d)."},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed units sold (unitsSoldClicks14d)."},{"name":"ad_units_sold_same_sku","type":"NUMBER","nullable":false,"description":"Attributed same-SKU units sold (unitsSoldSameSku14d)."},{"name":"ad_video5_second_views","type":"NUMBER","nullable":false,"description":"Impressions where the shopper watched the complete video or 5 seconds, whichever is shorter."},{"name":"ad_video_5_second_view_rate","type":"NUMBER","nullable":false,"description":"Share of impressions where the shopper watched the complete video or 5 seconds, whichever is shorter. A rate, not a view count."},{"name":"ad_video_first_quartile_views","type":"NUMBER","nullable":false,"description":"25% playback. Impressions that reached this video playback quartile. A view count, not a rate."},{"name":"ad_video_midpoint_views","type":"NUMBER","nullable":false,"description":"50% playback. Impressions that reached this video playback quartile. A view count, not a rate."},{"name":"ad_video_third_quartile_views","type":"NUMBER","nullable":false,"description":"75% playback. Impressions that reached this video playback quartile. A view count, not a rate."},{"name":"ad_video_complete_views","type":"NUMBER","nullable":false,"description":"Impressions where the shopper watched the video to completion."},{"name":"ad_viewability_rate","type":"NUMBER","nullable":false,"description":"Amazon viewabilityRate: views divided by impressions. A rate, not a view count."},{"name":"ad_view_click_through_rate","type":"NUMBER","nullable":false,"description":"Clicks divided by views. A rate, not a click count."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Performance for Sponsored Products video ad extensions per extension, ad, and date. Grain is creativeExtensionId + adId. Do not sum these metrics with campaign, ASIN, or ad-level ads views (double-count). Canonical conversion metrics use 14-day attribution.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":21},{"type":"RECURRING_MONTHLY","numberOfDays":49}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"10am, 1pm, 4pm"},"sources":["connections","raw_ads_api_report_video_ad_extension_sp"],"containsPii":false,"initialLoadProgress":null},{"id":"3d78ce25ee8eb3ce544ad7fb85c36382b52a88e89b49c61dc95b17c8dc332605","name":"Prompt Ad Extension Performance","tableName":"amazon_ads_prompt_ad_extensions_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"SPONSORED_PRODUCTS / SPONSORED_BRANDS"},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_creative_extension_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_creative_extension_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_prompt_text","type":"TEXT","nullable":true,"description":null},{"name":"ad_advertised_asin","type":"TEXT","nullable":true,"description":"Null for SPONSORED_BRANDS."},{"name":"ad_advertised_sku","type":"TEXT","nullable":true,"description":"Null for SPONSORED_BRANDS."},{"name":"ad_name","type":"TEXT","nullable":true,"description":"Null for SPONSORED_PRODUCTS."},{"name":"ad_portfolio_name","type":"TEXT","nullable":true,"description":null},{"name":"currency_code","type":"TEXT","nullable":true,"description":null},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":null},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":null},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":null},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed ad orders (purchases14d)."},{"name":"ad_orders_same_sku","type":"NUMBER","nullable":false,"description":"Attributed same-SKU ad orders (purchasesSameSku14d)."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed ad sales (sales14d)."},{"name":"ad_sales_same_sku","type":"NUMBER","nullable":false,"description":"Attributed same-SKU ad sales (attributedSalesSameSku14d)."},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed units sold (unitsSoldClicks14d)."},{"name":"ad_units_sold_same_sku","type":"NUMBER","nullable":false,"description":"Attributed same-SKU units sold (unitsSoldSameSku14d)."},{"name":"ad_new_to_brand_purchases","type":"NUMBER","nullable":true,"description":"First-time orders of the brand in a 12-month lookback, within 14 days of an ad click or view. A count, not a rate. Not available for book vendors. Null for SPONSORED_PRODUCTS."},{"name":"ad_new_to_brand_purchases_percentage","type":"NUMBER","nullable":true,"description":"Share of the matching total that is new-to-brand. Amazon reports this as a percentage, not a unit count. Not available for book vendors. Null for SPONSORED_PRODUCTS."},{"name":"ad_new_to_brand_sales","type":"NUMBER","nullable":true,"description":"Sales from first-time customers of the brand in a 12-month lookback, within 14 days of an ad click or view. A currency amount, not a rate. Not available for book vendors. Null for SPONSORED_PRODUCTS."},{"name":"ad_new_to_brand_sales_percentage","type":"NUMBER","nullable":true,"description":"Share of the matching total that is new-to-brand. Amazon reports this as a percentage, not a unit count. Not available for book vendors. Null for SPONSORED_PRODUCTS."},{"name":"ad_new_to_brand_units_sold","type":"NUMBER","nullable":true,"description":"Units in new-to-brand orders within 14 days of an ad click or view. A count, not a rate. Not available for book vendors. Null for SPONSORED_PRODUCTS."},{"name":"ad_new_to_brand_units_sold_percentage","type":"NUMBER","nullable":true,"description":"Share of the matching total that is new-to-brand. Amazon reports this as a percentage, not a unit count. Not available for book vendors. Null for SPONSORED_PRODUCTS."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Performance for Sponsored Products and Sponsored Brands prompt ad extensions per extension, ad, and date. Grain is creativeExtensionId + adId. Do not sum these metrics with campaign, ASIN, or ad-level ads views (double-count). Canonical conversion metrics use 14-day attribution.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":21},{"type":"RECURRING_MONTHLY","numberOfDays":49}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"10am, 1pm, 4pm"},"sources":["connections","raw_ads_api_report_prompt_ad_extension_sp","raw_ads_api_report_prompt_ad_extension_sb"],"containsPii":false,"initialLoadProgress":null},{"id":"9c93aaa5e28bbad50fcf119577554250b0d676fffae9b808eceb181c9b8c4068","name":"Bid-Boost Audience Performance","tableName":"amazon_ads_audiences_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"SPONSORED_PRODUCTS / SPONSORED_BRANDS"},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_audience_segment_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_audience_segment_class_code","type":"TEXT","nullable":false,"description":"Amazon audience segment class code. The readable name is ad_audience_segment_name."},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":null},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":null},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":null},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed ad orders (purchases14d for SPONSORED_PRODUCTS, purchases for SPONSORED_BRANDS)."},{"name":"ad_orders_same_sku","type":"NUMBER","nullable":true,"description":"Attributed same-SKU ad orders (purchasesSameSku14d). Null for SPONSORED_BRANDS."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed ad sales (sales14d for SPONSORED_PRODUCTS, sales for SPONSORED_BRANDS)."},{"name":"ad_sales_same_sku","type":"NUMBER","nullable":true,"description":"Attributed same-SKU ad sales (attributedSalesSameSku14d). Null for SPONSORED_BRANDS."},{"name":"ad_sales_clicks","type":"NUMBER","nullable":true,"description":"Click-attributed sales (salesClicks). Null for SPONSORED_PRODUCTS."},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed units sold (unitsSoldClicks14d for SPONSORED_PRODUCTS, unitsSoldClicks for SPONSORED_BRANDS)."},{"name":"ad_units_sold_same_sku","type":"NUMBER","nullable":true,"description":"Attributed same-SKU units sold (unitsSoldSameSku14d). Null for SPONSORED_BRANDS."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Bid-boost audience segment performance for Sponsored Products and Sponsored Brands. Grain is campaign + audience segment + date. Do not sum these metrics with campaign or ASIN ads views (double-count). DSP Audience (order / lineItem / segment) is a different report and is not included here. Canonical conversion metrics use 14-day attribution for SPONSORED_PRODUCTS and the unwindowed purchases/sales/unitsSoldClicks fields for SPONSORED_BRANDS.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":21},{"type":"RECURRING_MONTHLY","numberOfDays":49}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"10am, 1pm, 4pm"},"sources":["connections","raw_ads_api_report_audience_sp","raw_ads_api_report_audience_sb"],"containsPii":false,"initialLoadProgress":null},{"id":"7c1ba29e52b0e7b23d559d1e4647e65a05147374fe70d27b32dcc88177593b66","name":"Ad Group Performance","tableName":"amazon_ads_by_ad_group_by_date","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_add_to_lists_clicks_only","type":"NUMBER","nullable":false,"description":"Add-to-list actions attributed to a click. Excludes view-through."},{"name":"ad_branded_searches_clicks_only","type":"NUMBER","nullable":false,"description":"Branded searches attributed to a click. Excludes view-through."},{"name":"ad_campaign_budget_amount","type":"NUMBER","nullable":false,"description":null},{"name":"ad_campaign_budget_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_budget_currency","type":"TEXT","nullable":false,"description":null},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":null},{"name":"ad_spend","type":"NUMBER","nullable":false,"description":null},{"name":"ad_impressions","type":"NUMBER","nullable":false,"description":null},{"name":"ad_detail_page_views_clicks_only","type":"NUMBER","nullable":false,"description":"Detail-page views attributed to a click. Excludes view-through."},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed ad orders (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_orders_new_to_brand_14d","type":"NUMBER","nullable":false,"description":"First-time orders of the brand in a 12-month lookback, within 14 days of an ad click or view. A count, not a rate. Not available for book vendors."},{"name":"ad_orders_new_to_brand_14d_clicks_only","type":"NUMBER","nullable":false,"description":"New-to-brand orders attributed to a click only. Excludes view-through."},{"name":"ad_units_sold","type":"NUMBER","nullable":false,"description":"Attributed ad units sold (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_units_sold_new_to_brand_14d","type":"NUMBER","nullable":false,"description":null},{"name":"ad_video_five_second_view_rate","type":"NUMBER","nullable":false,"description":null},{"name":"ad_video_five_second_views","type":"NUMBER","nullable":false,"description":null},{"name":"ad_video_complete_views","type":"NUMBER","nullable":false,"description":null},{"name":"ad_video_first_quartile_views","type":"NUMBER","nullable":false,"description":null},{"name":"ad_video_midpoint_views","type":"NUMBER","nullable":false,"description":null},{"name":"ad_video_third_quartile_views","type":"NUMBER","nullable":false,"description":null},{"name":"ad_video_unmutes","type":"NUMBER","nullable":false,"description":null},{"name":"ad_viewability_rate","type":"NUMBER","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":null},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed ad sales (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS)."},{"name":"ad_sales_new_to_brand_14d","type":"NUMBER","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Performance for ad groups in SPONSORED_BRANDS and SPONSORED_DISPLAY campaigns.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_AD_GROUPS_ADD","relation":"writes"},{"type":"AMAZON_ADS_AD_GROUPS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_AD_GROUPS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_AD_GROUPS_FIND","relation":"live"}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":21},{"type":"RECURRING_MONTHLY","numberOfDays":49}],"sources":["connections","raw_ads_api_report_ad_group_sd","raw_ads_api_report_legacy_ad_group_sb_all"],"containsPii":false,"initialLoadProgress":null},{"id":"90b696e336f05b1a7f1684519cbaa63052a8e6452ede2d66aa41bfa92dfcfec3","name":"Ad Campaigns (raw)","tableName":"amazon_ads_campaigns_raw","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":true,"description":"SPONSORED_DISPLAY / SPONSORED_PRODUCTS / SPONSORED_BRANDS"},{"name":"ad_portfolio_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_portfolio_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_start_date","type":"DATE","nullable":true,"description":null},{"name":"ad_campaign_end_date","type":"DATE","nullable":true,"description":null},{"name":"ad_campaign_updated_at_utc","type":"DATE","nullable":false,"description":null},{"name":"ad_campaign_created_at_utc","type":"DATE","nullable":false,"description":null},{"name":"ad_campaign_state","type":"TEXT","nullable":false,"description":"Entity state from Amazon Ads Universal Exports API. Enum values: ARCHIVED / ENABLED / PAUSED."},{"name":"ad_campaign_delivery_status","type":"TEXT","nullable":false,"description":"Whether Amazon is delivering the campaign, such as DELIVERING or NOT_DELIVERING. Not ad_campaign_state (ENABLED, PAUSED, ARCHIVED)."},{"name":"ad_campaign_delivery_reasons","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"ad_campaign_brand_entity_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_optimization_bid_strategy","type":"TEXT","nullable":true,"description":"Sponsored Products bid strategy: LEGACY_FOR_SALES (down only), AUTO_FOR_SALES (up and down), MANUAL, or RULE_BASED."},{"name":"ad_campaign_optimization_placement_bid_adjustments","type":"JSON","nullable":true,"description":"Placement bid adjustments from campaign optimization settings. Same as JSON payload from Amazon Ads API."},{"name":"ad_campaign_optimization_shopper_segment_bid_adjustment","type":"JSON","nullable":true,"description":"Shopper segment bid adjustment from campaign optimization settings. Same as JSON payload from Amazon Ads API."},{"name":"ad_campaign_optimization_shopper_cohort_bid_adjustment","type":"JSON","nullable":true,"description":"Shopper cohort bid adjustment from campaign optimization settings. Same as JSON payload from Amazon Ads API."},{"name":"ad_campaign_budget_caps","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"ad_campaign_targeting_settings","type":"TEXT","nullable":true,"description":"MANUAL or AUTO for Sponsored Products. Null when Amazon does not send it."},{"name":"ad_campaign_cost_type","type":"TEXT","nullable":true,"description":"How the campaign is priced: CPC or VCPM."},{"name":"ad_campaign_tags","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Snapshots of Amazon Ads campaign configuration and settings. Rows are identified by campaign and ad product within each Organization, Store, and Ads Connection. State changes update the existing row. Includes archived, enabled, and paused campaigns. Snapshots are refreshed every 72 hours. Live entity state can be obtained using Actions.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_CAMPAIGNS_ADD","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_export_campaigns"],"containsPii":false,"initialLoadProgress":null},{"id":"4ce1ac7e86bf8900ebeb2fd716e8538184fb75794ba3072136beb43be515a256","name":"Ad Groups (raw)","tableName":"amazon_ads_ad_groups_raw","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_type","type":"TEXT","nullable":false,"description":"SPONSORED_DISPLAY / SPONSORED_PRODUCTS / SPONSORED_BRANDS"},{"name":"ad_group_creative_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_group_updated_at_utc","type":"DATE","nullable":false,"description":null},{"name":"ad_group_created_at_utc","type":"DATE","nullable":false,"description":null},{"name":"ad_group_state","type":"TEXT","nullable":false,"description":"Entity state from Amazon Ads Universal Exports API. Enum values: ARCHIVED / ENABLED / PAUSED."},{"name":"ad_group_delivery_status","type":"TEXT","nullable":false,"description":"Whether Amazon is delivering the ad group. Not ad_group_state (ENABLED, PAUSED, ARCHIVED)."},{"name":"ad_group_delivery_reasons","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"ad_group_default_bid","type":"NUMBER","nullable":true,"description":null},{"name":"ad_group_bid_currency_code","type":"TEXT","nullable":true,"description":null},{"name":"ad_group_optimization_goal","type":"TEXT","nullable":true,"description":null},{"name":"ad_group_optimization_kpi","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Snapshots of Amazon Ads ad group configuration and settings. Rows are identified by ad group and ad product. Includes archived, enabled, and paused ad groups. Snapshots are refreshed every 72 hours. Live entity state can be obtained using Actions.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_AD_GROUPS_ADD","relation":"writes"},{"type":"AMAZON_ADS_AD_GROUPS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_AD_GROUPS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_AD_GROUPS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_export_ad_groups"],"containsPii":false,"initialLoadProgress":null},{"id":"d78c8d084a149700169a6acec6fc7c76c06849a4ee60e376eeb4b77e12c81595","name":"Ads (raw)","tableName":"amazon_ads_ads_raw","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"ad_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_type","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"SPONSORED_DISPLAY / SPONSORED_PRODUCTS / SPONSORED_BRANDS"},{"name":"ad_version_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_updated_at_utc","type":"DATE","nullable":false,"description":null},{"name":"ad_created_at_utc","type":"DATE","nullable":false,"description":null},{"name":"ad_state","type":"TEXT","nullable":false,"description":"Entity state from Amazon Ads Universal Exports API. Enum values: ARCHIVED / ENABLED / PAUSED."},{"name":"ad_delivery_status","type":"TEXT","nullable":false,"description":"Whether Amazon is delivering the ad. Not ad_state (ENABLED, PAUSED, ARCHIVED)."},{"name":"ad_delivery_reasons","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"ad_creative_headline","type":"TEXT","nullable":true,"description":null},{"name":"ad_creative_brand_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_creative_landing_page_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_creative_landing_page_url","type":"TEXT","nullable":true,"description":null},{"name":"ad_creative_brand_logo_asset_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_creative_brand_logo_asset_version","type":"TEXT","nullable":true,"description":null},{"name":"ad_creative_brand_logo_top","type":"NUMBER","nullable":true,"description":null},{"name":"ad_creative_brand_logo_left","type":"NUMBER","nullable":true,"description":null},{"name":"ad_creative_brand_logo_width","type":"NUMBER","nullable":true,"description":null},{"name":"ad_creative_brand_logo_height","type":"NUMBER","nullable":true,"description":null},{"name":"ad_creative_products","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"ad_creative_custom_images","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"ad_creative_videos","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"ad_creative_cards","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Snapshots of Amazon Ads ad configuration and creative settings. Rows are identified by ad, ad product, and ad type. Includes archived, enabled, and paused ads. Snapshots are refreshed every 72 hours. Live entity state can be obtained using Actions.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_ADS_ADD","relation":"writes"},{"type":"AMAZON_ADS_ADS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_ADS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_ADS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_export_ads"],"containsPii":false,"initialLoadProgress":null},{"id":"bd819066dbd89514f573530c0f1463fc6b37881a79b2fa010dcd1d9f5afdf213","name":"Ad Targets (raw)","tableName":"amazon_ads_targets_raw","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"ad_target_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_type","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"SPONSORED_DISPLAY / SPONSORED_PRODUCTS / SPONSORED_BRANDS"},{"name":"ad_target_negative","type":"LOGIC","nullable":true,"description":"TRUE when this target blocks traffic (negative keyword or negative product target)."},{"name":"ad_target_updated_at_utc","type":"DATE","nullable":false,"description":null},{"name":"ad_target_created_at_utc","type":"DATE","nullable":false,"description":null},{"name":"ad_target_state","type":"TEXT","nullable":false,"description":"Entity state from Amazon Ads Universal Exports API. Enum values: ARCHIVED / ENABLED / PAUSED."},{"name":"ad_target_delivery_status","type":"TEXT","nullable":false,"description":"Whether Amazon is delivering the target. Not ad_target_state (ENABLED, PAUSED, ARCHIVED)."},{"name":"ad_target_delivery_reasons","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_bid","type":"NUMBER","nullable":true,"description":null},{"name":"ad_target_currency_code","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_match_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_keyword","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_native_language_keyword","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_native_language_locale","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_category_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_category_resolved","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_brand","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_brand_resolved","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_genre","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_price_less_than","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_price_greater_than","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_rating_less_than","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_rating_greater_than","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_age_range","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_age_range_resolved","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_product_prime_shipping_eligible","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_asin","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_event","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_lookback","type":"NUMBER","nullable":true,"description":"Audience lookback in days, such as views or purchases in the last N days. Not an ads attribution window."},{"name":"ad_target_audience_id","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Snapshots of Amazon Ads targeting configuration (keywords, product targets, audiences). Rows are identified by target and ad product. Includes archived, enabled, and paused targets. Snapshots are refreshed every 72 hours. Live entity state can be obtained using Actions.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_TARGETS_ADD","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_export_targets"],"containsPii":false,"initialLoadProgress":null},{"id":"f5554500cded667a82762e9c8605fd548460a33f4474020f9d2959cbb8937138","name":"Ad Creative Assets","tableName":"amazon_ads_creative_assets","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"creative_asset_id","type":"TEXT","nullable":false,"description":null},{"name":"creative_asset_version","type":"TEXT","nullable":false,"description":null},{"name":"creative_asset_type","type":"TEXT","nullable":true,"description":"Asset type from Amazon Ads Creative Asset Library."},{"name":"creative_asset_status","type":"TEXT","nullable":true,"description":null},{"name":"creative_asset_name","type":"TEXT","nullable":true,"description":null},{"name":"creative_asset_created_by","type":"TEXT","nullable":true,"description":null},{"name":"creative_asset_updated_by","type":"TEXT","nullable":true,"description":null},{"name":"creative_asset_created_at_utc","type":"DATE","nullable":true,"description":null},{"name":"creative_asset_updated_at_utc","type":"DATE","nullable":true,"description":null},{"name":"creative_asset_version_notes","type":"TEXT","nullable":true,"description":null},{"name":"creative_asset_default_url","type":"TEXT","nullable":true,"description":null},{"name":"creative_asset_file_extension","type":"TEXT","nullable":true,"description":null},{"name":"creative_asset_file_size","type":"NUMBER","nullable":true,"description":null},{"name":"creative_asset_file_width","type":"NUMBER","nullable":true,"description":null},{"name":"creative_asset_file_height","type":"NUMBER","nullable":true,"description":null},{"name":"creative_asset_file_duration","type":"NUMBER","nullable":true,"description":null},{"name":"creative_asset_file_aspect_ratio","type":"TEXT","nullable":true,"description":null},{"name":"creative_asset_file_content_type","type":"TEXT","nullable":true,"description":null},{"name":"creative_asset_sub_types","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_tags","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_account_ids","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_marketplaces","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_collections","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_spec_check_approved_programs","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_file_metadata","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_storage_location_urls","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_processed_files","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_moderation_policy_map","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_moderation_content_list","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_associated_contexts","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_failed_spec_checks","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_asset_other_metadata","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Ads Creative Asset Library assets and versions. Rows are identified by creative asset ID and version.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_creative_assets"],"containsPii":false,"initialLoadProgress":null},{"id":"26910458f6f12c38e9d2b3ac869902401d161a3892139879aa2f477219bdf0a3","name":"Ad Entity History","tableName":"amazon_ads_entity_history","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"ad_entity_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_entity_type","type":"TEXT","nullable":false,"description":"Type of entity changed. Common values: CAMPAIGN / AD_GROUP / AD / KEYWORD / PRODUCT_TARGETING / NEGATIVE_KEYWORD."},{"name":"ad_change_type","type":"TEXT","nullable":false,"description":"Type of change applied to the entity, as reported by Amazon Ads."},{"name":"ad_change_at_utc","type":"DATE","nullable":false,"description":"Time the change occurred, as reported by Amazon Ads."},{"name":"ad_campaign_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_new_value","type":"TEXT","nullable":true,"description":"Entity value after the change. Same as JSON payload from Amazon Ads API."},{"name":"ad_previous_value","type":"TEXT","nullable":true,"description":"Entity value before the change. Same as JSON payload from Amazon Ads API."},{"name":"ad_change_metadata","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Change history events for Amazon Ads entities (campaigns, ad groups, ads, targets), such as state, bid, and budget changes.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":90},{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"1pm, 4pm"},"sources":["connections","raw_ads_api_entity_history"],"containsPii":false,"initialLoadProgress":null},{"id":"7dca257b8f728ceacaed3bb4d4830dd530858d073392455fb43a3ec579b0f947","name":"Ad Purchased Products","tableName":"amazon_ads_purchased_products","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"SPONSORED_DISPLAY / SPONSORED_PRODUCTS / SPONSORED_BRANDS"},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_name","type":"TEXT","nullable":false,"description":null},{"name":"currency_code","type":"TEXT","nullable":true,"description":null},{"name":"ad_purchased_asin","type":"TEXT","nullable":false,"description":"ASIN the shopper bought. It can differ from ad_promoted_asin (brand halo)."},{"name":"ad_keyword_id","type":"TEXT","nullable":true,"description":"Null for SPONSORED_DISPLAY and SPONSORED_BRANDS"},{"name":"ad_target_id","type":"TEXT","nullable":true,"description":"Null for SPONSORED_DISPLAY and SPONSORED_BRANDS"},{"name":"ad_keyword","type":"TEXT","nullable":true,"description":"Null for SPONSORED_DISPLAY and SPONSORED_BRANDS"},{"name":"ad_match_type","type":"TEXT","nullable":true,"description":"Null for SPONSORED_DISPLAY and SPONSORED_BRANDS"},{"name":"ad_targeting_text","type":"TEXT","nullable":true,"description":"Null for SPONSORED_DISPLAY and SPONSORED_BRANDS"},{"name":"ad_keyword_type","type":"TEXT","nullable":true,"description":"Null for SPONSORED_DISPLAY and SPONSORED_BRANDS"},{"name":"ad_portfolio_id","type":"TEXT","nullable":true,"description":"Null for SPONSORED_DISPLAY and SPONSORED_BRANDS"},{"name":"ad_targeting_expression","type":"TEXT","nullable":true,"description":"Null for SPONSORED_DISPLAY and SPONSORED_BRANDS"},{"name":"ad_promoted_asin","type":"TEXT","nullable":true,"description":"ASIN advertised in the campaign. Null for SPONSORED_BRANDS. The bought ASIN is ad_purchased_asin."},{"name":"ad_promoted_sku","type":"TEXT","nullable":true,"description":"Null for SPONSORED_BRANDS"},{"name":"ad_keyword_no","type":"NUMBER","nullable":true,"description":null},{"name":"ad_orders","type":"NUMBER","nullable":true,"description":"Attributed ad orders (14d for SPONSORED_PRODUCTS and SPONSORED_BRANDS; Null for SPONSORED_DISPLAY)."},{"name":"ad_orders_other_sku","type":"NUMBER","nullable":true,"description":"Attributed ad orders where SKU is different from promoted one (14d for SPONSORED_PRODUCTS and SPONSORED_DISPLAY; Null for SPONSORED_BRANDS)."},{"name":"ad_sales","type":"NUMBER","nullable":true,"description":"Attributed ad sales (14d for SPONSORED_PRODUCTS and SPONSORED_BRANDS; Null for SPONSORED_DISPLAY)."},{"name":"ad_sales_other_sku","type":"NUMBER","nullable":true,"description":"Attributed ad sales where SKU is different from promoted one (14d for SPONSORED_PRODUCTS and SPONSORED_DISPLAY; Null for SPONSORED_BRANDS)."},{"name":"ad_units_sold","type":"NUMBER","nullable":true,"description":"Attributed ad units sold (14d for SPONSORED_PRODUCTS and SPONSORED_BRANDS; Null for SPONSORED_DISPLAY)."},{"name":"ad_units_sold_other_sku","type":"NUMBER","nullable":true,"description":"Attributed ad units sold where SKU is different from promoted one (14d for SPONSORED_PRODUCTS and SPONSORED_DISPLAY; Null for SPONSORED_BRANDS)."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"ASINs purchased after an ad click or view, including brand-halo ASINs that differ from the promoted ASIN. Sponsored Products, Sponsored Display, and Sponsored Brands. Not the advertised-product performance table (amazon_ads_performance_by_child_asin_and_date).","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_ADS_ADD","relation":"writes"},{"type":"AMAZON_ADS_ADS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_ADS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_ADS_FIND","relation":"live"}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":60},{"type":"RECURRING_DAILY","numberOfDays":21},{"type":"RECURRING_MONTHLY","numberOfDays":49}],"dataAvailability":{"type":"INTRADAY","description":"Intraday updates are available when source data changes during the day.","refreshAt":"1pm"},"sources":["connections","raw_ads_api_report_purchased_products_sd","raw_ads_api_report_purchased_products_sp","raw_ads_api_report_purchased_products_sb"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["brand halo","purchased asin"]},{"id":"edddc5144cb838c3088f9621eb23c372e7fea26fd983d1ed065b388dfc7907fa","name":"AMS Campaigns","tableName":"amazon_ads_ams_campaigns","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser identifier from Amazon Marketing Stream."},{"name":"received_at","type":"DATE","nullable":false,"description":"Timestamp when the Amazon Marketing Stream event was received by DataDoe."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":true,"description":"Advertising product type from Amazon Marketing Stream. Common values: SPONSORED_PRODUCTS / SPONSORED_BRANDS / AMAZON_DSP. Budget usage may use lowercase product codes such as sp / sb / sd."},{"name":"ad_portfolio_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_starts_at","type":"DATE","nullable":true,"description":null},{"name":"ad_campaign_ends_at","type":"DATE","nullable":true,"description":null},{"name":"ad_campaign_status","type":"TEXT","nullable":true,"description":"Campaign state from Amazon Marketing Stream (for example ENABLED / PAUSED / ARCHIVED)."},{"name":"ad_campaign_targeting_settings","type":"JSON","nullable":true,"description":"Targeting / site restriction settings from campaign optimizations. Same as JSON payload from Amazon Marketing Stream."},{"name":"ad_campaign_budget_cap_value","type":"NUMBER","nullable":true,"description":null},{"name":"ad_campaign_budget_cap_currency","type":"TEXT","nullable":true,"description":"Currency code for the budget cap."},{"name":"ad_campaign_budget_cap_recurrence","type":"TEXT","nullable":true,"description":"Budget recurrence period. Enum values: DAILY / MONTHLY / LIFETIME."},{"name":"ad_campaign_bid_settings","type":"JSON","nullable":true,"description":"Bid settings from campaign optimizations. Same as JSON payload from Amazon Marketing Stream."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Marketing Stream campaign configuration events from dataset ads-campaign-management-campaigns.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_CAMPAIGNS_ADD","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_CAMPAIGNS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_campaigns"],"containsPii":false,"initialLoadProgress":null},{"id":"d8a1eb98a80f6b9cdfb3a18290e20edc811f8e84c7f144c49b97e06d5e7cce45","name":"AMS Campaign Ad Groups","tableName":"amazon_ads_ams_campaign_ad_groups","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser identifier from Amazon Marketing Stream."},{"name":"received_at","type":"DATE","nullable":false,"description":"Timestamp when the Amazon Marketing Stream event was received by DataDoe."},{"name":"ad_group_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":true,"description":"Advertising product type from Amazon Marketing Stream. Common values: SPONSORED_PRODUCTS / SPONSORED_BRANDS / AMAZON_DSP. Budget usage may use lowercase product codes such as sp / sb / sd."},{"name":"ad_group_state","type":"TEXT","nullable":true,"description":"Ad group state (for example ENABLED / PAUSED / ARCHIVED)."},{"name":"ad_group_bid_value","type":"NUMBER","nullable":true,"description":null},{"name":"ad_group_bid_currency","type":"TEXT","nullable":true,"description":"Currency code for the ad group bid."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Marketing Stream ad group configuration events from dataset ads-campaign-management-adgroups.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_AD_GROUPS_ADD","relation":"writes"},{"type":"AMAZON_ADS_AD_GROUPS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_AD_GROUPS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_AD_GROUPS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_adgroups"],"containsPii":false,"initialLoadProgress":null},{"id":"539df71b9e15c750803f325409e9f7a2439a0ff2d6168e0d09314070ac554f19","name":"AMS Campaign Ads","tableName":"amazon_ads_ams_campaign_ads","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser identifier from Amazon Marketing Stream."},{"name":"received_at","type":"DATE","nullable":false,"description":"Timestamp when the Amazon Marketing Stream event was received by DataDoe."},{"name":"ad_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_state","type":"TEXT","nullable":true,"description":"Ad state (for example ENABLED / PAUSED / ARCHIVED)."},{"name":"ad_custom_text","type":"TEXT","nullable":true,"description":null},{"name":"ad_landing_page_url","type":"TEXT","nullable":true,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":true,"description":"Advertising product type from Amazon Marketing Stream. Common values: SPONSORED_PRODUCTS / SPONSORED_BRANDS / AMAZON_DSP. Budget usage may use lowercase product codes such as sp / sb / sd."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Marketing Stream ad configuration events from dataset ads-campaign-management-ads.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_ADS_ADD","relation":"writes"},{"type":"AMAZON_ADS_ADS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_ADS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_ADS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_ads"],"containsPii":false,"initialLoadProgress":null},{"id":"79f84d1bbf3813d11d69cc42d2719cdff0b6a1c3854682568e900e8dddbdd101","name":"AMS Budget Usage","tableName":"amazon_ads_ams_budget_usage","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser identifier from Amazon Marketing Stream."},{"name":"received_at","type":"DATE","nullable":false,"description":"Timestamp when the Amazon Marketing Stream event was received by DataDoe."},{"name":"budget_scope_id","type":"TEXT","nullable":false,"description":"Campaign or portfolio identifier the budget usage applies to."},{"name":"budget_scope_type","type":"TEXT","nullable":true,"description":"Budget scope type. Enum values: CAMPAIGN / PORTFOLIO."},{"name":"budget_value","type":"NUMBER","nullable":true,"description":null},{"name":"budget_currency","type":"TEXT","nullable":true,"description":"Currency code derived from the marketplace."},{"name":"budget_usage_percentage","type":"NUMBER","nullable":true,"description":"Budget usage percentage (spend divided by budget)."},{"name":"budget_usage_updated_at","type":"DATE","nullable":true,"description":"Last evaluation time for budget usage."},{"name":"ad_campaign_type","type":"TEXT","nullable":true,"description":"Advertising product type from Amazon Marketing Stream. Common values: SPONSORED_PRODUCTS / SPONSORED_BRANDS / AMAZON_DSP. Budget usage may use lowercase product codes such as sp / sb / sd."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Marketing Stream budget consumption events from dataset budget-usage.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_budget_usage"],"containsPii":false,"initialLoadProgress":null},{"id":"87c4febc07c447d311997432fa15a10ddce581e17b0085553934bdde9ad7f328","name":"AMS Campaign Diagnostics","tableName":"amazon_ads_ams_campaign_diagnostics","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser identifier from Amazon Marketing Stream."},{"name":"received_at","type":"DATE","nullable":false,"description":"Timestamp when the Amazon Marketing Stream event was received by DataDoe."},{"name":"recommendation_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":null},{"name":"recommendation_apply_endpoint","type":"TEXT","nullable":true,"description":null},{"name":"recommendation_type","type":"TEXT","nullable":true,"description":null},{"name":"recommendation_explanation","type":"JSON","nullable":true,"description":"Recommendation explanation payload from Amazon Marketing Stream."},{"name":"recommendation_published_at","type":"DATE","nullable":true,"description":null},{"name":"recommendation_expires_at","type":"DATE","nullable":true,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":true,"description":"Advertising product type from Amazon Marketing Stream. Common values: SPONSORED_PRODUCTS / SPONSORED_BRANDS / AMAZON_DSP. Budget usage may use lowercase product codes such as sp / sb / sd."},{"name":"ad_campaign_current_settings","type":"JSON","nullable":true,"description":"Current campaign settings snapshot from the recommendation."},{"name":"ad_campaign_recommended_settings","type":"JSON","nullable":true,"description":"Recommended campaign settings snapshot from the recommendation."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Marketing Stream campaign diagnostics recommendations from dataset sponsored-ads-campaign-diagnostics-recommendations.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_campaign_diagnostics"],"containsPii":false,"initialLoadProgress":null},{"id":"709f627e66f3f0a59d43e045d33f19b4ae649c827295cea211574d5dd4ae750b","name":"AMS Campaign Targets","tableName":"amazon_ads_ams_campaign_targets","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser identifier from Amazon Marketing Stream."},{"name":"received_at","type":"DATE","nullable":false,"description":"Timestamp when the Amazon Marketing Stream event was received by DataDoe."},{"name":"ad_target_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_global_target_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":true,"description":"Advertising product type from Amazon Marketing Stream. Common values: SPONSORED_PRODUCTS / SPONSORED_BRANDS / AMAZON_DSP. Budget usage may use lowercase product codes such as sp / sb / sd."},{"name":"ad_target_marketplace_scope","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_state","type":"TEXT","nullable":true,"description":"Target state (for example ENABLED / PAUSED / ARCHIVED)."},{"name":"ad_target_is_negative","type":"LOGIC","nullable":true,"description":null},{"name":"ad_target_level","type":"TEXT","nullable":true,"description":"Target level. Common values: CAMPAIGN / AD_GROUP."},{"name":"ad_target_created_at","type":"DATE","nullable":true,"description":null},{"name":"ad_target_updated_at","type":"DATE","nullable":true,"description":null},{"name":"ad_target_status_delivery_status","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_status_delivery_reasons","type":"JSON","nullable":true,"description":"Delivery reasons list from Amazon Marketing Stream. Available only in direct BigQuery integration.","bigQueryOnly":true},{"name":"ad_target_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_bid_value","type":"NUMBER","nullable":true,"description":null},{"name":"ad_target_bid_currency","type":"TEXT","nullable":true,"description":"Currency code for the target bid."},{"name":"ad_target_keyword_match_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_keyword_local_language","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_keyword_locale","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_tags","type":"JSON","nullable":true,"description":"Target tags list from Amazon Marketing Stream. Available only in direct BigQuery integration.","bigQueryOnly":true},{"name":"ad_target_marketplace_configurations","type":"JSON","nullable":true,"description":"Marketplace configuration list from Amazon Marketing Stream. Available only in direct BigQuery integration.","bigQueryOnly":true}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Marketing Stream targeting configuration events from dataset ads-campaign-management-targets.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_TARGETS_ADD","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_targets"],"containsPii":false,"initialLoadProgress":null},{"id":"962eb4a222e8c922ece909931ec5912a2a8a74374c115e151ff89e80ec5164ab","name":"AMS Traffic","tableName":"amazon_ads_ams_traffic","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser identifier from Amazon Marketing Stream."},{"name":"received_at","type":"DATE","nullable":false,"description":"Timestamp when the Amazon Marketing Stream event was received by DataDoe."},{"name":"idempotency_id","type":"TEXT","nullable":false,"description":"Amazon Marketing Stream event idempotency identifier."},{"name":"time_window_starts_at","type":"DATE","nullable":true,"description":"Start of the Amazon Marketing Stream metric time window (UTC)."},{"name":"ad_campaign_type","type":"TEXT","nullable":true,"description":"Advertising product type from Amazon Marketing Stream. Common values: SPONSORED_PRODUCTS / SPONSORED_BRANDS / AMAZON_DSP. Budget usage may use lowercase product codes such as sp / sb / sd."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_keyword_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_keyword","type":"TEXT","nullable":true,"description":null},{"name":"ad_match_type","type":"TEXT","nullable":true,"description":"Keyword match type BROAD, PHRASE, or EXACT. Product targets use TARGETING_EXPRESSION or TARGETING_EXPRESSION_PREDEFINED."},{"name":"ad_keyword_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_placement","type":"TEXT","nullable":true,"description":null},{"name":"ad_placement_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_targeting_text","type":"TEXT","nullable":true,"description":null},{"name":"currency","type":"TEXT","nullable":true,"description":"Currency code for ad spend."},{"name":"ad_clicks","type":"NUMBER","nullable":true,"description":null},{"name":"ad_impressions","type":"NUMBER","nullable":true,"description":null},{"name":"ad_view_impressions","type":"NUMBER","nullable":true,"description":null},{"name":"ad_viewable_impressions","type":"NUMBER","nullable":true,"description":null},{"name":"ad_spend","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Marketing Stream near real-time traffic metrics unified across Sponsored Products, Sponsored Brands, and Sponsored Display.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_sb_traffic","raw_ads_api_ams_sd_traffic","raw_ads_api_ams_sp_traffic"],"containsPii":false,"initialLoadProgress":null},{"id":"cd12665f74972995b0c6f8bc32388b4034090d5ea560732399151f3a18b814a7","name":"AMS Conversion","tableName":"amazon_ads_ams_conversion","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser identifier from Amazon Marketing Stream."},{"name":"received_at","type":"DATE","nullable":false,"description":"Timestamp when the Amazon Marketing Stream event was received by DataDoe."},{"name":"idempotency_id","type":"TEXT","nullable":false,"description":"Amazon Marketing Stream event idempotency identifier."},{"name":"time_window_starts_at","type":"DATE","nullable":true,"description":"Start of the Amazon Marketing Stream metric time window (UTC)."},{"name":"ad_campaign_type","type":"TEXT","nullable":true,"description":"Advertising product type from Amazon Marketing Stream. Common values: SPONSORED_PRODUCTS / SPONSORED_BRANDS / AMAZON_DSP. Budget usage may use lowercase product codes such as sp / sb / sd."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_keyword_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_keyword","type":"TEXT","nullable":true,"description":null},{"name":"ad_keyword_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_placement","type":"TEXT","nullable":true,"description":null},{"name":"ad_placement_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_target_id","type":"TEXT","nullable":true,"description":null},{"name":"currency","type":"TEXT","nullable":true,"description":"Currency code for attributed sales."},{"name":"ad_attributed_conversions_1d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_conversions_7d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_conversions_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_conversions_30d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_conversions_1d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_conversions_7d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_conversions_14d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_conversions_30d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_sales_1d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_sales_7d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_sales_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_sales_30d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_sales_1d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_sales_7d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_sales_14d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_sales_30d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_units_ordered_1d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_units_ordered_7d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_units_ordered_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_units_ordered_30d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_units_ordered_1d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_units_ordered_7d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_units_ordered_14d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_units_ordered_30d_same_sku","type":"NUMBER","nullable":true,"description":null},{"name":"ad_view_attributed_conversions_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_view_attributed_sales_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_view_attributed_units_ordered_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_orders_new_to_brand_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_sales_new_to_brand_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_units_ordered_new_to_brand_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_view_attributed_orders_new_to_brand_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_view_attributed_sales_new_to_brand_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_view_attributed_units_ordered_new_to_brand_14d","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Marketing Stream near real-time conversion metrics for Sponsored Products, Sponsored Brands, and Sponsored Display. Click-attributed columns are named ad_attributed_*; view-through columns start with ad_view_attributed_. Same-SKU columns exclude brand halo. Windows are 1, 7, 14, and 30 days. The daily campaign table uses 7 days for Sponsored Products and 14 days for Sponsored Brands and Sponsored Display — do not add these hourly rows to that table.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_sb_conversion","raw_ads_api_ams_sd_conversion","raw_ads_api_ams_sp_conversion"],"containsPii":false,"initialLoadProgress":null},{"id":"547098798e923c01c4b06496c991f088a274a04bbf46f07f83e8d8301128c972","name":"AMS SB Clickstream","tableName":"amazon_ads_ams_sb_clickstream","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser identifier from Amazon Marketing Stream."},{"name":"received_at","type":"DATE","nullable":false,"description":"Timestamp when the Amazon Marketing Stream event was received by DataDoe."},{"name":"idempotency_id","type":"TEXT","nullable":false,"description":"Amazon Marketing Stream event idempotency identifier."},{"name":"time_window_starts_at","type":"DATE","nullable":true,"description":"Start of the Amazon Marketing Stream metric time window (UTC)."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_keyword_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_keyword","type":"TEXT","nullable":true,"description":null},{"name":"ad_keyword_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_placement_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_view_attributed_branded_searches_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_branded_searches_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_view_attributed_detail_page_views_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_attributed_detail_page_views_14d","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Marketing Stream Sponsored Brands clickstream engagement metrics from dataset sb-clickstream.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_sb_clickstream"],"containsPii":false,"initialLoadProgress":null},{"id":"a1718104373cdd7645db6bbd56cf18f3956469606a974501082af3773fc0fce8","name":"AMS SB Rich Media","tableName":"amazon_ads_ams_sb_rich_media","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser identifier from Amazon Marketing Stream."},{"name":"received_at","type":"DATE","nullable":false,"description":"Timestamp when the Amazon Marketing Stream event was received by DataDoe."},{"name":"idempotency_id","type":"TEXT","nullable":false,"description":"Amazon Marketing Stream event idempotency identifier."},{"name":"time_window_starts_at","type":"DATE","nullable":true,"description":"Start of the Amazon Marketing Stream metric time window (UTC)."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_keyword_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_keyword","type":"TEXT","nullable":true,"description":null},{"name":"ad_keyword_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_placement_type","type":"TEXT","nullable":true,"description":null},{"name":"ad_video_5_second_views","type":"NUMBER","nullable":true,"description":null},{"name":"ad_video_complete_views","type":"NUMBER","nullable":true,"description":null},{"name":"ad_video_first_quartile_views","type":"NUMBER","nullable":true,"description":null},{"name":"ad_video_midpoint_views","type":"NUMBER","nullable":true,"description":null},{"name":"ad_video_third_quartile_views","type":"NUMBER","nullable":true,"description":null},{"name":"ad_video_unmutes","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Marketing Stream Sponsored Brands rich media / video engagement metrics.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_sb_rich_media"],"containsPii":false,"initialLoadProgress":null},{"id":"4ab9033728531a195adb23ff56f7f75da811433beaa94a7d045d8c505394cf52","name":"AMS SP Budget Recommendations","tableName":"amazon_ads_ams_sp_budget_recommendations","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser identifier from Amazon Marketing Stream."},{"name":"received_at","type":"DATE","nullable":false,"description":"Timestamp when the Amazon Marketing Stream event was received by DataDoe."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"recommendation_at","type":"DATE","nullable":true,"description":null},{"name":"suggested_budget_value","type":"NUMBER","nullable":true,"description":null},{"name":"suggested_budget_currency","type":"TEXT","nullable":true,"description":"Currency code for the suggested budget."},{"name":"recommendation_reason","type":"TEXT","nullable":true,"description":null},{"name":"estimated_missed_sales_lower","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_missed_sales_upper","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_missed_sales_currency","type":"TEXT","nullable":true,"description":"Currency code for estimated missed sales."},{"name":"estimated_missed_clicks_lower","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_missed_clicks_upper","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_missed_impressions_lower","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_missed_impressions_upper","type":"NUMBER","nullable":true,"description":null},{"name":"recommendation_starts_on","type":"DATE","nullable":true,"description":null},{"name":"recommendation_ends_on","type":"DATE","nullable":true,"description":null},{"name":"percent_time_in_budget","type":"NUMBER","nullable":true,"description":"Share of the recommendation window the campaign was in budget. A percentage, not hours."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Marketing Stream Sponsored Products budget recommendations. Missed sales, clicks, and impressions are Amazon estimates of what the campaign might have gained if it had not run out of budget, as a lower and upper bound, not a guarantee.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_sp_budget_recommendations"],"containsPii":false,"initialLoadProgress":null},{"id":"36596ff85ecdded5d4b949bf7c0bbd9bc88398dc4a5ec8c3db88ab010fbe6f3c","name":"Negative Keywords","tableName":"amazon_ads_negative_keywords","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"ISO country code for the Amazon marketplace."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Human-readable country name for the marketplace (derived from marketplace_id)."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"DataDoe connection context display name for the seller or vendor."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile identifier."},{"name":"date","type":"DATE","nullable":false,"description":"Snapshot date. Always the Monday of the week."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":"Null for SPONSORED_PRODUCTS campaigns before 2026-07-01."},{"name":"ad_keyword_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_keyword_text","type":"TEXT","nullable":false,"description":"Negative keyword text. This keyword is excluded from targeting."},{"name":"ad_match_type","type":"TEXT","nullable":false,"description":"Negative match type, such as NEGATIVE_EXACT or NEGATIVE_PHRASE. Not a positive BROAD, PHRASE, or EXACT target."},{"name":"ad_keyword_state","type":"TEXT","nullable":false,"description":"ENABLED, PAUSED, or ARCHIVED."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Negative keywords that block traffic. Weekly snapshots. These rows have no spend or sales.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_TARGETS_ADD","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_TARGETS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","refined_ads_negative_keywords"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["negative keyword"]},{"id":"6cdde992a36bdedb6fbd17bbcd294941dbf55ac504302db9b232dc0887f1598a","name":"Sellers & Vendors Context","tableName":"amazon_sellers_and_vendors_context","type":"AMAZON_ADS","columns":[{"name":"connection_context_id","type":"TEXT","nullable":false,"description":"DataDoe connection context id, or the connection id when no context is set. Same value as seller_or_vendor_id. Not a unique row key when one context has several connections or DSP advertisers."},{"name":"connection_context_name","type":"TEXT","nullable":false,"description":"Context display name. Same value as seller_or_vendor_name. Falls back to the connection name, then the connection id. DSP rows use the mapped context name."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"Same value as connection_context_id. DataDoe account id used by MCP and API calls (sellers_and_vendors_list, exports). Not unique on this table: repeated for each connection and each DSP advertiser in the context. Fact tables copy this value into their seller_or_vendor_id."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":false,"description":"Same value as connection_context_name. DataDoe display name for the seller or vendor context."},{"name":"ads_dsp_connection_id","type":"TEXT","nullable":true,"description":"DataDoe Amazon Ads connection id of the account Amazon DSP is run from. One agency connection can be shared by several sellers or vendors. Null on non-DSP rows. Join DSP facts on organization_id, store_id, ads_dsp_connection_id, and dsp_advertiser_id."},{"name":"dsp_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser identifier mapped to this seller or vendor. One advertiser maps to one context. If an advertiser is reassigned, only the latest mapping is kept. Null on non-DSP rows."},{"name":"selling_partner_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id from the connection (connection_seller_id). Same value as marketplace_seller_id. This is the Amazon id, not seller_or_vendor_id. Null on DSP advertiser rows and when the connection has no seller id."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Same value as selling_partner_id: Amazon connection_seller_id. Null on DSP advertiser rows and when the connection has no seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile id. Set on Amazon Ads connections and on DSP advertiser rows. Null on Seller Central and Vendor Central rows."},{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":false,"description":"Lookup of DataDoe Amazon accounts for Seller Central, Vendor Central, Amazon Ads, and Amazon DSP. One row per connection, plus one row per Amazon DSP advertiser mapped to a seller or vendor on a shared agency Ads account. A DSP-only agency seat is not its own seller. seller_or_vendor_id equals connection_context_id and is not unique: one context can have a Seller Central row, an Amazon Ads row, and one row per DSP advertiser. Join Seller Central and Vendor Central facts on sp_connection_id or vendor_connection_id. Attribute DSP facts on organization_id, store_id, ads_dsp_connection_id, and dsp_advertiser_id.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[],"sources":["connections","raw_connection_dsp_advertisers"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["connection mapping","selling partner id","dsp advertiser","ads profile"]}],"recommendedSources":[],"historicalDataStillLoadingNotice":null,"sourceSelectionNotice":null}