Metric Preference & Profit Signals
Get Metric Preference
Returns the tenant's headline advertising efficiency metric: `poas` (profit on ad spend, the default) or `acos`. This is a display preference only: targets are always stored as POAS (`targets_stored_as`), and break-even POAS is 1.0.
Update Metric Preference
Sets the tenant's headline advertising efficiency metric. The change is logged in the advertising activity log.
Get Ad Account Profit Signals
Returns an ad account's profit-signal settings and health: whether the platform accepts profit values (`supported`, Google Ads and Meta Ads only), the current settings, exactly which fields leave SKU.io (`fields_sent`), the consent notice and the recorded consent, 30-day upload stats (sent, failed, pending, held, clamped, estimated, eligible orders and match rate), the last batch, the last product-feed cost push (Google) and any warnings, e.g. a low match rate.
Update Ad Account Profit Signals
Updates an ad account's profit-signal settings. Profit signals send each matched order's contribution before ads (and, for Google, unit costs in the product feed) to the ad platform so it can bid on profit. Omitted fields keep their stored values.
List Ad Account Profit Signal Uploads
Lists the profit values queued or sent for an ad account, newest first. Each upload names the sales order, the signal type, what triggered it (`fulfilment`, `return`, `cost_change`, `backfill`), the click identifier type, the value sent versus the raw contribution (values below 0 are clamped to 0), status (`pending`, `sent`, `failed`, `superseded`), any hold reason and the platform's conversion window expiry.
Backfill Ad Account Profit Signals
Re-sends profit values for an ad account's orders in a date window. Runs as a queued, tracked background job; poll the returned `tracked_job_log_id` for progress.