Обновление тегов через CSV

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

Обновлять можно только теги, которые уже существуют в вашем аккаунте. Импорт не создает новые теги.

Видео Youtube: Присваивайте теги устройствам ваших подписчиков вручную, загружая CSV-файл

1. Подготовьте CSV

Экспортируйте сегмент и отредактируйте его или создайте файл самостоятельно.

Экспорт сегмента

Перейдите в Сегменты, выберите сегмент, для которого вы хотите установить теги, и экспортируйте сегмент. Файл содержит:

• HWID устройств, соответствующих этому сегменту фильтра (в первом столбце .csv)
• Push-токены устройств пользователя (во втором столбце)
• типы устройств (целочисленные и в понятном для человека формате)
• все теги из вашего аккаунта Pushwoosh (в остальных столбцах)

Измените значения тегов или добавьте недостающие в файле, затем сохраните его.

Создание CSV

Чтобы создать файл самостоятельно, подготовьте следующие столбцы:

• Столбец идентификатора: назовите его HWID и заполните аппаратными идентификаторами (hardware ID) устройств или назовите его User ID и заполните идентификаторами пользователей.
• Столбцы тегов: назовите каждый из них в точности как тег в вашем аккаунте Pushwoosh. Каждая ячейка содержит значение, которое нужно задать для этого устройства или пользователя.

HWID	Name	Age	Push Alerts Enabled	SDK Version	First Install	Preferences
XXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX	Paul	25	false	6.4.12.0	2023-06-27 12:00:00	sport, news
YYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY	Anne	30	true	6.7.17.0	2025-11-14 16:00:00	fashion, travel

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

HWID,Name,Age,Push Alerts Enabled,SDK Version,First Install,Preferences
XXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,Paul,25,false,6.4.12.0,2023-06-27 12:00:00,"sport, news"
YYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY,Anne,30,true,6.7.17.0,2025-11-14 16:00:00,"fashion, travel"

Значения тегов типа List

Ячейка тега типа List принимает два формата:

• Список через запятую: sport, news, как в примере выше. Такой формат проще создавать в табличных приложениях. Значения всегда разделяются по запятой.
• Массив JSON: ["sport","news"]. Используйте его, если одно значение содержит запятую, например ["Sports, general","news"].

Если оставить ячейку тега типа List пустой, существующее значение этого тега у подписчика останется без изменений. Чтобы очистить значение тега типа List у подписчика, используйте вместо этого пустой массив JSON ([]). Для тегов других типов (String, Integer, Date) пустая ячейка импортируется как есть и перезаписывает существующее значение у подписчика.

2. Загрузите CSV

Осторожно

Перед загрузкой убедитесь, что:

1. Файл сохранен в кодировке UTF-8.
2. Значения разделены запятой.
3. В каждой строке столько же столбцов, сколько в заголовке, и каждое значение в кавычках закрыто.

Из-за одной некорректной строки отклоняется весь файл, а не только эта строка.

1. Выберите проект. Значения тегов обновляются только в этом проекте. Если идентификатор не зарегистрирован в этом проекте, его строка не получит значения тегов.

2. Перейдите в Import CSV → Update Tag values.

   

3. Нажмите Upload CSV и выберите файл.

   

Примечание

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

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

3. Выберите теги для обновления

1. Выберите тип идентификатора, который используется в вашем CSV-файле, — HWID или User ID, — и столбец, который его содержит. От типа зависит, какие теги можно обновить:

   • HWID: теги, специфичные для устройства, например SDK Version.
   • User ID: теги, специфичные для пользователя, чьи значения относятся к профилю пользователя, а не к устройству.

   Pushwoosh показывает, какие теги будут импортированы, а какие пропущены для выбранного вами типа.

2. Выберите столбцы для импорта.

3. Нажмите Start import.

4. Проверьте результаты

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

Когда импорт завершится, отчет подтвердит, что значения тегов из выбранных столбцов обновлены. Проверьте счетчики в отчете:

• Matched: строки CSV, а не устройства, по идентификатору которых найдено хотя бы одно устройство.
• Updated: устройства, а не строки. При импорте по User ID одна строка может соответствовать нескольким устройствам пользователя, поэтому это число может быть больше, чем Matched.
• Updated users: только при импорте по User ID — количество уникальных пользователей, у которых обновлено хотя бы одно устройство. Две строки одного и того же пользователя считаются за одну.

Примечание

Файл размером более 100 000 строк Pushwoosh обрабатывает пакетами и может засчитать одного и того же пользователя как обновленного в нескольких пакетах, если строки этого пользователя оказались по обе стороны границы пакета. В этом случае значение Updated users может быть немного больше реального количества уникальных пользователей.

Строка пропускается по одной из двух причин:

• Ни одно устройство не соответствует идентификатору. Pushwoosh сверяет его с HWID, User ID или push-токеном независимо от того, какой тип идентификатора вы выбрали на шаге 3.
• Столбец идентификатора пуст. Такая строка не доходит до сопоставления с устройствами.

Сумма сопоставленных и пропущенных строк должна совпадать с общим количеством строк в файле.

Осторожно

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