Visão geral de integrações

Integrações conectam o pipeline canônico de eventos a fontes e destinos sem colocar comportamento específico de plataforma dentro do código compartilhado do Node.

Cada integração é um módulo autocontido. Ela é dona dos próprios manifestos, regras de configuração, tradutores, handlers e demais comportamentos de plataforma. O roteamento e o dispatch compartilhados continuam genéricos.

Catálogo versus runtime

Os dois lados têm responsabilidades diferentes:

• O catálogo do System publica metadados de módulo, releases, checksums e requisitos de compatibilidade.
• O runtime do Node instala e valida pacotes de módulo, armazena a configuração do lado do Node, compila a config de integração segura para o hot path, e executa o módulo.
• O Console permite que seu navegador configure o Node conectado e observe o resultado.

O catálogo não processa seus eventos de marketing. Eventos de runtime e dados de clientes ficam no seu Node até um handler habilitado encaminhar os campos exigidos pelo destino dele.

Encaminhamento canônico-primeiro

Eventos de navegador e webhooks recebidos são traduzidos antes de o pipeline compartilhado rodar. Durante o Forwarding, cada handler de saída ativo transforma o evento canônico no formato da própria plataforma.

Isso mantém uma regra de campo específica da Meta dentro do módulo Meta, um mapeamento do GA4 dentro do módulo GA4, e o dispatch compartilhado independente de qualquer uma das duas plataformas.

Leia O payload canônico de evento para o contrato de evento que esses handlers recebem.

Implante e configure um módulo

No Console:

1. Abra Integrations.
2. Selecione DEPLOY NEW MODULE.
3. Escolha a fonte ou destino que você quer conectar.
4. Se o módulo do catálogo for instalável e compatível com seu Node, selecione Install Module.
5. Abra a configuração dele, informe as credenciais e identificadores exigidos pela plataforma, habilite-o e salve.
6. Dispare um novo evento de teste.
7. Confirme o evento no Console, depois confirme o recebimento na plataforma de destino.

Instalado e ativo são estados diferentes. A instalação coloca código de módulo compatível no Node; a ativação e uma configuração válida determinam se ele participa em runtime.

Os campos exatos de configuração dependem do módulo. Mantenha credenciais fora de capturas de tela, tickets públicos, código-fonte de página e GTM, a menos que um campo seja explicitamente projetado como token de ingestão de navegador.

A fonte GTM

O Google Tag Manager usa o template aprovado Supreme Tracking Event Core para chamar o window.supremeSend do Loader. O Node então normaliza o envelope de navegador como qualquer outra fonte.

Siga Connect Google Tag Manager (em inglês) para o comportamento atual do template e o fluxo de triggers.

Verifique o encaminhamento

Use dois checkpoints:

1. Evento no Console: prova que o Node aceitou e persistiu o evento.
2. Recebimento no destino: prova que um handler ativo montou e entregou um payload que a plataforma aceitou.

Se o primeiro checkpoint falhar, verifique seu primeiro evento. Se o primeiro passar e o segundo falhar, foque no módulo e no destino.

Se uma integração ativa não recebe nada

Confira:

• O módulo está instalado neste Node e o release dele é compatível.
• A integração está habilitada, não só instalada.
• Os identificadores exigidos e as credenciais da plataforma estão presentes e válidos.
• Um evento canônico novo chega ao Node com os campos que o handler precisa.
• O Node compilou a configuração de integração atual depois da última mudança.
• A view de teste ou diagnóstico do destino está usando a conta, property, pixel ou stream corretos.
• Os logs do Node mostram se o Forwarding tentou o handler e retornou um erro.

Não contorne o pipeline canônico com lógica específica de destino dentro do código de ingestão compartilhado. Corrija o mapeamento de fonte no tradutor dela ou o mapeamento de destino no módulo autocontido dele.