Kokopelli ADTK Convert icon

Kokopelli ADTK Convert

Converte payloads da ADTK para schema canonico: gateways de venda (Hotmart, Guru, Eduzz, Virtu, Greenn, TMB, Kiwify) e eventos do GTM.

Converter GTM

AI-generated

Summary

Converts each incoming GTM event into a normalized event record, with optional event filtering, field selection, IP extraction from headers, and preservation of the original payload.

Inputs

  • Eventos Permitidos (`permitidos`) — Comma-separated event_name allowlist. Empty lets all events through; when set, only listed events pass.
  • Eventos Excluidos (`excluidos`) — Comma-separated event_name blocklist. Excluded events are dropped even if also allowlisted; empty excludes none.
  • Campos De Saida (`camposSaida`) — Selects fields to keep in the normalized output. Empty keeps all available fields; fields with empty values are omitted.
  • Campos A Excluir (`camposExcluir`) — Removes selected fields after the output-field selection. Empty removes none.
  • Usar IP Do Header (`usarIpDoHeader`) — When enabled, uses x-real-ip or x-forwarded-for as a last-resort IP source if no payload IP is usable. Disabled by default. Invalid, private, or reserved addresses are omitted.
  • IPs/Faixas De Proxy a Ignorar (`ipsProxy`) — Comma-separated IPs or CIDR ranges to skip in the header IP chain. Shown only when header IP use is enabled; applies only to header-derived addresses.
  • Manter Payload Original (`keepOriginal`) — When enabled, adds the received raw payload under _original.

Output shape

A list of n8n items, each containing a normalized GTM event record.

Event fields are returned as strings; objects and arrays are serialized as JSON strings, and empty values are omitted. The record can include event name, user and location data, attribution parameters, page details, timestamps, and IP when available. Events rejected by the allowlist or blocklist are filtered out. If no valid payload IP exists and header IP use is disabled, the ip field is omitted.

Links

Discussion