Implementación

Arquitectura

Un producto, tres capas independientes

núcleo

Atribución Bridgee

Link y Blink conservan el origen; el SDK soluciona la instalación; el canal llega a Firebase/GA4.

Calidad

Inteligencia de tráfico

CTIT, repetición, profundidad del recorrido y puntuación de confianza con componentes y códigos de motivo.

físico

Inteligencia Física

Las cámaras y sensores generan recuentos agregados, ocupación, permanencia y cohortes.

flujo animado

Del clic al canal en el GA4

Siga la atribución desde el clic hasta la entrega en GA4.

1. Haga clicBlink conserva los ID y UTM permitidos.

2. InstalaciónSDK realiza el partido.

3. DecisiónCódigos de método, confianza y razón.

4. Firebase/GA4Canal entregado sin duplicación.

Empieza aquí

Lista de verificación de implementación

Crear inquilino y entorno de prueba

Definir dominios, destinos, ventanas, consentimiento y contactos técnicos.

Configurar CNAME y Blink

Utilice HTTPS, lista de parámetros permitidos y una URL de prueba por plataforma.

Instale el SDK

Android, iOS o React Native; realice la primera apertura únicamente según el ciclo documentado.

Validar la decisión

Verifique el método de coincidencia, la confianza, la versión de la decisión, los códigos de motivo y la idempotencia.

Validar Firebase/GA4

Garantice la entrega de una atribución única y conserve la atribución nativa de Google.

Incorporación técnica

Credenciales e información requerida

Cada cliente recibe un Tenant ID y un Tenant Key para autenticar solicitudes de conciliación. Durante la incorporación, proporcione la empresa, los enlaces de la tienda de aplicaciones, los propietarios técnicos y los dominios Blink.

Problema individual

Las credenciales están separadas por inquilino y entorno. La producción y las pruebas no comparten ningún secreto.

Entrega segura

Las claves se envían a través de un canal autenticado, nunca en un ticket público, análisis o código de ejemplo.

Rotación

Planifique la propiedad, el vencimiento, la revocación y la rotación sin interrumpir la aplicación.

Contacto que figura en la documentación heredada: bridgee@caaqui.com. Antes de la producción, confirme el SLA y el contacto operativo durante la incorporación.

Servidor Blink

Dominios, CNAME, TLS y validación

El diseño documentado utiliza subdominios controlados por el cliente para iOS y Android. Elija nombres cortos y reconocibles como ios.suaempresa.com.br mi android.suaempresa.com.br.

Tipo	anfitrión de ejemplo	Destino documentado	TTL	Plataforma
CNOMBRE	`ios.suaempresa.com.br`	`blink.bridgee.ai`	300	iOS
CNOMBRE	`android.suaempresa.com.br`	`blink.bridgee.ai`	300	Android

confirmar el punto final final recibido en la incorporación antes de cambiar el DNS;
validar la propagación con dig tu nslookup;
el flujo heredado proporciona aprovisionamiento TLS por parte de Bridgee después de la confirmación de los hosts;
probar HTTPS, redireccionamiento, parámetros incluidos en la lista permitida y destino para cada plataforma;
No publique enlaces de campaña antes del enrutamiento y la validación del certificado.

SDK y ejemplos

Implementaciones oficiales del Bridgee

Los SDK y las aplicaciones de muestra a continuación se mantienen en la organización oficial. bridgee-ai. Los enlaces abren GitHub en una nueva pestaña.

Plataforma	Oficial SDK	Aplicación de muestra
Android/Kotlin	bridgee-android-sdk ↗	bridgee-ejemplo-android ↗
iOS / Rápido	bridgee-ios-sdk ↗	bridgee-ios-ejemplo ↗
React Native	bridgee-react-native-sdk ↗	bridgee-react-nativo-ejemplo ↗

Para producción, confirme la versión aprobada, la compatibilidad, la suma de verificación de artefactos y las credenciales del entorno en la incorporación. hablar con contato@bridgee.ai.

El ciclo de vida de firstOpen y la API pública debe seguir la versión aprobada del proyecto; valide la aplicación de muestra antes de promover la integración.

Primer acceso

De SDK a Firebase/GA4

En el primer ciclo elegible, SDK inicializa el identificador técnico aprobado, llama al servicio de conciliación y recibe los metadatos de adquisición. Luego, la fuente resuelta se pone a disposición del Firebase/GA4 según el contrato de liberación.

inicialice el SDK una vez en el ciclo documentado;
utilizar las credenciales y el entorno del inquilino correctos;
tratar el éxito, la no coincidencia, el tiempo muerto y la repetición con idempotencia;
validar source, medium, campaign, método y confianza;
preservar la atribución nativa y evitar la entrega duplicada;
confirme en DebugView/test y luego en el informe de adquisición.

Contrato neutral

Identificadores aceptados

Socio	evidencia	regla
Google	`gclid`, `gbraid`, `market_referrer_gclid`	Preserva el flujo nativo y evita la duplicación.
Meta	`fbclid` o carga útil aprobada	Mantener opaco; La devolución de datos requiere un contrato aprobado.
TikTok	`ttclid` o carga útil aprobada	Enrutamiento configurado por inquilino.
DSP	macro en `partner_click_id`	No existe una macro universal.
Bridgee	`bridgee_click_id`, `bridgee_install_id`	Correlación seudónima; nunca la identidad de una persona.

SDK

Respuesta de coincidencia versionada

{
  "utm_source": "tiktok",
  "utm_medium": "paid_social",
  "utm_campaign": "launch",
  "attribution": {
    "resolved_partner": "tiktok",
    "evidence_type": "ttclid",
    "match_method": "deterministic",
    "match_confidence": 1.0,
    "partner_conflict": false,
    "decision_version": "partner-routing/1.0.0"
  }
}

Las identificaciones distinguen entre mayúsculas y minúsculas y son opacas. Nunca elijas un canal basándose en una prioridad comercial; Los conflictos se auditan y suprimen la devolución de datos.

Calidad

Web, app y ausencia de GTM

Web+GTM

Punto de control habilitado con tiempo activo, profundidad, secuencia y clave idempotente. El navegador no calcula puntuaciones.

Aplicación+BigQuery

Vista autorizada de eventos nativos de Firebase. No recoge compras.

Aplicación sin acceso

Empuje de servidor a servidor, puntos de control SDK o estado de comportamiento no disponible.

contrato session-quality/1.0.0: evidencia bruta incluida en la lista permitida → validación y deduplicación del servidor → características explicables → antifraude versionado y Trust Score. Revocar analytics_storage detiene la recolección y borra el estado local.

Privacidad y funcionamiento

Puertas antes de la producción.

consentimiento y propósito por región;
sin IP sin procesar, PII o secretos en análisis;
retención y eliminación por inquilino;
pruebas de contrato Android, iOS, React Native y API;
puntuación sombra antes de afectar las decisiones;
reversión por indicador de característica.