From 473637667e475302420a0da41105fb5697cae409 Mon Sep 17 00:00:00 2001 From: Kseniya Pryalukhina <117263816+Ksksksksen@users.noreply.github.com> Date: Mon, 13 Jan 2025 18:15:31 +0300 Subject: [PATCH] fix(sendsay-docs): edit article (#357) --- .../how-to-prepare-file-for-import.md | 33 ++++++++++++------- 1 file changed, 21 insertions(+), 12 deletions(-) diff --git a/docs/subscribers/import-and-export/how-to-prepare-file-for-import.md b/docs/subscribers/import-and-export/how-to-prepare-file-for-import.md index 36d9ee50..b4c5d53c 100644 --- a/docs/subscribers/import-and-export/how-to-prepare-file-for-import.md +++ b/docs/subscribers/import-and-export/how-to-prepare-file-for-import.md @@ -1,7 +1,7 @@ --- sidebar_position: 2 sidebar_label: 'Файл для импорта' -description: Как подготовить файл для импорта контактов и других данных подписчиков +description: Как подготовить файл для загрузки контактов и других данных подписчиков --- import fieldCode from "/img/subscribers/import-and-export/how-to-prepare-file-for-import/field-code.png"; @@ -12,32 +12,36 @@ import Details from '@theme/Details'; import SupportLink from '@site/src/components/SupportLink'; import authextId from '/img/subscribers/import-and-export/how-to-prepare-file-for-import/authext-id.png'; -# Как подготовить файл для импорта +# Как подготовить файл для загрузки контактов + +Файл для загрузки контактов и других данных может понадобиться для [импорта подписчиков](https://docs.sendsay.ru/subscribers/import-and-export/how-to-import-subscribers), а также, например, для отправки экспресс-выпусков. Данные в файле должны соответствовать установленному формату. ### 1. Формат файла Файл должен быть формата CSV, TXT, XLSX или ZIP. -### 2. Расположение данных в файле +:::tip Важно +При работе с файлами формата XLSX стоит учитывать, что такой файл поддерживает 1 048 576 строк на лист. +::: -На одной строке записываются данные одного подписчика, порядок данных в строках должен быть одинаковым. Требования к первой строке файла различаются в зависимости от того, как вы импортируете контакты — вручную или через автоматизацию по времени. +### 2. Расположение данных в файле -При автоимпорте в первой строке каждого столбца нужно указать код поля, куда будут записаны данные. Код хранится в анкете напротив самого поля, префикс «anketa» копировать не нужно. Например, для столбца с именами нужно скопировать `base.firstName`: +На одной строке записываются данные одного подписчика, порядок данных в строках должен быть одинаковым. При обычном [импорте подписчиков](https://docs.sendsay.ru/subscribers/import-and-export/how-to-import-subscribers) через интерфейс в первой строке файла можно просто указать наименования столбцов, так как поля со столбцами сопоставляются вручную.

- Field code + File for manual import

-При автоимпорте у подписчиков может быть только основной контакт. Чтобы загружать дополнительные контакты, напишите в чат поддержки. Весь файл будет выглядеть вот так: +В других случаях в первой строке для каждого столбца необходимо указать коды полей, куда система запишет данные. Например, вот так может выглядеть файл:

File for autoimport

-При обычном импорте через интерфейс коды полей в файле указывать не нужно, так как поля со столбцами сопоставляются вручную. В первой строке файла могут быть указаны наименования столбцов — её можно будет пропустить при импорте. +Коды полей хранятся в [анкетах](https://docs.sendsay.ru/subscribers/subscriber-data/data-groups). Префикс «anketa» копировать не нужно: например, для столбца с именами нужно скопировать `base.firstName`.

- File for manual import + Field code

### 3. Разделитель данных @@ -60,8 +64,9 @@ pochta2@gmail.com, , Фёдоров, , 1980-02-14 - электронный адрес, - телефон, -- идентификатор csid, -- ID пользователя в Телеграме (это комбинация цифр — отправлять рассылки через бота по нику или номеру телефона нельзя). +- идентификатор CSID, +- ID пользователя в Телеграме (это комбинация цифр — отправлять рассылки через бота по нику или номеру телефона нельзя), +- [идентификатор пользователя приложения](#файл-для-импорта-mobile-push-подписчиков) для отправки Mobile Push уведомлений. По основному контакту происходит склеивание данных, если вы загружаете данные, которые уже есть в базе. Подписчики без основного контакта не загружаются. Если вы импортируете контакты в список, тип основного контакта должен совпадать с типом списка: @@ -73,6 +78,10 @@ pochta2@gmail.com, , Фёдоров, , 1980-02-14 ![How to choose list during import](/img/subscribers/import-and-export\how-to-prepare-file-for-import/how-to-choose-list-during-import.gif)
+:::tip Важно +При [автоматическом импорте](https://docs.sendsay.ru/automations/autoimport/how-to-set-autoimport) у подписчиков может быть только основной контакт. Чтобы загружать дополнительные контакты, напишите в чат поддержки. +::: + ### 5. Формат записи дат и телефонных номеров Даты указываются в формате ГГГГ-ММ-ДД. Например, для даты «1 июля 1993 года» запись будет такой: @@ -154,7 +163,7 @@ token@platform.os.authext_id =A1&"@"&B1&"."&C1&"."&D1 ``` - Затем нажмите клавишу ввода — формула автоматически преобразуется в нужное значение. Скопируйте ячейку с формулой вниз на весь столбец% + Затем нажмите клавишу ввода — формула автоматически преобразуется в нужное значение. Скопируйте ячейку с формулой вниз на весь столбец. ![Mobile push contacts](/img/subscribers/import-and-export/how-to-prepare-file-for-import/how-to-prepare-mobile-push-contacts1.gif)