LinkedIn Ads API: guía para campañas

Mapeá cuentas, campañas y objetos relacionados

Registrá el ID, la moneda, el responsable de facturación, los usuarios y las páginas de empresa asociadas a cada cuenta. Separá la estructura publicitaria de los objetos de medición y segmentación: así evitás mezclar entrega, medición y atribución.

Gestioná tokens OAuth y permisos

Implementá OAuth 2.0 con autorización del administrador; no uses client credentials. Redirigí al administrador a LinkedIn, intercambiá el código en el servidor y validá la cuenta seleccionada. Antes de escribir, probá una lectura.

Revisá los scopes para saber qué acciones permite el acceso: r_ads para consultar cuentas accesibles, r_ads_reporting para recuperar reportes y rw_ads para gestionar cuentas y recursos habilitados. El scope no cambia el rol en la cuenta: comprobá ese rol mediante adAccountUsers y verificá el permiso que exige cada endpoint.

Guardá tokens y secretos cifrados, separados por entorno y fuera de los logs y del código. Registrá el vencimiento, los scopes, el miembro y las cuentas autorizadas. Usá refresh tokens solo si la aplicación es elegible y los recibe; si no, prepará la reautorización.

Asigná responsables de las credenciales, las claves de cifrado y los roles. Ante una revocación, detené las tareas, invalidá las credenciales cuando sea posible y conservá el registro de auditoría sin incluir el token.

Gestioná versiones, límites y reintentos

El equipo de ingeniería debe centralizar la versión y los encabezados de cada endpoint, paginar las consultas y guardar el progreso. Reintentá solo las fallas temporales, con backoff exponencial, variación aleatoria y un límite de reintentos. Frená ante errores de autenticación, autorización o validación.

Antes de repetir una creación, comprobá si ya se ejecutó. Usá claves de idempotencia únicamente donde estén soportadas.

Mantené logs sin secretos y revisá los avisos de retiro de versiones. Probá las migraciones en una cuenta controlada y validá campos, relaciones y permisos antes de escribir. Conservá la trazabilidad al construir y monitorear campañas.

Creá, verificá y lanzá campañas

Con la cuenta y los objetos ya mapeados, creá la campaña con el URN de la cuenta y, si corresponde, el del grupo. Guardá los identificadores de cuenta, grupo, campaña, creativo, audiencia, formulario y regla de conversión para conciliar resultados.

Definí objetivos, presupuestos, fechas y segmentación

Elegí el objetivo según lo que vas a medir: visitas al sitio, compras, leads o alcance. Ajustá el presupuesto y la segmentación al evento que después vas a atribuir. Configurá la puja según el costo estimado de esa segmentación y definí la programación y el estado de entrega.

Mapeá ubicación, cargo, función y seniority a valores válidos del esquema. Comprobá que las audiencias listas para usar estén disponibles para la cuenta seleccionada y excluí clientes o compradores recientes. Consultá Audience Counts: LinkedIn exige al menos 300 miembros para entregar una campaña.

Separá los datos de cada nivel: la campaña define objetivo, presupuesto, fechas, segmentación y conversiones; el anuncio, formato, texto, CTA, URL e identidad de página.

Mostrá importes como ARS 150.000,00, fechas como 24/10/2026 y horarios como 09:00 ART, pero serializalos según el formato que pide el endpoint. Usá ARS solo si coincide con la moneda de la cuenta.

Antes de activar, asociá las reglas de conversión elegibles y comprobá que pertenezcan a la cuenta correcta.

Creá anuncios y conectá formularios Lead Gen

Subí o referenciá imágenes, videos, documentos u otros assets admitidos por el objetivo. Verificá que se hayan procesado y asociá el creativo con la campaña y la página autorizada. Creado no equivale a aprobado: revisá su estado antes de publicar. Agregá UTM estables y comprobá que se mantengan después de las redirecciones.

