Medição de campanhas de notificações push

Rastreie e meça o desempenho da campanha de notificação por push no iOS e Android para atribuir eventos de reengajamento a campanhas push específicas e otimizar as estratégias de retenção de usuários.

O Singular fornece rastreamento contínuo para campanhas de notificação push no Firebase Cloud Messaging (FCM), Apple Push Notification Service (APNs) e plataformas de terceiros, incluindo CleverTap, MoEngage, WebEngage, OneSignal, Salesforce Marketing Cloud e Braze.

Como funciona o rastreamento de notificações push

O Singular rastreia campanhas de notificação push incorporando links de rastreamento em payloads de notificação e atribuindo aberturas de aplicativos à campanha de origem.

Fluxo de rastreamento

1. Criar campanha: Crie uma notificação push com um link de rastreamento Singular incorporado como dados personalizados de chave/valor
2. O usuário recebe a notificação: O provedor de push entrega a notificação ao dispositivo do usuário
3. O utilizador toca na notificação: O utilizador abre a aplicação tocando na notificação
4. SDK processa a carga útil: O SDK da Singular extrai dados de rastreamento do payload da notificação
5. Atribuição registada: A Singular atribui a abertura da aplicação como um evento de reengajamento para a campanha push

Provedores de notificação por push suportados

A Singular suporta o rastreamento de notificações push em todos os principais provedores de push e plataformas de automação de marketing.

Matriz de suporte da plataforma

Pré-requisitos

Verifique se seu aplicativo atende a esses requisitos antes de implementar o rastreamento de notificações por push.

Configuração necessária

Integração do SDK Singular

Instale e configure o SDK do Singular com o suporte a notificações push ativado.

• SDK do Android: Faça a integração seguindo o Guia de integração do SDK do Android
• SDK para iOS: Integre seguindo o Guia de integração do SDK do iOS
• Suporte a push: Habilitar o suporte a notificações push durante a inicialização do SDK

Infraestrutura de notificação por push

Configure a entrega de notificações push em seu aplicativo e sistemas de back-end.

• Android: Firebase Cloud Messaging configurado com uma chave de servidor válida
• iOS: Certificados ou tokens APNs configurados na conta de desenvolvedor da Apple
• Registo do dispositivo: A aplicação regista-se com sucesso para notificações push e armazena tokens
• Teste de entrega: Verificar se as notificações push chegam aos dispositivos com êxito

Conta do fornecedor de push

Defina e configure o seu fornecedor de serviços de notificações push.

• Conta do fornecedor: Conta ativa com FCM, APNs ou plataforma de terceiros
• Suporte a dados personalizados: Verifique se o provedor oferece suporte a pares de chave/valor personalizados em cargas úteis
• Acesso à API: Credenciais configuradas para enviar notificações de forma programática

Etapas de implementação

Siga estas etapas para implementar o rastreamento de campanhas de notificação por push com o Singular.

Etapa 1: criar link de rastreamento Singular

Gerar link de reengajamento

Crie um link singular configurado especificamente para o rastreamento de reengajamento de campanhas de notificação por push.

1. Navegue até Links singulares: Acesse a seção Links do Singular no seu painel do Singular
2. Criar novo link: Clique em "Criar novo link" e selecione seu aplicativo
3. Habilitar reengajamento: Alterne a definição "Re-engagement" (Reengajamento) para ON (essencial para o rastreamento push)
4. Configurar parâmetros: Adicione parâmetros de campanha para atribuição (fonte, meio, nome da campanha)
5. Gerar link: Guardar e gerar formatos de URL curtos e longos

Guia completo: Criar links de rastreamento singulares

Exemplo de configuração de link:

Ativação de reengajamento:

Link gerado:

Etapa 2: Adicionar link à carga útil da notificação push

Configurar dados personalizados

Incorpore o link de rastreamento Singular na seção de dados personalizados da sua notificação por push usando o nome de chave padrão.

Requisitos de configuração:

