Zum Inhalt springen
Tecrübetecrube.com
Assistenten-Tools · Einrichtung und Kampagnen

LinkedIn-Ads-Tools

Kampagnengruppen, Kampagnen, Sponsored Content, Textanzeigen, Targeting und demografische Berichte.

Freigabe läuft — demnächst

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 Credits

LinkedIn 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 Credits

Kampagnengruppen eines LinkedIn Werbekontos mit Status, Auslieferungsstatus, Ziel, Gesamt-/Tagesbudget und Zeitplan. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
statusesOptionalarray<string>ACTIVE | PAUSED | DRAFT | ARCHIVED (Standard alle vier)

list_linkedin_campaigns

Lesen1 Credits

LinkedIn 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.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
campaign_groupOptionalstringnach URN oder ID der Kampagnengruppe filtern
statusesOptionalarray<string>ACTIVE | PAUSED | DRAFT | COMPLETED | ARCHIVED | CANCELED
sync_ledgerOptionalbooleanKampagnen zusätzlich in den Tecrübe-Ledger importieren (Standard true)

list_linkedin_creatives

Lesen1 Credits

Creatives (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.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
campaign_idsOptionalarray<string>Kampagnen-URNs/IDs; Standard: alle aktiven/pausierten/Entwurfskampagnen
statusesOptionalarray<string>ACTIVE | PAUSED | DRAFT | ARCHIVED | CANCELED
limitOptionalinteger (1–100)—

linkedin_performance_report

Lesen2 Credits

LinkedIn 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.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
daysOptionalinteger (1–366)letzte N Tage inkl. heute (Standard 30)
start_dateOptionalstringYYYY-MM-DD (überschreibt days)
end_dateOptionalstringYYYY-MM-DD
pivotOptionalCAMPAIGN | CAMPAIGN_GROUP | CREATIVE | ACCOUNT—
campaign_idsOptionalarray<string>auf diese Kampagnen-URNs/IDs einschränken (erforderlich für Creative-Namen mit pivot=CREATIVE)
campaign_group_idsOptionalarray<string>—
time_granularityOptionalALL | DAILY—
sort_byOptionalcpl | spend | impressions | clicks | leads | conversions | ctr—

linkedin_demographics_report

Lesen2 Credits

Berufliche 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.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
pivotsOptionalarray<MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2>Standard: alle sechs
pivotOptionalMEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2—
daysOptionalinteger (1–366)letzte N Tage inkl. heute (Standard 30)
start_dateOptionalstringYYYY-MM-DD (überschreibt days)
end_dateOptionalstringYYYY-MM-DD
campaign_idsOptionalarray<string>auf diese Kampagnen-URNs/IDs einschränken
campaign_group_idsOptionalarray<string>—
limitOptionalinteger (1–100)Zeilen pro Dimension (Standard 25, nach Impressionen)
locale_languageOptionalstringSprache der Namen, Standard en
locale_countryOptionalstringStandard US

build_linkedin_audience

Lesen2 Credits

Lö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.

ParameterTypBeschreibung
titlesOptionalarray<string>Jobtitel, z. B. Marketing Manager
industriesOptionalarray<string>—
locationsOptionalarray<string>Städte / Regionen / Länder, z. B. Istanbul, Turkey (LinkedIn verlangt mindestens einen)
company_sizesOptionalarray<string>z. B. '200+', '51-200', '1001+'
senioritiesOptionalarray<string>—
job_functionsOptionalarray<string>—
skillsOptionalarray<string>—
employersOptionalarray<string>Unternehmensnamen (nicht kombinierbar mit industries / company_sizes)
companiesOptionalarray<string>Alias of employers
exclude_titlesOptionalarray<string>—
exclude_employersOptionalarray<string>—
exclude_industriesOptionalarray<string>—
interface_localesOptionalarray<string>z. B. urn:li:locale:en_US, urn:li:locale:tr_TR (Standard en_US)
locale_languageOptionalstringSuchsprache, Standard en
locale_countryOptionalstringStandard US
estimateOptionalbooleanZielgruppengröße abrufen (Standard true)

list_linkedin_posts

Lesen1 Credits

Neueste 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.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
organization_urnOptionalstringurn:li:organization:{id}; Standard: die Unternehmensseite des Werbekontos
countOptionalinteger (1–100)—

linkedin_audience_forecast

Lesen1 Credits

Schä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.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
targeting_criteriaOptionalobjecttargetingCriteria-JSON genau so, wie build_linkedin_audience es zurückgibt
campaign_idOptionalstringdas gespeicherte Targeting dieser Kampagne verwenden, wenn kein anderes Targeting angegeben ist
geo_urnsOptionalarray<string>URNs für die Facette locations (linkedin_targeting_search)
job_title_urnsOptionalarray<string>URNs für die Facette titles (linkedin_targeting_search)
job_function_urnsOptionalarray<string>URNs für die Facette jobFunctions (linkedin_targeting_search)
seniority_urnsOptionalarray<string>URNs für die Facette seniorities (linkedin_targeting_search)
industry_urnsOptionalarray<string>URNs für die Facette industries (linkedin_targeting_search)
skill_urnsOptionalarray<string>URNs für die Facette skills (linkedin_targeting_search)
staff_count_urnsOptionalarray<string>URNs für die Facette staffCountRanges (linkedin_targeting_search)
employer_urnsOptionalarray<string>URNs für die Facette employers (linkedin_targeting_search)
include_audience_urnsOptionalarray<string>URNs für die Facette audienceMatchingSegments (linkedin_targeting_search)
exclude_geo_urnsOptionalarray<string>URNs für die Facette locations (linkedin_targeting_search)
exclude_title_urnsOptionalarray<string>URNs für die Facette titles (linkedin_targeting_search)
exclude_function_urnsOptionalarray<string>URNs für die Facette jobFunctions (linkedin_targeting_search)
exclude_seniority_urnsOptionalarray<string>URNs für die Facette seniorities (linkedin_targeting_search)
exclude_industry_urnsOptionalarray<string>URNs für die Facette industries (linkedin_targeting_search)
exclude_skill_urnsOptionalarray<string>URNs für die Facette skills (linkedin_targeting_search)
exclude_staff_count_urnsOptionalarray<string>URNs für die Facette staffCountRanges (linkedin_targeting_search)
exclude_employer_urnsOptionalarray<string>URNs für die Facette employers (linkedin_targeting_search)
exclude_audience_urnsOptionalarray<string>URNs für die Facette audienceMatchingSegments (linkedin_targeting_search)
location_modeOptionalrecent_or_permanent | permanentrecent_or_permanent (Standard, Facette locations) oder permanent (Facette profileLocations)
audience_languageOptionalstringOberflächen-Locale, z. B. en_US, tr_TR oder urn:li:locale:tr_TR (Standard en_US)

linkedin_bid_recommendations

Lesen1 Credits

Von LinkedIn empfohlenes Gebot, Gebotsunter-/-obergrenze und Tagesbudgetgrenzen für eine Zielgruppe (adBudgetPricing criteriaV2), in der Währung des Werbekontos. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
campaign_typeOptionalSPONSORED_UPDATES | TEXT_AD | SPONSORED_INMAILS—
bid_typeOptionalCPM | CPC | CPV—
objective_typeOptionalstringz. B. WEBSITE_VISIT, LEAD_GENERATION, BRAND_AWARENESS, WEBSITE_CONVERSION, VIDEO_VIEW, ENGAGEMENT
optimization_targetOptionalstringz. B. MAX_CLICK, MAX_LEAD, MAX_CONVERSION, NONE
daily_budgetOptionalnumberKontowährung; präzisiert die Empfehlung
audience_expansionOptionalboolean—
targeting_criteriaOptionalobjecttargetingCriteria-JSON genau so, wie build_linkedin_audience es zurückgibt
campaign_idOptionalstringdas gespeicherte Targeting dieser Kampagne verwenden
geo_urnsOptionalarray<string>URNs für die Facette locations (linkedin_targeting_search)
job_title_urnsOptionalarray<string>URNs für die Facette titles (linkedin_targeting_search)
job_function_urnsOptionalarray<string>URNs für die Facette jobFunctions (linkedin_targeting_search)
seniority_urnsOptionalarray<string>URNs für die Facette seniorities (linkedin_targeting_search)
industry_urnsOptionalarray<string>URNs für die Facette industries (linkedin_targeting_search)
skill_urnsOptionalarray<string>URNs für die Facette skills (linkedin_targeting_search)
staff_count_urnsOptionalarray<string>URNs für die Facette staffCountRanges (linkedin_targeting_search)
employer_urnsOptionalarray<string>URNs für die Facette employers (linkedin_targeting_search)
include_audience_urnsOptionalarray<string>URNs für die Facette audienceMatchingSegments (linkedin_targeting_search)
exclude_geo_urnsOptionalarray<string>URNs für die Facette locations (linkedin_targeting_search)
exclude_title_urnsOptionalarray<string>URNs für die Facette titles (linkedin_targeting_search)
exclude_function_urnsOptionalarray<string>URNs für die Facette jobFunctions (linkedin_targeting_search)
exclude_seniority_urnsOptionalarray<string>URNs für die Facette seniorities (linkedin_targeting_search)
exclude_industry_urnsOptionalarray<string>URNs für die Facette industries (linkedin_targeting_search)
exclude_skill_urnsOptionalarray<string>URNs für die Facette skills (linkedin_targeting_search)
exclude_staff_count_urnsOptionalarray<string>URNs für die Facette staffCountRanges (linkedin_targeting_search)
exclude_employer_urnsOptionalarray<string>URNs für die Facette employers (linkedin_targeting_search)
exclude_audience_urnsOptionalarray<string>URNs für die Facette audienceMatchingSegments (linkedin_targeting_search)
location_modeOptionalrecent_or_permanent | permanentrecent_or_permanent (Standard, Facette locations) oder permanent (Facette profileLocations)
audience_languageOptionalstringOberflächen-Locale, z. B. en_US, tr_TR oder urn:li:locale:tr_TR (Standard en_US)

list_linkedin_audiences

Lesen1 Credits

Matched 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.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
typesOptionalarray<string>BULK | RETARGETING | MARKET_AUTOMATION | BUSINESS_OBJECTIVE_BASED_AUDIENCE
statusesOptionalarray<string>BUILDING | READY | UPDATING | FAILED | ARCHIVED | EXPIRED …

list_linkedin_conversions

Lesen1 Credits

Conversion-Tracking-Regeln eines LinkedIn-Werbekontos (conversions q=account): ID, Name, Typ, aktiviert, Attributionsfenster, Wert und zugeordnete Kampagnen. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat

list_linkedin_lead_forms

Lesen1 Credits

Lead Gen Forms eines LinkedIn-Werbekontos (leadForms q=owner): ID, Name, Status, Version und Anzahl der Fragen. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-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.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
form_idOptionalstringLead-Formular-ID (list_linkedin_lead_forms); ordnet Antworten den Fragenamen zu
sinceOptionalstringYYYY-MM-DD
untilOptionalstringYYYY-MM-DD (Standard heute)
test_onlyOptionalboolean—
limitOptionalinteger (1–1000)—

linkedin_ad_copy

Lesen1 Credits

Liest 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.

ParameterTypBeschreibung
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
creative_idsOptionalarray<string>Creative-URNs/-IDs
post_urnsOptionalarray<string>urn:li:share / urn:li:ugcPost

Schreib-Tools20 Tools

create_linkedin_campaign_group

Schreiben2 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
statusOptionalACTIVE | PAUSED | DRAFTStandard PAUSED
daily_budgetOptionalnumberKontowährung; dynamisches Budget, das die Kampagnen der Gruppe teilen
total_budgetOptionalnumberKontowährung; erfordert end_date
end_dateOptionalstringYYYY-MM-DD
objectiveOptionalBRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT—
bid_strategyOptionalMAXIMUM_DELIVERY | MANUAL | COST_CAP—
currencyOptionalstringISO 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 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
daily_budgetPflichtnumberKontowährung
targeting_criteriaPflichtobjecttargetingCriteria-JSON genau wie von build_linkedin_audience zurückgegeben
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
campaign_groupOptionalstringURN/ID der Kampagnengruppe; Standard: die Standardgruppe des Kontos
objectiveOptionalBRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISITStandard WEBSITE_VISITS; LEAD_GENERATION für Lead-Formulare
typeOptionalSPONSORED_UPDATES | TEXT_ADStandard SPONSORED_UPDATES
statusOptionalPAUSED | ACTIVEStandard PAUSED (bis zur Fortsetzung wird nichts ausgegeben)
total_budgetOptionalnumber—
unit_costOptionalnumbermanuelles Gebot; weggelassen = automatische Gebotsstrategie
cost_typeOptionalCPC | CPM—
locale_countryOptionalstring—
locale_languageOptionalstring—
organization_urnOptionalstringUnternehmensseite für Sponsored Content; Standard: der Verweis des Werbekontos
audience_expansionOptionalboolean—
offsite_deliveryOptionalbooleanLinkedIn Audience Network
political_intentOptionalNOT_POLITICAL | POLITICAL | NOT_DECLAREDadvertiser'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
goalOptionalstring—
currencyOptionalstringISO 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).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/ID aus list_linkedin_campaigns
daily_budgetOptionalnumberKontowährung
total_budgetOptionalnumber—
unit_costOptionalnumbermanuelles Gebot (stellt die Kampagne auf manuelle Gebotsstrategie um)
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
currencyOptionalstringISO 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 Credits

