Guia de integração da web

Seguir
Avatar
Vaibhav Gupta
Updated

Bem-vindo ao Guia de Integração na Web da Singular. A Singular mede conversões para websites usando nosso Website SDK baseado em tags JavaScript. Quando a tag é implementada em seu site, a Singular pode determinar se um usuário, identificado por seu navegador, está visitando seu site pela primeira vez ou retornando ao site após uma campanha na Web.

Observe que o processo descrito aqui é diferente do processo de atribuição de aplicativos móveis.

 

Passo a passo

1

Adicione seu site como um "aplicativo" na Singular

Para começar a usar os relatórios da Singular, você deve adicionar seu site à página Apps na Singular.

  1. Vá para Singular > Configurações> Aplicativos.
  2. Se seu aplicativo móvel correspondente já estiver adicionado, selecione esse aplicativo móvel. Caso contrário, clique em Add New App (Adicionar novo aplicativo) e dê um nome ao seu aplicativo.
  3. Em New Site, selecione Web.
  4. Em "Add an app using" (Adicionar um aplicativo usando), selecione Store URL (URL da loja) e forneça o URL do seu site.
  5. Defina o ID do pacote e clique em Save (Salvar). Você usará esse ID do pacote (também conhecido como ID do produto) na inicialização do SDK.

web_bundleid.png

Dica: O Bundle Id é um nome para seu site. Recomendamos usar a notação DNS reversa, por exemplo, "com.example.site", que será usada para identificar seu site em toda a plataforma Singular.
2

Integrar o SDK em seu site

O Singular Website SDK permite atribuir a atividade do usuário a pontos de contato de marketing e rastrear eventos do usuário em seu website.

Siga os guias para integrar o SDK de uma das seguintes maneiras:

Dicas:

  • O código de inicialização do SDK deve ser chamado em cada página da Web e toda vez que ela for carregada.
  • Não recomendamos carregar o SDK da Singular somente após o login ou qualquer outra atividade. Isso fará com que a Singular perca o controle de alguns dados do usuário.
  • Você pode rastrear a atividade do usuário pós-instalação adicionando eventos como login, início de avaliação, compra e assinatura no site.
  • Recomendamos implementar o rastreamento do ID do usuário (custom_user_id), o que o ajudará a analisar os dados no nível do usuário.
3

Verifique a funcionalidade básica da integração do SDK

Para verificar a integração do SDK do seu site usando as Ferramentas do desenvolvedor do Chrome:

  1. Vá para seu site.
  2. Abra as Ferramentas do desenvolvedor digitando Ctrl+Shift+I(Windows) ou Cmd+Option+I (Mac).
  3. Na guia Rede das Ferramentas do desenvolvedor, digite "Singular" na caixa de filtro. Se o Website SDK tiver sido implementado corretamente, você verá o evento "__PAGE_VISIT__".
  4. Você também pode ver o SDID, que pode ser usado para testar a integração do Web SDK em Developer Tools > Testing Console.

check_integration.png
4

Teste sua integração no console de testes do Singular

  1. No Singular, vá para Developer Tools > Testing Console.
  2. Clique em Add Device (Adicionar dispositivo).
  3. Selecione a plataforma Web e selecione o espaço-chave Singular Device ID.
  4. Insira o SDID que você recuperou na etapa anterior e clique em Add (Adicionar).
  5. Depois que o SDID for adicionado, você poderá recarregar a página da Web e acionar eventos. O "__PAGE_VISIT__" e outros eventos (se acionados) serão mostrados no Console de teste.

testing_sdk.png

Observações:

  • O Console de teste só registra dados enquanto você está dentro da página. Ele não exibirá nenhum evento que tenha sido acionado enquanto o console estava off-line.
  • Você também pode testar a integração exportando dados no nível do usuário em Attribution > Export Logs. Essa página permite fazer download de dados no nível do usuário, como conversões (instalações), eventos e muito mais.
5

Implementar links da Web para aplicativos

Os links Web-to-app permitem rastrear as instalações do aplicativo de volta ao anúncio da Web a partir do qual o usuário chegou.

  1. Um link web-to-app básico pode ser gerado por seu engenheiro de soluções Singular. Antes de entrar em contato com o SE, certifique-se de ter adicionado esquemas de deep link para Android e iOS. Para verificar, vá para Configurações > Aplicativos, selecione seu aplicativo, selecione a plataforma e clique em Mostrar configurações avançadas.

    webtoapp_implemenetation.png

    Os deep links proporcionam uma melhor experiência de usuário da Web para o aplicativo, pois permitem que você direcione os usuários diretamente para uma página ou experiência específica dentro do seu aplicativo. Se você optar por não usar links profundos, informe seu engenheiro de soluções Singular.

  2. Depois de ter o link básico, você pode ir para Atribuição > Gerenciar links e fazer alterações se e quando necessário.

