Source: https://bridgeeme.com/es/docs/implementation.html Documentación / Implementación # 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 ↗](https://github.com/bridgee-ai/bridgee-android-sdk) | [bridgee-ejemplo-android ↗](https://github.com/bridgee-ai/bridgee-android-example) | | iOS / Rápido | [bridgee-ios-sdk ↗](https://github.com/bridgee-ai/bridgee-ios-sdk) | [bridgee-ios-ejemplo ↗](https://github.com/bridgee-ai/bridgee-ios-example) | | React Native | [bridgee-react-native-sdk ↗](https://github.com/bridgee-ai/bridgee-react-native-sdk) | [bridgee-react-nativo-ejemplo ↗](https://github.com/bridgee-ai/bridgee-react-native-example) | 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](mailto:contato@bridgee.ai?subject=Onboarding%20t%C3%A9cnico%20Bridgee). 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.