Loading...

customersummary

Overview

Generally, Acquia CDP promotes data utilizing the “last non-null” paradigm, where the most recent data received is the data promoted and surfaced in summary tables at the master customer level. In some instances, Acquia CDP employs more complex promotion logic because “last non-null” can have undesirable results. This complex promotion logic can be overwritten per tenant if you require adjustments to our standard logic. Rank conditions that begin with START_DYNAMIC_RANK__ and end with END_DYNAMIC_RANK__ can be overwritten for a specific client.

Related data:

  • AddressID
  • Country
  • State
  • City
  • Zip
  • Address1
  • Address2
  • Suite
  • Certified
  • DpvConfirm
  • CountryCode
  • ZipExt
  • NCOADateUpdate
  • MoveType
  • MoveDate
  • DoNotMail
  • LastName
  • RowModified
  • RBDI
  • AddressType

Summary logic applied:

  1. Prefer USPS delivery point verification confirmed addresses
  2. Prefer USPS-certified addresses
  3. Prefer the most recent address record
  4. Prefer addresses that are opted-in to receive mail
  5. Prefer more complete addresses

Related data:

  • Email
  • Preferences
  • EmailStatus
  • DoNotEmail

Summary logic applied:

  1. Prefer non-empty email addresses that are not @marketplace.amazon
  2. Prefer emails that are not opted-out of marketing communications
  3. Prefer emails whose syntax is verified by Acquia
  4. Prefer emails that transacted most recently
  5. Prefer the most recent customer record

Email-related ranking can be configured to de-duplicate DoNotEmail across customers with the same email address.

Related data:

  • PrimaryPhone
  • SecondaryPhone
  • MobilePhone
  • DoNotCall
  • DoNotText
  • PrimaryPhoneValidity
  • SecondaryPhoneValidity
  • MobilePhoneValidity

Summary logic applied:

  1. Prefer non-empty primary phone numbers
  2. Prefer phone numbers that are not opted-out of marketing communications
  3. Prefer phone numbers that transacted most recently
  4. Prefer the most recent customer record

Related data:

  • FirstName
  • MiddleName
  • LastName
  • Title
  • Sal
  • BirthYear
  • BirthMonth
  • Age
  • Gender
  • RowModified
  • BirthDate

Summary logic applied:

  1. Prefer the most complete record with first and last name heavily weighted
  2. Prefer the most recent customer record

Customer summary attributes