Importante: Para que o web-to-app funcione, todos os botões "Download App" em seu website devem ser marcados com o link de rastreamento web-to-app.

Para obter mais informações sobre implementação, consulte Encaminhamento de atribuição de site para aplicativo para Web móvel.
6

Início do rastreamento de campanhas da Web

Ao executar campanhas na Web, os destinos de seus URLs devem incluir parâmetros de rastreamento. Se você já usa parâmetros UTM, pode continuar a usá-los. Caso contrário, você pode usar nosso recurso Create Web Link para criar URLs de destino com parâmetros de rastreamento.

Criar links da Web

Para criar links da Web:
  1. Vá para Attribution > Create Web Link( Atribuição > Criar link da Web).
  2. Em Target (App), escolha o aplicativo que você está anunciando. O campo Domínioé preenchido automaticamente.
  3. Modifique o domínio e a página de destino (opcional) para criar seus links de acordo com sua preferência.
  4. Selecione um parceiro de anúncios ou um nome de fonte comum no menu suspenso Parceiro.
  5. Se você selecionou um parceiro de anúncios, um link "como fazer" será exibido no campo Parceiro. Clique nele para saber mais sobre as instruções e práticas recomendadas específicas do parceiro.
  6. Depois que o parceiro for selecionado, a seção Attributes (Atributos) será exibida. Digite seus parâmetros UTM, se houver.
  7. Clique em Generate Link e copie seu novo link de rastreamento.

createWebLinks.png

Para obter mais detalhes sobre a configuração avançada, consulte asPerguntas frequentes sobre links singulares ou Criação de links de sites.

Dica: não é necessário gerar um link de rastreamento da Web para cada nova campanha. Gere um link por rede e use-o em todas as suas campanhas com essa rede.

Instruções especiais para Facebook e Google Ads

Para configurar o Facebook:
  1. Depois de inserir suas informações nos níveis de campanha e de conjunto de anúncios, navegue até o nível do anúncio para definir os parâmetros de URL.
  2. No nível do anúncio, clique em Criar um parâmetro de URL em URL do site.
  3. Na página de geração do link de rastreamento no Singular, copie o URL gerado pela ferramenta de link de rastreamento e adicione-o ao URL do site.
  4. Consulte este documento do Facebookpara obter mais ajuda.

web_fb_link.png

Para configurar o Google Ads (AdWords):
  1. Se você não estiver usando o Google Analytics, um modelo de rastreamento precisará ser configurado de forma semelhante a outros parceiros.
  2. Para isso, na página de geração do link de rastreamento, copie os parâmetros de URL gerados pela ferramenta de link de rastreamento, sem o domínio base.
  3. Ao configurar um anúncio no Adwords, navegue até a seção "Opções de URL" e cole os parâmetros de URL no campo "Sufixo final de URL".
    Observação: isso pode ser feito no nível da conta, da campanha, do grupo de anúncios ou do anúncio, conforme desejado.
  4. Consulte este documento do Googlepara obter mais ajuda.

web_adwords_link.png

Observações:

  • Ao criar links de sites usando o Singular, mantenha suas convenções de nomenclatura de parâmetros UTM intactas para que os relatórios existentes não sejam alterados.
  • No link de rastreamento gerado, a Singular adiciona seu próprio conjunto de parâmetros, identificados pelo prefixo "wp". Os valores dos parâmetros "wp" incluem macros de rede, que são substituídas pela rede durante a veiculação de anúncios.
  • Quando um link de rastreamento tem parâmetros "wp" e parâmetros UTM, os parâmetros wp têm precedência para fins de atribuição da Singular.
  • Se você não usar os parâmetros "wp" da Singular, a Singular não poderá garantir a união precisa de dados (correspondência de dados do rastreador, como conversões na web e receita, com dados da rede, como custo/gastos com anúncios).
7

Configurar eventos na Singular

Ao integrar o SDK, você definiu os eventos que deseja rastrear. Para ver esses eventos em seus relatórios agregados, você precisa mapeá-los em Settings > Events( Configurações > Eventos). Observe que seus relatórios só mostrarão eventos que aconteceram depois que você os mapeou.
8

Executar um relatório de campanha

Depois de concluir a integração do SDK e o mapeamento de eventos, os dados começarão a fluir. Consulte Taxas de atualização de dados e tempos de atualizaçãopara saber quando você pode esperar seus dados.

Para executar relatórios sobre dados agregados, vá para Analytics > Reports. Escolha as dimensões e métricas que deseja ver em seu relatório e clique em Run (Executar).

Certifique-se de escolher a dimensão Platform para diferenciar entre dados da Web e de aplicativos.

web_report.png