Uso de la API de Google Ads
Última actualización: 26 de mayo de 2026
Quiénes somos
Kivolaro es un studio de software a medida y automatización con IA. Ayudamos a clientes (y a nosotros mismos) a reemplazar operaciones basadas en planillas por herramientas integradas. El Kivolaro Studio es nuestra aplicación interna de administración en studio.kivolaro.com, usada únicamente por personal de Kivolaro — no hay registro público ni acceso de terceros.
Cómo usamos la API de Google Ads
El Studio se integra con la API de Google Ads con un único propósito: leer las métricas diarias de rendimiento de las campañas de Google Ads que corremos en nuestra propia cuenta publicitaria (impresiones, clicks, costo, conversiones, cantidad de leads), y subir de vuelta conversiones offline cuando un lead generado por una campaña cierra como cliente pago.
La integración NO:
- Gestiona campañas ni budgets en nombre de terceros.
- Provee reportería a clientes externos.
- Revende acceso a la API ni expone endpoints fuera de Kivolaro.
- Usa los datos para publicidad distinta a nuestro propio marketing analytics.
Scopes de OAuth solicitados
https://www.googleapis.com/auth/adwords— necesario para llamar a la API. Usado en modo lectura para traer métricas y en modo escritura solo para subir conversiones offline a nuestra propia cuenta.
Datos que leemos
De nuestra cuenta propia de Google Ads, en cadencia diaria:
- ID de campaña, nombre, estado, daily budget.
- Impresiones, clicks y costo (USD) por día y por campaña.
- Conteo de conversiones atribuidas a cada campaña.
No solicitamos información identificable de usuarios finales. La atribución a nivel lead vive en nuestro CRM propio (Firestore), identificado por gclid / wbraid / gbraid anónimos que Google provee para medición.
Datos que escribimos
- Upload de conversiones offline vía
conversionUploadServicecuando una propuesta de Kivolaro cierra como proyecto pago. Payload: conversion_action, conversion_date_time, conversion_value (USD), y el gclid del lead original. Sin PII.
Dónde viven los datos
- Almacenados en Google Cloud Firestore (proyecto
kivolaro-studio) en coleccionesgrowth_campaigns,growth_campaign_daily_metricsygrowth_offline_conversion_queue. - Retención: indefinida mientras la campaña esté activa. Filas archivadas se preservan para auditoría.
- Control de acceso: lectura/escritura restringida a operadores autorizados de Kivolaro, autenticados vía Firebase Auth con allow-list de emails (actualmente:
facundoluism@gmail.com— cuenta operativa del operador de Kivolaro). Credenciales de service account guardadas en Google Secret Manager, jamás en código.
Seguridad
- Solo HTTPS con HSTS, X-Frame-Options DENY, Referrer-Policy estricta.
- Refresh tokens de OAuth en Google Secret Manager (alcance del proyecto).
- Ningún dato se comparte con terceros, brokers, ni se revende.
- Respuesta a incidentes: hello@kivolaro.com.
Derechos de los usuarios
El Studio es operado exclusivamente por personal de Kivolaro. Los derechos sobre métricas que originan en Google Ads se rigen por los términos de la plataforma de Google; sobre leads o contactos comerciales guardados en nuestro CRM, por nuestra Política de privacidad y los derechos GDPR/CCPA enumerados ahí.
Contacto de cumplimiento
Preguntas sobre esta integración: hello@kivolaro.com.