# LinkedIn Ads

Source : https://pilot.braike.com/docs/regies/linkedin

Les 24 outils que Pilot MCP sert pour LinkedIn Ads : 13 en lecture, et 11 qui écrivent avec l'offre à 29 €, tirés du serveur.

Pilot MCP sert **13 outils de lecture** pour LinkedIn Ads, à tous les forfaits. Avec l'offre à 29 €, il sert en plus **8** qui créent ou modifient et **3** qui suppriment. Leur nom commence par `linkedin_`.

<Callout title="Ce que dit chaque fiche">
Le nom, la description et les paramètres viennent de la liste que le serveur sert à votre assistant (`tools/list`). Les descriptions sont en anglais : c'est le texte que votre assistant reçoit. Votre assistant n'a pas à remplir les accès à la régie : Pilot les ajoute à chaque appel.
</Callout>

<Callout title="Écrire et supprimer">
Les outils qui écrivent ne sont servis qu'avec le forfait à 29 € : votre assistant y crée, modifie, met en pause et supprime, sans niveau à choisir à la connexion. Au forfait Gratuit, il ne les voit pas. Une modification qui passe un objet au statut supprimé ou archivé compte comme une suppression, et une suppression ne vise qu'un objet à la fois. Les modifications s'appliquent directement dans la régie : Pilot relit l'objet avant et après l'écriture, et la note dans votre espace. Voir [Lire et écrire](/docs/limites-et-forfaits#ecritures).
</Callout>

## Familles d'outils [#familles]

