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

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

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

Формат файла

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

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

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

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

Если номер телефона не соответствует международному формату, он пропускается для этого канала. Остальная часть строки все равно импортируется.

Примечание

Названия столбцов в вашем CSV-файле не обязательно должны совпадать с этими метками. Во время импорта вы сопоставляете существующие названия столбцов с каналом в мастере. Например, столбец с названием Mobile можно сопоставить с каналом SMS или WhatsApp.

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

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

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

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-файл

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

   

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

   Осторожно

   При загрузке Pushwoosh проверяет весь файл. Если строку не удается разобрать (количество столбцов в ней не совпадает с заголовком или значение в кавычках не закрыто), файл сразу отклоняется. Во всплывающем уведомлении указываются номер строки и причина, например «Row 42: the number of values does not match the header.» В этом случае ничего не импортируется. Исправьте эту строку и загрузите файл снова.

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

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

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

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

   

7. Нажмите Start Import.

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

На экране завершения показаны два счетчика:

• Created: регистрации каналов, новые для приложения.
• Updated: регистрации каналов, которые уже существовали, в том числе когда тот же адрес или номер повторно регистрируется под другим User ID или на другой платформе устройства.

Оба счетчика учитывают регистрации каналов, а не контакты или строки CSV. Контакт, сопоставленный с двумя каналами, например SMS и WhatsApp, добавляет 2.

У обновленного контакта меняются только теги, сопоставленные на шаге 6. Их значения перезаписываются значениями из CSV. Другие теги, уже заданные для контакта, остаются без изменений.

Примечание

Более ранние импорты в списке недавних импортов показывают один счетчик Imported вместо Created и Updated.

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

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

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

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

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

Примечание

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

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

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

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