Como rastrear eventos personalizados em seu site?

Criada por Isabelle Fernandes, Modificado em Sex, 10 Mar, 2023 na (o) 1:51 PM por Isabelle Fernandes

Indisponível no Freshsales.

Os eventos são referidos como qualquer ação executada por seus usuários em seu aplicativo/site da web, como adicionar o produto ao carrinho, comprar um produto, adicionar o produto a uma lista de desejos, enviar um formulário, clicar em um botão, clicar em e-mail, abrir e-mail , etc. Sempre que ocorrer um evento, um atributo será anexado a esses eventos, que contém informações de quando e onde esses eventos aconteceram, por exemplo: de qual dispositivo esse evento aconteceu, de qual sistema operacional aconteceu, a que horas aconteceu, de onde localização e fuso horário aconteceu etc

Essas informações relacionadas a eventos podem ser usadas por você para entender melhor seus visitantes e usuários e também podem ser usadas para segmentar seus usuários com base em suas ações e executar campanhas personalizadas específicas ou campanhas de gotejamento automatizadas para eles.

Recomendamos que você continue o processo de integração dos eventos em sua página da web/aplicativo da web apenas se estiver familiarizado com o uso de eventos e atributos em todas as principais plataformas, como Java, JS, Android e IOS, Webapps. Caso contrário, procure a ajuda do seu desenvolvedor para o mesmo.

Recomendamos que você anote todos os eventos que gostaria de rastrear junto com seus atributos e tipos de dados.

Observação: os tipos de dados uma vez definidos não podem ser alterados posteriormente, portanto, solicitamos que você tenha certeza de qual tipo de dados está definindo antes de começar. Sua aplicação web não poderá gravar dados se o tipo de dados recebido for diferente do que foi definido no início.

Antes de prosseguirmos com os eventos na aplicação web, consulte a tabela abaixo para conhecer nossos atributos base. Esses atributos básicos serão capturados automaticamente sempre que ocorrer um evento em sua página da web/aplicativos da web. Os usuários não podem modificar ou editar esses atributos de forma alguma.

Atributos básicos

Nome	Tipo	Descrição
nome do evento	string(50)	Todos os nomes de eventos do sistema (email_sent,email_delivered, email_subscribe,email_unsubscribe,email_bounced,email_opened,email_clicked,journey_entered,journey_exited,page_viewed,form_submitted)
categoria_evento	enumerar	Toda a categoria do sistema (e-mail, jornada, web, formulário)
tipo de evento	enumerar	Eventos do sistema e eventos personalizados
org_id (account_id)	longo	ID da organização/ID da conta associada ao usuário
contato_id	longo	ID de contato associado ao usuário
event_time (created_at)	data hora	Hora de ocorrência do evento

Seu aplicativo da web oferece suporte a dois tipos de eventos de marketing: eventos do sistema e eventos personalizados

Eventos do sistema

Os eventos do sistema serão capturados automaticamente, além de todos os eventos realizados pelo usuário no fluxo de trabalho da Jornada, as campanhas em massa também serão capturadas. Para saber mais sobre eventos do sistema, consulte este artigo .

Eventos personalizados

Eventos customizados são os eventos que são enviados por você para o aplicativo da web, esses eventos são definidos pelo usuário. Pode ser qualquer ação executada por seus usuários em seu site/aplicativos da web, como Adicionar à lista de desejos, Adicionar ao carrinho, Produto solicitado, Produto comprado, Falha no pagamento, etc. Você pode definir esses eventos com base em suas necessidades.

API de visitante associado

API de front-end:

FM.associateVisitor("johny.depp@hollywood.com");

Na captura de tela acima, 'johnny.depp' é um usuário ANÔNIMO que visitou a página de preços “ https://www.freshworks.com/marketing-automation/pricing” . Ao usar nossa API JS FM.associateVisitor(“email”), estamos associando o usuário anônimo ao seu contato de e-mail.

Observação: a API acima não criará um contato se ainda não estiver presente em seu aplicativo da web.

API de descanso:

curl -XPOST -H "fm-token:jrr3g04b0atvta4tmghbguhgugvd03r9n8v7eon7mv1b7qa" 'http://<domain>.freshworkscrm.com/ crm/marketer/ mas/api/v1/contacts/associate-visitor' -d '{"visitor_id": " 1564408766806r0.8685208684454182", "email": "johnny.depp@hollywood.com"}'

Observação: se o contato não estiver presente em seu aplicativo da Web, a API acima criará um novo contato

API de evento personalizado

API de front-end

FM.trackCustomEvent("Adicionado ao carrinho",

{

"email": "david.thompson@sample.com",

"preço": 100,21,

"moeda": "USD",

"is_mobile_transaction": verdadeiro,

"data de retorno": "2019-12-30"

});

API Rest

curl -XPOST 'https://<domínio>.freshworkscrm.com/crm/marketer/mas/api/v1/events?email=david@aws.com&event_name=signup_from_social' -d'{"preço": 1000, "moeda ": "USD", "product-name": "Amazon Fire Stick", "user_id": "1010303"}' -H "Content-Type: application/json"

Formatos de data suportados

1. "aaaa-MM-dd";

2. "aaaa-MM-dd HH:mm:ssZ";

3. "aaaa-MM-dd HH:mm:ss.SSS z";

4. "aaaa-MM-dd HH:mm:ss.SSS";

Atributos de evento personalizados

Atributos de eventos customizados são definidos pelo usuário, você pode definir atributos de eventos customizados dependendo de seus requisitos e necessidades de negócios.

Por exemplo: Produto adicionado ao carrinho, pode ter os seguintes atributos nome do produto, preço do produto, valor da moeda, etc.

Limitações do evento personalizado:

Seu aplicativo da web oferece suporte aos seguintes tipos de dados:

boleano
Número
String (255 caracteres)
Data

O nome do evento pode ser no máximo (100 caracteres)
Um evento personalizado pode ter no máximo 25 atributos personalizados por tipo de dados ( Boolean, Number, String, Date (ou seja, 25 atributos personalizados do tipo de dados Number, 25 atributos personalizados do tipo de dados String, etc.).
O comprimento máximo de um nome de evento é de 100 caracteres.
O comprimento máximo de um tipo de dados String para um atributo é de 255 caracteres.
O comprimento máximo de um nome de atributo é de 50 caracteres.
O nome do seu evento ou atributo do evento não deve começar com fm_