Attribute NameDescriptionData Type
MasterCustomerIDThe unique identifier of the de-duplicated master customer. It can change daily. Therefore, it cannot be consistent or persist across days.string
FirstTransactionDateThe date of the first transaction of the customer.timestamp
FirstTransactionDateDigitalThe date of the first transaction that the customer made in the digital sales channel.timestamp
FirstTransactionDatePhysicalThe date of the first transaction that the customer made in the physical sales channel.timestamp
PreviousTransactionDateThe date of the penultimate (second to last) transaction of the customer.timestamp
LastTransactionDateThe date of the last transaction of the customer.timestamp
LastTransactionDateDigitalThe date of the last transaction that the customer made in the digital sales channel.timestamp
LastTransactionDatePhysicalThe date of the last transaction that the customer made in the physical sales channel.timestamp
FirstTransactionRevenueThe revenue generated from the first transaction of the customer.decimal
TotalRevenueThe total revenue generated from the transactions that the customer made in their lifetime.decimal
TotalRevenue_Last12MonthsThe total revenue generated from the transactions that the customer made in the last 12 months.decimal
TotalRevenue_Last13_24MonthsThe total revenue generated from the transactions that the customer made between the last 13 and 24 months.decimal
TotalRevenuedecile_Last12MonthsThe total revenue generated from the transactions that the customer made in the last 12 months, grouped by deciles. Decile 1 being the highest spenders and decile 10 being the lowest spenders.int
TotalRevenuedecile_Last13_24MonthsThe total revenue generated from the transactions that the customer made between the last 13 and 24 months, grouped by deciles. Decile 1 being the highest spenders and decile 10 being the lowest spenders.int
TotalTransactionCountThe total number of transactions that the customer made in their lifetime.int
TotalTransactionCount_Last12MonthsThe total number of transactions that the customer made in the last 12 months.int
TotalTransactionCount_Last13_24MonthsThe total number of transactions that the customer made between the last 13 and 24 months.int
TotalTransactionCountWithDiscountThe total number of transactions that the customer made in their lifetime, with a discount amount greater than $0.int
TotalListPriceThe total amount of MSRP that the customer purchased before markdown or discount.decimal
TotalDiscountThe total amount of the discount that the customer used in their lifetime.decimal
TotalProductcategoryCountThe total number of distinct product categories that the customer purchased in their lifetime.int
TotalProductCountThe total number of distinct products that the customer purchased in their lifetime.int
LastOpenDateThe date when the customer last opened an email campaign.timestamp
LastSendDateThe date of the last email that you sent to the customer.timestamp
LastClickDateThe date when the customer last clicked an email campaign.timestamp
FirstVisitDateThe date when the customer first visited your website.timestamp
LastVisitDateThe date when the customer last visited your website.timestamp
TotalVisitCountLast30DaysThe total number of times the customer visited the website in the last 30 days.int
TotalVisitCount31_60DaysThe total number of times the customer visited the website between the last 31 and 60 days.int
TotalClickCountLast30DaysThe total number of times the customer clicked the links of an email campaign in the last 30 days.int
TotalClickCount31_60DaysThe total number of times the customer clicked the links of an email campaign between the last 31 and 60 days.int
TotalOpenCount31_60DaysThe total number of emails that the customer opened between the last 31 and 60 days.int
TotalOpenCountLast30DaysThe total number of emails that the customer opened in the last 30 days.int
TotalSendCount31_60DaysThe total number of emails sent to the customer between the last 31 and 60 days.int
TotalSendCountLast30DaysThe total number of emails sent to the customer in the last 30 days.int
PrimaryBrandThe brand that the customer purchased the most in their lifetime based on the total transaction count. The default value is Unknown.string
PrimaryOrganizationThe organization from which the customer purchased the most in their lifetime. The default value is Unknown.string
CountryThe country of the winning address of the customer. The default value is Unknown. By default, CDP promotes addresses that are DPV, certified, recent, opted-in to receive mails, and complete.string
CountryCodeThe two-letter country code (ISO 3166-1 alpha-2) of the winning address of the customer. The default value is Unknown.string
StateThe state of the winning address of the customer. The default value is Unknown. By default, CDP promotes addresses that are DPV, certified, recent, opted-in to receive mails, and complete.string
CityThe city of the winning address of the customer. The default value is Unknown. By default, CDP promotes addresses that are DPV, certified, recent, opted-in to receive mails, and complete.string
ZipCodeThe 5-digit zip code of the winning address of the customer. The default value is Unknown. By default, CDP promotes addresses that are DPV, certified, recent, opted-in to receive mail, and complete.string
GenderThe gender of the customer as provided by your standard customer feed or as deduced by CDP’s Identity Resolution Engine based on their first name. The default value is Unknown.string
FirstPromoIDThe marketing campaign through which you acquired the customer, as provided by your analytics data. For example, Google Analytics or Adobe Analytics. This is the most granular level of your marketing campaign categorization, typically the keyword level. The default value is Unknown.string
FirstPromoCategoryIDThe promo category of the first online promo (FirstPromoID).string
AovGroupThe average value of the transactions that the customer made in their lifetime, grouped into buckets for easier use.string
AverageDiscountRateThe average rate of discount that the customer used in their lifetime.string
CategoryMixGroupThe total number of distinct product categories that the customer purchased in their lifetime, grouped into buckets for easier use.string
DaySinceFirstWebLoginThe number of days since the customer first visited your website.int
DaySinceFirstWebLoginGroupThe number of days since the customer first visited your website, grouped into buckets for easier use.string
DaySinceLastWebLoginThe number of days since the customer last visited your website.int
DaySinceLastWebLoginGroupThe number of days since the customer last visited your website, grouped into buckets for easier use.string
FirstTransactionRevenueGroupThe revenue generated from the first transaction of the customer, grouped into buckets for easier use.string
LastTransactionIntervalThe number of days between the last and penultimate (second to last) transactions that the customer made.int
RecencyDaysGroupThe number of days since the last transaction that the customer made, grouped into buckets for easier use.string
RecencyMonthThe number of months since the last transaction that the customer made.string
FrequencyThe number of transactions that the customer made per year on an average in their lifetime. If the customer is a non-buyer, the customer will have a value of -99.double
TenureDaysThe number of days since the first transaction that the customer made.int
TenureDaysGroupThe number of days since the first transaction that the customer made, grouped into buckets for easier use.string
TotalClickCount31_60DaysGroupThe total number of times the customer clicked the links of an email campaign between the last 31 and 60 days, grouped into buckets for easier use.string
TotalClickCountLast30DaysGroupThe total number of times the customer clicked the links of an email campaign in the last 30 days, grouped into buckets for easier use.string
TotalOpenCount31_60DaysGroupThe total number of emails that the customer opened between the last 31 and 60 days, grouped into buckets for easier use.string
TotalOpenCountLast30DaysGroupThe total number of emails that the customer opened in the last 30 days, grouped into buckets for easier use.string
TotalSendCount31_60DaysGroupThe total number of emails sent to the customer between the last 31 and 60 days, grouped into buckets for easier use.string
TotalSendCountLast30DaysGroupThe total number of emails sent to the customer in the last 30 days, grouped into buckets for easier use.string
TotalProductCountGroupThe total number of distinct products that the customer purchased in their lifetime, grouped into buckets for easier use.string
TotalRevenue_Last13_24MonthsGroupThe total revenue generated from the transactions that the customer made between the last 13 and 24 months, grouped in buckets for easier use.string
TotalRevenue_Last12MonthsGroupThe total revenue generated from the transactions that the customer made in the last 12 months, grouped into buckets for easier use.string
TotalRevenueGroupThe total revenue generated from the transactions that the customer made in their lifetime, grouped into buckets for easier use.string
TotalRevenueSegment_13_24Months

