Skip to main content

Criteo

Download Criteo-Plugin plugin

To export item data to Criteo, you need the plugins Criteo-Plugin  and Elastic export. You can download the plugins in the plentyMarketplace .

1. Registering with Criteo

Criteo is a personalized retargeting company that works with Internet retailers to serve personalized online display advertisements to consumers who have previously visited the advertiser’s website. In order to set up the Criteo plugin, first register with Criteo .

2. Setting up the data format Criteo-Plugin in plentymarkets

By installing this plugin you will receive the export format Criteo-Plugin. Use this format to exchange data between plentymarkets and Criteo using the elastic export. You also need to install the plugin Elastic export from the plentyMarketplace first before you can use the format in plentymarkets.

Once both plugins are installed in your plentymarkets system, you can create the export format Criteo-Plugin. For more information on export formats, see the elastic export page.

Criteo retrieves item data via an URL. To make sure that your item data can be exported to Criteo, you have to save the URL at Criteo.

Creating a new export format:

  1. Go to Data » Elastic export.

  2. Click on New export ().

  3. Carry out the desired settings. Pay attention to the information given in Table 1.
    Note: There are no item filters set by default. If you do not add any item filters, all items are exported.

  4. Save () the settings.
    → The export format Criteo-Plugin is given an ID.
    → The export format is shown in the Exports overview.

  5. Save the URL displayed in the URL field at Criteo.

Table 1 lists details for settings, format settings and recommended item filters for the format Criteo-Plugin.

Table 1. Format settings and recommended item filters for the format Criteo-Plugin
Setting Explanation

Settings

Name

Enter a name. The export format is listed under this name in the overview in the Exports tab.

Type

Select the type item from the drop-down list.

Format

Select Criteo-Plugin.

Limit

Enter a number. If you want to transfer more than 9,999 data records to the interface, the output file will not be generated again for another 24 hours. This is to save resources. If more than 9999 data records are necessary, activate the option Generate cache file.

Generate cache file

Activate this option if you want to transfer more than 9999 data records to the interface.
Note: We recommend that you do not activate this option for more than 20 export formats. This is to ensure a high performance of the elastic export.

Provisioning

Select URL. Use this option to generate a token for authentication in order to allow external access.

Token, URL

Click on Generate token.
→ The token is entered automatically.
→ A URL is created in the field URL.

File name

The file name must have the ending .csv or .txt for Criteo to be able to import the file successfully.

Item filters

Add item filters

Select the items you wish to export. Select one or more of the following item filters from the drop-down list and click on Add. There are no filters set by default. It is possible to add all of the item filters listed below from the drop-down list one after the other.

  • Variations = Select the variations to be transferred.

    • Transfer all = All variations are transferred.

    • Only transfer main variations = Only main variations are transferred.

    • Do not transfer main variations = Only the variations of an item are transferred. Main variations are not transferred.
      Tip: Use this filter option if the main variations are virtual and not for sale.

    • Only transfer single variations = Only the main variations of items are transferred that have only a main variation and no other variations.

  • Markets = Select one or more order referrers. The selected order referrer has to be active at the variation for the item to be exported.

  • Currency = Select a currency.

  • Category = Activate to transfer the item with its category link. Only items that belong to this category are exported.

  • Image = Activate to transfer the item with its image. Only items with images are transferred.

  • Client = Select a client.

  • Stock = Select which stocks should be exported.

  • Flag 1-2 = Select a flag.

  • Manufacturers = Select one, several or ALL manufacturers.

  • Active = Activate if you only want to export active variations.

Format settings

Product URL

Choose the URL that you wish to transfer to the interface. You can choose between the item’s URL and the variation’s URL.
Note: URLs of variations can only be transferred in combination with the Ceres online store.

Client

Select a client. This setting is used for the URL structure.

URL parameter

Enter a suffix for the product URL if this is required for the export.
→ This character string is added to the product URL if you have activated the transfer option for the product URL further up.

Order referrer

Select the order referrer that should be assigned during the order import from the drop-down list.
→ The selected referrer is added to the product URL so that sales can be analysed later.

Marketplace account

Select the marketplace account from the drop-down list.

Language

Select the language from the drop-down list.

Item name

Select Name 1, Name 2 or Name 3. The names are saved in the Texts tab of the item. Enter a number into the Maximum number of characters (def. text) field if desired. This specifies how many characters are exported for the item name.

Preview text

This option does not affect this format.

Description

Select the text that you want to transfer as description. Enter a number into the Maximum number of characters (def. text) field if desired. This specifies how many characters are exported for the description. Activate the option Remove HTML tags if you want HTML tags to be removed during the export. If you only want to allow specific HTML tags to be exported, then enter these tags into the field Permitted HTML tags, separated by comma (def. text) field. Use commas to separate multiple tags.

Target country

Select the target country from the drop-down list.

Barcode

Select the ASIN, ISBN or a GTIN from the drop-down list.
Note: The barcode has to be linked to the order referrer selected above. Otherwise, the barcode will not be exported.

Image

Select Position 0 or First image.

  • Position 0 = An image with position 0 is transferred.

  • First image = The first image is transferred.

