HomeIntegration guideData integrationCustomer feed

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 nameField typeRequiredDescription
CUSTOMER_IDStringyesID of the customer
NEWSLETTER_FREQUENCYEnumyesevery day | special occasions | never
NLF_TIMEDatetime (as String)noDatetime in format YYYY-MM-DDThh:mm:ss.sTZD (more info). Time of setting NEWSLETTER_FREQUENCY to the current value
EMAILStringnoValid email
REGISTRATIONDatetime (as String)noDatetime in format YYYY-MM-DDThh:mm:ss.sTZD (more info)
DATA_PERMISSIONEnumnofull | do_not_personalize | anonymized_only,
default: full
FIRST_NAMEStringno
LAST_NAMEStringno
ZIP_CODEStringnoZip code from the customers billing address
PHONEStringnoPhone 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_FREQUENCYEnumnoevery day | special occasions | never
PARAMETERSnoCustom 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>
Was this article helpful to you? Yes 1 No