Черный список контактов
При регистрации, подписке или оформлении заказа клиенты могут указать некорректные контакты (79777777777, not@real.ru).
Клиенты с подобными контактами массово объединяются, действительные телефоны и email-адреса смешиваются с некорректными.
Для защиты от некорректных контактов создан «черный список». Контакты из него не могут быть добавлены на проект.
В список уже внесены самые частые некорректные контакты, и его можно редактировать.
Правила работы с некорректными контактами
1. Если при регистрации, подписке или заказе передан только некорректный контакт — данные не записываются.
2. Если передан некорректный контакт вместе c корректным контактом и/или идентификатором клиента — данные будут записаны, некорректный контакт отброшен.
3. При редактировании некорректный контакт не будет записан.
4. Фильтрация работает для всех способов передачи данных в Mindbox: ручные и автоматические файловые импорты, операции (API).
Добавление контакта в черный список не влияет на отправку рассылок.
Поэтому, после добавления контактов в список, нужно либо затереть их у клиентов, либо удалить клиентов с ними из базы.
Как следствие, пользователям не будут записываться некорректные контакты и в получателей рассылок они не попадут.
Причины попадания контактов в черный список
1. Наличие в базовом списке самых частых некорректных контактов.
2. Автоматическое добавление контакта в список при превышении лимита редактирований или объединений. При этом на проекте открывается «Проблема». Примеры проблем можно посмотреть по ссылке.
3. Импорт отобранных контактов в список.
Импорт черного списка
Чтобы добавить клиентов в черный список на проекте:
1. На вкладке Клиенты нажмите «Импорт» → «Импорт клиентов»:
2. Выберите операцию «Импорт черного списка»:
Для скачивания доступен шаблон с примером. Также на странице появляются данные по всем возможным полям для загрузки: их название, описание и обязательность с примерами принимаемых форматов.
3. Подготовьте файл.
В первой строке указываются названия полей, в которые нужно загрузить данные по клиенту.
Формат — .csv
Кодировка — по умолчанию utf-8. Можно проверить кодировку своего файла с помощью текстовых редакторов вроде Notepad++, VS Code и т.д.
Поля для заполнения:
- ContactType — тип контакта, который будет добавлен в список; обязательное поле. Доступные типы:
- Email — email-адрес
- MobilePhone — мобильный номер
- ExternalIdentity — идентификатор клиента; его системное имя задается в CustomFieldSystemName
- Device — идентификатор устройства
- DiscountCardNumber — номер дисконтной карты
- Contact — сам контакт; обязательное поле
- CustomFieldSystemName — системное имя идентификатора; обязательное поле для типа контакта ExternalIdentity
Пример заполненного файла:
4. Прикрепите файл для импорта и поставьте задачу:
-
Появляется ссылка на неё:
После успешного завершения задачи контакты будут добавлены в список.
Удаление из черного списка
Те же шаги, что в импорте, но нужно выбрать операцию удаления:
Операции V3 (API)
Для асинхронных и синхронных операций без обязательной валидации действуют общие правила.
Если в операции включен флаг «Операция возвращает валидационные ошибки», то при наличии некорректного контакта данные не будут записаны.
Сообщения о наличии некорректных контактов можно найти в ’Логе выполненных операций’ в разделе «Интеграции».
Работа с некорректными контактами при проблемах с импортом
Представим, что вы импортируете базу клиентов или заказов. Заводится проблема о том, что у клиентов много объединений или редактирований контактов. Это признак того, что в данных могут присутствовать некорректные контакты.
Порядок действий:
-
Проанализировать наиболее часто встречающиеся телефоны и email-адреса. В том числе те, которые вызвали объединения и редактирования клиентов (сообщение в проблеме).
-
Если они некорректные, то добавить их в список некорректных адресов.
-
Удалить загруженные данные.
-
Повторно импортировать данные. Некорректные контакты будут отброшены.
Добавление и удаление некорректных контактов через API
Как выгрузить черный список
1. На вкладке Клиенты в меню нажмите «Выгрузить черный список»:
2. Создается задача на экспорт:
3. По ссылке — файл с данными:
Поля в файле выгрузки:
- FakeContactContact — некорректный контакт;
- FakeContactContactType — тип контакта:
- Email — email-адрес;
- MobilePhone — мобильный номер;
- ExternalIdentity — идентификатор клиента;
- Device — идентификатор устройства;
- DiscountCardNumber — номер дисконтной карты.
- FakeContactCustomFieldSystemName — системное имя идентификатора для типа контакта ExternalIdentity;
- FakeContactCreationDateTimeUtc — дата и время попадания в список;
- FakeContactDescription — причина попадания в список:
- «Базовый список некорректных контактов»
- «Превышение лимита редактирований или объединений (N раз за час)»
- «Массовая операция — Импорт черного списка. ID задачи N»
Если не указаны время или причина
- У контактов, попавших в список до 20 декабря 2023 года через импорт или превышение лимита, время и причина попадания не отображаются.
- У некорректных контактов в базовом списке причина выводится всегда. Время попадания соответствует созданию проекта и отображается только на проектах, созданных после 20 декабря 2023 года.
Пример файла экспорта:
Список некорректных контактов
Список индивидуален для каждого проекта. Базовый список телефонов и email указан ниже. Вы можете добавлять или удалять контакты из этого списка.
Email-адреса
11111@mail.ru
123@mail.ru
1@1.RU
585@585mail.ru
1@mail.ru
585@mail.ru
0000@mail.ru
12345@mail.ru
585gold@mail.ru
000@mail.ru
demo@example.com
00@mail.ru
net@net.ru
123456@mail.ru
m@il.ru
mail.@mail.ru
mail@mail.ru
mail@mail.ru
mymail@mail.ru
n@mail.ru
1111@MAIL.RU
net@mail.ru
585@585.ru
1@1.ru
net@ya.ru
net@yandex.ru
No@mail.ru
no@no.ru
nomail@mail.ru
nomail@nomail.com
nomail@nomail.ru
noname@legkomarket.ru
noname@mail.ru
Nonnon@mail.ru
not@mail.ru
not@real.email
not@real.ru
notreal@mail.ru
pisem@net.ru
QWERT@mail.ru
qwerty@mail.ru
shop@reee.ru
unknown@site.ru
1@1
q@q
fale@fake.ru
Мобильные телефоны
70000000000
71111111111
71234567890
72222222222
72222224545
73333333333
74444444444
75346456456
75555555555
76666666666
77777777777
78888888888
79000010000
79111111111
79123456789
79151234567
79222222222
79333333333
79444444444
79555555555
79666666666
79777777777
79880000000
79888888888
79995555555
79999999999