Pausiert, setzt fort (ACTIVE) oder archiviert eine LinkedIn Kampagne. Durchläuft Vorschau und die Freigaberichtlinie.

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/ID aus list_linkedin_campaigns
statusPflichtACTIVE | PAUSED | ARCHIVED—
account_idOptionalstringLinkedIn-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 Credits

Aktiviert, pausiert, archiviert, setzt auf Entwurf oder löscht (PENDING_DELETION) eine LinkedIn Kampagnengruppe. Immer zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
campaign_groupPflichtstringURN oder ID der Kampagnengruppe
statusPflichtACTIVE | PAUSED | ARCHIVED | DRAFT | PENDING_DELETIONPENDING_DELETION löscht die Gruppe (unwiderruflich)
nameOptionalstringnur für die Vorschau
account_idOptionalstringLinkedIn-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 Credits

Aktualisiert Gesamtbudget, Tagesbudget, Enddatum oder Name einer LinkedIn Kampagnengruppe. Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
campaign_groupPflichtstring—
total_budgetOptionalnumber—
daily_budgetOptionalnumber—
end_dateOptionalstringYYYY-MM-DD
nameOptionalstring—
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
currencyOptionalstringISO 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 Credits

Ersetzt das Targeting einer LinkedIn Kampagne durch targeting_criteria aus build_linkedin_audience. Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/ID aus list_linkedin_campaigns
targeting_criteriaOptionalobjecttargetingCriteria-JSON genau wie von build_linkedin_audience zurückgegeben
audienceOptionalobjectZielgruppenschätzung aus build_linkedin_audience (für die Vorschau)
interface_localeOptionalstring—
account_idOptionalstringLinkedIn-Werbekonto-ID (aus list_linkedin_accounts); optional, wenn die Verbindung nur ein Konto hat
geo_urnsOptionalarray<string>URNs for the locations facet (linkedin_targeting_search)
job_title_urnsOptionalarray<string>URNs for the titles facet (linkedin_targeting_search)
job_function_urnsOptionalarray<string>URNs for the jobFunctions facet (linkedin_targeting_search)
seniority_urnsOptionalarray<string>URNs for the seniorities facet (linkedin_targeting_search)
industry_urnsOptionalarray<string>URNs for the industries facet (linkedin_targeting_search)
skill_urnsOptionalarray<string>URNs for the skills facet (linkedin_targeting_search)
staff_count_urnsOptionalarray<string>URNs for the staffCountRanges facet (linkedin_targeting_search)
employer_urnsOptionalarray<string>URNs for the employers facet (linkedin_targeting_search)
include_audience_urnsOptionalarray<string>URNs for the audienceMatchingSegments facet (linkedin_targeting_search)
exclude_geo_urnsOptionalarray<string>URNs for the locations facet (linkedin_targeting_search)
exclude_title_urnsOptionalarray<string>URNs for the titles facet (linkedin_targeting_search)
exclude_function_urnsOptionalarray<string>URNs for the jobFunctions facet (linkedin_targeting_search)
exclude_seniority_urnsOptionalarray<string>URNs for the seniorities facet (linkedin_targeting_search)
exclude_industry_urnsOptionalarray<string>URNs for the industries facet (linkedin_targeting_search)
exclude_skill_urnsOptionalarray<string>URNs for the skills facet (linkedin_targeting_search)
exclude_staff_count_urnsOptionalarray<string>URNs for the staffCountRanges facet (linkedin_targeting_search)
exclude_employer_urnsOptionalarray<string>URNs for the employers facet (linkedin_targeting_search)
exclude_audience_urnsOptionalarray<string>URNs for the audienceMatchingSegments facet (linkedin_targeting_search)
location_modeOptionalrecent_or_permanent | permanentrecent_or_permanent (default, locations facet) or permanent (profileLocations facet)
audience_languageOptionalstringinterface 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 Credits

