Choose a version:

Customer Privacy
API

Requires access to protected customer data for some properties.

The API for interacting with a customer's privacy consent. It is similar to the Customer Privacy API in storefront.

Anchor to standardapiStandardApi

The base API object provided to this and other customer-account extension targets.

Anchor to applyTrackingConsentChange applyTrackingConsentChange required: Allows setting and updating customer privacy consent settings and tracking consent metafields.

Note
Requires the customer_privacy capability to be set to true.
Requires access to protected customer data.
Anchor to customerPrivacy customerPrivacy <> required: Customer privacy consent settings and a flag denoting if consent has previously been collected.

Docs_Standard_CustomerPrivacyApi

applyTrackingConsentChange
Allows setting and updating customer privacy consent settings and tracking consent metafields. > Note: Requires the [`customer_privacy` capability](/docs/api/checkout-ui-extensions/unstable/configuration#collect-buyer-consent) to be set to `true`. {% include /apps/checkout/privacy-icon.md %} Requires access to [protected customer data](/docs/apps/store/data-protection/protected-customer-data).
```
ApplyTrackingConsentChangeType
```
customerPrivacy
Customer privacy consent settings and a flag denoting if consent has previously been collected.
```
ReadonlySignalLike<CustomerPrivacy>
```

export interface Docs_Standard_CustomerPrivacyApi
  extends Pick<
    StandardApi<any>,
    'customerPrivacy' | 'applyTrackingConsentChange'
  > {}

ApplyTrackingConsentChangeType

visitorConsent
```
VisitorConsentChange
```

Promise<TrackingConsentChangeResult>

Promise<TrackingConsentChangeResult>

(
  visitorConsent: VisitorConsentChange,
) => Promise<TrackingConsentChangeResult>

VisitorConsentChange

analytics
Visitor consents to recording data to understand how customers interact with the site.
```
boolean
```
marketing
Visitor consents to ads and marketing communications based on customer interests.
```
boolean
```
metafields
Tracking consent metafield data to be saved. If the value is `null`, the metafield will be deleted.
```
TrackingConsentMetafieldChange[]
```
preferences
Visitor consent to remembering customer preferences, such as country or language, to personalize visits to the website.
```
boolean
```
saleOfData
Opts the visitor out of data sharing / sales.
```
boolean
```
type
```
'changeVisitorConsent'
```

export interface VisitorConsentChange extends VisitorConsent {
  /**
   * Tracking consent metafield data to be saved.
   *
   * If the value is `null`, the metafield will be deleted.
   *
   * @example `[{key: 'granularAnalytics', value: 'true'}, {key: 'granularMarketing', value: 'false'}]`
   */
  metafields?: TrackingConsentMetafieldChange[];
  type: 'changeVisitorConsent';
}

TrackingConsentMetafieldChange

key
The name of the metafield. It must be between 3 and 30 characters in length (inclusive).
```
string
```
value
The information to be stored as metadata. If the value is `null`, the metafield will be deleted.
```
string | null
```

export interface TrackingConsentMetafieldChange {
  /**
   * The name of the metafield. It must be between 3 and 30 characters in
   * length (inclusive).
   */
  key: string;
  /**
   * The information to be stored as metadata. If the value is `null`, the metafield will be deleted.
   *
   * @example 'any string', `null`, or a stringified JSON object
   */
  value: string | null;
}

VisitorConsent

analytics
Visitor consents to recording data to understand how customers interact with the site.
```
boolean
```
marketing
Visitor consents to ads and marketing communications based on customer interests.
```
boolean
```
preferences
Visitor consent to remembering customer preferences, such as country or language, to personalize visits to the website.
```
boolean
```
saleOfData
Opts the visitor out of data sharing / sales.
```
boolean
```

export interface VisitorConsent {
  /**
   * Visitor consents to recording data to understand how customers interact with the site.
   */
  analytics?: boolean;
  /**
   * Visitor consents to ads and marketing communications based on customer interests.
   */
  marketing?: boolean;
  /**
   * Visitor consent to remembering customer preferences, such as country or language, to personalize visits to the website.
   */
  preferences?: boolean;
  /**
   * Opts the visitor out of data sharing / sales.
   */
  saleOfData?: boolean;
}

TrackingConsentChangeResult

TrackingConsentChangeResultSuccess | TrackingConsentChangeResultError

TrackingConsentChangeResultSuccess

The returned result of a successful tracking consent preference update.

type
The type of the `TrackingConsentChangeResultSuccess` API.
```
'success'
```

export interface TrackingConsentChangeResultSuccess {
  /**
   * The type of the `TrackingConsentChangeResultSuccess` API.
   */
  type: 'success';
}

TrackingConsentChangeResultError

The returned result of an unsuccessful tracking consent preference update with a message detailing the type of error that occurred.

message
A message that explains the error. This message is useful for debugging. It is **not** localized, and therefore should not be presented directly to the buyer.
```
string
```
type
The type of the `TrackingConsentChangeResultError` API.
```
'error'
```

export interface TrackingConsentChangeResultError {
  /**
   * The type of the `TrackingConsentChangeResultError` API.
   */
  type: 'error';

  /**
   * A message that explains the error. This message is useful for debugging.
   * It is **not** localized, and therefore should not be presented directly
   * to the buyer.
   */
  message: string;
}

ReadonlySignalLike

Represents a read-only value managed on the main thread that an extension can subscribe to. Example: Checkout uses this to manage the state of an object and communicate state changes to extensions running in a sandboxed web worker. This interface is compatible with Preact's ReadonlySignal: https://github.com/preactjs/signals/blob/a023a132a81bd4ba4a0bebb8cbbeffbd8c8bbafc/packages/core/src/index.ts#L700-L709

subscribe
```
(fn: (value: T) => void) => () => void
```
value
```
T
```

export interface ReadonlySignalLike<T> {
  readonly value: T;
  subscribe(fn: (value: T) => void): () => void;
}