Herramientas de LinkedIn Ads
Grupos de campañas, campañas, contenido patrocinado, anuncios de texto, segmentación e informes demográficos.
La integración de este canal está lista; la conexión se abrirá cuando la plataforma apruebe nuestra aplicación de desarrollador. Hasta entonces no se pueden conectar cuentas y las acciones descritas en esta página no están disponibles.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.
Herramientas de lectura16 herramientas
list_linkedin_accounts
Lectura1 créditosCuentas publicitarias de LinkedIn a las que puede acceder el usuario conectado (id, nombre, moneda, estado, estado de publicación, referencia a la página de empresa). Agencias: elige account_id para las demás herramientas. Solo lectura; devuelve connected=false si no hay cuenta vinculada.
Esta herramienta no recibe parámetros.
list_linkedin_campaign_groups
Lectura1 créditosGrupos de campañas de una cuenta publicitaria de LinkedIn con estado, estados de publicación, objetivo, presupuesto total/diario y calendario. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
statusesOpcional | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED (por defecto los cuatro) |
list_linkedin_campaigns
Lectura1 créditosCampañas de LinkedIn con estado, objetivo, tipo, presupuesto diario/total, puja, moneda, grupo de campañas y segmentación. Devuelve urn y ledger_campaign_id para usar con las herramientas de actualización. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
campaign_groupOpcional | string | filtrar por urn o id del grupo de campañas |
statusesOpcional | array<string> | ACTIVE | PAUSED | DRAFT | COMPLETED | ARCHIVED | CANCELED |
sync_ledgerOpcional | boolean | importar también las campañas al libro de Tecrübe (por defecto true) |
list_linkedin_creatives
Lectura1 créditosCreatividades (anuncios) de campañas de LinkedIn: estado previsto, estado de publicación y motivos de retención, estado de revisión y los motivos de rechazo de LinkedIn (review_rejection_reasons), publicación referenciada o campos del anuncio de texto. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
campaign_idsOpcional | array<string> | urns/ids de campaña; por defecto: todas las campañas activas/pausadas/borrador |
statusesOpcional | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED | CANCELED |
limitOpcional | integer (1–100) | — |
linkedin_performance_report
Lectura2 créditosAnalíticas de anuncios de LinkedIn para un rango de fechas: gasto, impresiones, clics, CTR, CPC, CPM, aperturas de formulario, leads, conversiones web, valor de conversión, coste por lead (CPL) y coste por conversión por campaña / grupo de campañas / creatividad / cuenta, más totales y las filas con 500+ impresiones y cero conversiones. Solo cifras reales; nunca inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
daysOpcional | integer (1–366) | últimos N días incl. hoy (por defecto 30) |
start_dateOpcional | string | YYYY-MM-DD (prevalece sobre days) |
end_dateOpcional | string | YYYY-MM-DD |
pivotOpcional | CAMPAIGN | CAMPAIGN_GROUP | CREATIVE | ACCOUNT | — |
campaign_idsOpcional | array<string> | limitar a estos urns/ids de campaña (obligatorio para nombres de creatividad con pivot=CREATIVE) |
campaign_group_idsOpcional | array<string> | — |
time_granularityOpcional | ALL | DAILY | — |
sort_byOpcional | cpl | spend | impressions | clicks | leads | conversions | ctr | — |
linkedin_demographics_report
Lectura2 créditosDemografía profesional de LinkedIn de quienes vieron, hicieron clic y convirtieron en tus anuncios: cargo, nivel, función, sector, tamaño de empresa y país (pivotes MEMBER_* de adAnalytics) con impresiones, clics, CTR, gasto, leads, CPL y conversiones web; los URN se resuelven a nombres legibles. Cada dimensión informa de la parte oculta por el umbral de privacidad de LinkedIn (los valores con menos de 3 eventos se descartan) en lugar de inventar filas. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
pivotsOpcional | array<MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2> | por defecto: las seis |
pivotOpcional | MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2 | — |
daysOpcional | integer (1–366) | últimos N días incl. hoy (por defecto 30) |
start_dateOpcional | string | YYYY-MM-DD (prevalece sobre days) |
end_dateOpcional | string | YYYY-MM-DD |
campaign_idsOpcional | array<string> | limitar a estos urns/ids de campaña |
campaign_group_idsOpcional | array<string> | — |
limitOpcional | integer (1–100) | filas por dimensión (por defecto 25, por impresiones) |
locale_languageOpcional | string | idioma de los nombres, por defecto en |
locale_countryOpcional | string | por defecto US |
build_linkedin_audience
Lectura2 créditosResuelve una segmentación en lenguaje natural (cargos, empresas, sectores, tamaños de empresa, ubicaciones, niveles, funciones, aptitudes) a facetas de segmentación de LinkedIn y devuelve targetingCriteria más el tamaño estimado de la audiencia. Descarta las combinaciones de facetas que LinkedIn rechaza y lo indica. Solo lectura; pasa targeting_criteria a create_linkedin_campaign o update_linkedin_campaign_targeting.
| Parámetro | Tipo | Descripción |
|---|---|---|
titlesOpcional | array<string> | cargos, p. ej. Marketing Manager |
industriesOpcional | array<string> | — |
locationsOpcional | array<string> | ciudades / regiones / países, p. ej. Istanbul, Turkey (LinkedIn exige al menos una) |
company_sizesOpcional | array<string> | p. ej. '200+', '51-200', '1001+' |
senioritiesOpcional | array<string> | — |
job_functionsOpcional | array<string> | — |
skillsOpcional | array<string> | — |
employersOpcional | array<string> | nombres de empresa (no combinable con industries / company_sizes) |
companiesOpcional | array<string> | Alias of employers |
exclude_titlesOpcional | array<string> | — |
exclude_employersOpcional | array<string> | — |
exclude_industriesOpcional | array<string> | — |
interface_localesOpcional | array<string> | p. ej. urn:li:locale:en_US, urn:li:locale:tr_TR (por defecto en_US) |
locale_languageOpcional | string | idioma de búsqueda, por defecto en |
locale_countryOpcional | string | por defecto US |
estimateOpcional | boolean | obtener el recuento de audiencia (por defecto true) |
list_linkedin_posts
Lectura1 créditosÚltimas publicaciones de la página de empresa (urn, texto, tipo de contenido, fecha de publicación, indicador de patrocinio) para elegir una en create_linkedin_sponsored_content. Requiere el ámbito r_organization_social; si no, devuelve una nota. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
organization_urnOpcional | string | urn:li:organization:{id}; por defecto: la página de empresa de la cuenta publicitaria |
countOpcional | integer (1–100) | — |
linkedin_targeting_search
Lectura1 créditosBusca por nombre entidades de segmentación de LinkedIn dentro de una faceta (typeahead de adTargetingEntities / lista de la faceta) y devuelve sus URN y nombres. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
queryOpcional | string | nombre que buscar; vacío lista toda la faceta (seniorities, jobFunctions, staffCountRanges) |
facetOpcional | titles | industries | locations | employers | skills | seniorities | jobFunctions | staffCountRanges | por defecto titles |
locale_languageOpcional | string | por defecto en |
locale_countryOpcional | string | por defecto US |
linkedin_audience_forecast
Lectura1 créditosEstima a cuántos miembros de LinkedIn alcanza una segmentación (audienceCounts): miembros totales y activos, con avisos por debajo del mínimo de 300 miembros o sin ubicación. Acepta targeting_criteria, listas de URN por faceta o la segmentación guardada de una campaña. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
targeting_criteriaOpcional | object | JSON targetingCriteria exactamente como lo devuelve build_linkedin_audience |
campaign_idOpcional | string | usa la segmentación guardada de esta campaña cuando no se indica otra |
geo_urnsOpcional | array<string> | URN de la faceta locations (linkedin_targeting_search) |
job_title_urnsOpcional | array<string> | URN de la faceta titles (linkedin_targeting_search) |
job_function_urnsOpcional | array<string> | URN de la faceta jobFunctions (linkedin_targeting_search) |
seniority_urnsOpcional | array<string> | URN de la faceta seniorities (linkedin_targeting_search) |
industry_urnsOpcional | array<string> | URN de la faceta industries (linkedin_targeting_search) |
skill_urnsOpcional | array<string> | URN de la faceta skills (linkedin_targeting_search) |
staff_count_urnsOpcional | array<string> | URN de la faceta staffCountRanges (linkedin_targeting_search) |
employer_urnsOpcional | array<string> | URN de la faceta employers (linkedin_targeting_search) |
include_audience_urnsOpcional | array<string> | URN de la faceta audienceMatchingSegments (linkedin_targeting_search) |
exclude_geo_urnsOpcional | array<string> | URN de la faceta locations (linkedin_targeting_search) |
exclude_title_urnsOpcional | array<string> | URN de la faceta titles (linkedin_targeting_search) |
exclude_function_urnsOpcional | array<string> | URN de la faceta jobFunctions (linkedin_targeting_search) |
exclude_seniority_urnsOpcional | array<string> | URN de la faceta seniorities (linkedin_targeting_search) |
exclude_industry_urnsOpcional | array<string> | URN de la faceta industries (linkedin_targeting_search) |
exclude_skill_urnsOpcional | array<string> | URN de la faceta skills (linkedin_targeting_search) |
exclude_staff_count_urnsOpcional | array<string> | URN de la faceta staffCountRanges (linkedin_targeting_search) |
exclude_employer_urnsOpcional | array<string> | URN de la faceta employers (linkedin_targeting_search) |
exclude_audience_urnsOpcional | array<string> | URN de la faceta audienceMatchingSegments (linkedin_targeting_search) |
location_modeOpcional | recent_or_permanent | permanent | recent_or_permanent (por defecto, faceta locations) o permanent (faceta profileLocations) |
audience_languageOpcional | string | configuración regional de la interfaz, p. ej. en_US, tr_TR o urn:li:locale:tr_TR (por defecto en_US) |
linkedin_bid_recommendations
Lectura1 créditosPuja sugerida por LinkedIn, puja mínima/máxima y límites de presupuesto diario para una audiencia (adBudgetPricing criteriaV2), en la moneda de la cuenta publicitaria. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
campaign_typeOpcional | SPONSORED_UPDATES | TEXT_AD | SPONSORED_INMAILS | — |
bid_typeOpcional | CPM | CPC | CPV | — |
objective_typeOpcional | string | p. ej. WEBSITE_VISIT, LEAD_GENERATION, BRAND_AWARENESS, WEBSITE_CONVERSION, VIDEO_VIEW, ENGAGEMENT |
optimization_targetOpcional | string | p. ej. MAX_CLICK, MAX_LEAD, MAX_CONVERSION, NONE |
daily_budgetOpcional | number | moneda de la cuenta; afina la sugerencia |
audience_expansionOpcional | boolean | — |
targeting_criteriaOpcional | object | JSON targetingCriteria exactamente como lo devuelve build_linkedin_audience |
campaign_idOpcional | string | usa la segmentación guardada de esta campaña |
geo_urnsOpcional | array<string> | URN de la faceta locations (linkedin_targeting_search) |
job_title_urnsOpcional | array<string> | URN de la faceta titles (linkedin_targeting_search) |
job_function_urnsOpcional | array<string> | URN de la faceta jobFunctions (linkedin_targeting_search) |
seniority_urnsOpcional | array<string> | URN de la faceta seniorities (linkedin_targeting_search) |
industry_urnsOpcional | array<string> | URN de la faceta industries (linkedin_targeting_search) |
skill_urnsOpcional | array<string> | URN de la faceta skills (linkedin_targeting_search) |
staff_count_urnsOpcional | array<string> | URN de la faceta staffCountRanges (linkedin_targeting_search) |
employer_urnsOpcional | array<string> | URN de la faceta employers (linkedin_targeting_search) |
include_audience_urnsOpcional | array<string> | URN de la faceta audienceMatchingSegments (linkedin_targeting_search) |
exclude_geo_urnsOpcional | array<string> | URN de la faceta locations (linkedin_targeting_search) |
exclude_title_urnsOpcional | array<string> | URN de la faceta titles (linkedin_targeting_search) |
exclude_function_urnsOpcional | array<string> | URN de la faceta jobFunctions (linkedin_targeting_search) |
exclude_seniority_urnsOpcional | array<string> | URN de la faceta seniorities (linkedin_targeting_search) |
exclude_industry_urnsOpcional | array<string> | URN de la faceta industries (linkedin_targeting_search) |
exclude_skill_urnsOpcional | array<string> | URN de la faceta skills (linkedin_targeting_search) |
exclude_staff_count_urnsOpcional | array<string> | URN de la faceta staffCountRanges (linkedin_targeting_search) |
exclude_employer_urnsOpcional | array<string> | URN de la faceta employers (linkedin_targeting_search) |
exclude_audience_urnsOpcional | array<string> | URN de la faceta audienceMatchingSegments (linkedin_targeting_search) |
location_modeOpcional | recent_or_permanent | permanent | recent_or_permanent (por defecto, faceta locations) o permanent (faceta profileLocations) |
audience_languageOpcional | string | configuración regional de la interfaz, p. ej. en_US, tr_TR o urn:li:locale:tr_TR (por defecto en_US) |
list_linkedin_audiences
Lectura1 créditosAudiencias coincidentes (segmentos de anuncios, adSegments) de una cuenta publicitaria de LinkedIn: listas subidas, retargeting del sitio web, automatización de marketing y audiencias predictivas, con estado y número aproximado de miembros. Usa el urn en la segmentación (include_audience_urns). Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
typesOpcional | array<string> | BULK | RETARGETING | MARKET_AUTOMATION | BUSINESS_OBJECTIVE_BASED_AUDIENCE |
statusesOpcional | array<string> | BUILDING | READY | UPDATING | FAILED | ARCHIVED | EXPIRED … |
list_linkedin_conversions
Lectura1 créditosReglas de seguimiento de conversiones de una cuenta publicitaria de LinkedIn (conversions q=account): id, nombre, tipo, activada, ventanas de atribución, valor y campañas vinculadas. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
list_linkedin_lead_forms
Lectura1 créditosLead Gen Forms de una cuenta publicitaria de LinkedIn (leadForms q=owner): id, nombre, estado, versión y número de preguntas. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
download_linkedin_leads
Lectura2 créditosClientes potenciales enviados a través de los Lead Gen Forms de LinkedIn (leadFormResponses): hora de envío, campaña, creatividad, todas las respuestas y consentimientos. Datos personales: úsalos dentro del consentimiento del formulario. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
form_idOpcional | string | id del formulario de clientes potenciales (list_linkedin_lead_forms); asocia las respuestas a los nombres de las preguntas |
sinceOpcional | string | YYYY-MM-DD |
untilOpcional | string | YYYY-MM-DD (por defecto hoy) |
test_onlyOpcional | boolean | — |
limitOpcional | integer (1–1000) | — |
linkedin_ad_copy
Lectura1 créditosLee el texto real de los anuncios de LinkedIn: título/descripción/página de destino de un anuncio de texto, o el texto, título del artículo, página de destino y llamada a la acción de la publicación patrocinada. Solo lectura; combínalo con linkedin_performance_report para comparar mensajes.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
creative_idsOpcional | array<string> | urn/id de creatividades |
post_urnsOpcional | array<string> | urn:li:share / urn:li:ugcPost |
Herramientas de escritura20 herramientas
create_linkedin_campaign_group
Escritura2 créditosCrea un grupo de campañas de LinkedIn (pausado por defecto). Devuelve una vista previa y abre un elemento de aprobación; se crea en LinkedIn solo tras la aprobación y solo con una cuenta conectada.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
statusOpcional | ACTIVE | PAUSED | DRAFT | por defecto PAUSED |
daily_budgetOpcional | number | moneda de la cuenta; presupuesto dinámico compartido por las campañas del grupo |
total_budgetOpcional | number | moneda de la cuenta; requiere end_date |
end_dateOpcional | string | YYYY-MM-DD |
objectiveOpcional | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | — |
bid_strategyOpcional | MAXIMUM_DELIVERY | MANUAL | COST_CAP | — |
currencyOpcional | string | ISO currency for the preview when the ad account currency is unknown |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_linkedin_campaign
Escritura2 créditosCrea una campaña de LinkedIn (contenido patrocinado o anuncio de texto) con presupuesto, objetivo, puja y segmentación de build_linkedin_audience. Escribe un borrador en el libro y abre un elemento de aprobación con vista previa; se crea en LinkedIn (pausada por defecto) tras la aprobación. Añade creatividades con create_linkedin_sponsored_content / create_linkedin_text_ad.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
daily_budgetObligatorio | number | moneda de la cuenta |
targeting_criteriaObligatorio | object | JSON targetingCriteria exactamente como lo devuelve build_linkedin_audience |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
campaign_groupOpcional | string | urn/id del grupo de campañas; por defecto: el grupo predeterminado de la cuenta |
objectiveOpcional | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | por defecto WEBSITE_VISITS; LEAD_GENERATION para formularios de leads |
typeOpcional | SPONSORED_UPDATES | TEXT_AD | por defecto SPONSORED_UPDATES |
statusOpcional | PAUSED | ACTIVE | por defecto PAUSED (no se gasta nada hasta reanudar) |
total_budgetOpcional | number | — |
unit_costOpcional | number | puja manual; omitida = puja automática |
cost_typeOpcional | CPC | CPM | — |
locale_countryOpcional | string | — |
locale_languageOpcional | string | — |
organization_urnOpcional | string | página de empresa para contenido patrocinado; por defecto: la referencia de la cuenta publicitaria |
audience_expansionOpcional | boolean | — |
offsite_deliveryOpcional | boolean | LinkedIn Audience Network |
political_intentOpcional | NOT_POLITICAL | POLITICAL | NOT_DECLARED | advertiser's declaration; ask the user and pass NOT_POLITICAL only if they confirm the ad is not political advertising (required before EU targeting goes live). Default NOT_DECLARED |
goalOpcional | string | — |
currencyOpcional | string | ISO currency for the preview when the ad account currency is unknown |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_linkedin_campaign_budget
Escritura2 créditosCambia el presupuesto diario, el presupuesto total y/o la puja de una campaña de LinkedIn. Devuelve una vista previa con los valores actual → nuevo; se aplica tras la aprobación (las reducciones de presupuesto y los aumentos pequeños pueden aplicarse automáticamente según la política de aprobación del usuario).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (uuid) o urn/id de campaña de LinkedIn de list_linkedin_campaigns |
daily_budgetOpcional | number | moneda de la cuenta |
total_budgetOpcional | number | — |
unit_costOpcional | number | puja manual (cambia la campaña a puja manual) |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
currencyOpcional | string | ISO currency for the preview when the ad account currency is unknown |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_linkedin_campaign_status
Escritura2 créditosPausa, reanuda (ACTIVE) o archiva una campaña de LinkedIn. Pasa por vista previa y por la política de aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (uuid) o urn/id de campaña de LinkedIn de list_linkedin_campaigns |
statusObligatorio | ACTIVE | PAUSED | ARCHIVED | — |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_linkedin_campaign_group_status
EscrituraIrreversible2 créditosActiva, pausa, archiva, pasa a borrador o elimina (PENDING_DELETION) un grupo de campañas de LinkedIn. Siempre con vista previa y aprobación previas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_groupObligatorio | string | urn o id del grupo de campañas |
statusObligatorio | ACTIVE | PAUSED | ARCHIVED | DRAFT | PENDING_DELETION | PENDING_DELETION elimina el grupo (irreversible) |
nameOpcional | string | solo para la vista previa |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_linkedin_campaign_group_budget
Escritura2 créditosActualiza el presupuesto total, el presupuesto diario, la fecha de fin o el nombre de un grupo de campañas de LinkedIn. Con vista previa y aprobación previas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_groupObligatorio | string | — |
total_budgetOpcional | number | — |
daily_budgetOpcional | number | — |
end_dateOpcional | string | YYYY-MM-DD |
nameOpcional | string | — |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
currencyOpcional | string | ISO currency for the preview when the ad account currency is unknown |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_linkedin_campaign_targeting
Escritura2 créditosSustituye la segmentación de una campaña de LinkedIn por targeting_criteria de build_linkedin_audience. Con vista previa y aprobación previas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (uuid) o urn/id de campaña de LinkedIn de list_linkedin_campaigns |
targeting_criteriaOpcional | object | JSON targetingCriteria exactamente como lo devuelve build_linkedin_audience |
audienceOpcional | object | estimación de audiencia de build_linkedin_audience (para la vista previa) |
interface_localeOpcional | string | — |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
geo_urnsOpcional | array<string> | URNs for the locations facet (linkedin_targeting_search) |
job_title_urnsOpcional | array<string> | URNs for the titles facet (linkedin_targeting_search) |
job_function_urnsOpcional | array<string> | URNs for the jobFunctions facet (linkedin_targeting_search) |
seniority_urnsOpcional | array<string> | URNs for the seniorities facet (linkedin_targeting_search) |
industry_urnsOpcional | array<string> | URNs for the industries facet (linkedin_targeting_search) |
skill_urnsOpcional | array<string> | URNs for the skills facet (linkedin_targeting_search) |
staff_count_urnsOpcional | array<string> | URNs for the staffCountRanges facet (linkedin_targeting_search) |
employer_urnsOpcional | array<string> | URNs for the employers facet (linkedin_targeting_search) |
include_audience_urnsOpcional | array<string> | URNs for the audienceMatchingSegments facet (linkedin_targeting_search) |
exclude_geo_urnsOpcional | array<string> | URNs for the locations facet (linkedin_targeting_search) |
exclude_title_urnsOpcional | array<string> | URNs for the titles facet (linkedin_targeting_search) |
exclude_function_urnsOpcional | array<string> | URNs for the jobFunctions facet (linkedin_targeting_search) |
exclude_seniority_urnsOpcional | array<string> | URNs for the seniorities facet (linkedin_targeting_search) |
exclude_industry_urnsOpcional | array<string> | URNs for the industries facet (linkedin_targeting_search) |
exclude_skill_urnsOpcional | array<string> | URNs for the skills facet (linkedin_targeting_search) |
exclude_staff_count_urnsOpcional | array<string> | URNs for the staffCountRanges facet (linkedin_targeting_search) |
exclude_employer_urnsOpcional | array<string> | URNs for the employers facet (linkedin_targeting_search) |
exclude_audience_urnsOpcional | array<string> | URNs for the audienceMatchingSegments facet (linkedin_targeting_search) |
location_modeOpcional | recent_or_permanent | permanent | recent_or_permanent (default, locations facet) or permanent (profileLocations facet) |
audience_languageOpcional | string | interface locale, e.g. en_US, tr_TR or urn:li:locale:tr_TR (default en_US) |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
upload_linkedin_image
Escritura2 créditosSube una imagen desde una URL (incluidas las generadas en Studio, hasta 5 MB) a LinkedIn; devuelve urn:li:image para creatividades.
| Parámetro | Tipo | Descripción |
|---|---|---|
image_urlObligatorio | string | — |
organization_urnOpcional | string | — |
account_idOpcional | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_linkedin_sponsored_content
Escritura2 créditosConvierte una publicación existente de la página de empresa en contenido patrocinado (una creatividad) dentro de una campaña de LinkedIn, o crea una nueva publicación oscura (dark post) como creatividad. Con vista previa y aprobación previas; LinkedIn revisa la creatividad antes de publicarla.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (uuid) o urn/id de campaña de LinkedIn de list_linkedin_campaigns |
post_urnOpcional | string | urn de publicación existente de la página urn:li:share:… / urn:li:ugcPost:… (list_linkedin_posts) |
commentaryOpcional | string | texto para una NUEVA publicación oscura cuando no se indica post_urn |
landing_pageOpcional | string | — |
cta_labelOpcional | string | LEARN_MORE | SIGN_UP | DOWNLOAD | REGISTER | APPLY | ... |
image_urnOpcional | string | urn:li:image:… from upload_linkedin_image |
article_urlOpcional | string | — |
article_titleOpcional | string | — |
article_descriptionOpcional | string | — |
lead_form_urnOpcional | string | urn:li:adForm:… para campañas LEAD_GENERATION |
organization_urnOpcional | string | — |
nameOpcional | string | — |
statusOpcional | ACTIVE | PAUSED | DRAFT | por defecto PAUSED |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_linkedin_text_ad
Escritura2 créditosCrea una creatividad de anuncio de texto de LinkedIn (título ≤25, descripción ≤75 caracteres, página de destino) en una campaña TEXT_AD. Con vista previa y aprobación previas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (uuid) o urn/id de campaña de LinkedIn de list_linkedin_campaigns |
headlineObligatorio | string | — |
descriptionObligatorio | string | — |
landing_pageObligatorio | string | — |
image_urnOpcional | string | urn:li:image:… 100x100 (opcional) |
nameOpcional | string | — |
statusOpcional | ACTIVE | PAUSED | DRAFT | por defecto PAUSED |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_linkedin_creative_status
Escritura2 créditosPausa, activa, archiva o pasa a borrador una o varias creatividades de LinkedIn (p. ej. las que tienen impresiones pero ninguna conversión). Con vista previa y aprobación previas; las creatividades en revisión no se pueden pausar.
| Parámetro | Tipo | Descripción |
|---|---|---|
creative_idsOpcional | array<string> | urns/ids de creatividad (list_linkedin_creatives) |
creative_idOpcional | string | — |
statusObligatorio | ACTIVE | PAUSED | ARCHIVED | DRAFT | — |
campaign_idOpcional | string | opcional; ayuda a elegir la cuenta publicitaria |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_linkedin_conversion
Escritura2 créditosCrea una regla de seguimiento de conversiones en la etiqueta Insight de LinkedIn (POST conversions): para todo el sitio mediante reglas de URL (p. ej. la URL contiene /gracias) o específica de un evento. Después se vincula a una campaña con attach_linkedin_conversion. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
typeObligatorio | ADD_TO_CART | DOWNLOAD | INSTALL | KEY_PAGE_VIEW | LEAD | PURCHASE | SIGN_UP | OTHER | — |
url_rulesOpcional | array<object> | regla para todo el sitio: las reglas se combinan con Y; déjalo vacío para una conversión específica de evento |
post_click_daysOpcional | 1 | 7 | 30 | — |
view_through_daysOpcional | 1 | 7 | 30 | — |
valueOpcional | number | — |
currencyOpcional | string | — |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
attach_linkedin_conversion
Escritura1 créditosVincula una regla de seguimiento de conversiones a una campaña de LinkedIn (campaignConversions PUT) para que informe y optimice según ella. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (uuid) o urn/id de campaña de LinkedIn de list_linkedin_campaigns |
conversion_idObligatorio | string | de list_linkedin_conversions |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
detach_linkedin_conversion
EscrituraIrreversible1 créditosDesvincula una regla de seguimiento de conversiones de una campaña de LinkedIn (campaignConversions DELETE). Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (uuid) o urn/id de campaña de LinkedIn de list_linkedin_campaigns |
conversion_idObligatorio | string | — |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_linkedin_campaign
EscrituraIrreversible5 créditosElimina una campaña de LinkedIn: una campaña DRAFT se elimina de forma permanente y cualquier otra pasa a PENDING_DELETION (los datos de informes se conservan). Irreversible; siempre espera aprobación explícita.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (uuid) o urn/id de campaña de LinkedIn de list_linkedin_campaigns |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_linkedin_campaign_group
EscrituraIrreversible5 créditosElimina un grupo de campañas de LinkedIn: de forma permanente si es DRAFT; si no, se marca como PENDING_DELETION. Irreversible; siempre espera aprobación explícita.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_groupObligatorio | string | urn o id del grupo de campañas |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_linkedin_creative
EscrituraIrreversible5 créditosElimina una creatividad (anuncio) de LinkedIn: de forma permanente si es DRAFT; si no, se marca como PENDING_DELETION. Irreversible; siempre espera aprobación explícita.
| Parámetro | Tipo | Descripción |
|---|---|---|
creative_idObligatorio | string | urn o id de la creatividad |
campaign_idOpcional | string | opcional; ayuda a elegir la cuenta publicitaria |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional si la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_linkedin_campaign
Escritura5 créditosActualiza una campaña de LinkedIn en una sola llamada: nombre, objetivo de optimización, tipo de coste y programación en una acción; presupuesto/puja y estado se abren como acciones protegidas propias (mismas reglas que update_linkedin_campaign_budget / _status). Cada una se aprueba por separado.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (uuid) o urn/id de campaña de LinkedIn de list_linkedin_campaigns |
nameOpcional | string | — |
statusOpcional | ACTIVE | PAUSED | ARCHIVED | — |
daily_budgetOpcional | number | moneda de la cuenta; pasa por la protección de presupuesto |
unit_costOpcional | number | puja manual |
optimization_targetOpcional | string | p. ej. MAX_CLICK, MAX_LEAD, MAX_CONVERSION, NONE (manual) |
cost_typeOpcional | CPC | CPM | CPV | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
currencyOpcional | string | moneda ISO para la vista previa cuando se desconoce la moneda de la cuenta publicitaria |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_linkedin_campaign_group
Escritura5 créditosActualiza un grupo de campañas de LinkedIn (solo los campos indicados): nombre, estado, presupuesto total, objetivo, fecha de inicio y de fin. Primero vista previa y aprobación; los aumentos de presupuesto de más del +50 % se rechazan.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_groupObligatorio | string | — |
nameOpcional | string | — |
statusOpcional | ACTIVE | PAUSED | ARCHIVED | DRAFT | — |
total_budgetOpcional | number | moneda de la cuenta; protección de +50 % por cambio |
objectiveOpcional | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
currencyOpcional | string | moneda ISO para la vista previa cuando se desconoce la moneda de la cuenta publicitaria |
account_idOpcional | string | id de la cuenta publicitaria de LinkedIn (de list_linkedin_accounts); opcional cuando la conexión tiene una sola cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_linkedin_ad_account
EscrituraIrreversible2 créditosCreate a new LinkedIn ad account for the connected user (the one with no ad account after OAuth). Only call it when the user explicitly asked for it; the account is created at once, the user becomes its ACCOUNT_MANAGER and the connection is linked to it. Currency is permanent; a payment method must still be added in Campaign Manager.
La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | account name, e.g. “Acme Ads” |
currencyObligatorio | AED | AUD | BRL | CAD | CHF | CZK | DKK | EUR | GBP | HKD | HUF | ILS | INR | JPY | KRW | MXN | MYR | NOK | NZD | PLN | SEK | SGD | THB | TRY | TWD | USD | ZAR | permanent; LinkedIn-supported ISO code |
organization_urnOpcional | string | optional company page urn:li:organization:{id} the account advertises for |
connection_idOpcional | string | optional: which LinkedIn identity (connection) opens the account |
forceOpcional | boolean | create even though this identity already has an ad account |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.