Outils LinkedIn Ads
Groupes de campagnes, campagnes, contenu sponsorisé, annonces textuelles, ciblage et rapports démographiques.
L’intégration de ce canal est prête ; la connexion ouvrira dès que la plateforme aura validé notre application développeur. D’ici là, aucun compte ne peut être connecté et les actions décrites sur cette page ne sont pas disponibles.
Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont la traduction du texte vu par l'assistant, les noms d'outils et de paramètres restent inchangés.
Outils de lecture16 outils
list_linkedin_accounts
Lecture1 créditsComptes publicitaires LinkedIn accessibles à l'utilisateur connecté (id, nom, devise, statut, statut de diffusion, référence de la page entreprise). Agences : choisissez account_id pour les autres outils. Lecture seule ; renvoie connected=false si aucun compte n'est lié.
Cet outil ne prend aucun paramètre.
list_linkedin_campaign_groups
Lecture1 créditsGroupes de campagnes d'un compte publicitaire LinkedIn avec statut, statuts de diffusion, objectif, budget total/quotidien et calendrier. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
statusesFacultatif | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED (les quatre par défaut) |
list_linkedin_campaigns
Lecture1 créditsCampagnes LinkedIn avec statut, objectif, type, budget quotidien/total, enchère, devise, groupe de campagnes et ciblage. Renvoie urn et ledger_campaign_id à utiliser avec les outils de mise à jour. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
campaign_groupFacultatif | string | filtrer par urn ou id de groupe de campagnes |
statusesFacultatif | array<string> | ACTIVE | PAUSED | DRAFT | COMPLETED | ARCHIVED | CANCELED |
sync_ledgerFacultatif | boolean | importer aussi les campagnes dans le registre Tecrübe (true par défaut) |
list_linkedin_creatives
Lecture1 créditsCréations (annonces) des campagnes LinkedIn : statut souhaité, état de diffusion et motifs de blocage, statut de vérification et motifs de refus de LinkedIn (review_rejection_reasons), publication référencée ou champs de l'annonce texte. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
campaign_idsFacultatif | array<string> | urns/ids de campagnes ; par défaut : toutes les campagnes actives/en pause/brouillon |
statusesFacultatif | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED | CANCELED |
limitFacultatif | integer (1–100) | — |
linkedin_performance_report
Lecture2 créditsStatistiques publicitaires LinkedIn sur une plage de dates : dépenses, impressions, clics, CTR, CPC, CPM, ouvertures de formulaire, prospects, conversions web, valeur de conversion, coût par prospect (CPL) et coût par conversion par campagne / groupe de campagnes / création / compte, plus les totaux et les lignes à 500+ impressions sans conversion. Chiffres réels uniquement ; jamais inventés.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
daysFacultatif | integer (1–366) | N derniers jours, aujourd'hui inclus (30 par défaut) |
start_dateFacultatif | string | YYYY-MM-DD (prime sur days) |
end_dateFacultatif | string | YYYY-MM-DD |
pivotFacultatif | CAMPAIGN | CAMPAIGN_GROUP | CREATIVE | ACCOUNT | — |
campaign_idsFacultatif | array<string> | limiter à ces urns/ids de campagnes (requis pour les noms de créations avec pivot=CREATIVE) |
campaign_group_idsFacultatif | array<string> | — |
time_granularityFacultatif | ALL | DAILY | — |
sort_byFacultatif | cpl | spend | impressions | clicks | leads | conversions | ctr | — |
linkedin_demographics_report
Lecture2 créditsDonnées démographiques professionnelles LinkedIn des personnes qui ont vu, cliqué et converti sur vos annonces : poste, niveau hiérarchique, fonction, secteur, taille d'entreprise et pays (pivots MEMBER_* d'adAnalytics) avec impressions, clics, CTR, dépenses, prospects, CPL et conversions web ; les URN sont résolus en noms lisibles. Chaque dimension indique la part masquée par le seuil de confidentialité LinkedIn (les valeurs à moins de 3 événements sont supprimées) au lieu d'inventer des lignes. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
pivotsFacultatif | array<MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2> | par défaut : les six |
pivotFacultatif | MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2 | — |
daysFacultatif | integer (1–366) | N derniers jours, aujourd'hui inclus (30 par défaut) |
start_dateFacultatif | string | YYYY-MM-DD (prime sur days) |
end_dateFacultatif | string | YYYY-MM-DD |
campaign_idsFacultatif | array<string> | limiter à ces urns/ids de campagnes |
campaign_group_idsFacultatif | array<string> | — |
limitFacultatif | integer (1–100) | lignes par dimension (25 par défaut, par impressions) |
locale_languageFacultatif | string | langue des noms, en par défaut |
locale_countryFacultatif | string | US par défaut |
build_linkedin_audience
Lecture2 créditsRésout un ciblage exprimé en langage courant (postes, entreprises, secteurs, tailles d'entreprise, lieux, niveaux hiérarchiques, fonctions, compétences) en facettes de ciblage LinkedIn et renvoie targetingCriteria ainsi que la taille d'audience estimée. Écarte les combinaisons de facettes refusées par LinkedIn et le signale. Lecture seule ; passez targeting_criteria à create_linkedin_campaign ou update_linkedin_campaign_targeting.
| Paramètre | Type | Description |
|---|---|---|
titlesFacultatif | array<string> | intitulés de poste, p. ex. Marketing Manager |
industriesFacultatif | array<string> | — |
locationsFacultatif | array<string> | villes / régions / pays, p. ex. Istanbul, Turkey (LinkedIn en exige au moins un) |
company_sizesFacultatif | array<string> | p. ex. '200+', '51-200', '1001+' |
senioritiesFacultatif | array<string> | — |
job_functionsFacultatif | array<string> | — |
skillsFacultatif | array<string> | — |
employersFacultatif | array<string> | noms d'entreprises (non combinable avec industries / company_sizes) |
companiesFacultatif | array<string> | Alias of employers |
exclude_titlesFacultatif | array<string> | — |
exclude_employersFacultatif | array<string> | — |
exclude_industriesFacultatif | array<string> | — |
interface_localesFacultatif | array<string> | p. ex. urn:li:locale:en_US, urn:li:locale:tr_TR (en_US par défaut) |
locale_languageFacultatif | string | langue de recherche, en par défaut |
locale_countryFacultatif | string | US par défaut |
estimateFacultatif | boolean | récupérer le nombre d'audience (true par défaut) |
list_linkedin_posts
Lecture1 créditsDernières publications de la page entreprise (urn, texte, type de contenu, date de publication, indicateur sponsorisé) pour en choisir une dans create_linkedin_sponsored_content. Nécessite la portée r_organization_social ; sinon renvoie une note. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
organization_urnFacultatif | string | urn:li:organization:{id} ; par défaut : la page entreprise du compte publicitaire |
countFacultatif | integer (1–100) | — |
linkedin_targeting_search
Lecture1 créditsRecherche par nom des entités de ciblage LinkedIn dans une facette (saisie semi-automatique adTargetingEntities / liste de la facette) et renvoie leurs URN et noms. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
queryFacultatif | string | nom à rechercher ; vide, liste toute la facette (seniorities, jobFunctions, staffCountRanges) |
facetFacultatif | titles | industries | locations | employers | skills | seniorities | jobFunctions | staffCountRanges | par défaut titles |
locale_languageFacultatif | string | par défaut en |
locale_countryFacultatif | string | par défaut US |
linkedin_audience_forecast
Lecture1 créditsEstime combien de membres LinkedIn un ciblage atteint (audienceCounts) : membres totaux et actifs, avec des avertissements sous le minimum de 300 membres ou sans lieu. Accepte targeting_criteria, des listes d'URN par facette ou le ciblage enregistré d'une campagne. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
targeting_criteriaFacultatif | object | JSON targetingCriteria tel que renvoyé par build_linkedin_audience |
campaign_idFacultatif | string | utilise le ciblage enregistré de cette campagne si aucun autre ciblage n'est fourni |
geo_urnsFacultatif | array<string> | URN de la facette locations (linkedin_targeting_search) |
job_title_urnsFacultatif | array<string> | URN de la facette titles (linkedin_targeting_search) |
job_function_urnsFacultatif | array<string> | URN de la facette jobFunctions (linkedin_targeting_search) |
seniority_urnsFacultatif | array<string> | URN de la facette seniorities (linkedin_targeting_search) |
industry_urnsFacultatif | array<string> | URN de la facette industries (linkedin_targeting_search) |
skill_urnsFacultatif | array<string> | URN de la facette skills (linkedin_targeting_search) |
staff_count_urnsFacultatif | array<string> | URN de la facette staffCountRanges (linkedin_targeting_search) |
employer_urnsFacultatif | array<string> | URN de la facette employers (linkedin_targeting_search) |
include_audience_urnsFacultatif | array<string> | URN de la facette audienceMatchingSegments (linkedin_targeting_search) |
exclude_geo_urnsFacultatif | array<string> | URN de la facette locations (linkedin_targeting_search) |
exclude_title_urnsFacultatif | array<string> | URN de la facette titles (linkedin_targeting_search) |
exclude_function_urnsFacultatif | array<string> | URN de la facette jobFunctions (linkedin_targeting_search) |
exclude_seniority_urnsFacultatif | array<string> | URN de la facette seniorities (linkedin_targeting_search) |
exclude_industry_urnsFacultatif | array<string> | URN de la facette industries (linkedin_targeting_search) |
exclude_skill_urnsFacultatif | array<string> | URN de la facette skills (linkedin_targeting_search) |
exclude_staff_count_urnsFacultatif | array<string> | URN de la facette staffCountRanges (linkedin_targeting_search) |
exclude_employer_urnsFacultatif | array<string> | URN de la facette employers (linkedin_targeting_search) |
exclude_audience_urnsFacultatif | array<string> | URN de la facette audienceMatchingSegments (linkedin_targeting_search) |
location_modeFacultatif | recent_or_permanent | permanent | recent_or_permanent (par défaut, facette locations) ou permanent (facette profileLocations) |
audience_languageFacultatif | string | paramètre régional de l'interface, p. ex. en_US, tr_TR ou urn:li:locale:tr_TR (par défaut en_US) |
linkedin_bid_recommendations
Lecture1 créditsEnchère suggérée par LinkedIn, enchère plancher/plafond et limites de budget quotidien pour une audience (adBudgetPricing criteriaV2), dans la devise du compte publicitaire. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
campaign_typeFacultatif | SPONSORED_UPDATES | TEXT_AD | SPONSORED_INMAILS | — |
bid_typeFacultatif | CPM | CPC | CPV | — |
objective_typeFacultatif | string | p. ex. WEBSITE_VISIT, LEAD_GENERATION, BRAND_AWARENESS, WEBSITE_CONVERSION, VIDEO_VIEW, ENGAGEMENT |
optimization_targetFacultatif | string | p. ex. MAX_CLICK, MAX_LEAD, MAX_CONVERSION, NONE |
daily_budgetFacultatif | number | devise du compte ; affine la suggestion |
audience_expansionFacultatif | boolean | — |
targeting_criteriaFacultatif | object | JSON targetingCriteria tel que renvoyé par build_linkedin_audience |
campaign_idFacultatif | string | utilise le ciblage enregistré de cette campagne |
geo_urnsFacultatif | array<string> | URN de la facette locations (linkedin_targeting_search) |
job_title_urnsFacultatif | array<string> | URN de la facette titles (linkedin_targeting_search) |
job_function_urnsFacultatif | array<string> | URN de la facette jobFunctions (linkedin_targeting_search) |
seniority_urnsFacultatif | array<string> | URN de la facette seniorities (linkedin_targeting_search) |
industry_urnsFacultatif | array<string> | URN de la facette industries (linkedin_targeting_search) |
skill_urnsFacultatif | array<string> | URN de la facette skills (linkedin_targeting_search) |
staff_count_urnsFacultatif | array<string> | URN de la facette staffCountRanges (linkedin_targeting_search) |
employer_urnsFacultatif | array<string> | URN de la facette employers (linkedin_targeting_search) |
include_audience_urnsFacultatif | array<string> | URN de la facette audienceMatchingSegments (linkedin_targeting_search) |
exclude_geo_urnsFacultatif | array<string> | URN de la facette locations (linkedin_targeting_search) |
exclude_title_urnsFacultatif | array<string> | URN de la facette titles (linkedin_targeting_search) |
exclude_function_urnsFacultatif | array<string> | URN de la facette jobFunctions (linkedin_targeting_search) |
exclude_seniority_urnsFacultatif | array<string> | URN de la facette seniorities (linkedin_targeting_search) |
exclude_industry_urnsFacultatif | array<string> | URN de la facette industries (linkedin_targeting_search) |
exclude_skill_urnsFacultatif | array<string> | URN de la facette skills (linkedin_targeting_search) |
exclude_staff_count_urnsFacultatif | array<string> | URN de la facette staffCountRanges (linkedin_targeting_search) |
exclude_employer_urnsFacultatif | array<string> | URN de la facette employers (linkedin_targeting_search) |
exclude_audience_urnsFacultatif | array<string> | URN de la facette audienceMatchingSegments (linkedin_targeting_search) |
location_modeFacultatif | recent_or_permanent | permanent | recent_or_permanent (par défaut, facette locations) ou permanent (facette profileLocations) |
audience_languageFacultatif | string | paramètre régional de l'interface, p. ex. en_US, tr_TR ou urn:li:locale:tr_TR (par défaut en_US) |
list_linkedin_audiences
Lecture1 créditsAudiences correspondantes (segments publicitaires, adSegments) d'un compte publicitaire LinkedIn : listes importées, reciblage du site web, automatisation marketing et audiences prédictives, avec statut et nombre approximatif de membres. Utilisez l'urn dans le ciblage (include_audience_urns). Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
typesFacultatif | array<string> | BULK | RETARGETING | MARKET_AUTOMATION | BUSINESS_OBJECTIVE_BASED_AUDIENCE |
statusesFacultatif | array<string> | BUILDING | READY | UPDATING | FAILED | ARCHIVED | EXPIRED … |
list_linkedin_conversions
Lecture1 créditsRègles de suivi des conversions d'un compte publicitaire LinkedIn (conversions q=account) : id, nom, type, activée, fenêtres d'attribution, valeur et campagnes associées. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
list_linkedin_lead_forms
Lecture1 créditsLead Gen Forms d'un compte publicitaire LinkedIn (leadForms q=owner) : id, nom, état, version et nombre de questions. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
download_linkedin_leads
Lecture2 créditsProspects envoyés via les Lead Gen Forms LinkedIn (leadFormResponses) : heure d'envoi, campagne, création, toutes les réponses et consentements. Données personnelles : à utiliser dans le cadre du consentement du formulaire. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
form_idFacultatif | string | id du formulaire pour prospects (list_linkedin_lead_forms) ; associe les réponses aux noms des questions |
sinceFacultatif | string | YYYY-MM-DD |
untilFacultatif | string | YYYY-MM-DD (par défaut aujourd'hui) |
test_onlyFacultatif | boolean | — |
limitFacultatif | integer (1–1000) | — |
linkedin_ad_copy
Lecture1 créditsLit le texte réel des publicités LinkedIn : titre/description/page de destination d'une annonce textuelle, ou texte, titre d'article, page de destination et incitation à l'action d'un post sponsorisé. Lecture seule ; à combiner avec linkedin_performance_report pour comparer les messages.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
creative_idsFacultatif | array<string> | urn/id des créations |
post_urnsFacultatif | array<string> | urn:li:share / urn:li:ugcPost |
Outils d'écriture20 outils
create_linkedin_campaign_group
Écriture2 créditsCrée un groupe de campagnes LinkedIn (en pause par défaut). Renvoie un aperçu et ouvre un élément de validation ; créé sur LinkedIn uniquement après validation et uniquement avec un compte connecté.
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
statusFacultatif | ACTIVE | PAUSED | DRAFT | PAUSED par défaut |
daily_budgetFacultatif | number | devise du compte ; budget dynamique partagé par les campagnes du groupe |
total_budgetFacultatif | number | devise du compte ; nécessite end_date |
end_dateFacultatif | string | YYYY-MM-DD |
objectiveFacultatif | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | — |
bid_strategyFacultatif | MAXIMUM_DELIVERY | MANUAL | COST_CAP | — |
currencyFacultatif | string | ISO currency for the preview when the ad account currency is unknown |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_linkedin_campaign
Écriture2 créditsCrée une campagne LinkedIn (contenu sponsorisé ou annonce texte) avec budget, objectif, enchères et ciblage issu de build_linkedin_audience. Écrit un brouillon dans le registre et ouvre un élément de validation avec aperçu ; créée sur LinkedIn (en pause par défaut) après validation. Ajoutez des créations avec create_linkedin_sponsored_content / create_linkedin_text_ad.
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
daily_budgetObligatoire | number | devise du compte |
targeting_criteriaObligatoire | object | JSON targetingCriteria exactement tel que renvoyé par build_linkedin_audience |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
campaign_groupFacultatif | string | urn/id du groupe de campagnes ; par défaut : le groupe par défaut du compte |
objectiveFacultatif | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | WEBSITE_VISITS par défaut ; LEAD_GENERATION pour les formulaires de prospects |
typeFacultatif | SPONSORED_UPDATES | TEXT_AD | SPONSORED_UPDATES par défaut |
statusFacultatif | PAUSED | ACTIVE | PAUSED par défaut (aucune dépense avant reprise) |
total_budgetFacultatif | number | — |
unit_costFacultatif | number | enchère manuelle ; omise = enchères automatiques |
cost_typeFacultatif | CPC | CPM | — |
locale_countryFacultatif | string | — |
locale_languageFacultatif | string | — |
organization_urnFacultatif | string | page entreprise pour le contenu sponsorisé ; par défaut : la référence du compte publicitaire |
audience_expansionFacultatif | boolean | — |
offsite_deliveryFacultatif | boolean | LinkedIn Audience Network |
political_intentFacultatif | 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 |
goalFacultatif | string | — |
currencyFacultatif | string | ISO currency for the preview when the ad account currency is unknown |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_linkedin_campaign_budget
Écriture2 créditsModifie le budget quotidien, le budget total et/ou l'enchère d'une campagne LinkedIn. Renvoie un aperçu avec les valeurs actuelle → nouvelle ; appliqué après validation (les baisses de budget et les petites hausses peuvent s'appliquer automatiquement selon la politique de validation de l'utilisateur).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (uuid) ou urn/id de campagne LinkedIn issu de list_linkedin_campaigns |
daily_budgetFacultatif | number | devise du compte |
total_budgetFacultatif | number | — |
unit_costFacultatif | number | enchère manuelle (fait passer la campagne en enchères manuelles) |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
currencyFacultatif | string | ISO currency for the preview when the ad account currency is unknown |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_linkedin_campaign_status
Écriture2 créditsMet en pause, reprend (ACTIVE) ou archive une campagne LinkedIn. Passe par l'aperçu et la politique de validation.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (uuid) ou urn/id de campagne LinkedIn issu de list_linkedin_campaigns |
statusObligatoire | ACTIVE | PAUSED | ARCHIVED | — |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_linkedin_campaign_group_status
ÉcritureIrréversible2 créditsActive, met en pause, archive, passe en brouillon ou supprime (PENDING_DELETION) un groupe de campagnes LinkedIn. Toujours prévisualisé et validé d'abord.
| Paramètre | Type | Description |
|---|---|---|
campaign_groupObligatoire | string | urn ou id du groupe de campagnes |
statusObligatoire | ACTIVE | PAUSED | ARCHIVED | DRAFT | PENDING_DELETION | PENDING_DELETION supprime le groupe (irréversible) |
nameFacultatif | string | pour l'aperçu uniquement |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_linkedin_campaign_group_budget
Écriture2 créditsMet à jour le budget total, le budget quotidien, la date de fin ou le nom d'un groupe de campagnes LinkedIn. Prévisualisé et validé d'abord.
| Paramètre | Type | Description |
|---|---|---|
campaign_groupObligatoire | string | — |
total_budgetFacultatif | number | — |
daily_budgetFacultatif | number | — |
end_dateFacultatif | string | YYYY-MM-DD |
nameFacultatif | string | — |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
currencyFacultatif | string | ISO currency for the preview when the ad account currency is unknown |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_linkedin_campaign_targeting
Écriture2 créditsRemplace le ciblage d'une campagne LinkedIn par targeting_criteria issu de build_linkedin_audience. Prévisualisé et validé d'abord.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (uuid) ou urn/id de campagne LinkedIn issu de list_linkedin_campaigns |
targeting_criteriaFacultatif | object | JSON targetingCriteria exactement tel que renvoyé par build_linkedin_audience |
audienceFacultatif | object | estimation d'audience issue de build_linkedin_audience (pour l'aperçu) |
interface_localeFacultatif | string | — |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
geo_urnsFacultatif | array<string> | URNs for the locations facet (linkedin_targeting_search) |
job_title_urnsFacultatif | array<string> | URNs for the titles facet (linkedin_targeting_search) |
job_function_urnsFacultatif | array<string> | URNs for the jobFunctions facet (linkedin_targeting_search) |
seniority_urnsFacultatif | array<string> | URNs for the seniorities facet (linkedin_targeting_search) |
industry_urnsFacultatif | array<string> | URNs for the industries facet (linkedin_targeting_search) |
skill_urnsFacultatif | array<string> | URNs for the skills facet (linkedin_targeting_search) |
staff_count_urnsFacultatif | array<string> | URNs for the staffCountRanges facet (linkedin_targeting_search) |
employer_urnsFacultatif | array<string> | URNs for the employers facet (linkedin_targeting_search) |
include_audience_urnsFacultatif | array<string> | URNs for the audienceMatchingSegments facet (linkedin_targeting_search) |
exclude_geo_urnsFacultatif | array<string> | URNs for the locations facet (linkedin_targeting_search) |
exclude_title_urnsFacultatif | array<string> | URNs for the titles facet (linkedin_targeting_search) |
exclude_function_urnsFacultatif | array<string> | URNs for the jobFunctions facet (linkedin_targeting_search) |
exclude_seniority_urnsFacultatif | array<string> | URNs for the seniorities facet (linkedin_targeting_search) |
exclude_industry_urnsFacultatif | array<string> | URNs for the industries facet (linkedin_targeting_search) |
exclude_skill_urnsFacultatif | array<string> | URNs for the skills facet (linkedin_targeting_search) |
exclude_staff_count_urnsFacultatif | array<string> | URNs for the staffCountRanges facet (linkedin_targeting_search) |
exclude_employer_urnsFacultatif | array<string> | URNs for the employers facet (linkedin_targeting_search) |
exclude_audience_urnsFacultatif | array<string> | URNs for the audienceMatchingSegments facet (linkedin_targeting_search) |
location_modeFacultatif | recent_or_permanent | permanent | recent_or_permanent (default, locations facet) or permanent (profileLocations facet) |
audience_languageFacultatif | string | interface locale, e.g. en_US, tr_TR or urn:li:locale:tr_TR (default en_US) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
upload_linkedin_image
Écriture2 créditsImporte une image depuis une URL (y compris celles générées dans Studio, jusqu'à 5 Mo) sur LinkedIn ; renvoie urn:li:image pour les créations.
| Paramètre | Type | Description |
|---|---|---|
image_urlObligatoire | string | — |
organization_urnFacultatif | string | — |
account_idFacultatif | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_linkedin_sponsored_content
Écriture2 créditsTransforme une publication existante de la page entreprise en contenu sponsorisé (une création) dans une campagne LinkedIn, ou crée une nouvelle publication masquée (dark post) comme création. Prévisualisé et validé d'abord ; LinkedIn vérifie la création avant diffusion.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (uuid) ou urn/id de campagne LinkedIn issu de list_linkedin_campaigns |
post_urnFacultatif | string | urn de publication existante de la page urn:li:share:… / urn:li:ugcPost:… (list_linkedin_posts) |
commentaryFacultatif | string | texte d'une NOUVELLE publication masquée lorsque post_urn n'est pas fourni |
landing_pageFacultatif | string | — |
cta_labelFacultatif | string | LEARN_MORE | SIGN_UP | DOWNLOAD | REGISTER | APPLY | ... |
image_urnFacultatif | string | urn:li:image:… from upload_linkedin_image |
article_urlFacultatif | string | — |
article_titleFacultatif | string | — |
article_descriptionFacultatif | string | — |
lead_form_urnFacultatif | string | urn:li:adForm:… pour les campagnes LEAD_GENERATION |
organization_urnFacultatif | string | — |
nameFacultatif | string | — |
statusFacultatif | ACTIVE | PAUSED | DRAFT | PAUSED par défaut |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_linkedin_text_ad
Écriture2 créditsCrée une création d'annonce texte LinkedIn (titre ≤25, description ≤75 caractères, page de destination) dans une campagne TEXT_AD. Prévisualisé et validé d'abord.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (uuid) ou urn/id de campagne LinkedIn issu de list_linkedin_campaigns |
headlineObligatoire | string | — |
descriptionObligatoire | string | — |
landing_pageObligatoire | string | — |
image_urnFacultatif | string | urn:li:image:… 100x100 (facultatif) |
nameFacultatif | string | — |
statusFacultatif | ACTIVE | PAUSED | DRAFT | PAUSED par défaut |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_linkedin_creative_status
Écriture2 créditsMet en pause, active, archive ou passe en brouillon une ou plusieurs créations LinkedIn (p. ex. celles avec des impressions mais aucune conversion). Prévisualisé et validé d'abord ; les créations en cours de vérification ne peuvent pas être mises en pause.
| Paramètre | Type | Description |
|---|---|---|
creative_idsFacultatif | array<string> | urns/ids de créations (list_linkedin_creatives) |
creative_idFacultatif | string | — |
statusObligatoire | ACTIVE | PAUSED | ARCHIVED | DRAFT | — |
campaign_idFacultatif | string | facultatif ; aide à choisir le compte publicitaire |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_linkedin_conversion
Écriture2 créditsCrée une règle de suivi des conversions sur le LinkedIn Insight Tag (POST conversions) : à l'échelle du site via des règles d'URL (p. ex. l'URL contient /merci) ou spécifique à un événement. À associer ensuite à une campagne avec attach_linkedin_conversion. Aperçu et validation d'abord.
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
typeObligatoire | ADD_TO_CART | DOWNLOAD | INSTALL | KEY_PAGE_VIEW | LEAD | PURCHASE | SIGN_UP | OTHER | — |
url_rulesFacultatif | array<object> | règle à l'échelle du site : les règles sont combinées par ET ; laissez vide pour une conversion spécifique à un événement |
post_click_daysFacultatif | 1 | 7 | 30 | — |
view_through_daysFacultatif | 1 | 7 | 30 | — |
valueFacultatif | number | — |
currencyFacultatif | string | — |
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
attach_linkedin_conversion
Écriture1 créditsAssocie une règle de suivi des conversions à une campagne LinkedIn (campaignConversions PUT) pour qu'elle la mesure et optimise dessus. Aperçu et validation d'abord.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (uuid) ou urn/id de campagne LinkedIn depuis list_linkedin_campaigns |
conversion_idObligatoire | string | depuis list_linkedin_conversions |
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
detach_linkedin_conversion
ÉcritureIrréversible1 créditsDissocie une règle de suivi des conversions d'une campagne LinkedIn (campaignConversions DELETE). Aperçu et validation d'abord.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (uuid) ou urn/id de campagne LinkedIn depuis list_linkedin_campaigns |
conversion_idObligatoire | string | — |
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
delete_linkedin_campaign
ÉcritureIrréversible5 créditsSupprime une campagne LinkedIn : une campagne DRAFT est supprimée définitivement, toute autre passe en PENDING_DELETION (les données de rapport restent). Irréversible ; attend toujours une validation explicite.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (uuid) ou urn/id de campagne LinkedIn depuis list_linkedin_campaigns |
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
delete_linkedin_campaign_group
ÉcritureIrréversible5 créditsSupprime un groupe de campagnes LinkedIn : définitivement s'il est en DRAFT, sinon marqué PENDING_DELETION. Irréversible ; attend toujours une validation explicite.
| Paramètre | Type | Description |
|---|---|---|
campaign_groupObligatoire | string | urn ou id du groupe de campagnes |
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
delete_linkedin_creative
ÉcritureIrréversible5 créditsSupprime une création (annonce) LinkedIn : définitivement si elle est en DRAFT, sinon marquée PENDING_DELETION. Irréversible ; attend toujours une validation explicite.
| Paramètre | Type | Description |
|---|---|---|
creative_idObligatoire | string | urn ou id de la création |
campaign_idFacultatif | string | facultatif ; aide à choisir le compte publicitaire |
account_idFacultatif | string | id du compte publicitaire LinkedIn (depuis list_linkedin_accounts) ; facultatif si la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_linkedin_campaign
Écriture5 créditsMet à jour une campagne LinkedIn en un seul appel : nom, objectif d'optimisation, type de coût et calendrier en une action ; budget/enchère et statut sont ouverts comme actions protégées distinctes (mêmes règles que update_linkedin_campaign_budget / _status). Chacune est approuvée séparément.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (uuid) ou urn/id de campagne LinkedIn issu de list_linkedin_campaigns |
nameFacultatif | string | — |
statusFacultatif | ACTIVE | PAUSED | ARCHIVED | — |
daily_budgetFacultatif | number | devise du compte ; passe par le garde-fou budgétaire |
unit_costFacultatif | number | enchère manuelle |
optimization_targetFacultatif | string | p. ex. MAX_CLICK, MAX_LEAD, MAX_CONVERSION, NONE (manuel) |
cost_typeFacultatif | CPC | CPM | CPV | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
currencyFacultatif | string | devise ISO pour l'aperçu lorsque la devise du compte publicitaire est inconnue |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_linkedin_campaign_group
Écriture5 créditsMet à jour un groupe de campagnes LinkedIn (uniquement les champs fournis) : nom, statut, budget total, objectif, dates de début et de fin. Aperçu et approbation d'abord ; les hausses de budget de plus de +50 % sont refusées.
| Paramètre | Type | Description |
|---|---|---|
campaign_groupObligatoire | string | — |
nameFacultatif | string | — |
statusFacultatif | ACTIVE | PAUSED | ARCHIVED | DRAFT | — |
total_budgetFacultatif | number | devise du compte ; garde-fou de +50 % par modification |
objectiveFacultatif | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
currencyFacultatif | string | devise ISO pour l'aperçu lorsque la devise du compte publicitaire est inconnue |
account_idFacultatif | string | id du compte publicitaire LinkedIn (issu de list_linkedin_accounts) ; facultatif lorsque la connexion n'a qu'un compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_linkedin_ad_account
ÉcritureIrréversible2 créditsCreate 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 description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | account name, e.g. “Acme Ads” |
currencyObligatoire | 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_urnFacultatif | string | optional company page urn:li:organization:{id} the account advertises for |
connection_idFacultatif | string | optional: which LinkedIn identity (connection) opens the account |
forceFacultatif | boolean | create even though this identity already has an ad account |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.