LinkedIn-Ads-Tools
Kampagnengruppen, Kampagnen, Sponsored Content, Textanzeigen, Targeting und demografische Berichte.
Die Integration für diesen Kanal ist fertig; die Verbindung wird freigeschaltet, sobald die Plattform unsere Entwickler-App genehmigt. Bis dahin können keine Konten verbunden werden, und die auf dieser Seite beschriebenen Aktionen sind nicht verfügbar.
Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind Übersetzungen des Textes, den der Assistent sieht, Tool- und Parameternamen bleiben unverändert.
Lese-Tools16 Tools
list_linkedin_accounts
Lesen1 CreditsLinkedIn Werbekonten, auf die der verbundene Nutzer zugreifen kann (id, Name, Währung, Status, Auslieferungsstatus, Verweis auf die Unternehmensseite). Agenturen: wählen Sie account_id für die anderen Tools. Nur lesend; gibt connected=false zurück, wenn kein Konto verknüpft ist.
Dieses Tool hat keine Parameter.
list_linkedin_campaign_groups
Lesen1 CreditsKampagnengruppen eines LinkedIn Werbekontos mit Status, Auslieferungsstatus, Ziel, Gesamt-/Tagesbudget und Zeitplan. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
statusesOptional | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED (Standard alle vier) |
list_linkedin_campaigns
Lesen1 CreditsLinkedIn Kampagnen mit Status, Ziel, Typ, Tages-/Gesamtbudget, Gebot, Währung, Kampagnengruppe und Targeting. Gibt urn und ledger_campaign_id für die Update-Tools zurück. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
campaign_groupOptional | string | nach URN oder ID der Kampagnengruppe filtern |
statusesOptional | array<string> | ACTIVE | PAUSED | DRAFT | COMPLETED | ARCHIVED | CANCELED |
sync_ledgerOptional | boolean | Kampagnen zusätzlich in den Tecrübe-Ledger importieren (Standard true) |
list_linkedin_creatives
Lesen1 CreditsCreatives (Anzeigen) von LinkedIn Kampagnen: beabsichtigter Status, Auslieferungszustand und Sperrgründe, Prüfstatus und die Ablehnungsgründe von LinkedIn (review_rejection_reasons), referenzierter Post oder Textanzeigenfelder. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
campaign_idsOptional | array<string> | Kampagnen-URNs/IDs; Standard: alle aktiven/pausierten/Entwurfskampagnen |
statusesOptional | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED | CANCELED |
limitOptional | integer (1–100) | — |
linkedin_performance_report
Lesen2 CreditsLinkedIn Anzeigenanalysen für einen Zeitraum: Ausgaben, Impressionen, Klicks, CTR, CPC, CPM, Lead-Formular-Öffnungen, Leads, Website-Conversions, Conversion-Wert, Kosten pro Lead (CPL) und Kosten pro Conversion je Kampagne / Kampagnengruppe / Creative / Konto, plus Summen und die Zeilen mit 500+ Impressionen und null Conversions. Nur echte Zahlen; niemals erfunden.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
daysOptional | integer (1–366) | letzte N Tage inkl. heute (Standard 30) |
start_dateOptional | string | YYYY-MM-DD (überschreibt days) |
end_dateOptional | string | YYYY-MM-DD |
pivotOptional | CAMPAIGN | CAMPAIGN_GROUP | CREATIVE | ACCOUNT | — |
campaign_idsOptional | array<string> | auf diese Kampagnen-URNs/IDs einschränken (erforderlich für Creative-Namen mit pivot=CREATIVE) |
campaign_group_idsOptional | array<string> | — |
time_granularityOptional | ALL | DAILY | — |
sort_byOptional | cpl | spend | impressions | clicks | leads | conversions | ctr | — |
linkedin_demographics_report
Lesen2 CreditsBerufliche Demografie auf LinkedIn derjenigen, die Ihre Anzeigen gesehen, angeklickt und konvertiert haben: Jobtitel, Karrierestufe, Tätigkeitsbereich, Branche, Unternehmensgröße und Land (adAnalytics MEMBER_*-Pivots) mit Impressionen, Klicks, CTR, Ausgaben, Leads, CPL und Website-Conversions; URNs werden in lesbare Namen aufgelöst. Jede Dimension meldet den durch die Datenschutzschwelle von LinkedIn verborgenen Anteil (Werte mit weniger als 3 Ereignissen werden verworfen), statt Zeilen zu erfinden. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
pivotsOptional | array<MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2> | Standard: alle sechs |
pivotOptional | MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2 | — |
daysOptional | integer (1–366) | letzte N Tage inkl. heute (Standard 30) |
start_dateOptional | string | YYYY-MM-DD (überschreibt days) |
end_dateOptional | string | YYYY-MM-DD |
campaign_idsOptional | array<string> | auf diese Kampagnen-URNs/IDs einschränken |
campaign_group_idsOptional | array<string> | — |
limitOptional | integer (1–100) | Zeilen pro Dimension (Standard 25, nach Impressionen) |
locale_languageOptional | string | Sprache der Namen, Standard en |
locale_countryOptional | string | Standard US |
build_linkedin_audience
Lesen2 CreditsLöst Targeting in Alltagssprache (Titel, Unternehmen, Branchen, Unternehmensgrößen, Standorte, Karrierestufen, Tätigkeitsbereiche, Kenntnisse) in LinkedIn-Targeting-Facetten auf und gibt targetingCriteria sowie die geschätzte Zielgruppengröße zurück. Verwirft Facettenkombinationen, die LinkedIn ablehnt, und weist darauf hin. Nur lesend; übergeben Sie targeting_criteria an create_linkedin_campaign oder update_linkedin_campaign_targeting.
| Parameter | Typ | Beschreibung |
|---|---|---|
titlesOptional | array<string> | Jobtitel, z. B. Marketing Manager |
industriesOptional | array<string> | — |
locationsOptional | array<string> | Städte / Regionen / Länder, z. B. Istanbul, Turkey (LinkedIn verlangt mindestens einen) |
company_sizesOptional | array<string> | z. B. '200+', '51-200', '1001+' |
senioritiesOptional | array<string> | — |
job_functionsOptional | array<string> | — |
skillsOptional | array<string> | — |
employersOptional | array<string> | Unternehmensnamen (nicht kombinierbar mit industries / company_sizes) |
companiesOptional | array<string> | Alias of employers |
exclude_titlesOptional | array<string> | — |
exclude_employersOptional | array<string> | — |
exclude_industriesOptional | array<string> | — |
interface_localesOptional | array<string> | z. B. urn:li:locale:en_US, urn:li:locale:tr_TR (Standard en_US) |
locale_languageOptional | string | Suchsprache, Standard en |
locale_countryOptional | string | Standard US |
estimateOptional | boolean | Zielgruppengröße abrufen (Standard true) |
list_linkedin_posts
Lesen1 CreditsNeueste Beiträge der Unternehmensseite (URN, Text, Inhaltstyp, Veröffentlichungszeit, Sponsored-Kennzeichen), um einen für create_linkedin_sponsored_content auszuwählen. Benötigt den Scope r_organization_social; andernfalls wird ein Hinweis zurückgegeben. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
organization_urnOptional | string | urn:li:organization:{id}; Standard: die Unternehmensseite des Werbekontos |
countOptional | integer (1–100) | — |
linkedin_targeting_search
Lesen1 CreditsSucht LinkedIn-Targeting-Entitäten innerhalb einer Facette nach Namen (adTargetingEntities-Typeahead / Facettenliste) und gibt ihre URNs und Namen zurück. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
queryOptional | string | zu suchender Name; leer listet die ganze Facette auf (seniorities, jobFunctions, staffCountRanges) |
facetOptional | titles | industries | locations | employers | skills | seniorities | jobFunctions | staffCountRanges | Standard titles |
locale_languageOptional | string | Standard en |
locale_countryOptional | string | Standard US |
linkedin_audience_forecast
Lesen1 CreditsSchätzt, wie viele LinkedIn-Mitglieder ein Targeting erreicht (audienceCounts): Gesamt- und aktive Mitglieder, mit Warnungen unterhalb des Minimums von 300 Mitgliedern oder ohne Standort. Akzeptiert targeting_criteria, URN-Listen pro Facette oder das gespeicherte Targeting einer Kampagne. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
targeting_criteriaOptional | object | targetingCriteria-JSON genau so, wie build_linkedin_audience es zurückgibt |
campaign_idOptional | string | das gespeicherte Targeting dieser Kampagne verwenden, wenn kein anderes Targeting angegeben ist |
geo_urnsOptional | array<string> | URNs für die Facette locations (linkedin_targeting_search) |
job_title_urnsOptional | array<string> | URNs für die Facette titles (linkedin_targeting_search) |
job_function_urnsOptional | array<string> | URNs für die Facette jobFunctions (linkedin_targeting_search) |
seniority_urnsOptional | array<string> | URNs für die Facette seniorities (linkedin_targeting_search) |
industry_urnsOptional | array<string> | URNs für die Facette industries (linkedin_targeting_search) |
skill_urnsOptional | array<string> | URNs für die Facette skills (linkedin_targeting_search) |
staff_count_urnsOptional | array<string> | URNs für die Facette staffCountRanges (linkedin_targeting_search) |
employer_urnsOptional | array<string> | URNs für die Facette employers (linkedin_targeting_search) |
include_audience_urnsOptional | array<string> | URNs für die Facette audienceMatchingSegments (linkedin_targeting_search) |
exclude_geo_urnsOptional | array<string> | URNs für die Facette locations (linkedin_targeting_search) |
exclude_title_urnsOptional | array<string> | URNs für die Facette titles (linkedin_targeting_search) |
exclude_function_urnsOptional | array<string> | URNs für die Facette jobFunctions (linkedin_targeting_search) |
exclude_seniority_urnsOptional | array<string> | URNs für die Facette seniorities (linkedin_targeting_search) |
exclude_industry_urnsOptional | array<string> | URNs für die Facette industries (linkedin_targeting_search) |
exclude_skill_urnsOptional | array<string> | URNs für die Facette skills (linkedin_targeting_search) |
exclude_staff_count_urnsOptional | array<string> | URNs für die Facette staffCountRanges (linkedin_targeting_search) |
exclude_employer_urnsOptional | array<string> | URNs für die Facette employers (linkedin_targeting_search) |
exclude_audience_urnsOptional | array<string> | URNs für die Facette audienceMatchingSegments (linkedin_targeting_search) |
location_modeOptional | recent_or_permanent | permanent | recent_or_permanent (Standard, Facette locations) oder permanent (Facette profileLocations) |
audience_languageOptional | string | Oberflächen-Locale, z. B. en_US, tr_TR oder urn:li:locale:tr_TR (Standard en_US) |
linkedin_bid_recommendations
Lesen1 CreditsVon LinkedIn empfohlenes Gebot, Gebotsunter-/-obergrenze und Tagesbudgetgrenzen für eine Zielgruppe (adBudgetPricing criteriaV2), in der Währung des Werbekontos. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
campaign_typeOptional | SPONSORED_UPDATES | TEXT_AD | SPONSORED_INMAILS | — |
bid_typeOptional | CPM | CPC | CPV | — |
objective_typeOptional | string | z. B. WEBSITE_VISIT, LEAD_GENERATION, BRAND_AWARENESS, WEBSITE_CONVERSION, VIDEO_VIEW, ENGAGEMENT |
optimization_targetOptional | string | z. B. MAX_CLICK, MAX_LEAD, MAX_CONVERSION, NONE |
daily_budgetOptional | number | Kontowährung; präzisiert die Empfehlung |
audience_expansionOptional | boolean | — |
targeting_criteriaOptional | object | targetingCriteria-JSON genau so, wie build_linkedin_audience es zurückgibt |
campaign_idOptional | string | das gespeicherte Targeting dieser Kampagne verwenden |
geo_urnsOptional | array<string> | URNs für die Facette locations (linkedin_targeting_search) |
job_title_urnsOptional | array<string> | URNs für die Facette titles (linkedin_targeting_search) |
job_function_urnsOptional | array<string> | URNs für die Facette jobFunctions (linkedin_targeting_search) |
seniority_urnsOptional | array<string> | URNs für die Facette seniorities (linkedin_targeting_search) |
industry_urnsOptional | array<string> | URNs für die Facette industries (linkedin_targeting_search) |
skill_urnsOptional | array<string> | URNs für die Facette skills (linkedin_targeting_search) |
staff_count_urnsOptional | array<string> | URNs für die Facette staffCountRanges (linkedin_targeting_search) |
employer_urnsOptional | array<string> | URNs für die Facette employers (linkedin_targeting_search) |
include_audience_urnsOptional | array<string> | URNs für die Facette audienceMatchingSegments (linkedin_targeting_search) |
exclude_geo_urnsOptional | array<string> | URNs für die Facette locations (linkedin_targeting_search) |
exclude_title_urnsOptional | array<string> | URNs für die Facette titles (linkedin_targeting_search) |
exclude_function_urnsOptional | array<string> | URNs für die Facette jobFunctions (linkedin_targeting_search) |
exclude_seniority_urnsOptional | array<string> | URNs für die Facette seniorities (linkedin_targeting_search) |
exclude_industry_urnsOptional | array<string> | URNs für die Facette industries (linkedin_targeting_search) |
exclude_skill_urnsOptional | array<string> | URNs für die Facette skills (linkedin_targeting_search) |
exclude_staff_count_urnsOptional | array<string> | URNs für die Facette staffCountRanges (linkedin_targeting_search) |
exclude_employer_urnsOptional | array<string> | URNs für die Facette employers (linkedin_targeting_search) |
exclude_audience_urnsOptional | array<string> | URNs für die Facette audienceMatchingSegments (linkedin_targeting_search) |
location_modeOptional | recent_or_permanent | permanent | recent_or_permanent (Standard, Facette locations) oder permanent (Facette profileLocations) |
audience_languageOptional | string | Oberflächen-Locale, z. B. en_US, tr_TR oder urn:li:locale:tr_TR (Standard en_US) |
list_linkedin_audiences
Lesen1 CreditsMatched Audiences (Anzeigensegmente, adSegments) eines LinkedIn-Werbekontos: Listen-Uploads, Website-Retargeting, Marketing-Automation und prädiktive Zielgruppen mit Status und ungefährer Mitgliederzahl. Die URN im Targeting verwenden (include_audience_urns). Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
typesOptional | array<string> | BULK | RETARGETING | MARKET_AUTOMATION | BUSINESS_OBJECTIVE_BASED_AUDIENCE |
statusesOptional | array<string> | BUILDING | READY | UPDATING | FAILED | ARCHIVED | EXPIRED … |
list_linkedin_conversions
Lesen1 CreditsConversion-Tracking-Regeln eines LinkedIn-Werbekontos (conversions q=account): ID, Name, Typ, aktiviert, Attributionsfenster, Wert und zugeordnete Kampagnen. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
list_linkedin_lead_forms
Lesen1 CreditsLead Gen Forms eines LinkedIn-Werbekontos (leadForms q=owner): ID, Name, Status, Version und Anzahl der Fragen. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
download_linkedin_leads
Lesen2 CreditsÜber LinkedIn Lead Gen Forms eingereichte Leads (leadFormResponses): Einreichungszeit, Kampagne, Creative, alle Antworten und Einwilligungen. Personenbezogene Daten: im Rahmen der Einwilligung des Formulars verwenden. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
form_idOptional | string | Lead-Formular-ID (list_linkedin_lead_forms); ordnet Antworten den Fragenamen zu |
sinceOptional | string | YYYY-MM-DD |
untilOptional | string | YYYY-MM-DD (Standard heute) |
test_onlyOptional | boolean | — |
limitOptional | integer (1–1000) | — |
linkedin_ad_copy
Lesen1 CreditsLiest den tatsächlichen Text von LinkedIn-Anzeigen: Anzeigentitel/Beschreibung/Zielseite einer Textanzeige oder Text, Artikeltitel, Zielseite und Call-to-Action eines gesponserten Beitrags. Nur lesend; mit linkedin_performance_report kombinieren, um Botschaften zu vergleichen.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
creative_idsOptional | array<string> | Creative-URNs/-IDs |
post_urnsOptional | array<string> | urn:li:share / urn:li:ugcPost |
Schreib-Tools20 Tools
create_linkedin_campaign_group
Schreiben2 CreditsErstellt eine LinkedIn Kampagnengruppe (standardmäßig pausiert). Gibt eine Vorschau zurück und öffnet ein Freigabeelement; wird erst nach Freigabe und nur mit verbundenem Konto auf LinkedIn erstellt.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
statusOptional | ACTIVE | PAUSED | DRAFT | Standard PAUSED |
daily_budgetOptional | number | Kontowährung; dynamisches Budget, das die Kampagnen der Gruppe teilen |
total_budgetOptional | number | Kontowährung; erfordert end_date |
end_dateOptional | string | YYYY-MM-DD |
objectiveOptional | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | — |
bid_strategyOptional | MAXIMUM_DELIVERY | MANUAL | COST_CAP | — |
currencyOptional | string | ISO currency for the preview when the ad account currency is unknown |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_linkedin_campaign
Schreiben2 CreditsErstellt eine LinkedIn Kampagne (Sponsored Content oder Textanzeige) mit Budget, Ziel, Gebotsstrategie und Targeting aus build_linkedin_audience. Schreibt einen Entwurf in den Ledger und öffnet ein Freigabeelement mit Vorschau; wird nach Freigabe (standardmäßig pausiert) auf LinkedIn erstellt. Creatives fügen Sie mit create_linkedin_sponsored_content / create_linkedin_text_ad hinzu.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
daily_budgetPflicht | number | Kontowährung |
targeting_criteriaPflicht | object | targetingCriteria-JSON genau wie von build_linkedin_audience zurückgegeben |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
campaign_groupOptional | string | URN/ID der Kampagnengruppe; Standard: die Standardgruppe des Kontos |
objectiveOptional | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | Standard WEBSITE_VISITS; LEAD_GENERATION für Lead-Formulare |
typeOptional | SPONSORED_UPDATES | TEXT_AD | Standard SPONSORED_UPDATES |
statusOptional | PAUSED | ACTIVE | Standard PAUSED (bis zur Fortsetzung wird nichts ausgegeben) |
total_budgetOptional | number | — |
unit_costOptional | number | manuelles Gebot; weggelassen = automatische Gebotsstrategie |
cost_typeOptional | CPC | CPM | — |
locale_countryOptional | string | — |
locale_languageOptional | string | — |
organization_urnOptional | string | Unternehmensseite für Sponsored Content; Standard: der Verweis des Werbekontos |
audience_expansionOptional | boolean | — |
offsite_deliveryOptional | boolean | LinkedIn Audience Network |
political_intentOptional | 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 |
goalOptional | string | — |
currencyOptional | string | ISO currency for the preview when the ad account currency is unknown |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_linkedin_campaign_budget
Schreiben2 CreditsÄndert Tagesbudget, Gesamtbudget und/oder Gebot einer LinkedIn Kampagne. Gibt eine Vorschau mit den aktuellen → neuen Werten zurück; wird nach Freigabe angewendet (Budgetsenkungen und kleine Erhöhungen können gemäß der Freigaberichtlinie des Nutzers automatisch angewendet werden).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/ID aus list_linkedin_campaigns |
daily_budgetOptional | number | Kontowährung |
total_budgetOptional | number | — |
unit_costOptional | number | manuelles Gebot (stellt die Kampagne auf manuelle Gebotsstrategie um) |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
currencyOptional | string | ISO currency for the preview when the ad account currency is unknown |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_linkedin_campaign_status
Schreiben2 CreditsPausiert, setzt fort (ACTIVE) oder archiviert eine LinkedIn Kampagne. Durchläuft Vorschau und die Freigaberichtlinie.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/ID aus list_linkedin_campaigns |
statusPflicht | ACTIVE | PAUSED | ARCHIVED | — |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_linkedin_campaign_group_status
SchreibenUnumkehrbar2 CreditsAktiviert, pausiert, archiviert, setzt auf Entwurf oder löscht (PENDING_DELETION) eine LinkedIn Kampagnengruppe. Immer zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_groupPflicht | string | URN oder ID der Kampagnengruppe |
statusPflicht | ACTIVE | PAUSED | ARCHIVED | DRAFT | PENDING_DELETION | PENDING_DELETION löscht die Gruppe (unwiderruflich) |
nameOptional | string | nur für die Vorschau |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_linkedin_campaign_group_budget
Schreiben2 CreditsAktualisiert Gesamtbudget, Tagesbudget, Enddatum oder Name einer LinkedIn Kampagnengruppe. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_groupPflicht | string | — |
total_budgetOptional | number | — |
daily_budgetOptional | number | — |
end_dateOptional | string | YYYY-MM-DD |
nameOptional | string | — |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
currencyOptional | string | ISO currency for the preview when the ad account currency is unknown |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_linkedin_campaign_targeting
Schreiben2 CreditsErsetzt das Targeting einer LinkedIn Kampagne durch targeting_criteria aus build_linkedin_audience. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/ID aus list_linkedin_campaigns |
targeting_criteriaOptional | object | targetingCriteria-JSON genau wie von build_linkedin_audience zurückgegeben |
audienceOptional | object | Zielgruppenschätzung aus build_linkedin_audience (für die Vorschau) |
interface_localeOptional | string | — |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
geo_urnsOptional | array<string> | URNs for the locations facet (linkedin_targeting_search) |
job_title_urnsOptional | array<string> | URNs for the titles facet (linkedin_targeting_search) |
job_function_urnsOptional | array<string> | URNs for the jobFunctions facet (linkedin_targeting_search) |
seniority_urnsOptional | array<string> | URNs for the seniorities facet (linkedin_targeting_search) |
industry_urnsOptional | array<string> | URNs for the industries facet (linkedin_targeting_search) |
skill_urnsOptional | array<string> | URNs for the skills facet (linkedin_targeting_search) |
staff_count_urnsOptional | array<string> | URNs for the staffCountRanges facet (linkedin_targeting_search) |
employer_urnsOptional | array<string> | URNs for the employers facet (linkedin_targeting_search) |
include_audience_urnsOptional | array<string> | URNs for the audienceMatchingSegments facet (linkedin_targeting_search) |
exclude_geo_urnsOptional | array<string> | URNs for the locations facet (linkedin_targeting_search) |
exclude_title_urnsOptional | array<string> | URNs for the titles facet (linkedin_targeting_search) |
exclude_function_urnsOptional | array<string> | URNs for the jobFunctions facet (linkedin_targeting_search) |
exclude_seniority_urnsOptional | array<string> | URNs for the seniorities facet (linkedin_targeting_search) |
exclude_industry_urnsOptional | array<string> | URNs for the industries facet (linkedin_targeting_search) |
exclude_skill_urnsOptional | array<string> | URNs for the skills facet (linkedin_targeting_search) |
exclude_staff_count_urnsOptional | array<string> | URNs for the staffCountRanges facet (linkedin_targeting_search) |
exclude_employer_urnsOptional | array<string> | URNs for the employers facet (linkedin_targeting_search) |
exclude_audience_urnsOptional | array<string> | URNs for the audienceMatchingSegments facet (linkedin_targeting_search) |
location_modeOptional | recent_or_permanent | permanent | recent_or_permanent (default, locations facet) or permanent (profileLocations facet) |
audience_languageOptional | string | interface locale, e.g. en_US, tr_TR or urn:li:locale:tr_TR (default en_US) |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
upload_linkedin_image
Schreiben2 CreditsLädt ein Bild von einer URL (auch im Studio erzeugte, bis 5 MB) zu LinkedIn hoch; gibt urn:li:image für Anzeigen-Creatives zurück.
| Parameter | Typ | Beschreibung |
|---|---|---|
image_urlPflicht | string | — |
organization_urnOptional | string | — |
account_idOptional | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_linkedin_sponsored_content
Schreiben2 CreditsWandelt einen bestehenden Beitrag der Unternehmensseite in Sponsored Content (ein Creative) in einer LinkedIn Kampagne um oder erstellt einen neuen Dark Post als Creative. Zuerst Vorschau und Freigabe; LinkedIn prüft das Creative vor der Auslieferung.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/ID aus list_linkedin_campaigns |
post_urnOptional | string | bestehender Seitenbeitrag urn:li:share:… / urn:li:ugcPost:… (list_linkedin_posts) |
commentaryOptional | string | Text für einen NEUEN Dark Post, wenn kein post_urn angegeben ist |
landing_pageOptional | string | — |
cta_labelOptional | string | LEARN_MORE | SIGN_UP | DOWNLOAD | REGISTER | APPLY | ... |
image_urnOptional | string | urn:li:image:… from upload_linkedin_image |
article_urlOptional | string | — |
article_titleOptional | string | — |
article_descriptionOptional | string | — |
lead_form_urnOptional | string | urn:li:adForm:… für LEAD_GENERATION-Kampagnen |
organization_urnOptional | string | — |
nameOptional | string | — |
statusOptional | ACTIVE | PAUSED | DRAFT | Standard PAUSED |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_linkedin_text_ad
Schreiben2 CreditsErstellt ein LinkedIn Textanzeigen-Creative (Überschrift ≤25, Beschreibung ≤75 Zeichen, Zielseite) in einer TEXT_AD-Kampagne. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/ID aus list_linkedin_campaigns |
headlinePflicht | string | — |
descriptionPflicht | string | — |
landing_pagePflicht | string | — |
image_urnOptional | string | urn:li:image:… 100x100 (optional) |
nameOptional | string | — |
statusOptional | ACTIVE | PAUSED | DRAFT | Standard PAUSED |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_linkedin_creative_status
Schreiben2 CreditsPausiert, aktiviert, archiviert oder setzt ein oder mehrere LinkedIn Creatives auf Entwurf (z. B. diejenigen mit Impressionen, aber ohne Conversions). Zuerst Vorschau und Freigabe; Creatives in Prüfung können nicht pausiert werden.
| Parameter | Typ | Beschreibung |
|---|---|---|
creative_idsOptional | array<string> | Creative-URNs/IDs (list_linkedin_creatives) |
creative_idOptional | string | — |
statusPflicht | ACTIVE | PAUSED | ARCHIVED | DRAFT | — |
campaign_idOptional | string | optional; hilft bei der Auswahl des Werbekontos |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_linkedin_conversion
Schreiben2 CreditsErstellt eine Conversion-Tracking-Regel auf dem LinkedIn Insight Tag (POST conversions): websiteweit über URL-Regeln (z. B. URL enthält /danke) oder ereignisspezifisch. Danach mit attach_linkedin_conversion einer Kampagne zuordnen. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
typePflicht | ADD_TO_CART | DOWNLOAD | INSTALL | KEY_PAGE_VIEW | LEAD | PURCHASE | SIGN_UP | OTHER | — |
url_rulesOptional | array<object> | websiteweite Regel: Regeln werden mit UND verknüpft; für ereignisspezifische Conversions leer lassen |
post_click_daysOptional | 1 | 7 | 30 | — |
view_through_daysOptional | 1 | 7 | 30 | — |
valueOptional | number | — |
currencyOptional | string | — |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
attach_linkedin_conversion
Schreiben1 CreditsOrdnet einer LinkedIn-Kampagne eine Conversion-Tracking-Regel zu (campaignConversions PUT), damit sie diese meldet und darauf optimiert. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/-ID aus list_linkedin_campaigns |
conversion_idPflicht | string | aus list_linkedin_conversions |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
detach_linkedin_conversion
SchreibenUnumkehrbar1 CreditsLöst eine Conversion-Tracking-Regel von einer LinkedIn-Kampagne (campaignConversions DELETE). Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/-ID aus list_linkedin_campaigns |
conversion_idPflicht | string | — |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_linkedin_campaign
SchreibenUnumkehrbar5 CreditsLöscht eine LinkedIn-Kampagne: Eine DRAFT-Kampagne wird dauerhaft gelöscht, jede andere auf PENDING_DELETION gesetzt (Berichtsdaten bleiben erhalten). Unumkehrbar; wartet immer auf ausdrückliche Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/-ID aus list_linkedin_campaigns |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_linkedin_campaign_group
SchreibenUnumkehrbar5 CreditsLöscht eine LinkedIn-Kampagnengruppe: dauerhaft, wenn DRAFT, sonst als PENDING_DELETION markiert. Unumkehrbar; wartet immer auf ausdrückliche Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_groupPflicht | string | URN oder ID der Kampagnengruppe |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_linkedin_creative
SchreibenUnumkehrbar5 CreditsLöscht ein LinkedIn-Creative (Anzeige): dauerhaft, wenn DRAFT, sonst als PENDING_DELETION markiert. Unumkehrbar; wartet immer auf ausdrückliche Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
creative_idPflicht | string | URN oder ID des Creatives |
campaign_idOptional | string | optional; hilft bei der Auswahl des Werbekontos |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_linkedin_campaign
Schreiben5 CreditsAktualisiert eine LinkedIn-Kampagne in einem Aufruf: Name, Optimierungsziel, Kostentyp und Zeitplan in einer Aktion; Budget/Gebot und Status werden als eigene abgesicherte Aktionen geöffnet (gleiche Regeln wie update_linkedin_campaign_budget / _status). Jede wird separat freigegeben.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/-ID aus list_linkedin_campaigns |
nameOptional | string | — |
statusOptional | ACTIVE | PAUSED | ARCHIVED | — |
daily_budgetOptional | number | Kontowährung; läuft über die Budget-Schutzregel |
unit_costOptional | number | manuelles Gebot |
optimization_targetOptional | string | z. B. MAX_CLICK, MAX_LEAD, MAX_CONVERSION, NONE (manuell) |
cost_typeOptional | CPC | CPM | CPV | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
currencyOptional | string | ISO-Währung für die Vorschau, wenn die Währung des Werbekontos unbekannt ist |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_linkedin_campaign_group
Schreiben5 CreditsAktualisiert eine LinkedIn-Kampagnengruppe (nur die angegebenen Felder): Name, Status, Gesamtbudget, Ziel, Start- und Enddatum. Zuerst Vorschau und Freigabe; Budgeterhöhungen über +50 % werden abgelehnt.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_groupPflicht | string | — |
nameOptional | string | — |
statusOptional | ACTIVE | PAUSED | ARCHIVED | DRAFT | — |
total_budgetOptional | number | Kontowährung; Schutzregel +50 % pro Änderung |
objectiveOptional | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
currencyOptional | string | ISO-Währung für die Vorschau, wenn die Währung des Werbekontos unbekannt ist |
account_idOptional | string | LinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_linkedin_ad_account
SchreibenUnumkehrbar2 CreditsCreate 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.
Die Beschreibung dieses Tools ist noch nicht übersetzt; gezeigt wird der englische Originaltext, den der Assistent sieht.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | account name, e.g. “Acme Ads” |
currencyPflicht | 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_urnOptional | string | optional company page urn:li:organization:{id} the account advertises for |
connection_idOptional | string | optional: which LinkedIn identity (connection) opens the account |
forceOptional | boolean | create even though this identity already has an ad account |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.