For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/integrations/vturb.md.
  • Português
  • Conectar a Vturb e ver as métricas das suas VSLs

    Conecte sua conta da Vturb com a chave da Analytics API e a Clickmax passa a listar seus vídeos no editor de páginas e a mostrar as métricas de cada VSL — play rate, engajamento, retenção e comparação de testes A/B — sem você abrir o painel da Vturb.

    Antes de começar

    • Papel de workspace: Proprietário, Administrador, Editor ou Colaborador. Os papéis Financeiro, Convidado e Atendente não têm acesso a Integrações.
    • Uma conta na Vturb com a Analytics API habilitada.
    • Cada workspace pode ter uma única conta Vturb conectada.

    Passo a passo

    1. Na Clickmax, abra Integrações > Explorar integrações e, na seção Vídeo e VSL, selecione o card Vturb.
    2. Em outra aba, entre na sua conta da Vturb e copie a chave em Settings > Analytics API.
    3. Volte à Clickmax e cole a chave no campo Chave da API.
    4. (Opcional) Cole o código de incorporação de qualquer vídeo da sua conta. Veja abaixo para que ele serve.
    5. Clique em Conectar conta.

    A Clickmax valida a chave na Vturb antes de salvar: se ela estiver errada ou inativa, a conexão não é criada e você recebe o aviso na hora.

    Conectada, a Vturb aparece em Integrações com o status Ativo e a data da última validação.

    Para que serve o código de incorporação

    A chave da API dá acesso às métricas, mas a API da Vturb não informa qual é a sua conta — e esse identificador é necessário para montar o endereço do player quando você escolhe um vídeo pelo editor.

    O código de incorporação resolve isso: a Clickmax extrai dele apenas o identificador da conta. É por isso que o campo é opcional no momento de conectar:

    • colou o embed: os vídeos já aparecem com miniatura no editor e você pode aplicá-los nas páginas;
    • não colou: a conexão funciona e as métricas ficam disponíveis, e o editor pede o embed na primeira vez que você abrir o bloco Vturb.

    Para copiar o embed, no painel da Vturb abra qualquer vídeo e use o botão </>. Cole o trecho inteiro — a Clickmax descarta o resto.

    Conectar direto pelo editor

    Enquanto monta uma página, você não precisa sair dela: adicione ou selecione um bloco Vturb e use a aba Conectar API na barra lateral direita.

    É a mesma conexão dos dois lados — conectar por um lugar já vale para o outro, porque só existe uma conta Vturb por workspace.

    Um vídeo por página

    O mesmo vídeo da Vturb não pode ser aplicado duas vezes na mesma página. O player usa o identificador do vídeo como identificador do elemento na página, então o segundo bloco com o mesmo vídeo não funcionaria na página publicada.

    Na prática: ao escolher um vídeo já usado naquela página, o card aparece desabilitado e a Clickmax avisa. Escolha outro vídeo ou remova o bloco anterior.

    Como ler as métricas

    As taxas são exibidas em porcentagem na interface. Ao interpretá-las:

    MétricaO que éOnde erra a leitura
    Play ratequantos deram play sobre quantos carregaram a páginaplay rate baixo é problema de miniatura, título ou posição do vídeo na página — não do vídeo
    Engajamentotempo médio assistido até o momento da ofertauma oferta muito no fim do vídeo derruba a métrica mecanicamente; leia junto com a duração
    Conversãoconversões sobre plays, medido pela Vturbpode divergir das vendas da Clickmax; são contagens diferentes e não devem ser somadas nem comparadas como se fossem a mesma coisa
    Espectadores agoraquem entrou na página nos últimos minutosnão prova que continuam assistindo

    As métricas de período são atualizadas em intervalos de poucos minutos, então não refletem o minuto corrente.

    Testes A/B

    Quando o vídeo faz parte de um teste A/B da Vturb, a Clickmax compara as variantes lado a lado e mostra a curva de retenção por segundo.

    Duas armadilhas ao decidir o vencedor:

    • decida pela receita por visitante, não pela taxa de conversão — uma variante pode converter menos e ainda ganhar mais por visitante;
    • se o teste ainda está rodando, os números são tendência, não veredito: o tráfego continua sendo dividido.

    Status "Credencial inválida"

    Significa que a conexão existe, mas a Vturb rejeitou a chave — normalmente porque ela foi revogada ou expirou no painel da Vturb.

    Para resolver, abra a integração em Integrações e cole uma chave nova. Não é preciso desconectar antes.

    Desconectar

    Em Integrações, abra a Vturb e clique em Desconectar.

    A chave é apagada — a Clickmax não guarda credencial que você já revogou. Os vídeos já aplicados nas páginas publicadas continuam funcionando, porque o player está no HTML da página; o que para de funcionar é a lista de vídeos no editor e os painéis de métricas.