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

    Interface ProvidePerformanceFeedbackRequest

    Request payload for provide_performance_feedback task

    interface ProvidePerformanceFeedbackRequest {
        adcp_major_version?: number;
        media_buy_id: string;
        idempotency_key: string;
        measurement_period: DatetimeRange;
        performance_index: number;
        package_id?: string;
        creative_id?: string;
        metric_type?: MetricType;
        feedback_source?: FeedbackSource;
        context?: ContextObject;
        ext?: ExtensionObject;
    }
    Index

    Properties

    adcp_major_version?: number

    The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.

    1

    99

    media_buy_id: string

    Seller's media buy identifier

    1

    idempotency_key: string

    Client-generated unique key for this request. Prevents duplicate feedback submissions on retries. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.

    16

    255

    ^[A-Za-z0-9_.:-]{16,255}$

    measurement_period: DatetimeRange
    performance_index: number

    Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected)

    0

    package_id?: string

    Specific package within the media buy (if feedback is package-specific)

    1

    creative_id?: string

    Specific creative asset (if feedback is creative-specific)

    1

    metric_type?: MetricType
    feedback_source?: FeedbackSource
    context?: ContextObject
    ext?: ExtensionObject