导入推送订阅者

如果您正在从其他推送提供商迁移，您可以将现有的推送订阅者基础从 CSV 文件导入到 Pushwoosh。只要应用程序仍使用相同的 APNs 密钥、Firebase 项目或 HMS 凭据，令牌就会继续工作。用户无需重新安装应用程序或再次授予权限。

此导入操作会注册带有推送令牌的设备。它不会创建细分。导入的设备会获得一个 CSV import 标签，您之后可以用它来构建一个细分。要将已注册的 User ID 或 Hardware ID 列表导入到细分中，请参阅导入细分。

支持的平台

Pushwoosh 仅导入下面列出的平台的推送令牌。device_type 中的任何其他值都将被跳过。请参阅为什么某一行会被跳过。

device_type 列接受两种不同的格式，具体取决于您的文件来源：

一个数字，如果您的导出文件使用 OneSignal 自己的平台代码。
一个单词，如果是 Amazon Pinpoint 导出的文件或您手动创建的文件。

不要在同一个文件中混合使用这两种格式，因为相同的数字在每个系统中代表不同的平台。从非 OneSignal 源粘贴数字可能会在错误的平台下静默导入设备。

平台	OneSignal `device_type` 编号	可接受的平台名称
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 自己的网页推送、电子邮件和短信设备类型。
Pushwoosh 不支持的平台，例如已停用的 Windows Phone 或百度推送。

网页推送订阅无法从任何提供商转移。这些用户需要通过您网站上的 Pushwoosh SDK 重新订阅。

准备 CSV 文件

您的 CSV 文件必须小于 100 MB。请完全按照下文所示命名列。字母大小写不敏感。您无法在 UI 中映射列，因此请重命名任何不匹配的表头：

表头	映射到
`identifier`	推送令牌（必需）
`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""}"

如何导入

请按照以下步骤上传您的 CSV 文件并在 Pushwoosh 中注册设备。

前往 Audience → Import CSV 并选择 Import push subscribers 卡片。

选择您的 CSV 文件。
查看摘要：
- 文件中的总行数，以及可导入的行数（按平台细分）。
- 跳过的行数（按原因细分），并提供一个链接以下载跳过的行（作为 CSV 文件，包含原始列和 skip_reason 列）。
- 在 tags 列中检测到的自定义标签，以及 Pushwoosh 为每个标签推断的类型（string、integer、boolean 或 date）。如果您的账户中已存在同名但类型不同的标签，它将被标记为冲突。您可以更改类型或在此次导入中跳过该标签。

确认无误后，点击 Start import。

导入完成后，您将看到导入了多少设备、失败了多少行以及在预检中跳过了多少行。只有预检中跳过的计数有下载链接。在进行故障排除时，请将导入和失败视为不同的问题。

为什么某一行会被跳过

以下是“映射”摘要和跳过行 CSV 文件中显示的跳过原因。

原因	起因
网页订阅	绑定到其他提供商的密钥。无法转移
无效令牌	已被 APNs / FCM 拒绝（OneSignal 的 `invalid_identifier` 标志）
电子邮件地址	请改用导入电子邮件联系人
电话号码	请改用导入短信联系人
重复令牌	同一个推送令牌在文件中出现多次。第一行生效，后续行将被跳过
不支持的平台	平台不是 Pushwoosh 支持的平台（例如 Windows Phone、百度）
未知平台	平台值完全无法识别
推送令牌为空	推送令牌列中没有值

重新导入相同文件

Pushwoosh 根据每个导入设备的推送令牌生成其 Hardware ID (HWID)，并且相同的令牌总是会生成相同的 HWID。因此，再次导入相同的文件会更新这些现有设备，而不会创建重复项。在修复映射问题后重新运行导入，或定期从新的导出文件中重新同步标签值是安全的。

导入之后

导入的设备会带有 CSV import 标签，其值为导入的日期和时间。该标签也用于细分导入。您可以用它从导入的设备构建一个细分，或在用户浏览器中单独查找它们。

不会自动创建细分。