Dispositivos móveis: o que são Callbacks da campanha Android e como são usados?

Last Updated dezembro 10, 2025

Breve Visão Geral

A partir da versão 1.6.0 do WalkMe Mobile SDK, o WalkMe Mobile SDK oferece suporte a chamadas de campanha.

Callbacks são uma maneira programática de um aplicativo se registrar nos eventos da Campanha WalkMe. Ao implementar a interface Campaign Callbacks, os aplicativos podem usar os dados transferidos por meio dos objetos de callback (incluindo informações da campanha e do usuário) e utilizá-los para os fins do aplicativo, como passar essas informações para qualquer sistema de análise ou CRM não relacionado ao WalkMe, ou atualizar qualquer aplicativo ou configurações do usuário de acordo com a interação do usuário com a campanha.

Casos de uso

Os callbacks de campanha podem ser usados para o seguinte e muito mais:

  • Acompanhe a integração de usuários em qualquer sistema de análise
  • Gere oportunidades em um CRM com base no envolvimento do usuário com o WalkMe Shoutout, por exemplo, "Interessado em uma demonstração gratuita? Sim/Não"
  • Integre com os sistemas de suporte existentes para rastrear e comparar o uso/conclusão do WalkThru com os principais tópicos do ticket de suporte

Abaixo está uma descrição de todas as etapas necessárias para implementar os callbacks da campanha.

Etapas Para Implementar Callbacks Da Campanha

Para poder se cadastrar nos callbacks da campanha, primeiro implemente esta interface:

/**
 * Definição de interface para que um callback seja invocado nas ações da campanha.
 */
interface pública WMCampaignInfoListener {
 /**
 * Chamado após o encerramento da campanha.
 *
 * @param campaignInfo As informações da campanha rejeitada.
 */
 void onCampaignDismissed(WMCampaignInfo campaignInfo);
}

Depois de implementar a interface, use o método para se cadastrar nos eventos de retorno de chamada da campanha:

/**
 * Cadastre um ouvinte para eventos da campanha
 *
 *@param campaignInfoListener O ouvinte
 *
 */
public static void setCampaignInfoListener(WMCampaignInfoListener campaignInfoListener)

O objeto de retorno de chamada de retorno será da classe , que inclui as seguintes informações:

Item Recuperado por Descrição
CTA da campanha getCampaignCta()

O CTA da campanha com o qual o usuário do aplicativo interagiu.

Para todos os CTAs que não sejam o personalizado, o CTA retornado será:
abbi://cta , por exemplo: abbi://ok ou abbi://never

ID da campanha getCampaignId() O ID exclusivo atribuído à campanha
ID do CTA da campanha getCampaignCtaId() O ID exclusivo para o CTA da campanha
Dados do usuário getUserData() Um objeto que contém informações sobre o usuário que interagiu com a campanha. Consulte a descrição completa do objeto abaixo.
Dados da campanha getCampaignData() Um objeto de espaço reservado adicionado para possível uso futuro de dados adicionais anexados à campanha. Os dados de envio da pesquisa são preenchidos aqui.

Esta é a estrutura do objeto:

 classe pública WMCampaignInfo {

 public String getCampaignCta()

 public String getCampaignId()

 public String getCampaignCtaId()

 public WMUserData getUserData()

 Mapa público<String, Object> getCampaignData()
}

Conforme mencionado acima, inclui o objeto , descrito abaixo:

