Skip to content

Commit

Permalink
fix(sendsay-docs): edit article (#357)
Browse files Browse the repository at this point in the history
  • Loading branch information
Ksksksksen authored Jan 13, 2025
1 parent 2ed1021 commit 4736376
Showing 1 changed file with 21 additions and 12 deletions.
Original file line number Diff line number Diff line change
@@ -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";
Expand All @@ -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) через интерфейс в первой строке файла можно просто указать наименования столбцов, так как поля со столбцами сопоставляются вручную.

<p align="center">
<img src={fieldCode} alt="Field code" />
<img src={fileForManualImport} alt="File for manual import" />
</p>

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

<p align="center">
<img src={fileForAutoimport} alt="File for autoimport" />
</p>

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

<p align="center">
<img src={fileForManualImport} alt="File for manual import" />
<img src={fieldCode} alt="Field code" />
</p>

### 3. Разделитель данных
Expand All @@ -60,8 +64,9 @@ [email protected], , Фёдоров, , 1980-02-14

- электронный адрес,
- телефон,
- идентификатор csid,
- ID пользователя в Телеграме (это комбинация цифр — отправлять рассылки через бота по нику или номеру телефона нельзя).
- идентификатор CSID,
- ID пользователя в Телеграме (это комбинация цифр — отправлять рассылки через бота по нику или номеру телефона нельзя),
- [идентификатор пользователя приложения](#файл-для-импорта-mobile-push-подписчиков) для отправки Mobile Push уведомлений.

По основному контакту происходит склеивание данных, если вы загружаете данные, которые уже есть в базе. Подписчики без основного контакта не загружаются. Если вы импортируете контакты в список, тип основного контакта должен совпадать с типом списка:

Expand All @@ -73,6 +78,10 @@ [email protected], , Фёдоров, , 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) <br/>

:::tip Важно
При [автоматическом импорте](https://docs.sendsay.ru/automations/autoimport/how-to-set-autoimport) у подписчиков может быть только основной контакт. Чтобы загружать дополнительные контакты, <SupportLink>напишите в чат поддержки</SupportLink>.
:::

### 5. Формат записи дат и телефонных номеров

Даты указываются в формате ГГГГ-ММ-ДД. Например, для даты «1 июля 1993 года» запись будет такой:
Expand Down Expand Up @@ -154,7 +163,7 @@ [email protected]_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)

Expand Down

0 comments on commit 4736376

Please sign in to comment.