@adcp/sdk API Reference - v7.9.0
    Preparing search index...

    Interface TimeBasedPricingOption

    Cost per time unit (hour, day, week, or month) - rate scales with campaign duration. If fixed_price is present, it's fixed pricing. If absent, it's auction-based.

    interface TimeBasedPricingOption {
        pricing_option_id: string;
        pricing_model: "time";
        currency: string;
        fixed_price?: number;
        floor_price?: number;
        price_guidance?: PriceGuidance;
        parameters: {
            time_unit: "hour" | "day" | "week" | "month";
            min_duration?: number;
            max_duration?: number;
        };
        min_spend_per_package?: number;
        price_breakdown?: PriceBreakdown;
        eligible_adjustments?: PriceAdjustmentKind[];
    }
    Index

    Properties

    pricing_option_id pricing_model currency fixed_price? floor_price? price_guidance? parameters min_spend_per_package? price_breakdown? eligible_adjustments?

    Properties

    pricing_option_id: string

    Unique identifier for this pricing option within the product

    pricing_model: "time"

    Cost per time unit - rate scales with campaign duration

    currency: string

    ISO 4217 currency code

    ^[A-Z]{3}$

    fixed_price?: number

    Cost per time unit. If present, this is fixed pricing. If absent, auction-based.

    0

    floor_price?: number

    Minimum acceptable bid per time unit for auction pricing (mutually exclusive with fixed_price). Bids below this value will be rejected.

    0

    price_guidance?: PriceGuidance
    parameters: {
        time_unit: "hour" | "day" | "week" | "month";
        min_duration?: number;
        max_duration?: number;
    }

    Time-based pricing parameters

    Type Declaration

    • time_unit: "hour" | "day" | "week" | "month"

      The time unit for pricing. Total cost = fixed_price × number of time_units in the campaign flight.

    • Optionalmin_duration?: number

      Minimum booking duration in time_units

      1

    • Optionalmax_duration?: number

      Maximum booking duration in time_units. Must be >= min_duration when both are present.

      1

    min_spend_per_package?: number

    Minimum spend requirement per package using this pricing option, in the specified currency

    0

    price_breakdown?: PriceBreakdown
    eligible_adjustments?: PriceAdjustmentKind[]

    Adjustment kinds applicable to this pricing option. Tells buyer agents which adjustments are available before negotiation. When absent, no adjustments are pre-declared — the buyer should check price_breakdown if present.

    Settings

    Member Visibility

    On This Page

    Properties