Como fazer a integração com o Qgiv

O que você vai aprender

Saiba como integrar o Qgiv com o Klaviyo. Depois de concluir essas etapas, o senhor poderá personalizar e direcionar e-mails com base na doação de cada colaborador e na atividade do site. Aqui estão alguns dos dados que sincronizamos do Qgiv:

• Valor de cada contribuição
• Informações do colaborador, incluindo nome e sobrenome, local e como ele encontrou seu site
• Se cada contribuição é recorrente e, em caso afirmativo, com que frequência ela ocorrerá

Primeiro, o senhor precisará gerar um token de API no Qgiv e, em seguida, ativar a integração no Klaviyo.

Gerar seu token de API do Qgiv

1. Faça login em sua conta Qgiv.
2. Clique em Settings (Configurações ) na barra lateral esquerda de sua conta e, em seguida, clique em API Access (Acesso à API).
   
   
3. Clique em Create API Token.
4. Em seguida, será solicitado que o senhor crie um nome de token e estabeleça um tipo de token. Em Token Type, selecione "Permanent".
   
5. Depois de selecionar "Permanent" como o Token Type, selecione os formulários que você deseja tornar acessíveis no Klaviyo. Se o senhor quiser todos os dados de doação, selecione todas as suas campanhas. 
6. O Qgiv fornecerá ao senhor o token de API localizado no lado esquerdo em Combination (Combinação). É disso que o senhor precisará na próxima etapa para integrar o Qgiv ao Klaviyo.
   

Adicionar a integração do Qgiv no Klaviyo

1. No Klaviyo, selecione o nome da sua conta no canto inferior esquerdo e clique em Integrations (Integrações).
2. Selecione Add integrations (Adicionar integrações), procure o Qgiv e clique no cartão. 
3. Em seguida, clique em Install (Instalar).
4. Digite seu token de API e clique em Connect to Qgiv.
   
   
5. O senhor deve receber uma mensagem de sucesso.

Monitorar a sincronização do Klaviyo e verificar os dados

Para verificar sua integração com o Qgiv:

1. Clique no menu suspenso Analytics no Klaviyo e selecione Metrics.
2. Clique na métrica Contribuição feita para verificar se há dados preenchidos para essa métrica. Se houver dados, tudo o que o senhor precisa fazer é esperar até que a sincronização inicial da integração com o Qgiv seja concluída; esse processo pode levar até duas horas, dependendo da quantidade de dados que o senhor tem em sua conta.
3. O Klaviyo importará todos os seus dados históricos do Qgiv. Para verificar isso, o senhor pode comparar o número de pedidos em um determinado dia no Klaviyo com o que está na interface do Qgiv e confirmar a correspondência. Por exemplo, ao explorar a métrica Made Contribution na Klaviyo, o senhor pode passar o mouse sobre o ponto de dados de ontem ou examinar a tabela de dados abaixo do gráfico para ver quantos pedidos foram relatados ontem.
4. Compare esse número com o que está armazenado no Qgiv de ontem e o senhor verá que eles são exatamente iguais. Caso contrário, o problema provavelmente é que o fuso horário da sua conta Klaviyo não corresponde ao fuso horário do Qgiv.
5. Para verificar sua configuração de fuso horário no Klaviyo:
   • Clique no nome de sua conta no canto inferior esquerdo.
   • Selecione e clique em Settings (Configurações) > Organization (Organização).
   • Role para baixo até Timezone.

Dados sincronizados do Qgiv

Há duas métricas capturadas pelo Qgiv e sincronizadas com o Klaviyo: Contribuição feita e Registro no evento.

Contribuição feita

Esse evento é rastreado quando um doador faz uma contribuição no Qgiv. O senhor pode filtrar e direcionar eventos de Contribuição Feita com base nos seguintes critérios: 

• DonationSource
• Restrição
• Optou por entrar
• Tipo
• IsAnonymous
• FormName
• FormID
• $valor

Registrado no evento

Esse evento é rastreado quando um formulário de registro de evento peer-to-peer é enviado. O senhor pode filtrar e direcionar eventos Registered for Event com base nos seguintes critérios: 

• FormID
• ID do registro
• ID da transação
• Título
• Meta de arrecadação de fundos
• DonationSource
• Capitão da equipe
• $event_id
• $valor

Dados do cliente

Além das métricas que a Klaviyo sincroniza do Qgiv, há também propriedades personalizadas que são adicionadas a cada perfil da Klaviyo. O senhor pode usar essas propriedades em segmentos e em fluxos. As propriedades a seguir são campos incorporados do Klaviyo que serão sincronizados automaticamente:

• E-mail
• Primeiro nome
• Sobrenome
• Cidade
• Estado/Região
• Código Postal
• País
• Número de telefone

Frequência da sincronização Qgiv

As métricas e as propriedades de perfil do Qgiv são sincronizadas usando webhooks. Isso significa que o Qgiv indica ao Klaviyo quando um evento ocorreu e o Klaviyo extrai todos os dados. Isso ocorre quase instantaneamente. 

Adicionar rastreamento no local do Klaviyo

A etapa final aqui é adicionar o código de rastreamento Active on Site da Klaviyo ao rodapé do seu site. Esse código de rastreamento da Klaviyo nos permitirá rastrear uma métrica Active on Site para que o senhor possa ver e aproveitar os dados relacionados às visitas ao site e ao comportamento do visitante. Por meio dessa métrica, a Klaviyo rastreará a atividade do site para navegadores conhecidos.

Por exemplo, o senhor pode usar a métrica Active on Site (Ativo no site ) para criar segmentos de pessoas que visitaram seu site (enquanto estavam conectadas), mas ainda não fizeram uma doação. 

1. O script de rastreamento a seguir pode ser encontrado no Klaviyo clicando no nome da sua conta no canto inferior esquerdo, selecionando Integrations (Integrações) e, em seguida, clicando em Manage sources (Gerenciar fontes) > Setup web tracking (Configurar rastreamento da Web ) no canto superior direito.
2. Também incluímos aqui o script de rastreamento Klaviyo Active on Site , que o senhor pode colar no modelo principal do seu aplicativo antes da </body>tag</body >. Lembre-se de adicionar sua própria chave de API, que pode ser encontrada em Account name (Nome da conta) > Settings (Configurações) > API Key(Chave de API pública), onde o senhor vê "Public API Key" (Chave de API pública):

   <script type="application/javascript" async
    src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=Public API Key"></script>
   

3. Em seguida, o senhor precisará inserir o URL do seu site na página Set Up Web Tracking. Depois de inserir o URL, clique em Next (Avançar ) para testar a configuração do rastreamento. O senhor deve receber uma mensagem de sucesso se estiver funcionando corretamente. 
   

Resultado

O senhor já se integrou ao Qgiv, verificou seus dados sincronizados e adicionou o rastreamento no local do Klaviyo. 

Recursos adicionais

• Referência de FAQ de integração
• Com que frequência as integrações sincronizam a referência