Черный список контактов

При регистрации, подписке или оформлении заказа клиенты могут указать некорректные контакты (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)

Для асинхронных и синхронных операций без обязательной валидации действуют общие правила.

Если в операции включен флаг «Операция возвращает валидационные ошибки», то при наличии некорректного контакта данные не будут записаны.

Сообщения о наличии некорректных контактов можно найти в ’Логе выполненных операций’ в разделе «Интеграции».

Работа с некорректными контактами при проблемах с импортом

Представим, что вы импортируете базу клиентов или заказов. Заводится проблема о том, что у клиентов много объединений или редактирований контактов. Это признак того, что в данных могут присутствовать некорректные контакты.
Порядок действий:

1. Проанализировать наиболее часто встречающиеся телефоны и email-адреса. В том числе те, которые вызвали объединения и редактирования клиентов (сообщение в проблеме).

2. Если они некорректные, то добавить их в список некорректных адресов.

3. Удалить загруженные данные.

4. Повторно импортировать данные. Некорректные контакты будут отброшены.

Добавление и удаление некорректных контактов через API

Инструкция

Как выгрузить черный список

1. На вкладке Клиенты в меню нажмите «Выгрузить черный список»:

2. Создается задача на экспорт:

3. По ссылке — файл с данными:

Поля в файле выгрузки:

• FakeContactContact — некорректный контакт;
• FakeContactContactType — тип контакта:
  • Email — email-адрес;
  • MobilePhone — мобильный номер;
  • ExternalIdentity — идентификатор клиента;
  • Device — идентификатор устройства;
  • DiscountCardNumber — номер дисконтной карты.
• FakeContactCustomFieldSystemName — системное имя идентификатора для типа контакта ExternalIdentity;
• FakeContactCreationDateTimeUtc — дата и время попадания в список;
• FakeContactDescription — причина попадания в список:
  • «Базовый список некорректных контактов»
  • «Превышение лимита редактирований или объединений (N раз за час)»
  • «Массовая операция — Импорт черного списка. ID задачи N»

Пример файла экспорта:

Список некорректных контактов

Список индивидуален для каждого проекта. Базовый список телефонов и 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