Para Lead Gen Forms, recuperá el formulario por ID y revisá las preguntas, el consentimiento y la URL de la política de privacidad. Lead Sync requiere una aprobación independiente. Sincronizá las respuestas con el CRM y usá el ID de respuesta para evitar duplicados. Guardá formulario, campaña, creativo, consentimiento, fecha de envío e ID de CRM.

Verificá las campañas antes del lanzamiento

Antes de activar, confirmá permisos, facturación, compatibilidad entre objetivo y formato, audiencia elegible, anuncios aprobados y asociaciones de conversión y formulario. Probá las URLs HTTPS, el funcionamiento en dispositivos móviles y la conservación de los parámetros UTM. Validá tipos, URN, fechas y encabezados del payload. Conservá las respuestas y los request IDs.

Validá antes de publicar para evitar gastos con URN equivocados, formatos incompatibles o fallas de medición.

Lanzá pocas campañas con presupuesto controlado y monitoreá gasto, impresiones, errores y recepción de leads o compras. Aumentá la inversión solo cuando la entrega y la medición funcionen. No repitas creaciones cuyo resultado todavía no confirmaste. Con la campaña activa, completá la conexión de conversiones y audiencias para medir atribución e ingresos.

Conectá datos de conversiones, audiencias y productos

Separá los datos en tres flujos: conversiones para medir, audiencias para activar o excluir y productos para landings o creatividades. Cada uno requiere sus propios permisos. Con esa base, podés cruzar la atribución con el gasto y las ventas.

Configurá reglas de conversión y envío de eventos

Definí las reglas según el resultado y la fuente. Vinculá los eventos de la tienda solo con tipos admitidos: un checkout iniciado no es una compra confirmada.

Insight Tag mide desde el navegador. Conversions API recibe actividad online y offline desde el servidor y requiere acceso aprobado. Antes de enviar datos, validá estos campos contra la versión del endpoint:

Creá audiencias y actualizá exclusiones

Matched Audiences usa contactos, empresas y señales de retargeting elegibles. Su API requiere aprobación y rw_dmp_segments. Para el retargeting web, también tenés que configurar y verificar Insight Tag y sus reglas en Campaign Manager.

Normalizá los identificadores admitidos y comprobá que el segmento esté listo. La coincidencia puede demorar y los umbrales dependen del producto. Registrá el tamaño final, los rechazos y la fecha de la última sincronización.

Actualizá altas y bajas de forma incremental. Ante una compra, baja o eliminación, retirá al contacto del segmento. No vuelvas a cargar un contacto eliminado para mantener una exclusión sin base legal. Dejá las exclusiones listas antes de medir resultados.

Verificá la disponibilidad de catálogos y feeds

Un feed de tienda no prueba que haya un catálogo publicitario habilitado en LinkedIn. Antes de desarrollar el conector, verificá la función habilitada, los endpoints, el esquema, los formatos, las aprobaciones, la región y la elegibilidad.

Confirmá qué atributos se admiten: no des por hecho que ID, título, URL, imagen, precio, moneda, stock y variantes son campos universales. Si el catálogo no está habilitado, podés usar esos datos en landings y creatividades propias admitidas, sin prometer anuncios de catálogo.

Protegé los datos comerciales y las conversaciones

Aplicá minimización de datos, acceso por rol, cifrado, plazos de conservación y borrado sincronizado. El hash no elimina las obligaciones de privacidad. Revisá la Ley 25.326, las condiciones de las plataformas y las garantías o excepciones aplicables a las transferencias internacionales.

Compartí solo los campos necesarios y definí qué sistema conserva el consentimiento y procesa las bajas. Usá los datos normalizados para comparar la atribución con los ingresos.

Leé reportes y conciliá ingresos

Con las conversiones activas, el siguiente paso es conectar gasto, atribución y ventas.

Consultá y guardá reportes de rendimiento

Usá adAnalytics por cuenta, campaña o creativo. Analytics admite un pivote y Statistics, hasta tres. Definí los filtros, el rango de fechas y la granularidad: diaria, semanal o mensual.

Pedí las métricas con fields. Sin ese parámetro, la respuesta solo incluye impresiones y clics. Podés solicitar hasta 20 métricas, pero verificá que sean compatibles con los pivotes elegidos.

