Импорт push-подписчиков

Если вы переходите от другого push-провайдера, вы можете импортировать существующую базу push-подписчиков в Pushwoosh из CSV-файла. Токены продолжат работать, пока приложение использует тот же ключ APNs, проект Firebase или учетные данные HMS. Пользователям не нужно переустанавливать приложение или снова предоставлять разрешение.

Этот импорт регистрирует устройства с push-токенами. Он не создает сегмент. Импортированным устройствам присваивается тег CSV import, который вы можете использовать для последующего создания сегмента. Чтобы вместо этого импортировать список уже зарегистрированных User ID или Hardware ID в сегмент, см. Импорт сегмента.

Поддерживаемые платформы

Pushwoosh импортирует push-токены только для платформ, перечисленных ниже. Любое другое значение в device_type будет пропущено. См. Почему строка пропускается.

Столбец device_type принимает два разных формата в зависимости от того, откуда был получен ваш файл:

• Число, если ваш экспорт использует собственные коды платформ OneSignal.
• Слово, если это экспорт из Amazon Pinpoint или файл, созданный вами вручную.

Не смешивайте два формата в одном файле, так как одно и то же число означает разные платформы в каждой системе. Вставка числа из источника, отличного от OneSignal, может привести к тихому импорту устройств под неправильной платформой.

Платформа	Номер device_type в OneSignal	Допустимые названия платформ
iOS	0	ios, apns, apns_sandbox, apns_voip
Android	1	android, gcm, fcm
Amazon	2	amazon, adm, fireos
Windows	6	windows, wns
macOS	9	macos, osx
Huawei (HMS)	13	huawei, hms

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

• Собственные типы устройств OneSignal для web push, email и SMS.
• Платформы, которые Pushwoosh не поддерживает, например, снятые с поддержки Windows Phone или Baidu push.

Подписки на web push не могут быть перенесены от любого провайдера. Этим пользователям необходимо повторно подписаться через Pushwoosh SDK на вашем сайте.

Подготовка CSV-файла

Размер вашего CSV-файла не должен превышать 100 МБ. Назовите столбцы в точности так, как показано ниже. Регистр букв не имеет значения. Вы не можете сопоставить столбцы в интерфейсе, поэтому переименуйте все заголовки, которые не совпадают:

Заголовок	Соответствует
identifier	Push-токен (обязательно)
device_type	Платформа (обязательно)
external_id или external_user_id	User ID
language	Язык устройства
tags	JSON-объект со значениями кастомных тегов
invalid_identifier	Флаг “отписан” в OneSignal. Строки с этим флагом пропускаются

Столбец с часовым поясом, если он есть, не импортируется, так как его формат различается в разных версиях экспорта.

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

Вот пример файла subscribers.csv с двумя устройствами: одно использует название платформы, а другое — числовой код OneSignal:

identifier	device_type	external_id	language	tags
ios-token-0001	ios	user-1001	en	{"plan":"pro"}
android-token-0002	1	user-1002	en	{"plan":"free"}

Представление subscribers.csv в формате простого текста:

identifier,device_type,external_id,language,tags
ios-token-0001,ios,user-1001,en,"{""plan"":""pro""}"
android-token-0002,1,user-1002,en,"{""plan"":""free""}"

Примечание

Значение tags — это JSON-объект, и оно содержит кавычки. При создании этого файла в Excel или Google Sheets вам не нужно ничего делать, так как эти приложения автоматически заключают ячейку в кавычки. При редактировании файла непосредственно в текстовом редакторе заключите все значение в кавычки и запишите каждую кавычку внутри него как две кавычки (" становится ""), так же, как в примере выше.

Как импортировать

Выполните следующие шаги, чтобы загрузить ваш CSV-файл и зарегистрировать устройства в Pushwoosh.

1. Перейдите в Audience → Import CSV и выберите карточку Import push subscribers.

2. Выберите ваш CSV-файл.
3. Просмотрите сводку:
   • Общее количество строк в файле и количество строк, доступных для импорта, с разбивкой по платформам.
   • Пропущенные строки с разбивкой по причинам и ссылкой для загрузки пропущенных строк в виде CSV-файла (исходные столбцы плюс столбец skip_reason).
   • Кастомные теги, обнаруженные в столбце tags, с типом, который Pushwoosh определил для каждого из них (string, integer, boolean или date). Если тег с таким именем уже существует в вашем аккаунте с другим типом, он будет помечен как конфликт. Вы можете изменить тип или пропустить этот тег для данного импорта.

4. Когда все будет готово, нажмите Start import.

Когда импорт завершится, вы увидите, сколько устройств было импортировано, сколько строк не удалось обработать и сколько было пропущено на этапе предварительной проверки. Ссылка для загрузки есть только у количества строк, пропущенных на этапе предварительной проверки. При устранении неполадок рассматривайте импортированные и неудавшиеся строки как отдельные проблемы.

Почему строка пропускается

Это причины пропуска, которые отображаются в сводке сопоставления и в CSV-файле с пропущенными строками.

Причина	Описание
Web-подписки	Привязаны к ключам другого провайдера. Не могут быть перенесены
Недействительные токены	Уже отклонены APNs / FCM (флаг invalid_identifier в OneSignal)
Email-адреса	Вместо этого используйте Импорт email-контактов
Номера телефонов	Вместо этого используйте Импорт SMS-контактов
Дублирующиеся токены	Один и тот же push-токен встречается в файле более одного раза. Первая строка обрабатывается, а последующие пропускаются
Неподдерживаемая платформа	Платформа не поддерживается Pushwoosh (например, Windows Phone, Baidu)
Неизвестная платформа	Значение платформы не распознано
Пустой push-токен	В столбце push-токена нет значения

Повторный импорт того же файла

Pushwoosh генерирует Hardware ID (HWID) каждого импортированного устройства на основе его push-токена, и один и тот же токен всегда создает один и тот же HWID. Поэтому повторный импорт того же файла обновляет существующие устройства, а не создает дубликаты. Безопасно повторно запускать импорт после исправления проблемы с сопоставлением или для периодической повторной синхронизации значений тегов из нового экспорта.

После импорта

Импортированным устройствам присваивается тег CSV import со значением, равным дате и времени импорта. Этот же тег используется при Импорте сегмента. Используйте его для создания сегмента из импортированных устройств или для их поиска по отдельности в User Explorer.

Сегмент не создается автоматически.