Amplitude: rastrear evento

Use Amplitude: rastrear evento para enviar um evento para um projeto do Amplitude a partir de uma etapa da jornada, através da API HTTP V2, com as propriedades que você listar.

O Pushwoosh define o insert_id do Amplitude para você a partir do viajante e desta etapa. Isso significa que o mesmo viajante passando por este ponto exato duas vezes, por exemplo, em uma segunda volta de uma jornada em loop, resulta em um evento sem duplicatas no Amplitude, e não em dois.

Usos típicos:

• Registrar marcos da jornada: envie um evento quando um viajante atingir uma etapa, para que ele apareça ao lado dos eventos do seu produto nos funis do Amplitude.
• Alimentar um funil multicanal: registre marcos de push, e-mail ou SMS junto com eventos no aplicativo para uma visualização de funil unificada no Amplitude.
• Rastrear uma jornada em loop com segurança: a eliminação de duplicatas integrada significa que um viajante que retorna a esta etapa ainda resulta em um evento, e não em vários.

Configure o ponto

1. Arraste Amplitude: rastrear evento da seção Integrações para a tela.
2. Clique duas vezes no ponto e insira um Nome da Etapa.
3. Em Chave de API, insira a chave de API do projeto do Amplitude: Settings > Projects > seu projeto > General. Ela é armazenada mascarada, como um cabeçalho secreto de webhook. O Pushwoosh nunca a exibe ou retorna após salva, e ela nunca aparece na solicitação armazenada do ponto ou no Registro de chamadas.

4. Em Endpoint do Amplitude, escolha a região em que o projeto do Amplitude foi criado: api2.amplitude.com para um projeto nos EUA, api.eu.amplitude.com para um na UE. Uma chave de uma região é rejeitada pela outra.

5. Em Nome do evento, insira o evento como ele deve aparecer no Amplitude, por exemplo, journey_welcome_push_sent. Ele aceita as mesmas macros que as Propriedades do evento.

6. Em Propriedades do evento, adicione uma linha por propriedade a ser enviada com o evento. Insira o nome da propriedade e o valor. Os nomes não devem estar vazios e devem ser únicos. Um valor que é uma única macro de viajante mantém seu próprio tipo no Amplitude ({{tag:Age}} chega como um número, {{tag:Trial Ends}} como uma data). Qualquer outro texto é enviado como uma string. As macros usam a mesma sintaxe do corpo de um Webhook. Ou clique em Inserir Valor Dinâmico para escolher um atributo que uma etapa anterior nesta jornada produziu, por exemplo, uma resposta de LLM ou um valor de Webhook mapeado.

Exemplo

Definir Propriedades do evento como plan com o nível do plano do viajante ({{tag:Plan}}) envia essa propriedade com o evento para o Amplitude.

7. Clique em Salvar.

Resposta

O viajante continua para qualquer etapa que você conectar a seguir na tela.

Atributos após a execução da etapa

Atributo	O que contém
amplitude_events_ingested	O número de eventos que o Amplitude ingeriu

Como usá-lo em etapas posteriores

O viajante já continuou para a próxima etapa, independentemente deste atributo. Salve-o em uma Tag com Atualizar perfil do usuário se precisar confirmar que o evento foi ingerido ou ramificar com base nele com Divisão por condição.

Falhas e respostas inesperadas

Uma solicitação com falha remove o viajante da jornada. Consulte Erros e solicitações com falha.

Cenário de exemplo: Registrando envios da jornada em um funil do Amplitude

Uma equipe deseja que o envio de um push de boas-vindas apareça no mesmo funil do Amplitude que seus outros eventos de produto.

1. Adicione Amplitude: rastrear evento no ponto da jornada onde o evento deve ser disparado. Defina o Nome do evento como journey_welcome_push_sent.
2. Clique em Salvar.

Depois que isso for executado, o envio aparecerá no Amplitude ao lado do restante dos eventos do produto, para que o funil reflita o cenário completo, em vez de uma lacuna onde a etapa da jornada não é relatada.