An easier way to use the “Revenue decile”:

  • “1 - High Value” represents your top 10% customers in terms of revenue on this period
  • “2 - Medium Value” represents your 80% average customers, that is, not in the top/bottom 10% in terms of revenue in this period
  • “3 - Low Value” represents your bottom 10% customers in terms of revenue in this period
string
TotalRevenueSegment_Last12Months

An easier way to use the “Revenue decile”:

  • “1 - High Value” represents your top 10% customers in terms of revenue on this period
  • “2 - Medium Value” represents your 80% average customers, that is, not in the top/bottom 10% in terms of revenue in this period
  • “3 - Low Value” represents your bottom 10% customers in terms of revenue in this period
string
TotalTransactionCount_13_24MonthsGroupThe total number of transactions that the customer made between the last 13 and 24 months, grouped into buckets for easier use.string
TotalTransactionCount_Last12MonthsGroupThe total number of transactions that the customer made in the last 12 months, grouped into buckets for easier use.string
TotalTransactionCountGroupThe total number of transactions that the customer made in their lifetime, grouped into buckets for easier use.string
TotalVisitCount31_60DaysGroupThe total number of times the customer visited the website between the last 31 and 60 days, grouped into buckets for easier use.string
TotalVisitCountLast30DaysGroupThe total number of times the customer visited the website in the last 30 days, grouped into buckets for easier use.string
ZipconcatA concatenation of the winning country and zip code, since some zip codes can conflict across countries.string
AgeThe age of the customer. This comes from your standard customer feed.int
BirthMonthThe birth month of the customer. This comes from your standard customer feed.string
BirthYearThe birth year of the customer. This comes from your standard customer feed.string
FrequencyGroupThe number of transactions that the customer made per year on an average in their lifetime, grouped into buckets for easier use.string
TotalRevenueSegment_SegmentationStatusA segmentation representing the progression of revenue for your customers between 13-24 months ago and the last 12 months. It characterizes whether they spent less (Downward), the same (Stable), or more (Upward) in the last 12 months when compared to the 13-24 months ago period. If a customer was acquired in the last 12 months, then they are marked as “New Buyer”. “Reactivated” customers are buyers who made a purchase in the last 12 months, but did not make a purchase in the previous 13-24 months, and made a transaction before the last 24 months. “2 Period Inactive” customers are buyers who did not make a purchase in the last 24 months, but made a purchase before 24 months ago. “Lapsed” customers are buyers who made a purchase in the last 13-24 months, but did not make a transaction in the last 12 months.string
LastTransactionIntervalGroupThe number of days between the last and penultimate (second to last) transactions that the customer made, grouped into buckets for easier use.string
EmailDomainThe domain of the customer’s email address. The default value is Unknown.string
ClosestStoreThe name of the store closest to the winning zip code of the customer. The default value is Unknown.string
ClosestStoreDistanceThe distance, in miles, between the location of the customer and the closest store. This filter can work only for US, Canada and UK addresses for both stores and customers.int
ClosestStoreDistanceGroupThe distance, in miles, between the location of the customer and the closest store, grouped into buckets for easier use. The default value is Unknown. This filter can work only for US, Canada and UK addresses for both stores and customers.string
TotalOrganizationCountThe total number of organizations or transaction channels from which the customer purchased in their lifetime.int
FirstTransactionOrganizationThe organization or transaction channel from which the customer made the first purchase. The default value is Unknown.string
LastTransactionOrganizationThe organization or transaction channel from which the customer made the last purchase. The default value is Unknown.string
PrimaryStoreThe physical store from which the customer purchased the most in their lifetime. The default value is Unknown.string
EmailThe winning email address of the master customer after CDP’s Identity Resolution Engine de-duplicates child customer profiles.string
EmailOptInDateThe date when the customer opted in to email communication.string
EmailOptOutDateThe date when the customer opted out of email communication.string
CustomerStatus

