Configuração do OneSignal
O OneSignal é um parceiro de analytics integrado à Adjust. Nossa integração permite que o OneSignal receba dados mensurados na Adjust por meio de callbacks automáticos. Use esses dados com as ferramentas de parceiros para analytics e insights.
Neste artigo, saiba como configurar a mensuração com o OneSignal para seu aplicativo. Isso inclui a ativação da integração e a escolha dos dados que a Adjust pode compartilhar com o OneSignal.
Antes de começar
Requisitos
- Permissões de Administrador, Editor ou Editor personalizado na Adjust.
- SDK versão 4.0.0 da Adjust e posteriormente para mapear os parâmetros do SDK aos parâmetros de OneSignal. Siga os guias abaixo para usar essa funcionalidade.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Credenciais
OneSignal App ID
- Para obter ajuda para encontrar suas credenciais, entre em contato com seu representante do OneSignal.
Selecione OneSignal e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > OneSignal. Selecione Próximo para ir para a próxima tela.
- Na tela Seleção de aplicativos, escolha o aplicativo para o qual deseja criar o link e habilite a integração para compartilhar dados com o OneSignal.
- Selecione Próximo.
Habilitar o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o OneSignal. Para fazer isso:
- Insira seus OneSignal App ID.
Depois que você habilitar o compartilhamento de dados com o OneSignal, a Adjust enviará automaticamente os seguintes dados ao OneSignal, por padrão:
- instalação
- sessão
Configurar suas opções de compartilhamento de dados
Se estiver trabalhando com um aplicativo multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:
- Separar opções de compartilhamento de dados no nível de plataforma selecionando Usar as configurações específicas da plataforma.
- Definir as mesmas configurações de compartilhamento de dados para múltiplas plataformas selecionando Usar as configurações globais.
Agora, em O que será compartilhado por padrão?, revise as atividades que o Adjust compartilha com o OneSignal por padrão:
- instalação
- sessão
Enviar dados adicionais
Escolha a quantidade e o tipo de dados que deseja compartilhar com o OneSignal por meio de retornos de chamada. O OneSignal pode usar essas informações para otimizar o desempenho.
Para enviar dados adicionais, você pode revisar e personalizar o seguinte:
Sessões
A Adjust não envia automaticamente callbacks de sessão devido ao alto volume de sessões. Ao compartilhar sessões, o OneSignal receberá a atividade das sessões do seu aplicativo.
Receita in-app (a partir de compras in-app)
O compartilhamento de receita in-app permite que o OneSignal receba valores de receita junto com seus dados de eventos com receita. Você precisa mapear eventos que geram receita para compartilhar esses dados.
Mapear eventos
Mapeie os eventos que você deseja compartilhar com os valores que o OneSignal pode receber. Os dados de eventos não mapeados não são compartilhados com o OneSignal.
Mapear eventos individuais
Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o OneSignal. Isso possibilita:
- Definir eventos individuais para gerenciar estratégias de campanha para cada plataforma.
- Personalizar o compartilhamento de dados por plataforma.
Em Mapear eventos, siga estes passos para escolher os eventos in-app que você quer enviar diretamente à OneSignal.
Selecione Mapear evento.
Na lista Evento da Adjust, escolha o evento da Adjust que quer compartilhar com OneSignal.
Em Evento do parceiro, selecione o evento do OneSignal que corresponde ao evento da Adjust.
Para aplicativos de plataforma única e aplicativos multiplataforma com compartilhamento de dados habilitado apenas para uma única plataforma, mapeie eventos apenas para essa plataforma. Para aplicativos multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:
- Selecionar Usar mapeamento específico da plataforma para mapear eventos separados no nível da plataforma ou para não mapear eventos para determinadas plataformas.
- Selecionar Usar mapeamento global para mapear os mesmos eventos para todas as plataformas.
Na lista Evento do parceiro, escolha ou insira um nome de evento personalizado que você deseja mapear ao evento da Adjust.
Selecione Aplicar.
Agora o OneSignal receberá dados de eventos in-app para todos os seus eventos vinculados.
Mapear todos os eventos
Se o OneSignal oferecer suporte para o mapeamento automático de todos os eventos, em Mapear eventos, selecione Mapear todos os eventos. Isso economiza tempo no mapeamento de eventos individuais.
Agora o OneSignal receberá dados de eventos in-app de todos os seus eventos vinculados.
Habilitar o OneSignal para seu aplicativo
Na tela Revisão da configuração, revise suas escolhas. Você também pode retornar e fazer alterações em:
- Seu app selecionado
- Opções de compartilhamento de dados
Selecione Habilitar parceiro para habilitar o OneSignal para seu aplicativo. Os parceiros de análise não trabalham com links para campanhas. Uma vez ativada, nossa integração envia dados de atribuição e de eventos no aplicativo por meio de callbacks automatizados.
Instruções de configuração de parceiros específicos
É necessário implementar Push Tokens em seu SDK da Adjust para que as requisições seja rastreadas com sucesso no painel do OneSignal.
Para informações adicionais, verifique os guias de SDK da Adjust: Android, iOS
Lista de todos os parâmetros encaminhados a OneSignal
O OneSignal solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:
| Placeholder | Informação |
{adid} | ID de dispositivo da Adjust (todas as plataformas) |
{country} | Código do país do dispositivo de dois caracteres |
{currency} | O código da moeda ISO 4217 original enviado pelo SDK da Adjust |
{event_name} | Nome do evento, conforme definido no painel |
{idfa||gps_adid} | IDFA ou GPS ADID se o IDFA estiver vazio |
{ip_address} | Endereço IP do dispositivo |
{language} | Código do idioma do dispositivo de dois caracteres |
{last_time_spent} | Duração da última sessão do usuário, em segundos |
{os_version} | Número da versão do sistema operacional |
{push_token} | Token de notificação push, isto é, token de registro (Android), token do dispositivo (iOS) |
{revenue_float} | Receita conforme enviada do SDK da Adjust, em unidades de moedas inteiras |
{session_count} | Número de sessões registradas pelo atual SDK da Adjust |
{app_version} | Número da versão do aplicativo (Android), número da versão para bundle (iOS) |
{campaign_name} | Nome da campanha, conforme retirado do tracker |
{created_at} | Marca temporal da atividade |
{installed_at} | Marca temporal da instalação (isto é, primeira abertura do aplicativo) |
{last_session_time} | Marca temporal da última sessão |
{network_name} | Nome da rede, conforme retirado do tracker |