Customer feed
Customer feed is used mostly for better personalization and targeting your newsletters. Thanks to this info we know e.g. how often they are likely to receive newsletter or when they filled registration. Thank to these information Yottly can customized content and newsletters offer even more. Additional information such as birthday info allows you to send automatically special b-day discounts.
If a customer unsubscribes from receiving newsletters via Yottly unsubscribe link or there is any other manual change, the original value NEWSLETTER_FREQUENCY is overwritten by the current value. If the attribute NLF_TIME is present, the most up-to-date value is considered.
Customers provided with the value DATA_PERMISSION = anonymized_only will not be targeted by any channel. The system only uses their anonymized data (behavior patterns) in order to train our algorithms.
Field name | Field type | Required | Description |
---|---|---|---|
CUSTOMER_ID | String | yes | ID of the customer |
NEWSLETTER_FREQUENCY | Enum | yes | every day | special occasions | never |
NLF_TIME | Datetime (as String) | no | Datetime in format YYYY-MM-DDThh:mm:ss.sTZD (more info). Time of setting NEWSLETTER_FREQUENCY to the current value |
String | no | Valid email | |
REGISTRATION | Datetime (as String) | no | Datetime in format YYYY-MM-DDThh:mm:ss.sTZD (more info) |
DATA_PERMISSION | Enum | no | full | do_not_personalize | anonymized_only, default: full |
FIRST_NAME | String | no | |
LAST_NAME | String | no | |
ZIP_CODE | String | no | Zip code from the customers billing address |
PHONE | String | no | Phone number in the format according to the International Telecommunication Union. It should contain a plus sign ("+") as the international prefix symbol, the country code and the number , e.g., "+420777123456" for the Czech Republic |
SMS_FREQUENCY | Enum | no | every day | special occasions | never |
PARAMETERS | no | Custom parameters for each customer, see example |
XML format
<?xml version="1.0" encoding="utf-8"?> <CUSTOMERS> <CUSTOMER> <CUSTOMER_ID>D45S8741545SD</CUSTOMER_ID> <EMAIL>john.doe@email.com</EMAIL> <REGISTRATION>2014-12-31T03:53:43.962Z<REGISTRATION> <FIRST_NAME>John</FIRST_NAME> <LAST_NAME>Doe</LAST_NAME> <NEWSLETTER_FREQUENCY>every day</NEWSLETTER_FREQUENCY> <DATA_PERMISSION>full</DATA_PERMISSION> <NLF_TIME>2015-12-31T03:53:43.962Z</NLF_TIME> <ZIP_CODE>15000</ZIP_CODE> <PARAMETERS> <PARAMETER> <NAME>Bonus Points</NAME> <VALUE>100</VALUE> </PARAMETER> <PARAMETER> <NAME>Gender</NAME> <VALUE>woman</VALUE> </PARAMETER> <PARAMETERS> </CUSTOMER> </CUSTOMERS>