Contentful Personalization & Analytics
    Preparing search index...

    Interface UseViewportTrackingOptions

    Options for the useViewportTracking hook.

    interface UseViewportTrackingOptions {
        enabled?: boolean;
        entry: Entry;
        personalization?: {
            experienceId: string;
            sticky?: boolean;
            variantIndex: number;
            variants: Record<string, string>;
        };
        threshold?: number;
        viewTimeMs?: number;
    }
    Index

    Properties

    enabled? entry personalization? threshold? viewTimeMs?

    Properties

    enabled?: boolean

    Whether view tracking is enabled for this component. When false, the hook returns a no-op onLayout and isVisible: false without setting up timers or scroll listeners.

    true

    entry

    entry: Entry

    The resolved Contentful entry to track (baseline or variant).

    personalization?: {
        experienceId: string;
        sticky?: boolean;
        variantIndex: number;
        variants: Record<string, string>;
    }

    Personalization data for variant tracking. Omit for baseline/non-personalized entries.

    Type Declaration

    • experienceId: string

      Identifier of the personalization or experiment experience.

    • Optionalsticky?: boolean

      Indicates whether this personalization selection is sticky for the user.

      false

      Sticky selections should be reused on subsequent requests for the same user, rather than re-allocating a new variant.

    • variantIndex: number

      Index of the selected variant within the experience configuration.

      Typically corresponds to the index of the selected PersonalizationConfig entry.

    • variants: Record<string, string>

      Mapping of baseline entry IDs to their selected variant entry IDs.

      The keys are component identifiers and the values are the identifiers of the selected variant for that component.

    threshold?: number

    Minimum visibility ratio (0.0 - 1.0) required to consider the component "visible".

    0.8
    viewTimeMs?: number

    Minimum time (in milliseconds) the component must be visible before tracking fires.

    2000

    Settings

    Member Visibility

    On This Page

    Properties