Visão geral
A integração OneSignal + Segment permite que você:
- Envie características e eventos de usuários do Segment para o OneSignal para enriquecer perfis de usuários, potencializar segmentação e acionar mensagens.
- Envie eventos de entrega e engajamento de mensagens do OneSignal para o Segment para análises centralizadas e data warehousing.
Esta configuração bidirecional suporta todos os principais canais do OneSignal: Push, In-App, Email e SMS.
Requisitos
- Uma Conta OneSignal Growth, Professional ou Enterprise.
- Permissões de Administrador do Segment
- O SDK Móvel e/ou SDK Web do OneSignal do qual você deseja enviar dados. Integrações apenas de Email ou SMS não requerem o SDK.
- A Propriedade do OneSignal: ID Externo que mapeia para o
userId do Segment.com.
Configuração
Use um aplicativo existente ou crie um novo no dashboard do OneSignal. Em seguida, configure seus canais preferidos:
2. Conecte o Segment ao OneSignal
No Dashboard do OneSignal, navegue até Dados > Integrações e clique em Ativo no cartão Segment.com. Em seguida, continue com as opções de configuração.
Entrada de dados
“Entrada de Dados” para o OneSignal permite que você envie segmentos do OneSignal, tags e eventos personalizados da sua conta Segment.com para o OneSignal. Clique em Autenticar na seção Entrada de Dados da página de configurações do Segment.com no Dashboard do OneSignal.
Os eventos personalizados estão atualmente em beta.
Para solicitar acesso, entre em contato com [email protected] com:
- Nome da sua empresa
- Seu ID de Organização do OneSignal
- O(s) ID(s) de Aplicativo que você deseja habilitar
Uma vez habilitado para rastrear eventos personalizados, a integração Segment.com enviará tanto Data Tags quanto Eventos, então você não precisará atualizar nenhum template existente que referencie data tags.
Saída de dados
Habilitar “Saída de Dados” para o Segment.com sincroniza eventos de mensagens gerados de volta para sua conta Segment.com. Esses eventos de mensagens são gerados ao enviar mensagens para seus usuários na plataforma OneSignal. Mais detalhes sobre que tipo de eventos podem ser gerados e as propriedades com as quais são enviados podem ser encontrados abaixo.
Primeiro, você precisa adicionar o OneSignal como uma fonte da sua conta Segment.com. Você pode fazer isso navegando até a listagem de Fonte OneSignal no Catálogo de Conexões do Segment.
A partir daí, você pode adicionar seu token de API do Segment.com no Dashboard do OneSignal. Por favor, navegue até Dados > Integrações > Segment no Dashboard do OneSignal para adicionar a chave de API do Segment.
Após configurar a chave de API, certifique-se de verificar suas configurações de Política de Dados no Segment.com para determinar se você precisa enviar eventos para o Endpoint de Residência da UE do Segment.
Depois que todas essas configurações estiverem concluídas, você pode selecionar quais eventos deseja sincronizar com sua Conta Segment dependendo de quais canais você utiliza com o OneSignal.
3. Adicione o destino OneSignal no Segment
Em Segment.com Dashboard > Destinos você deve ver OneSignal. Caso contrário, adicione o OneSignal como um novo destino.
Habilite o Destino OneSignal, você também deve ver sua Chave de API e ID de Aplicativo do OneSignal já configurados.
Se a chave de API e o ID do Aplicativo não estiverem definidos, navegue até o dashboard do OneSignal, selecione o Aplicativo e vá para Configurações > Chaves e IDs. Copie e cole o “ID do Aplicativo” e a “chave de API” no Segment.com.
Múltiplas Fontes do Segment.com
Se você tiver múltiplas fontes, pode utilizar o recurso Personas > Spaces do Segment para vincular múltiplas fontes a um destino.
4. Envie dados do Segment para o OneSignal
O OneSignal armazena registros no nível do canal: Push/IAM, Email e SMS. Esses registros já devem estar criados no OneSignal e você também deve definir o alias de ID Externo no OneSignal para corresponder ao campo userID enviado pelo Segment.com.
Registros que não tenham um mapeamento ID de Usuário do Segment <—> ID Externo do OneSignal serão descartados.
Características ou propriedades do usuário
Você pode agregar dados em todos os pontos de contato com o cliente no Segment e, em seguida, enviar essas propriedades do usuário em tempo real para o OneSignal como Data Tags.
Nota: O OneSignal não pode aceitar objetos aninhados ou arrays como propriedades de usuário.
Identify - Características ou propriedades de usuário enviadas usando a chamada Identify do Segment são armazenadas como data tags no OneSignal. Por exemplo:
Track - Para eventos e propriedades associadas enviadas usando a chamada Track do Segment, o OneSignal armazenará todas as propriedades do evento como data tags, mas descartará o nome do evento ao armazenar as tags. Se você quiser manter os nomes dos eventos nas data tags, pode anexar o nome do evento às propriedades antes de enviá-las ao OneSignal. Por exemplo:
let timestampInSeconds = Int(NSDate().timeIntervalSince1970).toString()//convert to string since Segment adds decimals to end
//name will be dropped and only properties will be sent to OneSignal as tag "last opened: timestampInSeconds"
analytics.track(
name: "iOS App Last Opened",
properties: ["last opened": timestampInSeconds]
)
Audiência Personas e Características Computadas
Audiências Persona aparecem automaticamente como um segmento no OneSignal.
Características computadas são atualizadas como Data Tags nos registros de usuário do OneSignal.
Audiência
Audiências enviadas usando a chamada Track do Segment criarão um segmento do OneSignal com o Nome da Audiência.
Audiências enviadas usando a chamada Identify do Segment irão
- criar um segmento do OneSignal com o Nome da Audiência
- adicionar data tags (se houver propriedades adicionais na chamada Identify) em todos os registros de usuário correspondentes.
As chamadas Identify e Track são enviadas automaticamente para o OneSignal sempre que um usuário entra ou sai da Audiência.
Características Computadas As Características Computadas de Personas são armazenadas como Data Tags nos registros de usuário do OneSignal, seja passadas ao OneSignal como uma chamada Identify ou uma chamada Track. Você pode então usar essas data tags para criar manualmente segmentos do OneSignal e automatizar seus fluxos de trabalho de mensagens.
Eventos de Mensagem
Tipos de Eventos
Estes são os tipos de eventos de mensagem que o OneSignal envia para o Segment
| Tipo de MessageEvent | Descrição do Evento |
|---|
| Push Sent | Notificação push enviada com sucesso |
| Push Received | Notificação push recebida com sucesso |
| Push Clicked | Notificação push tocada no dispositivo |
| In-App Message Displayed | Mensagem In-App exibida com sucesso no dispositivo |
| In-App Message Clicked | Mensagem In-App clicada no dispositivo |
| In-App Message Page Displayed | Página de Mensagem In-App é exibida |
| Email Sent | Email enviado com sucesso |
| Email Opened | Email aberto pelo destinatário |
| Email Unsubscribed | Destinatário cancelou inscrição do email |
| Email Received | Email recebido pelo destinatário |
| Email Reported As Spam | Email relatado como spam pelo destinatário |
| Email Bounced | Email retornado ao remetente devido a erro permanente |
| Email Failed | Não foi possível entregar o email na caixa de entrada |
| SMS Sent | SMS enviado ao destinatário |
| SMS Delivered | SMS entregue com sucesso |
| SMS Failed | Falha ao enviar SMS |
Propriedades de Eventos
Estas são as propriedades presentes nos eventos enviados do OneSignal para o Segment.com
| NOME DA PROPRIEDADE | DESCRIÇÃO |
|---|
userId | O external_id associado à mensagem |
anonymousId | O subscription_id |
messageId | O identificador da mensagem discreta |
campaign_id | O mesmo valor que messageId |
message_name | O nome da mensagem |
message_title | O título da mensagem |
message_contents | O conteúdo da mensagem |
| |
subscription_type | O canal através do qual a mensagem foi enviada |
template_id | O template de mensagem usado |
subscription_id. | O identificador de dispositivo/email/sms do OneSignal |
device_type | O tipo de dispositivo que recebeu a mensagem |
language | O código de idioma de dois caracteres do dispositivo |
message_type | O tipo de mensagem enviada: push, in-app, email, SMS |
Perguntas frequentes
Como podemos passar eventos de Assinatura?
Os eventos de assinatura não estão sendo enviados automaticamente no momento. Isso pode ser feito com os Métodos do Observador de Assinatura do SDK do OneSignal. Consulte Rastreamento de Assinatura para mais detalhes.
Gerenciando Propriedades de Usuário Reservadas e Personalizadas do Segment no OneSignal
- Todas as características de usuário do Segment são enviadas ao OneSignal como data tags. O número de data tags permitidas no OneSignal depende do seu plano de preços do OneSignal. Tags acima do número permitido serão descartadas.
- O OneSignal sempre atualiza as propriedades firstName e lastName para usuários correspondentes. Todas as outras características são adicionadas/atualizadas por ordem de chegada. As tags firstName e lastName são armazenadas como “first_name” e “last_name”.
- Propriedades de usuário enviadas ao OneSignal com valores em branco/nulos são removidas do registro de usuário do OneSignal. Isso é feito para garantir que você esteja dentro dos seus limites de data tag.