A flag to distinguish between customers who are buyers and non-buyers. Customers who have ever made a purchase are considered buyers. The following are the statuses:

  • Buyer
  • NonBuyer
  • High Volume Buyer
  • 10k+ transactions
  • NA
string
PreferencesThis is a deprecated field. Use DoNotEmail, DoNotMail, DoNotCall, and DoNotText instead.string
BuyerIdentificationA flag to distinguish individuals that are identified with an email address or other contact information, as opposed to anonymous customers. It can be either identified or unidentified.string
FirstNameThe winning first name of the master customer after CDP’s Identity Resolution Engine de-duplicates child customer profiles.string
MiddleNameThe winning middle name of the master customer after CDP’s Identity Resolution Engine de-duplicates child customer profiles.string
LastNameThe winning last name of the master customer after CDP’s Identity Resolution Engine de-duplicates child customer profiles.string
TitleThe title to use for the customer as provided by your standard customer feed. The default value is Unknown.string
SALThe salutation deduced by CDP’s Identity Resolution Engine.string
PrimaryPhoneThe winning phone number of the master customer after CDP’s Identity Resolution Engine de-duplicates child customer profiles.string
SecondaryPhoneThe winning secondary phone number of the master customer after CDP’s Identity Resolution Engine de-duplicates child customer profiles.string
MobilePhoneThe winning mobile phone number of the master customer after CDP’s Identity Resolution Engine de-duplicates child customer profiles.string
Address1The Address1 of the winning address of the customer. The default value is Unknown. By default, CDP promotes addresses that are DPV, certified, recent, opted-in to receive mail, and complete.string
Address2The Address2 of the winning address of the customer. The default value is Unknown. Address2 should not be used for direct mail campaigns. Choose Address 1 and Suite for direct mail campaigns.string
TotalCostThe total cost of goods of all products that the customer purchased in their lifetime.decimal
TotalCost_Last12MonthsThe total cost of goods of all products that the customer purchased in the last 12 months.decimal
TotalCost_Last13_24MonthsThe total cost of goods of all products that the customer purchased between the last 13 to 24 months.decimal
PrimaryDeviceTypeThe device that the customer used the most for their purchases in their lifetime. The default value is Unknown.string
RecencyDaysThe number of days since the last transaction of the customer.int
PropensityToBuyDecileA deprecated machine learning model that has been replaced with a new model.string
PropensityToEngageDecileA deprecated machine learning model that has been replaced with a new model.string
PropensityToConvertDecileA deprecated machine learning model that has been replaced with a new model.string
BehaviorBasedClusterIDA deprecated machine learning model that has been replaced with a new model.string
PurchaseClusterIDA deprecated machine learning model that has been replaced with a new model.string
BrowseClusterIDA deprecated machine learning model that has been replaced with a new model.string
ProductClusterIDA deprecated machine learning model that has been replaced with a new model.string
BrandClusterIDA deprecated machine learning model that has been replaced with a new model.string
EmailStatus

The validity of the email address of the customer.

  • “V” means “Verified” and the syntax is valid, the domain is good or known and this email address is not a known spam trap
  • “U” means “Unverified” and the syntax is valid, but the domain is unknown/bad
  • “X” means “Invalid” and the syntax is invalid
string
AddressCertified

A flag to mark whether the address is CASS certified by the USPS.

  • “True” means that the address is CASS certified
  • “False” means that the address is not CASS certified and is likely invalid
  • “Unknown” means that there is no address or the address is not in the US or Canada. Currently, these are the only countries that are certified.
string
SuiteThe apartment, suite, or room number of the winning address.string
DpvConfirm

The DPV confirmation results that CDP receives from USPS for US addresses. The new filter is called “DPV Confirmed”, and can take the values:

  • “Y” when the address is DPV confirmed
  • “N” when the address is not certified.
string
FirstOfflinePromoIDThe marketing campaign through which you acquired your customers, as provided by your direct mail. This is the most granular level of your marketing campaign categorization. The default value is Unknown.string
DoNotEmail

