Modules

ControlCard

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

  • new ControlCard(id?: undefined | string, viewed?: undefined | false | true, updated?: Date, expiresAt?: Date, extras?: Record<string, string>, pinned?: undefined | false | true): ControlCard

  • A card with no display that logs impressions, which can be passed to showContentCards or handled manually. Subscribe to receive new cards via subscribeToContentCardsUpdates.

    Parameters

    • Optional id: undefined | string

      The id of the card. This will be reported back to Braze with events for analytics purposes.

    • Optional viewed: undefined | false | true

      Whether this card has been shown to the user.

    • Optional updated: Date

      When this card was last modified.

    • Optional expiresAt: Date

      When this card expires and should stop being shown to the user.

    • Optional extras: Record<string, string>

      Object of string/string key/value pairs.

    • Optional pinned: undefined | false | true

      Whether to pin this card to the top of the view.

    Returns ControlCard

Properties

expiresAt

expiresAt: Date | null

When this card expires and should stop being shown to the user.

extras

extras: Record<string, string>

Object of string/string key/value pairs. Defaults to empty object {}.

Optional id

id: undefined | string

The id of the card. This will be reported back to Braze with events for analytics purposes.

isControl

isControl: true

Whether this card is a ControlCard.

pinned

pinned: boolean

Whether to pin this card to the top of the view.

updated

updated: Date | null

When this card was last modified.

viewed

viewed: boolean

Whether this card has been shown to the user.

Methods

dismissCard

  • dismissCard(): void

  • Call this method if you wish to programmatically remove the card from the feed and log a dismissal. This method is meant to be used with the Braze UI.

    If you are using your own UI, this method will have no effect. Instead, you should use logCardDismissal to log analytics and then remove the card from the DOM manually.

    Returns void

removeAllSubscriptions

  • removeAllSubscriptions(): void

removeSubscription

  • removeSubscription(subscriptionGuid: string): void

  • Remove an event subscription that you previously subscribed to.

    Parameters

    • subscriptionGuid: string

      The identifier of the subscription you wish to remove, returned by the method you initially used to create it.

    Returns void

subscribeToClickedEvent

  • subscribeToClickedEvent(subscriber: () => void): string | null

  • Subscribe to receive click events. The subscriber callback will be called whenever this card is clicked by the user.

    Parameters

    • subscriber: () => void

      The callback function to receive click events. This function will be invoked with no arguments when this card records a click.

        • (): void

        • Returns void

    Returns string | null

    The identifier of the subscription created. This can be passed to Card.removeSubscription to cancel the subscription. Returns null if the subscriber passed is not a function.

subscribeToDismissedEvent

  • subscribeToDismissedEvent(subscriber: () => void): string | null

  • Subscribe to receive dismissed events. The subscriber callback will be called whenever this card is dismissed by the user.

    Parameters

    • subscriber: () => void

      The callback function to receive dismissed events. This function will be invoked with no arguments when this card records a dismissal.

        • (): void

        • Returns void

    Returns string | null

    The identifier of the subscription created. This can be passed to Card.removeSubscription to cancel the subscription. Returns null if the subscriber passed is not a function.

Static fromContentCardsJson

  • fromContentCardsJson(jsonData: Record<string, unknown>): Card | undefined