| Famille | Outils |
| --- | ---: |
| [Autres outils](#autres) | 13 |
| [Créer et modifier (29 €)](#modification) | 8 |
| [Supprimer (29 €)](#suppression) | 3 |

## Autres outils [#autres]

### `linkedin_linkedin_ads_account_performance` [#linkedin_linkedin_ads_account_performance]

**LinkedIn Ads: Account Performance** · lecture · rejouable

Get account-level aggregate performance metrics for a date range. Good for high-level summaries.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `start_date` | `string` | oui | Start date YYYY-MM-DD (default: 30 days ago). |
| `end_date` | `string` | oui | End date YYYY-MM-DD (default: today). |
| `time_granularity` | `string` | non | ALL (default), DAILY, or MONTHLY. |

### `linkedin_linkedin_ads_analytics` [#linkedin_linkedin_ads_analytics]

**LinkedIn Ads: Analytics** · lecture · rejouable

Flexible analytics query with one pivot, custom fields and filters. Use for B2B demographic breakdowns (MEMBER\_JOB\_FUNCTION, MEMBER\_SENIORITY, MEMBER\_INDUSTRY, MEMBER\_COMPANY\_SIZE, MEMBER\_COUNTRY\_V2...), device splits or creative performance. Demographic values are approximate and URNs.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `start_date` | `string` | oui | Start date YYYY-MM-DD (default: 30 days ago). |
| `end_date` | `string` | oui | End date YYYY-MM-DD (default: today). |
| `time_granularity` | `string` | non | ALL (default), DAILY, or MONTHLY. |
| `pivot` | `string` | oui | Pivot dimension, one of: ACCOUNT, CAMPAIGN\_GROUP, CAMPAIGN, CREATIVE, COMPANY, CONVERSION, CONVERSATION\_NODE, CONVERSATION\_NODE\_OPTION\_INDEX, SERVING\_LOCATION, CARD\_INDEX, PLACEMENT\_NAME, IMPRESSION\_DEVICE\_TYPE, EVENT\_STAGE, OBJECTIVE\_TYPE, CAMPAIGN\_TYPE, MEMBER\_COMPANY\_SIZE, MEMBER\_INDUSTRY, MEMBER\_SENIORITY, MEMBER\_JOB\_TITLE, MEMBER\_JOB\_FUNCTION, MEMBER\_COUNTRY\_V2, MEMBER\_REGION\_V2, MEMBER\_COMPANY, MEMBER\_COUNTY. |
| `fields` | `string[]` | non | Metrics to return (18 at most: LinkedIn counts dateRange and pivotValues in its 20-field cap). There is no costPerLead metric: compute costInLocalCurrency / oneClickLeads. Default: impressions, clicks, costInLocalCurrency, landingPageClicks, oneClickLeads, oneClickLeadFormOpens, externalWebsiteConversions, conversionValueInLocalCurrency, totalEngagements, videoViews, videoCompletions. |
| `campaign_ids` | `string[]` | non | Filter by campaign IDs. |
| `campaign_group_ids` | `string[]` | non | Filter by campaign group IDs. |

### `linkedin_linkedin_ads_campaign_performance` [#linkedin_linkedin_ads_campaign_performance]

**LinkedIn Ads: Campaign Performance** · lecture · rejouable

Get campaign-level performance metrics (impressions, clicks, spend, leads, website conversions, engagement, video views) for a date range.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `start_date` | `string` | oui | Start date YYYY-MM-DD (default: 30 days ago). |
| `end_date` | `string` | oui | End date YYYY-MM-DD (default: today). |
| `time_granularity` | `string` | non | ALL (default), DAILY, or MONTHLY. |

### `linkedin_linkedin_ads_get_campaign` [#linkedin_linkedin_ads_get_campaign]

**LinkedIn Ads: Get Campaign** · lecture · rejouable

Get one LinkedIn campaign in full: status, objective, budget, bidding, schedule and targeting criteria.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_id` | `string` | oui | Campaign ID (numeric, or urn:li:sponsoredCampaign:\<id\>). |

### `linkedin_linkedin_ads_get_campaign_group` [#linkedin_linkedin_ads_get_campaign_group]

**LinkedIn Ads: Get Campaign Group** · lecture · rejouable

Get one LinkedIn campaign group in full: name, status, run schedule and total budget.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_group_id` | `string` | oui | Campaign group ID (numeric, or urn:li:sponsoredCampaignGroup:\<id\>). |

### `linkedin_linkedin_ads_get_conversion_action` [#linkedin_linkedin_ads_get_conversion_action]

**LinkedIn Ads: Get Conversion Action** · lecture · rejouable

Get one conversion tracking rule of an ad account: name, type, enabled, attribution type and windows, value.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `conversion_id` | `string` | oui | Conversion rule ID (numeric, or urn:lla:llaPartnerConversion:\<id\>). |

### `linkedin_linkedin_ads_get_creative` [#linkedin_linkedin_ads_get_creative]

**LinkedIn Ads: Get Creative** · lecture · rejouable

Get one LinkedIn creative (ad): its campaign, intendedStatus, isServing, review status and content reference.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `creative_id` | `string` | oui | Creative ID (numeric, or urn:li:sponsoredCreative:\<id\>). |

### `linkedin_linkedin_ads_list_accounts` [#linkedin_linkedin_ads_list_accounts]

**LinkedIn Ads: List Accounts** · lecture · rejouable

List the LinkedIn ad accounts (active and draft) the connected user can access, with currency and status.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | non | LinkedIn Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `linkedin_linkedin_ads_list_campaign_groups` [#linkedin_linkedin_ads_list_campaign_groups]

**LinkedIn Ads: List Campaign Groups** · lecture · rejouable

List campaign groups for a LinkedIn ad account. In Pilot's vocabulary a LinkedIn campaign group is a CAMPAIGN.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `status` | `string[]` | non | Filter by status: ACTIVE, PAUSED, ARCHIVED, CANCELED, DRAFT (COMPLETED does not exist for campaign groups and is rejected). Default: ACTIVE, PAUSED. |

### `linkedin_linkedin_ads_list_campaigns` [#linkedin_linkedin_ads_list_campaigns]

**LinkedIn Ads: List Campaigns** · lecture · rejouable

List campaigns for a LinkedIn ad account, with optional status and campaign group filters. A LinkedIn campaign carries budget, bidding, objective and targeting (an ad group in Pilot's vocabulary).

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `status` | `string[]` | non | Filter by status: ACTIVE, PAUSED, ARCHIVED, COMPLETED, CANCELED, DRAFT. Default: ACTIVE, PAUSED. |
| `campaign_group_id` | `string` | non | Filter by campaign group ID. |

### `linkedin_linkedin_ads_list_conversion_actions` [#linkedin_linkedin_ads_list_conversion_actions]

**LinkedIn Ads: List Conversion Actions** · lecture · rejouable

List conversion tracking rules of an ad account.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |

### `linkedin_linkedin_ads_list_creatives` [#linkedin_linkedin_ads_list_creatives]

**LinkedIn Ads: List Creatives** · lecture · rejouable

List the creatives (ads) of a LinkedIn ad account, optionally for given campaigns and statuses. Returns intendedStatus, isServing, review status and the content reference.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_ids` | `string[]` | non | Filter by campaign IDs. |
| `statuses` | `string[]` | non | Filter by intendedStatus: ACTIVE, PAUSED, DRAFT, ARCHIVED, CANCELED. Default: all. |

### `linkedin_linkedin_ads_manage_insight_tag` [#linkedin_linkedin_ads_manage_insight_tag]

**LinkedIn Ads: Manage Insight Tag** · lecture · rejouable

Read the LinkedIn Insight Tag(s) of an ad account (read-only despite the name).

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |

## Créer et modifier (29 €) [#modification]

Servis avec le forfait à 29 €.

### `linkedin_linkedin_ads_create_campaign` [#linkedin_linkedin_ads_create_campaign]

**LinkedIn Ads: Create Campaign** · création ou modification, forfait à 29 € · crée un objet à chaque appel

Create a LinkedIn campaign in a campaign group, always as DRAFT: it serves nothing until linkedin\_ads\_update\_campaign sets it ACTIVE. targeting\_criteria uses geo URNs (urn:li:geo:...) only. political\_intent is required by LinkedIn for campaigns that target the EU. Re-reads the campaign and returns it.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_group_id` | `string` | oui | Campaign group ID the campaign belongs to. |
| `name` | `string` | oui | Campaign name. |
| `objective_type` | `string` | oui | BRAND\_AWARENESS, ENGAGEMENT, JOB\_APPLICANTS, LEAD\_GENERATION, WEBSITE\_CONVERSIONS, WEBSITE\_VISIT, VIDEO\_VIEW or TALENT\_LEADS. |
| `type` | `string` | non | SPONSORED\_UPDATES (default), TEXT\_AD, SPONSORED\_INMAILS or DYNAMIC. |
| `cost_type` | `string` | oui | CPM, CPC or CPV. |
| `daily_budget` | `number` | oui | Daily budget, in the account currency. |
| `unit_cost` | `number` | non | Bid amount per cost\_type unit, in the account currency (optional: automated bidding when omitted). |
| `locale` | `string` | oui | Campaign locale, language\_COUNTRY, e.g. fr\_FR or en\_US. |
| `targeting_criteria` | `object` | oui | LinkedIn targetingCriteria object (\{ include: \{ and: \[...\] \}, exclude?: \{...\} \}). |
| `political_intent` | `string` | oui | NOT\_POLITICAL or POLITICAL. |
| `start_date` | `string` | non | Start date YYYY-MM-DD (default: today). |
| `end_date` | `string` | non | End date YYYY-MM-DD (optional). |
| `currency_code` | `string` | non | Account currency (read from the account when omitted). |

### `linkedin_linkedin_ads_create_campaign_group` [#linkedin_linkedin_ads_create_campaign_group]

**LinkedIn Ads: Create Campaign Group** · création ou modification, forfait à 29 € · crée un objet à chaque appel

Create a LinkedIn campaign group, always as DRAFT: it serves nothing until linkedin\_ads\_update\_campaign\_group sets it ACTIVE. Re-reads the group and returns it.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `name` | `string` | oui | Campaign group name. |
| `start_date` | `string` | non | Start date YYYY-MM-DD (default: today). |
| `end_date` | `string` | non | End date YYYY-MM-DD (optional; required by LinkedIn with a total budget). |
| `total_budget` | `number` | non | Total budget, in the account currency (optional). |
| `currency_code` | `string` | non | Account currency (read from the account when omitted). |

### `linkedin_linkedin_ads_create_conversion_action` [#linkedin_linkedin_ads_create_conversion_action]

**LinkedIn Ads: Create Conversion Action** · création ou modification, forfait à 29 € · crée un objet à chaque appel

Create a new conversion tracking rule for an ad account. LinkedIn cannot delete a conversion rule afterwards: disable it with linkedin\_ads\_update\_conversion\_action (enabled: false).

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `name` | `string` | oui | Conversion rule name. |
| `type` | `string` | oui | Conversion type, e.g. LEAD, PURCHASE, SIGN\_UP, ADD\_TO\_CART, DOWNLOAD, INSTALL, KEY\_PAGE\_VIEW, OTHER. |
| `attribution_type` | `string` | non | LAST\_TOUCH\_BY\_CAMPAIGN (default) or LAST\_TOUCH\_BY\_CONVERSION. |

### `linkedin_linkedin_ads_create_creative` [#linkedin_linkedin_ads_create_creative]

**LinkedIn Ads: Create Creative** · création ou modification, forfait à 29 € · crée un objet à chaque appel

Create a LinkedIn creative (ad) in a campaign from an existing organization post (urn:li:share:\<id\> or urn:li:ugcPost:\<id\>). intended\_status is DRAFT (default) or PAUSED; set it ACTIVE afterwards with linkedin\_ads\_update\_creative\_status. Re-reads the creative and returns it.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_id` | `string` | oui | Campaign ID the creative belongs to. |
| `post_urn` | `string` | oui | The post to sponsor: urn:li:share:\<id\> or urn:li:ugcPost:\<id\>. |
| `intended_status` | `string` | non | DRAFT (default) or PAUSED. |

### `linkedin_linkedin_ads_update_campaign` [#linkedin_linkedin_ads_update_campaign]

**LinkedIn Ads: Update Campaign** · création ou modification, forfait à 29 € · crée un objet à chaque appel

Update a LinkedIn campaign: status (ACTIVE, PAUSED, ARCHIVED), daily or total budget, or name. Re-reads the campaign afterwards and returns its new state.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_id` | `string` | oui | Campaign ID. |
| `status` | `string` | non | New status: ACTIVE, PAUSED or ARCHIVED. |
| `daily_budget` | `number` | non | New daily budget, in the account currency. |
| `total_budget` | `number` | non | New total (lifetime) budget, in the account currency. |
| `name` | `string` | non | New campaign name. |
| `currency_code` | `string` | non | Account currency (read from the account when omitted). |

### `linkedin_linkedin_ads_update_campaign_group` [#linkedin_linkedin_ads_update_campaign_group]

**LinkedIn Ads: Update Campaign Group** · création ou modification, forfait à 29 € · crée un objet à chaque appel

Update a LinkedIn campaign group: status (ACTIVE, PAUSED, ARCHIVED), total budget, or name. Re-reads the group afterwards and returns its new state.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_group_id` | `string` | oui | Campaign group ID. |
| `status` | `string` | non | New status: ACTIVE, PAUSED or ARCHIVED. |
| `total_budget` | `number` | non | New total budget, in the account currency. |
| `name` | `string` | non | New campaign group name. |
| `currency_code` | `string` | non | Account currency (read from the account when omitted). |

### `linkedin_linkedin_ads_update_conversion_action` [#linkedin_linkedin_ads_update_conversion_action]

**LinkedIn Ads: Update Conversion Action** · création ou modification, forfait à 29 € · crée un objet à chaque appel

Update a conversion tracking rule of the ad account: name, enabled, attribution\_type, attribution windows, value. The rule is read first and must belong to account\_id. Re-reads it afterwards and returns its new state.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `conversion_id` | `string` | oui | Conversion rule ID. |
| `name` | `string` | non | New name. |
| `enabled` | `boolean` | non | Turn the rule on (true) or off (false). |
| `attribution_type` | `string` | non | LAST\_TOUCH\_BY\_CAMPAIGN or LAST\_TOUCH\_BY\_CONVERSION. |
| `post_click_attribution_window_size` | `number` | non | Post-click window in days: 1, 7, 30 or 90. |
| `view_through_attribution_window_size` | `number` | non | View-through window in days: 1, 7, 30 or 90. |
| `value` | `number` | non | Default conversion value, in the account currency. |
| `currency_code` | `string` | non | Account currency (read from the account when omitted). |

### `linkedin_linkedin_ads_update_creative_status` [#linkedin_linkedin_ads_update_creative_status]

**LinkedIn Ads: Update Creative Status** · création ou modification, forfait à 29 € · crée un objet à chaque appel

Change the intendedStatus of a LinkedIn creative (ad): ACTIVE, PAUSED, ARCHIVED or CANCELED. A creative under review cannot be paused.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `creative_id` | `string` | oui | Creative ID (numeric, or urn:li:sponsoredCreative:\<id\>). |
| `intended_status` | `string` | oui | ACTIVE, PAUSED, ARCHIVED or CANCELED. |

## Supprimer (29 €) [#suppression]

Servis avec le forfait à 29 €. Une suppression ne vise qu'un objet à la fois.

### `linkedin_linkedin_ads_delete_campaign` [#linkedin_linkedin_ads_delete_campaign]

**LinkedIn Ads: Delete Campaign** · suppression, forfait à 29 €, un objet à la fois · crée un objet à chaque appel

Delete a LinkedIn campaign that is still DRAFT. Any other status is refused before anything is sent: archive it with linkedin\_ads\_update\_campaign instead. Re-reads it afterwards to confirm it is gone.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_id` | `string` | oui | Campaign ID. |

### `linkedin_linkedin_ads_delete_campaign_group` [#linkedin_linkedin_ads_delete_campaign_group]

**LinkedIn Ads: Delete Campaign Group** · suppression, forfait à 29 €, un objet à la fois · crée un objet à chaque appel

Delete a LinkedIn campaign group that is still DRAFT. Any other status is refused before anything is sent: archive it with linkedin\_ads\_update\_campaign\_group instead. Re-reads it afterwards to confirm it is gone.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_group_id` | `string` | oui | Campaign group ID. |

### `linkedin_linkedin_ads_delete_creative` [#linkedin_linkedin_ads_delete_creative]

**LinkedIn Ads: Delete Creative** · suppression, forfait à 29 €, un objet à la fois · crée un objet à chaque appel

Delete a LinkedIn creative (ad) whose intendedStatus is still DRAFT. Any other status is refused before anything is sent: archive or cancel it with linkedin\_ads\_update\_creative\_status instead. Re-reads it afterwards to confirm it is gone.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `creative_id` | `string` | oui | Creative ID (numeric, or urn:li:sponsoredCreative:\<id\>). |
