O Hightouch é uma plataforma de integração de dados que permite às empresas sincronizar dados entre os seus armazéns de dados e várias outras ferramentas ou plataformas que utilizam para análise, marketing e operações. Permite aos utilizadores ligar facilmente o seu armazém de dados a ferramentas como CRMs, plataformas de automatização de marketing, sistemas de apoio ao cliente e muito mais, sem necessidade de processos ETL (Extrair, Transformar, Carregar) complexos ou de codificação personalizada.
A integração do Hightouch com o Singular envia dados de eventos móveis (iOS/Android) a partir da fonte (armazém) do Hightouch utilizando a API REST do Singular Server-to-Server (S2S). Isto é referido como um "Destino" na plataforma Hightouch. As instruções abaixo ilustram como configurar o Singular Destination no Hightouch.
| Guia de requisitos para equipas de engenharia |
|
Para utilizar esta integração, tem de estar a utilizar uma fonte Hightouch com todos os pontos de dados Singular necessários que correspondam ao último evento conhecido do Singular Mobile SDK.
Esta integração NÃO é compatível com dados de eventos não móveis. Eventos de servidor ou da Web não são suportados.
-
Tipo de sincronização suportado pelo Hightouch: Eventos
O Hightouch suporta a sincronização de eventos in-app com o Singular
MODOS DE SINCRONIZAÇÃO SUPORTADOS: Apenas inserir
- Eventos de sessão
- Eventos Web
- Eventos do lado do servidor sem pontos de dados móveis
A integração do Hightouch não substitui o SDK do Singular. É necessário utilizar o SDK do Singular em paralelo com o Hightouch. Trata-se de uma integração híbrida em que a recolha de dados ocorre no cliente através de um SDK emitido pelo Singular e através do ponto de extremidade da API REST para o mesmo dispositivo/utilizador. Qualquer evento enviado do Hightouch para o Singular será associado ao último dispositivo móvel conhecido do utilizador e associado aos últimos dados de campanha conhecidos para esse dispositivo.
Como começar
Comece por criar uma instância de um destino Singular no Hightouch. Ao criar a sua instância, tem de introduzir a Chave SDK Singular para autenticação.
- No menu de navegação do Hightouch, clique em: "Configuração > Destinos".
- Clique no botão "Adicionar destino".
- Procure por "Singular" e clique em Continuar.
- Insira a Chave SDK do Singular no campo "Chave de API". E clique em Continuar.
Obtenha sua "SDK KEY" do Singular, encontrada no Painel de Controle do Singular em "Ferramentas do desenvolvedor > Integração do SDK > Chaves do SDK"
- Dê um nome ao destino e clique em "Concluir"
Importante: Se clicar no botão "Testar ligação", poderá ver o seguinte erro:
Isso ocorre apenas porque a API requer pontos de dados adicionais que serão configurados nas etapas a seguir.
Configuração adicional
Configurar um modelo
- No menu de navegação do Hightouch, selecione "Modelos" e Adicionar um novo modelo.
- Selecione a Fonte de dados e clique em "Continuar".
- Forneça um Nome para o Modelo e selecione uma Chave primária no menu pendente.
Para garantir que as sincronizações enviam cada evento, o seu modelo de evento tem de utilizar uma chave primária verdadeiramente única. Consulte a documentação de sincronização de eventos para obter mais informações.
Configurar uma sincronização
- No menu de navegação do Hightouch, selecione "Sincronização" e "Adicionar sincronização".
- Selecione o Modelo configurado para Singular.
- Selecione o Destino singular.
- Obrigatório: Selecione a coluna Nome do Evento no menu pendente, para ser utilizada como Nome do Evento Singular.
- Obrigatório: Selecione a coluna Timestamp (Carimbo de data/hora) no menu pendente, para ser utilizada como a hora do evento singular.
- Selecione as outras colunas que você gostaria de sincronizar com o Singular.
Configure como mapear colunas nos resultados da consulta para campos no destino. Observe que o destino Singular tem alguns campos condicionalmente obrigatórios com base no campo "plataforma".
Mapeamento de parâmetro adicional necessário:
Consulte os Parâmetros de evento necessários na Referência S2S do Singular AQUI para obter detalhes sobre quais parâmetros devem ser mapeados para um evento.
Se não mapear o campo IP, este será predefinido com um dos servidores da Hightouch.
Sobre identificadores de dispositivos
Para a atribuição correta de um evento enviado do Hightouch a um dispositivo existente no Singular, deve ser utilizado um identificador de dispositivo correspondente. Se a opção de ponto final BI interno tiver sido configurada para capturar dados de um evento de início de sessão no armazém, o mesmo identificador deve ser utilizado neste pedido de evento.
No caso do iOS, este seria o IDFA ou o IDFV. Não forneça valores "NULL" ou identificadores zerados. Se o IDFA não estava disponível no dispositivo quando o SDK do Singular foi inicializado, o Singular usará o valor IDFV.
Para Android - este seria o AIFA (também conhecido como GAID) ou ASID. Não forneça valores "NULL" ou identificadores zerados. Se o AIFA não estava disponível no dispositivo quando o SDK do Singular foi inicializado, o Singular usará o valor ASID. Se nem os valores AIFA nem ASID estiverem disponíveis no dispositivo, só então deve fornecer o ID Android (ANDI).
- Uma vez mapeados os parâmetros, pode testar o evento utilizando o botão "Testar".
Capture o identificador dos dados de origem que estão a ser utilizados no seu teste e utilize a consola de testes Singular para ver o evento a ser recebido em tempo real. Saiba mais sobre como testar eventos AQUI.
Exemplo:
O mapeamento
O teste
A consola de teste Singular - Quando o teste for bem-sucedido, clique em continuar, defina o tipo de agenda e clique em "Concluir".
Suporte a SkAdNetwork
Para usar eventos enviados do Hightouch nos modelos de conversão SkAdNetwork (SKAN) da Singular, é necessário ter o recurso "Hybrid SKAN" ativado para sua conta Singular. Entre em contato com seu CSM ou envie uma solicitação de suporte Singular para ativação.
Eventos
Quaisquer registos adicionados à sua fonte são tratados como novos eventos e são enviados para o Singular quando a sua sincronização é executada.
É possível usar mapeamentos personalizados para anexar dados personalizados relevantes para sua aplicação.
Os mapeamentos personalizados são incluídos como o parâmetro "e" da carga útil da solicitação de API.
Dicas e solução de problemas
Discrepâncias
Ocorrerão discrepâncias se os identificadores de dispositivo usados nas solicitações de eventos de servidor para servidor não tiverem um identificador de dispositivo correspondente no Singular. Esteja ciente das seguintes possibilidades:
- Se uma solicitação de evento for recebida "antes" de o SDK do Singular ter gravado o identificador do dispositivo, a partir de uma sessão de aplicativo, a solicitação de evento será considerada a "primeira sessão" para o dispositivo desconhecido e o Singular atribuirá o dispositivo como uma atribuição orgânica.
- Se o Singular SDK tiver registado um identificador de dispositivo, mas o identificador do Singular SDK for diferente do identificador de dispositivo especificado no pedido de evento de servidor para servidor, o evento será atribuído incorretamente.
Erros comuns
Se receber erros, certifique-se de que está a incluir todos os campos obrigatórios do Singular: "Plataforma", "Nome do pacote", "Versão do SO" e identificadores de dispositivo para a plataforma relevante.
Depurador em tempo real
O Hightouch fornece uma visibilidade completa das chamadas de API efectuadas durante cada uma das execuções de sincronização. Recomendamos a leitura do nosso artigo sobre dicas e truques de depuração para saber mais.
Alertas de sincronização
O Hightouch pode alertá-lo para problemas de sincronização através do Slack, PagerDuty, SMS ou e-mail. Para obter detalhes, visite o nosso artigo sobre alertas.