Function rollupOptimizationMetricsFromProducts

rollupOptimizationMetricsFromProducts<
    T extends ProductMetricOptimizationLike = Product,
>(
    products: readonly T[],
): (
    | "attention_score"
    | "clicks"
    | "views"
    | "completed_views"
    | "reach"
    | "engagements"
    | "follows"
    | "saves"
    | "profile_visits"
    | "viewed_seconds"
    | "attention_seconds"
)[]
Compute media_buy.supported_optimization_metrics from a product catalog. Per AdCP 3.1 (adcp#4669), this field is the array union of every product's metric_optimization.supported_metrics.

Returns a sorted, de-duplicated array. Empty union → empty array; callers SHOULD treat an empty result as "omit the field" (the wire description says an absent field means "seller declares no specific guarantees").

Stable ordering (alphabetical) so the declaration doesn't churn on insertion order. Pure function; safe to call repeatedly.
Type Parameters
- T extends ProductMetricOptimizationLike = Product
Parameters
- products: readonly T[]
Returns (
    | "attention_score"
    | "clicks"
    | "views"
    | "completed_views"
    | "reach"
    | "engagements"
    | "follows"
    | "saves"
    | "profile_visits"
    | "viewed_seconds"
    | "attention_seconds"
)[]
Example
```
const products: ProductMetricOptimizationLike[] = [
  { metric_optimization: { supported_metrics: ['clicks', 'views'] } },
  { metric_optimization: { supported_metrics: ['views', 'completed_views'] } },
];
rollupOptimizationMetricsFromProducts(products);
// → ['clicks', 'completed_views', 'views']
```
- Defined in src/lib/utils/capability-rollups.ts:62

Function rollupOptimizationMetricsFromProducts

Type Parameters

Parameters

Returns ( | "attention_score" | "clicks" | "views" | "completed_views" | "reach" | "engagements" | "follows" | "saves" | "profile_visits" | "viewed_seconds" | "attention_seconds")[]

Example

Settings

Returns (
| "attention_score"
| "clicks"
| "views"
| "completed_views"
| "reach"
| "engagements"
| "follows"
| "saves"
| "profile_visits"
| "viewed_seconds"
| "attention_seconds"
)[]