Como fazer a integração com o Segment

O que você vai aprender

Saiba como integrar o Segment à Klaviyo para poder acionar e filtrar fluxos e definir segmentos usando eventos sincronizados com a Klaviyo a partir do seu projeto do Segment. Use o destino Klaviyo (Actions) para enviar track eventos e identify atualizações de perfil do Segment para a Klaviyo.

Este guia explica como enviar dados do Segment para a Klaviyo e, opcionalmente, como enviar a atividade de Klaviyo Email de volta para o Segment. Para a configuração do destino, use o guia completo do Segment para integração com a Klaviyo.

Antes de começar

Conectar Segment e Klaviyo

Adicione o Klaviyo (ações) como um destino no Segment

Siga o guia de configuração do Klaviyo (Ações) da Segment para adicionar o destino e conectar a origem da Segment cujos dados você quer enviar para a Klaviyo.

Configure o destino e os mapeamentos de ação usando o guia do Segment e os detalhes do Klaviyo abaixo.

• Uma chave de API privada do Klaviyo com acesso completo a contas, campanhas, eventos, listas, perfis, segmentos e assinaturas. Saiba como criar uma chave de API privada e como gerenciar suas chaves de API no Klaviyo.
• Se você quiser adicionar perfis a uma lista, use o ID dessa lista no mapeamento de ação relevante. Saiba como encontrar o ID da sua lista na Klaviyo.

Trate as chaves de API privadas como senhas, armazenando-as em um local seguro e nunca divulgando-as.

Use Upsert perfil para identify chamadas que criam ou atualizam informações de perfil e Track Event para track chamadas que registram a atividade do cliente. Siga o guia do Segment para configurar e ativar os mapeamentos de que você precisa.

Ative o destino no Segment para começar a enviar dados que correspondam aos seus mapeamentos ativados.

Envie a atividade do Klaviyo Email para o Segment (opcional)

A sincronização de retorno envia eventos de entrega de e-mail, abertura, clique em link, bounce, denúncia de spam e cancelar inscrição para o Segment.

Obtenha uma chave de gravação para a origem do Segment que deve receber sua atividade do Klaviyo Email. Você pode configurar uma origem do Klaviyo ou encontrar a write key de uma origem de fluxos de eventos existente.

Copie sua chave de gravação. Sua chave de gravação é outra chave de API privada. Trate-o como uma senha; mantenha-o em um lugar seguro e nunca exponha-o ao público.

Habilite a integração na Klaviyo

1. Na Klaviyo, selecione a aba Integrações.
2. Selecione Explorar aplicativos, procure Segmento e clique no cartão. Em seguida, clique em Instalar.
3. Cole a chave de gravação que você copiou anteriormente na caixa e escolha a região Segment. Em seguida, clique em Connect to Segment.
   • Escolha Estados Unidos se o URL do Segment for: https://app.segment.com/.
   • Escolha União Europeia se o URL do seu Segment for: https://eu1.app.segment.com/.
     

4. Na próxima página, você pode limitar a atividade de e-mail enviada de volta ao Segment marcando a caixa ao lado de Não sincronizar perfis que não são atualizados pelo Destination do Klaviyo.

• Essa configuração controla a sincronização de devoluções. Ela não mescla nem remove perfis no Klaviyo. Se você deixar essa opção desmarcada, perfis sem identificadores do Segment armazenados enviam a atividade de e-mail usando o endereço de e-mail como um ID anônimo no Segment.
• Marque a caixa de seleção para enviar a atividade de e-mail apenas para perfis com um ID de usuário do Segment ou ID anônimo armazenado. A elegibilidade depende desses identificadores, não de onde o perfil foi criado pela primeira vez.

5. Quando terminar, clique em Concluir configuração.

Depois de enviar um e-mail pelo Klaviyo, confira a fonte de recebimento no Segment para ver a atividade de e-mail. Consulte o guia de fonte do Klaviyo no Segment para saber quais eventos esperar.

Métricas de segmento

Recomendamos sincronizar os eventos mais importantes com a Klaviyo, como:

• Quando um cliente se inscreve
• Quando um cliente inicia o checkout ou manifesta interesse em pagar
• O que um cliente compra (incluindo imagens de itens e descrições de itens)

Forneça os identificadores de perfil exigidos pelo seu mapeamento do Klaviyo (Ações), como um endereço de e-mail ou um ID externo. Para informações detalhadas sobre identificadores e formatação de eventos, consulte o guia de integração do Klaviyo do Segment.

Para empresas transacionais na web e plataformas de e-commerce, recomendamos seguir nosso guia de integração de um carrinho ou plataforma de e-commerce personalizado para obter informações detalhadas sobre os eventos que devem ser enviados para a Klaviyo via Segment.

Monitorando a sincronização da Klaviyo

Depois que você ativar o destino Klaviyo (Actions) e seus mapeamentos no Segment, suas chamadas identify e track começarão a enviar dados para a Klaviyo em 5-10 minutos. Para verificar a sincronização de eventos, envie um evento de teste track e depois acesse Análises > Métricas na Klaviyo para encontrar a métrica correspondente.

Para Track Event, o mapeamento de Nome da métrica determina o nome da métrica no Klaviyo. O Klaviyo trata as métricas de Segment como métricas de API de terceiros, então cada métrica terá um ícone de engrenagem ao lado do nome no Klaviyo. Para ver os dados recebidos, abra a métrica e selecione Feed de atividades.

Para verificar uma chamada de identify enviada por Upsert perfil, verifique o perfil correspondente no Klaviyo para ver as informações atualizadas. As atualizações de perfil não criam uma métrica nem um evento no feed de atividades da métrica.

Resultado

Agora você integrou o Segment à Klaviyo e pode começar a usar os dados do Segment para disparar e filtrar fluxos e definir segmentos usando eventos sincronizados com a Klaviyo a partir do seu projeto do Segment.

Recursos adicionais