Source: https://bridgeeme.com/pt/docs/academy/captura-dashboard-api.html

AULA 17 / 30 · Implementação e consentimento

# Dashboard → API: capture a campanha efetiva

Confira links, templates, tenant e falhas de resolução.

Estado deste conteúdo

Guia baseado em documentação e PRs consultados. SDKs/API citados ainda têm alterações em draft; confirmar release e homologação.

[Ver implementação e critérios de aceite →](https://bridgeeme.com/pt/docs/academy/implementacao.html)

PASSO 01

## Alteração da API em draft

O PR API #2 cria captura de links administrados pelo Dashboard com resolução autenticada e mapeamento organização→tenant. Ele está aberto e draft; não representa deploy concluído da API. O Dashboard tem mudanças mergeadas, mas a ponta API ainda requer ativação.

PASSO 02

## UTMs e destino

A captura considera UTMs efetivos de template/link, com valores recebidos na URL tendo prioridade. IDs opacos devem manter caixa e conteúdo. Confirme destino por plataforma e teste query encoding com valores que contenham separadores.

PASSO 03

## Estados operacionais

HEAD não publica captura. Link desconhecido ou pausado retorna 404; ausência de configuração ou falha upstream retorna 503. Registre esses estados sem fabricar uma captura bem sucedida e sem substituir silenciosamente um destino inválido.

PASSO 04

## O que ativar

Deploy da API, segredo compartilhado e mapeamento de tenants são pré-requisitos. Os campos opcionais de consentimento e preservação Google não migram automaticamente clientes legados. Valide captura real e isolamento por organização.

SUA VEZ

## Leve a aula para a prática

Prepare testes GET/HEAD, link pausado, configuração ausente e UTMs de template versus URL.

[Baixar checklist de homologação ↓](https://bridgeeme.com/pt/docs/checklist-homologacao.md)

## Confira o aprendizado

## Documentação e evidências

Consultadas em 03/10/2026. Os exercícios e números desta aula são fictícios.

- [API PR #2 · aberto / draft na revisão ↗](https://github.com/bridgee-ai/bridgee-api/pull/2)
- [API PR #1 · redirect e IDs opacos ↗](https://github.com/bridgee-ai/bridgee-api/pull/1)
- [Dashboard PR #1 · mergeado na revisão ↗](https://github.com/bridgee-ai/dashboard/pull/1)

[Consultar o guia técnico relacionado ↗](https://bridgeeme.com/pt/docs/implementation.html#dns)

[← Aula anterior](https://bridgeeme.com/pt/docs/academy/react-native-deferred.html)[Próxima aula →](https://bridgeeme.com/pt/docs/academy/agente-implementacao.html)