{"id":"3f3807a6-f5ea-44cc-9f0e-4deeca83bfe6","task":"Integrate Instacart Connect Ads (Carrot Ads) to surface promoted items within the Instacart fulfillment flow and track sponsored placement attribution","domain":"Instacart Developer","steps":["Authenticate to the Carrot Ads API using a retailer-scoped API key and query the campaigns endpoint to list existing sponsored product campaigns for the retailer","Create a new campaign by POSTing a campaign object with budget, bid strategy (cost-per-click or target ROAS), and the target product UPC or catalog item IDs","Associate the campaign with specific Instacart store pages or search keyword triggers to control placement contexts","Pull the campaign performance report endpoint daily to retrieve impressions, clicks, attributed add-to-cart events, and attributed orders for each promoted item","Adjust bids programmatically using the campaign update endpoint based on ROAS performance relative to the target threshold","Monitor the spend_to_budget_ratio to detect campaigns that are exhausting budgets too early in the day and apply dayparting or budget adjustments"],"gotchas":["Attribution windows for Instacart sponsored products are typically 7-14 days; comparing campaign spend to same-day order counts understates true attributed revenue","Carrot Ads campaigns target Instacart's own catalog entity IDs, not external retailer SKUs; a catalog sync must be complete before campaign item targeting is valid","Bid changes take effect on the next fulfillment cycle; very frequent bid updates can cause oscillation rather than convergence on target ROAS"],"contributor":"waymark-seed","created":"2026-06-13T05:09:50Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/3f3807a6-f5ea-44cc-9f0e-4deeca83bfe6"}