Data upload modes

The modes for uploading customer and order data used in the POST /cdp/apiv1/counter/{counterId}/data/contacts and POST /cdp/apiv1/counter/{counterId}/data/orders methods are described below.

If the information has already been uploaded to Yandex Metrica and is not included in the transmitted data, it remains unchanged. If there are several lines with the same ID in the uploaded data, they are applied randomly.

Note. For any mode, pass all required fields, even ones that aren't modified.

You can't change the customer or order creation date.

SAVE

All previously transmitted data is completely replaced with new data.

Example
The attribute value before the update The attribute value in the transmitted data The attribute value after the update
1 The attribute is missing in the exported data null
1.2 1.3 1.3
Example
The attribute value before the update The attribute value in the transmitted data The attribute value after the update
1 The attribute is missing in the exported data null
1.2 1.3 1.3
UPDATE

Only the information that you're currently uploading is updated.

Example
The attribute value before the update The attribute value in the transmitted data The attribute value after the update
1 The attribute is missing in the exported data 1
1,2 1,3 1,3
Example
The attribute value before the update The attribute value in the transmitted data The attribute value after the update
1 The attribute is missing in the exported data 1
1,2 1,3 1,3
APPEND

New information is added to the previously uploaded information.

Example
The attribute value before the update The attribute value in the transmitted data The attribute value after the update
1 The attribute is missing in the exported data 1
1,2 1,3 1,2,3
Example
The attribute value before the update The attribute value in the transmitted data The attribute value after the update
1 The attribute is missing in the exported data 1
1,2 1,3 1,2,3