AgnosticData.ai | Documentação
  • 👋Bem-vindo ao AgnosticData.ai | Docs
  • Overview
    • 💡O que nós fazemos
    • ✨Principais Funcionalidades
  • Legal
    • 📪Termos de Uso AgnosticData
    • 🤝Contrato do Programa de Parcerias AgnosticData
    • 📝Política e Enquadramento Parcerias
    • 📎Privacidade
    • 🛡️Código de Conduta do Parceiro
    • ℹ️Formulário de Contratação
  • Fundamentals
    • ℹ️Introdução
    • 🧰Features
      • Monitor de renderização (snippet_read)
      • 📃Postbacks
      • Valores padrão / Default Values
    • 📝Setting permissions
    • 🧑‍💻Conceitos técnicos
    • 📨Contacts API
      • Prefixo Auto-Rastreamento
      • Entendendo model_fields
    • 🔌Integrações
    • 🗳️Destinations
    • 📦Storage - VLS e PBS
    • 🔤Estratégias de Atribuição
    • Guia de Referência
  • Use Cases
    • 🧩For Creatives
    • 🎨For Designers
    • 🖥️For Developers
Powered by GitBook
On this page
  • Conceito
  • Como funciona, o básico.
  • Entendendo as regras: Postback Rules (url)
  1. Fundamentals
  2. Features

Postbacks

Configurações do projeto

PreviousMonitor de renderização (snippet_read)NextValores padrão / Default Values

Last updated 3 months ago

Conceito

A funcionalidade de postback é crucial para garantir o rastreamento eficiente de eventos em campanhas de marketing e integração com terceiros.

Quando um evento específico, como uma conversão ou ação do usuário, ocorre, os dados relevantes — incluindo informações detalhadas como UTM parameters — são enviados automaticamente para uma URL pré-definida.

Os postbacks permitem que as equipes de marketing acompanhem com precisão o desempenho de campanhas, otimizem estratégias de aquisição e atribuam corretamente os resultados aos canais e campanhas corretos mesmo com ferramentas de hospedagem ou análise dos eventos diferentes, mas com a precisão da mesma ferramenta coleta.

Como funciona, o básico.

A funcionalidade de postback permite que o sistema dispare uma requisição HTTP POST para uma URL específica sempre que um evento X ocorrer. Essa requisição inclui dados e parâmetros UTM, facilitando a integração com plataformas de análise e marketing. A implementação dessa funcionalidade garante que os dados de eventos sejam transmitidos de forma automática e em tempo real para a URL alvo, possibilitando o rastreamento preciso e a integração entre diferentes sistemas.

Entendendo as regras: Postback Rules (url)

Permite enviar um evento de volta (Postback) para um URL de destino baseado em:

  1. rota

  2. evento de página e

  3. parâmetros de URL.

Vamos detalhar o que cada parte dessa configuração representa e como ela poderia ser utilizada em uma implementação prática.

Exemplo de regras aplicadas em um payload JSON:

[
  {
    "url_target": "http://localhost:8080/test", // rota alvo para ação
    "utm_case_strategy": "any", // pode ser 'any', 'now', 'before'
    "utm_case_target": {
      "utm_source": "agnostic", // Valores como 'utm_medium' e 'utm_campaign' também podem ser configurados
    },
    "triggedByEvent": "agScriptLoaded", // agScriptLoaded, popstate, load, etc.
    "to_request": {
      "type": "IMAGE", // Pode ser 'IMAGE', 'GET', 'POST', 'PUT', 'DELETE'
      "url": "https://tracking.youragency.com/routeX",
      "add_params": {
        "offer_id": "40",
        "aff_id": "1"
      },
      "pinch": [
        { "from": "utm_case", "item": "utm_source", "name": "utm_source" },
        { "from": "utm_case", "item": "my_name", "name": "customer" },
        { "from": "utm_case", "item": "abc", "name": "paramX" }
      ]
    }
  }
]

Então temos:

Descrição dos componentes das Regras

  • url_target: URL alvo onde o postback deve ser iniciado ou a ação deve ser realizada. É o domínio mais o caminho relativo sem necessadade dos parâmetros de url (querystring).

    • Exemplos:

      • https://www.uol.com.br/esportes ou www.uol.com.br/esportes (para ambos http ou https)

      • https://meusite.com/minhapagina

    • now: aplicado para utilizar apenas os parâmetros de URL quando estão realmente na URL.

    • any: aplicado para ambos os casos, qualquer que seja os parâmetros disponíveis serão utilizados.

  • utm_case_target: Especifica os parâmetros UTM que devem ser atendidos para que a regra seja aplicável.

  • triggedByEvent: Especifica o(s) evento(s) que disparam a regra, como o carregamento de um script ou mudanças de visibilidade sendo eles: DOMContentLoaded, load, popstate, visibilitychange, beforeunload.

  • to_request: Define como a requisição deve ser feita, incluindo o tipo (imagem, GET, POST, etc.), a URL e quaisquer parâmetros adicionais.

    • type: Método da requisição.

    • url: Endereço da requisição. É rota para onde deve ser enviado o postback,

      • Exemplo: https://tracking.youragency.com/aff_goal

    • add_params: Parâmetros adicionais que devem ser incluídos na requisição.

    • pinch: Extração de dados de contexto do AgnosticData (ou "pinching") que são adicionados à requisição.

      • from: De onde os dados devem ser extraídos (e.g., 'utm_case').

      • item: Qual item deve ser extraído.

      • name: Nome sob o qual o item extraído deve ser incluído na requisição. (e pode ser renomeado)

utm_case_strategy: Define a estratégia de quando aplicar a regra consideranto as variáveis em ou exatamente na URL.

before: aplicado para utilizar apenas os parêmtros em histórico independentemente da URL. Lembrando todas as variáveis são armazenadas em histórico até o "reset" dos .

🧰
📃
determinantes
Histórico
Processo de definição para os disparos Postback (útil para integração ou envio de eventos a terceiros)