Lä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.

ParameterTypBeschreibung
image_urlPflichtstring—
organization_urnOptionalstring—
account_idOptionalstringLinkedIn 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 Credits

Wandelt 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.

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/ID aus list_linkedin_campaigns
post_urnOptionalstringbestehender Seitenbeitrag urn:li:share:… / urn:li:ugcPost:… (list_linkedin_posts)
commentaryOptionalstringText für einen NEUEN Dark Post, wenn kein post_urn angegeben ist
landing_pageOptionalstring—
cta_labelOptionalstringLEARN_MORE | SIGN_UP | DOWNLOAD | REGISTER | APPLY | ...
image_urnOptionalstringurn:li:image:… from upload_linkedin_image
article_urlOptionalstring—
article_titleOptionalstring—
article_descriptionOptionalstring—
lead_form_urnOptionalstringurn:li:adForm:… für LEAD_GENERATION-Kampagnen
organization_urnOptionalstring—
nameOptionalstring—
statusOptionalACTIVE | PAUSED | DRAFTStandard PAUSED
account_idOptionalstringLinkedIn-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 Credits

Erstellt ein LinkedIn Textanzeigen-Creative (Überschrift ≤25, Beschreibung ≤75 Zeichen, Zielseite) in einer TEXT_AD-Kampagne. Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/ID aus list_linkedin_campaigns
headlinePflichtstring—
descriptionPflichtstring—
landing_pagePflichtstring—
image_urnOptionalstringurn:li:image:… 100x100 (optional)
nameOptionalstring—
statusOptionalACTIVE | PAUSED | DRAFTStandard PAUSED
account_idOptionalstringLinkedIn-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 Credits

