Importar assinantes de push

Se você está migrando de outro provedor de push, pode importar sua base de assinantes de push existente para o Pushwoosh a partir de um arquivo CSV. Os tokens continuam funcionando desde que o aplicativo ainda use a mesma chave APNs, projeto Firebase ou credenciais HMS. Os usuários não precisam reinstalar o aplicativo ou conceder permissão novamente.

Esta importação registra dispositivos com tokens de push. Ela não cria um segmento. Os dispositivos importados recebem uma tag CSV import que você pode usar para criar um posteriormente. Para importar uma lista de User IDs ou Hardware IDs já registrados para um segmento, consulte Importar um segmento.

Plataformas suportadas

O Pushwoosh importa apenas tokens de push para as plataformas listadas abaixo. Qualquer outro valor em device_type é ignorado. Consulte Por que uma linha é ignorada.

A coluna device_type aceita dois formatos diferentes, dependendo da origem do seu arquivo:

• Um número, se sua exportação usar os códigos de plataforma próprios do OneSignal.
• Uma palavra, se for uma exportação do Amazon Pinpoint ou um arquivo que você criou manualmente.

Não misture os dois formatos em um único arquivo, pois o mesmo número significa uma plataforma diferente em cada sistema. Colar um número de uma fonte que não seja do OneSignal pode importar dispositivos silenciosamente para a plataforma errada.

Plataforma	Número device_type do OneSignal	Nomes de plataforma aceitos
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

Linhas com qualquer outro valor são ignoradas, incluindo:

• Os tipos de dispositivo de web push, e-mail e SMS próprios do OneSignal.
• Plataformas que o Pushwoosh não suporta, como o descontinuado Windows Phone ou Baidu push.

Assinaturas de web push não podem ser transferidas de nenhum provedor. Esses usuários precisam se inscrever novamente através do SDK do Pushwoosh em seu site.

Prepare um arquivo CSV

Seu CSV deve ter menos de 100 MB. Nomeie as colunas exatamente como mostrado abaixo. Maiúsculas e minúsculas não importam. Você não pode mapear colunas na interface do usuário, então renomeie quaisquer cabeçalhos que não correspondam:

Cabeçalho	Mapeia para
identifier	Token de push (obrigatório)
device_type	Plataforma (obrigatório)
external_id ou external_user_id	User ID
language	Idioma do dispositivo
tags	Um objeto JSON de valores de tags personalizadas
invalid_identifier	Sinalizador de “não inscrito” do OneSignal. Linhas sinalizadas aqui são ignoradas

Uma coluna de fuso horário, se presente, não é importada, pois seu formato difere entre as versões de exportação.

Exemplo de CSV

Aqui está um subscribers.csv com dois dispositivos, um usando um nome de plataforma e outro usando um código numérico do 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"}

Representação de subscribers.csv em formato de texto simples:

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""}"

Nota

O valor de tags é um objeto JSON e contém aspas. Ao criar este arquivo no Excel ou no Google Sheets, você não precisa fazer nada, pois esses aplicativos colocam a célula entre aspas para você automaticamente. Ao editar o arquivo diretamente em um editor de texto simples, envolva todo o valor em aspas e escreva cada aspa dentro dele como duas aspas (" se torna ""), da mesma forma que o exemplo acima faz.

Como importar

Siga estes passos para carregar seu CSV e registrar os dispositivos no Pushwoosh.

1. Vá para Audience → Import CSV e selecione o cartão Import push subscribers.

2. Selecione seu arquivo CSV.
3. Revise o resumo:
   • Total de linhas no arquivo e quantas são importáveis, detalhadas por plataforma.
   • Linhas ignoradas, detalhadas por motivo, com um link para baixar as linhas ignoradas como um CSV (colunas originais mais uma coluna skip_reason).
   • Tags personalizadas detectadas na coluna tags, com o tipo que o Pushwoosh inferiu para cada uma (string, integer, boolean ou date). Se um nome de tag já existir em sua conta com um tipo diferente, ele será sinalizado como um conflito. Você pode alterar o tipo ou ignorar essa tag para esta importação.

4. Clique em Start import quando estiver satisfeito.

Quando a importação terminar, você verá quantos dispositivos foram importados, quantas linhas falharam e quantas foram ignoradas na verificação prévia. Apenas a contagem de ignorados na verificação prévia tem um link para download. Trate importados e falhados como problemas separados ao solucionar problemas.

Por que uma linha é ignorada

Estes são os motivos de ignorar mostrados no resumo do Mapeamento e no CSV de linhas ignoradas.

Motivo	Causa
Assinaturas da web	Vinculadas às chaves de outro provedor. Não podem ser transferidas
Tokens inválidos	Já rejeitados por APNs / FCM (sinalizador invalid_identifier do OneSignal)
Endereços de e-mail	Use Importar contatos de e-mail em vez disso
Números de telefone	Use Importar contatos de SMS em vez disso
Tokens duplicados	O mesmo token de push aparece mais de uma vez no arquivo. A primeira linha prevalece e as linhas posteriores são ignoradas
Plataforma não suportada	A plataforma não é uma que o Pushwoosh suporta (por exemplo, Windows Phone, Baidu)
Plataforma desconhecida	O valor da plataforma não é reconhecido
Token de push vazio	Nenhum valor na coluna de token de push

Reimportando o mesmo arquivo

O Pushwoosh gera o Hardware ID (HWID) de cada dispositivo importado a partir de seu token de push, e o mesmo token sempre produz o mesmo HWID. Portanto, importar o mesmo arquivo novamente atualiza esses dispositivos existentes em vez de criar duplicatas. É seguro executar novamente uma importação após corrigir um problema de mapeamento ou para ressincronizar periodicamente os valores de tag de uma nova exportação.

Após a importação

Os dispositivos importados são marcados com a tag CSV import, com o valor da data e hora da importação. A mesma tag é usada pela Importação de Segmento. Use-a para criar um segmento a partir dos dispositivos importados ou encontrá-los individualmente no User Explorer.

Nenhum segmento é criado automaticamente.