Amplitude: definir propriedades do usuário

Use Amplitude: definir propriedades do usuário para atualizar o perfil de usuário do Amplitude do viajante a partir de uma etapa da jornada, através da operação $identify da API HTTP V2, para que a segmentação e os cohorts no lado do Amplitude vejam os mesmos dados que o Pushwoosh.

O Pushwoosh define o insert_id do Amplitude para você a partir do viajante e desta etapa. Isso significa que o mesmo viajante que passa por este ponto exato duas vezes, por exemplo, em uma segunda volta de uma jornada em loop, atualiza o mesmo perfil do Amplitude em vez de escrever um evento de identificação duplicado.

Usos típicos:

• Sincronizar tags em segmentos do Amplitude: envie o nível do plano, o status de avaliação ou outra tag para o perfil do Amplitude para que os cohorts do Amplitude correspondam aos públicos do Pushwoosh.
• Manter perfis atualizados sem um trabalho de sincronização separado: atualize o perfil na etapa exata da jornada onde a tag mudou.
• Evitar chamadas de identificação duplicadas em um loop: a desduplicação integrada significa que uma passagem repetida por este ponto atualiza o mesmo perfil em vez de escrever duas vezes.

Configurar o ponto

1. Arraste Amplitude: definir propriedades do usuário da seção Integrações para a tela.
2. Dê um duplo clique no ponto e insira um Nome da Etapa.
3. Em Chave de API, insira a chave de API do projeto do Amplitude: Configurações > Projetos > seu projeto > Geral. 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 dos EUA, api.eu.amplitude.com para um da UE. Uma chave de uma região é rejeitada pela outra.

5. Em Propriedades do usuário, adicione uma linha por propriedade a ser definida no perfil do Amplitude. 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 do 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 que o 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 usuário para user_id com o ID do viajante ({{device:user_id}}) e plan com o nível do plano ({{tag:Plan}}) define essas duas propriedades no perfil do Amplitude.

6. 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 a atualização foi ingerida ou ramificar com base nela com Divisão de 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: Mantendo o perfil do Amplitude de um assinante em sincronia

Uma equipe quer que o nível do plano de um viajante seja atualizado em seu perfil do Amplitude assim que ele mudar no Pushwoosh.

1. Adicione Amplitude: definir propriedades do usuário logo após a etapa em que o nível do plano muda. Em Propriedades do usuário, defina plan como {{tag:Plan}}.
2. Clique em Salvar.

Após a execução, o perfil do Amplitude refletirá a mudança de plano sem um trabalho de sincronização separado.