OTTO Sponsored Product Ads

Getting credentials

1. In OTTO Partner Connect create an app for your own account (or open the one you use for the Partner API) and enable the Sponsored Product Ads interfaces. You receive a client id and a client secret.
2. Set OTTO_ADS_CLIENT_ID and OTTO_ADS_CLIENT_SECRET. AnythingMCP runs OTTO's client-credentials flow against https://api.otto.market/v1/token with the scope advertising-services; a token lasts 30 minutes and is fetched again when it expires.
3. Orders, products, stock and returns are a separate scope and live in the OTTO Market connector. Keeping ads apart means an app without the advertising interface keeps working there.

Money is in euro cents. Budgets, bids and costs are {"amount": 160, "currency": "EUR"} = 1.60 EUR. The minimum bid and budget amount is 20 (0.20 EUR). Report columns TOTAL_COSTS and TOTAL_SALES are cents too.

Bids live in two places. AUTOMATIC campaigns bid per target (SKU); MANUAL campaigns bid per positive keyword. Negative keywords (no bid) work in both and belong to one target: to exclude a search term for a whole campaign, add it to every target.

Writes are asynchronous. Every create, update and delete answers 202 with changeRequest.requestId. Poll otto_ads_get_change_request (wait a second, then double the wait) until ACCEPTED or REJECTED; a rejection carries rejectionReason. Only one change request per campaign may be PENDING: a second write to the same campaign before the first is done fails with 409. A status change to the status a campaign already has is rejected ("Invalid status transition PAUSED to PAUSED"), so read the campaign first.

Paging. List tools return nextCursor; pass it back as cursor until it is null. limit is 1 to 1000 (default 100).

Reporting. KPIs cover at most the last 90 days and never today. OTTO attributes sales up to 14 days after the click, including other articles of the same brand (totalSalesSeller), so recent days still change. A campaign without impressions in the range answers 404 "Data not found". CSV reports: request one, poll otto_ads_get_report_status until READY, then otto_ads_download_report. At most 200 reports per 24 hours across all report types; a file is kept 24 hours.

Writes change live advertising and spend money: otto_ads_create_campaign, otto_ads_update_campaign, otto_ads_add_targets, otto_ads_update_target_bids, otto_ads_add_keywords, otto_ads_update_keywords. otto_ads_delete_keywords is installed switched off. Confirm amounts with the user before writing.

The read tools were checked against a live advertiser account; the write tools follow OTTO's documentation and a working production integration.