@adcp/sdk API Reference - v14.0.0-beta.6
    Preparing search index...

    Interface CardAsset

    A single card in a multi-card creative (image_carousel, future composed carousels). Carries: media (an image OR video asset), optional headline (short text), optional description (longer text), optional cta (call-to-action label), optional landing_page_url (url asset with url_type: "clickthrough").

    Covers the multi-card patterns across Meta carousel, Pinterest sponsored pin, Snap Collection, TikTok carousel, and AI-surface result cards. The two-field text shape (headline + description) reflects how almost every adopter splits short labels from longer copy; Pinterest pin description and Meta per-card description both go in description.

    Used as the array element type for the cards slot on image_carousel canonicals. Adopters MUST NOT invent per-card key conventions like card_0_headline / cards.0.headline — the manifest's assets.cards value is an array of card-asset objects, period. Per-card platform extensions (e.g., Meta-specific carousel attributes, Pinterest rich-pin metadata, Snap Collection price tags) attach via the platform_extensions field, never via inline non-canonical keys.

    interface CardAsset {
        asset_type: "card";
        media: ImageAsset | VideoAsset;
        headline?: string;
        description?: string;
        cta?: string;
        landing_page_url?: URLAsset;
        platform_extensions?: PlatformExtensionReference[];
        provenance?: Provenance;
    }
    Index

    Properties

    asset_type media headline? description? cta? landing_page_url? platform_extensions? provenance?

    Properties

    asset_type: "card"

    Discriminator identifying this as a card asset. See /schemas/creative/asset-types for the registry.

    media: ImageAsset | VideoAsset

    The card's primary visual asset. Either an image or video asset, matching the parent format's allowed_card_media_asset_types parameter.

    headline?: string

    Optional per-card short text label (typically 25-40 chars). Length governed by card_headline_max_chars on the format declaration. Meta carousel headline, Pinterest pin title, Snap Collection sticker text, TikTok caption-short.

    description?: string

    Optional per-card longer text (typically 100-500 chars). Distinct from headline: description is body copy, headline is the label. Length governed by card_description_max_chars on the format declaration. Meta carousel description, Pinterest pin description, AI-surface result body text, TikTok long caption.

    cta?: string

    Optional per-card call-to-action label (e.g., 'SHOP_NOW', 'LEARN_MORE'). When the parent format declares cta_values (allowed CTA labels), the per-card cta MUST be one of those values. Lets a Meta or TikTok carousel show different CTAs per card.

    Optionallanding_page_url

    landing_page_url?: URLAsset
    platform_extensions?: PlatformExtensionReference[]

    Per-card platform-specific extensions (URI+digest references). Same hosting model as format-level platform_extensions. Use this for Meta carousel-card attributes, Pinterest pin overrides, etc. — NEVER inline non-canonical keys on the card object directly.

    provenance?: Provenance

    Settings

    Member Visibility

    On This Page

    Properties