Automotive Purchaser Fields

Summary

Attribute

Requirement

Type

Max length

sku

mandatory

text

191

first_name

mandatory

text

80

email

mandatory

text

191

purchase_date

mandatory

date

n/a

customer_ref

mandatory

text

64

order_ref

mandatory

text

64

delivery_date

mandatory

date

n/a

dealer_code

mandatory*

text

191

autotrader_dealer_id

mandatory*

number

15

title

optional

text

24

country

optional

text

40

price

optional

float

191

currency

optional

text

3

vehicle_registration

optional

text

191

vin

optional

text

191

salesexec

optional

text

191

sku


Definition

Unique product identifier, or SKU.

Usage

The SKU is used to link the Product feed with Purchaser feed (customer sales data) so that our platform can identify products and services that customers purchased. This way, we can ask consumers questions relevant to their purchases in the questionnaires we email to them.

SKUs are also used for purposes of aggregation, and to ensure we can show the right reviews in the right places on your websites. Failure to provide information regarding a particular SKU in your Product feed that later appears in your Purchaser feed, will mean we're unable to collect reviews from consumers who have bought those products or services.

Constraints

  • Alphanumeric
  • Dashes and underscores
  • No spaces or symbols

Examples

  • DR26BBA1234
  • 234_172
  • ss-124

first_name


Definition

Customer's first name

Usage

Customer's first name is used in e-mail and questionnaires send to customers.

This will be also displayed as additional review detail on our reviews display solutions (alongside each review displaying in review lightbox).

Constraints

  • Does not include customer's surname.
  • No break space

Examples

  • John

email


Definition

Customer's email address

Usage

Customer's email address is used to contact/invite customer to fill in Reevoo questionnaire.

Constraints

  • Valid email address
  • Encrypted after processed

Examples

purchase_date


Definition

Date when the vehicle was sold to the customer

Usage

Purchase date is used (when delivery_date is not available) for email scheduling rules to estimate when the e-mail should be sent to customer (x number of days after they bought a vehicle). This might be also displayed as additional review detail on our reviews display solutions (alongside each review displaying in review lightbox).

Constraints

  • Allowed formats: "DD/MM/YYYY" or "DD-MM-YYYY" or "YYYYMMDD"

Examples

  • 19/12/2015
  • 19-12-2015
  • 20151219

customer_ref


Definition

Customer's unique reference number

Usage

Customer's unique reference is used for e-mail sending rules to ensure the same emails are not send to a single customer multiple times. Customer's unique reference can be used for reporting purposes.

Constraints

  • No break space

Examples

  • CUST29054

order_ref


Definition

Purchase reference of the product(s) sold within the same purchase

Usage

Order reference or purchase number is used for e-mail sending rules to ensure multiple emails are not sent to a customer for a single order. This would be used when single customer bought multiple vehicles/products within a single transaction. Customer's unique reference can be used for reporting purposes

Constraints

  • No break space or special characters

Examples

  • 849AB9053

delivery_date


Definition

Date when a product was delivered

Usage

Delivery date is used for email scheduling rules to estimate when the e-mail should be sent to customer (x number of days after a product was delivered). This might be also displayed as additional review detail on our reviews display solutions (alongside each review displaying in review lightbox).

Constraints

  • Allowed formats: "DD/MM/YYYY" or "DD-MM-YYYY" or "YYYYMMDD"

Examples

  • 19/12/2015
  • 19-12-2015
  • 20151219

dealer_code


Definition

Dealership code is referencing dealership name (taken from Branch / Dealer code feed) where the specific sale took place

Usage

Dealer code is used to link dealership name gathered from "Branch/Dealership feed" where the vehicle sale took place. It is used in emails and questionnaires sent to customers, for review collection purposes.

It is also used to display reviews on the website that are filtered by dealership. It allows displaying customer experience reviews on dealership websites. This will be also displayed as additional review detail on our reviews display solutions (alongside each review displaying in review lightbox).

* This is required if displaying individual dealership reviews on the website that can be filtered by dealer_code.

Constraints

  • URL friendly
  • Alphanumeric only
  • No break space

Examples

  • D1234

autotrader_dealer_id


Definition

Auto Trader Dealer IDs uniquely identify a dealer on Auto Trader platform.

Usage

* This is required for displaying CX reviews on Auto Trader.

Constraints

Examples

  • 20380

title


Definition

Customer's title

Usage

Customer's title is used together with customer's surname in email and questionnaires send to customers when customer's first name was not selected as option to refer to customer in the email.

Constraints

  • No break space or special characters

Examples

  • Mr

country


Definition

Country in which customer lives

Usage

Country can be used for reporting purposes.

Constraints

  • ISO 3166-1 alpha-2 country code

Examples

  • United Kingdom

price


Definition

Price the customer paid for the vehicle

Usage

Price can be used for reporting purposes.

Constraints

  • No break space or special characters

Examples

  • 12000

currency


Definition

Currency in which the customer paid for the vehicle

Usage

Currency can be used for reporting purposes.

Constraints

  • ISO 4217 currency code
  • No break space or special characters

Examples

  • GBP

vehicle_registration


Definition

Vehicle registration number of the vehicle bought

Usage

Vehicle registration number can be used for reporting purposes.

* This attribute is required for clients who would like to run reports on this value

Constraints

Examples

  • XY1234Z

vin


Definition

VIN is a Vehicle Identification Number

Usage

VIN number can be used for reporting purposes.

* This attribute is required for clients who would like to run reports on VIN

Constraints

Examples

  • JLAKJF123456778

salesexec


Definition

Sales Executive/Manager name or code.

This referencing a person who made the sale

Usage

Salesexec can be used for reporting purposes.

* This attribute is required for clients who would like to run reports on sales executive

Constraints

Examples

  • SP9654