Item Recuperado por Descrição
Atributos de usuário público getUserAttributesMap() Todos os atributos de usuário público que foram definidos para o usuário do aplicativo no momento em que o usuário interagiu com a campanha. A lista sempre incluirá a chave de atributo e seu valor, por exemplo, { "lead_id" : "12345" , "account_type" : "family"}
Atributos de usuário privado getPrivateUserAttributes() Todos os atributos de usuário privado que foram definidos para o usuário do aplicativo no momento em que o usuário interagiu com a campanha. A lista sempre incluirá a chave de atributo e seu valor, por exemplo, { "lead_id" : "12345" , "account_type" : "family"}
Carimbo de tempo e hora da criação do usuário getUserCreationTimestamp() O carimbo de data e hora em que o usuário foi identificado pela primeira vez pelo WalkMe
Duração da sessão getSessionDuration() Quanto tempo durou a sessão do usuário no momento em que o usuário fez a interação da campanha
Versão Android getDeviceVersion() A versão do SO do usuário
ID exclusiva do dispositivo getDeviceId() O ID exclusivo do dispositivo
Modelo de Dispositivo getDeviceModel() O modelo do dispositivo do usuário
Orientação do Dispositivo getDeviceOrientation() A orientação do dispositivo no momento em que o usuário interagiu com a campanha
Versão do aplicativo getAppVersion() A versão do aplicativo que o usuário está usando
Nome do aplicativo getAppName() O nome do aplicativo
Local getLocale() O local do dispositivo do usuário
Versão do SDK getSdkVer() A versão do SDK integrada ao aplicativo que o usuário está usando
ID da sessão getSessionId() O ID de sessão exclusivo gerado pelo WalkMe
Indicação de Novo Usuário getIsNewUser() Esta é a primeira vez que o usuário é identificado pelo WalkMe (verdadeiro / falso)
Status das Notificações Push getIsPushEnabled() O usuário ativou a notificação push para o aplicativo (verdadeiro/falso). Se o aplicativo não tiver notificações push, o valor será "false".
Fuso horário do dispositivo getTimezone() O fuso horário do usuário, conforme definido no dispositivo.
Rede getNetwork() O tipo de rede que o usuário está usando: WiFi / Celular / Off-line
Latitude do usuário getLocationLat() Marcador de posição para possível implementação da latitude de localização
Longitude do usuário getLocationLong() Marcador de posição para possível implementação da longitude da localização
Nome do Sistema getSystemName() O nome do sistema operacional do usuário - neste caso, será sempre "Android"
Carimbo de data e hora do usuário atual getTimestamp() O carimbo de data e hora atual do usuário

Esta é a estrutura do objeto:

classe pública WMUserData {

 /**
 * Atributos do usuário na sessão atual.
 */
 Mapa público<String, Object> getUserAttributesMap()


 /**
 * Atributos de usuário privados na sessão atual.
 */
 Mapa público<String, Object> getPrivateUserAttributes()

 /**
 * Retorna o carimbo de data e hora da criação do usuário para este usuário.
 *
 * @return long Timestamp.
 */
 public long getUserCreationTimestamp()

 /**
 * Retorna a duração da sessão do usuário em segundo.
 *
 * @return double second.
 */
 public double getSessionDuration()

 /**
 * Retorna a versão do Android do dispositivo.
 *
 * @return número da versão String.
 */
 public String getDeviceVersion()

 /**
 * Retorna o ID exclusivo do dispositivo.
 *
 * @return String id.
 */
 public String getDeviceId()

 /**
 * Retorna o modelo da marca do dispositivo.
 *
 * @return String Model.
 */
 public String getDeviceModel()

 /**
 * Retorna a Orientação do Dispositivo PRT_REG / LSL.
 *
 * @return String Orientation.
 */
 public String getDeviceOrientation()
 /**
 * Retorna a versão do aplicativo.
 *
 * @return String version.
 */
 public String getAppVersion()

 /**
 * Retorna o nome do aplicativo.
 *
 * @return Nome da Cadeia de caractere.
 */
 public String getAppName()

 /**
 * Retorna o idioma local para esta instância da Máquina Virtual Java.
 *
 * @return Nome da Cadeia de caractere.
 */
 public String getLocale()

 /**
 * Retorna a versão do walkme sdk.
 *
 * @return String version.
 */
 public String getSdkVer()

 /**
 * Retorna o ID exclusivo da sessão.
 *
 * @return String id.
 */
 public String getSessionId()

 /**
 * Retornado se o usuário usar o aplicativo pela primeira vez.
 *
 * @return String boolean.
 */
 public String getIsNewUser()

 /**
 * Retornado se a notificação Push for aprovada para o usuário.
 *
 * @return String boolean.
 */
 public String getIsPushEnabled()

 /**
 * Retorna o fuso horário do dispositivo do usuário.
 *
 * @return String timezone.
 */
 public String getTimezone()

 /**
 * Retorna a rede atual do usuário (WIFI / 3G)
 *
 * @return String network.
 */
 public String getNetwork()

 /**
 * Retorna a latitude da localização atual do usuário, se disponível
 *
 * @return String latitude.
 */
 public String getLocationLat()

 /**
 * Retorna a longitude da localização atual do usuário, se disponível
 *
 * @return String length.
 */
 public String getLocationLong()

 /**
 * Retorna o nome do sistema do usuário (Android).
 *
 * @return String Android.
 */
 public String getSystemName()

 /**
 * Retorna o carimbo de data e hora atual para este usuário.
 *
 * @return String Timestamp.
 */
 public String getTimestamp()
}

Was this article helpful?

Thanks for your feedback!

Faça parte de algo maior.

Interaja com colegas, tire dúvidas e compartilhe ideias.

Explore nossa comunidade
×