• Nome da chave: Use sng_link como a chave de dados personalizados (diferencia maiúsculas de minúsculas)
• Valor: Colar o link de rastreamento Singular completo (formato curto ou longo)
• Tipo de dados: Valor de cadeia de caracteres na carga útil de dados personalizados

Exemplo de mensagens do Firebase Cloud

Adicionar dados personalizados às notificações FCM através do Firebase Console ou API.

Configuração do Console do Firebase:

{
  "notification": {
    "title": "Special Offer Inside!",
    "body": "Open now to claim your reward"
  },
  "data": {
    "sng_link": "https://your-app.sng.link/Abc12/xyz9?pcn=push_campaign"
  },
  "to": "device_registration_token_here"
}

Exemplo de serviço de notificação por push da Apple

Incluir dados personalizados na carga útil de APNs usando o formato de dicionário aps padrão.

Estrutura da carga útil das APNs:

{
  "aps": {
    "alert": {
      "title": "Special Offer Inside!",
      "body": "Open now to claim your reward"
    },
    "sound": "default",
    "badge": 1
  },
  "sng_link": "https://your-app.sng.link/Abc12/xyz9?pcn=push_campaign"
}

Etapa 3: Configurar o SDK para processar a chave personalizada

Configuração do SDK do Android

Configure o Singular SDK do Android para extrair e processar a chave de dados personalizada sng_link das notificações FCM.

// In your FirebaseMessagingService
override fun onMessageReceived(remoteMessage: RemoteMessage) {
    super.onMessageReceived(remoteMessage)
    
    // Extract custom data from notification
    val data = remoteMessage.data
    
    // Check for Singular tracking link
    if (data.containsKey("sng_link")) {
        val singularLink = data["sng_link"]
        
        // Pass to Singular SDK for attribution
        Singular.setGCMData(data)
    }
    
    // Display notification to user
    showNotification(remoteMessage)
}

Guia de integração completo: Suporte para notificações push do Android

Configuração do SDK do iOS

Configure o Singular SDK do iOS para extrair e processar a chave de dados personalizada sng_link das notificações de APNs.

// In your AppDelegate
func application(_ application: UIApplication, 
                 didReceiveRemoteNotification userInfo: [AnyHashable : Any],
                 fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    
    // Check for Singular tracking link
    if let singularLink = userInfo["sng_link"] as? String {
        // Pass to Singular SDK for attribution
        Singular.setAPNSData(userInfo)
    }
    
    completionHandler(.newData)
}

// For iOS 10+ UNUserNotificationCenter
func userNotificationCenter(_ center: UNUserNotificationCenter,
                           didReceive response: UNNotificationResponse,
                           withCompletionHandler completionHandler: @escaping () -> Void) {
    
    let userInfo = response.notification.request.content.userInfo
    
    // Check for Singular tracking link
    if let singularLink = userInfo["sng_link"] as? String {
        // Pass to Singular SDK for attribution
        Singular.setAPNSData(userInfo)
    }
    
    completionHandler()
}

Guia de integração completo: Suporte para notificações push do iOS

Passo 4: Testar e validar

Procedimento de teste

Verifique se o rastreamento de notificações por push funciona corretamente antes de lançar campanhas.

1. Enviar notificação de teste: Acione uma notificação push de teste com o link Singular em dados personalizados
2. Receber no dispositivo: Confirmar se a notificação aparece no dispositivo de teste
3. Tocar na notificação: Abrir a aplicação tocando na notificação
4. Verificar registos SDK: Verificar se os logs do SDK mostram a extração do link Singular
5. Validar o painel de controlo: Confirmar se o evento de reengajamento aparece no painel do Singular dentro de 5 minutos

Validação específica da plataforma:

• iOS: Guia de validação do iOS
• Android: Guia de validação para Android

Etapa 5: Monitorar o desempenho da campanha

Analisar resultados de notificações push

Acompanhe o desempenho do reengajamento e o ROI das campanhas de notificação push nos relatórios analíticos do Singular.

Métricas disponíveis:

