{"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":true,"description":"Current parent ASIN resolved from the seller listing variation parent SKU within the same Organization, store, seller, SP connection and marketplace, matching the child SKU and ASIN. Falls back to the marketplace catalog parent when the listing parent is missing, unresolved or ambiguous. Empty when neither source resolves a parent. This is the current hierarchy, not the relationship as of the sale date."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"item_supplier_name","type":"TEXT","nullable":true,"description":"Comma-separated list of distinct supplier names from COGS uploads for shipped items."},{"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 Amazon marketplace order items. Includes tax where Amazon reports prices with tax; see sales_tax. Excludes off-Amazon Multi-Channel Fulfillment lines; their order-report amounts are fulfillment or declared values, not verified external-channel revenue.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && (amazon_order_items_with_cogs.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) && ((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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (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_units","type":"NUMBER","nullable":false,"description":"Units from Amazon marketplace order items whose status contains unshipped, ignoring case. Uses the purchase date and the same status filter as unshipped_sales. Excludes off-Amazon Multi-Channel Fulfillment lines. Not included in total_units_sold.","definition":"sum(String(amazon_order_items_with_cogs.item_status).toLowerCase().includes('unshipped') && (amazon_order_items_with_cogs.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (amazon_order_items_with_cogs.quantity ?? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase()))) && 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase()))) && !(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 Amazon marketplace order items. Excludes off-Amazon Multi-Channel Fulfillment lines.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && (amazon_order_items_with_cogs.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_orders","type":"NUMBER","nullable":false,"description":"Distinct shipped Amazon marketplace orders this item appeared in. Excludes off-Amazon Multi-Channel Fulfillment lines.","definition":"countDistinct(amazon_order_items_with_cogs.item_status === 'Shipped' && (amazon_order_items_with_cogs.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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. To list SKUs sold in the last 30 days without COGS, use GET /api/v1/cogs/missing or the MCP tool cogs_missing_list."},{"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. shipping_tax_discount is excluded too, because order shipping tax is already net of the shipping discount. 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.shipping_tax_discount ?? 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":"total_fees_tax","type":"NUMBER","nullable":false,"description":"Tax reported by Amazon within total_fees, including value added tax (VAT). Uses the same dates and cost sign as total_fees; refunds are excluded. Zero means no tax amount was reported. Profit still uses the existing fee total."},{"name":"total_fees_net","type":"NUMBER","nullable":false,"description":"total_fees minus total_fees_tax. Excludes only tax reported by Amazon within this total; no tax rate is assumed. Profit still uses total_fees."},{"name":"total_selling_fees_tax","type":"NUMBER","nullable":false,"description":"Tax reported by Amazon within selling fees, including value added tax (VAT). Uses the same dates and cost sign as total_selling_fees; refunds are excluded. Zero means no tax amount was reported. Profit still uses the existing fee total."},{"name":"total_selling_fees_net","type":"NUMBER","nullable":false,"description":"total_selling_fees minus total_selling_fees_tax. Excludes only tax reported by Amazon within this total; no tax rate is assumed. Profit still uses total_selling_fees."},{"name":"fba_fees_tax","type":"NUMBER","nullable":false,"description":"Tax reported by Amazon within Fulfillment by Amazon fees, including value added tax (VAT). Uses the same dates and cost sign as fba_fees; refunds are excluded. Zero means no tax amount was reported. Profit still uses the existing fee total."},{"name":"fba_fees_net","type":"NUMBER","nullable":false,"description":"fba_fees minus fba_fees_tax. Excludes only tax reported by Amazon within this total; no tax rate is assumed. Profit still uses fba_fees."},{"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 that carry this SKU. Stored as a positive cost. Subtract from sales. Amazon posts AWD processing, transportation and storage fees without a SKU, so this is usually 0; awd_fees_allocated estimates processing and transportation per SKU.","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":"awd_fees_allocated","type":"NUMBER","nullable":false,"description":"Estimated AWD processing and transportation fees of this SKU, stored as a positive cost. Amazon posts these fees without a SKU; each fee is split across the SKUs of its AWD replenishment order or inbound shipment by quantity (inbound quantities can be cases), in whole cents, on the date the fee posted. It is an allocation, not an amount Amazon reports per SKU. Not included in total_fees, total_cost or profit: subtract it from profit for an AWD-inclusive SKU profit. AWD storage and AGL freight and duty are not allocated. A SKU and date with only allocated fees has its own row, with empty traffic.","definition":"sum((amazon_settlements_with_cogs.settlement_type !== 'REFUND' && String(amazon_settlements_with_cogs.sku ?? '').trim() === '' ? 0 - ((amazon_settlements_with_cogs.awd_processing_fee ?? 0) + (amazon_settlements_with_cogs.awd_processing_fee_discount ?? 0) + (amazon_settlements_with_cogs.awd_transportation_fee ?? 0) + (amazon_settlements_with_cogs.awd_transportation_fee_discount ?? 0)) : 0) * skuQuantity / recordQuantity), where the record is amazon_settlements_with_cogs.amazon_order_id on the same sp_connection_id: 'repl-…' is amazon_awd_replenishment_order_line_items.awd_replenishment_order_id with skuQuantity amazon_awd_replenishment_order_line_items.quantity of line_item_source 'products'; 'IB_<date>_STAR-…' is amazon_awd_inbound_shipment_line_items.awd_inbound_shipment_id with skuQuantity received_quantity.quantity, or expected_quantity.quantity while nothing is received. Line items come from the latest sync of their record, each fee is split in whole cents by largest remainder, and a fee whose record has no SKU quantity is left out."},{"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":true,"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. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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":true,"description":"B2B buy box percentage for the child ASIN on this date, from Amazon Sales and Traffic buyBoxPercentageB2B. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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":true,"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. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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":true,"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. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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":true,"description":"B2B sessions for the child ASIN on this date, from Amazon Sales and Traffic sessionsB2B. Included in total_sessions, not additive. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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":true,"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. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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":true,"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. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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":true,"description":"B2B page views for the child ASIN on this date, from Amazon Sales and Traffic pageViewsB2B. Included in total_page_views, not additive. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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":true,"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. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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":"browser_sessions","type":"NUMBER","nullable":true,"description":"Sessions from web browsers for the child ASIN on this date, from Amazon Sales and Traffic browserSessions. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_sessions_b2b","type":"NUMBER","nullable":true,"description":"B2B sessions from web browsers for the child ASIN on this date, from Amazon Sales and Traffic browserSessionsB2B. Included in browser_sessions, not additive. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_sessions_b2c","type":"NUMBER","nullable":true,"description":"B2C sessions from web browsers for the child ASIN on this date, calculated as browser_sessions minus browser_sessions_b2b, floored at 0 per child ASIN. Amazon does not publish a B2C field. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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((raw_sp_api_report_sales_and_traffic.browserSessions ?? 0) - (raw_sp_api_report_sales_and_traffic.browserSessionsB2B ?? 0), 0))"},{"name":"mobile_sessions","type":"NUMBER","nullable":true,"description":"Sessions from the Amazon mobile app for the child ASIN on this date, from Amazon Sales and Traffic mobileAppSessions. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_sessions_b2b","type":"NUMBER","nullable":true,"description":"B2B sessions from the amazon mobile app for the child ASIN on this date, from Amazon Sales and Traffic mobileAppSessionsB2B. Included in mobile_sessions, not additive. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_sessions_b2c","type":"NUMBER","nullable":true,"description":"B2C sessions from the amazon mobile app for the child ASIN on this date, calculated as mobile_sessions minus mobile_sessions_b2b, floored at 0 per child ASIN. Amazon does not publish a B2C field. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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((raw_sp_api_report_sales_and_traffic.mobileAppSessions ?? 0) - (raw_sp_api_report_sales_and_traffic.mobileAppSessionsB2B ?? 0), 0))"},{"name":"browser_page_views","type":"NUMBER","nullable":true,"description":"Page views from web browsers for the child ASIN on this date, from Amazon Sales and Traffic browserPageViews. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_page_views_b2b","type":"NUMBER","nullable":true,"description":"B2B page views from web browsers for the child ASIN on this date, from Amazon Sales and Traffic browserPageViewsB2B. Included in browser_page_views, not additive. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_page_views_b2c","type":"NUMBER","nullable":true,"description":"B2C page views from web browsers for the child ASIN on this date, calculated as browser_page_views minus browser_page_views_b2b, floored at 0 per child ASIN. Amazon does not publish a B2C field. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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((raw_sp_api_report_sales_and_traffic.browserPageViews ?? 0) - (raw_sp_api_report_sales_and_traffic.browserPageViewsB2B ?? 0), 0))"},{"name":"mobile_page_views","type":"NUMBER","nullable":true,"description":"Page views from the Amazon mobile app for the child ASIN on this date, from Amazon Sales and Traffic mobileAppPageViews. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_page_views_b2b","type":"NUMBER","nullable":true,"description":"B2B page views from the amazon mobile app for the child ASIN on this date, from Amazon Sales and Traffic mobileAppPageViewsB2B. Included in mobile_page_views, not additive. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_page_views_b2c","type":"NUMBER","nullable":true,"description":"B2C page views from the amazon mobile app for the child ASIN on this date, calculated as mobile_page_views minus mobile_page_views_b2b, floored at 0 per child ASIN. Amazon does not publish a B2C field. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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((raw_sp_api_report_sales_and_traffic.mobileAppPageViews ?? 0) - (raw_sp_api_report_sales_and_traffic.mobileAppPageViewsB2B ?? 0), 0))"},{"name":"session_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily sessions as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic sessionPercentage. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"session_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B sessions as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic sessionPercentageB2B. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"page_views_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily page views as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic pageViewsPercentage. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"page_views_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B page views as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic pageViewsPercentageB2B. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_session_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily browser sessions as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic browserSessionPercentage. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_session_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B browser sessions as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic browserSessionPercentageB2B. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_session_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily mobile app sessions as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic mobileAppSessionPercentage. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_session_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B mobile app sessions as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic mobileAppSessionPercentageB2B. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_page_views_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily browser page views as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic browserPageViewsPercentage. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_page_views_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B browser page views as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic browserPageViewsPercentageB2B. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_page_views_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily mobile app page views as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic mobileAppPageViewsPercentage. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_page_views_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B mobile app page views as a percentage (0-100) for the child ASIN on this date, from Amazon Sales and Traffic mobileAppPageViewsPercentageB2B. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"unit_session_percentage","type":"NUMBER","nullable":true,"description":"Units ordered (not shipped units) as a percentage of sessions for the child ASIN on this date, from Amazon Sales and Traffic unitSessionPercentage. Can exceed 100. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"unit_session_percentage_b2b","type":"NUMBER","nullable":true,"description":"B2B units ordered as a percentage of B2B sessions for the child ASIN on this date, from Amazon Sales and Traffic unitSessionPercentageB2B. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. Empty when Amazon has not published traffic for the connection and date yet; 0 when traffic is published but the child ASIN had none. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"ordered_product_sales","type":"NUMBER","nullable":true,"description":"Ordered product sales in the row currency for the child ASIN on this date, as reported by Amazon Sales and Traffic Data Kiosk orderedProductSales. Missing report values remain empty. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"ordered_product_sales_b2b","type":"NUMBER","nullable":true,"description":"B2B ordered product sales in the row currency for the child ASIN on this date, as reported by Amazon Sales and Traffic Data Kiosk orderedProductSalesB2B. Included in ordered_product_sales, not additive. Missing report values remain empty. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"units_ordered","type":"NUMBER","nullable":true,"description":"Units ordered for the child ASIN on this date, as reported by Amazon Sales and Traffic Data Kiosk unitsOrdered. Missing report values remain empty. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"units_ordered_b2b","type":"NUMBER","nullable":true,"description":"B2B units ordered for the child ASIN on this date, as reported by Amazon Sales and Traffic Data Kiosk unitsOrderedB2B. Included in units_ordered, not additive. Missing report values remain empty. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"total_order_items","type":"NUMBER","nullable":true,"description":"Order items ordered, not distinct orders for the child ASIN on this date, as reported by Amazon Sales and Traffic Data Kiosk totalOrderItems. Missing report values remain empty. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"total_order_items_b2b","type":"NUMBER","nullable":true,"description":"B2B order items ordered, not distinct orders for the child ASIN on this date, as reported by Amazon Sales and Traffic Data Kiosk totalOrderItemsB2B. Included in total_order_items, not additive. Missing report values remain empty. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"units_refunded","type":"NUMBER","nullable":false,"description":"Units refunded for the child ASIN on this date, from Amazon Sales and Traffic unitsRefunded. Can differ from return_units, which counts customer returns. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"units_refunded_b2b","type":"NUMBER","nullable":false,"description":"B2B units refunded for the child ASIN on this date, from Amazon Sales and Traffic unitsRefundedB2B. Included in units_refunded, not additive. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"refund_rate","type":"NUMBER","nullable":false,"description":"Units refunded as a percentage of units ordered for the child ASIN on this date, from Amazon Sales and Traffic refundRate. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"refund_rate_b2b","type":"NUMBER","nullable":false,"description":"B2B units refunded as a percentage of B2B units ordered for the child ASIN on this date, from Amazon Sales and Traffic refundRateB2B. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Take max per seller, marketplace, child ASIN and date, including rows with no SKU. Do not add percentages; for several days or ASINs, recalculate the ratio from totals. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"shipped_product_sales","type":"NUMBER","nullable":false,"description":"Shipped product sales for the child ASIN on this date in the row currency, from Amazon Sales and Traffic shippedProductSales. Amazon reports shipped values per child ASIN as 0 for older days (seen on days a year or more back); use the amazon_profit_by_date shipped columns for daily totals. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"shipped_product_sales_b2b","type":"NUMBER","nullable":false,"description":"B2B shipped product sales for the child ASIN on this date, from Amazon Sales and Traffic shippedProductSalesB2B. Included in shipped_product_sales, not additive. Amazon reports shipped values per child ASIN as 0 for older days (seen on days a year or more back); use the amazon_profit_by_date shipped columns for daily totals. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"units_shipped","type":"NUMBER","nullable":false,"description":"Units shipped for the child ASIN on this date, from Amazon Sales and Traffic unitsShipped. Amazon reports shipped values per child ASIN as 0 for older days (seen on days a year or more back); use the amazon_profit_by_date shipped columns for daily totals. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"units_shipped_b2b","type":"NUMBER","nullable":false,"description":"B2B units shipped for the child ASIN on this date, from Amazon Sales and Traffic unitsShippedB2B. Included in units_shipped, not additive. Amazon reports shipped values per child ASIN as 0 for older days (seen on days a year or more back); use the amazon_profit_by_date shipped columns for daily totals. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"orders_shipped","type":"NUMBER","nullable":false,"description":"Orders shipped for the child ASIN on this date, from Amazon Sales and Traffic ordersShipped. Amazon reports shipped values per child ASIN as 0 for older days (seen on days a year or more back); use the amazon_profit_by_date shipped columns for daily totals. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"orders_shipped_b2b","type":"NUMBER","nullable":false,"description":"B2B orders shipped for the child ASIN on this date, from Amazon Sales and Traffic ordersShippedB2B. Included in orders_shipped, not additive. Amazon reports shipped values per child ASIN as 0 for older days (seen on days a year or more back); use the amazon_profit_by_date shipped columns for daily totals. Describes the child ASIN, not the SKU, and repeats on every SKU row of that child ASIN and date, for example its FBA and FBM SKUs. Do not add it across SKU rows: take max per seller, marketplace, child ASIN and date, including rows with no SKU, then add the daily values. From Amazon Sales and Traffic (Data Kiosk). 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."},{"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 Amazon marketplace orders, settlement fees, COGS and ad spend. Off-Amazon Multi-Channel Fulfillment lines are excluded from sales, units, orders, tax, and COGS. Their order-report amounts are fulfillment or declared values, not verified external-channel revenue, and this table is not a complete MCF profit statement. Prefer this table for SKU and child-ASIN profit drill-down instead of calculating manually from other tables. Amazon Sales and Traffic provides traffic per child ASIN, not per SKU, because shoppers view product detail pages per child ASIN: sessions, page views, buy box percentage, unit session percentage and the other Sales and Traffic columns repeat on every SKU row of that child ASIN and date. For example, a child ASIN sold through an FBA SKU and an FBM SKU shows the same total_sessions on both rows; adding them doubles the sessions. To aggregate traffic, take max per seller, marketplace, child ASIN and date (keep rows with no SKU, which hold traffic without SKU activity), then add the daily values across dates; recalculate ratios from those totals instead of adding percentages. Sessions are also not additive across child ASINs or parent ASINs, because Amazon counts a shopper visit once; use amazon_profit_by_date total_sessions for account sessions. Traffic columns are empty when Amazon has not published traffic for the date yet. Guide: https://app.datadoe.com/hub/docs/datadoe-data/sat-migration-to-profit-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_listings_items","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","raw_sp_api_awd_replenishment_orders","raw_sp_api_awd_replenishment_order_line_items","raw_sp_api_awd_inbound_shipments","raw_sp_api_awd_inbound_shipment_line_items"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["pnl","p&l","net profit","sku profit","contribution margin","margin","sessions","page views","traffic","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":"item_supplier_name","type":"TEXT","nullable":true,"description":"Comma-separated list of distinct supplier names from COGS uploads for shipped items."},{"name":"total_sales","type":"NUMBER","nullable":false,"description":"Sales from shipped Amazon marketplace order items. Includes tax where Amazon reports prices with tax; see sales_tax. Excludes off-Amazon Multi-Channel Fulfillment lines; their order-report amounts are fulfillment or declared values, not verified external-channel revenue.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && (amazon_order_items_with_cogs.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) && ((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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (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_units","type":"NUMBER","nullable":false,"description":"Units from Amazon marketplace order items whose status contains unshipped, ignoring case. Uses the purchase date and the same status filter as unshipped_sales. Excludes off-Amazon Multi-Channel Fulfillment lines. Not included in total_units_sold.","definition":"sum(String(amazon_order_items_with_cogs.item_status).toLowerCase().includes('unshipped') && (amazon_order_items_with_cogs.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? (amazon_order_items_with_cogs.quantity ?? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase()))) && 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase()))) && !(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 Amazon marketplace order items. Excludes off-Amazon Multi-Channel Fulfillment lines.","definition":"sum(amazon_order_items_with_cogs.item_status === 'Shipped' && (amazon_order_items_with_cogs.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? amazon_order_items_with_cogs.quantity : 0)"},{"name":"total_orders","type":"NUMBER","nullable":false,"description":"Distinct shipped Amazon marketplace orders. Excludes off-Amazon Multi-Channel Fulfillment lines.","definition":"countDistinct(amazon_order_items_with_cogs.item_status === 'Shipped' && (amazon_order_items_with_cogs.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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.sales_channel == null || String(amazon_order_items_with_cogs.sales_channel).trim() === '' || [\"amazon.ae\",\"amazon.ca\",\"amazon.co.jp\",\"amazon.co.uk\",\"amazon.co.za\",\"amazon.com\",\"amazon.com.au\",\"amazon.com.be\",\"amazon.com.br\",\"amazon.com.mx\",\"amazon.com.tr\",\"amazon.de\",\"amazon.eg\",\"amazon.es\",\"amazon.fr\",\"amazon.ie\",\"amazon.in\",\"amazon.it\",\"amazon.nl\",\"amazon.pl\",\"amazon.sa\",\"amazon.se\",\"amazon.sg\"].includes(String(amazon_order_items_with_cogs.sales_channel).trim().toLowerCase())) ? 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. To list SKUs sold in the last 30 days without COGS, use GET /api/v1/cogs/missing or the MCP tool cogs_missing_list."},{"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. shipping_tax_discount is excluded too, because order shipping tax is already net of the shipping discount. 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.shipping_tax_discount ?? 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":"total_fees_tax","type":"NUMBER","nullable":false,"description":"Tax reported by Amazon within total_fees, including value added tax (VAT). Uses the same dates and cost sign as total_fees; refunds are excluded. Zero means no tax amount was reported. Profit still uses the existing fee total."},{"name":"total_fees_net","type":"NUMBER","nullable":false,"description":"total_fees minus total_fees_tax. Excludes only tax reported by Amazon within this total; no tax rate is assumed. Profit still uses total_fees."},{"name":"total_selling_fees_tax","type":"NUMBER","nullable":false,"description":"Tax reported by Amazon within selling fees, including value added tax (VAT). Uses the same dates and cost sign as total_selling_fees; refunds are excluded. Zero means no tax amount was reported. Profit still uses the existing fee total."},{"name":"total_selling_fees_net","type":"NUMBER","nullable":false,"description":"total_selling_fees minus total_selling_fees_tax. Excludes only tax reported by Amazon within this total; no tax rate is assumed. Profit still uses total_selling_fees."},{"name":"fba_fees_tax","type":"NUMBER","nullable":false,"description":"Tax reported by Amazon within Fulfillment by Amazon fees, including value added tax (VAT). Uses the same dates and cost sign as fba_fees; refunds are excluded. Zero means no tax amount was reported. Profit still uses the existing fee total."},{"name":"fba_fees_net","type":"NUMBER","nullable":false,"description":"fba_fees minus fba_fees_tax. Excludes only tax reported by Amazon within this total; no tax rate is assumed. Profit still uses fba_fees."},{"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":true,"description":"Account-level buy box percentage for the day, from Amazon Sales and Traffic daily buyBoxPercentage. Buy box percentage is the share of page views where the buy box (add to cart) appeared for your offers. Falls back to the average of child ASINs weighted by page views when the day has no account total. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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":"(raw_sp_api_report_sales_and_traffic_by_date.sessions ?? 0) > 0 ? raw_sp_api_report_sales_and_traffic_by_date.buyBoxPercentage : sum(amazon_sales_and_traffic_with_cogs.buybox_percentage * amazon_sales_and_traffic_with_cogs.page_views) / sum(amazon_sales_and_traffic_with_cogs.page_views)"},{"name":"avg_buybox_percentage_b2b","type":"NUMBER","nullable":true,"description":"Account-level B2B buy box percentage for the day, from Amazon Sales and Traffic daily buyBoxPercentageB2B. Falls back to the average of child ASINs weighted by page views when the day has no account total. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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":"(raw_sp_api_report_sales_and_traffic_by_date.sessions ?? 0) > 0 ? raw_sp_api_report_sales_and_traffic_by_date.buyBoxPercentageB2B : sum(amazon_sales_and_traffic_with_cogs.buybox_percentage_b2b * amazon_sales_and_traffic_with_cogs.page_views_b2b) / sum(amazon_sales_and_traffic_with_cogs.page_views_b2b)"},{"name":"avg_buybox_percentage_b2c","type":"NUMBER","nullable":true,"description":"Account-level B2C buy box percentage for the day. Amazon does not publish B2C buy box; reconstructed from the daily overall and B2B buy box weighted by page views. Falls back to the average of child ASINs weighted by page views when the day has no account total. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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":"(raw_sp_api_report_sales_and_traffic_by_date.sessions ?? 0) > 0 ? ((raw_sp_api_report_sales_and_traffic_by_date.buyBoxPercentage ?? 0) * (raw_sp_api_report_sales_and_traffic_by_date.pageViews ?? 0) - (raw_sp_api_report_sales_and_traffic_by_date.buyBoxPercentageB2B ?? 0) * (raw_sp_api_report_sales_and_traffic_by_date.pageViewsB2B ?? 0)) / ((raw_sp_api_report_sales_and_traffic_by_date.pageViews ?? 0) - (raw_sp_api_report_sales_and_traffic_by_date.pageViewsB2B ?? 0)) : sum((amazon_sales_and_traffic_with_cogs.buybox_percentage * amazon_sales_and_traffic_with_cogs.page_views) - (amazon_sales_and_traffic_with_cogs.buybox_percentage_b2b ?? 0) * (amazon_sales_and_traffic_with_cogs.page_views_b2b ?? 0)) / sum(Math.max(amazon_sales_and_traffic_with_cogs.page_views - (amazon_sales_and_traffic_with_cogs.page_views_b2b ?? 0), 0))"},{"name":"total_sessions","type":"NUMBER","nullable":true,"description":"Account-level sessions for the day, from Amazon Sales and Traffic daily sessions. A session is a visit to your Amazon product detail pages via browser or mobile app, counted once even when it covers several child ASINs, so it can be lower than the sum of child ASIN sessions. Empty until Amazon publishes the day's account total; child ASIN sessions are not added up as a substitute. From Amazon Sales and Traffic (Data Kiosk). 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":"(raw_sp_api_report_sales_and_traffic_by_date.sessions ?? 0) > 0 ? raw_sp_api_report_sales_and_traffic_by_date.sessions : null"},{"name":"sessions_b2b","type":"NUMBER","nullable":true,"description":"Account-level B2B sessions for the day, from Amazon Sales and Traffic daily sessionsB2B. Included in total_sessions, not additive. Empty until Amazon publishes the day's account total. From Amazon Sales and Traffic (Data Kiosk). 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":"(raw_sp_api_report_sales_and_traffic_by_date.sessions ?? 0) > 0 ? raw_sp_api_report_sales_and_traffic_by_date.sessionsB2B : null"},{"name":"sessions_b2c","type":"NUMBER","nullable":true,"description":"Account-level B2C sessions for the day, calculated as total_sessions minus sessions_b2b. Amazon does not publish a B2C sessions field. Empty until Amazon publishes the day's account total. From Amazon Sales and Traffic (Data Kiosk). 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":"(raw_sp_api_report_sales_and_traffic_by_date.sessions ?? 0) > 0 ? Math.max((raw_sp_api_report_sales_and_traffic_by_date.sessions ?? 0) - (raw_sp_api_report_sales_and_traffic_by_date.sessionsB2B ?? 0), 0) : null"},{"name":"total_page_views","type":"NUMBER","nullable":true,"description":"Account-level page views for the day, from Amazon Sales and Traffic daily pageViews. Page views count visits to your Amazon product detail pages via browser or mobile app. Falls back to the sum of child ASIN rows when the day has no account total. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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":"(raw_sp_api_report_sales_and_traffic_by_date.sessions ?? 0) > 0 ? raw_sp_api_report_sales_and_traffic_by_date.pageViews : sum(amazon_sales_and_traffic_with_cogs.page_views)"},{"name":"page_views_b2b","type":"NUMBER","nullable":true,"description":"Account-level B2B page views for the day, from Amazon Sales and Traffic daily pageViewsB2B. Included in total_page_views, not additive. Falls back to the sum of child ASIN rows when the day has no account total. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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":"(raw_sp_api_report_sales_and_traffic_by_date.sessions ?? 0) > 0 ? raw_sp_api_report_sales_and_traffic_by_date.pageViewsB2B : sum(amazon_sales_and_traffic_with_cogs.page_views_b2b)"},{"name":"page_views_b2c","type":"NUMBER","nullable":true,"description":"Account-level B2C page views for the day, calculated as total_page_views minus page_views_b2b. Amazon does not publish a B2C page views field. Falls back to the sum of child ASIN rows when the day has no account total. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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":"(raw_sp_api_report_sales_and_traffic_by_date.sessions ?? 0) > 0 ? Math.max((raw_sp_api_report_sales_and_traffic_by_date.pageViews ?? 0) - (raw_sp_api_report_sales_and_traffic_by_date.pageViewsB2B ?? 0), 0) : sum(Math.max((amazon_sales_and_traffic_with_cogs.page_views ?? 0) - (amazon_sales_and_traffic_with_cogs.page_views_b2b ?? 0), 0))"},{"name":"ordered_product_sales","type":"NUMBER","nullable":true,"description":"Ordered product sales in the row currency for the account on this date, as reported by Amazon Sales and Traffic Data Kiosk orderedProductSales. Missing report values remain empty. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"ordered_product_sales_b2b","type":"NUMBER","nullable":true,"description":"B2B ordered product sales in the row currency for the account on this date, as reported by Amazon Sales and Traffic Data Kiosk orderedProductSalesB2B. Included in ordered_product_sales, not additive. Missing report values remain empty. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"units_ordered","type":"NUMBER","nullable":true,"description":"Units ordered for the account on this date, as reported by Amazon Sales and Traffic Data Kiosk unitsOrdered. Missing report values remain empty. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"units_ordered_b2b","type":"NUMBER","nullable":true,"description":"B2B units ordered for the account on this date, as reported by Amazon Sales and Traffic Data Kiosk unitsOrderedB2B. Included in units_ordered, not additive. Missing report values remain empty. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"total_order_items","type":"NUMBER","nullable":true,"description":"Order items ordered, not distinct orders for the account on this date, as reported by Amazon Sales and Traffic Data Kiosk totalOrderItems. Missing report values remain empty. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"total_order_items_b2b","type":"NUMBER","nullable":true,"description":"B2B order items ordered, not distinct orders for the account on this date, as reported by Amazon Sales and Traffic Data Kiosk totalOrderItemsB2B. Included in total_order_items, not additive. Missing report values remain empty. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"average_sales_per_order_item","type":"NUMBER","nullable":false,"description":"Account-level average ordered product sales per order item for the day, from Amazon Sales and Traffic averageSalesPerOrderItem. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"average_sales_per_order_item_b2b","type":"NUMBER","nullable":false,"description":"Account-level average ordered product sales per B2B order item for the day, from Amazon Sales and Traffic averageSalesPerOrderItemB2B. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"average_sales_per_order_item_b2c","type":"NUMBER","nullable":false,"description":"Account-level average ordered product sales per B2C order item for the day, reconstructed from overall and B2B averages weighted by order items. Amazon does not publish a B2C field. From Amazon Sales and Traffic (Data Kiosk). 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":"((raw_sp_api_report_sales_and_traffic_by_date.averageSalesPerOrderItem ?? 0) * (raw_sp_api_report_sales_and_traffic_by_date.totalOrderItems ?? 0) - (raw_sp_api_report_sales_and_traffic_by_date.averageSalesPerOrderItemB2B ?? 0) * (raw_sp_api_report_sales_and_traffic_by_date.totalOrderItemsB2B ?? 0)) / ((raw_sp_api_report_sales_and_traffic_by_date.totalOrderItems ?? 0) - (raw_sp_api_report_sales_and_traffic_by_date.totalOrderItemsB2B ?? 0))"},{"name":"average_units_per_order_item","type":"NUMBER","nullable":false,"description":"Account-level average units per order item for the day, from Amazon Sales and Traffic averageUnitsPerOrderItem. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"average_units_per_order_item_b2b","type":"NUMBER","nullable":false,"description":"Account-level average units per B2B order item for the day, from Amazon Sales and Traffic averageUnitsPerOrderItemB2B. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"average_units_per_order_item_b2c","type":"NUMBER","nullable":false,"description":"Account-level average units per B2C order item for the day, reconstructed from overall and B2B averages weighted by order items. Amazon does not publish a B2C field. From Amazon Sales and Traffic (Data Kiosk). 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":"((raw_sp_api_report_sales_and_traffic_by_date.averageUnitsPerOrderItem ?? 0) * (raw_sp_api_report_sales_and_traffic_by_date.totalOrderItems ?? 0) - (raw_sp_api_report_sales_and_traffic_by_date.averageUnitsPerOrderItemB2B ?? 0) * (raw_sp_api_report_sales_and_traffic_by_date.totalOrderItemsB2B ?? 0)) / ((raw_sp_api_report_sales_and_traffic_by_date.totalOrderItems ?? 0) - (raw_sp_api_report_sales_and_traffic_by_date.totalOrderItemsB2B ?? 0))"},{"name":"claims_granted","type":"NUMBER","nullable":false,"description":"Number of A-to-z Guarantee claims granted for the day, from Amazon Sales and Traffic claimsGranted. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"claims_granted_b2b","type":"NUMBER","nullable":false,"description":"Number of A-to-z Guarantee claims granted for B2B orders for the day, from Amazon Sales and Traffic claimsGrantedB2B. Included in claims_granted, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"claims_granted_b2c","type":"NUMBER","nullable":false,"description":"Number of A-to-z Guarantee claims granted for B2C orders for the day, calculated as claims_granted minus claims_granted_b2b. Amazon does not publish a B2C field. From Amazon Sales and Traffic (Data Kiosk). 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":"Math.max((amazon_profit_by_date.claims_granted ?? 0) - (amazon_profit_by_date.claims_granted_b2b ?? 0), 0)"},{"name":"claims_amount","type":"NUMBER","nullable":false,"description":"Amount of A-to-z Guarantee claims granted for the day in the row currency, from Amazon Sales and Traffic claimsAmount. Not included in profit or refund_cost. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"claims_amount_b2b","type":"NUMBER","nullable":false,"description":"Amount of A-to-z Guarantee claims granted for B2B orders for the day, from Amazon Sales and Traffic claimsAmountB2B. Included in claims_amount, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"claims_amount_b2c","type":"NUMBER","nullable":false,"description":"Amount of A-to-z Guarantee claims granted for B2C orders for the day, calculated as claims_amount minus claims_amount_b2b. Amazon does not publish a B2C field. From Amazon Sales and Traffic (Data Kiosk). 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":"Math.max((amazon_profit_by_date.claims_amount ?? 0) - (amazon_profit_by_date.claims_amount_b2b ?? 0), 0)"},{"name":"units_refunded","type":"NUMBER","nullable":false,"description":"Units refunded for the day as reported by Amazon Sales and Traffic unitsRefunded. Can differ from return_units, which counts customer returns. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"units_refunded_b2b","type":"NUMBER","nullable":false,"description":"B2B units refunded for the day, from Amazon Sales and Traffic unitsRefundedB2B. Included in units_refunded, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"refund_rate","type":"NUMBER","nullable":false,"description":"Units refunded as a percentage of units ordered for the day, from Amazon Sales and Traffic refundRate. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"refund_rate_b2b","type":"NUMBER","nullable":false,"description":"B2B units refunded as a percentage of B2B units ordered for the day, from Amazon Sales and Traffic refundRateB2B. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"shipped_product_sales","type":"NUMBER","nullable":false,"description":"Account-level shipped product sales for the day in the row currency, from Amazon Sales and Traffic shippedProductSales. Amazon's own figure; can differ from total_sales, which is built from order items. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"shipped_product_sales_b2b","type":"NUMBER","nullable":false,"description":"Account-level B2B shipped product sales for the day, from Amazon Sales and Traffic shippedProductSalesB2B. Included in shipped_product_sales, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"units_shipped","type":"NUMBER","nullable":false,"description":"Account-level units shipped for the day, from Amazon Sales and Traffic unitsShipped. Amazon's own figure; can differ from total_units_sold, which is built from order items. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"units_shipped_b2b","type":"NUMBER","nullable":false,"description":"Account-level B2B units shipped for the day, from Amazon Sales and Traffic unitsShippedB2B. Included in units_shipped, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"orders_shipped","type":"NUMBER","nullable":false,"description":"Account-level orders shipped for the day, from Amazon Sales and Traffic ordersShipped. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"orders_shipped_b2b","type":"NUMBER","nullable":false,"description":"Account-level B2B orders shipped for the day, from Amazon Sales and Traffic ordersShippedB2B. Included in orders_shipped, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"average_offer_count","type":"NUMBER","nullable":false,"description":"Account-level average number of offers listed for sale for the day, from Amazon Sales and Traffic averageOfferCount. Do not sum across days. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"average_parent_items","type":"NUMBER","nullable":false,"description":"Account-level average number of parent items listed for sale for the day, from Amazon Sales and Traffic averageParentItems. Do not sum across days. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"feedback_received","type":"NUMBER","nullable":false,"description":"Number of seller feedback ratings received for the day, from Amazon Sales and Traffic feedbackReceived. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"feedback_received_b2b","type":"NUMBER","nullable":false,"description":"Number of seller feedback ratings received from B2B buyers for the day, from Amazon Sales and Traffic feedbackReceivedB2B. Included in feedback_received, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"feedback_received_b2c","type":"NUMBER","nullable":false,"description":"Number of seller feedback ratings received from B2C buyers for the day, calculated as feedback_received minus feedback_received_b2b. Amazon does not publish a B2C field. From Amazon Sales and Traffic (Data Kiosk). 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":"Math.max((amazon_profit_by_date.feedback_received ?? 0) - (amazon_profit_by_date.feedback_received_b2b ?? 0), 0)"},{"name":"negative_feedback_received","type":"NUMBER","nullable":false,"description":"Number of negative seller feedback ratings received for the day, from Amazon Sales and Traffic negativeFeedbackReceived. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"negative_feedback_received_b2b","type":"NUMBER","nullable":false,"description":"Number of negative seller feedback ratings received from B2B buyers for the day, from Amazon Sales and Traffic negativeFeedbackReceivedB2B. Included in negative_feedback_received, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"received_negative_feedback_rate","type":"NUMBER","nullable":false,"description":"Negative seller feedback received as a percentage of feedback received for the day, from Amazon Sales and Traffic receivedNegativeFeedbackRate. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"received_negative_feedback_rate_b2b","type":"NUMBER","nullable":false,"description":"B2B negative seller feedback received as a percentage of B2B feedback received for the day, from Amazon Sales and Traffic receivedNegativeFeedbackRateB2B. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_sessions","type":"NUMBER","nullable":false,"description":"Account-level sessions from web browsers for the day, from Amazon Sales and Traffic browserSessions. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_sessions_b2b","type":"NUMBER","nullable":false,"description":"Account-level B2B sessions from web browsers for the day, from Amazon Sales and Traffic browserSessionsB2B. Included in browser_sessions, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_sessions","type":"NUMBER","nullable":false,"description":"Account-level sessions from the Amazon mobile app for the day, from Amazon Sales and Traffic mobileAppSessions. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_sessions_b2b","type":"NUMBER","nullable":false,"description":"Account-level B2B sessions from the Amazon mobile app for the day, from Amazon Sales and Traffic mobileAppSessionsB2B. Included in mobile_sessions, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_page_views","type":"NUMBER","nullable":false,"description":"Account-level page views from web browsers for the day, from Amazon Sales and Traffic browserPageViews. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"browser_page_views_b2b","type":"NUMBER","nullable":false,"description":"Account-level B2B page views from web browsers for the day, from Amazon Sales and Traffic browserPageViewsB2B. Included in browser_page_views, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_page_views","type":"NUMBER","nullable":false,"description":"Account-level page views from the Amazon mobile app for the day, from Amazon Sales and Traffic mobileAppPageViews. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"mobile_page_views_b2b","type":"NUMBER","nullable":false,"description":"Account-level B2B page views from the Amazon mobile app for the day, from Amazon Sales and Traffic mobileAppPageViewsB2B. Included in mobile_page_views, not additive. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"unit_session_percentage","type":"NUMBER","nullable":false,"description":"Account-level units ordered as a percentage of sessions for the day, from Amazon Sales and Traffic unitSessionPercentage. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"unit_session_percentage_b2b","type":"NUMBER","nullable":false,"description":"Account-level B2B units ordered as a percentage of B2B sessions for the day, from Amazon Sales and Traffic unitSessionPercentageB2B. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"order_item_session_percentage","type":"NUMBER","nullable":false,"description":"Account-level order items as a percentage of sessions for the day, from Amazon Sales and Traffic orderItemSessionPercentage. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"order_item_session_percentage_b2b","type":"NUMBER","nullable":false,"description":"Account-level B2B order items as a percentage of B2B sessions for the day, from Amazon Sales and Traffic orderItemSessionPercentageB2B. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_browser_sessions","type":"NUMBER","nullable":true,"description":"Sessions from web browsers summed across child ASIN rows for the day, from Amazon Sales and Traffic browserSessions. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_browser_sessions_b2b","type":"NUMBER","nullable":true,"description":"B2B sessions from web browsers summed across child ASIN rows for the day, from Amazon Sales and Traffic browserSessionsB2B. Included in asin_browser_sessions, not additive. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_browser_sessions_b2c","type":"NUMBER","nullable":true,"description":"B2C sessions from web browsers summed across child ASIN rows for the day, calculated as asin_browser_sessions minus asin_browser_sessions_b2b, floored at 0 per child ASIN. Amazon does not publish a B2C field. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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((raw_sp_api_report_sales_and_traffic.browserSessions ?? 0) - (raw_sp_api_report_sales_and_traffic.browserSessionsB2B ?? 0), 0))"},{"name":"asin_mobile_sessions","type":"NUMBER","nullable":true,"description":"Sessions from the Amazon mobile app summed across child ASIN rows for the day, from Amazon Sales and Traffic mobileAppSessions. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_mobile_sessions_b2b","type":"NUMBER","nullable":true,"description":"B2B sessions from the amazon mobile app summed across child ASIN rows for the day, from Amazon Sales and Traffic mobileAppSessionsB2B. Included in asin_mobile_sessions, not additive. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_mobile_sessions_b2c","type":"NUMBER","nullable":true,"description":"B2C sessions from the amazon mobile app summed across child ASIN rows for the day, calculated as asin_mobile_sessions minus asin_mobile_sessions_b2b, floored at 0 per child ASIN. Amazon does not publish a B2C field. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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((raw_sp_api_report_sales_and_traffic.mobileAppSessions ?? 0) - (raw_sp_api_report_sales_and_traffic.mobileAppSessionsB2B ?? 0), 0))"},{"name":"asin_browser_page_views","type":"NUMBER","nullable":true,"description":"Page views from web browsers summed across child ASIN rows for the day, from Amazon Sales and Traffic browserPageViews. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_browser_page_views_b2b","type":"NUMBER","nullable":true,"description":"B2B page views from web browsers summed across child ASIN rows for the day, from Amazon Sales and Traffic browserPageViewsB2B. Included in asin_browser_page_views, not additive. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_browser_page_views_b2c","type":"NUMBER","nullable":true,"description":"B2C page views from web browsers summed across child ASIN rows for the day, calculated as asin_browser_page_views minus asin_browser_page_views_b2b, floored at 0 per child ASIN. Amazon does not publish a B2C field. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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((raw_sp_api_report_sales_and_traffic.browserPageViews ?? 0) - (raw_sp_api_report_sales_and_traffic.browserPageViewsB2B ?? 0), 0))"},{"name":"asin_mobile_page_views","type":"NUMBER","nullable":true,"description":"Page views from the Amazon mobile app summed across child ASIN rows for the day, from Amazon Sales and Traffic mobileAppPageViews. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_mobile_page_views_b2b","type":"NUMBER","nullable":true,"description":"B2B page views from the amazon mobile app summed across child ASIN rows for the day, from Amazon Sales and Traffic mobileAppPageViewsB2B. Included in asin_mobile_page_views, not additive. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_mobile_page_views_b2c","type":"NUMBER","nullable":true,"description":"B2C page views from the amazon mobile app summed across child ASIN rows for the day, calculated as asin_mobile_page_views minus asin_mobile_page_views_b2b, floored at 0 per child ASIN. Amazon does not publish a B2C field. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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((raw_sp_api_report_sales_and_traffic.mobileAppPageViews ?? 0) - (raw_sp_api_report_sales_and_traffic.mobileAppPageViewsB2B ?? 0), 0))"},{"name":"asin_session_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily sessions as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic sessionPercentage. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_session_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B sessions as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic sessionPercentageB2B. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_page_views_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily page views as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic pageViewsPercentage. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_page_views_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B page views as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic pageViewsPercentageB2B. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_browser_session_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily browser sessions as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic browserSessionPercentage. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_browser_session_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B browser sessions as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic browserSessionPercentageB2B. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_mobile_session_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily mobile app sessions as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic mobileAppSessionPercentage. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_mobile_session_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B mobile app sessions as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic mobileAppSessionPercentageB2B. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_browser_page_views_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily browser page views as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic browserPageViewsPercentage. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_browser_page_views_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B browser page views as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic browserPageViewsPercentageB2B. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_mobile_page_views_percentage","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily mobile app page views as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic mobileAppPageViewsPercentage. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_mobile_page_views_percentage_b2b","type":"NUMBER","nullable":true,"description":"Child ASIN share of the account's daily B2B mobile app page views as a percentage (0-100) summed across child ASIN rows for the day, from Amazon Sales and Traffic mobileAppPageViewsPercentageB2B. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_unit_session_percentage","type":"NUMBER","nullable":true,"description":"Units ordered as a percentage of sessions across child ASIN rows for the day, the per-ASIN unitSessionPercentage weighted by sessions. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"name":"asin_unit_session_percentage_b2b","type":"NUMBER","nullable":true,"description":"B2B units ordered as a percentage of B2B sessions across child ASIN rows for the day, the per-ASIN unitSessionPercentageB2B weighted by B2B sessions. Empty when Amazon has not published traffic for the date yet. From Amazon Sales and Traffic (Data Kiosk). 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."},{"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 Amazon marketplace orders, settlement fees, COGS and ads spend. Off-Amazon Multi-Channel Fulfillment lines are excluded from sales, units, orders, tax, and COGS. Their order-report amounts are fulfillment or declared values, not verified external-channel revenue, and this table is not a complete MCF profit statement. Prefer this table for account-level P&L instead of calculating manually from other tables. Amazon Sales and Traffic provides account sessions, page views, buy box percentage, and unit session percentage. 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). Columns from average_sales_per_order_item through order_item_session_percentage_b2b are Amazon daily account totals from Sales and Traffic, filled for seller accounts only, and are not sums of per-ASIN rows. total_sessions, total_page_views, avg_buybox_percentage and their B2B and B2C variants also use the daily account totals. When the day has no account total yet, page views fall back to the sum of child ASIN rows and buy box to their page-view-weighted average, while sessions stay empty because Amazon counts a session once across child ASINs. Columns starting with asin_ are per child ASIN Sales and Traffic values summed for the day. Traffic columns are empty when Amazon has not published traffic for the date yet.","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_sales_and_traffic_by_date","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","page views","traffic","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. To list SKUs sold in the last 30 days without COGS, use GET /api/v1/cogs/missing or the MCP tool cogs_missing_list."},{"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: amazon_sales_and_traffic_with_cogs will be removed on November 22, 2026. Use amazon_profit_by_sku_and_date for SKU and child-ASIN analysis and amazon_profit_by_date for daily account summaries. These tables provide consistent sales and profitability definitions and more current sales data; Amazon traffic reports can still be delayed. SAT contains Sales and Traffic report metrics per child ASIN and date, including ordered sales and units. Read the SAT migration to profit tables guide at https://app.datadoe.com/hub/docs/datadoe-data/sat-migration-to-profit-tables or open a support ticket for help. The underlying report data remains available through the Raw BigQuery integration.","requiresDatePeriod":true,"issues":[{"title":"Deprecated: removal on November 22, 2026","description":"The Sales & Traffic by ASIN & Date (SAT) table will be removed on November 22, 2026. Migrate reports, exports, schedules, and integrations to Profit by SKU & Date or Profit by Date before that date. Read the [SAT migration to profit tables guide](https://app.datadoe.com/hub/docs/datadoe-data/sat-migration-to-profit-tables) or [open a support ticket](https://forms.clickup.com/9015200219/f/8cnj2ev-38615/AOYF9I35QFOXWJQXIG?type=Form&source=hub-sat-migration-docs) for help. The underlying report data remains available through the Raw BigQuery integration."}],"fetchPeriods":[{"type":"INITIAL","numberOfDays":35},{"type":"RECURRING_DAILY","numberOfDays":5},{"type":"RECURRING_MONTHLY","numberOfDays":30,"shiftDays":5}],"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":"Purchase date in the connection country's time zone, including off-Amazon MCF lines."},{"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":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose order-report copy holds this row. Off-Amazon MCF lines are kept once per seller account, from the latest Amazon update.","bigQueryOnly":true},{"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":"TEXT","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 Amazon supplied. Amazon marketplace orders use the marketplace domain, such as Amazon.com. Any other non-empty value, including generic Non-Amazon, is an off-Amazon Multi-Channel Fulfillment line. Amazon does not name the external store. 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 from the order report. Excludes buyer shipping. For an off-Amazon sales channel this is Amazon's reported amount, a fulfillment or declared value, not verified external-channel revenue. 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. When the order report omits tax, DataDoe uses the matching Amazon Finances amount only when the order item, currency, quantity, and item total reconcile. 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. When the order report omits tax, DataDoe uses the matching Amazon Finances amount only when the order item, currency, quantity, and shipping total reconcile. May be null for orders placed in the last 4h."},{"name":"promotion_ids","type":"TEXT","nullable":true,"description":"Promotion identifiers or labels from Amazon's order report, preserved as raw text and potentially containing multiple values. These are not a verified link to amazon_promotions.promotion_id or tracking_id. May be null for orders placed in the last 4h."},{"name":"item_promotion_discount_value","type":"NUMBER","nullable":true,"description":"Item promotion discount on this order line in item_price_currency, separate from the shipping promotion discount. 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. To list SKUs sold in the last 30 days without COGS, use GET /api/v1/cogs/missing or the MCP tool cogs_missing_list."},{"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":"Order line items from Amazon order reports and recent ORDER_CHANGE updates, one row per order line. Marketplace orders belong to their marketplace connection. Off-Amazon Multi-Channel Fulfillment (MCF) lines belong to the seller account and appear once per account, with regional attribution and null marketplace columns. Exports include them for any selected marketplace of that account; combining separate marketplace exports can count them more than once. sales_channel preserves Amazon's value, such as Non-Amazon. A generic value does not identify an external store, and a missing value does not identify MCF. Off-Amazon item_price_value is a fulfillment or declared amount, not verified external sales revenue. COGS uses the kept connection's uploaded costs. Profit tables and marketplace-filtered app reports omit off-Amazon lines. Initial reports cover 105 weeks of last-update time. Recurring reports re-read 8 days daily and 1 day intraday.","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_SHIPPING_ADDITIONAL_INPUTS","relation":"live"},{"type":"AMAZON_ORDERS_GET_SHIPMENT_DOCS","relation":"live"},{"type":"AMAZON_ORDERS_FIND","relation":"live"},{"type":"AMAZON_ORDERS_GET_METRICS","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":"title_differentiation","type":"TEXT","nullable":true,"description":"Item highlight shown in search results, extracted from the listing title_differentiation attribute."},{"name":"item_name","type":"TEXT","nullable":true,"description":"Listing title. Uses the listing item_name attribute, then the listing summary title, then the catalog product name."},{"name":"product_description","type":"TEXT","nullable":true,"description":"Listing description. Uses the listing product_description attribute, then the merchant listings report description when that report is joined, then the catalog product description. A+ content is not included."},{"name":"generic_keyword","type":"TEXT","nullable":true,"description":"Backend search terms from the listing generic_keyword attribute. The product catalog does not include this field. Null when Amazon omits it from the listing."},{"name":"bullet_point_1","type":"TEXT","nullable":true,"description":"First listing bullet. Uses the listing bullet_point attribute, then the catalog bullet. Only the first five bullets are stored."},{"name":"bullet_point_2","type":"TEXT","nullable":true,"description":"Second listing bullet. Uses the same sources as bullet_point_1."},{"name":"bullet_point_3","type":"TEXT","nullable":true,"description":"Third listing bullet. Uses the same sources as bullet_point_1."},{"name":"bullet_point_4","type":"TEXT","nullable":true,"description":"Fourth listing bullet. Uses the same sources as bullet_point_1."},{"name":"bullet_point_5","type":"TEXT","nullable":true,"description":"Fifth listing bullet. Uses the same sources as bullet_point_1."},{"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":"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. item_name, product_description, and bullet points use the listing when Amazon returns them, then the catalog.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_LISTINGS_CREATE","relation":"writes"},{"type":"AMAZON_LISTINGS_DELETE","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_CREATE_VERIFY","relation":"live"},{"type":"AMAZON_LISTINGS_UPDATE_VERIFY","relation":"live"},{"type":"AMAZON_LISTINGS_PRICING_UPDATE_VERIFY","relation":"live"},{"type":"AMAZON_LISTINGS_DETAILS_UPDATE_VERIFY","relation":"live"},{"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":"2dd9e60fba83da8ce54079c7df35d8d4da1aa50bea79e4cdc6274b3e149e379e","name":"Listing prices by audience","tableName":"amazon_listings_audience_pricing","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":"child_asin","type":"TEXT","nullable":true,"description":null},{"name":"audience","type":"TEXT","nullable":false,"description":"Buyer audience. ALL is every buyer. B2B is Amazon Business. Other values, such as B2B_EDUCATION, are industry audiences."},{"name":"audience_display_name","type":"TEXT","nullable":true,"description":"Audience name returned on the offers summary, when Amazon sends one."},{"name":"currency","type":"TEXT","nullable":true,"description":"Currency code for unit_price."},{"name":"unit_price","type":"NUMBER","nullable":true,"description":"Single-unit price for this audience. Taken from listing attributes when present, otherwise from the offers summary."},{"name":"quantity_discount_tiers","type":"JSON","nullable":true,"description":"Quantity discount tiers for this audience. Each item has discount_type, lower_bound, and value. Null when the listing attributes do not include a quantity discount plan. When discount_type is percent, value is the percentage points off the single-unit price. When discount_type is fixed, value is the unit price for that tier in the marketplace currency."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"One row per connection, marketplace, SKU, and price audience. Audiences include ALL for every buyer, B2B for Amazon Business, and industry audiences such as B2B_EDUCATION when the seller is enrolled. unit_price is the single-unit price. quantity_discount_tiers lists quantity discounts from the listing attributes. Prices come from listing attributes when Amazon sends them, and from the offers summary when the attribute price is missing. This view does not change prices.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_LISTINGS_PRICING_UPDATE","relation":"writes"},{"type":"AMAZON_LISTINGS_PRICING_UPDATE_VERIFY","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_listings_items"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["b2b price","audience price","quantity discount","ivp"]},{"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":"item_name","type":"TEXT","nullable":true,"description":"Listing title. Uses the listing item_name attribute, then the listing summary title, then the catalog product name."},{"name":"product_description","type":"TEXT","nullable":true,"description":"Listing description. Uses the listing product_description attribute, then the merchant listings report description when that report is joined, then the catalog product description. A+ content is not included."},{"name":"generic_keyword","type":"TEXT","nullable":true,"description":"Backend search terms from the listing generic_keyword attribute. The product catalog does not include this field. Null when Amazon omits it from the listing."},{"name":"bullet_point_1","type":"TEXT","nullable":true,"description":"First listing bullet. Uses the listing bullet_point attribute, then the catalog bullet. Only the first five bullets are stored."},{"name":"bullet_point_2","type":"TEXT","nullable":true,"description":"Second listing bullet. Uses the same sources as bullet_point_1."},{"name":"bullet_point_3","type":"TEXT","nullable":true,"description":"Third listing bullet. Uses the same sources as bullet_point_1."},{"name":"bullet_point_4","type":"TEXT","nullable":true,"description":"Fourth listing bullet. Uses the same sources as bullet_point_1."},{"name":"bullet_point_5","type":"TEXT","nullable":true,"description":"Fifth listing bullet. Uses the same sources as bullet_point_1."},{"name":"listing_condition","type":"TEXT","nullable":false,"description":"Condition enum values."},{"name":"listing_name","type":"TEXT","nullable":false,"description":"Item name from the merchant listings report."},{"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. To list SKUs sold in the last 30 days without COGS, use GET /api/v1/cogs/missing or the MCP tool cogs_missing_list."},{"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. item_name, product_description, and bullet points use the listing when Amazon returns them, then the catalog.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_LISTINGS_CREATE","relation":"writes"},{"type":"AMAZON_LISTINGS_DELETE","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_CREATE_VERIFY","relation":"live"},{"type":"AMAZON_LISTINGS_UPDATE_VERIFY","relation":"live"},{"type":"AMAZON_LISTINGS_PRICING_UPDATE_VERIFY","relation":"live"},{"type":"AMAZON_LISTINGS_DETAILS_UPDATE_VERIFY","relation":"live"},{"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","refined_products_by_child_asin","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":"b7d2aaa9206c5d5dd880f8102264da9cef72f6cdab4d3a7cdc7030d94e8e4e71","name":"Competitive Summaries","tableName":"amazon_competitive_summaries","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":"featured_buying_options","type":"JSON","nullable":true,"description":"Amazon featuredBuyingOptions array from the latest successful competitive summary, including nested promotions."},{"name":"lowest_priced_offers","type":"JSON","nullable":true,"description":"Amazon lowestPricedOffers array from the latest successful competitive summary, including nested promotions."},{"name":"reference_prices","type":"JSON","nullable":true,"description":"Amazon referencePrices array from the latest successful competitive summary."},{"name":"similar_items","type":"JSON","nullable":true,"description":"Amazon similarItems array from the latest successful competitive summary."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"Time of the latest successful fetch. This is the observation time. It is not a promotion start time or end time."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Current competitive summary snapshot for each Seller Central ASIN. last_seen_at is the time of the latest successful fetch. It is the observation time. It is not a promotion start time or end time.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_LISTINGS_COMPETITIVE_SUMMARY_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_competitive_summaries"],"containsPii":false,"initialLoadProgress":null},{"id":"3cdbda5b23cf8918cc55466c30e3ff14c677c9a4a8d7cd8f971d01440fbb27c3","name":"Competitive Offer Promotions","tableName":"amazon_competitive_offer_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":"asin","type":"TEXT","nullable":false,"description":null},{"name":"offer_source","type":"TEXT","nullable":false,"description":"featuredBuyingOptions or lowestPricedOffers."},{"name":"offer_group_index","type":"NUMBER","nullable":false,"description":"Zero-based position of the buying option or lowest-priced group."},{"name":"offer_index","type":"NUMBER","nullable":false,"description":"Zero-based position of the offer in that group."},{"name":"promotion_index","type":"NUMBER","nullable":false,"description":"Zero-based position of the promotion in that offer."},{"name":"buying_option_type","type":"TEXT","nullable":true,"description":"Featured group buyingOptionType. Empty for lowest-priced offers."},{"name":"item_condition","type":"TEXT","nullable":true,"description":"Offer condition. For a lowest-priced offer with no condition, this is lowestPricedOffersInput.itemCondition."},{"name":"offer_type","type":"TEXT","nullable":true,"description":"lowestPricedOffersInput.offerType. Empty for featured offers."},{"name":"offer_seller_id","type":"TEXT","nullable":true,"description":null},{"name":"fulfillment_type","type":"TEXT","nullable":true,"description":null},{"name":"featured_offer_segments","type":"JSON","nullable":true,"description":"Featured offer segments. Empty for lowest-priced offers."},{"name":"promotion_type","type":"TEXT","nullable":false,"description":"Amazon promotionType. Known values include COUPON, DEAL, and BASKET_BUILDING. Other values are kept."},{"name":"discount_type","type":"TEXT","nullable":true,"description":null},{"name":"discount_amount","type":"NUMBER","nullable":true,"description":null},{"name":"discount_currency_code","type":"TEXT","nullable":true,"description":null},{"name":"discount_percentage","type":"NUMBER","nullable":true,"description":"Amazon percentOff on a 0 to 100 scale. 10 means 10%."},{"name":"discounted_price","type":"NUMBER","nullable":true,"description":null},{"name":"discounted_price_currency_code","type":"TEXT","nullable":true,"description":null},{"name":"purchase_requirement_type","type":"TEXT","nullable":true,"description":"Purchase requirement type. When Amazon sends both a quantity threshold and a spend threshold, this is the quantity threshold type."},{"name":"minimum_quantity","type":"NUMBER","nullable":true,"description":null},{"name":"minimum_spend_amount","type":"NUMBER","nullable":true,"description":null},{"name":"minimum_spend_currency_code","type":"TEXT","nullable":true,"description":null},{"name":"promotion_payload","type":"JSON","nullable":false,"description":"Complete original promotion object returned by Amazon."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"Time of the successful competitive summary fetch that contained this promotion. This is the observation time. It is not a promotion start time or end time."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"One row for each promotion Amazon returned on a featured or lowest-priced offer in the current competitive summary snapshot. The same offer can appear in both sections, so rows are not unique promotion IDs. An empty result does not show that the ASIN has no promotions. last_seen_at is the observation time of the parent snapshot.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_LISTINGS_COMPETITIVE_SUMMARY_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_competitive_summaries"],"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":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"name":"inbound_plan_id","type":"TEXT","nullable":true,"description":"Modern inbound plan id. Empty when the row comes only from a legacy shipment read."},{"name":"fba_inbound_shipment_id","type":"TEXT","nullable":true,"description":"Modern inbound shipment id. Empty when the row comes only from a legacy shipment read. The FBA shipment id is shipment_confirmation_id."},{"name":"seller_sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":true,"description":null},{"name":"child_asin","type":"TEXT","nullable":true,"description":null},{"name":"quantity","type":"NUMBER","nullable":true,"description":"Planned units for this shipment and seller SKU. This is not the number of units Amazon has received. Empty on a legacy-only row."},{"name":"quantity_shipped","type":"NUMBER","nullable":true,"description":"Units Amazon reports shipped for this shipment and seller SKU. Empty until Amazon supplies the field. Distinct from planned quantity."},{"name":"quantity_received","type":"NUMBER","nullable":true,"description":"Cumulative units Amazon reports as received for this shipment and seller SKU. This can be higher than quantity. Zero means Amazon reported zero. Empty means Amazon did not send the field."},{"name":"quantity_in_case","type":"NUMBER","nullable":true,"description":"Units in each case. This is not the number of cases or the shipment total. Zero means Amazon reported zero. Empty means Amazon did not send the field."},{"name":"release_date","type":"DATE","nullable":true,"description":"Date a preorder item becomes available for sale. This is not the shipment, receipt, delivery, or expiration date. Empty means Amazon did not send the field."},{"name":"expiration","type":"DATE","nullable":true,"description":null},{"name":"label_owner","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_lot_code","type":"TEXT","nullable":true,"description":null},{"name":"prep_instructions","type":"JSON","nullable":true,"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":"carrier_name","type":"TEXT","nullable":true,"description":"Name of the selected transportation carrier. Amazon may return Other when the seller uses their own carrier."},{"name":"shipping_mode","type":"TEXT","nullable":true,"description":"Selected transportation mode, such as GROUND_SMALL_PARCEL, FREIGHT_LTL, or FREIGHT_FTL_PALLET."},{"name":"spd_tracking_items","type":"JSON","nullable":true,"description":"Small-parcel boxes. Each item has box_id, tracking_id, and tracking_number_validation_status (VALIDATED, NOT_VALIDATED, or NOT_SUPPORTED). Repeated on every product row for the shipment."},{"name":"bill_of_lading_number","type":"TEXT","nullable":true,"description":"Less-than-truckload bill of lading number, when Amazon provides one."},{"name":"freight_bill_numbers","type":"JSON","nullable":true,"description":"Less-than-truckload freight bill (PRO) numbers. A JSON array of strings, repeated on every product row for the shipment."},{"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":"legacy_prep_details","type":"JSON","nullable":true,"description":"Prep instruction and prep owner pairs from the legacy shipment item. Empty when Amazon omits the list. An empty array means Amazon sent an empty list."},{"name":"label_prep_type","type":"TEXT","nullable":true,"description":"Legacy label preparation type, such as NO_LABEL, SELLER_LABEL, or AMAZON_LABEL. This is not label_owner."},{"name":"are_cases_required","type":"LOGIC","nullable":true,"description":"Whether the legacy shipment requires cases. False means Amazon reported false. Empty means Amazon omitted the field."},{"name":"confirmed_need_by_date","type":"DATE","nullable":true,"description":null},{"name":"box_contents_source","type":"TEXT","nullable":true,"description":null},{"name":"estimated_box_contents_fee_total_units","type":"NUMBER","nullable":true,"description":"Shipment-level estimated box contents fee unit count. Repeated on every SKU row. This is not a sum across SKUs and not a posted freight charge."},{"name":"estimated_box_contents_fee_per_unit","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_box_contents_fee_per_unit_currency","type":"TEXT","nullable":true,"description":null},{"name":"estimated_box_contents_fee_total","type":"NUMBER","nullable":true,"description":"Shipment-level estimated box contents fee. Repeated on every SKU row. This is not a posted freight charge."},{"name":"estimated_box_contents_fee_total_currency","type":"TEXT","nullable":true,"description":null},{"name":"source_api_versions","type":"JSON","nullable":false,"description":"Amazon APIs that supplied this row. Values are fulfillmentInbound:v0 and fulfillmentInbound:2024-03-20."},{"name":"legacy_last_seen_at","type":"DATE","nullable":true,"description":"Time of the last complete legacy item read. A failed or partial read does not move this time."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"FBA inbound shipment items from modern inbound plans and legacy shipment reads, with planned, shipped and received quantities, shipment status, addresses, and available carrier, tracking and plan details. quantity is the planned unit count and is empty on a legacy-only row. quantity_shipped, quantity_received, and quantity_in_case keep a reported zero and stay empty when Amazon omits them. inbound_plan_id and fba_inbound_shipment_id are empty when the row comes only from a legacy shipment read. shipment_confirmation_id then holds the FBA shipment id. Estimated box contents fees repeat on every SKU row and are not a posted freight charge. source_api_versions lists the Amazon APIs that supplied the row. Historical rows are limited to shipments Amazon still returns. There is no AGL classification flag.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_FBA_INBOUND_PLANS_FIND","relation":"live"},{"type":"AMAZON_FBA_INBOUND_PLANS_GET","relation":"live"},{"type":"AMAZON_FBA_INBOUND_SHIPMENTS_GET","relation":"live"},{"type":"AMAZON_FBA_INBOUND_LEGACY_SHIPMENT_ITEMS_GET","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_fba_inbound_shipments"],"containsPii":false,"initialLoadProgress":null},{"id":"04df29e50c6c19254d042f5a2cf35568b5f9ccdd11695b597b9781a8fd29f874","name":"FBA Inbound Shipment Boxes","tableName":"amazon_fba_inbound_shipment_boxes","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"name":"inbound_plan_id","type":"TEXT","nullable":false,"description":null},{"name":"fba_inbound_shipment_id","type":"TEXT","nullable":false,"description":null},{"name":"package_id","type":"TEXT","nullable":false,"description":null},{"name":"box_id","type":"TEXT","nullable":true,"description":null},{"name":"box_quantity","type":"NUMBER","nullable":true,"description":"Number of identical boxes this row stands for. Amazon groups boxes that share the same size, weight, and contents."},{"name":"template_name","type":"TEXT","nullable":true,"description":"Name of the Send to Amazon box template, when Amazon provides one."},{"name":"content_information_source","type":"TEXT","nullable":true,"description":"How Amazon received the box contents: BOX_CONTENT_PROVIDED, MANUAL_PROCESS, or BARCODE_2D."},{"name":"length","type":"NUMBER","nullable":true,"description":"Box length."},{"name":"width","type":"NUMBER","nullable":true,"description":"Box width."},{"name":"height","type":"NUMBER","nullable":true,"description":"Box height."},{"name":"dimension_unit","type":"TEXT","nullable":true,"description":"Unit for length, width, and height: IN or CM."},{"name":"weight","type":"NUMBER","nullable":true,"description":"Weight of one box."},{"name":"weight_unit","type":"TEXT","nullable":true,"description":"Unit for weight: LB or KG."},{"name":"seller_sku","type":"TEXT","nullable":false,"description":null},{"name":"fnsku","type":"TEXT","nullable":true,"description":null},{"name":"child_asin","type":"TEXT","nullable":true,"description":null},{"name":"quantity","type":"NUMBER","nullable":true,"description":"Units of this SKU in one box."},{"name":"items_in_box","type":"NUMBER","nullable":false,"description":"Number of SKUs in the box."},{"name":"is_single_sku_box","type":"LOGIC","nullable":false,"description":"True when the box contains one SKU."},{"name":"expiration","type":"DATE","nullable":true,"description":null},{"name":"label_owner","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_lot_code","type":"TEXT","nullable":true,"description":null},{"name":"prep_instructions","type":"JSON","nullable":false,"description":null},{"name":"last_seen_at","type":"DATE","nullable":false,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Boxes in FBA inbound shipments. Each row is one SKU in one box, with the box size, weight, units in that box, and the Send to Amazon template name when Amazon provides one.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_fba_inbound_shipment_boxes"],"containsPii":false,"initialLoadProgress":null},{"id":"705516b99d12eae4bbe684c371f9408595f6325b5e52ef3ae9c4d293d0da7dad","name":"FBA Shipments","tableName":"amazon_fba_shipments","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"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. Personal fields, including buyer email, street addresses, postal codes, and tracking numbers, become NULL after 30 days from the shipment date, or the reporting date when the shipment date is unavailable. Historical rows, item and financial details, and city, state, and country remain available.","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":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"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":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"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":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"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":"1d28c4f8606f6babd56ec9b1db2f2de874cfde04f54424cdae912e347ea98671","name":"Remote Fulfillment Eligibility","tableName":"amazon_remote_fulfillment_eligibility","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 in the source marketplace time zone, from the time Amazon created the report."},{"name":"snapshot_time","type":"DATE","nullable":false,"description":"Time Amazon created the report. This is when DataDoe observed the file, not when eligibility changed."},{"name":"report_id","type":"TEXT","nullable":false,"description":null},{"name":"source_format","type":"TEXT","nullable":false,"description":"XLSX for the Seller Central workbook, or TSV for the flat file."},{"name":"source_sheet","type":"TEXT","nullable":true,"description":"Workbook sheet name. Empty for a flat file."},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":true,"description":null},{"name":"destination_country_label","type":"TEXT","nullable":true,"description":"Destination label printed in the workbook. Empty when the report names no destination."},{"name":"destination_marketplace_id","type":"TEXT","nullable":true,"description":"Amazon marketplace ID for a destination named in the workbook. Empty when the report names no destination."},{"name":"destination_country_code","type":"TEXT","nullable":true,"description":"Country code for the destination marketplace. Empty when the report names no destination."},{"name":"destination_country_name","type":"TEXT","nullable":true,"description":"Country name for the destination marketplace. Empty when the report names no destination."},{"name":"offer_status","type":"TEXT","nullable":true,"description":"Amazon offer status for this destination. Known values include Enabled, Not eligible, Action required, Undetermined, and Not applicable. Other values are kept as reported."},{"name":"more_details","type":"TEXT","nullable":true,"description":"Amazon reason text for the offer status, including line breaks. A blank cell is empty."},{"name":"inclusion_request","type":"TEXT","nullable":true,"description":"Text from the Enable/disable cell. A blank cell is empty. DataDoe does not treat it as enrolment and does not send it to Amazon."},{"name":"is_enabled","type":"LOGIC","nullable":true,"description":"True only when offer status is Enabled. False only when offer status is Disabled. Every other status is empty. Use offer status for the reported eligibility."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Remote Fulfillment eligibility for each product and destination country. Offer status and more details are the reported eligibility. A blank inclusion request is an empty seller input, not proof the product is unenrolled. The current state is the latest complete report for the source marketplace.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"DataDoe requests one report a day at 2am in the source marketplace time zone. Amazon can take up to 24 hours to generate it. Rows appear after Amazon generates the file and after DataDoe imports and exports it. This is not a same-day feed.","refreshAt":"2am"},"sources":["connections","raw_sp_api_report_remote_fulfillment_eligibility"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["remote fulfillment","remote fulfilment","eligibility","offer status"]},{"id":"9dd006c33e3d3a33dacb1e6e34fb8cf555dadb5b6c28f8a0c7043f528dd3a055","name":"Pan-European FBA eligibility","tableName":"amazon_pan_eu_fba_eligibility","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":"snapshot_date","type":"DATE","nullable":false,"description":"Snapshot date in the source marketplace time zone, from the time Amazon created the report."},{"name":"checked_at","type":"DATE","nullable":false,"description":"Time Amazon created the report. When Amazon omits that time, this is the time DataDoe requested it."},{"name":"imported_at","type":"DATE","nullable":false,"description":"Time DataDoe stored this report."},{"name":"report_id","type":"TEXT","nullable":false,"description":null},{"name":"report_type","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"title","type":"TEXT","nullable":true,"description":null},{"name":"pan_eu_status","type":"TEXT","nullable":true,"description":"Pan-EU status as Amazon reported it. Unknown values stay as reported."},{"name":"product_comments","type":"TEXT","nullable":true,"description":null},{"name":"enrol","type":"TEXT","nullable":true,"description":"Amazon Enrol cell. A blank cell is empty. DataDoe stores the text and does not send an enrolment change."},{"name":"fnsku","type":"TEXT","nullable":true,"description":null},{"name":"enrollment_date","type":"DATE","nullable":true,"description":null},{"name":"last_active_on","type":"DATE","nullable":true,"description":null},{"name":"pan_eu_expires_on","type":"DATE","nullable":true,"description":null},{"name":"present_country_codes","type":"TEXT","nullable":false,"description":"Destination country groups present in the file. A blank group is present. A missing header is absent."},{"name":"uk_offer_status","type":"TEXT","nullable":true,"description":"UK offer status as Amazon reported it. A blank cell is empty."},{"name":"uk_paneu_benefits","type":"TEXT","nullable":true,"description":"UK Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"uk_snl_status","type":"TEXT","nullable":true,"description":"UK SnL status as Amazon reported it. A blank cell is empty."},{"name":"de_offer_status","type":"TEXT","nullable":true,"description":"DE offer status as Amazon reported it. A blank cell is empty."},{"name":"de_paneu_benefits","type":"TEXT","nullable":true,"description":"DE Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"de_snl_status","type":"TEXT","nullable":true,"description":"DE SnL status as Amazon reported it. A blank cell is empty."},{"name":"fr_offer_status","type":"TEXT","nullable":true,"description":"FR offer status as Amazon reported it. A blank cell is empty."},{"name":"fr_paneu_benefits","type":"TEXT","nullable":true,"description":"FR Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"fr_snl_status","type":"TEXT","nullable":true,"description":"FR SnL status as Amazon reported it. A blank cell is empty."},{"name":"it_offer_status","type":"TEXT","nullable":true,"description":"IT offer status as Amazon reported it. A blank cell is empty."},{"name":"it_paneu_benefits","type":"TEXT","nullable":true,"description":"IT Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"it_snl_status","type":"TEXT","nullable":true,"description":"IT SnL status as Amazon reported it. A blank cell is empty."},{"name":"es_offer_status","type":"TEXT","nullable":true,"description":"ES offer status as Amazon reported it. A blank cell is empty."},{"name":"es_paneu_benefits","type":"TEXT","nullable":true,"description":"ES Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"es_snl_status","type":"TEXT","nullable":true,"description":"ES SnL status as Amazon reported it. A blank cell is empty."},{"name":"nl_offer_status","type":"TEXT","nullable":true,"description":"NL offer status as Amazon reported it. A blank cell is empty."},{"name":"nl_paneu_benefits","type":"TEXT","nullable":true,"description":"NL Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"se_offer_status","type":"TEXT","nullable":true,"description":"SE offer status as Amazon reported it. A blank cell is empty."},{"name":"se_paneu_benefits","type":"TEXT","nullable":true,"description":"SE Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"pl_offer_status","type":"TEXT","nullable":true,"description":"PL offer status as Amazon reported it. A blank cell is empty."},{"name":"pl_paneu_benefits","type":"TEXT","nullable":true,"description":"PL Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"be_offer_status","type":"TEXT","nullable":true,"description":"BE offer status as Amazon reported it. A blank cell is empty."},{"name":"be_paneu_benefits","type":"TEXT","nullable":true,"description":"BE Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"ie_offer_status","type":"TEXT","nullable":true,"description":"IE offer status as Amazon reported it. A blank cell is empty."},{"name":"ie_paneu_benefits","type":"TEXT","nullable":true,"description":"IE Pan-EU benefits as Amazon reported them. A blank cell is empty."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Pan-European programme offer status for one source marketplace. This is not FBA inbound eligibility, a listing restriction, or brand approval. Compare a product with Listings or FBA stranded inventory using the connection, SKU, and ASIN together. Every completed report is kept. A missing day stays empty.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"DataDoe requests one report a day at 2am in the source marketplace time zone. A request after 2am still covers that local day, and later days return to 2am. Amazon can take up to 24 hours to generate the file. Rows appear after Amazon generates the file and after DataDoe imports and exports it. History starts with the first collected report. A day with no report stays empty.","refreshAt":"2am"},"sources":["connections","raw_sp_api_report_pan_eu_offer_status"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["pan-eu","pan european fba","enrolment","fnsku"]},{"id":"22477322eee4fa3c404c9fe42432b21e5f78a36fd980fb43f77b8e6dc22998f1","name":"Pan-European MFN eligibility","tableName":"amazon_pan_eu_mfn_eligibility","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":"snapshot_date","type":"DATE","nullable":false,"description":"Snapshot date in the source marketplace time zone, from the time Amazon created the report."},{"name":"checked_at","type":"DATE","nullable":false,"description":"Time Amazon created the report. When Amazon omits that time, this is the time DataDoe requested it."},{"name":"imported_at","type":"DATE","nullable":false,"description":"Time DataDoe stored this report."},{"name":"report_id","type":"TEXT","nullable":false,"description":null},{"name":"report_type","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"title","type":"TEXT","nullable":true,"description":null},{"name":"pan_eu_status","type":"TEXT","nullable":true,"description":"Pan-EU status as Amazon reported it. Unknown values stay as reported."},{"name":"product_comments","type":"TEXT","nullable":true,"description":null},{"name":"present_country_codes","type":"TEXT","nullable":false,"description":"Destination country groups present in the file. A blank group is present. A missing header is absent."},{"name":"uk_offer_status","type":"TEXT","nullable":true,"description":"UK offer status as Amazon reported it. A blank cell is empty."},{"name":"de_offer_status","type":"TEXT","nullable":true,"description":"DE offer status as Amazon reported it. A blank cell is empty."},{"name":"fr_offer_status","type":"TEXT","nullable":true,"description":"FR offer status as Amazon reported it. A blank cell is empty."},{"name":"it_offer_status","type":"TEXT","nullable":true,"description":"IT offer status as Amazon reported it. A blank cell is empty."},{"name":"es_offer_status","type":"TEXT","nullable":true,"description":"ES offer status as Amazon reported it. A blank cell is empty."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Pan-European programme offer status for one source marketplace. This is not FBA inbound eligibility, a listing restriction, or brand approval. Compare a product with Listings or FBA stranded inventory using the connection, SKU, and ASIN together. Every completed report is kept. A missing day stays empty.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"DataDoe requests one report a day at 2am in the source marketplace time zone. A request after 2am still covers that local day, and later days return to 2am. Amazon can take up to 24 hours to generate the file. Rows appear after Amazon generates the file and after DataDoe imports and exports it. History starts with the first collected report. A day with no report stays empty.","refreshAt":"2am"},"sources":["connections","raw_sp_api_report_mfn_paneu_offer_status"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["pan-eu","pan european mfn","merchant fulfilled"]},{"id":"ef3baa616807e7bb7d1f40df4757804baa9d48fb46a10096037b672794f05523","name":"Pan-European FBA eligibility by country","tableName":"amazon_pan_eu_fba_eligibility_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":"snapshot_date","type":"DATE","nullable":false,"description":"Snapshot date in the source marketplace time zone, from the time Amazon created the report."},{"name":"checked_at","type":"DATE","nullable":false,"description":"Time Amazon created the report. When Amazon omits that time, this is the time DataDoe requested it."},{"name":"imported_at","type":"DATE","nullable":false,"description":"Time DataDoe stored this report."},{"name":"report_id","type":"TEXT","nullable":false,"description":null},{"name":"report_type","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"title","type":"TEXT","nullable":true,"description":null},{"name":"pan_eu_status","type":"TEXT","nullable":true,"description":"Pan-EU status as Amazon reported it. Unknown values stay as reported."},{"name":"product_comments","type":"TEXT","nullable":true,"description":null},{"name":"present_country_codes","type":"TEXT","nullable":false,"description":"Destination country groups present in the file. A blank group is present. A missing header is absent."},{"name":"destination_country_code","type":"TEXT","nullable":false,"description":null},{"name":"destination_marketplace_id","type":"TEXT","nullable":true,"description":null},{"name":"offer_status","type":"TEXT","nullable":true,"description":null},{"name":"paneu_benefits","type":"TEXT","nullable":true,"description":null},{"name":"snl_status","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"One row for each destination country group present in a Pan-European report. The source marketplace stays on marketplace_id. A present blank group is a row. A header that is absent from the file is not a row.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"DataDoe requests one report a day at 2am in the source marketplace time zone. A request after 2am still covers that local day, and later days return to 2am. Amazon can take up to 24 hours to generate the file. Rows appear after Amazon generates the file and after DataDoe imports and exports it. History starts with the first collected report. A day with no report stays empty.","refreshAt":"2am"},"sources":["connections","raw_sp_api_report_pan_eu_offer_status"],"containsPii":false,"initialLoadProgress":null},{"id":"093c33707fa0854aa13cbf3fde8f9560329b1f6aa9baf9d15b26090a4c47cda4","name":"Pan-European MFN eligibility by country","tableName":"amazon_pan_eu_mfn_eligibility_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":"snapshot_date","type":"DATE","nullable":false,"description":"Snapshot date in the source marketplace time zone, from the time Amazon created the report."},{"name":"checked_at","type":"DATE","nullable":false,"description":"Time Amazon created the report. When Amazon omits that time, this is the time DataDoe requested it."},{"name":"imported_at","type":"DATE","nullable":false,"description":"Time DataDoe stored this report."},{"name":"report_id","type":"TEXT","nullable":false,"description":null},{"name":"report_type","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"title","type":"TEXT","nullable":true,"description":null},{"name":"pan_eu_status","type":"TEXT","nullable":true,"description":"Pan-EU status as Amazon reported it. Unknown values stay as reported."},{"name":"product_comments","type":"TEXT","nullable":true,"description":null},{"name":"present_country_codes","type":"TEXT","nullable":false,"description":"Destination country groups present in the file. A blank group is present. A missing header is absent."},{"name":"destination_country_code","type":"TEXT","nullable":false,"description":null},{"name":"destination_marketplace_id","type":"TEXT","nullable":true,"description":null},{"name":"offer_status","type":"TEXT","nullable":true,"description":null},{"name":"paneu_benefits","type":"TEXT","nullable":true,"description":null},{"name":"snl_status","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"One row for each destination country group present in a Pan-European report. The source marketplace stays on marketplace_id. A present blank group is a row. A header that is absent from the file is not a row.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"DataDoe requests one report a day at 2am in the source marketplace time zone. A request after 2am still covers that local day, and later days return to 2am. Amazon can take up to 24 hours to generate the file. Rows appear after Amazon generates the file and after DataDoe imports and exports it. History starts with the first collected report. A day with no report stays empty.","refreshAt":"2am"},"sources":["connections","raw_sp_api_report_mfn_paneu_offer_status"],"containsPii":false,"initialLoadProgress":null},{"id":"ab2fda00c7e681429fdece6530e3e1a1dff79d0f680739a918585f3eef789b65","name":"Pan-European FBA eligibility latest","tableName":"amazon_pan_eu_fba_eligibility_latest","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":"snapshot_date","type":"DATE","nullable":false,"description":"Snapshot date in the source marketplace time zone, from the time Amazon created the report."},{"name":"checked_at","type":"DATE","nullable":false,"description":"Time Amazon created the report. When Amazon omits that time, this is the time DataDoe requested it."},{"name":"imported_at","type":"DATE","nullable":false,"description":"Time DataDoe stored this report."},{"name":"report_id","type":"TEXT","nullable":false,"description":null},{"name":"report_type","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"title","type":"TEXT","nullable":true,"description":null},{"name":"pan_eu_status","type":"TEXT","nullable":true,"description":"Pan-EU status as Amazon reported it. Unknown values stay as reported."},{"name":"product_comments","type":"TEXT","nullable":true,"description":null},{"name":"enrol","type":"TEXT","nullable":true,"description":"Amazon Enrol cell. A blank cell is empty. DataDoe stores the text and does not send an enrolment change."},{"name":"fnsku","type":"TEXT","nullable":true,"description":null},{"name":"enrollment_date","type":"DATE","nullable":true,"description":null},{"name":"last_active_on","type":"DATE","nullable":true,"description":null},{"name":"pan_eu_expires_on","type":"DATE","nullable":true,"description":null},{"name":"present_country_codes","type":"TEXT","nullable":false,"description":"Destination country groups present in the file. A blank group is present. A missing header is absent."},{"name":"uk_offer_status","type":"TEXT","nullable":true,"description":"UK offer status as Amazon reported it. A blank cell is empty."},{"name":"uk_paneu_benefits","type":"TEXT","nullable":true,"description":"UK Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"uk_snl_status","type":"TEXT","nullable":true,"description":"UK SnL status as Amazon reported it. A blank cell is empty."},{"name":"de_offer_status","type":"TEXT","nullable":true,"description":"DE offer status as Amazon reported it. A blank cell is empty."},{"name":"de_paneu_benefits","type":"TEXT","nullable":true,"description":"DE Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"de_snl_status","type":"TEXT","nullable":true,"description":"DE SnL status as Amazon reported it. A blank cell is empty."},{"name":"fr_offer_status","type":"TEXT","nullable":true,"description":"FR offer status as Amazon reported it. A blank cell is empty."},{"name":"fr_paneu_benefits","type":"TEXT","nullable":true,"description":"FR Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"fr_snl_status","type":"TEXT","nullable":true,"description":"FR SnL status as Amazon reported it. A blank cell is empty."},{"name":"it_offer_status","type":"TEXT","nullable":true,"description":"IT offer status as Amazon reported it. A blank cell is empty."},{"name":"it_paneu_benefits","type":"TEXT","nullable":true,"description":"IT Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"it_snl_status","type":"TEXT","nullable":true,"description":"IT SnL status as Amazon reported it. A blank cell is empty."},{"name":"es_offer_status","type":"TEXT","nullable":true,"description":"ES offer status as Amazon reported it. A blank cell is empty."},{"name":"es_paneu_benefits","type":"TEXT","nullable":true,"description":"ES Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"es_snl_status","type":"TEXT","nullable":true,"description":"ES SnL status as Amazon reported it. A blank cell is empty."},{"name":"nl_offer_status","type":"TEXT","nullable":true,"description":"NL offer status as Amazon reported it. A blank cell is empty."},{"name":"nl_paneu_benefits","type":"TEXT","nullable":true,"description":"NL Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"se_offer_status","type":"TEXT","nullable":true,"description":"SE offer status as Amazon reported it. A blank cell is empty."},{"name":"se_paneu_benefits","type":"TEXT","nullable":true,"description":"SE Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"pl_offer_status","type":"TEXT","nullable":true,"description":"PL offer status as Amazon reported it. A blank cell is empty."},{"name":"pl_paneu_benefits","type":"TEXT","nullable":true,"description":"PL Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"be_offer_status","type":"TEXT","nullable":true,"description":"BE offer status as Amazon reported it. A blank cell is empty."},{"name":"be_paneu_benefits","type":"TEXT","nullable":true,"description":"BE Pan-EU benefits as Amazon reported them. A blank cell is empty."},{"name":"ie_offer_status","type":"TEXT","nullable":true,"description":"IE offer status as Amazon reported it. A blank cell is empty."},{"name":"ie_paneu_benefits","type":"TEXT","nullable":true,"description":"IE Pan-EU benefits as Amazon reported them. A blank cell is empty."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Every product row from the newest complete Pan-European report whose rows have already been exported for the source marketplace. A product absent from that report is absent here. Older reports remain in the history table.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"DataDoe requests one report a day at 2am in the source marketplace time zone. A request after 2am still covers that local day, and later days return to 2am. Amazon can take up to 24 hours to generate the file. Rows appear after Amazon generates the file and after DataDoe imports and exports it. History starts with the first collected report. A day with no report stays empty.","refreshAt":"2am"},"sources":["connections","raw_sp_api_report_pan_eu_offer_status","raw_sp_api_pan_eu_eligibility_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["pan-eu current","latest fba eligibility"]},{"id":"0d7af9798419bc74d7a84f6ba29d3a5e7d5b88ff434228db127eead2fdb0482f","name":"Pan-European MFN eligibility latest","tableName":"amazon_pan_eu_mfn_eligibility_latest","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":"snapshot_date","type":"DATE","nullable":false,"description":"Snapshot date in the source marketplace time zone, from the time Amazon created the report."},{"name":"checked_at","type":"DATE","nullable":false,"description":"Time Amazon created the report. When Amazon omits that time, this is the time DataDoe requested it."},{"name":"imported_at","type":"DATE","nullable":false,"description":"Time DataDoe stored this report."},{"name":"report_id","type":"TEXT","nullable":false,"description":null},{"name":"report_type","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":false,"description":null},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"title","type":"TEXT","nullable":true,"description":null},{"name":"pan_eu_status","type":"TEXT","nullable":true,"description":"Pan-EU status as Amazon reported it. Unknown values stay as reported."},{"name":"product_comments","type":"TEXT","nullable":true,"description":null},{"name":"present_country_codes","type":"TEXT","nullable":false,"description":"Destination country groups present in the file. A blank group is present. A missing header is absent."},{"name":"uk_offer_status","type":"TEXT","nullable":true,"description":"UK offer status as Amazon reported it. A blank cell is empty."},{"name":"de_offer_status","type":"TEXT","nullable":true,"description":"DE offer status as Amazon reported it. A blank cell is empty."},{"name":"fr_offer_status","type":"TEXT","nullable":true,"description":"FR offer status as Amazon reported it. A blank cell is empty."},{"name":"it_offer_status","type":"TEXT","nullable":true,"description":"IT offer status as Amazon reported it. A blank cell is empty."},{"name":"es_offer_status","type":"TEXT","nullable":true,"description":"ES offer status as Amazon reported it. A blank cell is empty."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Every product row from the newest complete Pan-European report whose rows have already been exported for the source marketplace. A product absent from that report is absent here. Older reports remain in the history table.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"DataDoe requests one report a day at 2am in the source marketplace time zone. A request after 2am still covers that local day, and later days return to 2am. Amazon can take up to 24 hours to generate the file. Rows appear after Amazon generates the file and after DataDoe imports and exports it. History starts with the first collected report. A day with no report stays empty.","refreshAt":"2am"},"sources":["connections","raw_sp_api_report_mfn_paneu_offer_status","raw_sp_api_pan_eu_eligibility_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["pan-eu current","latest mfn eligibility"]},{"id":"4965ff92b8951d388c7d34436d53fe9376a6571da8d7b180c0cfe25b1e51d6ca","name":"Pan-European eligibility snapshots","tableName":"amazon_pan_eu_eligibility_snapshots","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":"report_type","type":"TEXT","nullable":false,"description":null},{"name":"report_id","type":"TEXT","nullable":false,"description":null},{"name":"snapshot_date","type":"DATE","nullable":false,"description":null},{"name":"checked_at","type":"DATE","nullable":false,"description":null},{"name":"imported_at","type":"DATE","nullable":false,"description":null},{"name":"row_count","type":"NUMBER","nullable":false,"description":null},{"name":"duplicate_line_count","type":"NUMBER","nullable":false,"description":"Product rows plus identical extra lines collapsed into those rows."},{"name":"validation_status","type":"TEXT","nullable":false,"description":null},{"name":"present_country_codes","type":"TEXT","nullable":false,"description":"Destination country groups present in the accepted file."},{"name":"unmapped_headers","type":"TEXT","nullable":false,"description":"Header names Amazon added that DataDoe has not mapped yet. The original cells stay on each product row."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"One row for each accepted Pan-European report. row_count is the number of product rows. An empty valid file has row_count 0. A failed or unreadable file does not remove an earlier row.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":1},{"type":"RECURRING_DAILY","numberOfDays":1}],"dataAvailability":{"type":"INTRADAY","description":"DataDoe requests one report a day at 2am in the source marketplace time zone. A request after 2am still covers that local day, and later days return to 2am. Amazon can take up to 24 hours to generate the file. Rows appear after Amazon generates the file and after DataDoe imports and exports it. History starts with the first collected report. A day with no report stays empty.","refreshAt":"2am"},"sources":["connections","raw_sp_api_pan_eu_eligibility_snapshots"],"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":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"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":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"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":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"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":"9fbbf3da8eb87e9fdb21f62124a48e1b7d8176733f2d3960984d3e6bce1114d7","name":"FBA Fee Preview","tableName":"amazon_fba_fee_preview","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":"snapshot_date","type":"DATE","nullable":false,"description":"UTC date Amazon finished the report. When a finish time is missing, this is the UTC date Amazon created the report."},{"name":"amazon_report_id","type":"TEXT","nullable":false,"description":null},{"name":"report_created_at","type":"DATE","nullable":true,"description":null},{"name":"processing_started_at","type":"DATE","nullable":true,"description":null},{"name":"processing_ended_at","type":"DATE","nullable":true,"description":null},{"name":"request_window_started_at","type":"DATE","nullable":true,"description":null},{"name":"request_window_ended_at","type":"DATE","nullable":true,"description":null},{"name":"source_row_number","type":"NUMBER","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":true,"description":null},{"name":"fnsku","type":"TEXT","nullable":true,"description":null},{"name":"child_asin","type":"TEXT","nullable":true,"description":null},{"name":"amazon_store","type":"TEXT","nullable":true,"description":null},{"name":"product_name","type":"TEXT","nullable":true,"description":null},{"name":"product_group","type":"TEXT","nullable":true,"description":null},{"name":"brand","type":"TEXT","nullable":true,"description":null},{"name":"fulfilled_by","type":"TEXT","nullable":true,"description":null},{"name":"your_price","type":"NUMBER","nullable":true,"description":null},{"name":"sales_price","type":"NUMBER","nullable":true,"description":null},{"name":"longest_side","type":"NUMBER","nullable":true,"description":null},{"name":"median_side","type":"NUMBER","nullable":true,"description":null},{"name":"shortest_side","type":"NUMBER","nullable":true,"description":null},{"name":"length_and_girth","type":"NUMBER","nullable":true,"description":null},{"name":"unit_of_dimension","type":"TEXT","nullable":true,"description":null},{"name":"item_package_weight","type":"NUMBER","nullable":true,"description":null},{"name":"unit_of_weight","type":"TEXT","nullable":true,"description":null},{"name":"currency","type":"TEXT","nullable":true,"description":null},{"name":"estimated_fee_total","type":"NUMBER","nullable":true,"description":"Estimated fee total in the row currency. A blank fee is unknown, not zero."},{"name":"estimated_referral_fee_per_unit","type":"NUMBER","nullable":true,"description":null},{"name":"product_size_tier","type":"TEXT","nullable":true,"description":null},{"name":"estimated_order_handling_fee_per_order","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_future_order_handling_fee_per_order","type":"NUMBER","nullable":true,"description":null},{"name":"expected_fulfillment_fee_per_unit","type":"NUMBER","nullable":true,"description":null},{"name":"expected_future_fulfillment_fee_per_unit","type":"NUMBER","nullable":true,"description":"Future fulfillment estimate supplied by Amazon. This is not a scheduled referral fee category or an effective date."},{"name":"estimated_variable_closing_fee","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_future_fee","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_pick_pack_fee_per_unit","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_future_pick_pack_fee_per_unit","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_weight_handling_fee_per_unit","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_future_weight_handling_fee_per_unit","type":"NUMBER","nullable":true,"description":null},{"name":"estimated_fixed_closing_fee","type":"NUMBER","nullable":true,"description":null},{"name":"has_local_inventory","type":"LOGIC","nullable":true,"description":null},{"name":"product_size_weight_band","type":"TEXT","nullable":true,"description":null},{"name":"expected_domestic_fulfilment_fee_per_unit","type":"NUMBER","nullable":true,"description":null},{"name":"expected_efn_fulfilment_fee_per_unit_uk","type":"NUMBER","nullable":true,"description":null},{"name":"expected_efn_fulfilment_fee_per_unit_de","type":"NUMBER","nullable":true,"description":null},{"name":"expected_efn_fulfilment_fee_per_unit_fr","type":"NUMBER","nullable":true,"description":null},{"name":"expected_efn_fulfilment_fee_per_unit_it","type":"NUMBER","nullable":true,"description":null},{"name":"expected_efn_fulfilment_fee_per_unit_es","type":"NUMBER","nullable":true,"description":null},{"name":"expected_efn_fulfilment_fee_per_unit_se","type":"NUMBER","nullable":true,"description":null},{"name":"extras","type":"JSON","nullable":true,"description":"Columns Amazon included that are outside the published fee preview catalog."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Estimated FBA fees for each active FBA offer, kept as a daily snapshot. snapshot_date is the UTC date Amazon finished the report. When a finish time is missing, it is the UTC date Amazon created the report. Amazon refreshes the estimates at least every 72 hours, so a later snapshot can repeat the same estimates. The report has no scheduled fee category and no effective date. A future fulfillment fee is a fulfillment estimate, not a scheduled referral fee category. Fees stay in the currency on the row. Dimensions and weight stay in the units on the row. A blank fee is unknown, not zero. A product missing from a snapshot had no active FBA offer in that snapshot. A snapshot for one marketplace is not copied to another marketplace. History starts when the first snapshot is collected.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":4},{"type":"RECURRING_DAILY","numberOfDays":4}],"sources":["connections","raw_sp_api_report_fba_estimated_fba_fees"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["fba fees","fee preview","estimated fees","size tier"]},{"id":"316ea56bca9b5c665b2aa835c861b634d7cada971aa3814abf8f872b7e3f469e","name":"FBA Storage Fee Charges","tableName":"amazon_fba_storage_fees","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"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":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"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":"Long-term FBA storage fee charges for the previous 13 completed calendar months. The previous month is refreshed daily.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":390},{"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":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"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":true,"description":"Amazon provided ID that represents a specific country where the Seller or Vendor operates. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code for the Amazon marketplace. Null on regional rows (attribution_method = regional)."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Human-readable country name for the marketplace (derived from marketplace_id). Null on regional rows (attribution_method = regional)."},{"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":"regional_account_id","type":"TEXT","nullable":true,"description":"Amazon seller account of the row: <organization_id>:<seller_id>:<region> (NA, EU or FE). One seller account serves all its marketplaces in an SP-API region. Null when the connection has no seller ID."},{"name":"attribution_method","type":"TEXT","nullable":false,"description":"How the row was tied to a marketplace. connection: the row belongs to its marketplace connection. order / sales_channel: tied to the marketplace from the order or sales channel. regional: the row belongs to the whole seller account (regional_account_id), not to one marketplace; it appears once per account in exports for any selected marketplace of that account, and marketplace columns are null. Summing separate per-marketplace exports counts regional rows once per export."},{"name":"warehouse_country","type":"TEXT","nullable":true,"description":"Warehouse or fulfillment center country (ISO code, GB for the United Kingdom) when the report has one. It is not the sales marketplace."},{"name":"source_connection_id","type":"TEXT","nullable":false,"description":"Connection whose report copy holds the row. A regional report is the same for every marketplace of a seller account and one copy is shown per account, so this can be another marketplace connection of the account, including a deleted one while the account still has a connected marketplace.","bigQueryOnly":true},{"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_delivery_date","type":"DATE","nullable":true,"description":"Available only for FBM returns. The date Amazon recorded that the return package was delivered, from Return delivery date on the FBM returns report. Null for FBA returns and when Amazon has not provided a date. This is a calendar date, not a time of day and not a carrier tracking status. The returns report refreshes daily."},{"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. To list SKUs sold in the last 30 days without COGS, use GET /api/v1/cogs/missing or the MCP tool cogs_missing_list."},{"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":"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":"0c9717978ab8160fe4662b723014a01d8d5449ee8d6fba4aea829898adde64fa","name":"MCF Fulfillment Order Status Notifications","tableName":"amazon_notifications_fulfillment_order_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: FULFILLMENT_ORDER_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 FULFILLMENT_ORDER_STATUS notifications (payload version 2026-07-04) for Multi-Channel Fulfillment order, shipment, and package status changes. eventType is ORDER_STATUS_CHANGED, SHIPMENT_STATUS_CHANGED, or SHIPMENT_PACKAGE_STATUS_CHANGED. Tracking numbers and estimated delivery times are present only when Amazon sends them. Returns are not included. Seller Central only, for Amazon MCF marketplaces in North America, Europe, and the Far East. This is not the Brazil FBA Onsite notification and not the US-only Tracking API.","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_fulfillment_order_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":"aec3d5976911a7a80110c08801a741e4f0a25dd997d639f5d918284d905a4758","name":"Branded Listing Content Changes","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."},{"name":"asin","type":"TEXT","nullable":true,"description":"ASIN from the notification payload."},{"name":"brand_name","type":"TEXT","nullable":true,"description":"Brand name from the notification payload."},{"name":"attributes_changed","type":"TEXT","nullable":false,"description":"Changed listing attribute names. Empty when Amazon omits AttributesChanged. Known names are item_name, bullet_point, product_description, main_product_image_locator, other_product_image_locator_*, and swatch_product_image_locator. Each value is the name of a changed attribute, not the previous or new listing content. Elements are strings."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Near real-time changes to title, bullet points, description or images for ASINs with an Amazon Brand Registry relationship.","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":"be0983f979d7657c00f5b0b9d8db6c152625cb89eeba95578ad2b11edcead596","name":"MCF Fulfillment Coverage","tableName":"amazon_mcf_fulfillment_coverage","type":"SELLER_CENTRAL","columns":[{"name":"marketplace_id","type":"TEXT","nullable":true,"description":"Always empty. The notification belongs to the seller account. It does not name an Amazon marketplace or the external store."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"Always empty. See marketplace_id."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Always empty. See marketplace_id."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"DataDoe seller context that received the notification."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"Display name of the seller context. Group by seller_or_vendor_id."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon seller id from the connection that stored the notification."},{"name":"date","type":"DATE","nullable":false,"description":"Coordinated Universal Time (UTC) calendar day of event_time. Use it for from and to filters. It is not the purchase date and not a confirmed carrier ship date."},{"name":"fulfillment_order_id","type":"TEXT","nullable":false,"description":"Seller fulfillment order id from the notification. The seller assigned this id. It is not an Amazon marketplace order id and it is not verified store revenue."},{"name":"amazon_shipment_id","type":"TEXT","nullable":false,"description":"Amazon shipment id on the kept snapshot."},{"name":"shipment_item_id","type":"TEXT","nullable":false,"description":"Amazon shipment item id. The same line can ship in more than one shipment item. Items without this id are omitted."},{"name":"line_item_id","type":"TEXT","nullable":true,"description":"Seller line id when Amazon sends it."},{"name":"package_id","type":"TEXT","nullable":true,"description":"Package id Amazon attached to the shipment item, when present."},{"name":"sku","type":"TEXT","nullable":true,"description":"Amazon SKU on the shipment item, when Amazon sends it."},{"name":"facility_id","type":"TEXT","nullable":true,"description":"Amazon facility id on the shipment, when Amazon sends it."},{"name":"shipped_quantity","type":"NUMBER","nullable":false,"description":"Units on this shipment item in the latest shipped snapshot, in EACHES. Repeated notifications are not added. A later snapshot replaces the quantity."},{"name":"event_time","type":"DATE","nullable":false,"description":"Amazon event time of the shipment-status notification kept for this shipment. This is not the purchase date and not a confirmed carrier ship date."},{"name":"coverage_started_at","type":"DATE","nullable":false,"description":"Earliest FULFILLMENT_ORDER_STATUS notification stored for this seller. Shipments before this time are absent."},{"name":"sp_api_notification_id","type":"TEXT","nullable":false,"description":"Amazon notification id of the snapshot kept for this shipment."},{"name":"source_event_type","type":"TEXT","nullable":false,"description":"Always SHIPMENT_STATUS_CHANGED. Package status events are not counted as additional shipments."},{"name":"shipment_status","type":"TEXT","nullable":false,"description":"Always SHIPPED. A later snapshot that is not shipped removes the shipment from this table."},{"name":"product_cost_value","type":"NUMBER","nullable":true,"description":"Always empty. Uploaded product cost is not applied, because this order is not linked to a purchase date. Empty is not a zero cost."},{"name":"product_cost_currency","type":"TEXT","nullable":true,"description":"Always empty. Currencies are not converted, and no cost amount is published."},{"name":"external_revenue_status","type":"TEXT","nullable":false,"description":"Always unavailable. External store sales, shipping income, discounts, tax, and refunds are not imported. Unavailable is not zero."},{"name":"product_cost_status","type":"TEXT","nullable":false,"description":"Always unavailable. See product_cost_value."},{"name":"amazon_fee_status","type":"TEXT","nullable":false,"description":"Always omitted. Amazon fee debits and credits are not matched to this row. Omitted is not zero. Fees that already sit in account profit are not repeated here."},{"name":"uploaded_shipping_cost_status","type":"TEXT","nullable":false,"description":"Always omitted. Uploaded shipping cost is not included. It is separate from Amazon outbound delivery fees."},{"name":"shared_storage_and_inbound_status","type":"TEXT","nullable":false,"description":"Always excluded. Shared Fulfillment by Amazon (FBA) storage and inbound costs stay in account profit and are not allocated to these units."},{"name":"returns_and_refunds_status","type":"TEXT","nullable":false,"description":"Always deferred. A physical return or an Amazon fee credit does not change shipped units or create a refund amount."},{"name":"profit_status","type":"TEXT","nullable":false,"description":"Always unavailable. Profit, margin, and ROI are not calculated."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Confirmed Multi-Channel Fulfillment (MCF) units Amazon reported as shipped. One row is one shipment item on the latest SHIPMENT_STATUS_CHANGED notification whose shipment status is SHIPPED. Rows appear only after this table, or MCF Fulfillment Order Status Notifications, is enabled. Shipments reported before the first stored notification are absent. A row does not show the full life of an order that started earlier. This is not profit, margin, or return on investment (ROI). External store sales, shipping income, discounts, tax, and refunds are unavailable, not zero. Uploaded product cost is unavailable because the seller fulfillment order id is not linked to a purchase date. Amazon fees are omitted and may already be inside Profit by Date and Profit by SKU and Date, so do not add those tables to this one. An omitted cost is not zero. Uploaded shipping cost, shared Fulfillment by Amazon (FBA) storage, and inbound costs are excluded. A physical return does not change these units. A repeated notification does not add the same shipment item. A later notification replaces the earlier one. Package delivery events are not extra shipments. Declared order amounts are not sales.","requiresDatePeriod":true,"issues":[],"prerequisites":"Seller Central only, for Amazon Multi-Channel Fulfillment in North America, Europe, and the Far East. Enable this table to collect FULFILLMENT_ORDER_STATUS notifications from that point forward. A seller without the Amazon Fulfillment role cannot subscribe. There is no historical backfill.","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_fulfillment_order_status"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["mcf","multi-channel fulfillment","fulfillment coverage","shipped units"]},{"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. Values: UpComing, Pending, Unshipped, PartiallyShipped, Shipped, Canceled, Unfulfillable, InvoiceUnconfirmed, PendingAvailability. This is not the UK Amazon Autos reservation status."},{"name":"pre_fulfillment_status","type":"TEXT","nullable":true,"description":"UK Amazon Autos reservation status. Separate from order status and fulfillment status. AWAITING_SELLER_ACTION means the reservation is waiting for the seller. ACKNOWLEDGED means the seller accepted it. REJECTED means the seller rejected it. Empty for other order changes. Use order_change_time_utc to keep the latest status for an order."},{"name":"order_change_type","type":"TEXT","nullable":true,"description":"Why Amazon sent this order change notification. BuyerRequestedChange means the buyer asked for a change. OrderStatusChange means the order status changed. PreFulfillmentStatusChange means the UK Amazon Autos reservation status changed."},{"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 order change notifications. Includes order status changes, buyer-requested changes, and UK Amazon Autos reservation status.","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 feedback, with one to three stars, left for the seller by buyers. Buyer email, buyer comments, and seller responses become NULL after 30 days from the feedback date. Historical rows, order identifiers, dates, and ratings remain available.","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":"cf005ac3eda90ca81af3080d6768a304e700badd171dda35c38a059a90b75bae","name":"Seller Product Ratings and Reviews","tableName":"amazon_seller_review_metrics","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":"Child ASIN from Seller Analytics. Rows are not grouped by parent ASIN, SKU, brand, or fulfillment channel."},{"name":"date","type":"DATE","nullable":false,"description":"Start of the period Amazon returned. For a week or month, this is the period start, not one day inside that period."},{"name":"period_start_date","type":"DATE","nullable":false,"description":"Start of the period Amazon returned. Same value as date."},{"name":"period_end_date","type":"DATE","nullable":false,"description":"End of the period Amazon returned."},{"name":"aggregation","type":"TEXT","nullable":false,"description":"DAY, WEEK, or MONTH. Do not mix aggregations when you add review counts."},{"name":"display_rating","type":"NUMBER","nullable":true,"description":"Rounded product-page star rating, from 1 to 5. This is a snapshot, not reviews received in the period. Do not sum across periods."},{"name":"raw_rating","type":"NUMBER","nullable":true,"description":"Unrounded product star rating, from 1 to 5. This is a snapshot, not reviews received in the period. Do not sum across periods."},{"name":"total_rating_count","type":"NUMBER","nullable":true,"description":"Number of ratings included in the rating snapshot. Not the number of new reviews in the period. Do not sum across periods. Empty when Amazon returned no rating snapshot; Amazon sends a count of 0 without a star rating in that case, which is not a real zero."},{"name":"total_review_count","type":"NUMBER","nullable":true,"description":"Reviews received in the returned period. Add counts only for non-overlapping periods with the same aggregation."},{"name":"low_rating_review_count","type":"NUMBER","nullable":true,"description":"Critical reviews received in the returned period. This is a count, not the text of those reviews. Add counts only for non-overlapping periods with the same aggregation."},{"name":"critical_review_rate","type":"NUMBER","nullable":true,"description":"Fraction from 0 to 1 of period reviews that are critical. Do not average this rate across rows. For compatible periods, divide the summed low-rating review count by the summed review count."},{"name":"activity_last_seen_at","type":"DATE","nullable":true,"description":"Latest successful import of the review-count values for this row."},{"name":"rating_last_seen_at","type":"DATE","nullable":true,"description":"Latest successful import of the rating snapshot for this row. Set even when Amazon returned no rating, so it does not mean a rating is present."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Product star ratings and review counts by child ASIN, marketplace, and period for a Seller Central account. This is not buyer feedback left for the seller, and it does not include review text. Review counts cover the returned period. Ratings are the product rating at the snapshot, not new reviews in that period. date is the start of the period Amazon returned. A week or month stays one row. An empty metric means Amazon did not return a value. It is not a confirmed zero. A stored review count of zero is a real zero. An empty total_rating_count with empty ratings means Amazon returned no rating snapshot for that ASIN and period, not that the product has no ratings. Initial collection covers 365 days of activity and 12 completed calendar months of rating snapshots. Activity refreshes cover seven days daily and 31 days every 30 days in batches of at most seven days with DAY output. Amazon returns the star rating for a completed calendar month. A single day does not include the star rating. Amazon returns rating snapshots for only some ASINs, and for some accounts a completed month has no products. Such a month adds no MONTH row. The latest completed month refreshes every day. Two completed months refresh every 30 days. Amazon does not return the calendar month that is still in progress.","requiresDatePeriod":true,"issues":[],"prerequisites":"Requires a Seller Central connection. Vendor Central does not provide these product ratings and review counts.","fetchPeriods":[{"type":"INITIAL","numberOfDays":365,"shiftDays":2},{"type":"RECURRING_DAILY","numberOfDays":7,"shiftDays":2},{"type":"RECURRING_MONTHLY","numberOfDays":31,"shiftDays":2}],"dataAvailability":{"type":"INTRADAY","description":"Review counts and rating snapshots are generally ready at 10am in the marketplace time zone, two days after the period. A later refresh can restate recent days.","refreshAt":"10am"},"sources":["connections","raw_sp_api_dk_seller_review_metrics"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["product rating","star rating","review count","critical reviews"]},{"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. Weekly grain is amazon_child_product_search_performance_per_week.","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":"02d9e9ab902f03151952fa2fcbb00b4afda58d5c8ff372fb7e6b30513650c2a3","name":"Search Engagement by ASIN (Weekly)","tableName":"amazon_child_product_search_performance_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":"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":"Sunday that starts the Sunday–Saturday week the data refers to. Represents an aggregated weekly snapshot. Data availability can lag, so use MAX(date) for the most recent published week."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Weekly Search Catalog Performance per child ASIN (GET_BRAND_ANALYTICS_SEARCH_CATALOG_PERFORMANCE_REPORT, reportPeriod WEEK). Each row is one Sunday–Saturday week. 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. Monthly grain is amazon_child_product_search_performance_per_month.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":91},{"type":"RECURRING_WEEKLY","numberOfDays":21}],"sources":["connections","raw_sp_api_report_brand_analytics_search_catalog_performance_weekly"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["search catalog","search engagement","weekly"]},{"id":"3f67a61127b23010777ff4b6656c02b498fe168fca652c6aa736540b269aa70e","name":"Amazon Financial Transactions","tableName":"amazon_financial_transactions","type":"SELLER_CENTRAL","columns":[{"name":"seller_or_vendor_id","type":"TEXT","nullable":true,"description":"Public DataDoe account id for MCP, API, and Export account selection. Empty when the connection context cannot be resolved."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"Display name of the DataDoe account. Empty when the context cannot be resolved."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon seller id from the connection. This is not the public DataDoe account id."},{"name":"marketplace_id","type":"TEXT","nullable":true,"description":"Amazon marketplace id stored for this transaction. The view does not change the collector attribution."},{"name":"marketplace_country_code","type":"TEXT","nullable":true,"description":"ISO country code from marketplace_id."},{"name":"marketplace_country_name","type":"TEXT","nullable":true,"description":"Country name from marketplace_id."},{"name":"transaction_id","type":"TEXT","nullable":false,"description":"Amazon transaction id. One row is the latest stored copy of this id on the connection."},{"name":"transaction_type","type":"TEXT","nullable":true,"description":"Amazon transaction type, including Transfer and types Amazon adds later. Blank becomes empty."},{"name":"transaction_status","type":"TEXT","nullable":true,"description":"Amazon status, including DEFERRED, RELEASED, DEFERRED_RELEASED, and later values. Blank stays empty. A missing status is not treated as RELEASED."},{"name":"posted_at","type":"DATE","nullable":true,"description":"UTC time Amazon posted this transaction id. This is not the order date, the expected release time, or the bank deposit time."},{"name":"date","type":"DATE","nullable":true,"description":"Marketplace-local calendar date of posted_at. US and Canada use America/Los_Angeles. Export from and to filters use this column. Empty when posted_at is missing."},{"name":"total_amount","type":"NUMBER","nullable":true,"description":"Signed transaction total from Amazon, once for the transaction. Zero stays zero. Empty when Amazon omits the amount. This is not a sum of nested breakdowns and it is not converted to another currency."},{"name":"currency","type":"TEXT","nullable":true,"description":"Currency Amazon reported on the transaction total. Empty when Amazon omits it."},{"name":"business_store_name","type":"TEXT","nullable":true,"description":"BusinessContext storeName, preserved verbatim. Known values include AMAZON_HAUL and AMAZON_FBA_FROM_ORIGIN. Later values are allowed. NULL when no nonempty string is present or distinct names conflict. Identical names count once. Empty or missing context does not establish a program. AmazonPayContext is excluded."},{"name":"business_contexts","type":"JSON","nullable":false,"description":"Full transaction BusinessContext entries in source order, including duplicates and unfamiliar fields or values. An empty JSON array when none were sent. Use this evidence when business_store_name is NULL or ambiguous. Other context types are excluded."},{"name":"deferral_reason","type":"TEXT","nullable":true,"description":"deferralReason from the only DeferredContext. Empty when there is not exactly one distinct DeferredContext, or when that context has no reason. Codes such as DD7 stay as Amazon sent them."},{"name":"expected_release_at","type":"DATE","nullable":true,"description":"maturityDate from the only DeferredContext, as a UTC instant. Empty when there is not exactly one context, or when the timestamp cannot be parsed. Amazon can change this time. It is not confirmation that the money was released or deposited."},{"name":"deferred_contexts","type":"JSON","nullable":false,"description":"DeferredContext entries from the transaction, with contextType, deferralReason, and maturityDate only. Duplicate entries are removed. An invalid maturityDate string is kept here. The array is empty when there is no DeferredContext."},{"name":"deferred_context_count","type":"NUMBER","nullable":false,"description":"Number of distinct DeferredContext entries. Zero when there are none. Use this to see when deferral_reason and expected_release_at were left empty because the contexts disagree."},{"name":"related_identifiers","type":"JSON","nullable":false,"description":"Related financial identifiers limited to the documented names and their values. The array is empty when there are none."},{"name":"amazon_order_id","type":"TEXT","nullable":true,"description":"ORDER_ID. Empty when the value is missing or more than one distinct value is stored."},{"name":"shipment_id","type":"TEXT","nullable":true,"description":"SHIPMENT_ID. Empty when the value is missing or more than one distinct value is stored."},{"name":"financial_event_group_id","type":"TEXT","nullable":true,"description":"FINANCIAL_EVENT_GROUP_ID. Empty when the value is missing or more than one distinct value is stored."},{"name":"settlement_id","type":"TEXT","nullable":true,"description":"SETTLEMENT_ID. Empty when the value is missing or more than one distinct value is stored."},{"name":"refund_id","type":"TEXT","nullable":true,"description":"REFUND_ID. Empty when the value is missing or more than one distinct value is stored."},{"name":"invoice_id","type":"TEXT","nullable":true,"description":"INVOICE_ID. Empty when the value is missing or more than one distinct value is stored."},{"name":"disbursement_id","type":"TEXT","nullable":true,"description":"DISBURSEMENT_ID. Empty when the value is missing or more than one distinct value is stored."},{"name":"transfer_id","type":"TEXT","nullable":true,"description":"TRANSFER_ID. Empty when the value is missing or more than one distinct value is stored."},{"name":"deferred_transaction_id","type":"TEXT","nullable":true,"description":"DEFERRED_TRANSACTION_ID of the linked hold. Empty when the value is missing or more than one distinct value is stored."},{"name":"release_transaction_id","type":"TEXT","nullable":true,"description":"RELEASE_TRANSACTION_ID of the linked release. Empty when the value is missing or more than one distinct value is stored."},{"name":"transaction_chain_id","type":"TEXT","nullable":true,"description":"Shared id for an unambiguous hold and release in this Organization, Store, and connection. Empty when the links conflict, cycle, or attach more than one hold or release. A link to the same transaction id is ignored."},{"name":"is_outstanding_deferred","type":"LOGIC","nullable":false,"description":"True only when the stored status is DEFERRED and the stored rows show no release. This is the latest stored observation, not a live Amazon balance. A release outside an Export date range still clears the hold."},{"name":"dt_created","type":"DATE","nullable":true,"description":"UTC time DataDoe first stored this row. This is not the Amazon posting time."},{"name":"dt_updated","type":"DATE","nullable":true,"description":"UTC time DataDoe last updated this stored row. A later import can move it. This is not proof of the last Amazon poll."}],"userManaged":false,"isPremium":false,"defaultDataset":true,"enabled":true,"rowCountBilling":true,"description":"Seller Central finances transactions, one latest stored row per transaction id on a DataDoe connection. A hold and its release stay as separate rows when Amazon gives them separate ids. total_amount is the signed total Amazon sent, once per row, in the reported currency. Summing every row counts a hold and its release twice and mixes Transfers with sales. For a deferred forecast, use is_outstanding_deferred = TRUE, group by currency, and keep rows with an empty expected_release_at or total_amount. posted_at is the UTC posting time of this transaction id. date is that instant as a marketplace-local calendar date, with America/Los_Angeles for the US and Canada, and Export from and to filters use date. expected_release_at is the maturity time Amazon reported while the transaction is deferred. It can change and is not a bank deposit time. is_outstanding_deferred is true only for a stored DEFERRED status with no stored release. The first finances load reads 370 one-day posted windows, the daily load reads 8 one-day windows, and the 10am and 4pm loads read 2 posted days in the marketplace time zone. Those are start times, not a promise of when the row appears. Deferred rows outside those windows can keep an old status, reason, or maturity time. A later release row can clear a known hold. This table does not list every current hold at Amazon. Sums skip empty amounts.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":370},{"type":"RECURRING_DAILY","numberOfDays":8}],"dataAvailability":{"type":"INTRADAY","description":"The daily fetch starts at 2am and rereads 8 days. Fetches also start at 10am and 4pm, including weekends, and reread 2 days, including the current day. US and Canada use Pacific time (America/Los_Angeles) for the 10am and 4pm fetches, including daylight saving. Other marketplaces use their local time zone. Amazon may leave out orders from the last 48 hours. These times are when the fetch starts. Rows appear after Amazon publishes them and after DataDoe finishes processing and export.","refreshAt":"2am, 10am, 4pm"},"sources":["connections","raw_sp_api_finances_transactions"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["deferred","cash flow","finances","transaction"]},{"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":"referral_fee_tax","type":"NUMBER","nullable":false,"description":"Tax reported by Amazon within referral_fee, including value added tax (VAT). Uses the settlement cash-flow sign. Zero means no tax amount was reported."},{"name":"referral_fee_net","type":"NUMBER","nullable":false,"description":"referral_fee minus referral_fee_tax, in the settlement cash-flow sign. Excludes only reported tax; no tax rate is assumed."},{"name":"fba_per_unit_fulfillment_fee_tax","type":"NUMBER","nullable":false,"description":"Tax reported by Amazon within the per-unit Fulfillment by Amazon fee. Uses the settlement cash-flow sign. Zero means no tax amount was reported."},{"name":"fba_per_unit_fulfillment_fee_net","type":"NUMBER","nullable":false,"description":"fba_per_unit_fulfillment_fee minus fba_per_unit_fulfillment_fee_tax, in the settlement cash-flow sign."},{"name":"total_selling_fees_tax","type":"NUMBER","nullable":false,"description":"Tax reported by Amazon within referral fees, refunded referral fees and refund commissions. Uses the settlement cash-flow sign."},{"name":"total_selling_fees_net","type":"NUMBER","nullable":false,"description":"total_selling_fees minus total_selling_fees_tax, in the settlement cash-flow sign. Includes fee reversals on REFUND rows."},{"name":"order_fees_tax","type":"NUMBER","nullable":false,"description":"Reported tax included in fees assigned to the order date by the profit tables. Uses the settlement cash-flow sign. Excludes sales tax and tax already excluded from the existing fee total."},{"name":"posted_fees_tax","type":"NUMBER","nullable":false,"description":"Reported tax included in fees assigned to the posting date by the profit tables. Uses the settlement cash-flow sign. Excludes tax already excluded from the existing fee total."},{"name":"order_fba_fees_tax","type":"NUMBER","nullable":false,"description":"Reported tax within order-tied Fulfillment by Amazon fees, in the settlement cash-flow sign."},{"name":"posted_fba_fees_tax","type":"NUMBER","nullable":false,"description":"Reported tax within posting-date Fulfillment by Amazon fees, in the settlement cash-flow sign. Excludes tax already excluded from the existing fee total."},{"name":"total_fees_tax","type":"NUMBER","nullable":false,"description":"order_fees_tax plus posted_fees_tax, in the settlement cash-flow sign. Includes only reported tax within the existing fee total."},{"name":"total_fees_net","type":"NUMBER","nullable":false,"description":"total_fees minus total_fees_tax, in the settlement cash-flow sign. Like total_fees, this also includes non-fee payments. No tax rate is assumed."},{"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 tax Amazon reports separately on inbound transportation fees. Settlement report tax on fee lines for inbound fees map here too."},{"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":"Settlement amount Amazon deducted for advertising (ServiceFee, Cost of Advertising). It is 0 when advertising is invoiced separately and not taken from the settlement. Profit uses ad_spend from ads reports, so 0 here is not missing advertising cost. Expenses are negative."},{"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, including postage surcharges and VAT on that purchase. From Finances Adjustment or ShippingService LabmanLabelPurchase 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 or ShippingService LabmanLabelReturn 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 fee, including an Amazon-partnered carrier shipment fee. This is the base amount from Amazon Finances, or the base fee from a settlement report. Tax that Amazon reports separately is in item_tax."},{"name":"fba_inbound_transportation_program_fee","type":"NUMBER","nullable":false,"description":"FBA inbound transportation program fee. This is the base amount from Amazon Finances. Tax that Amazon reports separately is in item_tax."},{"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. Excluded from profit total_fees because order shipping tax is already net of this amount."},{"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":"transparency_invoice_deduction","type":"NUMBER","nullable":false,"description":"Amazon Transparency invoice deduction, with the settlement transaction sign."},{"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 and other merchant-fulfilled postage charged by Amazon, including Finances ServiceFee MfnPostageFee base and tax, and settlement-report Amazon Easy Ship Charges. Expenses are negative."},{"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 from Finances Adjustment or ShippingService and VAT credited on that chargeback. 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. To list SKUs sold in the last 30 days without COGS, use GET /api/v1/cogs/missing or the MCP tool cogs_missing_list."},{"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 the base fee amounts from Amazon Finances. When Amazon reports tax on those fees separately, that tax is in item_tax. DataDoe does not estimate this tax by dividing the fee. Settlement report base fee amounts stay on the fee column, and settlement report tax on fee lines map to item_tax. 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 in the Amazon order report. Amazon settlement start, settlement end, and deposit timestamps are not columns on this table. They are on the raw finances transactions table when a settlement report header matches the settlement ID. The deposit timestamp is the time Amazon starts the funds transfer, not the time the money arrives at the bank.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":365},{"type":"RECURRING_DAILY","numberOfDays":8}],"dataAvailability":{"type":"INTRADAY","description":"The daily fetch starts at 2am and rereads 8 days. Fetches also start at 10am and 4pm, including weekends, and reread 2 days, including the current day. US and Canada use Pacific time (America/Los_Angeles) for the 10am and 4pm fetches, including daylight saving. Other marketplaces use their local time zone. Amazon may leave out orders from the last 48 hours. These times are when the fetch starts. Rows appear after Amazon publishes them and after DataDoe finishes processing and export.","refreshAt":"2am, 10am, 4pm"},"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":"search_query_total_median_click_price_value","type":"NUMBER","nullable":true,"description":null},{"name":"search_query_total_median_click_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"search_query_total_median_cart_add_price_value","type":"NUMBER","nullable":true,"description":null},{"name":"search_query_total_median_cart_add_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"search_query_total_median_purchase_price_value","type":"NUMBER","nullable":true,"description":null},{"name":"search_query_total_median_purchase_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"child_asin_median_cart_add_price_value","type":"NUMBER","nullable":true,"description":null},{"name":"child_asin_median_cart_add_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"child_asin_median_purchase_price_value","type":"NUMBER","nullable":true,"description":null},{"name":"child_asin_median_purchase_price_currency","type":"TEXT","nullable":true,"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 252 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 252 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":"search_query_total_median_click_price_value","type":"NUMBER","nullable":true,"description":null},{"name":"search_query_total_median_click_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"search_query_total_median_cart_add_price_value","type":"NUMBER","nullable":true,"description":null},{"name":"search_query_total_median_cart_add_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"search_query_total_median_purchase_price_value","type":"NUMBER","nullable":true,"description":null},{"name":"search_query_total_median_purchase_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"child_asin_median_cart_add_price_value","type":"NUMBER","nullable":true,"description":null},{"name":"child_asin_median_cart_add_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"child_asin_median_purchase_price_value","type":"NUMBER","nullable":true,"description":null},{"name":"child_asin_median_purchase_price_currency","type":"TEXT","nullable":true,"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 252 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 252 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":"869faf9a6763b60ab8edc88216bd6fbc2b1414b9eb15e7420ee1de869f1f972e","name":"Repeat Purchase Performance (Quarterly)","tableName":"amazon_repeat_purchase_report_quarterly","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 quarter. 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 quarter."},{"name":"repeat_customers_score_total","type":"NUMBER","nullable":false,"description":"Fraction of unique customers that are repeat customers in the quarter, 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 quarter. 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 quarter, between 0 and 1."},{"name":"date","type":"DATE","nullable":false,"description":"First day of the calendar quarter the data refers to: 1 January, 1 April, 1 July or 1 October. One row covers that full quarter. This table stores the QUARTER Brand Analytics period."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Quarterly Brand Analytics repeat purchase report per child ASIN for Brand Registry sellers and vendors. One row per child ASIN, connection, marketplace and calendar quarter. repeat_customers_score_total and repeat_purchase_revenue_score_total are 0-1 rates calculated inside the quarter, not the sum or average of monthly rates. Repeat revenue is ordered revenue and excludes returns. Initial collection requests the last 4 complete calendar quarters. Weekly refresh requests the last 2 complete calendar quarters. The quarter in progress is excluded.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":456},{"type":"RECURRING_WEEKLY","numberOfDays":276}],"sources":["connections","raw_sp_api_report_brand_analytics_repeat_purchase_quarterly"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["quarterly repeat purchase","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":"clicked_item_name","type":"TEXT","nullable":true,"description":"Product title for clicked_asin from Amazon’s Search Terms report. Includes products outside your catalog. Null when the report does not provide a title or the row has not been reprocessed."},{"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":"clicked_item_name","type":"TEXT","nullable":true,"description":"Product title for clicked_asin from Amazon’s Search Terms report. Includes products outside your catalog. Null when the report does not provide a title or the row has not been reprocessed."},{"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":"clicked_item_name","type":"TEXT","nullable":true,"description":"Product title for clicked_asin from Amazon’s Search Terms report. Includes products outside your catalog. Null when the report does not provide a title or the row has not been reprocessed."},{"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":"observation_id","type":"TEXT","nullable":true,"description":"Successful source observation identity. Null on legacy cache rows."},{"name":"checked_at","type":"DATE","nullable":true,"description":"Successful source-response observation time. Retry markers are not source checks."},{"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":"observation_id","type":"TEXT","nullable":true,"description":"Successful source observation identity. Null on legacy cache rows."},{"name":"checked_at","type":"DATE","nullable":true,"description":"Successful source-response observation time. Retry markers are not source checks."},{"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":"dcc0857a409fa1b40f544efca243912c6e5b8f64ac79addb8c9b2e9428a18289","name":"Product Catalog by ASIN History","tableName":"amazon_products_by_child_asin_history","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."},{"name":"date","type":"DATE","nullable":false,"description":"UTC date of the successful source observation. Same as snapshot_date."},{"name":"observation_id","type":"TEXT","nullable":false,"description":"Stable per-item observation identity. Replays retain this identity; unchanged later collections have a new identity."},{"name":"checked_at","type":"DATE","nullable":false,"description":"Successful source-response observation time, not the exact Amazon edit time."},{"name":"imported_at","type":"DATE","nullable":false,"description":"Time the observation entered durable Connector staging. Warehouse retries retain this value."},{"name":"snapshot_date","type":"DATE","nullable":false,"description":"UTC date of checked_at."},{"name":"snapshot_kind","type":"TEXT","nullable":false,"description":"OBSERVED. Legacy cache rows with unknown observation time are not copied into history."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Successful Amazon Catalog Items observations per child ASIN and marketplace for items the Organization tracks. A later successful response is retained even when unchanged; a retry keeps the original observation_id and checked_at without adding a duplicate. History starts after the Organization enables it and tracks the item. A newly associated item receives its next successful observation, without older shared-cache history. The source stays off until a staged Connector rollout enables it. History follows the existing catalog refresh. DataDoe can request an item again one day after its last cache update. The catalog worker runs every 15 minutes in each region and stops at its time limit, so a tracked item can go more than one day without a new observation. A history delivery backlog does not stop current catalog refreshes. Failed, throttled, empty and hard-failed attempts and items Amazon omits create no history observation. Missing days and source values remain unknown: a missing item or rank does not mean deletion or a zero rank. Observations are per item, not an atomic snapshot of the whole catalog. Changes occurred between observations; checked_at is not the exact time Amazon edited the item. Use amazon_products_by_child_asin and amazon_products_raw for current-state joins to sales, inventory and profit. They keep one latest row per ASIN and marketplace and provide the cached onboarding baseline. Legacy rows can have null checked_at and observation_id; overwritten payloads are not recovered or assigned invented times. When Amazon omits an item, its current row is created or cleared without a new checked_at and without a history observation. Filter history by child_asin, marketplace_id and a date range; date and snapshot_date are the UTC date of checked_at. For rank trends, order by checked_at and observation_id and compare category names and raw category identifiers, which can change. To compare observations, join on child_asin and marketplace_id and filter the two observation_id values; an absent observation produces no comparison. For the last observed state at a chosen time, filter checked_at <= the chosen timestamp, then use QUALIFY ROW_NUMBER() OVER (PARTITION BY child_asin, marketplace_id ORDER BY checked_at DESC, observation_id DESC) = 1. This returns only items observed by that time and does not fill gaps with current content.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["refined_products_by_child_asin_history"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["historical catalog observations","rank trends"]},{"id":"54089117e787319ccf91f286a0d42907e8fc727c63926d687cfd0798735c5ee3","name":"Product Catalog by ASIN History (Raw JSON)","tableName":"amazon_products_raw_history","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."},{"name":"date","type":"DATE","nullable":false,"description":"UTC date of the successful source observation. Same as snapshot_date."},{"name":"observation_id","type":"TEXT","nullable":false,"description":"Stable per-item observation identity. Replays retain this identity; unchanged later collections have a new identity."},{"name":"checked_at","type":"DATE","nullable":false,"description":"Successful source-response observation time, not the exact Amazon edit time."},{"name":"imported_at","type":"DATE","nullable":false,"description":"Time the observation entered durable Connector staging. Warehouse retries retain this value."},{"name":"snapshot_date","type":"DATE","nullable":false,"description":"UTC date of checked_at."},{"name":"snapshot_kind","type":"TEXT","nullable":false,"description":"OBSERVED. Legacy cache rows with unknown observation time are not copied into history."},{"name":"product_data","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Successful Amazon Catalog Items observations per child ASIN and marketplace for items the Organization tracks. A later successful response is retained even when unchanged; a retry keeps the original observation_id and checked_at without adding a duplicate. History starts after the Organization enables it and tracks the item. A newly associated item receives its next successful observation, without older shared-cache history. The source stays off until a staged Connector rollout enables it. History follows the existing catalog refresh. DataDoe can request an item again one day after its last cache update. The catalog worker runs every 15 minutes in each region and stops at its time limit, so a tracked item can go more than one day without a new observation. A history delivery backlog does not stop current catalog refreshes. Failed, throttled, empty and hard-failed attempts and items Amazon omits create no history observation. Missing days and source values remain unknown: a missing item or rank does not mean deletion or a zero rank. Observations are per item, not an atomic snapshot of the whole catalog. Changes occurred between observations; checked_at is not the exact time Amazon edited the item. Use amazon_products_by_child_asin and amazon_products_raw for current-state joins to sales, inventory and profit. They keep one latest row per ASIN and marketplace and provide the cached onboarding baseline. Legacy rows can have null checked_at and observation_id; overwritten payloads are not recovered or assigned invented times. When Amazon omits an item, its current row is created or cleared without a new checked_at and without a history observation. Filter history by child_asin, marketplace_id and a date range; date and snapshot_date are the UTC date of checked_at. For rank trends, order by checked_at and observation_id and compare category names and raw category identifiers, which can change. To compare observations, join on child_asin and marketplace_id and filter the two observation_id values; an absent observation produces no comparison. For the last observed state at a chosen time, filter checked_at <= the chosen timestamp, then use QUALIFY ROW_NUMBER() OVER (PARTITION BY child_asin, marketplace_id ORDER BY checked_at DESC, observation_id DESC) = 1. This returns only items observed by that time and does not fill gaps with current content. Listing-specific prices, inventory, the advertising product catalog, Search Catalog Performance and A+ content are separate data sources. Matches amazon_products_by_child_asin_history by child_asin, marketplace_id and observation_id. Full product_data preserves the complete source JSON, including sales-rank arrays and category identifiers; missing values remain null. Rows are large; download payloads to a file. For MCP raw-history exports, paginate with limit and skip: at most 100 rows in JSON or 250 rows in CSV. REST file generation and direct BigQuery queries use their own policies.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["refined_products_by_child_asin_history"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["historical catalog payloads","raw catalog observations"]},{"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":"d56182eea515323d6a59cd58f5bdfdf7e5707e15a49a915e73a78381ab2a07b4","name":"Customer Feedback ASIN Categories","tableName":"amazon_customer_feedback_item_browse_nodes","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"node_category_id","type":"TEXT","nullable":false,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"The browse node Amazon Customer Feedback associated with each child ASIN. One row is one associated node, not the full category path. DataDoe collects a new snapshot about every 30 days.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"224df5a43c4a64a064c285c29fc2f4932d3fdd38f55493ada7f60b992550458d","name":"Customer Feedback ASIN Review Topics","tableName":"amazon_customer_feedback_item_review_topics","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the date range Amazon returned with the response, in UTC."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the date range Amazon returned with the response, in UTC."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"node_category_id","type":"TEXT","nullable":true,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":true,"description":null},{"name":"sort_by","type":"TEXT","nullable":false,"description":"MENTIONS for this table."},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":"POSITIVE or NEGATIVE."},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":"1-based position in the Amazon list. A blank topic is skipped and does not renumber later topics."},{"name":"topic","type":"TEXT","nullable":false,"description":null},{"name":"topic_child_asin_number_of_mentions","type":"NUMBER","nullable":true,"description":null},{"name":"topic_child_asin_occurrence_percentage","type":"NUMBER","nullable":true,"description":null},{"name":"topic_child_asin_star_rating_impact","type":"NUMBER","nullable":true,"description":null},{"name":"topic_parent_asin_number_of_mentions","type":"NUMBER","nullable":true,"description":null},{"name":"topic_parent_asin_occurrence_percentage","type":"NUMBER","nullable":true,"description":null},{"name":"topic_parent_asin_star_rating_impact","type":"NUMBER","nullable":true,"description":null},{"name":"topic_review_snippet_1","type":"TEXT","nullable":true,"description":"First review excerpt Amazon returned for the topic. Not the full review. Amazon chooses the language."},{"name":"topic_review_snippet_2","type":"TEXT","nullable":true,"description":"Second review excerpt Amazon returned for the topic. Empty when Amazon returned fewer than 2."},{"name":"topic_review_snippet_3","type":"TEXT","nullable":true,"description":"Third review excerpt Amazon returned for the topic. Empty when Amazon returned fewer than 3."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback review topics for a child ASIN, sorted by mentions. DataDoe collects about every 30 days. Amazon may refresh the source weekly, so a row can be newer than the previous fetch. Topics are the ones Amazon returned, not a complete list. Snippets and topic names are the text Amazon returned, not full reviews. Amazon chooses the language. Sentiment is the positive or negative list, not a star rating. Percentages are the source values and are not additive. Category fields are empty when the ASIN has no category mapping.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["review topics","customer feedback","voice of the customer"]},{"id":"d3413c87b8b0b20213618c358f01c5ce3bc4fb8dae680bb7e04bbdf69986d819","name":"Customer Feedback ASIN Review Subtopics","tableName":"amazon_customer_feedback_item_review_subtopics","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the date range Amazon returned with the response, in UTC."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the date range Amazon returned with the response, in UTC."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"node_category_id","type":"TEXT","nullable":true,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":true,"description":null},{"name":"sort_by","type":"TEXT","nullable":false,"description":null},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":null},{"name":"topic","type":"TEXT","nullable":false,"description":null},{"name":"subtopic_rank","type":"NUMBER","nullable":false,"description":null},{"name":"subtopic","type":"TEXT","nullable":false,"description":null},{"name":"subtopic_number_of_mentions","type":"NUMBER","nullable":true,"description":null},{"name":"subtopic_occurrence_percentage","type":"NUMBER","nullable":true,"description":null},{"name":"subtopic_review_snippet_1","type":"TEXT","nullable":true,"description":null},{"name":"subtopic_review_snippet_2","type":"TEXT","nullable":true,"description":null},{"name":"subtopic_review_snippet_3","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback review subtopics for a child ASIN. Subtopics stay under the topic Amazon returned. There is no extra subtopic for reviews that do not match a returned subtopic. Percentages are the source values and are not additive.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"d3aea65db06b6e3e1f9e395cae749e63571e3f555b3e514d10b6a9a1daa3f2be","name":"Customer Feedback Category Review Topics","tableName":"amazon_customer_feedback_browse_node_review_topics","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the date range Amazon returned with the response, in UTC."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the date range Amazon returned with the response, in UTC."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"node_category_id","type":"TEXT","nullable":false,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"sort_by","type":"TEXT","nullable":false,"description":null},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":null},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":null},{"name":"topic","type":"TEXT","nullable":false,"description":null},{"name":"topic_node_category_star_rating_impact_all_products","type":"NUMBER","nullable":true,"description":null},{"name":"topic_node_category_star_rating_impact_top_25_percent_products","type":"NUMBER","nullable":true,"description":null},{"name":"topic_node_category_occurrence_percentage_all_products","type":"NUMBER","nullable":true,"description":null},{"name":"topic_node_category_occurrence_percentage_top_25_percent_products","type":"NUMBER","nullable":true,"description":null},{"name":"topic_review_snippet_1","type":"TEXT","nullable":true,"description":"First review excerpt Amazon returned for the topic. Not the full review. Amazon chooses the language."},{"name":"topic_review_snippet_2","type":"TEXT","nullable":true,"description":"Second review excerpt Amazon returned for the topic. Empty when Amazon returned fewer than 2."},{"name":"topic_review_snippet_3","type":"TEXT","nullable":true,"description":"Third review excerpt Amazon returned for the topic. Empty when Amazon returned fewer than 3."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback review topics for all products in a browse node. This is not an ASIN topic list. DataDoe collects about every 30 days. Topics are the ones Amazon returned, not a complete list. Percentages are the source values. Do not add them across products or connections.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"b553b2a9c27645655db27f1b80e6638ee9b1218085973a906fd4f7e8d839667c","name":"Customer Feedback Category Review Subtopics","tableName":"amazon_customer_feedback_browse_node_review_subtopics","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the date range Amazon returned with the response, in UTC."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the date range Amazon returned with the response, in UTC."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"node_category_id","type":"TEXT","nullable":false,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"sort_by","type":"TEXT","nullable":false,"description":null},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":null},{"name":"topic","type":"TEXT","nullable":false,"description":null},{"name":"subtopic_rank","type":"NUMBER","nullable":false,"description":null},{"name":"subtopic","type":"TEXT","nullable":false,"description":null},{"name":"subtopic_occurrence_percentage","type":"NUMBER","nullable":true,"description":null},{"name":"subtopic_review_snippet_1","type":"TEXT","nullable":true,"description":null},{"name":"subtopic_review_snippet_2","type":"TEXT","nullable":true,"description":null},{"name":"subtopic_review_snippet_3","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback review subtopics for all products in a browse node. A category subtopic has an occurrence percentage only. It has no mention count. There is no extra subtopic for reviews that do not match a returned subtopic.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"ae4696b6c71ccc9ba281a7e91c627d512a74c39853fe25c172c1d5d9b97be5c6","name":"Customer Feedback Category Return Topics","tableName":"amazon_customer_feedback_browse_node_return_topics","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the date range Amazon returned with the response, in UTC."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the date range Amazon returned with the response, in UTC."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"node_category_id","type":"TEXT","nullable":false,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":null},{"name":"topic","type":"TEXT","nullable":false,"description":null},{"name":"topic_node_category_occurrence_percentage_all_products","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback return topics for all products in a browse node. The occurrence percentage is not an ASIN return rate. The table has no sentiment, snippets, or mention counts.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["return topics","return reasons"]},{"id":"56c68b48499ae6ebd950fc47606e36bbf3b75635d3fa53503a7930122ed7cb7b","name":"Customer Feedback ASIN Review Trends","tableName":"amazon_customer_feedback_item_review_trends","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"response_period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the overall date range on the Customer Feedback response, in UTC."},{"name":"response_period_end_at_utc","type":"DATE","nullable":false,"description":"End of the overall date range on the Customer Feedback response, in UTC."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"topic","type":"TEXT","nullable":false,"description":"Topic text Amazon returned. The same words can change between fetches."},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":"1-based position of the topic in the Amazon list. The same rank is repeated on each monthly row for that topic."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"node_category_id","type":"TEXT","nullable":true,"description":"Browse node from the Customer Feedback ASIN category mapping. Empty when that mapping is missing."},{"name":"product_node_category_name","type":"TEXT","nullable":true,"description":"Browse node name from the Customer Feedback ASIN category mapping. Empty when that mapping is missing."},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":"POSITIVE or NEGATIVE."},{"name":"topic_child_asin_occurrence_percentage","type":"NUMBER","nullable":false,"description":"Source percentage of this child ASIN reviews that mention the topic in the month. 10 means 10%."},{"name":"topic_parent_asin_occurrence_percentage","type":"NUMBER","nullable":true,"description":"Source percentage for the parent ASIN when Amazon returned it. Empty when parent data is unavailable. There is no parent ASIN id in this response."},{"name":"topic_node_category_occurrence_percentage_all_products","type":"NUMBER","nullable":true,"description":"Source percentage for all products in the browse node when Amazon returned it. Empty when the category comparison is unavailable."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback monthly review topic trends for a child ASIN. DataDoe fetches a new response about every 30 days. Amazon may refresh the source weekly. date is the UTC day of the fetch. period_start_at_utc and period_end_at_utc are the month Amazon returned for that point. Percentages are the source values on a 0 to 100 scale. A missing parent or category percentage means Amazon did not return that comparison. Category names stay empty when the ASIN has no category mapping.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["review trends","customer feedback","topic trends"]},{"id":"711321083dbdaaa2eeb9d6cd3beb38ccf61a0821e7866f53791eca749ff5a8be","name":"Customer Feedback Category Review Trends","tableName":"amazon_customer_feedback_browse_node_review_trends","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"response_period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the overall date range on the Customer Feedback response, in UTC."},{"name":"response_period_end_at_utc","type":"DATE","nullable":false,"description":"End of the overall date range on the Customer Feedback response, in UTC."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"topic","type":"TEXT","nullable":false,"description":"Topic text Amazon returned. The same words can change between fetches."},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":"1-based position of the topic in the Amazon list. The same rank is repeated on each monthly row for that topic."},{"name":"node_category_id","type":"TEXT","nullable":false,"description":"Browse node id Amazon returned. Kept as text."},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":"POSITIVE or NEGATIVE."},{"name":"topic_node_category_occurrence_percentage_all_products","type":"NUMBER","nullable":false,"description":"Source percentage of review feedback for all products in the browse node that mentions the topic."},{"name":"topic_node_category_occurrence_percentage_top_25_percent_products","type":"NUMBER","nullable":false,"description":"Source percentage for the top 25 percent of products in the browse node."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback monthly review topic trends for all products in a browse node. This is separate from ASIN trends. DataDoe fetches a new response about every 30 days. date is the UTC day of the fetch. period_start_at_utc and period_end_at_utc are the month Amazon returned. The top 25 percent column is the source percentage for the top 25 percent of products, not 25 percent of the all-products value. Percentages are the source values on a 0 to 100 scale.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["category review trends","review trends"]},{"id":"4f40bfc6eaa96c4864b74465ebfbce9e6e97d686dd4066af7f87a43092959a26","name":"Customer Feedback Category Return Trends","tableName":"amazon_customer_feedback_browse_node_return_trends","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"response_period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the overall date range on the Customer Feedback response, in UTC."},{"name":"response_period_end_at_utc","type":"DATE","nullable":false,"description":"End of the overall date range on the Customer Feedback response, in UTC."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"topic","type":"TEXT","nullable":false,"description":"Topic text Amazon returned. The same words can change between fetches."},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":"1-based position of the topic in the Amazon list. The same rank is repeated on each monthly row for that topic."},{"name":"node_category_id","type":"TEXT","nullable":false,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"topic_node_category_occurrence_percentage_all_products","type":"NUMBER","nullable":false,"description":"Source percentage of category return feedback that mentions the topic. 10 means 10%."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback monthly return topic trends for all products in a browse node. The percentage is the share of category return feedback that mentions the topic. It is not the share of sold units that were returned. The table has no sentiment. DataDoe fetches a new response about every 30 days. date is the UTC day of the fetch. period_start_at_utc and period_end_at_utc are the month Amazon returned.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["return trends","return reasons"]},{"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."},{"name":"ads_account_type","type":"TEXT","nullable":true,"description":"Amazon Ads profile account type: seller / vendor / agency. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"ads_account_subtype","type":"TEXT","nullable":true,"description":"Amazon Ads special account subtype, such as KDP_AUTHOR or AMAZON_ATTRIBUTION. Null for regular accounts and until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"is_kdp_author","type":"LOGIC","nullable":true,"description":"True for a Kindle Direct Publishing author account (ads_account_subtype KDP_AUTHOR), false for other captured profiles. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"ads_profile_currency_code","type":"TEXT","nullable":true,"description":"Currency of the Amazon Ads profile. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"ads_profile_timezone","type":"TEXT","nullable":true,"description":"IANA timezone of the Amazon Ads profile. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"amazon_ads_reporting_timezone","type":"TEXT","nullable":true,"description":"IANA timezone from the Amazon Ads profile, such as Europe/London. Null when it is not verified. Seller Central and Vendor Central rows are null. DSP rows use the agency Ads connection timezone, not a DSP advertiser timezone. There is no country or UTC fallback."},{"name":"amazon_ads_reporting_timezone_source","type":"TEXT","nullable":false,"description":"ADS_PROFILE when amazon_ads_reporting_timezone is verified. UNKNOWN when it is not."},{"name":"ads_billing_permission_missing_at","type":"DATE","nullable":true,"description":"When the last Ads Billing check for this connection was denied. Null when the last check succeeded, the connection is not Amazon Ads, or billing has not been checked. DSP advertiser rows are null."}],"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_ads_api_billing_access","raw_connection_dsp_advertisers"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["connection mapping","selling partner id","dsp advertiser","ads profile","billing permission"]},{"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":"vendor_code","type":"TEXT","nullable":false,"description":"Optional vendor code cost variant. Empty for the ASIN default."},{"name":"fulfillment_method","type":"TEXT","nullable":false,"description":"Optional explicit fulfillment cost variant."},{"name":"purchase_order_number","type":"TEXT","nullable":false,"description":"Optional exact purchase-order cost override. It requires unambiguous transaction linkage before use in a margin."},{"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":"Your uploaded product cost ledger, maintained by the user. Seller costs are per SKU and ASIN; vendor costs are per account, marketplace, ASIN and effective date with empty SKU. Vendor rows can have optional vendor-code, fulfillment and exact-PO variant keys; an empty set of variant keys is the explicit ASIN default. The full variant key and effective date identify an upsert or edit. Uploaded costs stay separate from Amazon-reported costs. COGS are managed by the user via form in the Sellers & Vendors page. Every 5 days DataDoe checks sellers with at least one COGS row and emails organization owners when SKUs sold in the last 30 days have no COGS. To list SKUs sold in the last 30 days without COGS, use GET /api/v1/cogs/missing or the MCP tool cogs_missing_list.","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":"latest_ship_date","type":"DATE","nullable":true,"description":"Latest date and time in UTC by which the seller must ship the order. NULL when Amazon does not provide the deadline or the order has not been fetched with deadline support."},{"name":"latest_delivery_date","type":"DATE","nullable":true,"description":"Latest date and time in UTC by which the order must be delivered. NULL when Amazon does not provide the deadline or the order has not been fetched with deadline support."},{"name":"buyer_email","type":"TEXT","nullable":true,"description":"DataDoe stores the anonymized buyer email Amazon returns for up to 30 days from the purchase date. The value is NULL for Fulfillment by Amazon (FBA) orders. Amazon does not document this value as identifying the same buyer across orders."},{"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 details that extend `amazon_order_items_with_cogs`, including shipping and delivery deadlines when Amazon provides them. Personal fields become NULL after 30 days from the purchase date. Historical rows, order identifiers, dates, and coarse geography remain available.","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":"869faf9a6763b60ab8edc88216bd6fbc2b1414b9eb15e7420ee1de869f1f972e","name":"Repeat Purchase Performance (Quarterly)","tableName":"amazon_repeat_purchase_report_quarterly","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 quarter. 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 quarter."},{"name":"repeat_customers_score_total","type":"NUMBER","nullable":false,"description":"Fraction of unique customers that are repeat customers in the quarter, 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 quarter. 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 quarter, between 0 and 1."},{"name":"date","type":"DATE","nullable":false,"description":"First day of the calendar quarter the data refers to: 1 January, 1 April, 1 July or 1 October. One row covers that full quarter. This table stores the QUARTER Brand Analytics period."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Quarterly Brand Analytics repeat purchase report per child ASIN for Brand Registry sellers and vendors. One row per child ASIN, connection, marketplace and calendar quarter. repeat_customers_score_total and repeat_purchase_revenue_score_total are 0-1 rates calculated inside the quarter, not the sum or average of monthly rates. Repeat revenue is ordered revenue and excludes returns. Initial collection requests the last 4 complete calendar quarters. Weekly refresh requests the last 2 complete calendar quarters. The quarter in progress is excluded.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":456},{"type":"RECURRING_WEEKLY","numberOfDays":276}],"sources":["connections","raw_sp_api_report_brand_analytics_repeat_purchase_quarterly"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["quarterly repeat purchase","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":"clicked_item_name","type":"TEXT","nullable":true,"description":"Product title for clicked_asin from Amazon’s Search Terms report. Includes products outside your catalog. Null when the report does not provide a title or the row has not been reprocessed."},{"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":"clicked_item_name","type":"TEXT","nullable":true,"description":"Product title for clicked_asin from Amazon’s Search Terms report. Includes products outside your catalog. Null when the report does not provide a title or the row has not been reprocessed."},{"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":"clicked_item_name","type":"TEXT","nullable":true,"description":"Product title for clicked_asin from Amazon’s Search Terms report. Includes products outside your catalog. Null when the report does not provide a title or the row has not been reprocessed."},{"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":"observation_id","type":"TEXT","nullable":true,"description":"Successful source observation identity. Null on legacy cache rows."},{"name":"checked_at","type":"DATE","nullable":true,"description":"Successful source-response observation time. Retry markers are not source checks."},{"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":"observation_id","type":"TEXT","nullable":true,"description":"Successful source observation identity. Null on legacy cache rows."},{"name":"checked_at","type":"DATE","nullable":true,"description":"Successful source-response observation time. Retry markers are not source checks."},{"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":"dcc0857a409fa1b40f544efca243912c6e5b8f64ac79addb8c9b2e9428a18289","name":"Product Catalog by ASIN History","tableName":"amazon_products_by_child_asin_history","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."},{"name":"date","type":"DATE","nullable":false,"description":"UTC date of the successful source observation. Same as snapshot_date."},{"name":"observation_id","type":"TEXT","nullable":false,"description":"Stable per-item observation identity. Replays retain this identity; unchanged later collections have a new identity."},{"name":"checked_at","type":"DATE","nullable":false,"description":"Successful source-response observation time, not the exact Amazon edit time."},{"name":"imported_at","type":"DATE","nullable":false,"description":"Time the observation entered durable Connector staging. Warehouse retries retain this value."},{"name":"snapshot_date","type":"DATE","nullable":false,"description":"UTC date of checked_at."},{"name":"snapshot_kind","type":"TEXT","nullable":false,"description":"OBSERVED. Legacy cache rows with unknown observation time are not copied into history."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Successful Amazon Catalog Items observations per child ASIN and marketplace for items the Organization tracks. A later successful response is retained even when unchanged; a retry keeps the original observation_id and checked_at without adding a duplicate. History starts after the Organization enables it and tracks the item. A newly associated item receives its next successful observation, without older shared-cache history. The source stays off until a staged Connector rollout enables it. History follows the existing catalog refresh. DataDoe can request an item again one day after its last cache update. The catalog worker runs every 15 minutes in each region and stops at its time limit, so a tracked item can go more than one day without a new observation. A history delivery backlog does not stop current catalog refreshes. Failed, throttled, empty and hard-failed attempts and items Amazon omits create no history observation. Missing days and source values remain unknown: a missing item or rank does not mean deletion or a zero rank. Observations are per item, not an atomic snapshot of the whole catalog. Changes occurred between observations; checked_at is not the exact time Amazon edited the item. Use amazon_products_by_child_asin and amazon_products_raw for current-state joins to sales, inventory and profit. They keep one latest row per ASIN and marketplace and provide the cached onboarding baseline. Legacy rows can have null checked_at and observation_id; overwritten payloads are not recovered or assigned invented times. When Amazon omits an item, its current row is created or cleared without a new checked_at and without a history observation. Filter history by child_asin, marketplace_id and a date range; date and snapshot_date are the UTC date of checked_at. For rank trends, order by checked_at and observation_id and compare category names and raw category identifiers, which can change. To compare observations, join on child_asin and marketplace_id and filter the two observation_id values; an absent observation produces no comparison. For the last observed state at a chosen time, filter checked_at <= the chosen timestamp, then use QUALIFY ROW_NUMBER() OVER (PARTITION BY child_asin, marketplace_id ORDER BY checked_at DESC, observation_id DESC) = 1. This returns only items observed by that time and does not fill gaps with current content.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["refined_products_by_child_asin_history"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["historical catalog observations","rank trends"]},{"id":"54089117e787319ccf91f286a0d42907e8fc727c63926d687cfd0798735c5ee3","name":"Product Catalog by ASIN History (Raw JSON)","tableName":"amazon_products_raw_history","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."},{"name":"date","type":"DATE","nullable":false,"description":"UTC date of the successful source observation. Same as snapshot_date."},{"name":"observation_id","type":"TEXT","nullable":false,"description":"Stable per-item observation identity. Replays retain this identity; unchanged later collections have a new identity."},{"name":"checked_at","type":"DATE","nullable":false,"description":"Successful source-response observation time, not the exact Amazon edit time."},{"name":"imported_at","type":"DATE","nullable":false,"description":"Time the observation entered durable Connector staging. Warehouse retries retain this value."},{"name":"snapshot_date","type":"DATE","nullable":false,"description":"UTC date of checked_at."},{"name":"snapshot_kind","type":"TEXT","nullable":false,"description":"OBSERVED. Legacy cache rows with unknown observation time are not copied into history."},{"name":"product_data","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon SP-API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Successful Amazon Catalog Items observations per child ASIN and marketplace for items the Organization tracks. A later successful response is retained even when unchanged; a retry keeps the original observation_id and checked_at without adding a duplicate. History starts after the Organization enables it and tracks the item. A newly associated item receives its next successful observation, without older shared-cache history. The source stays off until a staged Connector rollout enables it. History follows the existing catalog refresh. DataDoe can request an item again one day after its last cache update. The catalog worker runs every 15 minutes in each region and stops at its time limit, so a tracked item can go more than one day without a new observation. A history delivery backlog does not stop current catalog refreshes. Failed, throttled, empty and hard-failed attempts and items Amazon omits create no history observation. Missing days and source values remain unknown: a missing item or rank does not mean deletion or a zero rank. Observations are per item, not an atomic snapshot of the whole catalog. Changes occurred between observations; checked_at is not the exact time Amazon edited the item. Use amazon_products_by_child_asin and amazon_products_raw for current-state joins to sales, inventory and profit. They keep one latest row per ASIN and marketplace and provide the cached onboarding baseline. Legacy rows can have null checked_at and observation_id; overwritten payloads are not recovered or assigned invented times. When Amazon omits an item, its current row is created or cleared without a new checked_at and without a history observation. Filter history by child_asin, marketplace_id and a date range; date and snapshot_date are the UTC date of checked_at. For rank trends, order by checked_at and observation_id and compare category names and raw category identifiers, which can change. To compare observations, join on child_asin and marketplace_id and filter the two observation_id values; an absent observation produces no comparison. For the last observed state at a chosen time, filter checked_at <= the chosen timestamp, then use QUALIFY ROW_NUMBER() OVER (PARTITION BY child_asin, marketplace_id ORDER BY checked_at DESC, observation_id DESC) = 1. This returns only items observed by that time and does not fill gaps with current content. Listing-specific prices, inventory, the advertising product catalog, Search Catalog Performance and A+ content are separate data sources. Matches amazon_products_by_child_asin_history by child_asin, marketplace_id and observation_id. Full product_data preserves the complete source JSON, including sales-rank arrays and category identifiers; missing values remain null. Rows are large; download payloads to a file. For MCP raw-history exports, paginate with limit and skip: at most 100 rows in JSON or 250 rows in CSV. REST file generation and direct BigQuery queries use their own policies.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["refined_products_by_child_asin_history"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["historical catalog payloads","raw catalog observations"]},{"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":"d56182eea515323d6a59cd58f5bdfdf7e5707e15a49a915e73a78381ab2a07b4","name":"Customer Feedback ASIN Categories","tableName":"amazon_customer_feedback_item_browse_nodes","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"node_category_id","type":"TEXT","nullable":false,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"The browse node Amazon Customer Feedback associated with each child ASIN. One row is one associated node, not the full category path. DataDoe collects a new snapshot about every 30 days.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"224df5a43c4a64a064c285c29fc2f4932d3fdd38f55493ada7f60b992550458d","name":"Customer Feedback ASIN Review Topics","tableName":"amazon_customer_feedback_item_review_topics","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the date range Amazon returned with the response, in UTC."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the date range Amazon returned with the response, in UTC."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"node_category_id","type":"TEXT","nullable":true,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":true,"description":null},{"name":"sort_by","type":"TEXT","nullable":false,"description":"MENTIONS for this table."},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":"POSITIVE or NEGATIVE."},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":"1-based position in the Amazon list. A blank topic is skipped and does not renumber later topics."},{"name":"topic","type":"TEXT","nullable":false,"description":null},{"name":"topic_child_asin_number_of_mentions","type":"NUMBER","nullable":true,"description":null},{"name":"topic_child_asin_occurrence_percentage","type":"NUMBER","nullable":true,"description":null},{"name":"topic_child_asin_star_rating_impact","type":"NUMBER","nullable":true,"description":null},{"name":"topic_parent_asin_number_of_mentions","type":"NUMBER","nullable":true,"description":null},{"name":"topic_parent_asin_occurrence_percentage","type":"NUMBER","nullable":true,"description":null},{"name":"topic_parent_asin_star_rating_impact","type":"NUMBER","nullable":true,"description":null},{"name":"topic_review_snippet_1","type":"TEXT","nullable":true,"description":"First review excerpt Amazon returned for the topic. Not the full review. Amazon chooses the language."},{"name":"topic_review_snippet_2","type":"TEXT","nullable":true,"description":"Second review excerpt Amazon returned for the topic. Empty when Amazon returned fewer than 2."},{"name":"topic_review_snippet_3","type":"TEXT","nullable":true,"description":"Third review excerpt Amazon returned for the topic. Empty when Amazon returned fewer than 3."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback review topics for a child ASIN, sorted by mentions. DataDoe collects about every 30 days. Amazon may refresh the source weekly, so a row can be newer than the previous fetch. Topics are the ones Amazon returned, not a complete list. Snippets and topic names are the text Amazon returned, not full reviews. Amazon chooses the language. Sentiment is the positive or negative list, not a star rating. Percentages are the source values and are not additive. Category fields are empty when the ASIN has no category mapping.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["review topics","customer feedback","voice of the customer"]},{"id":"d3413c87b8b0b20213618c358f01c5ce3bc4fb8dae680bb7e04bbdf69986d819","name":"Customer Feedback ASIN Review Subtopics","tableName":"amazon_customer_feedback_item_review_subtopics","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the date range Amazon returned with the response, in UTC."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the date range Amazon returned with the response, in UTC."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"node_category_id","type":"TEXT","nullable":true,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":true,"description":null},{"name":"sort_by","type":"TEXT","nullable":false,"description":null},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":null},{"name":"topic","type":"TEXT","nullable":false,"description":null},{"name":"subtopic_rank","type":"NUMBER","nullable":false,"description":null},{"name":"subtopic","type":"TEXT","nullable":false,"description":null},{"name":"subtopic_number_of_mentions","type":"NUMBER","nullable":true,"description":null},{"name":"subtopic_occurrence_percentage","type":"NUMBER","nullable":true,"description":null},{"name":"subtopic_review_snippet_1","type":"TEXT","nullable":true,"description":null},{"name":"subtopic_review_snippet_2","type":"TEXT","nullable":true,"description":null},{"name":"subtopic_review_snippet_3","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback review subtopics for a child ASIN. Subtopics stay under the topic Amazon returned. There is no extra subtopic for reviews that do not match a returned subtopic. Percentages are the source values and are not additive.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"d3aea65db06b6e3e1f9e395cae749e63571e3f555b3e514d10b6a9a1daa3f2be","name":"Customer Feedback Category Review Topics","tableName":"amazon_customer_feedback_browse_node_review_topics","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the date range Amazon returned with the response, in UTC."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the date range Amazon returned with the response, in UTC."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"node_category_id","type":"TEXT","nullable":false,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"sort_by","type":"TEXT","nullable":false,"description":null},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":null},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":null},{"name":"topic","type":"TEXT","nullable":false,"description":null},{"name":"topic_node_category_star_rating_impact_all_products","type":"NUMBER","nullable":true,"description":null},{"name":"topic_node_category_star_rating_impact_top_25_percent_products","type":"NUMBER","nullable":true,"description":null},{"name":"topic_node_category_occurrence_percentage_all_products","type":"NUMBER","nullable":true,"description":null},{"name":"topic_node_category_occurrence_percentage_top_25_percent_products","type":"NUMBER","nullable":true,"description":null},{"name":"topic_review_snippet_1","type":"TEXT","nullable":true,"description":"First review excerpt Amazon returned for the topic. Not the full review. Amazon chooses the language."},{"name":"topic_review_snippet_2","type":"TEXT","nullable":true,"description":"Second review excerpt Amazon returned for the topic. Empty when Amazon returned fewer than 2."},{"name":"topic_review_snippet_3","type":"TEXT","nullable":true,"description":"Third review excerpt Amazon returned for the topic. Empty when Amazon returned fewer than 3."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback review topics for all products in a browse node. This is not an ASIN topic list. DataDoe collects about every 30 days. Topics are the ones Amazon returned, not a complete list. Percentages are the source values. Do not add them across products or connections.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"b553b2a9c27645655db27f1b80e6638ee9b1218085973a906fd4f7e8d839667c","name":"Customer Feedback Category Review Subtopics","tableName":"amazon_customer_feedback_browse_node_review_subtopics","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the date range Amazon returned with the response, in UTC."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the date range Amazon returned with the response, in UTC."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"node_category_id","type":"TEXT","nullable":false,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"sort_by","type":"TEXT","nullable":false,"description":null},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":null},{"name":"topic","type":"TEXT","nullable":false,"description":null},{"name":"subtopic_rank","type":"NUMBER","nullable":false,"description":null},{"name":"subtopic","type":"TEXT","nullable":false,"description":null},{"name":"subtopic_occurrence_percentage","type":"NUMBER","nullable":true,"description":null},{"name":"subtopic_review_snippet_1","type":"TEXT","nullable":true,"description":null},{"name":"subtopic_review_snippet_2","type":"TEXT","nullable":true,"description":null},{"name":"subtopic_review_snippet_3","type":"TEXT","nullable":true,"description":null}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback review subtopics for all products in a browse node. A category subtopic has an occurrence percentage only. It has no mention count. There is no extra subtopic for reviews that do not match a returned subtopic.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"ae4696b6c71ccc9ba281a7e91c627d512a74c39853fe25c172c1d5d9b97be5c6","name":"Customer Feedback Category Return Topics","tableName":"amazon_customer_feedback_browse_node_return_topics","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the date range Amazon returned with the response, in UTC."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the date range Amazon returned with the response, in UTC."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"node_category_id","type":"TEXT","nullable":false,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":null},{"name":"topic","type":"TEXT","nullable":false,"description":null},{"name":"topic_node_category_occurrence_percentage_all_products","type":"NUMBER","nullable":true,"description":null}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback return topics for all products in a browse node. The occurrence percentage is not an ASIN return rate. The table has no sentiment, snippets, or mention counts.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["return topics","return reasons"]},{"id":"56c68b48499ae6ebd950fc47606e36bbf3b75635d3fa53503a7930122ed7cb7b","name":"Customer Feedback ASIN Review Trends","tableName":"amazon_customer_feedback_item_review_trends","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"response_period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the overall date range on the Customer Feedback response, in UTC."},{"name":"response_period_end_at_utc","type":"DATE","nullable":false,"description":"End of the overall date range on the Customer Feedback response, in UTC."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"topic","type":"TEXT","nullable":false,"description":"Topic text Amazon returned. The same words can change between fetches."},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":"1-based position of the topic in the Amazon list. The same rank is repeated on each monthly row for that topic."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"product_name","type":"TEXT","nullable":false,"description":null},{"name":"node_category_id","type":"TEXT","nullable":true,"description":"Browse node from the Customer Feedback ASIN category mapping. Empty when that mapping is missing."},{"name":"product_node_category_name","type":"TEXT","nullable":true,"description":"Browse node name from the Customer Feedback ASIN category mapping. Empty when that mapping is missing."},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":"POSITIVE or NEGATIVE."},{"name":"topic_child_asin_occurrence_percentage","type":"NUMBER","nullable":false,"description":"Source percentage of this child ASIN reviews that mention the topic in the month. 10 means 10%."},{"name":"topic_parent_asin_occurrence_percentage","type":"NUMBER","nullable":true,"description":"Source percentage for the parent ASIN when Amazon returned it. Empty when parent data is unavailable. There is no parent ASIN id in this response."},{"name":"topic_node_category_occurrence_percentage_all_products","type":"NUMBER","nullable":true,"description":"Source percentage for all products in the browse node when Amazon returned it. Empty when the category comparison is unavailable."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback monthly review topic trends for a child ASIN. DataDoe fetches a new response about every 30 days. Amazon may refresh the source weekly. date is the UTC day of the fetch. period_start_at_utc and period_end_at_utc are the month Amazon returned for that point. Percentages are the source values on a 0 to 100 scale. A missing parent or category percentage means Amazon did not return that comparison. Category names stay empty when the ASIN has no category mapping.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["review trends","customer feedback","topic trends"]},{"id":"711321083dbdaaa2eeb9d6cd3beb38ccf61a0821e7866f53791eca749ff5a8be","name":"Customer Feedback Category Review Trends","tableName":"amazon_customer_feedback_browse_node_review_trends","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"response_period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the overall date range on the Customer Feedback response, in UTC."},{"name":"response_period_end_at_utc","type":"DATE","nullable":false,"description":"End of the overall date range on the Customer Feedback response, in UTC."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"topic","type":"TEXT","nullable":false,"description":"Topic text Amazon returned. The same words can change between fetches."},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":"1-based position of the topic in the Amazon list. The same rank is repeated on each monthly row for that topic."},{"name":"node_category_id","type":"TEXT","nullable":false,"description":"Browse node id Amazon returned. Kept as text."},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"topic_sentiment","type":"TEXT","nullable":false,"description":"POSITIVE or NEGATIVE."},{"name":"topic_node_category_occurrence_percentage_all_products","type":"NUMBER","nullable":false,"description":"Source percentage of review feedback for all products in the browse node that mentions the topic."},{"name":"topic_node_category_occurrence_percentage_top_25_percent_products","type":"NUMBER","nullable":false,"description":"Source percentage for the top 25 percent of products in the browse node."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback monthly review topic trends for all products in a browse node. This is separate from ASIN trends. DataDoe fetches a new response about every 30 days. date is the UTC day of the fetch. period_start_at_utc and period_end_at_utc are the month Amazon returned. The top 25 percent column is the source percentage for the top 25 percent of products, not 25 percent of the all-products value. Percentages are the source values on a 0 to 100 scale.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["category review trends","review trends"]},{"id":"4f40bfc6eaa96c4864b74465ebfbce9e6e97d686dd4066af7f87a43092959a26","name":"Customer Feedback Category Return Trends","tableName":"amazon_customer_feedback_browse_node_return_trends","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":true,"description":"DataDoe account identifier. Empty when the connection context cannot be resolved. The row is still returned."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"DataDoe connection context display name. Empty when the connection context cannot be resolved."},{"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 day when DataDoe fetched the response."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":"Identifier of the promoted Customer Feedback snapshot."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"UTC time when DataDoe fetched the response."},{"name":"response_period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the overall date range on the Customer Feedback response, in UTC."},{"name":"response_period_end_at_utc","type":"DATE","nullable":false,"description":"End of the overall date range on the Customer Feedback response, in UTC."},{"name":"period_start_at_utc","type":"DATE","nullable":false,"description":"Start of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"period_end_at_utc","type":"DATE","nullable":false,"description":"End of the monthly point Amazon returned in trendMetrics, in UTC. Use this for trend analysis."},{"name":"source_api","type":"TEXT","nullable":false,"description":"Fixed value CUSTOMER_FEEDBACK_2024_06_01."},{"name":"topic","type":"TEXT","nullable":false,"description":"Topic text Amazon returned. The same words can change between fetches."},{"name":"topic_rank","type":"NUMBER","nullable":false,"description":"1-based position of the topic in the Amazon list. The same rank is repeated on each monthly row for that topic."},{"name":"node_category_id","type":"TEXT","nullable":false,"description":null},{"name":"product_node_category_name","type":"TEXT","nullable":false,"description":null},{"name":"topic_node_category_occurrence_percentage_all_products","type":"NUMBER","nullable":false,"description":"Source percentage of category return feedback that mentions the topic. 10 means 10%."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Customer Feedback monthly return topic trends for all products in a browse node. The percentage is the share of category return feedback that mentions the topic. It is not the share of sold units that were returned. The table has no sentiment. DataDoe fetches a new response about every 30 days. date is the UTC day of the fetch. period_start_at_utc and period_end_at_utc are the month Amazon returned.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_customer_feedback_snapshots"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["return trends","return reasons"]},{"id":"abafd926794c204dea3a7ff75f430f27a7285cabdb2651a34a4c2cdd89f531c6","name":"Invoices","tableName":"amazon_invoices","type":"VENDOR_CENTRAL","columns":[{"name":"invoiced_non_product_amount_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"uploaded_cogs_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_complete","type":"LOGIC","nullable":true,"description":"Your uploaded product cost coverage. True only when all relevant lines, units, currencies and source totals reconcile. Partial matched sums are not complete totals."},{"name":"uploaded_cogs_missing_reason","type":"TEXT","nullable":true,"description":"Your uploaded product cost. Reason an applicable cost or complete margin is unavailable. Missing identifiers and equally specific variants are unresolved."},{"name":"uploaded_cogs_calculation_date","type":"DATE","nullable":true,"description":"Your uploaded product cost selection date. PO date for projected margins; invoice issue date for invoice and settlement margins. Payment date never selects another cost."},{"name":"uploaded_cogs_goods_line_count","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_missing_line_count","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"invoiced_product_revenue_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"invoiced_product_tax_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"invoiced_product_margin_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"invoiced_product_margin_percentage","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"adjusted_invoiced_product_margin_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"uploaded_cogs_adjustment_status","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"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","raw_sp_api_invoice_items","raw_amazon_cogs"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["accounts payable","vendor invoice"]},{"id":"225e7ddc71dc18c0eac1cc5c4ece2f974e0c737590d39ca89543d8566a0dfc5f","name":"Invoice Items","tableName":"amazon_invoice_items","type":"VENDOR_CENTRAL","columns":[{"name":"uploaded_cogs_unit_item_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost per single ASIN item. Customer-maintained cost, separate from Amazon-reported wholesale prices, shipped COGS and Net PPM."},{"name":"uploaded_cogs_unit_shipping_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost per single ASIN item. Customer-maintained cost, separate from Amazon-reported wholesale prices, shipped COGS and Net PPM."},{"name":"uploaded_cogs_unit_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost per single ASIN item. Customer-maintained cost, separate from Amazon-reported wholesale prices, shipped COGS and Net PPM."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_effective_from","type":"DATE","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_present","type":"LOGIC","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_match_status","type":"TEXT","nullable":true,"description":"Your uploaded product cost. Reason an applicable cost or complete margin is unavailable. Missing identifiers and equally specific variants are unresolved."},{"name":"uploaded_cogs_vendor_code","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_fulfillment_method","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_purchase_order_number","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_calculation_date","type":"DATE","nullable":true,"description":"Your uploaded product cost selection date. PO date for projected margins; invoice issue date for invoice and settlement margins. Payment date never selects another cost."},{"name":"uploaded_cogs_quantity_unit","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_item_units","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_complete","type":"LOGIC","nullable":true,"description":"Your uploaded product cost coverage. True only when all relevant lines, units, currencies and source totals reconcile. Partial matched sums are not complete totals."},{"name":"uploaded_cogs_missing_reason","type":"TEXT","nullable":true,"description":"Your uploaded product cost. Reason an applicable cost or complete margin is unavailable. Missing identifiers and equally specific variants are unresolved."},{"name":"invoiced_product_revenue_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"invoiced_product_margin_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"invoiced_product_margin_percentage","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"uploaded_cogs_applicable","type":"LOGIC","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"invoiced_product_tax_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"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","raw_sp_api_invoices","raw_amazon_cogs"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["invoice lines","price variance","quantity variance"]},{"id":"ab3e362adb3ce1a6e2db23ff506738f91e2cb8073e8298dba8e4007dbba821a7","name":"Remittances","tableName":"amazon_remittances","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 payment date. Use for date filtering."},{"name":"unique_payment_id","type":"TEXT","nullable":false,"description":"Unique payment identifier. Join amazon_remittance_items on this column. Differs from payment_number."},{"name":"payment_number","type":"TEXT","nullable":true,"description":"External payment reference, as shown on the bank statement and in Vendor Central. Not unique."},{"name":"payment_date","type":"DATE","nullable":true,"description":"Payment timestamp. date is the UTC calendar day of this value."},{"name":"payment_amount","type":"NUMBER","nullable":true,"description":null},{"name":"payment_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of payment_amount."},{"name":"payment_amount_in_invoice_currency","type":"NUMBER","nullable":true,"description":"Payment amount in the invoice currency, when it differs from payment_currency."},{"name":"invoice_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of payment_amount_in_invoice_currency."},{"name":"exchange_rate","type":"NUMBER","nullable":true,"description":"Exchange rate applied to the payment."},{"name":"payment_method","type":"TEXT","nullable":true,"description":"Payment method, such as EFT."},{"name":"remittance_status","type":"TEXT","nullable":true,"description":"IN_PROGRESS, SUCCESSFUL, or FAILED."},{"name":"line_item_count","type":"NUMBER","nullable":true,"description":"Number of lines in amazon_remittance_items for this payment."},{"name":"vendor_codes","type":"JSON","nullable":true,"description":"JSON list of vendor codes the payment covers."},{"name":"payee_codes","type":"JSON","nullable":true,"description":"JSON list of payee codes the payment was made to."},{"name":"related_identifiers","type":"JSON","nullable":true,"description":"Raw JSON related business identifiers. relatedIdentifierName values: VENDOR_CODE, PAYEE_CODE."},{"name":"country_code","type":"TEXT","nullable":true,"description":"ISO 3166-1 alpha-2 country code of the remittance."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last received this row from the SP-API Finance Remittance API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Vendor Central payments from Amazon, as in Vendor Central Payments > Remittance. One row per payment. Join amazon_remittance_items on unique_payment_id for the invoices, deductions, vendor returns, and advertising lines the payment covers. The sum of amazon_remittance_items.amount_paid over a payment equals payment_amount. Use amazon_invoices for per-invoice status and settlement totals, and this table for when and how Amazon paid. Chargeback reason codes, disputes, and co-op agreements are not included. date is the UTC day of payment_date.","requiresDatePeriod":true,"issues":[],"prerequisites":"Vendor Central only. Amazon does not offer the Finance Remittance API to Seller Central accounts, so sellers get no rows. The API needs the Finance and Accounting role, the same role as the Invoices API. 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":364},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_sp_api_remittances"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["remittance","vendor payments","payment"]},{"id":"702e2dbb8fe12141e41bd1be8f5d8864bddd149f743cbabc69f81df43a7a52d1","name":"Remittance Items","tableName":"amazon_remittance_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 payment date. Use for date filtering."},{"name":"unique_payment_id","type":"TEXT","nullable":false,"description":"Parent payment. Join amazon_remittances on this column."},{"name":"line_number","type":"NUMBER","nullable":false,"description":"Position of the line in the payment, starting at 1. Amazon gives lines no id, so unique_payment_id and line_number identify a line."},{"name":"invoice_number","type":"TEXT","nullable":true,"description":"Invoice number. Join amazon_invoices.invoice_number."},{"name":"invoice_issue_date","type":"DATE","nullable":true,"description":null},{"name":"invoice_type","type":"TEXT","nullable":true,"description":"Invoice type as Amazon reports it, such as Standard."},{"name":"description","type":"TEXT","nullable":true,"description":"Line description, such as Payment for goods received."},{"name":"payment_terms","type":"TEXT","nullable":true,"description":"Payment terms, such as 1% 30, NET 60."},{"name":"total_amount","type":"NUMBER","nullable":true,"description":"Invoiced amount of the line: invoice_amount plus tax_amount."},{"name":"currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of the line amounts."},{"name":"invoice_amount","type":"NUMBER","nullable":true,"description":"InvoiceAmount part of total_amount."},{"name":"tax_amount","type":"NUMBER","nullable":true,"description":"TaxAmount part of total_amount."},{"name":"net_amount_paid","type":"NUMBER","nullable":true,"description":"Amount this payment settles for the line: amount_paid plus terms_discount_taken. Use amount_paid for the money transferred."},{"name":"amount_paid","type":"NUMBER","nullable":true,"description":"Money transferred for this line by this payment (AmountPaid part of net_amount_paid). Sums to amazon_remittances.payment_amount."},{"name":"terms_discount_taken","type":"NUMBER","nullable":true,"description":"Early-payment discount Amazon took under the payment terms (TermsDiscountTaken part of net_amount_paid)."},{"name":"withholding_amount","type":"NUMBER","nullable":true,"description":"Amount withheld on the line."},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code of the line."},{"name":"total_amount_breakdown","type":"JSON","nullable":true,"description":"Raw JSON list of {breakdownType, breakdownAmount {currencyCode, currencyAmount}}. breakdownType values: InvoiceAmount, TaxAmount."},{"name":"net_amount_paid_breakdown","type":"JSON","nullable":true,"description":"Raw JSON list of {breakdownType, breakdownAmount {currencyCode, currencyAmount}}. breakdownType values: AmountPaid, TermsDiscountTaken."},{"name":"related_item_identifiers","type":"JSON","nullable":true,"description":"Raw JSON related identifiers of the line. relatedIdentifierName values: VENDOR_CODE."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last received this row from the SP-API Finance Remittance API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Invoice-level lines of Vendor Central payments. One row per line of a payment: invoice payments, deductions, vendor returns, and advertising. A deduction shows only through description, invoice_type, and a negative amount; there is no reason code, dispute, or purchase order field. One invoice can be paid across several payments, so amount_paid is the part paid by this payment. Join amazon_remittances on unique_payment_id and amazon_invoices on invoice_number. date is the UTC day of the parent payment date.","requiresDatePeriod":true,"issues":[],"prerequisites":"Vendor Central only. Amazon does not offer the Finance Remittance API to Seller Central accounts, so sellers get no rows. The API needs the Finance and Accounting role, the same role as the Invoices API. 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":364},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_sp_api_remittance_items"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["remittance lines","deductions","terms discount"]},{"id":"9847d8eaf96a6c44fe7c174ec787e09862ed875b844a77d648028765432c0f60","name":"Vendor PO margins","tableName":"amazon_vendor_po_margins","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":"Scoped Amazon source identifier or document detail for filtering and drilldown. JSON details retain unresolved rows and source links."},{"name":"source","type":"TEXT","nullable":true,"description":"Scoped Amazon source identifier or document detail for filtering and drilldown. JSON details retain unresolved rows and source links."},{"name":"purchase_order_number","type":"TEXT","nullable":true,"description":"Scoped Amazon source identifier or document detail for filtering and drilldown. JSON details retain unresolved rows and source links."},{"name":"uploaded_cogs_calculation_date","type":"DATE","nullable":true,"description":"Your uploaded product cost selection date. PO date for projected margins; invoice issue date for invoice and settlement margins. Payment date never selects another cost."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_complete","type":"LOGIC","nullable":true,"description":"Your uploaded product cost coverage. True only when all relevant lines, units, currencies and source totals reconcile. Partial matched sums are not complete totals."},{"name":"uploaded_cogs_missing_reason","type":"TEXT","nullable":true,"description":"Your uploaded product cost. Reason an applicable cost or complete margin is unavailable. Missing identifiers and equally specific variants are unresolved."},{"name":"uploaded_cogs_line_count","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_missing_line_count","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"projected_product_revenue_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Projected product margin uses tax-exclusive wholesale revenue minus uploaded costs on the PO date. Cancelled orders are excluded. Not invoiced revenue, cash or complete net profit."},{"name":"projected_product_margin_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Projected product margin uses tax-exclusive wholesale revenue minus uploaded costs on the PO date. Cancelled orders are excluded. Not invoiced revenue, cash or complete net profit."},{"name":"projected_product_margin_percentage","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Projected product margin uses tax-exclusive wholesale revenue minus uploaded costs on the PO date. Cancelled orders are excluded. Not invoiced revenue, cash or complete net profit."},{"name":"source_lines","type":"JSON","nullable":true,"description":"Scoped Amazon source identifier or document detail for filtering and drilldown. JSON details retain unresolved rows and source links."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"DataDoe projected product margins, one row per scoped PO and source. Regular and Direct Fulfillment orders remain separate. Costs use the PO date and validated item units; cancelled orders and incomplete lines have no active margin. Your uploaded product cost remains separate from Amazon-reported costs. Not invoiced revenue, cash or complete net profit.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":30},{"type":"CONTINUOUS"}],"sources":["connections","raw_amazon_cogs","raw_amazon_vendor_codes","raw_sp_api_vendor_purchase_orders","raw_sp_api_vendor_purchase_orders_status","raw_sp_api_vendor_df_orders"],"containsPii":false,"initialLoadProgress":null},{"id":"cb739f004136adfdcc03aac931a0b069ea9a8a4a880ed2dba79e3855f333b6f9","name":"Vendor invoice settlements","tableName":"amazon_vendor_invoice_settlement_margins","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."},{"name":"uploaded_cogs_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_complete","type":"LOGIC","nullable":true,"description":"Your uploaded product cost coverage. True only when all relevant lines, units, currencies and source totals reconcile. Partial matched sums are not complete totals."},{"name":"uploaded_cogs_missing_reason","type":"TEXT","nullable":true,"description":"Your uploaded product cost. Reason an applicable cost or complete margin is unavailable. Missing identifiers and equally specific variants are unresolved."},{"name":"uploaded_cogs_calculation_date","type":"DATE","nullable":true,"description":"Your uploaded product cost selection date. PO date for projected margins; invoice issue date for invoice and settlement margins. Payment date never selects another cost."},{"name":"uploaded_cogs_goods_line_count","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_missing_line_count","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"invoiced_product_revenue_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"invoiced_product_tax_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"invoiced_product_margin_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"invoiced_product_margin_percentage","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"invoiced_non_product_amount_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"adjusted_invoiced_product_margin_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Invoice issue-date goods amounts and uploaded costs. Unknown units, taxes, currencies or line coverage leave margin NULL. Available non-product adjustments remain separate."},{"name":"uploaded_cogs_adjustment_status","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"settlement_vendor_code","type":"TEXT","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_payee_code","type":"TEXT","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_net_receipts_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_tax_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_terms_discount_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_withholding_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_outstanding_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_payment_count","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_payment_ids","type":"JSON","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"final_payment_id","type":"TEXT","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"final_settlement_date","type":"DATE","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_complete","type":"LOGIC","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_missing_reason","type":"TEXT","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settled_invoice_revenue_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settled_invoice_margin_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settled_invoice_margin_percentage","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"uploaded_cogs_settled_invoice_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost for invoices whose final settlement is attributed to this row. Counted once, never allocated proportionally to installments."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"DataDoe invoice product costs and reconciled settlement margins. One row per scoped invoice. date remains the invoice issue date; final_settlement_date attributes the complete settlement history once. Partial payments show cash immediately but have no final margin. Costs use the invoice issue date. Unmatched identities, history or tax leave settlement margin unavailable. Nonzero deductions linked to the same invoice number or purchase order also withhold that invoice margin. Other payment-level deductions remain visible without blocking individual invoice margins. Backdated edits and reopening recompute this current view. Not complete net profit.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":30},{"type":"CONTINUOUS"}],"sources":["connections","raw_amazon_cogs","raw_sp_api_invoices","raw_sp_api_invoice_items","raw_sp_api_remittances","raw_sp_api_remittance_items"],"containsPii":false,"initialLoadProgress":null},{"id":"880f7a6598f041da41ea145a2b90d4a96b018fdbbf2914a8ea67e8f236440f2e","name":"Vendor payment margins","tableName":"amazon_vendor_payment_margins","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 payment date. Use for date filtering."},{"name":"unique_payment_id","type":"TEXT","nullable":false,"description":"Unique payment identifier. Join amazon_remittance_items on this column. Differs from payment_number."},{"name":"payment_number","type":"TEXT","nullable":true,"description":"External payment reference, as shown on the bank statement and in Vendor Central. Not unique."},{"name":"payment_date","type":"DATE","nullable":true,"description":"Payment timestamp. date is the UTC calendar day of this value."},{"name":"payment_amount","type":"NUMBER","nullable":true,"description":null},{"name":"payment_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of payment_amount."},{"name":"payment_amount_in_invoice_currency","type":"NUMBER","nullable":true,"description":"Payment amount in the invoice currency, when it differs from payment_currency."},{"name":"invoice_currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency of payment_amount_in_invoice_currency."},{"name":"exchange_rate","type":"NUMBER","nullable":true,"description":"Exchange rate applied to the payment."},{"name":"payment_method","type":"TEXT","nullable":true,"description":"Payment method, such as EFT."},{"name":"remittance_status","type":"TEXT","nullable":true,"description":"IN_PROGRESS, SUCCESSFUL, or FAILED."},{"name":"line_item_count","type":"NUMBER","nullable":true,"description":"Number of lines in amazon_remittance_items for this payment."},{"name":"vendor_codes","type":"JSON","nullable":true,"description":"JSON list of vendor codes the payment covers."},{"name":"payee_codes","type":"JSON","nullable":true,"description":"JSON list of payee codes the payment was made to."},{"name":"related_identifiers","type":"JSON","nullable":true,"description":"Raw JSON related business identifiers. relatedIdentifierName values: VENDOR_CODE, PAYEE_CODE."},{"name":"country_code","type":"TEXT","nullable":true,"description":"ISO 3166-1 alpha-2 country code of the remittance."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"Timestamp when DataDoe last received this row from the SP-API Finance Remittance API."},{"name":"cash_net_receipts_value","type":"NUMBER","nullable":true,"description":"Amazon-reported cash activity by payment date. Net receipts retain signed deductions; discount and withholding components are shown for reconciliation and are not subtracted twice."},{"name":"cash_inventory_net_receipts_value","type":"NUMBER","nullable":true,"description":"Amazon-reported cash activity by payment date. Net receipts retain signed deductions; discount and withholding components are shown for reconciliation and are not subtracted twice."},{"name":"cash_other_net_receipts_value","type":"NUMBER","nullable":true,"description":"Amazon-reported cash activity by payment date. Net receipts retain signed deductions; discount and withholding components are shown for reconciliation and are not subtracted twice."},{"name":"cash_terms_discount_value","type":"NUMBER","nullable":true,"description":"Amazon-reported cash activity by payment date. Net receipts retain signed deductions; discount and withholding components are shown for reconciliation and are not subtracted twice."},{"name":"cash_withholding_value","type":"NUMBER","nullable":true,"description":"Amazon-reported cash activity by payment date. Net receipts retain signed deductions; discount and withholding components are shown for reconciliation and are not subtracted twice."},{"name":"cash_line_count","type":"NUMBER","nullable":true,"description":"Amazon-reported cash activity by payment date. Net receipts retain signed deductions; discount and withholding components are shown for reconciliation and are not subtracted twice."},{"name":"cash_complete","type":"LOGIC","nullable":true,"description":"Amazon-reported cash activity by payment date. Net receipts retain signed deductions; discount and withholding components are shown for reconciliation and are not subtracted twice."},{"name":"cash_missing_reason","type":"TEXT","nullable":true,"description":"Amazon-reported cash activity by payment date. Net receipts retain signed deductions; discount and withholding components are shown for reconciliation and are not subtracted twice."},{"name":"invoice_allocations","type":"JSON","nullable":true,"description":"Scoped Amazon source identifier or document detail for filtering and drilldown. JSON details retain unresolved rows and source links."},{"name":"settled_invoice_count","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"partial_invoice_count","type":"NUMBER","nullable":true,"description":"Scoped Amazon source identifier or document detail for filtering and drilldown. JSON details retain unresolved rows and source links."},{"name":"unresolved_invoice_count","type":"NUMBER","nullable":true,"description":"Scoped Amazon source identifier or document detail for filtering and drilldown. JSON details retain unresolved rows and source links."},{"name":"uploaded_cogs_settled_invoice_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost for invoices whose final settlement is attributed to this row. Counted once, never allocated proportionally to installments."},{"name":"settled_invoice_revenue_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settled_invoice_margin_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settled_invoice_margin_percentage","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_complete","type":"LOGIC","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settlement_missing_reason","type":"TEXT","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"settled_invoice_ids","type":"JSON","nullable":true,"description":"DataDoe calculation. Current invoice settlement state across its complete payment history. Final margin is available only after identity, balance, tax and history reconciliation. Attributed once to the final event; reopening recomputes it. This differs from cash received during the period."},{"name":"invoice_coverage","type":"JSON","nullable":true,"description":"Scoped Amazon source identifier or document detail for filtering and drilldown. JSON details retain unresolved rows and source links."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon-reported payment-date cash activity and separate DataDoe settled-invoice margins. One row per scoped payment. Net receipts already include signed deductions; never subtract them twice. Invoice costs are inherited from the invoice date and counted once at its final settlement, never proportionally per payment. A period of settled-invoice margin includes those invoices complete payment histories and differs from cash received in that period. Invoice allocations, partial states and unresolved adjustments remain visible. Not complete net profit.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":30},{"type":"CONTINUOUS"}],"sources":["connections","raw_amazon_cogs","raw_sp_api_invoices","raw_sp_api_invoice_items","raw_sp_api_remittances","raw_sp_api_remittance_items"],"containsPii":false,"initialLoadProgress":null},{"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. ASIN-based sales tables prefer an explicit ASIN upload and can resolve SKU uploads through an unambiguous Vendor Listings mapping. Every 5 days DataDoe checks vendors with at least one vendor code row and emails organization owners when ASINs sold in the last 30 days have no vendor code. To list ASINs sold in the last 30 days without a vendor code, use GET /api/v1/vendor-codes/missing or the MCP tool vendor_codes_missing_list.","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":"uploaded_cogs_match_status","type":"TEXT","nullable":false,"description":"ASIN default match status. Variant-only costs require transaction identifiers and leave daily estimates incomplete."},{"name":"uploaded_cogs_unit_item_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost. Customer-maintained standard or average cost per reported ASIN unit. ASIN-day analytics currently use only the explicit ASIN default; variant-only costs require transaction context and leave coverage incomplete. Separate from Amazon-reported costs, procurement prices, shipped COGS and Net PPM. No pack, tax or currency conversion. Latest effective date on or before the report date applies. Backdated corrections change historical estimates. Item cost per unit."},{"name":"uploaded_cogs_unit_shipping_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost. Shipping cost per unit. Defaults to zero when omitted from an applicable upload."},{"name":"uploaded_cogs_unit_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost. Item plus shipping cost per unit, not a period total."},{"name":"uploaded_cogs_effective_from","type":"DATE","nullable":true,"description":"Start date of the applicable uploaded ASIN cost. Future rows do not affect earlier dates."},{"name":"uploaded_cogs_present","type":"LOGIC","nullable":false,"description":"True when an applicable uploaded ASIN cost exists. Explicit zero is present. Missing or conflicting costs are not present."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Currency of your uploaded product cost."},{"name":"cogs_present","type":"LOGIC","nullable":false,"description":"Compatibility alias of uploaded_cogs_present. New integrations use the explicit uploaded-cost fields."},{"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":"item_name","type":"TEXT","nullable":true,"description":"Listing title. Uses the listing item_name attribute, then the listing summary title, then the catalog product name."},{"name":"product_description","type":"TEXT","nullable":true,"description":"Listing description. Uses the listing product_description attribute, then the merchant listings report description when that report is joined, then the catalog product description. A+ content is not included."},{"name":"generic_keyword","type":"TEXT","nullable":true,"description":"Backend search terms from the listing generic_keyword attribute. The product catalog does not include this field. Null when Amazon omits it from the listing."},{"name":"bullet_point_1","type":"TEXT","nullable":true,"description":"First listing bullet. Uses the listing bullet_point attribute, then the catalog bullet. Only the first five bullets are stored."},{"name":"bullet_point_2","type":"TEXT","nullable":true,"description":"Second listing bullet. Uses the same sources as bullet_point_1."},{"name":"bullet_point_3","type":"TEXT","nullable":true,"description":"Third listing bullet. Uses the same sources as bullet_point_1."},{"name":"bullet_point_4","type":"TEXT","nullable":true,"description":"Fourth listing bullet. Uses the same sources as bullet_point_1."},{"name":"bullet_point_5","type":"TEXT","nullable":true,"description":"Fifth listing bullet. Uses the same sources as bullet_point_1."},{"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":"Compatibility field for your current uploaded ASIN item cost. Use uploaded_cogs_unit_item_value. Zero when missing; check uploaded_cogs_present."},{"name":"cogs_shipping_value","type":"NUMBER","nullable":true,"description":"Compatibility field for your current uploaded ASIN shipping cost. Use uploaded_cogs_unit_shipping_value."},{"name":"cogs_total_value","type":"NUMBER","nullable":true,"description":"cogs_item_value plus cogs_shipping_value."},{"name":"cogs_currency","type":"TEXT","nullable":true,"description":"Compatibility alias of uploaded_cogs_currency."},{"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. item_name, product_description, and bullet points use the listing when Amazon returns them, then the catalog.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_LISTINGS_CREATE","relation":"writes"},{"type":"AMAZON_LISTINGS_DELETE","relation":"writes"},{"type":"AMAZON_LISTINGS_UPDATE","relation":"writes"},{"type":"AMAZON_LISTINGS_DETAILS_UPDATE","relation":"writes"},{"type":"AMAZON_LISTINGS_CREATE_VERIFY","relation":"live"},{"type":"AMAZON_LISTINGS_UPDATE_VERIFY","relation":"live"},{"type":"AMAZON_LISTINGS_DETAILS_UPDATE_VERIFY","relation":"live"},{"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":"7f45dd2738d0b06f5fbcc26f2e6b11fb89d127f64fbddf100062cee837c86cca","name":"Vendor Product Replenishment Details","tableName":"amazon_vendor_product_details","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":"Child ASIN from Catalog Items for this vendor connection and marketplace."},{"name":"replenishment_category","type":"TEXT","nullable":true,"description":"Amazon replenishment category for this marketplace, such as OBSOLETE. Stored as Amazon sends it. Not a reorder flag and not Subscribe & Save eligibility."},{"name":"product_group","type":"TEXT","nullable":true,"description":"Amazon product group from vendor details."},{"name":"product_category_code","type":"TEXT","nullable":true,"description":"Amazon product category code from vendor details."},{"name":"product_category_name","type":"TEXT","nullable":true,"description":"Amazon display name for the vendor product category."},{"name":"product_subcategory_code","type":"TEXT","nullable":true,"description":"Amazon product subcategory code from vendor details."},{"name":"product_subcategory_name","type":"TEXT","nullable":true,"description":"Amazon display name for the vendor product subcategory."},{"name":"manufacturer_code","type":"TEXT","nullable":true,"description":"Manufacturer code from Amazon vendor catalog details. Not a vendor code uploaded in DataDoe."},{"name":"manufacturer_code_parent","type":"TEXT","nullable":true,"description":"Parent manufacturer code from Amazon vendor catalog details."},{"name":"brand_code","type":"TEXT","nullable":true,"description":"Brand code from Amazon vendor catalog details. Not a vendor code uploaded in DataDoe."},{"name":"vendor_details_available","type":"LOGIC","nullable":false,"description":"True when the latest successful catalog response included vendor details for this marketplace. False does not mean the ASIN is obsolete or that the connection lacks permission."},{"name":"last_seen_at","type":"DATE","nullable":false,"description":"When DataDoe last received a successful catalog item response for this ASIN on this connection."},{"name":"dt_created","type":"DATE","nullable":false,"description":"When DataDoe first stored this snapshot."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"When DataDoe last updated this snapshot from a successful catalog response."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Current Vendor Central replenishment category for each child ASIN, read with the vendor connection that owns the row. One row per organization, store, connection, marketplace, and child ASIN. DataDoe refreshes each ASIN about once a day. This is a current snapshot, not a daily history. replenishment_category is Amazon's category string. It is not a reorder recommendation and it is not Subscribe & Save eligibility. vendor_details_available is false when the latest successful response had no vendor details for this marketplace. A missing category does not mean the ASIN is obsolete. manufacturer_code and brand_code come from Amazon's vendor catalog. They are not vendor codes uploaded in DataDoe.","requiresDatePeriod":false,"issues":[],"prerequisites":"Vendor Central only. Seller Central connections do not have this table.","fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_sp_api_vendor_product_details"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["replenishment category","obsolete","vendor catalog"]},{"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 uploaded for this Vendor connection. ASIN-based tables prefer an ASIN upload. A SKU-only upload can match through Vendor Listings when the SKU maps to one ASIN and the inferred codes for that ASIN agree. Ambiguous matches stay null. Uploads label existing rows and do not identify stock location. To list ASINs sold in the last 30 days without a vendor code, use GET /api/v1/vendor-codes/missing or the MCP tool vendor_codes_missing_list."},{"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 the Amazon Vendor Forecasting report. Each request returns only the latest forecast. DataDoe stores each weekly fetch as a snapshot keyed by date (forecast generation date). Amazon forecasts week 0 through week 47 from that date, so each snapshot has 48 forward weeks (start_forecasting_date and end_forecasting_date). The same week can appear on later snapshots. 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","raw_sp_api_vendor_listings_items"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["customer demand","p70","weekly forecast"]},{"id":"ad00bc8aa232f64ebb758312067a28ea7343e51216b444af8be12d4553e2ffca","name":"Geo Sales by ASIN & Date","tableName":"amazon_vendor_geo_sales_by_asin_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":"Amazon reporting day for these shipped sales."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"vendor_view","type":"TEXT","nullable":false,"description":"SOURCING covers products sourced directly from this vendor. MANUFACTURING covers products manufactured by the vendor, regardless of who sourced them. Filter to one view before summing."},{"name":"customer_country_code","type":"TEXT","nullable":true,"description":"Customer shipment destination in ISO 3166-1 alpha-2 format from Amazon shipToCountryCode. Null when Amazon omits the country. Filter this column for customer-country sales. It is not the Amazon store or warehouse country."},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code uploaded for this Vendor connection. ASIN-based tables prefer an ASIN upload. A SKU-only upload can match through Vendor Listings when the SKU maps to one ASIN and the inferred codes for that ASIN agree. Ambiguous matches stay null. Uploads label existing rows and do not identify stock location. To list ASINs sold in the last 30 days without a vendor code, use GET /api/v1/vendor-codes/missing or the MCP tool vendor_codes_missing_list."},{"name":"shipped_units","type":"NUMBER","nullable":true,"description":"Units shipped to customers in this country for the selected Vendor view, ASIN and day. Shipped units are not ordered units. Included in the corresponding connection total."},{"name":"shipped_revenue","type":"NUMBER","nullable":true,"description":"Amazon customer revenue for shipped units in this country. Not the price Amazon paid the vendor. Sum only within the same currency and Vendor view."},{"name":"currency","type":"TEXT","nullable":true,"description":"ISO 4217 currency code for shipped_revenue."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily shipped sales by Vendor connection, view, child ASIN and customer country from Amazon Geo Sales. Shipped units are not ordered units. This dataset does not reproduce all-accounts, cross-marketplace Retail Analytics. Filter vendor_view to SOURCING or MANUFACTURING before summing. The views overlap and must not be added together. customer_country_code is the shipment destination. marketplace_country_code identifies the connection marketplace, not the customer or warehouse country. Use customer_country_code as a column filter for destination sales. Summing countries gives the same shipped sales already included in the equivalent connection totals, not additional sales. This table has no warehouse location, inventory or stock-by-store breakdown. Shipped revenue is Amazon customer revenue, not the vendor procurement price. Compare the same view, dates, metric and currency.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":720,"shiftDays":3},{"type":"RECURRING_DAILY","numberOfDays":7,"shiftDays":3}],"sources":["connections","raw_sp_api_dk_vendor_geo_sales","raw_amazon_vendor_codes","raw_sp_api_vendor_listings_items"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["geo sales","customer country","ship to country","shipment destination","cross-border sales"]},{"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 uploaded for this Vendor connection. ASIN-based tables prefer an ASIN upload. A SKU-only upload can match through Vendor Listings when the SKU maps to one ASIN and the inferred codes for that ASIN agree. Ambiguous matches stay null. Uploads label existing rows and do not identify stock location. To list ASINs sold in the last 30 days without a vendor code, use GET /api/v1/vendor-codes/missing or the MCP tool vendor_codes_missing_list."},{"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. Stored values can be above 1. 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. Stored values can be above 1. 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."},{"name":"uploaded_cogs_match_status","type":"TEXT","nullable":false,"description":"ASIN default match status. Variant-only costs require transaction identifiers and leave daily estimates incomplete."},{"name":"uploaded_cogs_unit_item_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost. Customer-maintained standard or average cost per reported ASIN unit. ASIN-day analytics currently use only the explicit ASIN default; variant-only costs require transaction context and leave coverage incomplete. Separate from Amazon-reported costs, procurement prices, shipped COGS and Net PPM. No pack, tax or currency conversion. Latest effective date on or before the report date applies. Backdated corrections change historical estimates. Item cost per unit."},{"name":"uploaded_cogs_unit_shipping_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost. Shipping cost per unit. Defaults to zero when omitted from an applicable upload."},{"name":"uploaded_cogs_unit_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost. Item plus shipping cost per unit, not a period total."},{"name":"uploaded_cogs_effective_from","type":"DATE","nullable":true,"description":"Start date of the applicable uploaded ASIN cost. Future rows do not affect earlier dates."},{"name":"uploaded_cogs_present","type":"LOGIC","nullable":false,"description":"True when an applicable uploaded ASIN cost exists. Explicit zero is present. Missing or conflicting costs are not present."},{"name":"uploaded_cogs_sourcing_retail_item_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_shipping_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Currency of your uploaded product cost. No FX conversion. Mixed currencies make the estimate incomplete."},{"name":"uploaded_cogs_sourcing_retail_complete","type":"LOGIC","nullable":false,"description":"True only with complete underlying daily cost history and currency, shipped units and shipped COGS consistent with the native Amazon Sourcing / Retail population. Missing days are not assumed to be zero."},{"name":"uploaded_cogs_sourcing_retail_units_with_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units with applicable uploaded product costs. This count does not prove complete daily history."},{"name":"uploaded_cogs_sourcing_retail_units_missing_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units without applicable uploaded product costs. Missing days are not counted as zero-cost or zero-unit days."},{"name":"manufacturing_business_customer_returns","type":"NUMBER","nullable":true,"description":"Manufacturing view. Units customers returned. DataDoe reads this from GET_VENDOR_SALES_REPORT with sellingProgram BUSINESS. It is not Retail Data Kiosk. This report has no traffic, inventory, Net PPM, or vendor co-op."},{"name":"manufacturing_business_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. DataDoe reads this from GET_VENDOR_SALES_REPORT with sellingProgram BUSINESS. It is not Retail Data Kiosk. This report has no traffic, inventory, Net PPM, or vendor co-op."},{"name":"manufacturing_business_shipped_cogs_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_business_shipped_revenue","type":"NUMBER","nullable":true,"description":"Manufacturing view. Amazon's customer revenue from shipped units, not the vendor's invoice to Amazon. DataDoe reads this from GET_VENDOR_SALES_REPORT with sellingProgram BUSINESS. It is not Retail Data Kiosk. This report has no traffic, inventory, Net PPM, or vendor co-op."},{"name":"manufacturing_business_shipped_revenue_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_business_shipped_units","type":"NUMBER","nullable":true,"description":"Manufacturing view. Units shipped to Amazon Business customers. Manufacturing and sourcing views overlap, so do not add the prefixes. DataDoe reads this from GET_VENDOR_SALES_REPORT with sellingProgram BUSINESS. It is not Retail Data Kiosk. This report has no traffic, inventory, Net PPM, or vendor co-op."},{"name":"manufacturing_business_ordered_revenue","type":"NUMBER","nullable":true,"description":"Revenue from units ordered by Amazon Business customers. Customer demand. Manufacturing Business view only. This is not purchase-order value."},{"name":"manufacturing_business_ordered_revenue_currency","type":"TEXT","nullable":true,"description":null},{"name":"manufacturing_business_ordered_units","type":"NUMBER","nullable":true,"description":"Units ordered by Amazon Business customers. Customer demand, with return and cancellation adjustments. Manufacturing Business view only. This is not an Amazon-to-vendor purchase order."},{"name":"sourcing_business_customer_returns","type":"NUMBER","nullable":true,"description":"Sourcing view. Units customers returned. DataDoe reads this from GET_VENDOR_SALES_REPORT with sellingProgram BUSINESS. It is not Retail Data Kiosk. This report has no traffic, inventory, Net PPM, or vendor co-op."},{"name":"sourcing_business_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. DataDoe reads this from GET_VENDOR_SALES_REPORT with sellingProgram BUSINESS. It is not Retail Data Kiosk. This report has no traffic, inventory, Net PPM, or vendor co-op."},{"name":"sourcing_business_shipped_cogs_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_business_shipped_revenue","type":"NUMBER","nullable":true,"description":"Sourcing view. Amazon's customer revenue from shipped units, not the vendor's invoice to Amazon. DataDoe reads this from GET_VENDOR_SALES_REPORT with sellingProgram BUSINESS. It is not Retail Data Kiosk. This report has no traffic, inventory, Net PPM, or vendor co-op."},{"name":"sourcing_business_shipped_revenue_currency","type":"TEXT","nullable":true,"description":null},{"name":"sourcing_business_shipped_units","type":"NUMBER","nullable":true,"description":"Sourcing view. Units shipped to Amazon Business customers. Manufacturing and sourcing views overlap, so do not add the prefixes. DataDoe reads this from GET_VENDOR_SALES_REPORT with sellingProgram BUSINESS. It is not Retail Data Kiosk. This report has no traffic, inventory, Net PPM, or vendor co-op."}],"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. For a monthly balance, use the latest available date in the month, then aggregate across ASINs if needed. Columns prefixed manufacturing_business_ and sourcing_business_ are Amazon Business selling-program sales on the same ASIN-day. They come from GET_VENDOR_SALES_REPORT, not Retail Data Kiosk. Manufacturing and sourcing Business views overlap and are not additive. Do not subtract Business from Retail. Shipped COGS is the price Amazon paid the vendor. Shipped revenue is Amazon's customer revenue. Ordered revenue and units are customer demand and exist only on the manufacturing Business view. Customer returns are units customers returned. The Business report has no traffic, inventory, Net PPM, or vendor co-op. Dates stay on Amazon's Pacific reporting date.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":720,"shiftDays":4},{"type":"RECURRING_DAILY","numberOfDays":14,"shiftDays":4}],"sources":["raw_amazon_cogs","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_sp_api_report_vendor_sales_manufacturing_business","raw_sp_api_report_vendor_sales_sourcing_business","raw_amazon_vendor_codes","raw_sp_api_vendor_listings_items"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["pos","vendor sales","vendor traffic","net ppm","glance views","amazon business"]},{"id":"4eaa8147bc12eb0c5dee6ae7d296991ad612366c4b687cfc9698f2222da0a376","name":"Sales, Traffic & Inventory by Date","tableName":"amazon_vendor_sales_traffic_and_inventory_by_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":"The day these catalog totals cover."},{"name":"period_end_date","type":"DATE","nullable":false,"description":"The same day as date. Daily catalog totals cover one day."},{"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. Stored values can be above 1. 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. Stored values can be above 1. 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."},{"name":"uploaded_cogs_sourcing_retail_item_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_shipping_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Currency of your uploaded product cost. No FX conversion. Mixed currencies make the estimate incomplete."},{"name":"uploaded_cogs_sourcing_retail_complete","type":"LOGIC","nullable":false,"description":"True only with complete underlying daily cost history and currency, shipped units and shipped COGS consistent with the native Amazon Sourcing / Retail population. Missing days are not assumed to be zero."},{"name":"uploaded_cogs_sourcing_retail_units_with_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units with applicable uploaded product costs. This count does not prove complete daily history."},{"name":"uploaded_cogs_sourcing_retail_units_missing_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units without applicable uploaded product costs. Missing days are not counted as zero-cost or zero-unit days."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily catalog totals for one Vendor connection and marketplace. Amazon returns one total for the catalog. It is not the sum of ASIN rows. Rates and averages, including net PPM, vendor confirmation rate, received fill rate, sell-through, Ultra Fast Track, sourceable replenishment out-of-stock, and lost Featured Offer, are Amazon figures for this period. Do not average or sum ASIN or daily rows to recreate them. Shipped COGS, shipped revenue, contra-COGS, and Net PPM measure Amazon retail economics, not the vendor's own product margin. Inventory and open purchase-order units are end-of-period snapshots and are not additive across periods. 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. Amazon returns daily inventory only for the current common date, so older daily inventory stays empty. Sales and traffic history is about two years.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":720,"shiftDays":3},{"type":"RECURRING_DAILY","numberOfDays":7,"shiftDays":3}],"sources":["raw_amazon_cogs","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_sp_api_report_vendor_sales_manufacturing_business","raw_sp_api_report_vendor_sales_sourcing_business","raw_amazon_vendor_codes","raw_sp_api_vendor_listings_items","connections","raw_sp_api_dk_vendor_analytics_manufacturing_totals","raw_sp_api_dk_vendor_analytics_sourcing_totals","raw_sp_api_dk_vendor_product_availability_manufacturing_totals","raw_sp_api_dk_vendor_product_availability_sourcing_totals"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["catalog total","vendor totals"]},{"id":"8991390d373226c66b05a77840a8ddf08798beaf5fc8da57dff4a731b946357b","name":"Sales, Traffic & Inventory by ASIN & Week","tableName":"amazon_vendor_sales_traffic_and_inventory_by_child_and_date_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":"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":"Sunday that starts this week."},{"name":"period_end_date","type":"DATE","nullable":false,"description":"Saturday that ends this week."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code uploaded for this Vendor connection. ASIN-based tables prefer an ASIN upload. A SKU-only upload can match through Vendor Listings when the SKU maps to one ASIN and the inferred codes for that ASIN agree. Ambiguous matches stay null. Uploads label existing rows and do not identify stock location. To list ASINs sold in the last 30 days without a vendor code, use GET /api/v1/vendor-codes/missing or the MCP tool vendor_codes_missing_list."},{"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. Stored values can be above 1. 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. Stored values can be above 1. 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."},{"name":"uploaded_cogs_sourcing_retail_item_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_shipping_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Currency of your uploaded product cost. No FX conversion. Mixed currencies make the estimate incomplete."},{"name":"uploaded_cogs_sourcing_retail_complete","type":"LOGIC","nullable":false,"description":"True only with complete underlying daily cost history and currency, shipped units and shipped COGS consistent with the native Amazon Sourcing / Retail population. Missing days are not assumed to be zero."},{"name":"uploaded_cogs_sourcing_retail_units_with_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units with applicable uploaded product costs. This count does not prove complete daily history."},{"name":"uploaded_cogs_sourcing_retail_units_missing_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units without applicable uploaded product costs. Missing days are not counted as zero-cost or zero-unit days."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Weekly sales, traffic, and inventory per child ASIN. Weeks start on Sunday and end on Saturday. Rates and averages, including net PPM, vendor confirmation rate, received fill rate, sell-through, Ultra Fast Track, sourceable replenishment out-of-stock, and lost Featured Offer, are Amazon figures for this period. Do not average or sum ASIN or daily rows to recreate them. Shipped COGS, shipped revenue, contra-COGS, and Net PPM measure Amazon retail economics, not the vendor's own product margin. Inventory and open purchase-order units are end-of-period snapshots and are not additive across periods. 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. Amazon returns inventory for the current week and the previous seven weeks. Older weekly inventory stays empty. Sales and traffic history is about two years. For a stock balance, use the latest week, then add ASINs if you need a catalog figure. Prefer the weekly catalog total when Amazon has already calculated it.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":728,"shiftDays":3},{"type":"RECURRING_WEEKLY","numberOfDays":14,"shiftDays":3}],"sources":["raw_amazon_cogs","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_sp_api_report_vendor_sales_manufacturing_business","raw_sp_api_report_vendor_sales_sourcing_business","raw_amazon_vendor_codes","raw_sp_api_vendor_listings_items","connections","raw_sp_api_dk_vendor_analytics_manufacturing_by_grain","raw_sp_api_dk_vendor_analytics_sourcing_by_grain","raw_sp_api_dk_vendor_product_availability_manufacturing_by_grain","raw_sp_api_dk_vendor_product_availability_sourcing_by_grain","raw_amazon_vendor_codes","raw_sp_api_vendor_listings_items"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["weekly vendor sales","vendor week"]},{"id":"bf4b048ab457d9109bf001ed1698f57fc831ee3359370d68b57ee61a46af4809","name":"Sales, Traffic & Inventory by Week","tableName":"amazon_vendor_sales_traffic_and_inventory_by_date_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":"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":"Sunday that starts this week."},{"name":"period_end_date","type":"DATE","nullable":false,"description":"Saturday that ends this week."},{"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. Stored values can be above 1. 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. Stored values can be above 1. 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."},{"name":"uploaded_cogs_sourcing_retail_item_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_shipping_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Currency of your uploaded product cost. No FX conversion. Mixed currencies make the estimate incomplete."},{"name":"uploaded_cogs_sourcing_retail_complete","type":"LOGIC","nullable":false,"description":"True only with complete underlying daily cost history and currency, shipped units and shipped COGS consistent with the native Amazon Sourcing / Retail population. Missing days are not assumed to be zero."},{"name":"uploaded_cogs_sourcing_retail_units_with_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units with applicable uploaded product costs. This count does not prove complete daily history."},{"name":"uploaded_cogs_sourcing_retail_units_missing_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units without applicable uploaded product costs. Missing days are not counted as zero-cost or zero-unit days."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Weekly catalog totals for one Vendor connection and marketplace. Weeks start on Sunday and end on Saturday. Amazon returns one total for the catalog. It is not the sum of ASIN rows. Rates and averages, including net PPM, vendor confirmation rate, received fill rate, sell-through, Ultra Fast Track, sourceable replenishment out-of-stock, and lost Featured Offer, are Amazon figures for this period. Do not average or sum ASIN or daily rows to recreate them. Shipped COGS, shipped revenue, contra-COGS, and Net PPM measure Amazon retail economics, not the vendor's own product margin. Inventory and open purchase-order units are end-of-period snapshots and are not additive across periods. 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. Amazon returns inventory for the current week and the previous seven weeks. Older weekly inventory stays empty. Sales and traffic history is about two years.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":728,"shiftDays":3},{"type":"RECURRING_WEEKLY","numberOfDays":14,"shiftDays":3}],"sources":["raw_amazon_cogs","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_sp_api_report_vendor_sales_manufacturing_business","raw_sp_api_report_vendor_sales_sourcing_business","raw_amazon_vendor_codes","raw_sp_api_vendor_listings_items","connections","raw_sp_api_dk_vendor_analytics_manufacturing_totals","raw_sp_api_dk_vendor_analytics_sourcing_totals","raw_sp_api_dk_vendor_product_availability_manufacturing_totals","raw_sp_api_dk_vendor_product_availability_sourcing_totals"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["weekly catalog total"]},{"id":"dafef7f138d5949db8559d4e87d7ca649ce2a5e6bdf60e64a0aa4452c6d7f399","name":"Sales, Traffic & Inventory by ASIN & Month","tableName":"amazon_vendor_sales_traffic_and_inventory_by_child_and_date_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":"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":"The first day of the month."},{"name":"period_end_date","type":"DATE","nullable":false,"description":"The last day of this month."},{"name":"child_asin","type":"TEXT","nullable":false,"description":null},{"name":"vendor_code","type":"TEXT","nullable":true,"description":"Vendor code uploaded for this Vendor connection. ASIN-based tables prefer an ASIN upload. A SKU-only upload can match through Vendor Listings when the SKU maps to one ASIN and the inferred codes for that ASIN agree. Ambiguous matches stay null. Uploads label existing rows and do not identify stock location. To list ASINs sold in the last 30 days without a vendor code, use GET /api/v1/vendor-codes/missing or the MCP tool vendor_codes_missing_list."},{"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. Stored values can be above 1. 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. Stored values can be above 1. 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."},{"name":"uploaded_cogs_sourcing_retail_item_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_shipping_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Currency of your uploaded product cost. No FX conversion. Mixed currencies make the estimate incomplete."},{"name":"uploaded_cogs_sourcing_retail_complete","type":"LOGIC","nullable":false,"description":"True only with complete underlying daily cost history and currency, shipped units and shipped COGS consistent with the native Amazon Sourcing / Retail population. Missing days are not assumed to be zero."},{"name":"uploaded_cogs_sourcing_retail_units_with_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units with applicable uploaded product costs. This count does not prove complete daily history."},{"name":"uploaded_cogs_sourcing_retail_units_missing_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units without applicable uploaded product costs. Missing days are not counted as zero-cost or zero-unit days."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Monthly sales, traffic, and inventory per child ASIN. Months start on day 1. Rates and averages, including net PPM, vendor confirmation rate, received fill rate, sell-through, Ultra Fast Track, sourceable replenishment out-of-stock, and lost Featured Offer, are Amazon figures for this period. Do not average or sum ASIN or daily rows to recreate them. Shipped COGS, shipped revenue, contra-COGS, and Net PPM measure Amazon retail economics, not the vendor's own product margin. Inventory and open purchase-order units are end-of-period snapshots and are not additive across periods. 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. Amazon returns inventory for the current month and the previous 23 months. Older monthly inventory stays empty. Sales and traffic history is about two years. For a stock balance, use the latest month, then add ASINs if you need a catalog figure. Prefer the monthly catalog total when Amazon has already calculated it.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":730,"shiftDays":3},{"type":"RECURRING_MONTHLY","numberOfDays":62,"shiftDays":3}],"sources":["raw_amazon_cogs","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_sp_api_report_vendor_sales_manufacturing_business","raw_sp_api_report_vendor_sales_sourcing_business","raw_amazon_vendor_codes","raw_sp_api_vendor_listings_items","connections","raw_sp_api_dk_vendor_analytics_manufacturing_by_grain","raw_sp_api_dk_vendor_analytics_sourcing_by_grain","raw_sp_api_dk_vendor_product_availability_manufacturing_by_grain","raw_sp_api_dk_vendor_product_availability_sourcing_by_grain","raw_amazon_vendor_codes","raw_sp_api_vendor_listings_items"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["monthly vendor sales"]},{"id":"116748ea87c652c96e708eda09e1f130cc63cacff32477089db98e07faf36c95","name":"Sales, Traffic & Inventory by Month","tableName":"amazon_vendor_sales_traffic_and_inventory_by_date_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":"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":"The first day of the month."},{"name":"period_end_date","type":"DATE","nullable":false,"description":"The last day of this month."},{"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. Stored values can be above 1. 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. Stored values can be above 1. 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."},{"name":"uploaded_cogs_sourcing_retail_item_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_shipping_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_sourcing_retail_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost estimate for Sourcing / Retail. Sum of daily shipped units times the uploaded cost effective on each day. NULL when daily coverage, currency or the shipment population cannot be reconciled with native Amazon totals. Not an Amazon-reported amount. Never apply a current unit cost to a whole period."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Currency of your uploaded product cost. No FX conversion. Mixed currencies make the estimate incomplete."},{"name":"uploaded_cogs_sourcing_retail_complete","type":"LOGIC","nullable":false,"description":"True only with complete underlying daily cost history and currency, shipped units and shipped COGS consistent with the native Amazon Sourcing / Retail population. Missing days are not assumed to be zero."},{"name":"uploaded_cogs_sourcing_retail_units_with_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units with applicable uploaded product costs. This count does not prove complete daily history."},{"name":"uploaded_cogs_sourcing_retail_units_missing_cost","type":"NUMBER","nullable":true,"description":"Observed daily Sourcing / Retail shipped units without applicable uploaded product costs. Missing days are not counted as zero-cost or zero-unit days."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Monthly catalog totals for one Vendor connection and marketplace. Months start on day 1. Amazon returns one total for the catalog. It is not the sum of ASIN rows. Rates and averages, including net PPM, vendor confirmation rate, received fill rate, sell-through, Ultra Fast Track, sourceable replenishment out-of-stock, and lost Featured Offer, are Amazon figures for this period. Do not average or sum ASIN or daily rows to recreate them. Shipped COGS, shipped revenue, contra-COGS, and Net PPM measure Amazon retail economics, not the vendor's own product margin. Inventory and open purchase-order units are end-of-period snapshots and are not additive across periods. 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. Amazon returns inventory for the current month and the previous 23 months. Older monthly inventory stays empty. Sales and traffic history is about two years.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":730,"shiftDays":3},{"type":"RECURRING_MONTHLY","numberOfDays":62,"shiftDays":3}],"sources":["raw_amazon_cogs","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_sp_api_report_vendor_sales_manufacturing_business","raw_sp_api_report_vendor_sales_sourcing_business","raw_amazon_vendor_codes","raw_sp_api_vendor_listings_items","connections","raw_sp_api_dk_vendor_analytics_manufacturing_totals","raw_sp_api_dk_vendor_analytics_sourcing_totals","raw_sp_api_dk_vendor_product_availability_manufacturing_totals","raw_sp_api_dk_vendor_product_availability_sourcing_totals"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["monthly catalog total"]},{"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 uploaded for this Vendor connection. ASIN-based tables prefer an ASIN upload. A SKU-only upload can match through Vendor Listings when the SKU maps to one ASIN and the inferred codes for that ASIN agree. Ambiguous matches stay null. Uploads label existing rows and do not identify stock location. To list ASINs sold in the last 30 days without a vendor code, use GET /api/v1/vendor-codes/missing or the MCP tool vendor_codes_missing_list."},{"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","raw_sp_api_vendor_listings_items"],"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 uploaded for this Vendor connection. ASIN-based tables prefer an ASIN upload. A SKU-only upload can match through Vendor Listings when the SKU maps to one ASIN and the inferred codes for that ASIN agree. Ambiguous matches stay null. Uploads label existing rows and do not identify stock location. To list ASINs sold in the last 30 days without a vendor code, use GET /api/v1/vendor-codes/missing or the MCP tool vendor_codes_missing_list."},{"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","raw_sp_api_vendor_listings_items"],"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 uploaded for this Vendor connection. ASIN-based tables prefer an ASIN upload. A SKU-only upload can match through Vendor Listings when the SKU maps to one ASIN and the inferred codes for that ASIN agree. Ambiguous matches stay null. Uploads label existing rows and do not identify stock location. To list ASINs sold in the last 30 days without a vendor code, use GET /api/v1/vendor-codes/missing or the MCP tool vendor_codes_missing_list."},{"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","raw_sp_api_vendor_listings_items"],"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":"uploaded_cogs_unit_item_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost per single ASIN item. Customer-maintained cost, separate from Amazon-reported wholesale prices, shipped COGS and Net PPM."},{"name":"uploaded_cogs_unit_shipping_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost per single ASIN item. Customer-maintained cost, separate from Amazon-reported wholesale prices, shipped COGS and Net PPM."},{"name":"uploaded_cogs_unit_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost per single ASIN item. Customer-maintained cost, separate from Amazon-reported wholesale prices, shipped COGS and Net PPM."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_effective_from","type":"DATE","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_present","type":"LOGIC","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_match_status","type":"TEXT","nullable":true,"description":"Your uploaded product cost. Reason an applicable cost or complete margin is unavailable. Missing identifiers and equally specific variants are unresolved."},{"name":"uploaded_cogs_vendor_code","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_fulfillment_method","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_purchase_order_number","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_calculation_date","type":"DATE","nullable":true,"description":"Your uploaded product cost selection date. PO date for projected margins; invoice issue date for invoice and settlement margins. Payment date never selects another cost."},{"name":"uploaded_cogs_quantity_unit","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_item_units","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_complete","type":"LOGIC","nullable":true,"description":"Your uploaded product cost coverage. True only when all relevant lines, units, currencies and source totals reconcile. Partial matched sums are not complete totals."},{"name":"uploaded_cogs_missing_reason","type":"TEXT","nullable":true,"description":"Your uploaded product cost. Reason an applicable cost or complete margin is unavailable. Missing identifiers and equally specific variants are unresolved."},{"name":"projected_product_revenue_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Projected product margin uses tax-exclusive wholesale revenue minus uploaded costs on the PO date. Cancelled orders are excluded. Not invoiced revenue, cash or complete net profit."},{"name":"projected_product_margin_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Projected product margin uses tax-exclusive wholesale revenue minus uploaded costs on the PO date. Cancelled orders are excluded. Not invoiced revenue, cash or complete net profit."},{"name":"projected_product_margin_percentage","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Projected product margin uses tax-exclusive wholesale revenue minus uploaded costs on the PO date. Cancelled orders are excluded. Not invoiced revenue, cash or complete net profit."},{"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 uploaded by ASIN for this Vendor connection. This table matches vendor codes by ASIN only. SKU-only uploads do not match. Uploads label existing rows and do not identify stock location. To list ASINs sold in the last 30 days without a vendor code, use GET /api/v1/vendor-codes/missing or the MCP tool vendor_codes_missing_list."},{"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":"Amazon-reported price to Amazon per item. This is not a line total and must not be assumed to equal net_price_amount × ordered_quantity."},{"name":"total_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"item_tax_amount","type":"NUMBER","nullable":true,"description":"Amazon-reported tax based on the Amazon retail list price. Do not subtract it from the tax-exclusive net price paid to the vendor."},{"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","raw_amazon_cogs"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["direct fulfillment","df orders"]},{"id":"bcafbe27c337d3772b8c71895ffda6d99b66dbcebf3ee93aa144987653e5a2f3","name":"Vendor Direct Fulfillment Shipping Labels","tableName":"amazon_vendor_df_shipping_labels","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":"UTC day of the label creation window start (createdAfter)."},{"name":"purchase_order_number","type":"TEXT","nullable":false,"description":"Amazon Direct Fulfillment purchase order number."},{"name":"selling_party_id","type":"TEXT","nullable":true,"description":"Vendor party id on the label."},{"name":"ship_from_party_id","type":"TEXT","nullable":true,"description":"Warehouse party id the label ships from."},{"name":"label_format","type":"TEXT","nullable":true,"description":"Label file format, PNG or ZPL. The file itself is not stored."},{"name":"package_identifier","type":"TEXT","nullable":false,"description":"Package id on the label. The first package is 001. Grain key with purchase_order_number."},{"name":"tracking_number","type":"TEXT","nullable":true,"description":"Carrier tracking number for this package."},{"name":"ship_method","type":"TEXT","nullable":true,"description":"Amazon ship method code for this package."},{"name":"ship_method_name","type":"TEXT","nullable":true,"description":"Ship method name for this package."},{"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 shipping label metadata. One row per package. No label file and no customer address. The label file is available from AMAZON_VENDOR_DF_SHIPPING_LABEL_GET.","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_shipping_labels"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["direct fulfillment labels","df shipping labels"]},{"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 details. One row per purchase order. Join amazon_vendor_df_orders on purchase_order_number. Personal fields, customer notes, gift messages, and customization URLs become NULL after 30 days from the order date. Historical rows, order identifiers, dates, and coarse geography remain available. 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":"vendor_code","type":"TEXT","nullable":true,"description":"Scoped Amazon source identifier or document detail for filtering and drilldown. JSON details retain unresolved rows and source links."},{"name":"net_cost_unit_of_measure","type":"TEXT","nullable":true,"description":"Amazon-reported price unit. EACH means a confirmed per-item price. Historical NULL or weight units cannot be treated as a per-item price."},{"name":"uploaded_cogs_unit_item_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost per single ASIN item. Customer-maintained cost, separate from Amazon-reported wholesale prices, shipped COGS and Net PPM."},{"name":"uploaded_cogs_unit_shipping_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost per single ASIN item. Customer-maintained cost, separate from Amazon-reported wholesale prices, shipped COGS and Net PPM."},{"name":"uploaded_cogs_unit_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost per single ASIN item. Customer-maintained cost, separate from Amazon-reported wholesale prices, shipped COGS and Net PPM."},{"name":"uploaded_cogs_currency","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_effective_from","type":"DATE","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_present","type":"LOGIC","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_match_status","type":"TEXT","nullable":true,"description":"Your uploaded product cost. Reason an applicable cost or complete margin is unavailable. Missing identifiers and equally specific variants are unresolved."},{"name":"uploaded_cogs_vendor_code","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_fulfillment_method","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_purchase_order_number","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_calculation_date","type":"DATE","nullable":true,"description":"Your uploaded product cost selection date. PO date for projected margins; invoice issue date for invoice and settlement margins. Payment date never selects another cost."},{"name":"uploaded_cogs_quantity_unit","type":"TEXT","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_item_units","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_total_value","type":"NUMBER","nullable":true,"description":"Your uploaded product cost matching and coverage. Costs use the full scoped variant and effective date. Unknown values remain NULL; backdated corrections restate estimates."},{"name":"uploaded_cogs_complete","type":"LOGIC","nullable":true,"description":"Your uploaded product cost coverage. True only when all relevant lines, units, currencies and source totals reconcile. Partial matched sums are not complete totals."},{"name":"uploaded_cogs_missing_reason","type":"TEXT","nullable":true,"description":"Your uploaded product cost. Reason an applicable cost or complete margin is unavailable. Missing identifiers and equally specific variants are unresolved."},{"name":"projected_product_revenue_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Projected product margin uses tax-exclusive wholesale revenue minus uploaded costs on the PO date. Cancelled orders are excluded. Not invoiced revenue, cash or complete net profit."},{"name":"projected_product_margin_value","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Projected product margin uses tax-exclusive wholesale revenue minus uploaded costs on the PO date. Cancelled orders are excluded. Not invoiced revenue, cash or complete net profit."},{"name":"projected_product_margin_percentage","type":"NUMBER","nullable":true,"description":"DataDoe calculation. Projected product margin uses tax-exclusive wholesale revenue minus uploaded costs on the PO date. Cancelled orders are excluded. Not invoiced revenue, cash or complete net profit."},{"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"}],"dataAvailability":{"type":"INTRADAY","description":"DataDoe checks for new and changed purchase orders every 2 hours. Availability depends on when Amazon provides the orders and on sync and export processing.","refreshAt":"Every 2 hours"},"sources":["connections","raw_sp_api_vendor_purchase_orders","raw_amazon_cogs","raw_sp_api_vendor_purchase_orders_status"],"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 uploaded by ASIN for this Vendor connection. This table matches vendor codes by ASIN only. SKU-only uploads do not match. Uploads label existing rows and do not identify stock location. To list ASINs sold in the last 30 days without a vendor code, use GET /api/v1/vendor-codes/missing or the MCP tool vendor_codes_missing_list."},{"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":"date","type":"DATE","nullable":false,"description":"Calendar day used for from/to filtering. Earliest Created status date from shipment_status_details, else earliest status date, else current_shipment_status_date, else last_seen_at. Always populated."},{"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":true,"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."},{"name":"ads_account_type","type":"TEXT","nullable":true,"description":"Amazon Ads profile account type: seller / vendor / agency. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"ads_account_subtype","type":"TEXT","nullable":true,"description":"Amazon Ads special account subtype, such as KDP_AUTHOR or AMAZON_ATTRIBUTION. Null for regular accounts and until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"is_kdp_author","type":"LOGIC","nullable":true,"description":"True for a Kindle Direct Publishing author account (ads_account_subtype KDP_AUTHOR), false for other captured profiles. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"ads_profile_currency_code","type":"TEXT","nullable":true,"description":"Currency of the Amazon Ads profile. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"ads_profile_timezone","type":"TEXT","nullable":true,"description":"IANA timezone of the Amazon Ads profile. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"amazon_ads_reporting_timezone","type":"TEXT","nullable":true,"description":"IANA timezone from the Amazon Ads profile, such as Europe/London. Null when it is not verified. Seller Central and Vendor Central rows are null. DSP rows use the agency Ads connection timezone, not a DSP advertiser timezone. There is no country or UTC fallback."},{"name":"amazon_ads_reporting_timezone_source","type":"TEXT","nullable":false,"description":"ADS_PROFILE when amazon_ads_reporting_timezone is verified. UNKNOWN when it is not."},{"name":"ads_billing_permission_missing_at","type":"DATE","nullable":true,"description":"When the last Ads Billing check for this connection was denied. Null when the last check succeeded, the connection is not Amazon Ads, or billing has not been checked. DSP advertiser rows are null."}],"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_ads_api_billing_access","raw_connection_dsp_advertisers"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["connection mapping","selling partner id","dsp advertiser","ads profile","billing permission"]},{"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. The advertised-product total, including other products and Display view-through sales, is ad_attributed_sales.","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_attributed_sales","type":"NUMBER","nullable":true,"description":"Sales attributed to this ad, including other products. Sponsored Products uses a 7-day click window. This is the Sales figure on Amazon's advertised-product report. Sponsored Display includes sales from clicks and views, so view-through sales are included. The value is null for Sponsored Brands. For Sponsored Products, ad_sales is only the same-SKU part. Do not add ad_sales to this column.","definition":"amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_PRODUCTS' ? raw_ads_api_report_advertised_products_sp.sales7d : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_DISPLAY' ? raw_ads_api_report_advertised_products_sd.sales : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_TELEVISION' ? null : null"},{"name":"ad_attributed_orders","type":"NUMBER","nullable":true,"description":"Orders attributed to this ad, including other products. Sponsored Products uses a 7-day click window. Sponsored Display includes orders from clicks and views, so view-through orders are included. The value is null for Sponsored Brands. For Sponsored Products, ad_orders is only the same-SKU part. Do not add ad_orders to this column.","definition":"amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_PRODUCTS' ? raw_ads_api_report_advertised_products_sp.purchases7d : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_DISPLAY' ? raw_ads_api_report_advertised_products_sd.purchases : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_TELEVISION' ? null : null"},{"name":"ad_attributed_units_sold","type":"NUMBER","nullable":true,"description":"Units attributed to this ad, including other products. Sponsored Products uses a 7-day click window. Sponsored Display includes units from clicks and views, so view-through units are included. The value is 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.unitsSoldClicks7d : amazon_ads_performance_by_child_asin_and_date.ad_campaign_type === 'SPONSORED_DISPLAY' ? raw_ads_api_report_advertised_products_sd.unitsSold : 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."},{"name":"book_metric_assignment_method","type":"TEXT","nullable":false,"description":"REPORTED when Amazon reports the metrics per ASIN (SPONSORED_PRODUCTS / SPONSORED_DISPLAY); ALLOCATED when SPONSORED_BRANDS campaign totals are split across ASINs (is_estimated = TRUE)."},{"name":"kindle_edition_normalized_pages_read_14d","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read by Kindle Unlimited readers within 14 days of an ad click. A page count, not money. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kindle_edition_normalized_pages_royalties_14d","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties for kindle_edition_normalized_pages_read_14d, in the Ads profile currency. Money, not pages. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kenp_per_click_14d","type":"NUMBER","nullable":true,"description":"KENP read per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_read_14d / ad_clicks"},{"name":"estimated_kenp_royalty_per_click_14d","type":"NUMBER","nullable":true,"description":"Estimated KENP royalties per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_royalties_14d / ad_clicks"},{"name":"ku_qualified_borrows","type":"NUMBER","nullable":true,"description":"Kindle Unlimited borrows Amazon counts as qualified, attributed to the ad. A count, not money. Sponsored Products only; null for other campaign types."},{"name":"estimated_ku_borrow_royalties","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties of ku_qualified_borrows. Money, not a count. Sponsored Products only; null for other campaign types."},{"name":"ad_add_to_list","type":"NUMBER","nullable":true,"description":"Times shoppers added the advertised product to a list, attributed to the ad. Sponsored Products only; null for other campaign types."}],"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. ad_sales and ad_orders are same-SKU click sales for Sponsored Products and promoted-product click sales for Sponsored Display. ad_attributed_sales, ad_attributed_orders and ad_attributed_units_sold are the advertised-product report totals, including other products. Sponsored Display totals include view-through sales. Display ad_units_sold_same_sku includes all click-attributed units. Brands ad_sales and ad_orders are estimated shares of campaign totals, including brand halo. Brands same-SKU columns, attributed 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":"Daily fetch starts at 2am and rereads 21 days. Intraday fetches start at 8am, 1pm and 4pm and reread 5 days. Times use the marketplace time zone. Data is available after processing and can change in later reports.","refreshAt":"2am, 8am, 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_ads_api_portfolios","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. The rule definition is budget_rule_id on amazon_ads_budget_rules. Amazon does not provide 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. The definition is on amazon_ads_budget_rules. This report value is read-only and does not change the rule.","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."},{"name":"kindle_edition_normalized_pages_read_14d","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read by Kindle Unlimited readers within 14 days of an ad click. A page count, not money. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kindle_edition_normalized_pages_royalties_14d","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties for kindle_edition_normalized_pages_read_14d, in the Ads profile currency. Money, not pages. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kenp_per_click_14d","type":"NUMBER","nullable":true,"description":"KENP read per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_read_14d / ad_clicks"},{"name":"estimated_kenp_royalty_per_click_14d","type":"NUMBER","nullable":true,"description":"Estimated KENP royalties per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_royalties_14d / ad_clicks"},{"name":"ku_qualified_borrows","type":"NUMBER","nullable":true,"description":"Kindle Unlimited borrows Amazon counts as qualified, attributed to the ad. A count, not money. Sponsored Products only; null for other campaign types."},{"name":"estimated_ku_borrow_royalties","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties of ku_qualified_borrows. Money, not a count. Sponsored Products only; null for other campaign types."},{"name":"ad_add_to_list","type":"NUMBER","nullable":true,"description":"Times shoppers added the advertised product to a list, attributed to the ad. Sponsored Products only; null for other campaign types."}],"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":"Daily fetch starts at 2am and rereads 21 days. Intraday fetches start at 8am, 1pm and 4pm and reread 5 days. Times use the marketplace time zone. Data is available after processing and can change in later reports.","refreshAt":"2am, 8am, 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."},{"name":"kindle_edition_normalized_pages_read","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read, attributed to the ad. A page count, not money. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"kindle_edition_normalized_pages_read_from_clicks","type":"NUMBER","nullable":true,"description":"Part of kindle_edition_normalized_pages_read attributed to ad clicks. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"kindle_edition_normalized_pages_read_from_views","type":"NUMBER","nullable":true,"description":"Part of kindle_edition_normalized_pages_read attributed to ad views. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_new_subscribe_and_save","type":"NUMBER","nullable":false,"description":"New Subscribe & Save subscriptions (DSP totalSubscribeAndSave). Promoted ASINs plus brand halo (non-promoted ASINs of the same brands). Amazon DSP 14-day attribution after an ad view or click. Counts the first subscription for a product. Later replenishment orders are not included."},{"name":"ad_new_subscribe_and_save_promoted","type":"NUMBER","nullable":false,"description":"New Subscribe & Save subscriptions (DSP newSubscribeAndSave), the New Subscribe & Save metric in the Amazon DSP console. Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click. Counts the first subscription for a product. Later replenishment orders are not included."}],"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","subscribe and save","new subscribe and save"]},{"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":"book_title","type":"TEXT","nullable":true,"description":"Latest book title from amazon_ads_book_catalog for this ASIN. Null when the catalog has no title."},{"name":"book_format","type":"TEXT","nullable":true,"description":"Edition format from the latest uploaded KDP royalty parameters of this ASIN: EBOOK / PAPERBACK / HARDCOVER / AUDIOBOOK. Latest upload, not effective for the row date. Null without royalty parameters."},{"name":"book_work_id","type":"TEXT","nullable":true,"description":"User-defined work ID that groups the editions of one book, from the latest uploaded KDP royalty parameters of this ASIN. Null without royalty parameters."},{"name":"book_metadata_source","type":"TEXT","nullable":true,"description":"USER when uploaded KDP royalty parameters supply book_format or book_work_id; API_METADATA when only the catalog title matched; null when neither matched."},{"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."},{"name":"ad_new_subscribe_and_save","type":"NUMBER","nullable":false,"description":"New Subscribe & Save subscriptions of this ASIN within dsp_conversion_type (DSP totalSubscribeAndSave). Counts the first subscription for a product. Later replenishment orders are not included. Sum PROMOTED and BRAND_HALO rows for the brand total. 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","raw_ads_api_product_metadata","raw_amazon_kdp_royalty_parameters"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","dsp product","dsp brand halo","subscribe and save","new subscribe and save"]},{"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."},{"name":"kindle_edition_normalized_pages_read","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read, attributed to the ad. A page count, not money. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"kindle_edition_normalized_pages_read_from_clicks","type":"NUMBER","nullable":true,"description":"Part of kindle_edition_normalized_pages_read attributed to ad clicks. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"kindle_edition_normalized_pages_read_from_views","type":"NUMBER","nullable":true,"description":"Part of kindle_edition_normalized_pages_read attributed to ad views. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_kindle_detail_page_views","type":"NUMBER","nullable":true,"description":"Attributed Kindle detail page views (DSP kindleDetailPageView). Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_kindle_detail_page_views_from_clicks","type":"NUMBER","nullable":true,"description":"Part of ad_kindle_detail_page_views attributed to ad clicks. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_kindle_detail_page_views_from_views","type":"NUMBER","nullable":true,"description":"Part of ad_kindle_detail_page_views attributed to ad views. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."}],"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. marketplace_country_code and marketplace_country_name describe the marketplace of the seller or vendor, not where the ad was delivered; use amazon_ads_dsp_performance_by_country_by_date for the delivery 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":"348b551df32f38c7cfe62fad7b8e43aeed0261294e5311a2495359854cfbd603","name":"DSP Performance by Country & Date","tableName":"amazon_ads_dsp_performance_by_country_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":"country","type":"TEXT","nullable":true,"description":"Country where the ad was delivered, as an English country name reported by Amazon DSP (for example Australia or Viet Nam), not an ISO code. Unallocated or null when Amazon could not attribute the country."},{"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."},{"name":"kindle_edition_normalized_pages_read","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read, attributed to the ad. A page count, not money. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"kindle_edition_normalized_pages_read_from_clicks","type":"NUMBER","nullable":true,"description":"Part of kindle_edition_normalized_pages_read attributed to ad clicks. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"kindle_edition_normalized_pages_read_from_views","type":"NUMBER","nullable":true,"description":"Part of kindle_edition_normalized_pages_read attributed to ad views. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_kindle_detail_page_views","type":"NUMBER","nullable":true,"description":"Attributed Kindle detail page views (DSP kindleDetailPageView). Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_kindle_detail_page_views_from_clicks","type":"NUMBER","nullable":true,"description":"Part of ad_kindle_detail_page_views attributed to ad clicks. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_kindle_detail_page_views_from_views","type":"NUMBER","nullable":true,"description":"Part of ad_kindle_detail_page_views attributed to ad views. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP performance per advertiser, date, order, line item, and delivery country. 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. country is where the ad was delivered and can differ from marketplace_country_code, the marketplace of the seller or vendor; filter on country to find line items that deliver outside their marketplace. Country and city rows break down the same delivery, so never add them together.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":95},{"type":"RECURRING_DAILY","numberOfDays":28},{"type":"RECURRING_MONTHLY","numberOfDays":56}],"sources":["connections","raw_ads_api_report_geo_country_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","dsp geo","dsp country","delivery country"]},{"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."},{"name":"ad_kindle_detail_page_views","type":"NUMBER","nullable":true,"description":"Attributed Kindle detail page views (DSP kindleDetailPageView). Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_kindle_detail_page_views_from_clicks","type":"NUMBER","nullable":true,"description":"Part of ad_kindle_detail_page_views attributed to ad clicks. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_kindle_detail_page_views_from_views","type":"NUMBER","nullable":true,"description":"Part of ad_kindle_detail_page_views attributed to ad views. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."}],"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."},{"name":"kindle_edition_normalized_pages_read","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read, attributed to the ad. A page count, not money. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"kindle_edition_normalized_pages_read_from_clicks","type":"NUMBER","nullable":true,"description":"Part of kindle_edition_normalized_pages_read attributed to ad clicks. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"kindle_edition_normalized_pages_read_from_views","type":"NUMBER","nullable":true,"description":"Part of kindle_edition_normalized_pages_read attributed to ad views. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_kindle_detail_page_views","type":"NUMBER","nullable":true,"description":"Attributed Kindle detail page views (DSP kindleDetailPageView). Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_kindle_detail_page_views_from_clicks","type":"NUMBER","nullable":true,"description":"Part of ad_kindle_detail_page_views attributed to ad clicks. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"ad_kindle_detail_page_views_from_views","type":"NUMBER","nullable":true,"description":"Part of ad_kindle_detail_page_views attributed to ad views. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."}],"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."},{"name":"kindle_edition_normalized_pages_read","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read, attributed to the ad. A page count, not money. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"kindle_edition_normalized_pages_read_from_clicks","type":"NUMBER","nullable":true,"description":"Part of kindle_edition_normalized_pages_read attributed to ad clicks. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."},{"name":"kindle_edition_normalized_pages_read_from_views","type":"NUMBER","nullable":true,"description":"Part of kindle_edition_normalized_pages_read attributed to ad views. Amazon DSP reports no attribution window for Kindle metrics. Null when the report has no value."}],"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":"135d3293a4d487d57c895305380af6259a3e7bceec0e727ddc27ea7348c1ef28","name":"DSP Performance by Inventory & Date","tableName":"amazon_ads_dsp_performance_by_inventory_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":"amazon_ads_account_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser account id (advertiserAccount.id) used to request the report. The numeric DSP advertiser id is dsp_advertiser_id."},{"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_site_or_app","type":"TEXT","nullable":true,"description":"Site or app where the ad ran (siteApp). Amazon does not classify the value as an app or a site. Null when Amazon omits it."},{"name":"dsp_supply_source","type":"TEXT","nullable":true,"description":"Supply source (inventory exchange or publisher) as reported by Amazon DSP. Null when Amazon omits it."},{"name":"dsp_deal_id","type":"TEXT","nullable":true,"description":"Amazon DSP deal id. Null when the row has no deal. Unallocated when Amazon reports that label."},{"name":"dsp_deal_name","type":"TEXT","nullable":true,"description":"Amazon DSP deal name. Null when the row has no deal. Unallocated when Amazon reports that label."},{"name":"ad_currency","type":"TEXT","nullable":true,"description":"Currency of the monetary metrics (budgetCurrency). Do not add monetary values across currencies."},{"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_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_measurable_impressions","type":"NUMBER","nullable":false,"description":"Impressions Amazon could measure for viewability (metric.measurableImpressions)."},{"name":"ad_clicks","type":"NUMBER","nullable":false,"description":"Amazon DSP click-throughs after Amazon removed invalid traffic."},{"name":"ad_detail_page_views","type":"NUMBER","nullable":false,"description":"Attributed detail page views (metric.detailPageViews). 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 (metric.detailPageViewsPromoted). 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 (metric.addToCart). 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 (metric.addToCartPromoted). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_orders","type":"NUMBER","nullable":false,"description":"Attributed purchases (metric.purchases). 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 (metric.purchasesPromoted). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":"Attributed sales (metric.sales). 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 (metric.salesPromoted). Promoted ASINs of the line item only, excluding brand halo. Amazon DSP 14-day attribution after an ad view or click. In ad_currency."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon DSP inventory performance per advertiser, date, order, line item, site or app, supply source, deal, and currency. 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. The table stays off until the Organization turns it on. Once enabled, it uses the DSP advertiser ID configured on each Seller or Vendor. No separate advertiser or connection selection is needed. Each Amazon request is one day and one DSP order. The first fetch covers 56 days, a daily refresh covers 14 days, and a monthly refresh covers 56 days so Amazon can restate conversions. ad_currency is budgetCurrency. Do not add monetary values across currencies. Site, supply source, and deal stay null when Amazon omits them, and deal can be Unallocated. There is no app or site classification. ad_sales, ad_orders, ad_detail_page_views, and ad_add_to_cart come from metric.sales, metric.purchases, metric.detailPageViews, and metric.addToCart and are the intended promoted-plus-halo totals. Columns ending in _promoted come from the matching Promoted fields. Amazon DSP 14-day attribution after an ad view or click.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":56},{"type":"RECURRING_DAILY","numberOfDays":14},{"type":"RECURRING_MONTHLY","numberOfDays":56}],"sources":["connections","raw_ads_api_report_inventory_detail_dsp"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dsp","amazon dsp","dsp inventory","site","app","deal","line item"]},{"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":"e6921915580ae22f578b770e3b237090e05bcc48f8ac40a347932634f76eff9b","name":"Ads Performance Benchmarks","tableName":"amazon_ads_performance_benchmarks","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":"period_type","type":"TEXT","nullable":false,"description":"Amazon period grain: DAILY, WEEKLY, or MONTHLY. Weekly and monthly rows use Amazon's own period. Do not build them by averaging daily rows."},{"name":"period_start","type":"DATE","nullable":false,"description":"First day of the period Amazon returned. For a daily row this is that date."},{"name":"period_end","type":"DATE","nullable":false,"description":"Last day of the period Amazon returned. For a daily row this is the same date as period_start."},{"name":"campaign_country","type":"TEXT","nullable":true,"description":"Country of the campaign, as returned by Amazon."},{"name":"brand","type":"TEXT","nullable":true,"description":"Brand name, as returned by Amazon. There is no stable brand id."},{"name":"browse_category","type":"TEXT","nullable":true,"description":"Browse category, as returned by Amazon. There is no stable category id."},{"name":"ad_product","type":"TEXT","nullable":true,"description":"Ad product on this row, such as Sponsored Products. The report request asks for all Sponsored Ads products together. This is not Amazon DSP."},{"name":"ad_format","type":"TEXT","nullable":true,"description":"Ad format, as returned by Amazon."},{"name":"campaign_goal","type":"TEXT","nullable":true,"description":"Campaign goal, as returned by Amazon."},{"name":"peer_set_size","type":"TEXT","nullable":true,"description":"Amazon returns this as text, for example \"5-10\". DataDoe stores that text. Empty when Amazon omits it. Do not sum or average it."},{"name":"currency_code","type":"TEXT","nullable":true,"description":"Currency of the money measures, as returned by Amazon."},{"name":"source_report_id","type":"TEXT","nullable":false,"description":"DataDoe id of the completed report that stored this row."},{"name":"synced_at","type":"DATE","nullable":false,"description":"When DataDoe stored this row from a completed report."},{"name":"percent_of_purchases_new_to_brand","type":"NUMBER","nullable":true,"description":"This brand's percent of purchases new to brand for the period. This is the brand's own value, not a peer percentile. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"percent_of_purchases_new_to_brand_p25","type":"NUMBER","nullable":true,"description":"25th percentile of percent of purchases new to brand among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"percent_of_purchases_new_to_brand_p50","type":"NUMBER","nullable":true,"description":"Median percent of purchases new to brand among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"percent_of_purchases_new_to_brand_p75","type":"NUMBER","nullable":true,"description":"75th percentile of percent of purchases new to brand among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"new_to_brand_purchase_rate","type":"NUMBER","nullable":true,"description":"This brand's new-to-brand purchase rate for the period. This is the brand's own value, not a peer percentile. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"new_to_brand_purchase_rate_p25","type":"NUMBER","nullable":true,"description":"25th percentile of new-to-brand purchase rate among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"new_to_brand_purchase_rate_p50","type":"NUMBER","nullable":true,"description":"Median new-to-brand purchase rate among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"new_to_brand_purchase_rate_p75","type":"NUMBER","nullable":true,"description":"75th percentile of new-to-brand purchase rate among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"ctr","type":"NUMBER","nullable":true,"description":"This brand's click-through rate for the period. This is the brand's own value, not a peer percentile. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"ctr_p25","type":"NUMBER","nullable":true,"description":"25th percentile of click-through rate among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"ctr_p50","type":"NUMBER","nullable":true,"description":"Median click-through rate among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"ctr_p75","type":"NUMBER","nullable":true,"description":"75th percentile of click-through rate among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"completion_rate_video_ad","type":"NUMBER","nullable":true,"description":"This brand's video ad completion rate for the period. This is the brand's own value, not a peer percentile. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"completion_rate_video_ad_p25","type":"NUMBER","nullable":true,"description":"25th percentile of video ad completion rate among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"completion_rate_video_ad_p50","type":"NUMBER","nullable":true,"description":"Median video ad completion rate among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"completion_rate_video_ad_p75","type":"NUMBER","nullable":true,"description":"75th percentile of video ad completion rate among the category peers. This is not the brand's own value. Amazon does not document whether this is a 0 to 1 ratio or a 0 to 100 percentage. DataDoe does not rescale it. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cost_per_new_to_brand_purchase","type":"NUMBER","nullable":true,"description":"This brand's cost per new-to-brand purchase for the period. This is the brand's own value, not a peer percentile. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cost_per_new_to_brand_purchase_p25","type":"NUMBER","nullable":true,"description":"25th percentile of cost per new-to-brand purchase among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cost_per_new_to_brand_purchase_p50","type":"NUMBER","nullable":true,"description":"Median cost per new-to-brand purchase among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cost_per_new_to_brand_purchase_p75","type":"NUMBER","nullable":true,"description":"75th percentile of cost per new-to-brand purchase among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cpc","type":"NUMBER","nullable":true,"description":"This brand's cost per click for the period. This is the brand's own value, not a peer percentile. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cpc_p25","type":"NUMBER","nullable":true,"description":"25th percentile of cost per click among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cpc_p50","type":"NUMBER","nullable":true,"description":"Median cost per click among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cpc_p75","type":"NUMBER","nullable":true,"description":"75th percentile of cost per click among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cpm","type":"NUMBER","nullable":true,"description":"This brand's cost per thousand impressions for the period. This is the brand's own value, not a peer percentile. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cpm_p25","type":"NUMBER","nullable":true,"description":"25th percentile of cost per thousand impressions among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cpm_p50","type":"NUMBER","nullable":true,"description":"Median cost per thousand impressions among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cpm_p75","type":"NUMBER","nullable":true,"description":"75th percentile of cost per thousand impressions among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cost_per_completed_view_video_ad","type":"NUMBER","nullable":true,"description":"This brand's cost per completed video view for the period. This is the brand's own value, not a peer percentile. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cost_per_completed_view_video_ad_p25","type":"NUMBER","nullable":true,"description":"25th percentile of cost per completed video view among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cost_per_completed_view_video_ad_p50","type":"NUMBER","nullable":true,"description":"Median cost per completed video view among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."},{"name":"cost_per_completed_view_video_ad_p75","type":"NUMBER","nullable":true,"description":"75th percentile of cost per completed video view among the category peers. This is not the brand's own value. Amount in currency_code. DataDoe keeps Amazon's decimal and does not convert currency. Not additive. Empty when Amazon omits or suppresses the value. A missing value is not zero."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Sponsored Ads category benchmarks. One row compares a brand in a browse category with peer percentiles for one ad product, ad format, campaign goal, currency, and Amazon period. This is not Brand Metrics and not Amazon DSP. Amazon updates the figures about every 48 hours. DataDoe refreshes the latest 30 completed days, 4 completed weeks, and 2 completed months every 2 days. That refresh is a DataDoe choice, not an Amazon guarantee. The earliest period is the earliest one Amazon returned for the account. The account must represent the brand. Rates and percentiles are not additive. Do not average daily percentiles into a week or month.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":456},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_ads_api_report_cross_program_benchmarks"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["category benchmark","peer percentile","cross program benchmarks","sponsored ads benchmark"]},{"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},{"name":"estimated_kenp_royalty_per_external_click","type":"NUMBER","nullable":true,"description":"Estimated 14-day KENP royalties per click on the off-Amazon tagged link. Not earnings per reader. Null when click_throughs are zero or unknown.","definition":"kindle_edition_normalized_pages_royalties_14d / click_throughs"}],"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":[],"relatedActions":[{"type":"AMAZON_ADS_ATTRIBUTION_REPORTS_FIND","relation":"live"}],"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},{"name":"estimated_kenp_royalty_per_external_click","type":"NUMBER","nullable":true,"description":"Estimated 14-day KENP royalties per click on the off-Amazon tagged link. Not earnings per reader. Null when click_throughs are zero or unknown.","definition":"kindle_edition_normalized_pages_royalties_14d / click_throughs"}],"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":[],"relatedActions":[{"type":"AMAZON_ADS_ATTRIBUTION_REPORTS_FIND","relation":"live"}],"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":[],"relatedActions":[{"type":"AMAZON_ADS_ATTRIBUTION_REPORTS_FIND","relation":"live"}],"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."},{"name":"kindle_edition_normalized_pages_read_14d","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read by Kindle Unlimited readers within 14 days of an ad click. A page count, not money. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kindle_edition_normalized_pages_royalties_14d","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties for kindle_edition_normalized_pages_read_14d, in the Ads profile currency. Money, not pages. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kenp_per_click_14d","type":"NUMBER","nullable":true,"description":"KENP read per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_read_14d / ad_clicks"},{"name":"estimated_kenp_royalty_per_click_14d","type":"NUMBER","nullable":true,"description":"Estimated KENP royalties per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_royalties_14d / ad_clicks"},{"name":"ku_qualified_borrows","type":"NUMBER","nullable":true,"description":"Kindle Unlimited borrows Amazon counts as qualified, attributed to the ad. A count, not money. Sponsored Products and Sponsored Display; null for Sponsored Brands and Sponsored Television."},{"name":"estimated_ku_borrow_royalties","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties of ku_qualified_borrows. Money, not a count. Sponsored Products and Sponsored Display; null for Sponsored Brands and Sponsored Television."},{"name":"ad_add_to_list","type":"NUMBER","nullable":true,"description":"Times shoppers added the advertised product to a list, attributed to the ad. Sponsored Products and Sponsored Display; null for Sponsored Brands and Sponsored Television."},{"name":"ku_qualified_borrows_from_clicks","type":"NUMBER","nullable":true,"description":"Part of ku_qualified_borrows attributed to ad clicks. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"ku_qualified_borrows_from_views","type":"NUMBER","nullable":true,"description":"Part of ku_qualified_borrows attributed to ad views. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"estimated_ku_borrow_royalties_from_clicks","type":"NUMBER","nullable":true,"description":"Part of estimated_ku_borrow_royalties attributed to ad clicks. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"estimated_ku_borrow_royalties_from_views","type":"NUMBER","nullable":true,"description":"Part of estimated_ku_borrow_royalties attributed to ad views. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"ad_add_to_list_from_clicks","type":"NUMBER","nullable":true,"description":"Part of ad_add_to_list attributed to ad clicks. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"ad_add_to_list_from_views","type":"NUMBER","nullable":true,"description":"Part of ad_add_to_list attributed to ad views. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Target performance by target and date. Sponsored Products includes keywords and product targets. Sponsored Brands includes product targets and broad, phrase and exact keywords. Keyword rows appear after the keyword report is collected. The first keyword load covers the latest 30 completed days. Keyword refreshes run every two days and replace the latest 14 completed days. Keyword rows have no monthly refresh. The table refresh periods apply to the other campaign types. The keyword report does not cover every Sponsored Brands campaign. A global Ads account keeps keyword rows for the connection marketplace only. Campaign status and budget on keyword rows come from the Sponsored Brands campaign report for the same connection, date and campaign. Sponsored Display includes product, category, and remarketing targets such as views and purchases. Display ad_match_type is blank, Amazon audience segments are not included, and Display spend and impressions can be lower than the campaign table for the same campaign. Sponsored Television is included. ad_keyword is the target. The shopper query 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}],"dataAvailability":{"type":"INTRADAY","description":"Sponsored Products, Sponsored Brands product targets, and Sponsored Display refresh once a day at 2am in the marketplace time zone. Sponsored Brands keyword reports refresh every two days. Sponsored Television targeting also refreshes at 8am, 1pm, and 4pm. Data is available after processing and can change in a later report.","refreshAt":"2am"},"sources":["connections","raw_ads_api_report_keywords_sb","raw_ads_api_report_legacy_campaign_sb_all","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","raw_ads_api_portfolios"],"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."},{"name":"kindle_edition_normalized_pages_read_14d","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read by Kindle Unlimited readers within 14 days of an ad click. A page count, not money. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kindle_edition_normalized_pages_royalties_14d","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties for kindle_edition_normalized_pages_read_14d, in the Ads profile currency. Money, not pages. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kenp_per_click_14d","type":"NUMBER","nullable":true,"description":"KENP read per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_read_14d / ad_clicks"},{"name":"estimated_kenp_royalty_per_click_14d","type":"NUMBER","nullable":true,"description":"Estimated KENP royalties per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_royalties_14d / ad_clicks"},{"name":"ku_qualified_borrows","type":"NUMBER","nullable":true,"description":"Kindle Unlimited borrows Amazon counts as qualified, attributed to the ad. A count, not money. Sponsored Products only; null for other campaign types."},{"name":"estimated_ku_borrow_royalties","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties of ku_qualified_borrows. Money, not a count. Sponsored Products only; null for other campaign types."},{"name":"ad_add_to_list","type":"NUMBER","nullable":true,"description":"Times shoppers added the advertised product to a list, attributed to the ad. Sponsored Products only; null for other campaign types."}],"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","raw_ads_api_portfolios"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["search term report","customer query"]},{"id":"6d049f13217b7ccb19df053b6623f79e1b447b3a95ea13c35afb3725e40e6e9d","name":"Search Term Impression Share","tableName":"amazon_ads_search_term_impression_share_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":"Amazon's reporting date in the advertiser account's Ads reporting time zone. Today is not included. The marketplace time zone is used only when the reporting time zone is not stored."},{"name":"advertiser_account_id","type":"TEXT","nullable":false,"description":"Amazon Ads advertiser account id (advertiserAccount.id). Not the numeric Ads profile id."},{"name":"ad_product","type":"TEXT","nullable":false,"description":"Sponsored Products or Sponsored Brands, using Amazon's report label. A missing product is not 0% share."},{"name":"search_term","type":"TEXT","nullable":false,"description":"Customer search term exactly as Amazon reported it. Not a keyword, target, or campaign."},{"name":"search_term_occurrence","type":"NUMBER","nullable":false,"description":"Number of this row among the rows Amazon returned for the same search term and date of the advertiser account, from 1. Rows are ordered by the best rank, then the higher share. The marketplace of each row is unknown."},{"name":"search_term_occurrences","type":"NUMBER","nullable":false,"description":"How many rows Amazon returned for this search term and date of the advertiser account. Above 1 means the term ran in several marketplaces of a global account."},{"name":"is_account_primary_copy","type":"LOGIC","nullable":false,"description":"TRUE for the copy of one Ads connection per advertiser account, ad product, and date, chosen across the whole Organization (the latest import, then the lowest connection ID). Every connection of the account holds the same rows. Filter TRUE only to count the account once across all sellers and vendors of the Organization. Do not filter on it for one seller or vendor or a subset of them: the TRUE copy can belong to a connection outside the selection, and the account would then have no rows."},{"name":"impression_share","type":"NUMBER","nullable":true,"description":"Search impression share for this account, ad product, search term, date, and occurrence. A percentage from 0% to 100%, not a ratio from 0 to 1. Null when Amazon omits it. Do not add shares across rows. Not ad_top_of_search_impression_share."},{"name":"impression_share_rank","type":"NUMBER","nullable":true,"description":"Search impression share rank for this account, ad product, search term, date, and occurrence. A positive whole number when Amazon sends it. Null when Amazon omits it. Do not average ranks across rows."},{"name":"synced_at","type":"DATE","nullable":false,"description":"When DataDoe stored this completed report slice."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily account-wide search impression share and rank for Sponsored Products and Sponsored Brands. One row is one Ads connection, advertiser account, ad product, search term, date, and occurrence. A global advertiser account covers several marketplaces, and Amazon reports a search term once per marketplace without saying which one: a term with search_term_occurrences above 1 ran in several marketplaces of the account. Every Ads connection of the same advertiser account holds a copy of the account's rows; to count an account once across all sellers and vendors of the Organization, filter is_account_primary_copy = TRUE. Do not use that filter for one seller or vendor or a subset of them: the marked copy can belong to a connection outside the selection. marketplace_id is the marketplace of the connection that fetched the account's report, not of the row. impression_share is Amazon's percentage from 0% to 100%, not a ratio from 0 to 1. impression_share_rank is a positive whole number when Amazon sends it. Do not add shares or average ranks across dates, accounts, or search terms. This is not ad_top_of_search_impression_share on a keyword, and it is not amazon_ads_recommendation_snapshots. Sponsored Display, Sponsored Television, and Full-Funnel are not included. A product with no rows does not have 0% share. The first fetch covers the latest 30 completed days in the advertiser account's Ads reporting time zone. A refresh every two days covers the latest 21 completed days and replaces those days, including search terms that are no longer in the file and dates with no rows. Today is not included. The marketplace time zone is used only when the reporting time zone is not stored.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":30},{"type":"RECURRING_DAILY","numberOfDays":21}],"sources":["connections","raw_ads_api_report_search_term_impression_share"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["impression share","search term rank","share of voice"]},{"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 and Sponsored Brands keyword rows. 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 and Sponsored Brands keywords. Null for product or automatic targets.","definition":"keywordId when match type is BROAD, EXACT or PHRASE, including Sponsored Brands keyword rows"},{"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, Sponsored Brands keyword report 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 and broad, phrase and exact keywords after the keyword report is collected, 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_keywords_sb","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, Sponsored Brands keyword report 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. The rule definition is budget_rule_id on amazon_ads_budget_rules. Amazon does not provide 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. The definition is on amazon_ads_budget_rules. This report value is read-only and does not change the rule.","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."},{"name":"kindle_edition_normalized_pages_read_14d","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read by Kindle Unlimited readers within 14 days of an ad click. A page count, not money. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kindle_edition_normalized_pages_royalties_14d","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties for kindle_edition_normalized_pages_read_14d, in the Ads profile currency. Money, not pages. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kenp_per_click_14d","type":"NUMBER","nullable":true,"description":"KENP read per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_read_14d / ad_clicks"},{"name":"estimated_kenp_royalty_per_click_14d","type":"NUMBER","nullable":true,"description":"Estimated KENP royalties per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_royalties_14d / ad_clicks"},{"name":"ku_qualified_borrows","type":"NUMBER","nullable":true,"description":"Kindle Unlimited borrows Amazon counts as qualified, attributed to the ad. A count, not money. Sponsored Products only; null for other campaign types."},{"name":"estimated_ku_borrow_royalties","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties of ku_qualified_borrows. Money, not a count. Sponsored Products only; null for other campaign types."},{"name":"ad_add_to_list","type":"NUMBER","nullable":true,"description":"Times shoppers added the advertised product to a list, attributed to the ad. Sponsored Products only; null for other campaign types."}],"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}],"dataAvailability":{"type":"INTRADAY","description":"Placement performance refreshes once a day at 2am in the marketplace time zone. Data is available after processing and can change in a later report.","refreshAt":"2am"},"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":[],"relatedActions":[{"type":"AMAZON_ADS_AD_EXTENSIONS_ADD","relation":"writes"},{"type":"AMAZON_ADS_AD_EXTENSIONS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_AD_EXTENSIONS_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_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},{"name":"kindle_edition_normalized_pages_read_14d","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read by Kindle Unlimited readers within 14 days of an ad click. A page count, not money. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kindle_edition_normalized_pages_royalties_14d","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties for kindle_edition_normalized_pages_read_14d, in the Ads profile currency. Money, not pages. Sponsored Products only; null for other campaign types and for books outside Kindle Unlimited."},{"name":"kenp_per_click_14d","type":"NUMBER","nullable":true,"description":"KENP read per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_read_14d / ad_clicks"},{"name":"estimated_kenp_royalty_per_click_14d","type":"NUMBER","nullable":true,"description":"Estimated KENP royalties per ad click. Null when clicks are zero or unknown.","definition":"kindle_edition_normalized_pages_royalties_14d / ad_clicks"},{"name":"ku_qualified_borrows","type":"NUMBER","nullable":true,"description":"Kindle Unlimited borrows Amazon counts as qualified, attributed to the ad. A count, not money. Sponsored Products and Sponsored Display; null for Sponsored Brands."},{"name":"estimated_ku_borrow_royalties","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties of ku_qualified_borrows. Money, not a count. Sponsored Products and Sponsored Display; null for Sponsored Brands."},{"name":"ad_add_to_list","type":"NUMBER","nullable":true,"description":"Times shoppers added the advertised product to a list, attributed to the ad. Sponsored Products and Sponsored Display; null for Sponsored Brands."},{"name":"ku_qualified_borrows_from_clicks","type":"NUMBER","nullable":true,"description":"Part of ku_qualified_borrows attributed to ad clicks. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"ku_qualified_borrows_from_views","type":"NUMBER","nullable":true,"description":"Part of ku_qualified_borrows attributed to ad views. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"estimated_ku_borrow_royalties_from_clicks","type":"NUMBER","nullable":true,"description":"Part of estimated_ku_borrow_royalties attributed to ad clicks. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"estimated_ku_borrow_royalties_from_views","type":"NUMBER","nullable":true,"description":"Part of estimated_ku_borrow_royalties attributed to ad views. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"ad_add_to_list_from_clicks","type":"NUMBER","nullable":true,"description":"Part of ad_add_to_list attributed to ad clicks. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"ad_add_to_list_from_views","type":"NUMBER","nullable":true,"description":"Part of ad_add_to_list attributed to ad views. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Performance for ad groups in SPONSORED_PRODUCTS, SPONSORED_BRANDS and SPONSORED_DISPLAY campaigns. Attribution windows differ by campaign type: Sponsored Products ad_sales, ad_orders and ad_units_sold use 7-day click attribution, Sponsored Brands 14 days and Sponsored Display its default window. Sponsored Products rows have null budget, new-to-brand, video, viewability, detail-page-view and branded-search columns.","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_ad_group_sp","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 48 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","raw_ads_api_portfolios"],"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 48 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 48 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 48 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":"936f3f79f5ad2b076f4ffe1aeb672c92aaa57b27384050d7ccac963fef4e9f2a","name":"Ad Campaign Settings History","tableName":"amazon_ads_campaigns_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_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."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":null},{"name":"source_export_id","type":"TEXT","nullable":true,"description":null},{"name":"source_requested_at","type":"DATE","nullable":true,"description":"Original export request time. Use this to order source observations."},{"name":"checked_at","type":"DATE","nullable":true,"description":"Export completion observation, not the exact time an entity changed."},{"name":"checked_at_source","type":"TEXT","nullable":true,"description":null},{"name":"snapshot_date","type":"DATE","nullable":true,"description":"Completion observation date in the verified Amazon Ads reporting time zone. Null when that time zone is unavailable; checked_at still retains the actual observation time."},{"name":"profile_id","type":"TEXT","nullable":true,"description":null},{"name":"snapshot_kind","type":"TEXT","nullable":false,"description":"OBSERVED. Only observations captured after enablement are retained."},{"name":"imported_at","type":"DATE","nullable":true,"description":null},{"name":"date","type":"DATE","nullable":true,"description":"Alias of snapshot_date for date-range exports."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Entity settings from complete published Universal Ads exports, including unchanged later observations. Each snapshot_id is one family/profile export, not a simultaneous account snapshot. Actual observation dates and gaps are authoritative. Portfolio names are null in campaign history; seller and account labels are current context. Absence from a later file does not imply deletion. Changes are known only between observations.  History follows existing collection, normally every 48 hours, with large targets on the weekly schedule. Source caps and failed or incomplete exports leave gaps. No complete daily coverage is guaranteed. Inspect checked_at and snapshot manifests for actual observations. Actions provide live entity state.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_export_campaigns_history","raw_ads_api_export_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"ba08d5b48579a76160566107027a761c22ab5fe19544b64c00fe20aac2ddc983","name":"Ad Group Settings History","tableName":"amazon_ads_ad_groups_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_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},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":null},{"name":"source_export_id","type":"TEXT","nullable":true,"description":null},{"name":"source_requested_at","type":"DATE","nullable":true,"description":"Original export request time. Use this to order source observations."},{"name":"checked_at","type":"DATE","nullable":true,"description":"Export completion observation, not the exact time an entity changed."},{"name":"checked_at_source","type":"TEXT","nullable":true,"description":null},{"name":"snapshot_date","type":"DATE","nullable":true,"description":"Completion observation date in the verified Amazon Ads reporting time zone. Null when that time zone is unavailable; checked_at still retains the actual observation time."},{"name":"profile_id","type":"TEXT","nullable":true,"description":null},{"name":"snapshot_kind","type":"TEXT","nullable":false,"description":"OBSERVED. Only observations captured after enablement are retained."},{"name":"imported_at","type":"DATE","nullable":true,"description":null},{"name":"date","type":"DATE","nullable":true,"description":"Alias of snapshot_date for date-range exports."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Entity settings from complete published Universal Ads exports, including unchanged later observations. Each snapshot_id is one family/profile export, not a simultaneous account snapshot. Actual observation dates and gaps are authoritative. Portfolio names are null in campaign history; seller and account labels are current context. Absence from a later file does not imply deletion. Changes are known only between observations.  History follows existing collection, normally every 48 hours, with large targets on the weekly schedule. Source caps and failed or incomplete exports leave gaps. No complete daily coverage is guaranteed. Inspect checked_at and snapshot manifests for actual observations. Actions provide live entity state.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_export_ad_groups_history","raw_ads_api_export_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"4523e9fe3739126b684fa292272fe8ee155428adf925980aeeb70545e4212676","name":"Ad Settings History","tableName":"amazon_ads_ads_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_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."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":null},{"name":"source_export_id","type":"TEXT","nullable":true,"description":null},{"name":"source_requested_at","type":"DATE","nullable":true,"description":"Original export request time. Use this to order source observations."},{"name":"checked_at","type":"DATE","nullable":true,"description":"Export completion observation, not the exact time an entity changed."},{"name":"checked_at_source","type":"TEXT","nullable":true,"description":null},{"name":"snapshot_date","type":"DATE","nullable":true,"description":"Completion observation date in the verified Amazon Ads reporting time zone. Null when that time zone is unavailable; checked_at still retains the actual observation time."},{"name":"profile_id","type":"TEXT","nullable":true,"description":null},{"name":"snapshot_kind","type":"TEXT","nullable":false,"description":"OBSERVED. Only observations captured after enablement are retained."},{"name":"imported_at","type":"DATE","nullable":true,"description":null},{"name":"date","type":"DATE","nullable":true,"description":"Alias of snapshot_date for date-range exports."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Entity settings from complete published Universal Ads exports, including unchanged later observations. Each snapshot_id is one family/profile export, not a simultaneous account snapshot. Actual observation dates and gaps are authoritative. Portfolio names are null in campaign history; seller and account labels are current context. Absence from a later file does not imply deletion. Changes are known only between observations.  History follows existing collection, normally every 48 hours, with large targets on the weekly schedule. Source caps and failed or incomplete exports leave gaps. No complete daily coverage is guaranteed. Inspect checked_at and snapshot manifests for actual observations. Actions provide live entity state.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_export_ads_history","raw_ads_api_export_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"c898588a9d95995cc152483f28e3b3df87ea6862c7ce5bf7b9706a0026c623de","name":"Target Settings History","tableName":"amazon_ads_targets_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_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},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":null},{"name":"source_export_id","type":"TEXT","nullable":true,"description":null},{"name":"source_requested_at","type":"DATE","nullable":true,"description":"Original export request time. Use this to order source observations."},{"name":"checked_at","type":"DATE","nullable":true,"description":"Export completion observation, not the exact time an entity changed."},{"name":"checked_at_source","type":"TEXT","nullable":true,"description":null},{"name":"snapshot_date","type":"DATE","nullable":true,"description":"Completion observation date in the verified Amazon Ads reporting time zone. Null when that time zone is unavailable; checked_at still retains the actual observation time."},{"name":"profile_id","type":"TEXT","nullable":true,"description":null},{"name":"snapshot_kind","type":"TEXT","nullable":false,"description":"OBSERVED. Only observations captured after enablement are retained."},{"name":"imported_at","type":"DATE","nullable":true,"description":null},{"name":"date","type":"DATE","nullable":true,"description":"Alias of snapshot_date for date-range exports."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Entity settings from complete published Universal Ads exports, including unchanged later observations. Each snapshot_id is one family/profile export, not a simultaneous account snapshot. Actual observation dates and gaps are authoritative. Portfolio names are null in campaign history; seller and account labels are current context. Absence from a later file does not imply deletion. Changes are known only between observations.  History follows existing collection, normally every 48 hours, with large targets on the weekly schedule. Source caps and failed or incomplete exports leave gaps. No complete daily coverage is guaranteed. Inspect checked_at and snapshot manifests for actual observations. Actions provide live entity state.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_export_targets_history","raw_ads_api_export_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"046313e11ffd76422d4fbee10761c063e4ffaeb2d8e383f1b55428b8fc7e6b73","name":"Ads Entity Export Snapshots","tableName":"amazon_ads_entity_export_snapshots","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":true,"description":null},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":null},{"name":"source_export_id","type":"TEXT","nullable":true,"description":null},{"name":"source_requested_at","type":"DATE","nullable":true,"description":"Original export request time. Use this to order source observations."},{"name":"checked_at","type":"DATE","nullable":true,"description":"Export completion observation, not the exact time an entity changed."},{"name":"checked_at_source","type":"TEXT","nullable":true,"description":null},{"name":"snapshot_date","type":"DATE","nullable":true,"description":"Completion observation date in the verified Amazon Ads reporting time zone. Null when that time zone is unavailable; checked_at still retains the actual observation time."},{"name":"profile_id","type":"TEXT","nullable":true,"description":null},{"name":"snapshot_kind","type":"TEXT","nullable":false,"description":"OBSERVED. Only observations captured after enablement are retained."},{"name":"imported_at","type":"DATE","nullable":true,"description":null},{"name":"entity_type","type":"TEXT","nullable":false,"description":null},{"name":"report_lifecycle_id","type":"TEXT","nullable":true,"description":null},{"name":"reporting_timezone","type":"TEXT","nullable":true,"description":null},{"name":"status","type":"TEXT","nullable":false,"description":null},{"name":"is_complete","type":"LOGIC","nullable":false,"description":null},{"name":"source_element_count","type":"NUMBER","nullable":true,"description":null},{"name":"imported_row_count","type":"NUMBER","nullable":false,"description":null},{"name":"rejected_row_count","type":"NUMBER","nullable":false,"description":null},{"name":"completeness_reason","type":"TEXT","nullable":true,"description":null},{"name":"published_at","type":"DATE","nullable":true,"description":null},{"name":"dt_created","type":"DATE","nullable":true,"description":null},{"name":"dt_updated","type":"DATE","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"One manifest per Ads family/profile export. Only COMPLETE, is_complete observations whose rows reached the warehouse appear in entity history. Empty complete files have zero rows. PARTIAL and FAILED files explain gaps.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["raw_ads_api_export_snapshots"],"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":"dsp_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon DSP advertiser identifier. Empty for profile-scoped creative asset rows."},{"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 seller or vendor, connection, DSP advertiser, creative asset ID, and version. The same asset version can appear once per DSP advertiser that sees it, and once with an empty DSP advertiser ID for the Ads profile.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_ASSETS_ADD","relation":"writes"},{"type":"AMAZON_ADS_ASSETS_FIND","relation":"live"}],"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 Sponsored Products and Sponsored Brands campaigns, ad groups, ads, and targets, such as state, bid, and budget changes. Amazon's change history API does not return Sponsored Display events.","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":"product_attribution_type","type":"TEXT","nullable":true,"description":"Whether the purchase was of the promoted product or brand halo, as Amazon reports it (for example Promoted / Brand Halo). SPONSORED_BRANDS only; null for SPONSORED_PRODUCTS and SPONSORED_DISPLAY."},{"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)."},{"name":"kindle_edition_normalized_pages_read_14d","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read by Kindle Unlimited readers within 14 days of an ad click. A page count, not money. Sponsored Products and Sponsored Brands; null for Sponsored Display."},{"name":"kindle_edition_normalized_pages_royalties_14d","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties for kindle_edition_normalized_pages_read_14d, in the Ads profile currency. Money, not pages. Sponsored Products and Sponsored Brands; null for Sponsored Display."},{"name":"ku_qualified_borrows","type":"NUMBER","nullable":true,"description":"Kindle Unlimited borrows Amazon counts as qualified, attributed to the ad. A count, not money. Sponsored Products and Sponsored Display; null for Sponsored Brands."},{"name":"estimated_ku_borrow_royalties","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties of ku_qualified_borrows. Money, not a count. Sponsored Products and Sponsored Display; null for Sponsored Brands."},{"name":"ad_add_to_list","type":"NUMBER","nullable":true,"description":"Times shoppers added the advertised product to a list, attributed to the ad. Sponsored Products and Sponsored Display; null for Sponsored Brands."},{"name":"ku_qualified_borrows_from_clicks","type":"NUMBER","nullable":true,"description":"Part of ku_qualified_borrows attributed to ad clicks. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"ku_qualified_borrows_from_views","type":"NUMBER","nullable":true,"description":"Part of ku_qualified_borrows attributed to ad views. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"estimated_ku_borrow_royalties_from_clicks","type":"NUMBER","nullable":true,"description":"Part of estimated_ku_borrow_royalties attributed to ad clicks. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"estimated_ku_borrow_royalties_from_views","type":"NUMBER","nullable":true,"description":"Part of estimated_ku_borrow_royalties attributed to ad views. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"ad_add_to_list_from_clicks","type":"NUMBER","nullable":true,"description":"Part of ad_add_to_list attributed to ad clicks. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."},{"name":"ad_add_to_list_from_views","type":"NUMBER","nullable":true,"description":"Part of ad_add_to_list attributed to ad views. Sponsored Display only; Amazon reports no click/view split for Sponsored Products."}],"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."},{"name":"is_multi_ad_groups_enabled","type":"LOGIC","nullable":true,"description":"Whether the campaign can have multiple ad groups."},{"name":"ad_campaign_created_at","type":"DATE","nullable":true,"description":"Time Amazon created the campaign."},{"name":"ad_campaign_updated_at","type":"DATE","nullable":true,"description":"Time Amazon last updated the campaign."}],"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},{"name":"book_title","type":"TEXT","nullable":true,"description":"Latest book title from amazon_ads_book_catalog for this ASIN. Null when the catalog has no title."},{"name":"book_format","type":"TEXT","nullable":true,"description":"Edition format from the latest uploaded KDP royalty parameters of this ASIN: EBOOK / PAPERBACK / HARDCOVER / AUDIOBOOK. Latest upload, not effective for the row date. Null without royalty parameters."},{"name":"book_work_id","type":"TEXT","nullable":true,"description":"User-defined work ID that groups the editions of one book, from the latest uploaded KDP royalty parameters of this ASIN. Null without royalty parameters."},{"name":"book_metadata_source","type":"TEXT","nullable":true,"description":"USER when uploaded KDP royalty parameters supply book_format or book_work_id; API_METADATA when only the catalog title matched; null when neither matched."}],"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","raw_ads_api_product_metadata","raw_amazon_kdp_royalty_parameters"],"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."},{"name":"ad_portfolio_id","type":"TEXT","nullable":true,"description":"Portfolio of the budget: budget_scope_id for PORTFOLIO scope, or the portfolio of the campaign from amazon_ads_ams_campaigns for CAMPAIGN scope. Null when unknown."},{"name":"budget_rule_ids","type":"JSON","nullable":true,"description":"Sorted JSON array of budget rule IDs attached to the campaign, from amazon_ads_budget_rule_campaigns for Sponsored Products, Sponsored Brands and Sponsored Display. Null, never an empty array, for PORTFOLIO scope or when no rule is attached."}],"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","raw_ads_api_budget_rule_campaigns","raw_ads_api_budget_rule_snapshots"],"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":"entity_id","type":"TEXT","nullable":true,"description":"Entity ID from the diagnostics message, when Amazon sends one."},{"name":"advertiser_type","type":"TEXT","nullable":true,"description":"Advertiser type from the diagnostics message, when Amazon sends one."},{"name":"marketplace","type":"TEXT","nullable":true,"description":"Marketplace from the diagnostics message. This is not a Partner Opportunity ID."},{"name":"source_recommendation_status","type":"TEXT","nullable":true,"description":"Recommendation status from the diagnostics message."},{"name":"recommendation_group","type":"TEXT","nullable":true,"description":"Recommendation group from the diagnostics message."},{"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_name","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":"e22ddcc5203b6dceecebfa06a0101e44e00bd143573dbd96479fe659db96a183","name":"Ads performance by campaign by hour","tableName":"amazon_ads_performance_by_campaign_by_hour","type":"AMAZON_ADS","columns":[{"name":"marketplace_id","type":"TEXT","nullable":false,"description":"Amazon marketplace identifier."},{"name":"marketplace_country_code","type":"TEXT","nullable":false,"description":"Marketplace country code."},{"name":"marketplace_country_name","type":"TEXT","nullable":false,"description":"Marketplace country name."},{"name":"seller_or_vendor_id","type":"TEXT","nullable":false,"description":"DataDoe seller or vendor context id. Campaign ids are not unique across accounts."},{"name":"seller_or_vendor_name","type":"TEXT","nullable":true,"description":"Seller or vendor display name. Filter and group by seller_or_vendor_id."},{"name":"marketplace_seller_id","type":"TEXT","nullable":true,"description":"Amazon selling partner id. Null for an Ads account with no seller id."},{"name":"amazon_ads_profile_id","type":"TEXT","nullable":true,"description":"Amazon Ads profile id."},{"name":"amazon_ads_advertiser_id","type":"TEXT","nullable":true,"description":"Amazon Ads advertiser id. Null when the stream did not report it."},{"name":"ad_campaign_type","type":"TEXT","nullable":false,"description":"Sponsored Products, Sponsored Brands, or Sponsored Display."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":"Amazon Ads campaign id. Use it with the Ads connection, not on its own."},{"name":"currency","type":"TEXT","nullable":false,"description":"Currency of the measures on this row. Do not combine different currencies."},{"name":"time_window_starts_at","type":"DATE","nullable":false,"description":"UTC start of the Amazon activity window. This is not the time the event was received. Events with no start stay on AMS Traffic and AMS Conversion and are not given an hour."},{"name":"time_window_ends_at","type":"DATE","nullable":false,"description":"UTC end of the activity window, 1 hour after time_window_starts_at."},{"name":"reporting_timezone","type":"TEXT","nullable":true,"description":"IANA timezone of the Amazon Ads profile, such as Europe/London. Null when that timezone is not verified. There is no UTC fallback."},{"name":"reporting_timezone_source","type":"TEXT","nullable":false,"description":"ADS_PROFILE when reporting_timezone is verified. UNKNOWN when it is not."},{"name":"date","type":"DATE","nullable":true,"description":"Calendar date of the activity window in reporting_timezone. Filter on this date, then group by weekday and local_hour. Null when the timezone is unknown. A retention period uses this date, so those rows are removed when retention is set."},{"name":"date_utc","type":"DATE","nullable":false,"description":"UTC calendar date of the activity window. This is a diagnostic, not the local date."},{"name":"local_hour","type":"NUMBER","nullable":true,"description":"Hour of the activity window in reporting_timezone, from 0 to 23. Null when the timezone is unknown. Repeated local hours during daylight saving stay on separate UTC windows."},{"name":"weekday","type":"NUMBER","nullable":true,"description":"Local weekday of date. Monday is 1 and Sunday is 7. Null when the timezone is unknown."},{"name":"weekday_name","type":"TEXT","nullable":true,"description":"English name of weekday. Use weekday for grouping."},{"name":"utc_offset_minutes","type":"NUMBER","nullable":true,"description":"Minutes between the local activity time and UTC, including the daylight-saving offset. Null when the timezone is unknown."},{"name":"default_click_attribution_window_days","type":"NUMBER","nullable":true,"description":"7 for Sponsored Products and 14 for Sponsored Brands and Sponsored Display. Null for any other ad product. This chooses the default click metrics only. The 1, 7, 14, and 30 day columns stay separate."},{"name":"ad_impressions","type":"NUMBER","nullable":true,"description":"Sum of impressions for this campaign and activity hour. Null when traffic was not reported. Null is not zero."},{"name":"ad_clicks","type":"NUMBER","nullable":true,"description":"Sum of clicks for this campaign and activity hour. Null when traffic was not reported. Null is not zero."},{"name":"ad_view_impressions","type":"NUMBER","nullable":true,"description":"Sum of view impressions for this campaign and activity hour. Null when the ad product does not report them."},{"name":"ad_viewable_impressions","type":"NUMBER","nullable":true,"description":"Sum of viewable impressions for this campaign and activity hour. Null when the ad product does not report them."},{"name":"ad_spend","type":"NUMBER","nullable":true,"description":"Sum of ad spend for this campaign and activity hour, in currency. Null when traffic was not reported."},{"name":"ad_attributed_conversions_1d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_conversions_1d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_conversions_7d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_conversions_7d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_conversions_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_conversions_14d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_conversions_30d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_conversions_30d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_sales_1d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_sales_1d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_sales_7d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_sales_7d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_sales_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_sales_14d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_sales_30d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_sales_30d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_units_ordered_1d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_units_ordered_1d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_units_ordered_7d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_units_ordered_7d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_units_ordered_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_units_ordered_14d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_units_ordered_30d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_units_ordered_30d_same_sku","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_view_attributed_conversions_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_view_attributed_sales_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_view_attributed_units_ordered_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_orders_new_to_brand_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_sales_new_to_brand_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_attributed_units_ordered_new_to_brand_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_view_attributed_orders_new_to_brand_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_view_attributed_sales_new_to_brand_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_view_attributed_units_ordered_new_to_brand_14d","type":"NUMBER","nullable":true,"description":"Sum of this Amazon Marketing Stream attribution measure for the campaign and activity hour. The window, same-SKU, new-to-brand, and view-through meanings stay separate. Null when conversion was not reported. This is an advertising outcome on the activity hour, not the purchase hour."},{"name":"ad_click_attributed_conversions","type":"NUMBER","nullable":true,"description":"Click conversions for the default window: 7 days for Sponsored Products, 14 days for Sponsored Brands and Sponsored Display. Null when that window or the conversion side is unavailable."},{"name":"ad_click_attributed_sales","type":"NUMBER","nullable":true,"description":"Click sales for the default attribution window, in currency. Null when that window or the conversion side is unavailable."},{"name":"ad_click_attributed_units_ordered","type":"NUMBER","nullable":true,"description":"Click units ordered for the default attribution window. Null when that window or the conversion side is unavailable."},{"name":"ad_cpc","type":"NUMBER","nullable":true,"description":"Cost per click: ad spend divided by clicks. Money per click, in currency.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_ctr","type":"NUMBER","nullable":true,"description":"Click-through rate: clicks divided by impressions. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_cvr","type":"NUMBER","nullable":true,"description":"Default click conversion rate: ad_click_attributed_conversions divided by clicks. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_acos","type":"NUMBER","nullable":true,"description":"Default click advertising cost of sales: ad spend divided by ad_click_attributed_sales. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_roas","type":"NUMBER","nullable":true,"description":"Default click return on ad spend: ad_click_attributed_sales divided by ad spend. A multiple, not a percentage.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_cvr_1d","type":"NUMBER","nullable":true,"description":"Click conversion rate for the 1-day conversions, divided by clicks. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_acos_1d","type":"NUMBER","nullable":true,"description":"Advertising cost of sales for the 1-day sales. Ad spend divided by those sales. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_roas_1d","type":"NUMBER","nullable":true,"description":"Return on ad spend for the 1-day sales, divided by ad spend. A multiple, not a percentage.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_cvr_1d_same_sku","type":"NUMBER","nullable":true,"description":"Click conversion rate for the 1-day same-SKU conversions, divided by clicks. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_acos_1d_same_sku","type":"NUMBER","nullable":true,"description":"Advertising cost of sales for the 1-day same-SKU sales. Ad spend divided by those sales. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_roas_1d_same_sku","type":"NUMBER","nullable":true,"description":"Return on ad spend for the 1-day same-SKU sales, divided by ad spend. A multiple, not a percentage.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_cvr_7d","type":"NUMBER","nullable":true,"description":"Click conversion rate for the 7-day conversions, divided by clicks. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_acos_7d","type":"NUMBER","nullable":true,"description":"Advertising cost of sales for the 7-day sales. Ad spend divided by those sales. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_roas_7d","type":"NUMBER","nullable":true,"description":"Return on ad spend for the 7-day sales, divided by ad spend. A multiple, not a percentage.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_cvr_7d_same_sku","type":"NUMBER","nullable":true,"description":"Click conversion rate for the 7-day same-SKU conversions, divided by clicks. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_acos_7d_same_sku","type":"NUMBER","nullable":true,"description":"Advertising cost of sales for the 7-day same-SKU sales. Ad spend divided by those sales. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_roas_7d_same_sku","type":"NUMBER","nullable":true,"description":"Return on ad spend for the 7-day same-SKU sales, divided by ad spend. A multiple, not a percentage.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_cvr_14d","type":"NUMBER","nullable":true,"description":"Click conversion rate for the 14-day conversions, divided by clicks. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_acos_14d","type":"NUMBER","nullable":true,"description":"Advertising cost of sales for the 14-day sales. Ad spend divided by those sales. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_roas_14d","type":"NUMBER","nullable":true,"description":"Return on ad spend for the 14-day sales, divided by ad spend. A multiple, not a percentage.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_cvr_14d_same_sku","type":"NUMBER","nullable":true,"description":"Click conversion rate for the 14-day same-SKU conversions, divided by clicks. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_acos_14d_same_sku","type":"NUMBER","nullable":true,"description":"Advertising cost of sales for the 14-day same-SKU sales. Ad spend divided by those sales. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_roas_14d_same_sku","type":"NUMBER","nullable":true,"description":"Return on ad spend for the 14-day same-SKU sales, divided by ad spend. A multiple, not a percentage.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_cvr_30d","type":"NUMBER","nullable":true,"description":"Click conversion rate for the 30-day conversions, divided by clicks. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_acos_30d","type":"NUMBER","nullable":true,"description":"Advertising cost of sales for the 30-day sales. Ad spend divided by those sales. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_roas_30d","type":"NUMBER","nullable":true,"description":"Return on ad spend for the 30-day sales, divided by ad spend. A multiple, not a percentage.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_cvr_30d_same_sku","type":"NUMBER","nullable":true,"description":"Click conversion rate for the 30-day same-SKU conversions, divided by clicks. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_acos_30d_same_sku","type":"NUMBER","nullable":true,"description":"Advertising cost of sales for the 30-day same-SKU sales. Ad spend divided by those sales. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_roas_30d_same_sku","type":"NUMBER","nullable":true,"description":"Return on ad spend for the 30-day same-SKU sales, divided by ad spend. A multiple, not a percentage.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_view_acos_14d","type":"NUMBER","nullable":true,"description":"View-through advertising cost of sales using 14-day view sales. Separate from click advertising cost of sales. A decimal ratio. 0.25 means 25%.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"ad_view_roas_14d","type":"NUMBER","nullable":true,"description":"View-through return on ad spend using 14-day view sales. Separate from click return on ad spend. A multiple, not a percentage.","definition":"Divide the numerator by the denominator only when both values are available, the numerator is zero or greater, and the denominator is greater than zero. Otherwise null. When you group rows, divide the summed numerator by the summed denominator. Do not average this ratio."},{"name":"traffic_source_rows","type":"NUMBER","nullable":false,"description":"Count of canonical AMS Traffic events in this row, after repeated deliveries of the same idempotency id are collapsed. 0 when only conversion data is present. This does not prove every hour was collected."},{"name":"conversion_source_rows","type":"NUMBER","nullable":false,"description":"Count of canonical AMS Conversion events in this row. 0 when only traffic data is present. This is not the conversion count."},{"name":"traffic_data_present","type":"LOGIC","nullable":false,"description":"True when traffic_source_rows is greater than zero."},{"name":"conversion_data_present","type":"LOGIC","nullable":false,"description":"True when conversion_source_rows is greater than zero."},{"name":"traffic_first_received_at","type":"DATE","nullable":true,"description":"Earliest received time among the traffic events in this row. Null when traffic is absent."},{"name":"traffic_last_received_at","type":"DATE","nullable":true,"description":"Latest received time among the traffic events in this row. Null when traffic is absent."},{"name":"conversion_first_received_at","type":"DATE","nullable":true,"description":"Earliest received time among the conversion events in this row. Null when conversion is absent."},{"name":"conversion_last_received_at","type":"DATE","nullable":true,"description":"Latest received time among the conversion events in this row. Null when conversion is absent."},{"name":"source_last_updated_at","type":"DATE","nullable":true,"description":"Latest source dt_updated across the traffic and conversion events in this row."},{"name":"source_presence","type":"TEXT","nullable":false,"description":"BOTH, TRAFFIC_ONLY, or CONVERSION_ONLY. This shows which side contributed. It does not mean collection is complete."},{"name":"has_negative_aggregates","type":"LOGIC","nullable":false,"description":"True when any summed traffic or conversion measure is below zero. Negative corrections stay in the measure."},{"name":"dt_created","type":"DATE","nullable":true,"description":"Earliest source dt_created among the events in this row. Not the time this view was built."},{"name":"dt_updated","type":"DATE","nullable":true,"description":"Same timestamp as source_last_updated_at. Not the current time."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":false,"description":"Advertising performance for each campaign and each Amazon activity hour. Filter on the local date, then group by weekday and local hour and recompute ratios from the summed measures. Hours use the advertiser's Amazon Ads profile timezone, including daylight saving. If that timezone is unknown, the local date, hour, and weekday are null. A null measure is unavailable, not zero. A missing traffic or conversion side stays null. Turning this table on does not mean the stream is subscribed, receiving, or complete for every past hour. This is not the shopper's purchase hour, and it is not hourly profit, fees, or total advertising cost of sales.","requiresDatePeriod":true,"issues":[],"prerequisites":"Requires AMS Traffic and AMS Conversion. Turning this table on can turn those tables on and starts collection for every Sponsored Products, Sponsored Brands, and Sponsored Display dataset they use. This view does not store a second billed copy of those rows. Rows with row billing on a required table still count toward usage.","fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_ams_sb_traffic","raw_ads_api_ams_sd_traffic","raw_ads_api_ams_sp_traffic","raw_ads_api_ams_sb_conversion","raw_ads_api_ams_sd_conversion","raw_ads_api_ams_sp_conversion"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["dayparting","hour of day","weekday"]},{"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":"2cb8447d6f8a87eec209d1f9fc797f608b53f4d262d662c2098cda8409129b44","name":"Ads Profiles","tableName":"amazon_ads_profiles","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":"ads_account_id","type":"TEXT","nullable":true,"description":"Amazon Ads account identifier."},{"name":"ads_account_name","type":"TEXT","nullable":true,"description":"Amazon Ads account name."},{"name":"ads_account_type","type":"TEXT","nullable":true,"description":"Amazon Ads profile account type: seller / vendor / agency. Null until DataDoe captured the profile."},{"name":"ads_account_subtype","type":"TEXT","nullable":true,"description":"Amazon Ads special account subtype, such as KDP_AUTHOR or AMAZON_ATTRIBUTION. Null for regular accounts and until DataDoe captured the profile."},{"name":"is_kdp_author","type":"LOGIC","nullable":true,"description":"True for a Kindle Direct Publishing author account (ads_account_subtype KDP_AUTHOR), false for other captured profiles. Null until DataDoe captured the profile."},{"name":"ads_profile_country_code","type":"TEXT","nullable":true,"description":"Country code of the Amazon Ads profile."},{"name":"ads_profile_currency_code","type":"TEXT","nullable":true,"description":"Currency of the Amazon Ads profile. Null until DataDoe captured the profile."},{"name":"ads_profile_timezone","type":"TEXT","nullable":true,"description":"IANA timezone of the Amazon Ads profile. Null until DataDoe captured the profile."},{"name":"valid_payment_method","type":"LOGIC","nullable":true,"description":"Whether the Amazon Ads account has a valid payment method."},{"name":"observed_at_utc","type":"DATE","nullable":true,"description":"Time DataDoe read the Amazon Ads profile."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"One row per Amazon Ads connection with its Amazon Ads profile: account type and subtype (for example KDP_AUTHOR), country, currency, timezone and payment status. Profile columns are null until DataDoe captured the profile.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections"],"containsPii":false,"initialLoadProgress":null},{"id":"7d9b622db43e35c5cafcf36ae4212aa3e594f597e164dd93f7c10e65e344cbb3","name":"Ads Profile Capabilities","tableName":"amazon_ads_profile_capabilities","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":"UTC day of the check."},{"name":"capability_source","type":"TEXT","nullable":false,"description":"PROGRAM_ELIGIBILITY / ACCESS_PAUSE."},{"name":"ad_program","type":"TEXT","nullable":true,"description":"Amazon Ads program code, such as SP, SB, SD, MAAS, SPOT or DTC. Null for access pauses."},{"name":"ad_product","type":"TEXT","nullable":true,"description":"SPONSORED_PRODUCTS / SPONSORED_BRANDS / SPONSORED_DISPLAY / AMAZON_ATTRIBUTION / STORES / DIRECT_TO_CONSUMER. Null for unknown programs and some pauses."},{"name":"operation_family","type":"TEXT","nullable":false,"description":"PROGRAM / REPORTS / BRAND_METRICS_REPORTS / ENTITY_HISTORY / RECOMMENDATIONS."},{"name":"api_version","type":"TEXT","nullable":true,"description":"API version of a paused operation, such as V2. Usually null."},{"name":"capability_status","type":"TEXT","nullable":false,"description":"VERIFIED_SUPPORTED / VERIFIED_DENIED / UNKNOWN."},{"name":"reason_code","type":"TEXT","nullable":true,"description":"Comma-separated reason codes, HTTP_<status> when the eligibility call failed, or ACCESS_PAUSED."},{"name":"reason_message","type":"TEXT","nullable":true,"description":null},{"name":"reason_level","type":"TEXT","nullable":true,"description":null},{"name":"reasons","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"verification_source","type":"TEXT","nullable":false,"description":"API_RESPONSE / ACCESS_STATE."},{"name":"is_listed_in_last_fetch","type":"LOGIC","nullable":false,"description":"True for rows of the latest check. Capabilities that later checks stopped returning (eligibility regained, pause expired) keep their rows with false."},{"name":"last_checked_at_utc","type":"DATE","nullable":false,"description":null},{"name":"next_check_at_utc","type":"DATE","nullable":true,"description":"For access pauses, when DataDoe retries the operation."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Ads program eligibility and API access pauses per Ads connection and UTC check day. PROGRAM_ELIGIBILITY rows come from Amazon program eligibility; ACCESS_PAUSE rows are operations DataDoe paused after Amazon denied access. Use is_listed_in_last_fetch = TRUE for the current state. Checked about every 20 hours.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_PROGRAM_ELIGIBILITY_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_profile_capabilities"],"containsPii":false,"initialLoadProgress":null},{"id":"ba41ad8515047fbd0db08e11f5f1bbc91569e978ea3a44cddd2c76c9e6604fe3","name":"Ads Billing","tableName":"amazon_ads_billing","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":"Invoice date."},{"name":"billing_type","type":"TEXT","nullable":false,"description":"CAMPAIGN / PROMOTION / ADJUSTMENT / FEE / TAX."},{"name":"invoice_id","type":"TEXT","nullable":false,"description":null},{"name":"invoice_number","type":"TEXT","nullable":true,"description":null},{"name":"invoice_status","type":"TEXT","nullable":false,"description":"Amazon invoice status, such as ISSUED, PAID_IN_FULL or WRITTEN_OFF. Open invoices are refetched until paid or written off."},{"name":"invoice_country_code","type":"TEXT","nullable":true,"description":"Country of the invoice. One Ads account can bill several countries with separate invoices and currencies."},{"name":"ad_product_group","type":"TEXT","nullable":true,"description":null},{"name":"billing_period_start_date","type":"DATE","nullable":true,"description":null},{"name":"billing_period_end_date","type":"DATE","nullable":true,"description":null},{"name":"invoice_due_date","type":"DATE","nullable":true,"description":null},{"name":"payment_method","type":"TEXT","nullable":true,"description":null},{"name":"invoice_amount_due","type":"NUMBER","nullable":true,"description":"Amount due of the whole invoice, repeated on each of its rows."},{"name":"invoice_tax_amount_due","type":"NUMBER","nullable":true,"description":"Tax due of the whole invoice, repeated on each of its rows."},{"name":"invoice_remaining_amount_due","type":"NUMBER","nullable":true,"description":"Unpaid amount of the whole invoice, repeated on each of its rows."},{"name":"currency_code","type":"TEXT","nullable":true,"description":null},{"name":"program_name","type":"TEXT","nullable":true,"description":"Ad program of a CAMPAIGN row as Amazon bills it, such as SPONSORED PRODUCTS, SPONSORED BRANDS, SPONSORED DISPLAY or CREATOR CONNECTIONS."},{"name":"is_creator_connections","type":"LOGIC","nullable":false,"description":"True for Creator Connections charges: program CREATOR CONNECTIONS or a line with a commission. Their counts are in billed_event_count, never in clicks."},{"name":"ad_campaign_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_portfolio_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_portfolio_name","type":"TEXT","nullable":true,"description":null},{"name":"invoice_line_count","type":"NUMBER","nullable":true,"description":"Invoice lines summed into this row."},{"name":"billed_event_type","type":"TEXT","nullable":true,"description":"What Amazon counted for the charge, such as CLICKS or IMPRESSIONS."},{"name":"billed_event_count","type":"NUMBER","nullable":true,"description":null},{"name":"clicks","type":"NUMBER","nullable":true,"description":"Billed clicks. Null for Creator Connections rows."},{"name":"impressions","type":"NUMBER","nullable":true,"description":"Billed impressions. Null for Creator Connections rows."},{"name":"sponsored_products_cost","type":"NUMBER","nullable":true,"description":"Sponsored Products charges, without fees."},{"name":"sponsored_brands_cost","type":"NUMBER","nullable":true,"description":"Sponsored Brands charges, without fees."},{"name":"sponsored_display_cost","type":"NUMBER","nullable":true,"description":"Sponsored Display charges, without fees and without Creator Connections."},{"name":"creator_connections_cost","type":"NUMBER","nullable":true,"description":"Creator Connections charges, without fees."},{"name":"other_ads_cost","type":"NUMBER","nullable":true,"description":"Charges of other ad programs, without fees."},{"name":"creator_connections_commission","type":"NUMBER","nullable":true,"description":"Commission amount when Amazon reports it on the line. Informational, already part of creator_connections_cost."},{"name":"promotion_amount","type":"NUMBER","nullable":true,"description":"Promotion credit, negative."},{"name":"adjustment_amount","type":"NUMBER","nullable":true,"description":"Adjustment, with Amazon sign."},{"name":"fee_type","type":"TEXT","nullable":true,"description":"Fee type, such as REGULATORY_ADVERTISING_FEE."},{"name":"fee_country_code","type":"TEXT","nullable":true,"description":"Country (jurisdiction) of the fee."},{"name":"fee_amount","type":"NUMBER","nullable":true,"description":"Fee amount for the fee type and country. Can be negative."},{"name":"tax_name","type":"TEXT","nullable":true,"description":null},{"name":"tax_jurisdiction","type":"TEXT","nullable":true,"description":null},{"name":"tax_rate","type":"NUMBER","nullable":true,"description":"Tax rate as returned by Amazon. A rate, not money."},{"name":"tax_amount","type":"NUMBER","nullable":true,"description":"Tax amount of the jurisdiction."},{"name":"total","type":"NUMBER","nullable":false,"description":"Amount of the row. SUM(total) over an invoice without TAX rows equals invoice_amount_due."},{"name":"billing_description","type":"TEXT","nullable":true,"description":"Promotion or adjustment description from Amazon."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Ads Billing invoices, as in the Ads console billing history. Not the SP-API Vendor amazon_invoices. One row per issued invoice and billing_type: CAMPAIGN (one campaign and program, lines of the same campaign summed, Amazon sign kept), PROMOTION, ADJUSTMENT, FEE (per fee type and country) and TAX. date is the invoice date. SUM(total) over an invoice without TAX rows equals invoice_amount_due. The current, not yet issued period is not included. Empty when the Ads account has no Billing history permission. Fetched daily, 2 years back.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_invoices","raw_ads_api_invoice_lines"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["billing history","invoice","creator connections","regulatory fee"]},{"id":"165d07b93d21248c7a96b2fb0d99b40affddf7e0270db597f71cfea98dc8062b","name":"Ads Invoice Lines","tableName":"amazon_ads_invoice_lines","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":"Invoice date."},{"name":"invoice_id","type":"TEXT","nullable":false,"description":null},{"name":"invoice_number","type":"TEXT","nullable":true,"description":null},{"name":"invoice_status","type":"TEXT","nullable":true,"description":"Amazon invoice status, such as ISSUED, PAID_IN_FULL or WRITTEN_OFF."},{"name":"invoice_country_code","type":"TEXT","nullable":true,"description":"Country on the invoice. Marketplace country comes from the Ads connection."},{"name":"line_index","type":"NUMBER","nullable":false,"description":"Zero-based position of the line in the latest complete invoice detail."},{"name":"program_name","type":"TEXT","nullable":true,"description":null},{"name":"line_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_aid","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":true,"description":null},{"name":"campaign_tags","type":"JSON","nullable":true,"description":null},{"name":"ad_portfolio_id","type":"TEXT","nullable":true,"description":null},{"name":"cost","type":"NUMBER","nullable":true,"description":"Amazon line cost. It still includes the line fees."},{"name":"currency_code","type":"TEXT","nullable":true,"description":null},{"name":"commission_amount","type":"NUMBER","nullable":true,"description":null},{"name":"commission_rate","type":"NUMBER","nullable":true,"description":null},{"name":"promotion_amount","type":"NUMBER","nullable":true,"description":null},{"name":"supply_cost","type":"NUMBER","nullable":true,"description":null},{"name":"cost_per_unit","type":"NUMBER","nullable":true,"description":null},{"name":"cost_per_event_type","type":"NUMBER","nullable":true,"description":null},{"name":"billed_event_type","type":"TEXT","nullable":true,"description":null},{"name":"billed_event_count","type":"NUMBER","nullable":true,"description":"Count of the billed event. For Creator Connections this is not a click count."},{"name":"price_type","type":"TEXT","nullable":true,"description":null},{"name":"purchase_order_number","type":"TEXT","nullable":true,"description":null},{"name":"fees","type":"JSON","nullable":true,"description":"Fee objects on the line. Ads Billing already publishes these as FEE rows."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"When DataDoe last stored this invoice line."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Exact Amazon Ads invoice lines. One row per invoice and line position in the latest complete invoice detail. line_index is that position, starting at 0. cost is the Amazon line cost and still includes fees. Do not add it to Ads Billing, which already publishes those fees as separate rows. Creator Connections counts stay in billed_event_count.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_invoices","raw_ads_api_invoice_lines"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["invoice lines","ads invoice line","campaign charge"]},{"id":"ba5bebe5f401eb22a5fc0d8abf86832289e9f7cc476b96aed896d7dc1fd8d1a1","name":"Ads Invoice Payments","tableName":"amazon_ads_invoice_payments","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":"Invoice date, not the payment date."},{"name":"invoice_id","type":"TEXT","nullable":false,"description":null},{"name":"invoice_number","type":"TEXT","nullable":true,"description":null},{"name":"invoice_status","type":"TEXT","nullable":false,"description":"Amazon invoice status. This is not the payment status."},{"name":"invoice_country_code","type":"TEXT","nullable":true,"description":"Country on the invoice. Marketplace country comes from the Ads connection."},{"name":"payment_id","type":"TEXT","nullable":false,"description":"Amazon payment id, kept as text."},{"name":"payment_status","type":"TEXT","nullable":false,"description":"Amazon payment status, such as PROCESSING, SUCCEEDED, FAILED, VERIFICATION_REQUIRED, REFUNDED or VOIDED."},{"name":"payment_method","type":"TEXT","nullable":true,"description":"Amazon payment method, including DEDUCT_FROM_PAYMENT."},{"name":"amount","type":"NUMBER","nullable":true,"description":null},{"name":"currency_code","type":"TEXT","nullable":true,"description":null},{"name":"refunded_amount","type":"NUMBER","nullable":true,"description":null},{"name":"refunded_currency_code","type":"TEXT","nullable":true,"description":null},{"name":"reason","type":"TEXT","nullable":true,"description":"Payment reason from Amazon."},{"name":"current_payment_attempt_date_raw","type":"TEXT","nullable":true,"description":"Current payment attempt date as Amazon sent it."},{"name":"last_payment_attempt_date_raw","type":"TEXT","nullable":true,"description":"Last payment attempt date as Amazon sent it."},{"name":"next_payment_attempt_date_raw","type":"TEXT","nullable":true,"description":"Next payment attempt date as Amazon sent it."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"When DataDoe last stored this invoice."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Ads invoice payments. One row per invoice and payment. date is the invoice date. invoice_status is the invoice and payment_status is the payment. payment_method keeps Amazon values such as DEDUCT_FROM_PAYMENT. Amounts keep Amazon's sign, and each amount keeps its own currency. A missing payment list produces no rows.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_invoices","raw_ads_api_invoice_lines"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["ads payment","invoice payment","deduct from payment"]},{"id":"47b90a1271283867ad3d1e87cf4aea5b80ec69c388d41b7647121c6128e640d4","name":"Ads Billing Statements","tableName":"amazon_ads_billing_statements","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":"Day DataDoe requested the statement."},{"name":"statement_request_id","type":"TEXT","nullable":false,"description":null},{"name":"amazon_ads_account_id","type":"TEXT","nullable":false,"description":"Amazon Ads advertiser account id. This is not the profile id."},{"name":"period_start_date","type":"DATE","nullable":false,"description":"First day covered by the statement."},{"name":"period_end_date","type":"DATE","nullable":false,"description":"Last day covered by the statement."},{"name":"locale","type":"TEXT","nullable":false,"description":null},{"name":"format","type":"TEXT","nullable":false,"description":"CSV."},{"name":"country_codes","type":"JSON","nullable":true,"description":"Country filter sent to Amazon. Null when DataDoe did not filter by country."},{"name":"report_status","type":"TEXT","nullable":false,"description":"IN_PROGRESS, SUCCESS or FAILED. SUCCESS means the file was downloaded and stored."},{"name":"details","type":"TEXT","nullable":true,"description":"Amazon or DataDoe note for this statement request. Null when there is none."},{"name":"requested_at_utc","type":"DATE","nullable":false,"description":"When DataDoe requested the statement."},{"name":"last_checked_at_utc","type":"DATE","nullable":true,"description":"When DataDoe last checked this statement request."},{"name":"completed_at_utc","type":"DATE","nullable":true,"description":"When DataDoe stored the statement file."},{"name":"source_headers","type":"JSON","nullable":true,"description":"Ordered CSV header from the statement. Null until the file is stored."},{"name":"row_count","type":"NUMBER","nullable":true,"description":null},{"name":"source_checksum_sha256","type":"TEXT","nullable":true,"description":null},{"name":"is_provisional","type":"LOGIC","nullable":false,"description":"True when the file is stored as source cells only. False when the verified German statement columns were read."},{"name":"is_current","type":"LOGIC","nullable":false,"description":"True for the latest stored SUCCESS statement on this Ads connection. Use this row when reading statement metadata. Older statements repeat the same invoices."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"When DataDoe last stored this statement request."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Ads billing statement requests. One row per statement. Each statement covers the previous 30 complete UTC days, so the next statement repeats invoices. date is the day DataDoe requested the statement. Use the row where is_current is true. This is request metadata, not a list of charges. The download link from Amazon is not stored. is_provisional is false when the verified German statement columns were read.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_billing_statements","raw_ads_api_billing_statement_rows"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["billing statement","ads statement"]},{"id":"553217419730fcbb2eba3adc64300ed34a0f3ce88a1c4c47e8c223ee33f763a5","name":"Ads Billing Statement Rows","tableName":"amazon_ads_billing_statement_rows","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":"Day DataDoe requested the statement."},{"name":"statement_request_id","type":"TEXT","nullable":false,"description":null},{"name":"row_index","type":"NUMBER","nullable":false,"description":"Zero-based position of the source row. The header is not a row."},{"name":"invoice_id","type":"TEXT","nullable":true,"description":"Amazon invoice id from the statement. It can match an Ads invoice. It is not a vendor remittance id."},{"name":"invoice_issue_date","type":"DATE","nullable":true,"description":"Invoice issue date from the statement."},{"name":"due_date","type":"DATE","nullable":true,"description":"Invoice due date from the statement."},{"name":"invoice_status","type":"TEXT","nullable":true,"description":"Invoice status text from the statement, such as Paid In Full. The invoice API uses a separate status code."},{"name":"payment_method","type":"TEXT","nullable":true,"description":"Payment method text from the statement. A deduction can show as Deduct From Payment. DataDoe keeps the statement text."},{"name":"currency_code","type":"TEXT","nullable":true,"description":"Currency of the unconverted amounts."},{"name":"billed_amount","type":"NUMBER","nullable":true,"description":"Billed amount in currency_code, before conversion. A dash in the file means there is no value."},{"name":"tax_amount","type":"NUMBER","nullable":true,"description":"Tax amount in currency_code, before conversion."},{"name":"outstanding_amount","type":"NUMBER","nullable":true,"description":"Outstanding amount in currency_code, before conversion."},{"name":"paid_amount","type":"NUMBER","nullable":true,"description":"Paid amount in currency_code, before conversion."},{"name":"currency_service_fee","type":"NUMBER","nullable":true,"description":"Currency service fee in currency_code. A dash in the file means there is no value."},{"name":"exchange_rate","type":"NUMBER","nullable":true,"description":"Exchange rate on the invoice date. This is a rate, not an amount."},{"name":"country_name","type":"TEXT","nullable":true,"description":"Country name from the statement. This is not the connection marketplace."},{"name":"account_type","type":"TEXT","nullable":true,"description":"Account type text from the statement."},{"name":"account_name","type":"TEXT","nullable":true,"description":"Account name from the statement."},{"name":"account_identifier","type":"TEXT","nullable":true,"description":"Account id text from the statement. This is not the Ads profile id."},{"name":"company_name","type":"TEXT","nullable":true,"description":"Company name from the statement."},{"name":"account_label","type":"TEXT","nullable":true,"description":"Account label from the statement."},{"name":"order_name","type":"TEXT","nullable":true,"description":"Order name from the statement. A dash in the file means there is no value."},{"name":"order_number","type":"TEXT","nullable":true,"description":"Order number from the statement. A dash in the file means there is no value."},{"name":"purchase_order_number","type":"TEXT","nullable":true,"description":"Purchase order number from the statement. A dash in the file means there is no value."},{"name":"is_provisional","type":"LOGIC","nullable":false,"description":"True when this row has a date or amount that could not be read, or when the file headers are not the verified German columns. Leave these rows out of totals."},{"name":"is_current","type":"LOGIC","nullable":false,"description":"True when this row belongs to the latest stored SUCCESS statement on this Ads connection. Sum billed_amount only on these rows, and skip rows where is_provisional is true."},{"name":"source_values","type":"JSON","nullable":false,"description":"Ordered CSV cells as text, in the same order as source_headers."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"When DataDoe stored this statement file."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Rows from an Amazon Ads billing statement. One row per statement and source row. Each statement covers the previous 30 complete UTC days, so later statements repeat invoices. Sum billed_amount only where is_current is true and is_provisional is false. That total counts each invoice once. Skip is_provisional rows because an amount that could not be read is missing. When the file uses the verified German column names, the invoice, amount, date and payment columns are filled. source_values keeps every cell as text, in the same order as source_headers on Ads Billing Statements. A file with other column names leaves the mapped columns empty. These rows do not identify a vendor remittance. The invoice id can match an Ads invoice.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_billing_statements","raw_ads_api_billing_statement_rows"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["billing statement rows","ads statement invoice"]},{"id":"8bf36701444f6d3172457c7191c8a191b3a09bc0f5dbdb8a329ee1a8ae9054f1","name":"Ad Portfolios","tableName":"amazon_ads_portfolios","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":"portfolio_id","type":"TEXT","nullable":false,"description":null},{"name":"portfolio_name","type":"TEXT","nullable":true,"description":null},{"name":"portfolio_state","type":"TEXT","nullable":true,"description":null},{"name":"is_listed_in_last_fetch","type":"LOGIC","nullable":true,"description":"False when the last fetch no longer returned this row. The row keeps its last fetched values."},{"name":"budget_amount","type":"NUMBER","nullable":true,"description":"Portfolio budget cap, in budget_currency."},{"name":"budget_currency","type":"TEXT","nullable":true,"description":null},{"name":"budget_policy","type":"TEXT","nullable":true,"description":"DATE_RANGE / MONTHLY_RECURRING / NO_CAP / OTHER."},{"name":"budget_start_date","type":"TEXT","nullable":true,"description":"Budget start date as returned by Amazon."},{"name":"budget_end_date","type":"TEXT","nullable":true,"description":"Budget end date as returned by Amazon."},{"name":"in_budget","type":"LOGIC","nullable":true,"description":"Whether the portfolio is within its budget."},{"name":"budget_controls","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"serving_status","type":"TEXT","nullable":true,"description":"Portfolio serving status, such as PORTFOLIO_STATUS_ENABLED, PORTFOLIO_OUT_OF_BUDGET, PORTFOLIO_ENDED or ADVERTISER_PAYMENT_FAILURE."},{"name":"status_reasons","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"portfolio_created_at_utc","type":"DATE","nullable":true,"description":null},{"name":"portfolio_updated_at_utc","type":"DATE","nullable":true,"description":null},{"name":"budget_usage_percent","type":"NUMBER","nullable":true,"description":"Budget usage percentage reported by Amazon. A percentage, not money."},{"name":"budget_usage_updated_at_utc","type":"DATE","nullable":true,"description":"Time Amazon computed budget_usage_percent."},{"name":"observed_at_utc","type":"DATE","nullable":true,"description":"Time DataDoe last fetched this row from Amazon Ads."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Ads portfolios with budget caps, serving status and budget usage. One row per portfolio. Portfolios Amazon stopped returning keep their last row with is_listed_in_last_fetch = FALSE. Refreshed daily.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_PORTFOLIOS_ADD","relation":"writes"},{"type":"AMAZON_ADS_PORTFOLIOS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_PORTFOLIOS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_portfolios"],"containsPii":false,"initialLoadProgress":null},{"id":"45d9d2ea7fd38f830c1184ad93e1058e63622319ef1876a4bc56e3090074a5f1","name":"Partner Opportunities","tableName":"amazon_ads_partner_opportunities","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":"partner_opportunity_id","type":"TEXT","nullable":false,"description":"Partner opportunity ID from the catalog. This is not a recommendation ID."},{"name":"snapshot_id","type":"TEXT","nullable":false,"description":null},{"name":"source_row_number","type":"NUMBER","nullable":false,"description":null},{"name":"locale","type":"TEXT","nullable":true,"description":null},{"name":"title","type":"TEXT","nullable":true,"description":null},{"name":"description","type":"TEXT","nullable":true,"description":null},{"name":"objective_type","type":"TEXT","nullable":true,"description":null},{"name":"product","type":"TEXT","nullable":true,"description":null},{"name":"audience","type":"TEXT","nullable":true,"description":null},{"name":"call_to_action","type":"TEXT","nullable":true,"description":null},{"name":"catalog_updated_at","type":"TEXT","nullable":true,"description":"Catalog data timestamp from Amazon, kept as text."},{"name":"first_published_at","type":"DATE","nullable":true,"description":"First published time from the opportunity freshness context."},{"name":"data_source_updated_at","type":"DATE","nullable":true,"description":"Data source update time from the opportunity freshness context."},{"name":"metadata_updated_at","type":"DATE","nullable":true,"description":"Metadata update time from the opportunity freshness context."},{"name":"profile_id","type":"TEXT","nullable":true,"description":null},{"name":"advertiser_type","type":"TEXT","nullable":true,"description":null},{"name":"encrypted_advertiser_id","type":"TEXT","nullable":true,"description":"Advertiser ID from the recommendation file. This is not the Ads account ID."},{"name":"entity_id","type":"TEXT","nullable":true,"description":null},{"name":"entity_name","type":"TEXT","nullable":true,"description":null},{"name":"source_marketplace","type":"TEXT","nullable":true,"description":null},{"name":"recommendation_id","type":"TEXT","nullable":true,"description":null},{"name":"recommendation_type","type":"TEXT","nullable":true,"description":null},{"name":"recommendation_status","type":"TEXT","nullable":true,"description":null},{"name":"apply_api_end_point","type":"TEXT","nullable":true,"description":null},{"name":"explanation","type":"JSON","nullable":true,"description":null},{"name":"campaign_id","type":"TEXT","nullable":true,"description":null},{"name":"campaign_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_product","type":"TEXT","nullable":true,"description":"Amazon ad product from adProduct or adProductType."},{"name":"expiry_date","type":"DATE","nullable":true,"description":null},{"name":"estimated_incremental_sales","type":"TEXT","nullable":true,"description":"Benefit text from Amazon. DataDoe does not convert the unit."},{"name":"estimated_incremental_clicks","type":"TEXT","nullable":true,"description":"Benefit text from Amazon. DataDoe does not convert the unit."},{"name":"current_settings","type":"JSON","nullable":true,"description":null},{"name":"recommended_settings","type":"JSON","nullable":true,"description":"Recommended settings from recommendedSettings or recommendedCampaignSettings."},{"name":"metrics","type":"JSON","nullable":true,"description":null},{"name":"attributes","type":"JSON","nullable":true,"description":null},{"name":"extra_fields","type":"JSON","nullable":true,"description":"Source fields that do not have their own column, kept as Amazon sent them."},{"name":"raw_payload","type":"JSON","nullable":true,"description":null},{"name":"can_apply","type":"LOGIC","nullable":false,"description":"True when this row can be sent to the Partner Network apply Action. Checked again when the Action runs."},{"name":"latest_application_status","type":"TEXT","nullable":true,"description":"Latest DataDoe application status for this recommendation. Null when it has not been applied."},{"name":"latest_amazon_status","type":"TEXT","nullable":true,"description":"Latest status Amazon returned for this recommendation: PUBLISHED, IN_PROGRESS, SUCCESS, FAILED or REJECTED."},{"name":"latest_application_checked_at","type":"DATE","nullable":true,"description":"Time of the latest status read. A status read does not change the original submission time."},{"name":"observed_at","type":"DATE","nullable":true,"description":null}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Ads Partner Network rows for one Ads connection. One row per source row in the latest complete file for that opportunity. Rows without a matching advertiser in this connection are not included. can_apply is true only for current account-team recommendations with a Partner Network apply endpoint. Benefit columns and extra_fields stay as Amazon sent them. A saved Partner Network account ID is required before DataDoe collects this table. DataDoe refreshes it once a day.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_PARTNER_OPPORTUNITIES_FIND","relation":"live"},{"type":"AMAZON_ADS_PARTNER_RECOMMENDATIONS_APPLY","relation":"writes"},{"type":"AMAZON_ADS_PARTNER_RECOMMENDATION_STATUS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_partner_opportunities","raw_ads_api_partner_recommendation_applications"],"containsPii":false,"initialLoadProgress":null},{"id":"52ba79185ae807f4546f56a3ef0b8b836221403fe5e364f232792dc7daf879c9","name":"Ad Budget Rules","tableName":"amazon_ads_budget_rules","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_product","type":"TEXT","nullable":false,"description":"SPONSORED_PRODUCTS / SPONSORED_BRANDS / SPONSORED_DISPLAY."},{"name":"budget_rule_id","type":"TEXT","nullable":false,"description":null},{"name":"budget_rule_name","type":"TEXT","nullable":true,"description":null},{"name":"budget_rule_type","type":"TEXT","nullable":true,"description":"SCHEDULE / PERFORMANCE."},{"name":"budget_rule_state","type":"TEXT","nullable":true,"description":"Rule state, such as ACTIVE or PAUSED."},{"name":"budget_rule_status","type":"TEXT","nullable":true,"description":"Rule status as returned by Amazon."},{"name":"budget_rule_created_at_utc","type":"DATE","nullable":true,"description":null},{"name":"budget_rule_updated_at_utc","type":"DATE","nullable":true,"description":null},{"name":"budget_increase_type","type":"TEXT","nullable":true,"description":"Budget increase type, such as PERCENT."},{"name":"budget_increase_value","type":"NUMBER","nullable":true,"description":"Budget increase in budget_increase_type units."},{"name":"budget_rule_start_date","type":"TEXT","nullable":true,"description":"Start day as Amazon YYYYMMDD string."},{"name":"budget_rule_end_date","type":"TEXT","nullable":true,"description":"End day as Amazon YYYYMMDD string."},{"name":"budget_rule_event_id","type":"TEXT","nullable":true,"description":"Event of an event-based schedule rule."},{"name":"budget_rule_event_name","type":"TEXT","nullable":true,"description":null},{"name":"budget_rule_metric_name","type":"TEXT","nullable":true,"description":"Performance rule metric: ACOS / CTR / CVR / ROAS."},{"name":"budget_rule_comparison_operator","type":"TEXT","nullable":true,"description":"GREATER_THAN / LESS_THAN / EQUAL_TO / LESS_THAN_OR_EQUAL_TO / GREATER_THAN_OR_EQUAL_TO."},{"name":"budget_rule_threshold","type":"NUMBER","nullable":true,"description":"Performance rule metric threshold."},{"name":"budget_rule_recurrence","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"budget_rule_duration","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"budget_rule_performance_measure_condition","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Budget rules for Sponsored Products, Sponsored Brands and Sponsored Display, including rules created in the Amazon Ads console. One row per ad product and rule from the latest fetch. A schedule rule raises the budget on dates or during an Amazon event. A performance rule raises the budget when a metric crosses a threshold. DataDoe refreshes this table every 3 hours.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_SP_BUDGET_RULES_ADD","relation":"writes"},{"type":"AMAZON_ADS_SP_BUDGET_RULES_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_SP_BUDGET_RULES_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_SB_BUDGET_RULES_ADD","relation":"writes"},{"type":"AMAZON_ADS_SB_BUDGET_RULES_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_SB_BUDGET_RULES_REMOVE","relation":"writes"},{"type":"AMAZON_ADS_SD_BUDGET_RULES_ADD","relation":"writes"},{"type":"AMAZON_ADS_SD_BUDGET_RULES_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_SD_BUDGET_RULES_REMOVE","relation":"writes"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_budget_rules","raw_ads_api_budget_rule_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"1f6073ce44c732a7674a445d9890ae07f032c1484149181f527488b8fef25543","name":"Ad Budget Rule Campaigns","tableName":"amazon_ads_budget_rule_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":"ad_product","type":"TEXT","nullable":false,"description":"SPONSORED_PRODUCTS / SPONSORED_BRANDS / SPONSORED_DISPLAY."},{"name":"budget_rule_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":true,"description":null},{"name":"budget_rule_campaign_status","type":"TEXT","nullable":true,"description":"Amazon status of this rule on this campaign at the last fetch. ACTIVE means Amazon is applying the rule. PAUSED means the rule is paused. ON_HOLD means Amazon is not applying the rule at that time, including when an intraday rule is outside its time window. EXPIRED means the rule dates have ended. A query does not recompute this status."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Campaigns attached to budget rules from the latest fetch. One row per ad product, rule and campaign for Sponsored Products, Sponsored Brands and Sponsored Display. Rule definitions are in amazon_ads_budget_rules. DataDoe refreshes this table every 3 hours.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_SP_BUDGET_RULES_ASSOCIATE","relation":"writes"},{"type":"AMAZON_ADS_SB_BUDGET_RULES_ASSOCIATE","relation":"writes"},{"type":"AMAZON_ADS_SD_BUDGET_RULES_ASSOCIATE","relation":"writes"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_budget_rule_campaigns","raw_ads_api_budget_rule_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"b95e2fa1925efdea437f3dd29db33d4264e3361bdccc613e13c09c3914e2a185","name":"Ad Recommendation Snapshots","tableName":"amazon_ads_recommendation_snapshots","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":"UTC day of the snapshot."},{"name":"recommendation_request_id","type":"TEXT","nullable":false,"description":"request_fingerprint and date of the snapshot."},{"name":"request_fingerprint","type":"TEXT","nullable":false,"description":"Hash of the operation and request body. A changed request gets a new fingerprint."},{"name":"operation","type":"TEXT","nullable":false,"description":"SB_BUDGET_RECOMMENDATIONS / SP_BUDGET_RULE_EVENTS / SB_BUDGET_RULE_EVENTS / SP_BID_RECOMMENDATIONS / SP_KEYWORD_RECOMMENDATIONS / SB_BID_RECOMMENDATIONS / SP_PRODUCT_TARGET_RECOMMENDATIONS / SB_KEYWORD_RECOMMENDATIONS / SB_PRODUCT_TARGET_RECOMMENDATIONS."},{"name":"ad_product","type":"TEXT","nullable":false,"description":"SPONSORED_PRODUCTS / SPONSORED_BRANDS."},{"name":"recommendation_type","type":"TEXT","nullable":false,"description":"BUDGET / BUDGET_RULE_EVENT / BID / KEYWORD / PRODUCT_TARGET."},{"name":"ad_campaign_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":null},{"name":"asin","type":"TEXT","nullable":true,"description":"Set only when the request has exactly one ASIN."},{"name":"request_parameters","type":"JSON","nullable":false,"description":"Request body sent to Amazon Ads API."},{"name":"recommendation_payload","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"response_status","type":"TEXT","nullable":false,"description":"SUCCESS / PARTIAL (some items failed) / ERROR."},{"name":"http_status","type":"NUMBER","nullable":true,"description":null},{"name":"failure_code","type":"TEXT","nullable":true,"description":"Amazon error code or HTTP_<status>. Null on SUCCESS."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"Time DataDoe called Amazon Ads API."},{"name":"expires_at_utc","type":"DATE","nullable":true,"description":"Recommendation expiry. Currently always null."},{"name":"is_latest_snapshot","type":"LOGIC","nullable":false,"description":"True for the newest day of each request_fingerprint."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily snapshots of Amazon Ads budget, bid, keyword, product-target and budget-rule-event recommendations for Sponsored Products and Sponsored Brands. One row per request and UTC day; is_latest_snapshot = TRUE is the current answer of a request. Errors are stored as snapshots too.","requiresDatePeriod":true,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND","relation":"live"},{"type":"AMAZON_ADS_SP_TARGET_RECOMMENDATIONS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_recommendation_snapshots"],"containsPii":false,"initialLoadProgress":null},{"id":"2f11a8603224c8424c7167ac1ac1e58ad9e85aa397a5031ddbbaaacc5eae761f","name":"Ad Creative Versions","tableName":"amazon_ads_creative_versions","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":true,"description":null},{"name":"ad_campaign_id","type":"TEXT","nullable":true,"description":null},{"name":"ad_campaign_type","type":"TEXT","nullable":true,"description":"SPONSORED_BRANDS."},{"name":"creative_version","type":"TEXT","nullable":false,"description":"Numeric version string."},{"name":"is_latest_creative_version","type":"LOGIC","nullable":false,"description":null},{"name":"creative_type","type":"TEXT","nullable":true,"description":"PRODUCT_COLLECTION / STORE_SPOTLIGHT / VIDEO / BRAND_VIDEO."},{"name":"creative_status","type":"TEXT","nullable":true,"description":"SUBMITTED_FOR_MODERATION / PENDING_TRANSLATION / PENDING_MODERATION_REVIEW / APPROVED_BY_MODERATION / REJECTED_BY_MODERATION / PUBLISHED."},{"name":"creative_created_at_utc","type":"DATE","nullable":true,"description":null},{"name":"creative_updated_at_utc","type":"DATE","nullable":true,"description":null},{"name":"creative_headline","type":"TEXT","nullable":true,"description":null},{"name":"creative_original_headline","type":"TEXT","nullable":true,"description":"Headline before translation."},{"name":"creative_headlines","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_brand_name","type":"TEXT","nullable":true,"description":null},{"name":"creative_asins","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_landing_page_type","type":"TEXT","nullable":true,"description":"PRODUCT_LIST / STORE / CUSTOM_URL / DETAIL_PAGE."},{"name":"creative_landing_page_value","type":"TEXT","nullable":true,"description":null},{"name":"creative_landing_page_asins","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"creative_consent_to_translate","type":"LOGIC","nullable":true,"description":null},{"name":"creative_collection_type","type":"TEXT","nullable":true,"description":null},{"name":"creative_properties","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"moderation_ad_program_type","type":"TEXT","nullable":true,"description":"SB_PRODUCT_COLLECTION / SB_VIDEO / SB_STORE_SPOTLIGHT."},{"name":"moderation_status","type":"TEXT","nullable":true,"description":"APPROVED / IN_PROGRESS / REJECTED / FAILED."},{"name":"moderation_policy_violations","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"moderation_eta","type":"TEXT","nullable":true,"description":"Moderation ETA as returned by Amazon."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"Time DataDoe last fetched this row from Amazon Ads."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Sponsored Brands ad creative versions with moderation results. One row per ad and creative version; is_latest_creative_version = TRUE is the current creative.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_ADS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_ADS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_sb_ad_creative_versions","raw_ads_api_ad_moderation_results","raw_ads_api_ad_creatives"],"containsPii":false,"initialLoadProgress":null},{"id":"f61edae11640cffe6b35c6c7d88ccc46476cc9980daa3aee5a4e698794a041a7","name":"Ads Attribution Tags","tableName":"amazon_ads_attribution_tags","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":"attribution_advertiser_id","type":"TEXT","nullable":false,"description":null},{"name":"attribution_advertiser_name","type":"TEXT","nullable":true,"description":null},{"name":"publisher_id","type":"TEXT","nullable":false,"description":null},{"name":"publisher_name","type":"TEXT","nullable":true,"description":null},{"name":"tag_type","type":"TEXT","nullable":false,"description":"MACRO / NON_MACRO_TEMPLATE."},{"name":"tag_template","type":"TEXT","nullable":false,"description":"Attribution tag template to append to the off-Amazon link."},{"name":"is_listed_in_last_fetch","type":"LOGIC","nullable":false,"description":"False when the last fetch no longer returned this row. The row keeps its last fetched values."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"Time DataDoe last fetched this row from Amazon Ads."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Amazon Attribution tags (URL parameter templates) per Attribution advertiser and publisher. Use them to tag off-Amazon links; results are in the amazon_ads_attribution_* tables.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_ATTRIBUTION_PUBLISHERS_FIND","relation":"live"},{"type":"AMAZON_ADS_ATTRIBUTION_ADVERTISERS_FIND","relation":"live"},{"type":"AMAZON_ADS_ATTRIBUTION_MACRO_TAGS_FIND","relation":"writes"},{"type":"AMAZON_ADS_ATTRIBUTION_NON_MACRO_TAG_TEMPLATES_FIND","relation":"writes"},{"type":"AMAZON_ADS_ATTRIBUTION_TAGS_GENERATE","relation":"writes"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_attribution_tags"],"containsPii":false,"initialLoadProgress":null},{"id":"bd8c2384f1d4a4dc5f032c5ec1c01d3b93d8d12db92c43089f7d6b2e963978ce","name":"Ads Author Brands","tableName":"amazon_ads_author_brands","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":"author_brand_id","type":"TEXT","nullable":false,"description":"Sponsored Brands brand ID of the author."},{"name":"author_brand_entity_id","type":"TEXT","nullable":true,"description":null},{"name":"author_brand_name","type":"TEXT","nullable":true,"description":"Author name of the brand."},{"name":"is_listed_in_last_fetch","type":"LOGIC","nullable":false,"description":"False when the last fetch no longer returned this row. The row keeps its last fetched values."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"Time DataDoe last fetched this row from Amazon Ads."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Sponsored Brands author brands (bookAuthor) of KDP author Ads accounts. Refreshed weekly.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_BRANDS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_brands"],"containsPii":false,"initialLoadProgress":null},{"id":"61399195cbdacdb2f33c74281188117dea775e338fae68699a632141673d07f4","name":"Ads Brand Stores","tableName":"amazon_ads_stores","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_entity_id","type":"TEXT","nullable":false,"description":"Amazon brand entity id used to request Store Insights."},{"name":"brand_store_id","type":"TEXT","nullable":false,"description":"Amazon Brand Store id. The DataDoe store id is store_id."},{"name":"brand_store_name","type":"TEXT","nullable":true,"description":"Amazon Brand Store name."},{"name":"brand_store_status","type":"TEXT","nullable":true,"description":"Store status returned by Amazon. Empty when Amazon does not provide one."},{"name":"synced_at","type":"DATE","nullable":false,"description":"When this fetch finished."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Current Amazon Brand Stores for an Ads connection. One row per store. A store Amazon stops listing stays here, with its last known name and status. Refreshed daily.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_stores"],"containsPii":false,"initialLoadProgress":null},{"id":"8c44ddef424bbbb1ac0c08d43af324cb2b42643bb9397f9d3169dc630aabc3ef","name":"Ads Brand Store Pages","tableName":"amazon_ads_store_pages","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_entity_id","type":"TEXT","nullable":false,"description":"Amazon brand entity id used to request Store Insights."},{"name":"brand_store_id","type":"TEXT","nullable":false,"description":"Amazon Brand Store id. The DataDoe store id is store_id."},{"name":"brand_store_name","type":"TEXT","nullable":true,"description":"Amazon Brand Store name from the latest store list. Empty when Amazon no longer lists the store."},{"name":"page_id","type":"TEXT","nullable":false,"description":"Amazon Brand Store page id."},{"name":"page_name","type":"TEXT","nullable":true,"description":"Page name. Empty when Amazon does not provide one."},{"name":"page_status","type":"TEXT","nullable":true,"description":"Page status returned by Amazon. Empty when Amazon does not provide one."},{"name":"page_url","type":"TEXT","nullable":true,"description":"Page URL. Empty when Amazon does not provide one."},{"name":"synced_at","type":"DATE","nullable":false,"description":"When this fetch finished."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Current pages of Amazon Brand Stores. One row per store and page. A page that disappears stays here, with its last known name and URL. Refreshed daily.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_store_pages","raw_ads_api_stores"],"containsPii":false,"initialLoadProgress":null},{"id":"b67372355ea0e0ca413b82544fc89495646ec996212959d236bd6896ef5698d6","name":"Ads Brand Store Insights by Date","tableName":"amazon_ads_store_insights_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":"brand_entity_id","type":"TEXT","nullable":false,"description":"Amazon brand entity id used to request Store Insights."},{"name":"brand_store_id","type":"TEXT","nullable":false,"description":"Amazon Brand Store id. The DataDoe store id is store_id."},{"name":"brand_store_name","type":"TEXT","nullable":true,"description":"Amazon Brand Store name from the latest store list. Empty when Amazon no longer lists the store."},{"name":"date","type":"DATE","nullable":false,"description":"Calendar date of the store insight, in the Ads profile timezone."},{"name":"views","type":"NUMBER","nullable":true,"description":"Store page views. Product detail page glance views are a different measure."},{"name":"visits","type":"NUMBER","nullable":true,"description":"Visits counted within the day. One person can visit more than one page or come from more than one source."},{"name":"visitors","type":"NUMBER","nullable":true,"description":"Unique visitors to the store on that day. A total across days is a sum of daily counts, so the same person can be counted on more than one day."},{"name":"orders","type":"NUMBER","nullable":true,"description":"Estimated orders by store visitors within 14 days of their visit."},{"name":"units","type":"NUMBER","nullable":true,"description":"Estimated units bought within 14 days of the last store visit."},{"name":"sales","type":"NUMBER","nullable":true,"description":"Estimated sales within 14 days of the last store visit, in currency_code. DataDoe does not convert this amount."},{"name":"currency_code","type":"TEXT","nullable":true,"description":"Currency of the Amazon Ads profile. Empty when that currency is not known."},{"name":"synced_at","type":"DATE","nullable":false,"description":"When this fetch finished."},{"name":"views_per_visit","type":"NUMBER","nullable":true,"description":"Views divided by visits. Empty when visits are zero or missing. For more than one day, divide the summed views by the summed visits."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily Brand Store totals: page views, visits, unique visitors, and estimated orders, units and sales within 14 days of a store visit. Visitors are unique for that day only. A total across days counts the same person again on each day they visit. views_per_visit is views divided by visits. Sales stay in the Ads profile currency. The first load covers 418 days. Later loads refresh the latest 30 days. Collection runs daily. Amazon decides how fresh the figures are.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":418},{"type":"RECURRING_DAILY","numberOfDays":30}],"sources":["connections","raw_ads_api_store_insights","raw_ads_api_stores"],"containsPii":false,"initialLoadProgress":null},{"id":"da3a5f41fe6bbd444793cd6687ab884193a61597ec702c5dc1b71925c75cf5d9","name":"Ads Brand Store Insights by Page","tableName":"amazon_ads_store_insights_by_page_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":"brand_entity_id","type":"TEXT","nullable":false,"description":"Amazon brand entity id used to request Store Insights."},{"name":"brand_store_id","type":"TEXT","nullable":false,"description":"Amazon Brand Store id. The DataDoe store id is store_id."},{"name":"brand_store_name","type":"TEXT","nullable":true,"description":"Amazon Brand Store name from the latest store list. Empty when Amazon no longer lists the store."},{"name":"date","type":"DATE","nullable":false,"description":"Calendar date of the store insight, in the Ads profile timezone."},{"name":"page_id","type":"TEXT","nullable":false,"description":"Amazon Brand Store page id."},{"name":"page_name","type":"TEXT","nullable":true,"description":"Page name from the latest page list. Empty when the page is no longer listed."},{"name":"page_status","type":"TEXT","nullable":true,"description":"Page status from the latest page list. Empty when the page is no longer listed."},{"name":"page_url","type":"TEXT","nullable":true,"description":"Page URL from the latest page list. Empty when the page is no longer listed."},{"name":"views","type":"NUMBER","nullable":true,"description":"Store page views. Product detail page glance views are a different measure."},{"name":"visits","type":"NUMBER","nullable":true,"description":"Visits counted within the day. One person can visit more than one page or come from more than one source."},{"name":"orders","type":"NUMBER","nullable":true,"description":"Estimated orders by store visitors within 14 days of their visit."},{"name":"units","type":"NUMBER","nullable":true,"description":"Estimated units bought within 14 days of the last store visit."},{"name":"sales","type":"NUMBER","nullable":true,"description":"Estimated sales within 14 days of the last store visit, in currency_code. DataDoe does not convert this amount."},{"name":"currency_code","type":"TEXT","nullable":true,"description":"Currency of the Amazon Ads profile. Empty when that currency is not known."},{"name":"synced_at","type":"DATE","nullable":false,"description":"When this fetch finished."},{"name":"views_per_visit","type":"NUMBER","nullable":true,"description":"Views divided by visits. Empty when visits are zero or missing. For more than one day, divide the summed views by the summed visits."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily page performance for Amazon Brand Stores. One row per store, date and page. Visitor counts stay on the daily store total. Page name and URL come from the latest page list and are empty when the page is no longer listed. These rows are separate from daily store totals.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":60},{"type":"RECURRING_DAILY","numberOfDays":3}],"sources":["connections","raw_ads_api_store_insights","raw_ads_api_store_pages","raw_ads_api_stores"],"containsPii":false,"initialLoadProgress":null},{"id":"0435dbb851e5bab216e639a19de17b4e1c5882e34f1c0f76714172bc4384193d","name":"Ads Brand Store Insights by Source","tableName":"amazon_ads_store_insights_by_source_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":"brand_entity_id","type":"TEXT","nullable":false,"description":"Amazon brand entity id used to request Store Insights."},{"name":"brand_store_id","type":"TEXT","nullable":false,"description":"Amazon Brand Store id. The DataDoe store id is store_id."},{"name":"brand_store_name","type":"TEXT","nullable":true,"description":"Amazon Brand Store name from the latest store list. Empty when Amazon no longer lists the store."},{"name":"date","type":"DATE","nullable":false,"description":"Calendar date of the store insight, in the Ads profile timezone."},{"name":"traffic_source","type":"TEXT","nullable":false,"description":"Traffic source category returned by Amazon for that day."},{"name":"views","type":"NUMBER","nullable":true,"description":"Store page views. Product detail page glance views are a different measure."},{"name":"visits","type":"NUMBER","nullable":true,"description":"Visits counted within the day. One person can visit more than one page or come from more than one source."},{"name":"orders","type":"NUMBER","nullable":true,"description":"Estimated orders by store visitors within 14 days of their visit."},{"name":"units","type":"NUMBER","nullable":true,"description":"Estimated units bought within 14 days of the last store visit."},{"name":"sales","type":"NUMBER","nullable":true,"description":"Estimated sales within 14 days of the last store visit, in currency_code. DataDoe does not convert this amount."},{"name":"currency_code","type":"TEXT","nullable":true,"description":"Currency of the Amazon Ads profile. Empty when that currency is not known."},{"name":"synced_at","type":"DATE","nullable":false,"description":"When this fetch finished."},{"name":"views_per_visit","type":"NUMBER","nullable":true,"description":"Views divided by visits. Empty when visits are zero or missing. For more than one day, divide the summed views by the summed visits."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily Brand Store traffic by the source category Amazon returned. Amazon chooses the categories, and they can change. Social traffic stays as the category Amazon sent. Visitor counts stay on the daily store total. These rows are separate from page rows and daily store totals.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":60},{"type":"RECURRING_DAILY","numberOfDays":3}],"sources":["connections","raw_ads_api_store_insights","raw_ads_api_stores"],"containsPii":false,"initialLoadProgress":null},{"id":"a2eb24fed76b17532f460b78ddd08952dcfd5baca0de168eb2dedb3f9ce26183","name":"Ads Brand Store Insights by Tag","tableName":"amazon_ads_store_insights_by_tag_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":"brand_entity_id","type":"TEXT","nullable":false,"description":"Amazon brand entity id used to request Store Insights."},{"name":"brand_store_id","type":"TEXT","nullable":false,"description":"Amazon Brand Store id. The DataDoe store id is store_id."},{"name":"brand_store_name","type":"TEXT","nullable":true,"description":"Amazon Brand Store name from the latest store list. Empty when Amazon no longer lists the store."},{"name":"date","type":"DATE","nullable":false,"description":"Calendar date of the store insight, in the Ads profile timezone."},{"name":"traffic_tag","type":"TEXT","nullable":false,"description":"Store source tag returned by Amazon. Amazon Attribution tags are a different field."},{"name":"views","type":"NUMBER","nullable":true,"description":"Store page views. Product detail page glance views are a different measure."},{"name":"visits","type":"NUMBER","nullable":true,"description":"Visits counted within the day. One person can visit more than one page or come from more than one source."},{"name":"orders","type":"NUMBER","nullable":true,"description":"Estimated orders by store visitors within 14 days of their visit."},{"name":"units","type":"NUMBER","nullable":true,"description":"Estimated units bought within 14 days of the last store visit."},{"name":"sales","type":"NUMBER","nullable":true,"description":"Estimated sales within 14 days of the last store visit, in currency_code. DataDoe does not convert this amount."},{"name":"currency_code","type":"TEXT","nullable":true,"description":"Currency of the Amazon Ads profile. Empty when that currency is not known."},{"name":"synced_at","type":"DATE","nullable":false,"description":"When this fetch finished."},{"name":"views_per_visit","type":"NUMBER","nullable":true,"description":"Views divided by visits. Empty when visits are zero or missing. For more than one day, divide the summed views by the summed visits."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily Brand Store traffic by store source tag. Amazon Attribution tags are a different field. Visitor counts stay on the daily store total. These rows are separate from the other store insight tables.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":60},{"type":"RECURRING_DAILY","numberOfDays":3}],"sources":["connections","raw_ads_api_store_insights","raw_ads_api_stores"],"containsPii":false,"initialLoadProgress":null},{"id":"fe7d4cb4edc4344a5fc6a9e3edbdfb984517bb6d2d43c56c8d91df72cbc90fbf","name":"Ads Brand Store Insights by Page and Source","tableName":"amazon_ads_store_insights_by_page_by_source_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":"brand_entity_id","type":"TEXT","nullable":false,"description":"Amazon brand entity id used to request Store Insights."},{"name":"brand_store_id","type":"TEXT","nullable":false,"description":"Amazon Brand Store id. The DataDoe store id is store_id."},{"name":"brand_store_name","type":"TEXT","nullable":true,"description":"Amazon Brand Store name from the latest store list. Empty when Amazon no longer lists the store."},{"name":"date","type":"DATE","nullable":false,"description":"Calendar date of the store insight, in the Ads profile timezone."},{"name":"page_id","type":"TEXT","nullable":false,"description":"Amazon Brand Store page id."},{"name":"page_name","type":"TEXT","nullable":true,"description":"Page name from the latest page list. Empty when the page is no longer listed."},{"name":"page_status","type":"TEXT","nullable":true,"description":"Page status from the latest page list. Empty when the page is no longer listed."},{"name":"page_url","type":"TEXT","nullable":true,"description":"Page URL from the latest page list. Empty when the page is no longer listed."},{"name":"traffic_source","type":"TEXT","nullable":false,"description":"Traffic source category Amazon returned for this page and day. Social traffic stays as the category Amazon sent."},{"name":"views","type":"NUMBER","nullable":true,"description":"Store page views. Product detail page glance views are a different measure."},{"name":"visits","type":"NUMBER","nullable":true,"description":"Visits counted within the day. One person can visit more than one page or come from more than one source."},{"name":"orders","type":"NUMBER","nullable":true,"description":"Estimated orders by store visitors within 14 days of their visit."},{"name":"units","type":"NUMBER","nullable":true,"description":"Estimated units bought within 14 days of the last store visit."},{"name":"sales","type":"NUMBER","nullable":true,"description":"Estimated sales within 14 days of the last store visit, in currency_code. DataDoe does not convert this amount."},{"name":"currency_code","type":"TEXT","nullable":true,"description":"Currency of the Amazon Ads profile. Empty when that currency is not known."},{"name":"synced_at","type":"DATE","nullable":false,"description":"When this fetch finished."},{"name":"views_per_visit","type":"NUMBER","nullable":true,"description":"Views divided by visits. Empty when visits are zero or missing. For more than one day, divide the summed views by the summed visits."}],"userManaged":false,"isPremium":true,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Daily Brand Store traffic by page and the source category Amazon returned for that page. One row per store, date, page and source. Amazon returns these figures for that page only. They are separate from page totals and from source totals for the whole store. Visitor counts stay on the daily store total. Page name and URL come from the latest page list and are empty when the page is no longer listed. Sales stay in the Ads profile currency.","requiresDatePeriod":true,"issues":[],"fetchPeriods":[{"type":"INITIAL","numberOfDays":7},{"type":"RECURRING_DAILY","numberOfDays":1}],"sources":["connections","raw_ads_api_store_page_source_insights","raw_ads_api_store_pages","raw_ads_api_stores"],"containsPii":false,"initialLoadProgress":null},{"id":"fe20bbfb0d5095194762ed73a18e4581fee4040414b1cd67cabda390ad4edd37","name":"Ads Product Catalog","tableName":"amazon_ads_product_catalog","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":"asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":true,"description":"Seller SKU. Null when Amazon returned none, including for KDP authors."},{"name":"product_title","type":"TEXT","nullable":true,"description":"Product or book title."},{"name":"product_brand","type":"TEXT","nullable":true,"description":"Brand returned by Amazon."},{"name":"product_category","type":"TEXT","nullable":true,"description":"Product category returned by Amazon."},{"name":"availability","type":"TEXT","nullable":true,"description":"Availability returned by Amazon."},{"name":"image_url","type":"TEXT","nullable":true,"description":"Product image URL returned by Amazon."},{"name":"price_to_pay_amount","type":"NUMBER","nullable":true,"description":"Current buy price, in price_to_pay_currency. Null when Amazon omits it or the amount is not numeric."},{"name":"price_to_pay_currency","type":"TEXT","nullable":true,"description":"Currency of price_to_pay_amount. Not inferred when Amazon omits it."},{"name":"basis_price_amount","type":"NUMBER","nullable":true,"description":"List or strike-through price, in basis_price_currency. Null when Amazon omits it or the amount is not numeric."},{"name":"basis_price_currency","type":"TEXT","nullable":true,"description":"Currency of basis_price_amount. Not inferred when Amazon omits it."},{"name":"best_seller_rank","type":"TEXT","nullable":true,"description":"Best seller rank as returned by Amazon. Text, not a number."},{"name":"first_available_date_raw","type":"TEXT","nullable":true,"description":"Date the product was first available, unparsed as returned by Amazon."},{"name":"global_store_catalog_source_country_code","type":"TEXT","nullable":true,"description":"Catalog source country code from Amazon global store settings."},{"name":"variation_asins","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"sp_eligibility_status","type":"TEXT","nullable":true,"description":"Sponsored Products eligibility for this Ads connection, ASIN, and SKU. Null when that program returned no result. Null means unknown, not ineligible."},{"name":"sp_ineligibility_codes","type":"JSON","nullable":true,"description":"JSON array of Sponsored Products ineligibility codes for this Ads connection, ASIN, and SKU. Null when that program returned no result."},{"name":"sp_ineligibility_reasons","type":"JSON","nullable":true,"description":"JSON array of Sponsored Products ineligibility reasons for this Ads connection, ASIN, and SKU. Null when that program returned no result."},{"name":"sb_eligibility_status","type":"TEXT","nullable":true,"description":"Sponsored Brands eligibility for this Ads connection, ASIN, and SKU. Null when that program returned no result. Null means unknown, not ineligible."},{"name":"sb_ineligibility_codes","type":"JSON","nullable":true,"description":"JSON array of Sponsored Brands ineligibility codes for this Ads connection, ASIN, and SKU. Null when that program returned no result."},{"name":"sb_ineligibility_reasons","type":"JSON","nullable":true,"description":"JSON array of Sponsored Brands ineligibility reasons for this Ads connection, ASIN, and SKU. Null when that program returned no result."},{"name":"sd_eligibility_status","type":"TEXT","nullable":true,"description":"Sponsored Display eligibility for this Ads connection, ASIN, and SKU. Null when that program returned no result. Null means unknown, not ineligible."},{"name":"sd_ineligibility_codes","type":"JSON","nullable":true,"description":"JSON array of Sponsored Display ineligibility codes for this Ads connection, ASIN, and SKU. Null when that program returned no result."},{"name":"sd_ineligibility_reasons","type":"JSON","nullable":true,"description":"JSON array of Sponsored Display ineligibility reasons for this Ads connection, ASIN, and SKU. Null when that program returned no result."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"Time of the latest product observation for this row. Use it to see how fresh the catalog row is."},{"name":"dt_created","type":"DATE","nullable":false,"description":"Time DataDoe first stored the raw product row. This is export metadata, not an Amazon business date."},{"name":"dt_updated","type":"DATE","nullable":false,"description":"Time DataDoe last updated the raw product row. This is export metadata, not an Amazon business date."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Products you can advertise in Amazon Ads, for sellers, vendors, and books, with Sponsored Products, Sponsored Brands, and Sponsored Display eligibility. One row per Organization, DataDoe Store, Ads connection, marketplace, ASIN, and SKU. A missing SKU is null. Eligibility belongs to that Ads account, not to the ASIN in every account. A missing program status is unknown, not a denial. Amazon DSP is not included. Each Ads connection refreshes every three days, with at most 10,000 products per program. Account permissions and Amazon API availability apply. observed_at_utc is the time of the latest product observation. Existing exports stay on amazon_ads_book_catalog until you select this table. Migration examples: https://app.datadoe.com/hub/docs/datadoe-data/ads-product-catalog.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_product_metadata"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["ads product catalog","product eligibility","advertised products"]},{"id":"38861ef539bc54e8659217afcb3393140afbcf461724a8ca6801354b5deae55d","name":"Ads Book Catalog","tableName":"amazon_ads_book_catalog","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":"asin","type":"TEXT","nullable":false,"description":null},{"name":"sku","type":"TEXT","nullable":true,"description":"Seller SKU. Null when Amazon returned none, as for KDP authors."},{"name":"book_title","type":"TEXT","nullable":true,"description":"Product or book title."},{"name":"product_brand","type":"TEXT","nullable":true,"description":null},{"name":"product_category","type":"TEXT","nullable":true,"description":null},{"name":"availability","type":"TEXT","nullable":true,"description":null},{"name":"image_url","type":"TEXT","nullable":true,"description":null},{"name":"price_to_pay_amount","type":"NUMBER","nullable":true,"description":"Current buy price, in price_to_pay_currency."},{"name":"price_to_pay_currency","type":"TEXT","nullable":true,"description":null},{"name":"basis_price_amount","type":"NUMBER","nullable":true,"description":"List or strike-through price, in basis_price_currency."},{"name":"basis_price_currency","type":"TEXT","nullable":true,"description":null},{"name":"best_seller_rank","type":"TEXT","nullable":true,"description":"Best seller rank as returned by Amazon. Text, not a number."},{"name":"first_available_date_raw","type":"TEXT","nullable":true,"description":"Date the product was first available, unparsed as returned by Amazon."},{"name":"global_store_catalog_source_country_code","type":"TEXT","nullable":true,"description":null},{"name":"variation_asins","type":"JSON","nullable":true,"description":"Same as JSON payload from Amazon Ads API."},{"name":"sp_eligibility_status","type":"TEXT","nullable":true,"description":"SP advertising eligibility status of the product."},{"name":"sp_ineligibility_codes","type":"JSON","nullable":true,"description":"JSON array of SP ineligibility codes."},{"name":"sp_ineligibility_reasons","type":"JSON","nullable":true,"description":"JSON array of SP ineligibility reasons."},{"name":"sb_eligibility_status","type":"TEXT","nullable":true,"description":"SB advertising eligibility status of the product."},{"name":"sb_ineligibility_codes","type":"JSON","nullable":true,"description":"JSON array of SB ineligibility codes."},{"name":"sb_ineligibility_reasons","type":"JSON","nullable":true,"description":"JSON array of SB ineligibility reasons."},{"name":"sd_eligibility_status","type":"TEXT","nullable":true,"description":"SD advertising eligibility status of the product."},{"name":"sd_ineligibility_codes","type":"JSON","nullable":true,"description":"JSON array of SD ineligibility codes."},{"name":"sd_ineligibility_reasons","type":"JSON","nullable":true,"description":"JSON array of SD ineligibility reasons."},{"name":"observed_at_utc","type":"DATE","nullable":false,"description":"Time DataDoe last fetched this row from Amazon Ads."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Deprecated. Use amazon_ads_product_catalog (Ads Product Catalog). It covers the same seller, vendor and book products and eligibility data. Replace book_title with product_title when migrating. This view remains available for compatibility.","requiresDatePeriod":false,"issues":[{"title":"Deprecated","description":"Use Ads Product Catalog (amazon_ads_product_catalog). Read the [Ads Product Catalog guide](https://app.datadoe.com/hub/docs/datadoe-data/ads-product-catalog). This table remains available and has no removal date."}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_product_metadata"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["ads book catalog"]},{"id":"32d706007ac49080b198d45f8a5f495f775e15836ce1394c8bb7e728fea2bb96","name":"Ads Book Associations","tableName":"amazon_ads_book_ad_associations","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_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":"SPONSORED_PRODUCTS / SPONSORED_BRANDS / SPONSORED_DISPLAY."},{"name":"ad_type","type":"TEXT","nullable":true,"description":"Ad or creative type. Values come from the source that reported the ad, such as PRODUCT_AD, VIDEO or PRODUCT_COLLECTION."},{"name":"ad_state","type":"TEXT","nullable":true,"description":"ENABLED / PAUSED / ARCHIVED."},{"name":"product_id_type","type":"TEXT","nullable":true,"description":"ASIN / SKU."},{"name":"product_id","type":"TEXT","nullable":false,"description":"ASIN or SKU, per product_id_type."},{"name":"association_role","type":"TEXT","nullable":false,"description":"ADVERTISED_PRODUCT / STORE_SPOTLIGHT_CARD / LANDING_PAGE_PRODUCT."},{"name":"association_sources","type":"JSON","nullable":false,"description":"JSON array of sources that reported the association: EXPORT_ADS / AD_CREATIVE / SB_CREATIVE_VERSION."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Products (books) associated with each ad: advertised products, Store Spotlight cards and Sponsored Brands landing-page products. One row per ad, product and association role.","requiresDatePeriod":false,"issues":[],"relatedActions":[{"type":"AMAZON_ADS_ADS_UPDATE","relation":"writes"},{"type":"AMAZON_ADS_ADS_FIND","relation":"live"}],"fetchPeriods":[{"type":"CONTINUOUS"}],"sources":["connections","raw_ads_api_export_ads","raw_ads_api_ad_creatives","raw_ads_api_sb_ad_creative_versions"],"containsPii":false,"initialLoadProgress":null},{"id":"10788355fc7e398b903cf1395b6b15e0f867ee9e707be9d46478dc5be906408b","name":"KDP Royalty Parameters","tableName":"amazon_kdp_royalty_parameters","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":"asin","type":"TEXT","nullable":false,"description":"ASIN of the book edition."},{"name":"book_work_id","type":"TEXT","nullable":true,"description":"User-defined ID that groups the editions of one book."},{"name":"book_format","type":"TEXT","nullable":false,"description":"EBOOK / PAPERBACK / HARDCOVER / AUDIOBOOK."},{"name":"currency_code","type":"TEXT","nullable":false,"description":"Currency of all money values of the row."},{"name":"distribution_channel","type":"TEXT","nullable":false,"description":"AMAZON / EXPANDED_DISTRIBUTION."},{"name":"from","type":"DATE","nullable":false,"description":"Same value as effective_from."},{"name":"effective_from","type":"DATE","nullable":false,"description":"First day the parameters apply."},{"name":"effective_to","type":"DATE","nullable":true,"description":"Last day the parameters apply: the day before the next effective_from of the same edition and channel. Null when open-ended."},{"name":"list_price_ex_tax","type":"NUMBER","nullable":true,"description":"List price excluding tax."},{"name":"royalty_rate","type":"NUMBER","nullable":true,"description":"Royalty rate as a fraction, not percent."},{"name":"ebook_royalty_option","type":"TEXT","nullable":true,"description":"SEVENTY_PERCENT / THIRTY_FIVE_PERCENT. Ebooks only."},{"name":"delivery_cost_per_unit","type":"NUMBER","nullable":true,"description":"Ebook delivery cost per unit."},{"name":"printing_cost_per_unit","type":"NUMBER","nullable":true,"description":"Print cost per unit for paperbacks and hardcovers."},{"name":"estimated_royalty_per_unit","type":"NUMBER","nullable":true,"description":"Royalty per unit sold, provided by the user or estimated with KDP rules (see calculation_method)."},{"name":"calculation_method","type":"TEXT","nullable":false,"description":"PROVIDED_PER_UNIT / KDP_RULE_ESTIMATE."},{"name":"ku_page_rate","type":"NUMBER","nullable":true,"description":"Kindle Unlimited royalty per KENP page."},{"name":"ku_rate_month","type":"DATE","nullable":true,"description":"Month that ku_page_rate refers to."},{"name":"audio_royalty_per_unit","type":"NUMBER","nullable":true,"description":"Audiobook royalty per unit."},{"name":"assumption_source","type":"TEXT","nullable":false,"description":"KDP_EXPORT / USER_CONFIGURATION."},{"name":"source_reference","type":"TEXT","nullable":true,"description":"Free-text reference to the source of the parameters."},{"name":"created_at","type":"DATE","nullable":false,"description":null},{"name":"updated_at","type":"DATE","nullable":false,"description":null}],"userManaged":true,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"KDP royalty parameters per book edition, Ads connection and effective period, managed by the user in the DataDoe app, API or MCP. Used to estimate author royalties in amazon_ads_book_economics_by_entity_and_date.","requiresDatePeriod":false,"issues":[],"fetchPeriods":[],"sources":["connections","raw_amazon_kdp_royalty_parameters"],"containsPii":false,"initialLoadProgress":null},{"id":"5e10c29e1e570d4959aadfba5aa1a7dc3f2b303d793c51591090552cf3b578d2","name":"KDP Book Economics","tableName":"amazon_ads_book_economics_by_entity_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":"ad_campaign_type","type":"TEXT","nullable":false,"description":"Always SPONSORED_PRODUCTS."},{"name":"entity_type","type":"TEXT","nullable":false,"description":"AD / AD_GROUP / CAMPAIGN. AD_GROUP and CAMPAIGN rows roll up AD rows."},{"name":"entity_id","type":"TEXT","nullable":false,"description":"ad_id, ad_group_id or ad_campaign_id, per entity_type."},{"name":"ad_campaign_id","type":"TEXT","nullable":false,"description":null},{"name":"ad_campaign_name","type":"TEXT","nullable":true,"description":null},{"name":"ad_group_id","type":"TEXT","nullable":true,"description":"Null on CAMPAIGN rows."},{"name":"ad_group_name","type":"TEXT","nullable":true,"description":"Null on CAMPAIGN rows."},{"name":"ad_id","type":"TEXT","nullable":true,"description":"Null on AD_GROUP and CAMPAIGN rows."},{"name":"advertised_asin","type":"TEXT","nullable":true,"description":"Null on AD_GROUP and CAMPAIGN rows."},{"name":"date","type":"DATE","nullable":false,"description":"Ad click date."},{"name":"currency_code","type":"TEXT","nullable":true,"description":"Currency of all money values of the row."},{"name":"ad_spend","type":"NUMBER","nullable":true,"description":null},{"name":"ad_clicks","type":"NUMBER","nullable":true,"description":null},{"name":"ad_impressions","type":"NUMBER","nullable":true,"description":null},{"name":"ad_sales_14d","type":"NUMBER","nullable":true,"description":"Retail sales attributed within 14 days of a click, all editions."},{"name":"ad_orders_14d","type":"NUMBER","nullable":true,"description":null},{"name":"ad_units_sold_14d","type":"NUMBER","nullable":true,"description":"Units attributed within 14 days of a click, all editions."},{"name":"ad_sales_same_product_14d","type":"NUMBER","nullable":true,"description":"Retail sales of the advertised edition only."},{"name":"ad_units_same_product_14d","type":"NUMBER","nullable":true,"description":"Units of the advertised edition only."},{"name":"kindle_edition_normalized_pages_read_14d","type":"NUMBER","nullable":true,"description":"Kindle Edition Normalized Pages (KENP) read by Kindle Unlimited readers within 14 days of an ad click. A page count, not money. Null for books outside Kindle Unlimited."},{"name":"kindle_edition_normalized_pages_royalties_14d","type":"NUMBER","nullable":true,"description":"Amazon estimate of the royalties for kindle_edition_normalized_pages_read_14d, in the Ads profile currency. Money, not pages. Null for books outside Kindle Unlimited."},{"name":"profit_model","type":"TEXT","nullable":false,"description":"Always KDP_ROYALTIES."},{"name":"product_assignment_method","type":"TEXT","nullable":false,"description":"How purchased editions are assigned to the ad: REPORTED_SINGLE_EDITION / REPORTED_PURCHASED_ASIN / ESTIMATED_MIX (other-edition units split evenly across ads sharing the advertised ASIN in the ad group) / UNSUPPORTED."},{"name":"royalty_costed_units_14d","type":"NUMBER","nullable":false,"description":"Units with a royalty-per-unit assumption."},{"name":"royalty_cost_coverage_rate","type":"NUMBER","nullable":true,"description":"Share of attributed units with a royalty assumption. Ratio, not percent; null without units.","definition":"min(royalty_costed_units_14d / ad_units_sold_14d, 1)"},{"name":"royalty_estimate_status","type":"TEXT","nullable":false,"description":"COMPLETE (all units costed) / PARTIAL (some units costed) / MISSING_ASSUMPTIONS."},{"name":"estimated_sale_royalties_14d","type":"NUMBER","nullable":true,"description":"Estimated royalties from attributed sales: units times royalty per unit of the purchased edition. Null when MISSING_ASSUMPTIONS."},{"name":"ku_royalty_method","type":"TEXT","nullable":false,"description":"KENP_API when Amazon reports KENP royalties, otherwise UNAVAILABLE."},{"name":"estimated_ku_royalties_selected_14d","type":"NUMBER","nullable":true,"description":"Kindle Unlimited royalties used in author earnings.","definition":"kindle_edition_normalized_pages_royalties_14d"},{"name":"estimated_author_earnings_14d","type":"NUMBER","nullable":true,"description":"Estimated author royalties from sales and Kindle Unlimited reads.","definition":"estimated_sale_royalties_14d + estimated_ku_royalties_selected_14d"},{"name":"estimated_author_profit_after_ads_14d","type":"NUMBER","nullable":true,"description":null,"definition":"estimated_author_earnings_14d - ad_spend"},{"name":"royalty_roas_14d","type":"NUMBER","nullable":true,"description":"Author earnings per unit of ad spend. Ratio.","definition":"estimated_author_earnings_14d / ad_spend"},{"name":"royalty_acos_14d","type":"NUMBER","nullable":true,"description":"Ad spend divided by author earnings. Ratio, not percent.","definition":"ad_spend / estimated_author_earnings_14d"},{"name":"estimated_break_even_retail_acos_14d","type":"NUMBER","nullable":true,"description":"Retail ACoS at which ad spend equals author earnings. Ratio, not percent.","definition":"estimated_author_earnings_14d / ad_sales_14d"},{"name":"is_attribution_mature_14d","type":"LOGIC","nullable":false,"description":"True when the report was refreshed at least 17 days after the date (14-day window plus 3 days for restatements)."},{"name":"mature_spend_without_author_earnings","type":"NUMBER","nullable":true,"description":"ad_spend of mature COMPLETE rows that earned nothing; 0 when earnings are positive; null otherwise."},{"name":"royalty_parameter_version","type":"TEXT","nullable":true,"description":"Hash of the royalty parameter rows used. Changes when the parameters change. Null when none were used."},{"name":"estimated_at_utc","type":"DATE","nullable":false,"description":"Query time. The table computes estimates on read."}],"userManaged":false,"isPremium":false,"defaultDataset":false,"enabled":true,"rowCountBilling":true,"description":"Estimated KDP author earnings and profit after ads for Sponsored Products ads, ad groups and campaigns by date, using 14-day attribution. Only Ads connections with KDP royalty parameters for the AMAZON channel. Units are costed per purchased edition with the parameters effective on the date; KENP royalties are Amazon estimates. Estimates are provisional until is_attribution_mature_14d. Do not sum AD, AD_GROUP and CAMPAIGN rows together; filter one entity_type.","requiresDatePeriod":true,"issues":[],"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_sp","raw_ads_api_report_purchased_products_sp","raw_amazon_kdp_royalty_parameters"],"containsPii":false,"initialLoadProgress":null},{"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."},{"name":"ads_account_type","type":"TEXT","nullable":true,"description":"Amazon Ads profile account type: seller / vendor / agency. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"ads_account_subtype","type":"TEXT","nullable":true,"description":"Amazon Ads special account subtype, such as KDP_AUTHOR or AMAZON_ATTRIBUTION. Null for regular accounts and until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"is_kdp_author","type":"LOGIC","nullable":true,"description":"True for a Kindle Direct Publishing author account (ads_account_subtype KDP_AUTHOR), false for other captured profiles. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"ads_profile_currency_code","type":"TEXT","nullable":true,"description":"Currency of the Amazon Ads profile. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"ads_profile_timezone","type":"TEXT","nullable":true,"description":"IANA timezone of the Amazon Ads profile. Null until DataDoe captured the profile. Null on Seller Central, Vendor Central and DSP advertiser rows."},{"name":"amazon_ads_reporting_timezone","type":"TEXT","nullable":true,"description":"IANA timezone from the Amazon Ads profile, such as Europe/London. Null when it is not verified. Seller Central and Vendor Central rows are null. DSP rows use the agency Ads connection timezone, not a DSP advertiser timezone. There is no country or UTC fallback."},{"name":"amazon_ads_reporting_timezone_source","type":"TEXT","nullable":false,"description":"ADS_PROFILE when amazon_ads_reporting_timezone is verified. UNKNOWN when it is not."},{"name":"ads_billing_permission_missing_at","type":"DATE","nullable":true,"description":"When the last Ads Billing check for this connection was denied. Null when the last check succeeded, the connection is not Amazon Ads, or billing has not been checked. DSP advertiser rows are null."}],"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_ads_api_billing_access","raw_connection_dsp_advertisers"],"containsPii":false,"initialLoadProgress":null,"searchAliases":["connection mapping","selling partner id","dsp advertiser","ads profile","billing permission"]}],"recommendedSources":[],"historicalDataStillLoadingNotice":null,"sourceSelectionNotice":null,"missingDataNotice":"If you need data that DataDoe does not have, you can open a ticket to the DataDoe team with datadoe_support_ticket_create.","catalogCoverageNotice":null}