Pausiert, 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.

ParameterTypBeschreibung
creative_idsOptionalarray<string>Creative-URNs/IDs (list_linkedin_creatives)
creative_idOptionalstring—
statusPflichtACTIVE | PAUSED | ARCHIVED | DRAFT—
campaign_idOptionalstringoptional; hilft bei der Auswahl des Werbekontos
account_idOptionalstringLinkedIn-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 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
typePflichtADD_TO_CART | DOWNLOAD | INSTALL | KEY_PAGE_VIEW | LEAD | PURCHASE | SIGN_UP | OTHER—
url_rulesOptionalarray<object>websiteweite Regel: Regeln werden mit UND verknüpft; für ereignisspezifische Conversions leer lassen
post_click_daysOptional1 | 7 | 30—
view_through_daysOptional1 | 7 | 30—
valueOptionalnumber—
currencyOptionalstring—
account_idOptionalstringLinkedIn-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 Credits

Ordnet einer LinkedIn-Kampagne eine Conversion-Tracking-Regel zu (campaignConversions PUT), damit sie diese meldet und darauf optimiert. Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/-ID aus list_linkedin_campaigns
conversion_idPflichtstringaus list_linkedin_conversions
account_idOptionalstringLinkedIn-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 Credits

Löst eine Conversion-Tracking-Regel von einer LinkedIn-Kampagne (campaignConversions DELETE). Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/-ID aus list_linkedin_campaigns
conversion_idPflichtstring—
account_idOptionalstringLinkedIn-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 Credits

