When a visitor signs up for non-transactional content, such as a newsletter, they are consenting to receive marketing messages. This agreement is called a marketing consent. A marketing consent holds the visitor's sign-up details such as email address or phone number, the status of the consent, and more.
The Marketing Consent API allows you to manage a site's marketing consents. With the Marketing Consent API, you can:
A marketing consent has an optInLevel
of either single or double confirmation. Some countries require double confirmation for all marketing consents. With single confirmation, when a site visitor signs up, their marketing consent state
is CONFIRMED
. With double confirmation, when a site visitor signs up, their marketing consent state
is PENDING
until the visitor confirms their consent, for example, by clicking a link to verify their email address. When the visitor confirms their consent, the state
is CONFIRMED
.
getMarketingConsentByIdentifier() returns the communicationEligibility.granted
boolean which determines whether the recipient of the marketing consent is eligible to receive marketing messages. Note that this only serves as a signal for you to decide whether or not you should send marketing messages to the recipient's email address or phone number.
For example:
CommunicationEligibility.granted
is false
. This applies to marketing consents made by both phone and email.state
is NEVER_CONFIRMED
, the visitor has never confirmed to receive communication, and CommunicationEligibility.granted
is false
.Note: This applies only to marketing consents made by phone. If a visitor made a marketing consent by email and the state
is NEVER_CONFIRMED
, the visitor can still receive communication, and CommunicationEligibility.granted
is true
.
To use the Marketing Consent API, import { marketingConsent } from the wix-marketing.v2 module.
import { marketingConsent } from "wix-marketing.v2";
Visitor: A visitor is any person who visits a site, including contacts, non-contacts, members, and non-members.
Communication channel: Each marketing consent has a communication channel of either email
or phone
. A visitor can sign up multiple times using different email addresses and phone numbers, however, they can only create a single marketing consent per email and per phone number.
State: Different states of a marketing consent.
UNKNOWN_STATE
: The state of the marketing consent is unknown.NEVER_CONFIRMED
: The visitor never confirmed to receive marketing messages.REVOKED
: The marketing consent has been removed, for example, when a visitor unsubscribes from a newsletter.PENDING
: The marketing consent is pending confirmation. Relevant only for {"optInLevel": "DOUBLE_CONFIRMATION"}
.CONFIRMED
: The site visitor has confirmed their marketing consent.Opt in level: A marketing consent can require either single or double confirmation, as some countries require double confirmation for all marketing consents.
Communication eligibility: A signal for your app to easily check whether or not it can send marketing messages to the recipient's email address or phone number.