Configurar Primer de Empurrar

Configure os primeiros lançamentos usando campanhas independentes dentro do app.

O que são Primers de Pressão

Quando um usuário abre seu aplicativo pela primeira vez, recebe uma notificação push com permissão pedindo para permitir ou negar notificações.

Um push primer é uma mensagem personalizada dentro do app que aparece antes desse diálogo de notificações push, dando a você a oportunidade de explicar o valor das notificações para seus usuários.

Configure uma Campanha de Introdução ao Push

Com o Xtremepush, você pode criar primários de push usando campanhas independentes dentro do app. Na campanha, você cria sua mensagem push primer e especifica o evento SDK que a desencadeia.

Essas campanhas podem ser configuradas nos seguintes formatos de mensagem:

• Modal: O primer de pressão é configurado em um botão dentro da mensagem.

• Banner: O push primer fica definido no nível da mensagem, e ao tocar em qualquer lugar do banner, o diálogo de permissão push é ativado.

• Tela cheia: O primer de pressão pode ser ajustado no nível da mensagem, em um botão ou em ambos.

Para mais informações sobre como configurar campanhas Modais, Banners e Tela Cheia, veja Modal In-App, Banner In-App e Tela Cheia In-App.

Configuração da Campanha

Para configurar uma campanha push primer, faça o seguinte:

1. Clique em Criar Campanha e depois selecione In-App / Onsite.

2. Na aba Configuração , selecione o canal In-App .

3. Na aba Conteúdo , selecione o Tipo de mensagem no app e crie o conteúdo para o seu push introductor:

   • Modal: O primer de pressão pode ser adicionado como um botão. Quando um usuário clica nesse botão, a janela de permissão para empurrar é exibida. Configure este botão na aba Formulário :

     1. No menu suspenso de Ação , selecione Solicitar Permissão de Empurramento.

     2. Insira o rótulo do botão no campo Texto .

     3. Deixe os menu suspensos de Salvar e Disparar como Nenhum.

     4. Selecione a caixa de seleção do botão para visualizar o botão. O exemplo abaixo mostra um botão Habilitar Notificações adicionado a uma campanha modal. Quando um usuário clica, o diálogo de permissão push é exibido.

        

   • Banner: Tocar em qualquer lugar do banner ativa o diálogo de permissão para empurrar. Para configurar isso, na aba Retrato , selecione Solicitar Permissão de Push no menu suspenso de Ação .

     

   • Tela cheia: Você pode configurar a ação de permissão push no nível da mensagem, em um botão, ou em ambos:

     • Nível da Mensagem: Tocar em qualquer lugar da mensagem em tela cheia ativa o diálogo de permissão para o push. Para configurar isso, na aba Retrato , selecione Solicitar Permissão de Push no menu suspenso de Ação .

       

     • Botão: Tocar em um botão na mensagem em tela cheia ativa o diálogo de permissão por empurrão. Para configurar isso:

       1. Na aba Retrato , clique no botão Adicionar

       2. No menu suspenso de Ação , selecione Solicitar Permissão de Empurramento.

          1. Insira o rótulo do botão no campo Texto

          2. Deixe os menu suspensos de Salvar e Disparar como Nenhum. O exemplo a seguir mostra um botão configurado para solicitar permissão de inserção em uma campanha em tela cheia.

          

4. Na aba Trigger , selecione o evento do SDK que vai acionar a mensagem push primer.

5. Antes de iniciar sua campanha, veja abaixo Desencadear o Evento Push Primer .

Uma vez que sua campanha está ativa, quando um usuário aciona o evento SDK, aparece a mensagem push principal. Usuários que já concederam permissão para notificação push não verão o manual.

Acionando o Evento de Primer de Empurrar

Antes de enviar o evento que aciona sua campanha push primer, verifique se os usuários são elegíveis para receber o prompt de notificação. Você pode fazer isso usando canRequestNotificationPermission. Se esse método retornar true, você pode prosseguir para enviar o evento e o push primer é exibido.

Isso garante que o evento só seja enviado quando o diálogo de permissão de notificação push for exibido ao usuário.

// Check if the user is eligible to receive the notification prompt.
if (mPushConnector.canRequestNotificationPermission(this)) {
    // Trigger the in-app campaign.
    mPushConnector.hitEvent("inapp-primer", "");
}

// Before showing your in-app push primer, check whether iOS will allow a permission prompt.
// If permission has already been granted/denied, iOS will not show the system prompt again.
[XPush canRequestNotificationPermission:^(BOOL canRequest) {
    if (canRequest) {
        // Trigger your Xtremepush in-app campaign via an event.
        [XPush hitEvent:@"inapp-primer"];
    }
}];

XPush.canRequestNotificationPermission { canRequest in
    if canRequest {
        // Trigger your in-app "push primer" campaign via an event
        XPush.hitEvent("inapp-primer")
    }
}