Image position of the energy label

This option does not affect this format.

Stock buffer

The stock buffer for variations with limitation to the net stock.

Stock for variation without stock limitation

The stock for variations without stock limitation.

Stock for variations with no stock administration

The stock for variations without stock administration.

Live currency conversion

Activate this option to convert the price into the currency of the selected country of delivery. The price has to be released for the corresponding currency.

Sales price

Select gross price or net price from the drop-down list.

Offer price

Activate to transfer the offer price.

RRP

This option does not affect this format.

Shipping costs

Activate this option if you want to use the shipping costs that are saved in a configuration. If this option is activated, then you are able to select the configuration and the payment method from the drop-down lists. Activate the option Transfer flat rate shipping charge if you want to use a flat rate shipping charge. If this option is activated, a value has to be entered in the line underneath.

VAT note

This option does not affect this format.

Item availability

Activate the overwrite option and enter item availabilities into the fields 1 to 10. The fields represent the IDs of the availabilities. This overwrites the item availabilities that are saved in the Setup » Item » Availability menu.

3. Available columns for the export file

Open the export format Criteo-Plugin in the Data » Elastic export menu to download and edit the export file.

Downloading the export file:

  1. Go to Data » Elastic export.

  2. In the line of the format Criteo-Plugin, click on Download ().
    → The file is downloaded and saved on your computer.

  3. Open the export file with an appropriate program.

Table 2. Available columns of the export file for the export format {exportformat}
Column header Explanation

id
(mandatory)

The SKU of the variation

title
(mandatory)

According to the format setting Item name.

description

According to the format setting Description

google_product_category

According to the setting Setup » Markets » Google » Google Shopping Int. the Google Shopping category for the default category

link
(mandatory)

The URL path of the item depending on the chosen client in the format settings.

image_link
(mandatory)

The URL of the image. Variation images are prioritised over item images.

additional_image_link

Additional comma-separated image URLs for up to 10 images. Variation images are prioritised over item images.

availability

The name of the item availability saved in the Setup » Item » Availability menu or the translation according to the format setting Overwrite item availability.

price
(mandatory)

The sales price.

sale_price

The offer price of the variation according to the setting offer price

gtin

According to the format setting Barcode

mpn

The model of the variation

brand

The name of the manufacturer of the item. If it exists, the external name saved in the Setup » Item » Manufacturers menu is preferred.

adult

The Criteo characteristic adult. Possible values:

  • yes

  • no

product_type

The name of the default category linked to the variation

product_type_key

Empty

number_of_ratings

Empty

product_rating

Empty

filters

Empty

mobile_link

The Criteo characteristic mobile link

condition

The item’s condition. Possible values:

  • new

  • refurbished

  • used

item_group_id

The item ID of the variation.

color

The color of the variation according to the attribute or characteristic. Characteristics are prioritised.

gender

The gender according to the Criteo characteristic gender. Possible values:

  • female

  • male

  • unisex

age_group

The Criteo characteristic age group. Possible values:

  • newborn

  • infant

  • toddler

  • kids

  • adult

material

The material of the variation according to the attribute or characteristic. Characteristics are prioritised.

pattern

The pattern of the variation according to the attribute or characteristic. Characteristics are prioritised.

size

The size of the variation according to the attribute or characteristic. Characteristics are prioritised.

size_type

The Criteo characteristic size type. Possible values:

  • regular

  • petite

  • used

  • big

  • tall

  • maternity

size_system

The Criteo characteristic size system. Possible values:

  • US

  • UK

  • EU

  • UK

  • DE

  • FR

  • JP

  • CN

  • IT

  • BR

  • MEX

  • AU

cross_sellers_product_id

The Criteo characteristic Cross Selling ID

seller_name

The Criteo characteristic seller name

seller_id

The Criteo characteristic seller id

shipping

According to the format setting Shipping costs

shipping_weight

The weight of the variation

shipping_height

The height of the variation

shipping_width

The width of the variation

shipping_label

The length of the variation

multipack

Empty

is_bundle

Empty

promotion_id

The Criteo characteristic promotion id

promo_text

The Criteo characteristic promotion text

custom_label_0

The Criteo characteristic Custom label 0

custom_label_1

The Criteo characteristic Custom label 1

custom_label_2

The Criteo characteristic Custom label 2

custom_label_3

The Criteo characteristic Custom label 3

custom_label_4

The Criteo characteristic Custom label 4

sale_price_effective_date

The Criteo characteristic sales price effective date

adwords_redirect

The Criteo characteristic AdWords Redirect

excluded_destination

The Criteo characteristic excluded destination

expiration_date

Empty

unit_pricing_measure

The unit of the variation

unit_pricing_base_measure

The base unit of the variation according to unit_pricing_measure

display_ads_title

The display ads title according to the Criteo property display ads title

display_ads_value

The display ads value according to the Criteo property display ads value

map_price

Empty

map_model

Empty

Visit the Criteo website  for additional information on the Criteo product feed specifications.

4. License

This project is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE. Find further information in the file LICENSE.md .

To top