LinkedIn Ads tools
Campaign groups, campaigns, sponsored content, text ads, targeting and demographic reports.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son el texto original en inglés que ve el asistente.
Herramientas de lectura8 herramientas
list_linkedin_accounts
Lectura1 créditosLinkedIn ad accounts the connected user can access (id, name, currency, status, serving status, company page reference). Agencies: pick account_id for the other tools. Read only; returns connected=false when no account is linked.
Esta herramienta no recibe parámetros.
list_linkedin_campaign_groups
Lectura1 créditosCampaign groups of a LinkedIn ad account with status, serving statuses, objective, total/daily budget and schedule. Read only.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
statusesOpcional | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED (default all four) |
list_linkedin_campaigns
Lectura1 créditosLinkedIn campaigns with status, objective, type, daily/total budget, bid, currency, campaign group and targeting. Returns urn and ledger_campaign_id to use with the update tools. Read only.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
campaign_groupOpcional | string | filter by campaign group urn or id |
statusesOpcional | array<string> | ACTIVE | PAUSED | DRAFT | COMPLETED | ARCHIVED | CANCELED |
sync_ledgerOpcional | boolean | also import campaigns into the Tecrübe ledger (default true) |
list_linkedin_creatives
Lectura1 créditosCreatives (ads) of LinkedIn campaigns: intended status, serving state and hold reasons, review status, referenced post or text-ad fields. Read only.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
campaign_idsOpcional | array<string> | campaign urns/ids; default: all active/paused/draft campaigns |
statusesOpcional | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED | CANCELED |
limitOpcional | integer (1–100) | — |
linkedin_performance_report
Lectura2 créditosLinkedIn ad analytics for a date range: spend, impressions, clicks, CTR, CPC, CPM, lead-form opens, leads, website conversions, conversion value, cost per lead (CPL) and cost per conversion per campaign / campaign group / creative / account, plus totals and the rows with 500+ impressions and zero conversions. Real numbers only; never invented.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
daysOpcional | integer (1–366) | last N days incl. today (default 30) |
start_dateOpcional | string | YYYY-MM-DD (overrides days) |
end_dateOpcional | string | YYYY-MM-DD |
pivotOpcional | CAMPAIGN | CAMPAIGN_GROUP | CREATIVE | ACCOUNT | — |
campaign_idsOpcional | array<string> | restrict to these campaign urns/ids (required for creative names with 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éditosLinkedIn professional demographics of who saw, clicked and converted on your ads: job title, seniority, job function, industry, company size and country (adAnalytics MEMBER_* pivots) with impressions, clicks, CTR, spend, leads, CPL and website conversions; URNs are resolved to readable names. Each dimension reports the share hidden by LinkedIn's privacy threshold (values with fewer than 3 events are dropped) instead of inventing rows. Read only.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
pivotsOpcional | array<MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2> | default: all six |
pivotOpcional | MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2 | — |
daysOpcional | integer (1–366) | last N days incl. today (default 30) |
start_dateOpcional | string | YYYY-MM-DD (overrides days) |
end_dateOpcional | string | YYYY-MM-DD |
campaign_idsOpcional | array<string> | restrict to these campaign urns/ids |
campaign_group_idsOpcional | array<string> | — |
limitOpcional | integer (1–100) | rows per dimension (default 25, by impressions) |
locale_languageOpcional | string | names language, default en |
locale_countryOpcional | string | default US |
build_linkedin_audience
Lectura2 créditosResolve plain-language targeting (titles, companies, industries, company sizes, locations, seniorities, functions, skills) to LinkedIn targeting facets and return targetingCriteria plus the estimated audience size. Drops facet combinations LinkedIn rejects and says so. Read only; pass targeting_criteria to create_linkedin_campaign or update_linkedin_campaign_targeting.
| Parámetro | Tipo | Descripción |
|---|---|---|
titlesOpcional | array<string> | job titles, e.g. Marketing Manager |
industriesOpcional | array<string> | — |
locationsOpcional | array<string> | cities / regions / countries, e.g. Istanbul, Turkey (at least one is required by LinkedIn) |
company_sizesOpcional | array<string> | e.g. '200+', '51-200', '1001+' |
senioritiesOpcional | array<string> | — |
job_functionsOpcional | array<string> | — |
skillsOpcional | array<string> | — |
employersOpcional | array<string> | company names (cannot be combined with industries / company_sizes) |
exclude_titlesOpcional | array<string> | — |
exclude_employersOpcional | array<string> | — |
exclude_industriesOpcional | array<string> | — |
interface_localesOpcional | array<string> | e.g. urn:li:locale:en_US, urn:li:locale:tr_TR (default en_US) |
locale_languageOpcional | string | search language, default en |
locale_countryOpcional | string | default US |
estimateOpcional | boolean | fetch audience count (default true) |
list_linkedin_posts
Lectura1 créditosLatest company page posts (urn, text, content type, published time, sponsored flag) to pick one for create_linkedin_sponsored_content. Needs the r_organization_social scope; otherwise returns a note. Read only.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
organization_urnOpcional | string | urn:li:organization:{id}; default: the ad account's company page |
countOpcional | integer (1–100) | — |
Herramientas de escritura10 herramientas
create_linkedin_campaign_group
Escritura2 créditosCreate a LinkedIn campaign group (paused by default). Returns a preview and opens an approval item; created on LinkedIn only after approval and only with a connected account.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
account_idOpcional | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
statusOpcional | ACTIVE | PAUSED | DRAFT | default PAUSED |
daily_budgetOpcional | number | account currency; dynamic budget shared by the group's campaigns |
total_budgetOpcional | number | account currency; requires end_date |
end_dateOpcional | string | YYYY-MM-DD |
objectiveOpcional | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | — |
bid_strategyOpcional | MAXIMUM_DELIVERY | MANUAL | COST_CAP | — |
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éditosCreate a LinkedIn campaign (sponsored content or text ad) with budget, objective, bidding and targeting from build_linkedin_audience. Writes a draft to the ledger and opens an approval item with a preview; created on LinkedIn (paused by default) after approval. Add creatives with create_linkedin_sponsored_content / create_linkedin_text_ad.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
daily_budgetObligatorio | number | account currency |
targeting_criteriaObligatorio | object | targetingCriteria JSON exactly as returned by build_linkedin_audience |
account_idOpcional | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
campaign_groupOpcional | string | campaign group urn/id; default: the account's default group |
objectiveOpcional | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | default WEBSITE_VISITS; LEAD_GENERATION for lead forms |
typeOpcional | SPONSORED_UPDATES | TEXT_AD | default SPONSORED_UPDATES |
statusOpcional | PAUSED | ACTIVE | default PAUSED (nothing spends until resumed) |
total_budgetOpcional | number | — |
unit_costOpcional | number | manual bid; omitted = automated bidding |
cost_typeOpcional | CPC | CPM | — |
locale_countryOpcional | string | — |
locale_languageOpcional | string | — |
organization_urnOpcional | string | company page for sponsored content; default: the ad account's reference |
audience_expansionOpcional | boolean | — |
offsite_deliveryOpcional | boolean | LinkedIn Audience Network |
political_intentOpcional | NOT_POLITICAL | POLITICAL | — |
goalOpcional | string | — |
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éditosChange a LinkedIn campaign's daily budget, total budget and/or bid. Returns a preview with the current → new values; applied after approval (budget decreases and small increases may auto-apply per the user's approval policy).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | Tecrübe campaign id (uuid) or LinkedIn campaign urn/id from list_linkedin_campaigns |
daily_budgetOpcional | number | account currency |
total_budgetOpcional | number | — |
unit_costOpcional | number | manual bid (switches the campaign to manual bidding) |
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.
update_linkedin_campaign_status
Escritura2 créditosPause, resume (ACTIVE) or archive a LinkedIn campaign. Goes through preview and the approval policy.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | Tecrübe campaign id (uuid) or LinkedIn campaign urn/id from list_linkedin_campaigns |
statusObligatorio | ACTIVE | PAUSED | ARCHIVED | — |
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.
update_linkedin_campaign_group_status
EscrituraIrreversible2 créditosActivate, pause, archive, draft or delete (PENDING_DELETION) a LinkedIn campaign group. Always previewed and approved first.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_groupObligatorio | string | campaign group urn or id |
statusObligatorio | ACTIVE | PAUSED | ARCHIVED | DRAFT | PENDING_DELETION | PENDING_DELETION deletes the group (irreversible) |
nameOpcional | string | for the preview only |
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.
update_linkedin_campaign_group_budget
Escritura2 créditosUpdate a LinkedIn campaign group's total budget, daily budget, end date or name. Previewed and approved first.
| 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 | 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.
update_linkedin_campaign_targeting
Escritura2 créditosReplace a LinkedIn campaign's targeting with targeting_criteria from build_linkedin_audience. Previewed and approved first.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | Tecrübe campaign id (uuid) or LinkedIn campaign urn/id from list_linkedin_campaigns |
targeting_criteriaObligatorio | object | targetingCriteria JSON exactly as returned by build_linkedin_audience |
audienceOpcional | object | audience estimate from build_linkedin_audience (for the preview) |
interface_localeOpcional | 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éditosTurn an existing company page post into sponsored content (a creative) in a LinkedIn campaign, or create a new dark post as the creative. Previewed and approved first; LinkedIn reviews the creative before it serves.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | Tecrübe campaign id (uuid) or LinkedIn campaign urn/id from list_linkedin_campaigns |
post_urnOpcional | string | existing page post urn:li:share:… / urn:li:ugcPost:… (list_linkedin_posts) |
commentaryOpcional | string | text for a NEW dark post when no post_urn is given |
landing_pageOpcional | string | — |
cta_labelOpcional | string | LEARN_MORE | SIGN_UP | DOWNLOAD | REGISTER | APPLY | ... |
article_urlOpcional | string | — |
article_titleOpcional | string | — |
article_descriptionOpcional | string | — |
lead_form_urnOpcional | string | urn:li:adForm:… for LEAD_GENERATION campaigns |
organization_urnOpcional | string | — |
nameOpcional | string | — |
statusOpcional | ACTIVE | PAUSED | DRAFT | default PAUSED |
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_text_ad
Escritura2 créditosCreate a LinkedIn text ad creative (headline ≤25, description ≤75 chars, landing page) in a TEXT_AD campaign. Previewed and approved first.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | Tecrübe campaign id (uuid) or LinkedIn campaign urn/id from list_linkedin_campaigns |
headlineObligatorio | string | — |
descriptionObligatorio | string | — |
landing_pageObligatorio | string | — |
image_urnOpcional | string | urn:li:image:… 100x100 (optional) |
nameOpcional | string | — |
statusOpcional | ACTIVE | PAUSED | DRAFT | default PAUSED |
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.
update_linkedin_creative_status
Escritura2 créditosPause, activate, archive or draft one or more LinkedIn creatives (e.g. the ones with impressions but no conversions). Previewed and approved first; creatives under review cannot be paused.
| Parámetro | Tipo | Descripción |
|---|---|---|
creative_idsOpcional | array<string> | creative urns/ids (list_linkedin_creatives) |
creative_idOpcional | string | — |
statusObligatorio | ACTIVE | PAUSED | ARCHIVED | DRAFT | — |
campaign_idOpcional | string | optional; helps pick the ad account |
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.