LinkedIn Ads araçları
Kampanya grupları, kampanyalar, sponsorlu içerik, metin reklamları, hedefleme ve demografik raporlar.
Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü özgün İngilizce metinlerdir.
Okuma araçları8 araç
list_linkedin_accounts
Okuma1 krediLinkedIn 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.
Bu araç parametre almaz.
list_linkedin_campaign_groups
Okuma1 krediCampaign groups of a LinkedIn ad account with status, serving statuses, objective, total/daily budget and schedule. Read only.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
statusesİsteğe bağlı | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED (default all four) |
list_linkedin_campaigns
Okuma1 krediLinkedIn 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.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
campaign_groupİsteğe bağlı | string | filter by campaign group urn or id |
statusesİsteğe bağlı | array<string> | ACTIVE | PAUSED | DRAFT | COMPLETED | ARCHIVED | CANCELED |
sync_ledgerİsteğe bağlı | boolean | also import campaigns into the Tecrübe ledger (default true) |
list_linkedin_creatives
Okuma1 krediCreatives (ads) of LinkedIn campaigns: intended status, serving state and hold reasons, review status, referenced post or text-ad fields. Read only.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
campaign_idsİsteğe bağlı | array<string> | campaign urns/ids; default: all active/paused/draft campaigns |
statusesİsteğe bağlı | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED | CANCELED |
limitİsteğe bağlı | integer (1–100) | — |
linkedin_performance_report
Okuma2 krediLinkedIn 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.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
daysİsteğe bağlı | integer (1–366) | last N days incl. today (default 30) |
start_dateİsteğe bağlı | string | YYYY-MM-DD (overrides days) |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
pivotİsteğe bağlı | CAMPAIGN | CAMPAIGN_GROUP | CREATIVE | ACCOUNT | — |
campaign_idsİsteğe bağlı | array<string> | restrict to these campaign urns/ids (required for creative names with pivot=CREATIVE) |
campaign_group_idsİsteğe bağlı | array<string> | — |
time_granularityİsteğe bağlı | ALL | DAILY | — |
sort_byİsteğe bağlı | cpl | spend | impressions | clicks | leads | conversions | ctr | — |
linkedin_demographics_report
Okuma2 krediLinkedIn 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.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
pivotsİsteğe bağlı | array<MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2> | default: all six |
pivotİsteğe bağlı | MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2 | — |
daysİsteğe bağlı | integer (1–366) | last N days incl. today (default 30) |
start_dateİsteğe bağlı | string | YYYY-MM-DD (overrides days) |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
campaign_idsİsteğe bağlı | array<string> | restrict to these campaign urns/ids |
campaign_group_idsİsteğe bağlı | array<string> | — |
limitİsteğe bağlı | integer (1–100) | rows per dimension (default 25, by impressions) |
locale_languageİsteğe bağlı | string | names language, default en |
locale_countryİsteğe bağlı | string | default US |
build_linkedin_audience
Okuma2 krediResolve 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.
| Parametre | Tip | Açıklama |
|---|---|---|
titlesİsteğe bağlı | array<string> | job titles, e.g. Marketing Manager |
industriesİsteğe bağlı | array<string> | — |
locationsİsteğe bağlı | array<string> | cities / regions / countries, e.g. Istanbul, Turkey (at least one is required by LinkedIn) |
company_sizesİsteğe bağlı | array<string> | e.g. '200+', '51-200', '1001+' |
senioritiesİsteğe bağlı | array<string> | — |
job_functionsİsteğe bağlı | array<string> | — |
skillsİsteğe bağlı | array<string> | — |
employersİsteğe bağlı | array<string> | company names (cannot be combined with industries / company_sizes) |
exclude_titlesİsteğe bağlı | array<string> | — |
exclude_employersİsteğe bağlı | array<string> | — |
exclude_industriesİsteğe bağlı | array<string> | — |
interface_localesİsteğe bağlı | array<string> | e.g. urn:li:locale:en_US, urn:li:locale:tr_TR (default en_US) |
locale_languageİsteğe bağlı | string | search language, default en |
locale_countryİsteğe bağlı | string | default US |
estimateİsteğe bağlı | boolean | fetch audience count (default true) |
list_linkedin_posts
Okuma1 krediLatest 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.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
organization_urnİsteğe bağlı | string | urn:li:organization:{id}; default: the ad account's company page |
countİsteğe bağlı | integer (1–100) | — |
Yazma araçları10 araç
create_linkedin_campaign_group
Yazma2 krediCreate 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.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
statusİsteğe bağlı | ACTIVE | PAUSED | DRAFT | default PAUSED |
daily_budgetİsteğe bağlı | number | account currency; dynamic budget shared by the group's campaigns |
total_budgetİsteğe bağlı | number | account currency; requires end_date |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
objectiveİsteğe bağlı | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | — |
bid_strategyİsteğe bağlı | MAXIMUM_DELIVERY | MANUAL | COST_CAP | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_linkedin_campaign
Yazma2 krediCreate 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.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
daily_budgetZorunlu | number | account currency |
targeting_criteriaZorunlu | object | targetingCriteria JSON exactly as returned by build_linkedin_audience |
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
campaign_groupİsteğe bağlı | string | campaign group urn/id; default: the account's default group |
objectiveİsteğe bağlı | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | default WEBSITE_VISITS; LEAD_GENERATION for lead forms |
typeİsteğe bağlı | SPONSORED_UPDATES | TEXT_AD | default SPONSORED_UPDATES |
statusİsteğe bağlı | PAUSED | ACTIVE | default PAUSED (nothing spends until resumed) |
total_budgetİsteğe bağlı | number | — |
unit_costİsteğe bağlı | number | manual bid; omitted = automated bidding |
cost_typeİsteğe bağlı | CPC | CPM | — |
locale_countryİsteğe bağlı | string | — |
locale_languageİsteğe bağlı | string | — |
organization_urnİsteğe bağlı | string | company page for sponsored content; default: the ad account's reference |
audience_expansionİsteğe bağlı | boolean | — |
offsite_deliveryİsteğe bağlı | boolean | LinkedIn Audience Network |
political_intentİsteğe bağlı | NOT_POLITICAL | POLITICAL | — |
goalİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign_budget
Yazma2 krediChange 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe campaign id (uuid) or LinkedIn campaign urn/id from list_linkedin_campaigns |
daily_budgetİsteğe bağlı | number | account currency |
total_budgetİsteğe bağlı | number | — |
unit_costİsteğe bağlı | number | manual bid (switches the campaign to manual bidding) |
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign_status
Yazma2 krediPause, resume (ACTIVE) or archive a LinkedIn campaign. Goes through preview and the approval policy.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe campaign id (uuid) or LinkedIn campaign urn/id from list_linkedin_campaigns |
statusZorunlu | ACTIVE | PAUSED | ARCHIVED | — |
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign_group_status
YazmaGeri alınamaz2 krediActivate, pause, archive, draft or delete (PENDING_DELETION) a LinkedIn campaign group. Always previewed and approved first.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_groupZorunlu | string | campaign group urn or id |
statusZorunlu | ACTIVE | PAUSED | ARCHIVED | DRAFT | PENDING_DELETION | PENDING_DELETION deletes the group (irreversible) |
nameİsteğe bağlı | string | for the preview only |
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign_group_budget
Yazma2 krediUpdate a LinkedIn campaign group's total budget, daily budget, end date or name. Previewed and approved first.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_groupZorunlu | string | — |
total_budgetİsteğe bağlı | number | — |
daily_budgetİsteğe bağlı | number | — |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
nameİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign_targeting
Yazma2 krediReplace a LinkedIn campaign's targeting with targeting_criteria from build_linkedin_audience. Previewed and approved first.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe campaign id (uuid) or LinkedIn campaign urn/id from list_linkedin_campaigns |
targeting_criteriaZorunlu | object | targetingCriteria JSON exactly as returned by build_linkedin_audience |
audienceİsteğe bağlı | object | audience estimate from build_linkedin_audience (for the preview) |
interface_localeİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_linkedin_sponsored_content
Yazma2 krediTurn 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe campaign id (uuid) or LinkedIn campaign urn/id from list_linkedin_campaigns |
post_urnİsteğe bağlı | string | existing page post urn:li:share:… / urn:li:ugcPost:… (list_linkedin_posts) |
commentaryİsteğe bağlı | string | text for a NEW dark post when no post_urn is given |
landing_pageİsteğe bağlı | string | — |
cta_labelİsteğe bağlı | string | LEARN_MORE | SIGN_UP | DOWNLOAD | REGISTER | APPLY | ... |
article_urlİsteğe bağlı | string | — |
article_titleİsteğe bağlı | string | — |
article_descriptionİsteğe bağlı | string | — |
lead_form_urnİsteğe bağlı | string | urn:li:adForm:… for LEAD_GENERATION campaigns |
organization_urnİsteğe bağlı | string | — |
nameİsteğe bağlı | string | — |
statusİsteğe bağlı | ACTIVE | PAUSED | DRAFT | default PAUSED |
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_linkedin_text_ad
Yazma2 krediCreate a LinkedIn text ad creative (headline ≤25, description ≤75 chars, landing page) in a TEXT_AD campaign. Previewed and approved first.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe campaign id (uuid) or LinkedIn campaign urn/id from list_linkedin_campaigns |
headlineZorunlu | string | — |
descriptionZorunlu | string | — |
landing_pageZorunlu | string | — |
image_urnİsteğe bağlı | string | urn:li:image:… 100x100 (optional) |
nameİsteğe bağlı | string | — |
statusİsteğe bağlı | ACTIVE | PAUSED | DRAFT | default PAUSED |
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_creative_status
Yazma2 krediPause, 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.
| Parametre | Tip | Açıklama |
|---|---|---|
creative_idsİsteğe bağlı | array<string> | creative urns/ids (list_linkedin_creatives) |
creative_idİsteğe bağlı | string | — |
statusZorunlu | ACTIVE | PAUSED | ARCHIVED | DRAFT | — |
campaign_idİsteğe bağlı | string | optional; helps pick the ad account |
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.