Guardá date, account_id, campaign_id, creative_id, pivot_values, moneda, zona horaria y fecha de actualización, junto con la versión y los parámetros de consulta. Volvé a consultar los últimos 7 o 14 días y hacé upsert por fecha, cuenta, pivote y métrica. Tratá los datos de las últimas 72 horas como preliminares. Con esa información guardada, compará LinkedIn con las ventas reales del e-commerce.

Compará las métricas de LinkedIn con los ingresos de la tienda

Al conciliar, separá evento recibido, conversión atribuida, pedido confirmado e ingreso incremental: no miden lo mismo. Contrastá la atribución de LinkedIn con las ventas confirmadas del e-commerce.

Para calcular los indicadores, usá estas fórmulas:

• CPA atribuido = gasto / conversiones atribuidas.
• ROAS = ingreso atribuido / gasto.
• Tasa de conversión = conversiones / clics o pedidos / sesiones.
• Ticket promedio = ingreso neto / pedidos.

Alineá las ventanas y las fechas en America/Argentina/Buenos_Aires. Si convertís USD a ARS, registrá la fuente, la cotización y la fecha del tipo de cambio aprobado por Finanzas.

Encontrá las causas de las diferencias

Revisá primero la entrega y los errores de eventos. Después, seguí este orden: IDs de unión, asociación campaña-conversión, ventanas y modelo, duplicados, demoras, moneda y zona horaria. Por último, verificá las cancelaciones y los reembolsos.

Guardá una fila financiera por order_id y mantené una sola fuente de verdad financiera. Conservá las atribuciones como vistas separadas: no sumes ingresos atribuidos por distintos canales si corresponden al mismo pedido. Revisá todos los días los casos sin conciliar.

Mejorá las campañas y mantené la integración

Con los reportes ya conciliados, usá los datos para decidir qué corregir primero.

Priorizá cambios de audiencia, anuncios y presupuesto

Revisá los resultados en este orden: entrega → gasto → calidad de leads → ventas → margen. Empezá por las fallas de entrega: anuncios rechazados, campañas sin gasto y audiencias demasiado chicas.

Si gastás mucho y conseguís pocos leads calificados, revisá la segmentación y la oferta. Si los leads son buenos, pero hay pocas ventas, revisá el seguimiento comercial. Si las compras dejan un margen de contribución negativo, ajustá el presupuesto o la oferta. No elijas un anuncio solo por su tasa de clics: mirá también la calidad de los leads, las ventas y el margen.

Probá una variable importante por vez - audiencia, imagen, mensaje u oferta - y mantené un anuncio de control. En adquisición, excluí a compradores existentes y leads ya convertidos. Registrá la versión de cada audiencia y su última sincronización exitosa.

Compará períodos equivalentes y cohortes que ya tuvieron tiempo de convertir. Un día malo no alcanza para pausar un anuncio; unas pocas conversiones tampoco alcanzan para escalarlo.

Antes de escalar, definí los requisitos: volumen mínimo validado, CPL dentro del objetivo y margen positivo. Fijá un tope de gasto y una condición para revertir el cambio. Separá adquisición de seguimiento y medí tiempo de respuesta, contacto y cierre. Para comprobar ventas incrementales, usá un grupo de control comparable cuando sea viable: la atribución de LinkedIn no demuestra causalidad.

Asigná responsables de monitoreo y mantenimiento

Una vez definidos los cambios, repartí las tareas para sostenerlos. Asigná un titular y un suplente por control:

• Growth: decisiones de campaña, ritmo de gasto y experimentos.
• Ingeniería: medición e integración; tokens OAuth, errores, límites, reintentos y entrega de eventos. También debe ejecutar la migración de versión antes de cada retiro.
• Analytics: lectura de resultados y reportes completos y actualizados.
• Operaciones comerciales: asignación, respuesta y cierre de leads.
• Finanzas o e-commerce: margen, cancelaciones y devoluciones.

