Customers Table (BETA)
customers_table
The Customers table contains comprehensive details about each customer, including contact information, geographical details, status, consent status for email and SMS marketing, and their purchase history with your store. Querying this table enables businesses to segment customers, analyze customer behavior, and improve targeted marketing efforts.
Dimensions
Dimensions are immutable properties that can be used for grouping data.
Title | ID | Type | Description |
---|---|---|---|
Address Line 1 |
| string | The first line of the customer's default address. Example value: |
Address Line 2 |
| string | The second line of the customer's default address. Example value: |
City |
| string | The city of the customer's default address. Example value: |
Coordinates Validated |
| boolean | Indicates whether the customer coordinates were successfully validated. Possible values: |
Country |
| string | The country of the customer's default address. Example values: |
Country Code |
| string | The country code of the customer's default address, according to ISO 3166-1 alpha-2. See list of country codes Example values: |
Customer Created Date |
| timestamp | The time at which the customer record was created. Formatted according to the ISO 8601 international standard. Example value: |
Customer ID |
| string | The unique identifier for the customer, assigned by the main sales platform. Example value: |
Customer Key |
| string | Column to use when joining with the Orders or Pixel Orders tables Example value: |
Customer Tags |
| repeated string | Tags associated with the customer, set in the main sales platform. Example values: |
Display Name |
| string | The display name of the customer. Example value: |
Email Address |
| string | The primary email address associated with the customer’s account. Example value: |
Email Marketing Consent Collected From |
| string | The source from which the customer's email marketing consent was collected. |
Email Marketing Consent Opt-In Level |
| string | The level of consent provided by the customer for email marketing. Example values: |
Email Marketing Consent Status |
| string | The current status of the customer's email marketing consent. Example values: |
Email Marketing Consent Updated Date |
| timestamp | The time at which the email marketing consent was updated. Formatted according to the ISO 8601 international standard. Example value: |
First Name |
| string | The customer's first name. Example value: |
Last Name |
| string | The customer's last name. Example value: |
Last Order ID |
| string | The ID of the most recent order from the customer, according to the main sales platform. Example value: |
Latitude |
| string | The latitude associated with the customer's location. Example value: |
Locale |
| string | The locale setting associated with the customer's account. Example values: |
Longitude |
| string | The longitude associated with the customer's location. Example value: |
Note |
| string | Note attached to the customer profile. |
Phone |
| string | The customer's phone number. Example value: |
Sales Platform |
| string | The sales platform associated with the customer's account. Example values: |
Product Subscriber Status |
| string | The customer's subscription status for products. Example values: |
SMS Marketing Consent Collected From |
| string | The source from which the customer's SMS marketing consent was collected. |
SMS Marketing Consent Opt-In Level |
| string | The level of consent provided by the customer for SMS marketing. Example values: |
SMS Marketing Consent Updated Date |
| timestamp | The time at which the sms marketing consent was updated. Formatted according to the ISO 8601 international standard. Example value: |
State |
| string | The state or province of the customer's default address. Example values: |
State Code |
| string | The state or province code of the customer's default address. Example values: |
Predicted Spend Tier |
| string | A predicted tier for how much the customer is likely to spend. Example values: |
Customer Status |
| string | The current status of the customer in the system. Example values: |
Tax Exempt |
| boolean | Indicates whether the customer is exempt from tax. Possible values: |
Valid Email Address |
| boolean | Whether the email address has passed a validation check. Possible values: |
Verified Email Address |
| boolean | Whether the email address has been verified by the platform. Possible values: |
Zip/Postal Code |
| string | The zip or postal code of the customer's defaults address. Example values: |
Measures
Measures are numeric fields that can be aggregated and/or combined to calculate new metrics.
Title | ID | Type | Description |
---|---|---|---|
Amount Spent | amount_spent | numeric | The total amount spent by the customer. |
Number of Orders | number_of_orders | numeric | The total number of orders placed by the customer. |
Updated about 2 hours ago