Перейти к содержанию
Документация для разработчиков Практические руководства Поддержка Запросить демо Войти
Pushwoosh.com

Импорт контактов

Загрузите один CSV-файл, чтобы одновременно зарегистрировать контакты в качестве подписчиков на email, SMS, WhatsApp и Viber. Сопоставьте каждый столбец, содержащий контактный адрес, с соответствующим каналом. Один и тот же столбец, например с номером телефона, можно сопоставить с несколькими каналами, поэтому вам больше не понадобится отдельный файл для номеров SMS и WhatsApp, если это один и тот же номер.

Подготовьте ваш CSV-файл

Anchor link to

Правила форматирования CSV

Anchor link to

Общая структура

Anchor link to
  • Первая строка должна содержать заголовки столбцов, описывающие данные в каждом столбце.
  • Каждая последующая строка представляет один контакт со значениями, соответствующими заголовкам.
  • Значения должны быть разделены запятыми.
  • Сохраните файл в кодировке UTF-8, чтобы обеспечить правильное отображение символов.
  • Максимальный размер файла — 100 МБ.

Столбцы с контактами

Anchor link to

Включите хотя бы один из следующих столбцов в зависимости от того, для каких каналов вы хотите зарегистрировать контакт:

  • Email: адрес электронной почты получателя.
  • Номер телефона (для SMS, WhatsApp и Viber): должен быть в международном формате, начинаться с + и кода страны, например +120XXXXX234. Введите обычный номер телефона. Pushwoosh добавит префикс whatsapp: или viber: внутри системы после того, как вы сопоставите столбец с этим каналом, поэтому не добавляйте его самостоятельно.

Номер телефона, не соответствующий международному формату, будет проигнорирован для данного канала во время импорта, но это не приведет к сбою всей строки.

Необязательные столбцы

Anchor link to
  • User ID: уникальный идентификатор пользователя (например, имя или email). Не является обязательным, но рекомендуется, чтобы каналы контакта использовали один профиль пользователя, а не несколько.
  • Любой другой столбец можно сопоставить с системным тегом для сегментации и персонализации, например Location, Birthday, Language или Customer type.

Пример CSV-файла

Anchor link to
Email,Mobile,User ID,Name,Location
john.smith@email.com,+120XXXXX234,john.smith@email.com,John Smith,New York
jane.smith@email.com,+131XXXXX890,jane.smith@email.com,Jane Smith,Los Angeles

Загрузите и сопоставьте CSV-файл

Anchor link to
  1. Перейдите в Audience → Import CSV → Import Contacts.

Центр импорта CSV в разделе Audience, где показана карточка Import Contacts рядом с Update tag values, Import push subscribers, Import events и Import subscription categories

  1. Нажмите Upload CSV и выберите ваш файл. Чтобы заменить его, нажмите Upload Another CSV.

  2. Введите Segment name (название сегмента) для импортированных контактов.

  3. В разделе Contact column in CSV выберите столбец и рядом с ним выберите Channel (канал), на который он регистрирует (Email, SMS, WhatsApp или Viber). Нажмите + Add channel, чтобы сопоставить другой столбец или сопоставить тот же столбец с дополнительным каналом.

  4. В разделе UserId column in CSV выберите столбец с уникальными идентификаторами пользователей, если он есть в вашем файле.

  5. Чтобы включить дополнительные данные для сегментации, выберите Column Name (название столбца) из вашего CSV-файла и назначьте ему Tag (тег). Нажмите + Add Column, чтобы сопоставить больше атрибутов.

Шаг сопоставления в мастере импорта контактов, где один столбец сопоставлен с Email, один столбец Mobile сопоставлен с SMS, WhatsApp и Viber, а столбец City сопоставлен с тегом

  1. Нажмите Start Import, чтобы начать обработку файла.

После импорта контакты будут доступны для кампаний на сопоставленных вами каналах. Они появятся как новый сегмент в списке сегментов, а также будут доступны через User explorer.

Строки, пропущенные при импорте

Anchor link to

На экране завершения пропущенные строки группируются по причинам:

  • Email-адрес недействителен
  • Номер телефона недействителен
  • В строке нет контактного адреса: все сопоставленные столбцы были пустыми

Строка может быть импортирована частично и все равно появиться в этой разбивке. Например, столбец с email-адресом импортируется успешно, а столбец с телефоном не проходит проверку.

Нажмите Download skipped rows, чтобы получить CSV-файл только с этими строками. В файл будет добавлен дополнительный столбец с причиной пропуска, чтобы вы могли исправить строки и загрузить их заново.

Строки, которые не удалось зарегистрировать при импорте

Anchor link to

Некоторые строки в файле выглядят правильно, но все равно не проходят. Например, email-адрес может быть написан правильно, но все равно отклонен, потому что он принадлежит одноразовому или возвращенному домену. Pushwoosh считает такие строки как Failed (Неудачные), отдельно от Added (Добавленных) или Skipped (Пропущенных).

Неудачные строки не разбиваются по причинам и не включаются в файл для скачивания пропущенных строк. Чтобы найти их, сравните ваш исходный CSV-файл с импортированным сегментом. Исправьте недостающие адреса (например, удалите одноразовый или возвращенный домен), а затем повторно загрузите только эти строки в новом импорте.