Revisá gasto, errores y leads a diario; pruebas y pendientes, cada semana.

Dejá claro cuándo escalar un problema, a quién avisar y qué permisos tiene cada equipo. Las fallas de autenticación o el riesgo de eventos duplicados requieren aviso inmediato a Ingeniería. Si el gasto supera el ritmo planificado, avisá a Growth dentro de una hora hábil.

Si faltan reportes o eventos, bloqueá los aumentos automáticos hasta resolver el problema. Usá las recomendaciones para iniciar una revisión, pero exigí aprobación humana para subir presupuestos, ampliar segmentaciones o pausar campañas. Guardá quién aprobó el cambio, la fecha, el valor anterior y el nuevo, el motivo, la respuesta de la API y la condición de reversión.

Conclusión: checklist de lanzamiento y mantenimiento

Antes de habilitar el gasto, confirmá que LinkedIn encaje con tu objetivo, audiencia, ticket promedio, ciclo de venta y madurez de medición. Verificá el acceso aprobado a Marketing APIs, la autorización OAuth del administrador y el mapeo completo de la cuenta, la campaña y los activos.

Control de lanzamiento: revisá objetivo, puja, presupuesto diario o total, moneda, fechas, zona horaria, exclusiones, anuncios aprobados y URLs con UTM. Si corresponde, comprobá también el estado del catálogo o feed. Para operar en Argentina, normalizá los importes en ARS y configurá America/Argentina/Buenos_Aires. Empezá con un presupuesto acotado y definí de antemano cuándo frenar el gasto.

Control de medición: validá la regla de conversión, las campañas asociadas y la aceptación de un evento de prueba con consentimiento. Comprobá que el identificador sea estable y que la deduplicación funcione entre navegador, servidor y reintentos. Registrá el order_id junto con el evento.

Control de ingresos: conciliá la primera ventana de reportes con los pedidos confirmados, usando la misma moneda y zona horaria. Separá la atribución por clic de la atribución por visualización. Los ingresos atribuidos por LinkedIn no equivalen automáticamente a ingresos netos.

Mantenimiento: agendá controles diarios de gasto, entrega y errores; semanales de audiencias, catálogos, URLs rotas y conciliación; y mensuales de OAuth, permisos y versión de API. Registrá cuándo verificaste los endpoints y permisos: las audiencias, los catálogos y los reportes dependen del acceso real y de la documentación vigente.

FAQs

¿Cuándo me conviene usar la API en lugar de Campaign Manager?

Campaign Manager sirve para la gestión publicitaria básica. La API te conviene cuando necesitás conectar el rendimiento de los anuncios con las ventas reales, el margen, el CRM y el stock para seguir el recorrido de cada resultado.

Ese cruce de datos permite evitar el sesgo de atribución de la plataforma, que suele adjudicarse conversiones hasta 30 días después del clic. Además, podés tomar decisiones diarias con datos sincronizados en tiempo real y medir el retorno por segmento.

¿Cómo concilio ventas que se cierran semanas después del clic?

No te quedes solo con el ROAS de LinkedIn. Definí un modelo y una ventana de atribución consistentes: hasta 30 días posclic y 7 días posimpresión. Cruzá los datos con el CRM, la tienda y los pedidos para no atribuirle a LinkedIn más ventas de las que le corresponden.

Medí también la atribución asistida: dividí las rutas en las que LinkedIn participó como asistencia por el total de rutas. Después, revisá la rentabilidad de cada segmento: ganancia bruta atribuida menos costo. Evitá contar una misma venta dos veces o usar ventanas demasiado largas.

¿Qué hago si pierdo acceso a la API con campañas activas?

Primero, verificá el estado de la integración y la tasa de errores de conexión. Revisá si hay tokens vencidos, si se alcanzaron los límites de tasa o si hay errores de sincronización.

Si el flujo de datos se corta, tus análisis pueden quedar incompletos y afectar las decisiones sobre presupuesto o audiencias. La sincronización en tiempo real te ayuda a detectar fallas y hacer ajustes sin frenar la operación.