🧑💻 APIs Públicas del Gestor de Anuncios
Las APIs Públicas del Gestor de Anuncios de CRMHUB permiten automatizar campañas publicitarias en Facebook, Google y LinkedIn sin necesidad de interactuar manualmente con la interfaz. Estas herramientas para desarrolladores permiten a las organizaciones construir, gestionar y medir anuncios directamente desde su propio software o flujos de trabajo.
📋 Contenido de este Tutorial
🎯 Propósito principal
🔐 Autenticación
🗂️ Módulos de API disponibles
📈 APIs de reportes
🧭 Pasos clave de implementación
🎯 Propósito Principal
Las APIs funcionan como un conjunto de herramientas para desarrolladores en CRMHUB que permiten que tu software se comunique directamente con el Gestor de Anuncios, habilitando la creación programática de campañas, la gestión de presupuestos, la selección de audiencias, la publicación de anuncios y el reporte de rendimiento en múltiples plataformas.
🔐 Autenticación
Método: autenticación HTTP Bearer usando tokens JWT.
Tipos de token: tokens de Agencia (acceso a múltiples cuentas) o tokens de Subcuenta (acceso a una sola ubicación).
Implementación: los desarrolladores configuran encabezados de token Bearer en cada solicitud a la API.
🗂️ Módulos de API Disponibles
Capacidades de Facebook/Instagram
Creación y actualización de campañas, conjuntos de anuncios y anuncios.
Gestión de audiencias personalizadas y píxeles de conversión.
Búsqueda de opciones de segmentación (ubicación geográfica, intereses).
Operaciones de ciclo de vida de campaña: pausar, reanudar, duplicar, eliminar.
Gestión de formularios de clientes potenciales y formularios de conversación.
Capacidades de Google Ads
Publicación de campañas, grupos de anuncios y anuncios.
Gestión de conversiones y activos creativos.
Búsqueda de ubicación geográfica, ideas de palabras clave e intereses objetivo (afinidad y en el mercado).
Listas de usuarios offline, segmentos de audiencia y audiencias combinadas.
Capacidades de LinkedIn Ads
Operaciones de grupos de campañas de anuncios.
Creación y recuperación de formularios de clientes potenciales.
Búsqueda de facetas de segmentación (ubicación, industria, cargos).
Gestión del estado del anuncio (pausar/reanudar).
📈 APIs de Reportes
Todas las plataformas admiten la obtención de métricas estandarizadas, incluyendo Impresiones, Clics, Gasto, Conversiones y métricas relacionadas con conversiones. Los endpoints de reporte específicos por plataforma permiten obtener datos de rendimiento agregados para paneles y para integraciones de analítica.
🧭 Pasos Clave de Implementación
Confirma que el Gestor de Anuncios esté habilitado en las subcuentas.
Genera y almacena de forma segura los tokens de API.
Conecta las cuentas publicitarias mediante las APIs de Integración o desde la interfaz.
Prueba los endpoints básicos de obtención de datos.
Implementa los flujos de automatización específicos de tu negocio.