1. Centro de Ajuda
  2. Integre seu app móvel com a Connectif
  3. Recursos para o desenvolvedor
  4. Integração do App Móvel através do Mobile SDK
  5. Android SDK
  6. Tracking

Android Mobile SDK: Notificar evento personalizado

Criado
Atualizado
Seguir

O evento personalizado serve para criar notificações personalizadas entre o eCommerce e o Connectif. Para isso, notifica via Mobile SDK eventos de Integração personalizada para receber dados no Connectif, utilizando as funções Connectif.sendCustomEventById() e Connectif.sendCustomEventByAlias(), conforme desejarmos identificar os eventos por alias ou id.

 

Como usar

A notificação de eventos de integração personalizada é realizada definindo o campo type com o valor literal "custom e identificando o evento pelo parâmetro eventAlias, único na sua loja. No parâmetro CustomEvent, estarão, caso existam, os campos do evento de integração.

Para construir o parâmetro CustomEvent, podemos usar as classes que herdam de CustomEventValue, que correspondem aos tipos de campos que podem ser criados nos Eventos personalizados a partir do Dashboard do Connectif.

CustomEventValue.Text
CustomEventValue.Phone
CustomEventValue.Email
CustomEventValue.Integer
CustomEventValue.Decimal
CustomEventValue.DateTime
CustomEventValue.Boolean
CustomEventValue.MultipleChoice
CustomEventValue.SingleOption

Este tipo de evento coleta automaticamente as seguintes informações:

  • Sistema operacional: Android ou iOS.
  • Versão do aplicativo.
  • Versão do sistema operacional.
  • Versão do Connectif SDK.

Exemplo usando alias do evento

Dada uma integração personalizada para receber dados, que é enviada quando um contato dá um Like em um produto, que inclui os campos email, productId.

Notificar evento personalizado 2023 - 01-min.png

A notificação terá esta aparência usando CustomEventValue:

Connectif.sendCustomEventByAlias("product-like",
    CustomEvent(
        mapOf(
            "email" to CustomEventValue.Email("test@example.org"),
            "product-id" to CustomEventValue.Text("1234")
        )
    )
)

Podemos optar por enviar os campos do evento como um objeto anônimo da seguinte forma:

Connectif.sendCustomEventByAlias("product-like",
    object {
       val `email` = "test@example.org"
       val `product-id` = "1234"
    }
)

 

Exemplo usando identificador do evento

Como alternativa ao uso do alias, é possível identificar o evento pelo seu eventId. O exemplo a seguir mostra como utilizá-lo (também compatível com o envio de campos como objeto anônimo):

Connectif.sendCustomEventById("635feb9a4168beeaf0ae6a46",
    CustomEvent(
        mapOf(
            "email" to CustomEventValue.Email("test@example.org"),
            "product-id" to CustomEventValue.Text("1234")
        )
    )
)

 

Callbacks (Opcional)

Se desejar obter feedback sobre possíveis erros ao enviar eventos, podemos adicionar um EventCallbacks ao utilizar nosso método.  

 object : EventCallbacks {
    override fun onSuccess() {
        //Tratamento em caso de sucesso
    }
    override fun onError(message: String?) {
         //Tratamento em caso de erro
    }
}

 

 

 

Parabéns!
Você chegou ao final da lição.

  

Ficou com alguma dúvida?
Lembre-se de que nossos especialistas em Connectif estão à sua disposição. Para entrar em contato com eles, basta abrir um ticket para o Suporte clicando no botão azul “Ajuda” no seu dashboard.

Continue aprendendo!

Para aproveitar ao máximo sua conta no Connectif, recomendamos que continue com os seguintes artigos: