SDK do React Native - Suporte a notificações push

Seguir
Avatar
Ghani Yusuf
Updated
Documento

Suporte ao rastreamento de reengajamento usando notificações push

O Singular suporta o rastreamento de notificações push para melhorar a medição do reengajamento. Ao integrar o Firebase Cloud Messaging (FCM) com o SDK do Singular, é possível rastrear os usuários que interagem com as notificações push e atribuí-los adequadamente.

Para garantir um rastreamento preciso, siga as diretrizes de implementação abaixo e certifique-se de que os dados de notificação sejam passados corretamente para o Singular SDK.

Por que o rastreamento de notificações push é importante?

As notificações push são uma ferramenta chave de re-engajamento, mas rastreá-las requer uma integração correta. O Singular garante que os usuários que interagem com as notificações sejam devidamente atribuídos, ajudando a otimizar campanhas de marketing e estratégias de engajamento.

Guia de Implementação

Integrar o SDK do Singular

Integre o Singular SDK em seu projeto React Native usando as instruções oficiais fornecidas na documentação do Singular.

Configurar notificações push

  • Configure as notificações push usando o Firebase Cloud Messaging

  • Certifique-se de que os seguintes plug-ins do React Native sejam adicionados:

    bash
    npm install @react-native-firebase/app
npm install @react-native-firebase/messaging

iOS

  • Registre seu aplicativo iOS no Firebase.
  • Adicione GoogleService-Info.plist ao seu projeto Xcode.
  • Ative as notificações por push e os modos em segundo plano (notificações remotas).

Android

  • Registe a sua aplicação Android no Firebase.
  • Adicione google-services.json ao seu projeto em android/app/.
  • Certifique-se de que as dependências de mensagens do Firebase sejam adicionadas e as permissões sejam concedidas.

Manipulação de notificações push com Singular SDK

iOS

Aplicação em segundo plano ou em primeiro plano

Chame o método abaixo onde a notificação é tratada:

javascript
Singular.handlePushNotification(notificationPayloadData);

App em estado terminado

Em AppDelegate.m, adicione a seguinte linha dentro de didFinishLaunchingWithOptions:

AppDelegate.m
[SingularBridge startSessionWithLaunchOptions:launchOptions];

Android

Aplicação em segundo plano ou em primeiro plano

Na sua atividade principal (por exemplo, MainActivity.java), substitua onNewIntent:

MainActivity.java
@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    SingularBridgeModule.onNewIntent(intent);
}

App in Terminated State (Aplicação em estado terminado)

Não é necessária nenhuma ação. A camada de ponte do React Native lida com esse cenário automaticamente.

Configurar caminhos de link de envio

Configure o SDK Singular para reconhecer caminhos específicos em suas cargas de notificação para atribuição de reengajamento. Atualize o objeto SingularConfig com as opções withPushNotificationsLinkPaths.

App.tsx
config.withPushNotificationsLinkPaths([
  ["path", "to", "url"]]);

Guia de validação

Etapa 4: validação/verificação do recebimento da notificação por push na chamada de sessão inicial

A chamada da API do Singular SDK garante que o link do payload da notificação por push seja passado corretamente sob o parâmetro reservado singular_link na chamada da sessão inicial.

Exemplo:

bash
https://sdk-api-v1.singular.net/api/v1/start?a=<SDK-Key>&ab=arm64-v8a&aifa=180f63a1-0955-47b4-896a-d75ae3d35955&apc=Marchv7&apg=1&aps=Intex&asid_scope=1&asid_timeinterval=0.112&av=20.0&br=samsung&c=wifi&current_device_time=1740905574088&de=m15x&device_type=phone&device_user_agent=Dalvik/2.1.0 (Linux; U; Android 14; SM-E156B Build/UP1A.231005.007)&dnt=0&event_index=3&fi=e5bRZuVddO8:APA91bHXI3OmFZv3-r8f03zyji2kvKWbIngwf8KBDHk4Rj5q5MEeEm6EtzC-if1vpJRmuYLyGdAcSz9-nc49eIjD86xwj-n9J4jKucqMVt9mP8ICifP0arA&i=net.singular.singularsampleapp&install_time=1740905507036&is=false&k=SDID&lag=0.067&lc=en_IN&ma=samsung&mo=SM-E156B&n=Singular-TestApp-Debug&p=Android&pr=m15xnndins&pu=1&rt=json&s=1740905574084&sdk=Singular/v12.6.2&singular_install_id=2dc5dfc2-a2a8-484a-aad1-fed6cb7a3023&singular_link=https://singularassist2.sng.link/C4nw9/r1m0?_dl=singular://test&_smtype=3&src=com.android.shell&u=75f7b911-5a77-597d-8892-56f5e0e210ff&update_time=1740905507036&v=14&h=1e723fd90344d5d037059f110611ed1d84fbba88


Como alternativa, você pode usar o Console do SDK Singular para verificar o link de rastreamento da notificação por push no URL do Deeplink, conforme demonstrado abaixo.

Ao verificar isso, você pode confirmar que os compromissos de notificação por push são rastreados corretamente no Singular SDK.

Observações:

  • Observe que, ao contrário do código singularLinksHandler, o Singular SDK não fornece retornos de chamada de carga de push para esse recurso. É responsabilidade do desenvolvedor do aplicativo ler os dados da notificação push e implementar a lógica de deep linking para redirecionar os usuários para páginas de produtos específicos dentro do aplicativo. Nesta solução, o Singular recupera o payload da notificação push quando o usuário toca na notificação e inclui esse payload no evento de início de sessão do SDK disparado por Singular.start(config). Esses dados são então processados no backend do Singular para atribuir o ponto de toque/clique da notificação push e registrá-lo para rastreamento de reengajamento.

  • Temos um mecanismo de segurança que permite apenas domínios de link Singular do par de valores-chave personalizado passado na carga útil da notificação push. Especificamente, apenas os domínios sng.link predefinidos na página Singular Manage Links são permitidos.

    Por exemplo:
    https://prod_test.sng.link/B0s2a/51oi?_dl=singular%3A%2F%2Fmain

    Se pretender envolver links Singular num domínio diferente (por exemplo, um domínio ESP para fornecedores de serviços de e-mail), deve configurar explicitamente o domínio adicionando a seguinte opção na sua configuração: Isso garante que o domínio externo seja reconhecido e permitido na estrutura do Singular. Consulte o exemplo de configuração abaixo. config.withESPDomains(Arrays.asList("sl.esp.link"));

  • Se você precisar acionar diferentes deep links com base nas ações do usuário a partir de uma única notificação por push, poderá usar um único link de rastreamento Singular e modificar dinamicamente os redirecionamentos.

    Exemplo:

    Uma notificação push para notícias de última hora pode oferecer várias opções de deep link! Em vez de criar vários links de rastreamento, configure um link de rastreamento Singular e ajuste os redirecionamentos dinamicamente com base na seleção do usuário.

    Ler as últimas notícias →
    newsapp://article?id=12345
    Tópicos em destaque →
    newsapp://trending
    Desporto →
    newsapp://sports


    Saiba mais sobre a substituição de redireccionamentos em ligações de seguimento Singular.

Sucesso!

Seguindo essas etapas, seu aplicativo agora está configurado para rastrear interações de notificação por push usando o Singular. Isso ajuda a melhorar os insights de desempenho da campanha e garante uma atribuição precisa de reengajamento.