Sign in

Welcome to our Support Center

Get help with integration and live campaigns

Welcome to our Support Center. Get help with integration and live campaigns

Store Directory

1 - Why should I share this data?

In order to run Store Conversions campaigns, we need to understand the location of your stores and key information that shoppers need to visit.

We will leverage this data to improve campaign targeting and display the most relevant ads to shoppers. 

2 - Format overview and frequency

  • We accept CSV or TSV (comma- or tab-separated values) files
  • The header must be declared in the first row of the file and must be provided in lower case without spaces
  • Each line of the file should be a distinct store
  • Files can be uploaded to the Criteo FTP or SFTP, or downloaded from your own FTP, SFTP or http(s) servers by Criteo.  Get in touch with your Criteo Account Strategist to agree the integration method that is best for you
  • We can support daily file updates. However, if information doesn’t change that often, just let us know when we need to ingest a new file

3 - List of required fields

3.1 - store information

3.1.1 store_id

ID of the store.

This must match the value sent in your offline sales data feed.

Value: String.

Example: 1so56

3.1.2 store_name

Name of the store.

Please note, this value can be used to display in the creatives.

Value: String.

Example: Rockefeller Center

3.1.3 store_url

URL of the dedicated store page on your website.

Please note, this URL can be used in creatives to redirect to more information about the specific store.  If you don't have dedicated store pages on your site, we can default to a given URL.

Value: URL

Example: http://mysite.com/ stores?store=r23

3.2 - location data

3.2.1 address

First line(s) of the store address excluding postal code, city, region/state and country.

Please note, this value can be used to display in the creatives.

Value: String

Example: 514 4th ave.

3.2.2 zipcode

Zipcode of the store.

Please note, this value can be used to display in the creatives. 

Value: String

Example: 94120

3.2.3 city

City the store is located in.

Value: String

Example: San Francisco

 

3.2.4 location_lat

Latitude GPS co-ordinate of the store.

Please conform to the WGS84 standard.

Value: Decimal

Example: 47.908126

3.2.5 location_long

Longitude GPS co-ordinate of the store.

Please conform to the WGS84 standard.

Value: Decimal

Example: 1.905492

3.2.6 primary_phone

Phone number of the store.

This data input is optional.

Value: String

Example: (765) 876-7211 

 

3.3 - opening hours

3.3.1 monday_hours

Opening hours of the store on Mondays.

Please present the data in the following format; HH:mm-HH:mm|HH:mm-HH:mm

Use "|" to separate morning and afternoon opening hours when there is a break during the day.

Leave this field empty or use "x" if the store is closed on this day.

Value: String

Example: 09:00-12:00|13:00-20:00

3.3.2 tuesday_hours

Opening hours of the store on Tuesdays.

Please present the data in the following format; HH:mm-HH:mm|HH:mm-HH:mm

Use "|" to separate morning and afternoon opening hours when there is a break during the day.

Leave this field empty or use "x" if the store is closed on this day.

Value: String

Example: 09:00-18:00

3.3.3 wednesday_hours

Opening hours of the store on Wednesdays.

Please present the data in the following format; HH:mm-HH:mm|HH:mm-HH:mm

Use "|" to separate morning and afternoon opening hours when there is a break during the day.

Leave this field empty or use "x" if the store is closed on this day.

Value: String

Example: 09:00-18:00

3.3.4 thursday_hours

Opening hours of the store on Thursdays.

Please present the data in the following format; HH:mm-HH:mm|HH:mm-HH:mm

Use "|" to separate morning and afternoon opening hours when there is a break during the day.

Leave this field empty or use "x" if the store is closed on this day.

Value: String

Example: 09:00-18:00

3.3.5 friday_hours

Opening hours of the store on Fridays.

Please present the data in the following format; HH:mm-HH:mm|HH:mm-HH:mm

Use "|" to separate morning and afternoon opening hours when there is a break during the day.

Leave this field empty or use "x" if the store is closed on this day.

Value: String

Example: 09:00-18:00

3.3.6 saturday_hours

Opening hours of the store on Saturdays.

Please present the data in the following format; HH:mm-HH:mm|HH:mm-HH:mm

Use "|" to separate morning and afternoon opening hours when there is a break during the day.

Leave this field empty or use "x" if the store is closed on this day.

Value: String

Example: 09:00-18:00

3.3.7 sunday_hours

Opening hours of the store on Sundays.

Please present the data in the following format; HH:mm-HH:mm|HH:mm-HH:mm

Use "|" to separate morning and afternoon opening hours when there is a break during the day.

Leave this field empty or use "x" if the store is closed on this day.

Value: String

Example: 09:00-18:00

3.3.8 special_hours

Special opening hours of your store on a specific day.

Please present the data in the following format; yyyy-MM-dd:HH:mm-HH:mm|HH:mm-HH:mm;yyyy-MM-dd

Use "|" to separate morning and afternoon opening hours when there is a break during the day.

Use "x" to represent that a store is shut on a specific date.

Value: String

Example: 2016-12-24:08:00-13 :00|14:00-20:00;2016-12-25:x;2016-12-26:08:00-18:00

3.4 - additional information

3.4.1 services

List of the services offered in this store. Values must be separated by pipes (|).

This data input is optional.

Value: String

Example: Pet Grooming|ATM|Free Delivery

3.4.2 store_picture

URL to the main picture of the store.

This data input is optional.

Value: URL

Example: http://storepicture123c.jpg

3.4.3 custom_label1

Any short marketing message you want to push which is specific to this store.

This data input is optional. You can add multiple marketing messages by including additional custom_label lines in your feed.

Value: String

Example: Free yoga class every Tuesday

 

Was this article helpful?
0 out of 0 found this helpful
Powered by Zendesk