Lö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.

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/-ID aus list_linkedin_campaigns
account_idOptionalstringLinkedIn-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 Credits

Löscht eine LinkedIn-Kampagnengruppe: dauerhaft, wenn DRAFT, sonst als PENDING_DELETION markiert. Unumkehrbar; wartet immer auf ausdrückliche Freigabe.

ParameterTypBeschreibung
campaign_groupPflichtstringURN oder ID der Kampagnengruppe
account_idOptionalstringLinkedIn-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 Credits

Löscht ein LinkedIn-Creative (Anzeige): dauerhaft, wenn DRAFT, sonst als PENDING_DELETION markiert. Unumkehrbar; wartet immer auf ausdrückliche Freigabe.

ParameterTypBeschreibung
creative_idPflichtstringURN oder ID des Creatives
campaign_idOptionalstringoptional; hilft bei der Auswahl des Werbekontos
account_idOptionalstringLinkedIn-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 Credits

Aktualisiert 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.

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (uuid) oder LinkedIn-Kampagnen-URN/-ID aus list_linkedin_campaigns
nameOptionalstring—
statusOptionalACTIVE | PAUSED | ARCHIVED—
daily_budgetOptionalnumberKontowährung; läuft über die Budget-Schutzregel
unit_costOptionalnumbermanuelles Gebot
optimization_targetOptionalstringz. B. MAX_CLICK, MAX_LEAD, MAX_CONVERSION, NONE (manuell)
cost_typeOptionalCPC | CPM | CPV—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
currencyOptionalstringISO-Währung für die Vorschau, wenn die Währung des Werbekontos unbekannt ist
account_idOptionalstringLinkedIn-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 Credits

Aktualisiert eine LinkedIn-Kampagnengruppe (nur die angegebenen Felder): Name, Status, Gesamtbudget, Ziel, Start- und Enddatum. Zuerst Vorschau und Freigabe; Budgeterhöhungen über +50 % werden abgelehnt.

ParameterTypBeschreibung
campaign_groupPflichtstring—
nameOptionalstring—
statusOptionalACTIVE | PAUSED | ARCHIVED | DRAFT—
total_budgetOptionalnumberKontowährung; Schutzregel +50 % pro Änderung
objectiveOptionalBRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
currencyOptionalstringISO-Währung für die Vorschau, wenn die Währung des Werbekontos unbekannt ist
account_idOptionalstringLinkedIn-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 Credits

Create 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.

ParameterTypBeschreibung
namePflichtstringaccount name, e.g. “Acme Ads”
currencyPflichtAED | 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 | ZARpermanent; LinkedIn-supported ISO code
organization_urnOptionalstringoptional company page urn:li:organization:{id} the account advertises for
connection_idOptionalstringoptional: which LinkedIn identity (connection) opens the account
forceOptionalbooleancreate 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.