Data upload modes

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

If the information is already 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

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

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