Information for: DEVELOPERS   PARTNERS   SUPPORT

Address & Customer Address XRef Feeds

The Address feed ties to the Customer feed via the CustomerAddressXRef feed. This enables us to handle many-to-many relationships between addresses and customers, via this cross-reference feed. If you only have one address per customer, you can also provide it directly in the Customer feed.

Address feed structure

Field Name Required ? Data type Referential integrity Description
SourceAddressNumber (key) Required String CustomerAddressXRef:SourceAddressNumber The unique ID for this address.
Name Optional String   The name of the address, e.g. “San Francisco home”, “Work”…
Type Optional String   The address’ type, e.g. “primary residence”, “work”…
Address1 Recommended String   The first line of the address (typically the street number and street name).
Address2 Recommended String   The second line of the address (typically the unit/suite/apt number).
City Recommended String   The city in which this address is located.
Zip Recommended String   The zipcode for this address. You can include the Zip+4 in this field if you have it.
State Recommended String   The state, or province, in which this address is located.
Country Recommended String   The country in which this address is located.
CountryCode Required String   The standard ISO Alpha-2 code for the country where the organization is located (e.g. “United States” should be “US”, “France” should be “FR”, etc…).Required for address validation and distance-to-store calculations. See the list of supported countries for more details
Custom attributes Optional Any (float, datetime, string, boolean)   Custom attributes that you want to use inside the Customer Data Platform (CDP) application. Note that this customization is not self-service, requires you to engage with your CDP CSM, and involves some deployment effort.

Customer Address XRef feed structure

Field Name Required ? Data type Referential integrity Description
SourceAddressNumber (key) Required String Address:SourceAddressNumber The unique identifier of the address in your data.
SourceCustomerNumber (key) Required String Customer:SourceCustomerNumber The unique identifier of the customer in your data.