The subscription preference of the customer for email campaigns. The possible values are:

  • “Y” indicates that the contacts explicitly opted-out
  • “N” indicates that the contacts explicitly opted-in
  • “U” indicates that the contacts have no explicit values and are usually the contacts that you can/want to contact
string
DoNotCall

The subscription preference of the customer for phone campaigns. The possible values are:

  • “Y” indicates that the contacts explicitly opted-out
  • “N” indicates that the contacts explicitly opted-in
  • “U” indicates that the contacts have no explicit values and are usually the contacts that you can/want to contact
string
DoNotText

The subscription preference of the customer for text (SMS) campaigns. The possible values are:

  • “Y” indicates that the contacts explicitly opted-out
  • “N” indicates that the contacts explicitly opted-in
  • “U” indicates that the contacts have no explicit values and are usually the contacts that you can/want to contact
string
DoNotMail

The subscription preference of the customer for direct postal mail campaigns. The possible values are:

  • “Y” indicates that the contacts explicitly opted-out
  • “N” indicates that the contacts explicitly opted-in
  • “U” indicates that the contacts have no explicit values and are usually the contacts that you can/want to contact
string
BirthDateThe birth date of the customer. This comes from your standard customer feed.timestamp
ZipExtThe 4-digit zip code extension of the winning address of the customer. The default value is Unknown. By default CDP, promotes addresses that are DPV, certified, recent, opted-in to receive mail, and complete.string
NCOADateUpdateThe date when the record last went through NCOA processing.string
NCOAMatchFlag

The match flag that was returned by NCOA processing. The possible values are:

  • “M” for Moved
  • “G” for PO Box Closed
  • “K” for Moved, left no forwarding address
  • “F” for Moved to a Foreign Country
string
MoveType

The type of move that was registered within the USPS NCOA database. The possible values are:

  • “I” for Individual Match
  • “F” for Family Match
  • “B” for Business Name Match
string
MoveDateThe date when the move was registered with USPS in the NCOA database. This is in the format “YYYYMM”. For example, “201905” is a move that was registered in January 2014. The actual move could have happened earlier or later, the NCOA database cannot provide that information.string
NCOADateUpdateBigIntThe date when the move was registered with USPS in the NCOA. database.timestamp
PrimaryPhoneValidityReturned by Melissa to indicate the primary phone validity. The possible values are V, X, and Unidentified. By default, phone validation is turned off.string
SecondaryPhoneValidityReturned by Melissa to indicate the secondary phone validity. The possible values are V, X, and Unidentified. By default, phone validation is turned off.string
MobilePhoneValidityReturned by Melissa to indicate the mobile phone validity. The possible values are V, X, and Unidentified. By default, phone validation is turned off.string
PropensityToBuyDecile_L1MA deprecated machine learning model that has been replaced with a new model.string
PropensityToBuyDecile_L2MA deprecated machine learning model that has been replaced with a new model.string
BehaviorBasedClusterID_L1MA deprecated machine learning model that has been replaced with a new model.string
BehaviorBasedClusterID_L2MA deprecated machine learning model that has been replaced with a new model.string
PropensityToBuyDecile_ThisMonthA deprecated machine learning model that has been replaced with a new model.string
BehaviorBasedClusterID_ThisMonthA deprecated machine learning model that has been replaced with a new model.string
EmailHashA SHA-256 hash of the winning email address of the master customer after CDP’s Identity Resolution Engine de-duplicates child customer profiles.string
RBDI

A flag to indicate whether the address is a business or residential address for the United States only:

  • "R" - Residential Address
  • "B" - Business Address
  • "U" - No address or address unknown by the USPS
string
AddressTypeExample Address Types: Firm or Company address, General Delivery address, High Rise or Business complex, PO Box address, Rural Route address, Street or Residential addressstring
ProductClusterID_L1MA deprecated machine learning model that has been replaced with a new model.string
ProductClusterID_L2MA deprecated machine learning model that has been replaced with a new model.string
ProductClusterID_ThisMonthA deprecated machine learning model that has been replaced with a new model.string
ClosestStoreIDThe unique identifier of the store closest to the winning zip code of the customer.string
PrimaryStoreIDThe unique identifier of the physical store from which the customer purchased the most in their lifetime.string
ChannelMixThe mix of sales channels from which the customer purchased in their lifetime.string
ChannelMix_Last12MonthsThe mix of sales channels from which the customer purchased in the last 12 months.string
ChannelMix_Last13_24MonthsThe mix of sales channels from which the customer purchased between the last 13 and 24 months.string

Did not find what you were looking for?

If this content did not answer your questions, try searching or contacting our support team for further assistance.

Back to Section navigation