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. Na Klaviyo, selecione a aba Integrações.
2. Selecione “Explorar aplicativos”, procure por “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é Time zone (Fuso horário).

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. 

Para habilitar o rastreamento no local:

1. Na Klaviyo, selecione a aba Integrações.
2. Selecione Gerenciar dados e, em seguida, selecione > Configure o rastreamento da web.
3. Copie o código da Etapa 1 e cole-o no modelo principal do seu site, antes da tag </body>. Certifique-se de colá-lo no site associado à conta da Klaviyo em que o senhor está.
   
4. Depois de colar o snippet de código, clique em Confirm (Confirmar ) na Etapa 2 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