• Eventos de reengajamento: Total de aberturas de aplicativos atribuídas a notificações push
• Taxa de reengajamento: Percentagem de utilizadores que abriram a aplicação a partir de push
• Atribuição de receita: Receita gerada por utilizadores reengajados
• Comparação de campanhas: Desempenho em diferentes campanhas push
• Análise de coorte: Comportamento do utilizador após o reengajamento

Exemplo de painel:

Aceder aos relatórios através de: Análises → Relatórios de análises agregadas → Filtrar por fonte de reengajamento

Métodos de integração alternativos

Alguns provedores de push suportam a integração direta do link de rastreamento sem exigir a configuração de dados personalizados no SDK.

Integração direta de CTA

Certas plataformas permitem que os links de rastreamento Singular sejam configurados diretamente nos campos de CTA de notificação, iniciando automaticamente o aplicativo com dados de atribuição.

URL de lançamento do OneSignal

O OneSignal suporta links de rastreamento direto por meio do recurso Launch URL.

• Configuração: Adicionar link Singular ao campo Launch URL no compositor de notificações
• Comportamento: Tocar na notificação abre a aplicação com o link Singular processado automaticamente
• Requisito do SDK: Integração mínima padrão do SDK do Singular é suficiente

Documentação: URL de lançamento do OneSignal

OpenDirect do Salesforce Marketing Cloud

O SFMC fornece a funcionalidade OpenDirect para lançar aplicativos com links de rastreamento.

• Configuração: Definir o link do Singular como URL do OpenDirect na configuração da mensagem
• Comportamento: O toque de notificação aciona o lançamento do aplicativo via protocolo OpenDirect
• Suporte de plataforma: Disponível para iOS e Android

Documentação: SFMC OpenDirect

Comportamento do Braze ao clicar

O Braze permite que links de rastreamento Singular sejam configurados nas definições de comportamento ao clicar na notificação.

• Configuração: Adicionar link Singular ao campo Comportamento ao clicar no compositor de envio
• Comportamento: O toque na notificação abre o aplicativo com processamento automático do link
• Tipos de ação: Suporta deep linking e opções de URL externo

Documentação: Comportamentoao clicar no Braze

Práticas recomendadas

Siga estas diretrizes para maximizar a precisão e a eficácia do rastreamento da campanha de notificação por push.

Estrutura da campanha

Configuração de links

• Links exclusivos por campanha: Crie links de rastreamento separados para cada campanha push para isolar o desempenho
• Parâmetros descritivos: Use nomes de campanha claros nos parâmetros do link de rastreamento
• Nomeação consistente: Estabeleça convenções de nomenclatura para campanhas push (por exemplo, push_promo_2025_q1)
• Teste antes do lançamento: Validar cada nova ligação de seguimento com notificações de teste

Implementação técnica

• Sensibilidade a maiúsculas e minúsculas: Utilizar sempre sng_linkexatamente como está escrito (minúsculas)
• Codificação de URL: Assegurar que as hiperligações de seguimento estão corretamente codificadas em URL nos pedidos de API
• Tamanho da carga útil: Monitorizar o tamanho da carga útil da notificação - manter abaixo dos limites da plataforma (4KB para APNs, 4KB para FCM)
• Tratamento de erros: Implementar lógica de fallback se faltarem dados personalizados na notificação
• Versão do SDK: Usar a versão mais recente do SDK da Singular para obter suporte ideal a notificações push

Otimização de desempenho

• Segmentação: Direcione campanhas push para segmentos de usuários engajados para obter taxas de abertura mais altas
• Tempo: Envie notificações durante as janelas de envolvimento ideais com base no comportamento do utilizador
• Testes A/B: Teste diferentes mensagens e horários com links de rastreamento separados
• Limites de frequência: Limite a frequência de envio para evitar a fadiga do utilizador e as desistências
• Deep Linking: Combine o rastreamento de push com links diretos para conteúdo específico no aplicativo

Resolução de problemas

Problemas e soluções comuns