Microsoft-Advertising-Tools
Bing-Suchkampagnen, Keywords, Targeting, UET-Tags, Conversion-Ziele und Berichte.
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_microsoft_accounts
Lesen1 CreditsMicrosoft Advertising Werbekonten, auf die der verbundene Nutzer zugreifen kann (id, name, number, customer_id, currency, status), und welches ausgewählt ist. In Manager-/Agentur-Setups vor Schreibvorgängen verwenden. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
all_accessibleOptional | boolean | default true; false returns only the selected account |
list_microsoft_ad_groups
Lesen1 CreditsAnzeigengruppen einer Microsoft Advertising Kampagne (id, name, status, Standard-CPC-Gebot). Verwenden Sie die IDs für Keywords, Anzeigen und Targeting auf Anzeigengruppenebene. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
list_microsoft_audiences
Lesen1 CreditsZielgruppen im Microsoft Advertising Konto (Remarketing-Listen, kaufbereite Zielgruppen, benutzerdefiniert) mit Größen und UET-Tag. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
list_microsoft_conversion_goals
Lesen1 CreditsConversion-Ziele des Microsoft Advertising Kontos mit Typ, Status, Tracking-Status, Kategorie und Umsatzeinstellungen. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
list_microsoft_uet_tags
Lesen1 CreditsUET-Tags (Universal Event Tracking) des Microsoft Advertising Kontos mit Tracking-Status und Skript. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
microsoft_search_terms_report
Lesen2 CreditsMicrosoft Advertising Suchbegriffe (Suchanfragen, die Anzeigen ausgelöst haben) mit Ausgaben, Klicks, Conversions, Keyword und Übereinstimmungstyp der letzten N Tage sowie die verschwendeten Begriffe (ohne Conversion). Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–90) | — |
campaign_idOptional | string | — |
start_dateOptional | string | YYYY-MM-DD (overrides days) |
end_dateOptional | string | YYYY-MM-DD, default today |
min_wasteOptional | number | only count zero-conversion terms spending at least this much as wasted |
limitOptional | integer (1–500) | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
microsoft_performance_report
Lesen2 CreditsMicrosoft Advertising Leistung nach Kampagne, Anzeigengruppe oder Gerät (Ausgaben, Klicks, Impressionen, Conversions, Umsatz, CTR, CPC, CPA, ROAS) mit Summen; compare_previous fügt den Vorzeitraum hinzu. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD (overrides days) |
end_dateOptional | string | YYYY-MM-DD, default today |
breakdownOptional | campaign | ad_group | device | — |
campaign_idOptional | string | — |
compare_previousOptional | boolean | zusätzlich den vorherigen Zeitraum gleicher Länge zurückgeben |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
list_microsoft_campaigns
Lesen1 CreditsLive aus dem Microsoft Advertising-Konto gelesene Kampagnen (ID, Name, Status, Typ, Tagesbudget, Gebote). raw_status ist der Status von Microsoft selbst (Active, Paused, BudgetPaused, BudgetAndManualPaused, Suspended); bidding_settings enthält Ziel-CPA / Ziel-ROAS / maximalen CPC der Strategie, sofern Microsoft sie liefert; dazu budget_type und shared_budget_id. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
statusOptional | string | optionaler Filter: live | paused | ended (oder Microsoft-Status) |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Manager-Konto-ID (customer) von account_id |
diagnose_microsoft_delivery
Lesen2 CreditsLIVE-Auslieferungsdiagnose einer Microsoft Advertising-Kampagne. Zuerst aufrufen, wenn der Nutzer meldet, dass die Kampagne nicht ausgeliefert wird, wegen des Budgets pausiert, gesperrt, eingeschränkt oder abgelehnt ist. Liest den Kontostatus, die Kampagne (Status, Budget, Gebotsstrategie mit Ziel-CPA / Ziel-ROAS / maximalem CPC), ihre Anzeigengruppen (Status, Daten, Gebote) und Anzeigen (redaktioneller Status mit den redaktionellen Grundcodes von Microsoft und dem Einspruchsstatus), den Änderungsverlauf der letzten 14 Tage sowie die Budgetchancen und Empfehlungen von Microsoft; liefert eine Befundliste (Ebene, Code von Microsoft, Kategorie, Beleg) und cannot_read für das, was nicht gelesen wurde. Nur lesend. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Microsoft-Kampagnen-ID (list_microsoft_campaigns) oder Tecrübe-Kampagnen-ID |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Manager-Konto-ID (customer) von account_id |
list_microsoft_ads
Lesen1 CreditsAnzeigen einer Microsoft Advertising-Anzeigengruppe mit Typ, Status, redaktionellem Status, Anzeigentiteln, Beschreibungen und Ziel-URLs. Die IDs für update_microsoft_ad_status / update_microsoft_responsive_search_ad verwenden. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Manager-Konto-ID (customer) von account_id |
list_microsoft_keywords
Lesen1 CreditsKeywords einer Microsoft Advertising-Anzeigengruppe (ID, Text, Übereinstimmungsart, Status, redaktioneller Status, Gebot). Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Manager-Konto-ID (customer) von account_id |
list_microsoft_negative_keywords
Lesen1 CreditsAktuell für eine Microsoft Advertising-Kampagne oder -Anzeigengruppe festgelegte auszuschließende Keywords — hier prüfen, wenn der Traffic sinkt oder bevor eines entfernt wird. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | — |
ad_group_idOptional | string | Anzeigengruppenebene; campaign_id wird ebenfalls benötigt |
entity_idOptional | string | Alias: Kampagnen- oder Anzeigengruppen-ID, zusammen mit entity_type |
entity_typeOptional | Campaign | AdGroup | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Manager-Konto-ID (customer) von account_id |
list_microsoft_ad_extensions
Lesen1 CreditsMit Microsoft Advertising-Kampagnen verknüpfte Sitelink- und Callout-Erweiterungen (ID, Text, URLs, Status, redaktioneller Status). Vor dem Hinzufügen prüfen, um Duplikate zu vermeiden; die IDs dienen remove_microsoft_ad_extensions. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls wird connected=false zurückgegeben, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | optional; standardmäßig alle Kampagnen des Kontos |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Manager-Konto-ID (customer) von account_id |
microsoft_entity_performance_report
Lesen2 CreditsMicrosoft Advertising-Leistung unterhalb der Kampagnenebene — nach Anzeigengruppe, Anzeige, Keyword (mit Qualitätsfaktor), Standort, Gerät oder Alter/Geschlecht — mit Ausgaben, Klicks, Conversions, Umsatz, CTR, CPC, CPA, ROAS und Summen. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
levelOptional | ad_group | ad | keyword | location | device | age_gender | — |
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD (überschreibt days) |
end_dateOptional | string | YYYY-MM-DD, Standard heute |
campaign_idOptional | string | — |
limitOptional | integer (1–500) | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Verwaltungskonto-(Kunden-)ID von account_id |
microsoft_location_search
Lesen1 CreditsSucht Microsoft Advertising-Standort-IDs nach Namen (aus Microsofts offizieller Geodatei) mit Typ und vollständigem Anzeigenamen für add_microsoft_location_target. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
queryPflicht | string | — |
location_typeOptional | Country | State | City | MetroArea | County | PostalCode | — |
limitOptional | integer (1–50) | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Verwaltungskonto-(Kunden-)ID von account_id |
microsoft_report_query
Lesen2 CreditsFreie Abfrage der Microsoft Advertising Reporting API (v13): jeder Berichtstyp mit den von Ihnen gewählten Spalten; die Zeilen kommen so zurück, wie Microsoft sie liefert. Verwenden Sie sie, wenn die festen Berichte die benötigte Aufschlüsselung nicht haben. Erfordert ein verbundenes Microsoft Advertising Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
report_typePflicht | string | Reporting-v13-Bericht, z. B. KeywordPerformanceReport, AdPerformanceReport, GeographicPerformanceReport |
columnsPflicht | array<string> | Spaltennamen dieses Berichts, z. B. CampaignName, Clicks, Spend |
aggregationOptional | Summary | Hourly | Daily | Weekly | Monthly | Yearly | HourOfDay | DayOfWeek | WeeklyStartingMonday | — |
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD (überschreibt days) |
end_dateOptional | string | YYYY-MM-DD, Standard heute |
limitOptional | integer (1–2000) | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Verwaltungskonto-(Kunden-)ID von account_id |
Schreib-Tools27 Tools
select_microsoft_account
Schreiben1 CreditsLegt fest, welches Microsoft Advertising Werbekonto alle weiteren Lese- und Schreibvorgänge verwenden (Manager-/Agentur-Setups). Lokale Einstellung; auf Microsoft wird nichts geändert.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idPflicht | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_microsoft_campaign
Schreiben2 CreditsErstellt einen Microsoft Advertising Suchkampagnen-ENTWURF mit Anzeigengruppen, Keywords und responsiven Suchanzeigentexten in einem Schritt (z. B. um eine Google Ads Struktur zu replizieren). Die gesamte Struktur wird als Vorschau angezeigt; nach Freigabe wird sie PAUSIERT auf Microsoft erstellt. Live-Schaltung mit update_microsoft_campaign_status(resume). Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
daily_budgetPflicht | number | Tagesbudget in der Kontowährung |
kindOptional | string | search (Standard) | local_search | sales | traffic |
goalOptional | string | — |
languageOptional | string | Anzeigensprache, z. B. Turkish, English (Standard Turkish) |
campaign_typeOptional | Search | only Search is supported |
bid_strategyOptional | manual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share | — |
target_cpaOptional | number | — |
target_roasOptional | number | — |
max_cpcOptional | number | — |
final_urlOptional | string | Zielseite für die Anzeigen; standardmäßig die Marken-Website |
ad_groupsOptional | array<object> | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_microsoft_ad_group
Schreiben2 CreditsFügt einer bestehenden Microsoft Advertising Kampagne eine Anzeigengruppe hinzu, optional mit Keywords und einer responsiven Suchanzeige (headlines + descriptions + final_url). Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | — |
namePflicht | string | — |
cpc_bidOptional | number | — |
keywordsOptional | array<any> | — |
headlinesOptional | array<string> | — |
descriptionsOptional | array<string> | — |
final_urlOptional | string | — |
path1Optional | string | — |
path2Optional | string | — |
languageOptional | string | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_microsoft_keywords
Schreiben2 CreditsFügt einer Microsoft Advertising Anzeigengruppe Keywords hinzu (Text, Übereinstimmungstyp BROAD|PHRASE|EXACT, optionales Gebot). Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | — |
campaign_idOptional | string | — |
keywordsPflicht | array<any> | — |
match_typeOptional | BROAD | PHRASE | EXACT | default for plain-text keywords (PHRASE) |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_microsoft_negative_keywords
Schreiben2 CreditsFügt einer Microsoft Advertising Kampagne (oder Anzeigengruppe) auszuschließende Keywords hinzu. Microsoft unterstützt PHRASE- und EXACT-Ausschlüsse. Typischer Folgeschritt nach microsoft_search_terms_report. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | — |
ad_group_idOptional | string | optional: Ausschlüsse auf Anzeigengruppenebene |
keywordsPflicht | array<string> | — |
match_typeOptional | PHRASE | EXACT | — |
entity_idOptional | string | alias: campaign or ad group id, with entity_type |
entity_typeOptional | Campaign | AdGroup | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_microsoft_responsive_search_ad
Schreiben2 CreditsErstellt eine responsive Suchanzeige (3-15 Überschriften ≤30 Zeichen, 2-4 Beschreibungen ≤90 Zeichen, Zielseiten-URL) in einer Microsoft Advertising Anzeigengruppe. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | — |
headlinesPflicht | array<string> | — |
descriptionsPflicht | array<string> | — |
final_urlPflicht | string | — |
path1Optional | string | — |
path2Optional | string | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_microsoft_campaign_budget
Schreiben2 CreditsÄndert das Tagesbudget einer Microsoft Advertising Kampagne. Die Vorschau zeigt alt → neu. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | — |
amountOptional | number | neues Tagesbudget in der Kontowährung |
daily_budgetOptional | number | alias of amount |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_microsoft_campaign_status
Schreiben2 CreditsPausiert eine Microsoft Advertising Kampagne oder setzt sie fort (resume veröffentlicht auch eine pausiert erstellte Kampagne). Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | — |
statusPflicht | pause | resume | paused | active | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_microsoft_ad_group_status
Schreiben2 CreditsPausiert oder aktiviert eine Microsoft Advertising Anzeigengruppe. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | — |
ad_group_idPflicht | string | — |
statusPflicht | pause | resume | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_microsoft_keyword
Schreiben2 CreditsÄndert ein Microsoft Advertising Keyword: Gebot, pausieren/fortsetzen, Übereinstimmungstyp (der Keyword-Text kann nicht geändert werden). Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | — |
keyword_idPflicht | string | — |
bidOptional | number | — |
statusOptional | pause | resume | — |
match_typeOptional | BROAD | PHRASE | EXACT | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
set_microsoft_bid_strategy
Schreiben2 CreditsLegt die Gebotsstrategie einer Microsoft Advertising Kampagne fest: manueller/erweiterter CPC, Klicks/Conversions maximieren (optional Ziel-CPA), Conversion-Wert maximieren (optional Ziel-ROAS), Ziel-Anteil an Impressionen. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | — |
strategyPflicht | manual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share | — |
target_cpaOptional | number | — |
target_roasOptional | number | z. B. 4.0 für 400 % |
max_cpcOptional | number | — |
target_impression_shareOptional | number | — |
target_ad_positionOptional | AbsoluteTopOfPage | TopOfPage | MainLine1 | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_microsoft_location_target
Schreiben2 CreditsZielt auf Standorte in einer Microsoft Advertising Kampagne oder Anzeigengruppe (oder schließt sie aus). Namen werden bei verbundenem Konto über die offizielle Geo-Datei in Microsoft-Standort-IDs aufgelöst. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID oder Microsoft-Kampagnen-ID (Kampagnenebene) |
ad_group_idOptional | string | Microsoft-Anzeigengruppen-ID (Anzeigengruppenebene hat Vorrang vor Kampagnenebene) |
locationsOptional | array<string> | Namen von Städten/Regionen/Ländern, z. B. İstanbul, Ankara |
location_idsOptional | array<string> | Microsoft-Standort-IDs, falls bereits bekannt |
countryOptional | string | Hinweis zur Eindeutigkeit, Standard Türkiye |
bid_adjustmentOptional | number | Prozent -100..900 |
bid_multiplierOptional | number | alias of bid_adjustment |
excludeOptional | boolean | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_microsoft_device_target
Schreiben2 CreditsLegt Gebotsanpassungen für Geräte (Prozent -100..900; -100 schließt aus) in einer Microsoft Advertising Kampagne oder Anzeigengruppe fest. Microsoft verlangt alle drei Geräte; fehlende werden als 0 gesendet. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID oder Microsoft-Kampagnen-ID (Kampagnenebene) |
ad_group_idOptional | string | Microsoft-Anzeigengruppen-ID (Anzeigengruppenebene hat Vorrang vor Kampagnenebene) |
computersOptional | number | — |
smartphonesOptional | number | — |
tabletsOptional | number | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_microsoft_demographic_target
Schreiben2 CreditsLegt Gebotsanpassungen nach Alter und Geschlecht (Prozent -100..900) in einer Microsoft Advertising Kampagne oder Anzeigengruppe fest. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID oder Microsoft-Kampagnen-ID (Kampagnenebene) |
ad_group_idOptional | string | Microsoft-Anzeigengruppen-ID (Anzeigengruppenebene hat Vorrang vor Kampagnenebene) |
agesOptional | array<object> | — |
gendersOptional | array<object> | — |
criterion_typeOptional | age | gender | single-criterion form |
valueOptional | string | single-criterion form: age range (e.g. 25-34) or gender |
bid_multiplierOptional | number | single-criterion form: percent -100..900 |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_microsoft_ad_schedule
Schreiben2 CreditsFügt einer Microsoft Advertising Kampagne oder Anzeigengruppe einen Werbezeitplaner hinzu (Tag-/Zeitfenster mit Gebotsanpassung); außerhalb der Zeitfenster werden keine Anzeigen ausgeliefert. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID oder Microsoft-Kampagnen-ID (Kampagnenebene) |
ad_group_idOptional | string | Microsoft-Anzeigengruppen-ID (Anzeigengruppenebene hat Vorrang vor Kampagnenebene) |
scheduleOptional | array<object> | — |
daysOptional | any | short form (instead of schedule): weekdays | weekend | all or a list of day names |
from_hourOptional | integer | — |
to_hourOptional | integer | — |
bid_adjustmentOptional | number | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_microsoft_remarketing_list
Schreiben2 CreditsErstellt eine Remarketing-Liste (Regel für Seitenbesucher auf dem UET-Tag) im Microsoft Advertising Konto. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
descriptionOptional | string | — |
url_containsPflicht | string | Besucher von Seiten, deren URL übereinstimmt |
operatorOptional | Contains | Equals | BeginsWith | EndsWith | DoesNotContain | — |
membership_durationOptional | integer | Tage 1-180, Standard 30 |
tag_idOptional | string | UET-Tag-ID; Standard: erstes Tag |
uet_tag_idOptional | string | alias of tag_id |
valueOptional | string | Alias of url_contains |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_microsoft_conversion_goal
Schreiben2 CreditsErstellt ein Conversion-Ziel (URL-Ziel: Dankeseite; Ereignisziel: benutzerdefiniertes UET-Ereignis) im Microsoft Advertising Konto. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
goal_typeOptional | url | event | — |
categoryOptional | Purchase | Signup | Contact | SubmitLeadForm | RequestQuote | BookAppointment | AddToCart | BeginCheckout | Subscribe | PageView | OutboundClick | GetDirections | Other | — |
url_expressionOptional | string | — |
url_operatorOptional | Contains | Equals | BeginsWith | RegularExpression | — |
actionOptional | string | — |
category_expressionOptional | string | — |
labelOptional | string | — |
valueOptional | number | — |
action_operatorOptional | string | event goals: Equals | BeginsWith | Contains | RegularExpression |
category_expression_operatorOptional | string | event goals: Equals | BeginsWith | Contains | RegularExpression |
label_operatorOptional | string | event goals: Equals | BeginsWith | Contains | RegularExpression |
value_operatorOptional | string | event goals: Equals | GreaterThan | LessThan |
count_typeOptional | all | unique | — |
conversion_window_daysOptional | number | — |
revenue_valueOptional | number | — |
revenue_typeOptional | fixed | variable | — |
currencyOptional | string | — |
tag_idOptional | string | — |
uet_tag_idOptional | string | alias of tag_id |
operatorOptional | string | alias of url_operator |
goal_categoryOptional | string | alias of category |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_microsoft_uet_tag
Schreiben2 CreditsErstellt ein UET-Tag; das Ergebnis enthält das Tracking-Skript, das auf der Website einzubinden ist. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
descriptionOptional | string | — |
account_idOptional | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idOptional | string | optional: manager account (customer) id of account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_microsoft_campaign
SchreibenUnumkehrbar2 CreditsLöscht eine Microsoft Advertising-Kampagne DAUERHAFT (nicht rückgängig zu machen; im Zweifel pausieren). Wartet unabhängig von der Freigaberichtlinie immer auf die ausdrückliche Freigabe des Nutzers. Erstellt einen Freigabeeintrag mit Vorschau; bei Microsoft erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Manager-Konto-ID (customer) von account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_microsoft_audience
SchreibenUnumkehrbar2 CreditsLöscht eine Microsoft Advertising-Zielgruppe (z. B. eine Remarketing-Liste) DAUERHAFT. Wartet immer auf die ausdrückliche Freigabe des Nutzers. Erstellt einen Freigabeeintrag mit Vorschau; bei Microsoft erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
audience_idPflicht | string | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Manager-Konto-ID (customer) von account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_microsoft_ad_status
Schreiben2 CreditsPausiert oder aktiviert eine einzelne Microsoft Advertising-Anzeige. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | — |
ad_idPflicht | string | — |
statusPflicht | pause | resume | paused | active | — |
ad_typeOptional | ResponsiveSearch | ExpandedText | Text | DynamicSearch | ResponsiveAd | Image | Product | AppInstall | Hotel | Standard ResponsiveSearch (siehe list_microsoft_ads) |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Verwaltungskonto-(Kunden-)ID von account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_microsoft_responsive_search_ad
Schreiben2 CreditsÄndert den Text einer bestehenden responsiven Microsoft Advertising-Suchanzeige direkt (behält die Anzeigen-ID und den Leistungsverlauf, anders als ein Neuaufbau). Angegebene Listen ersetzen die aktuellen. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | — |
ad_idPflicht | string | — |
headlinesOptional | array<string> | vollständiger neuer Satz, 3-15, ≤30 Zeichen |
descriptionsOptional | array<string> | vollständiger neuer Satz, 2-4, ≤90 Zeichen |
final_urlOptional | string | — |
path1Optional | string | — |
path2Optional | string | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Verwaltungskonto-(Kunden-)ID von account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_microsoft_ad_group
Schreiben2 CreditsBearbeitet eine Microsoft Advertising-Anzeigengruppe: Name, Standard-CPC-Gebot, Start-/Enddatum, Status, Suchnetzwerk. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | — |
ad_group_idPflicht | string | — |
nameOptional | string | — |
cpc_bidOptional | number | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
statusOptional | pause | resume | paused | active | — |
networkOptional | all | microsoft_only | syndicated_only | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Verwaltungskonto-(Kunden-)ID von account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_microsoft_ad_extensions
Schreiben2 CreditsFügt einer Microsoft Advertising-Kampagne Sitelink- und/oder Callout-Erweiterungen hinzu (in der Kontobibliothek erstellt und dann der Kampagne zugeordnet). Erstellt einen Freigabeeintrag mit Vorschau; bei Microsoft erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | — |
sitelinksOptional | array<object> | — |
calloutsOptional | array<string> | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Manager-Konto-ID (customer) von account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
remove_microsoft_ad_extensions
SchreibenUnumkehrbar2 CreditsEntfernt Sitelink-/Zusatzinformations-Erweiterungen: löst sie von der Kampagne und löscht sie aus der Kontobibliothek (dauerhaft; sie fallen aus allen Kampagnen heraus). Wartet immer auf die ausdrückliche Freigabe des Nutzers. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
extension_idsPflicht | array<string> | — |
campaign_idOptional | string | zuerst von dieser Kampagne lösen (optional) |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Verwaltungskonto-(Kunden-)ID von account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
remove_microsoft_negative_keywords
SchreibenUnumkehrbar2 CreditsEntfernt auszuschließende Keywords (nach Text, optional mit einer Übereinstimmungsart) aus einer Microsoft Advertising-Kampagne oder Anzeigengruppe — z. B. um ein Negativ rückgängig zu machen, das guten Traffic blockiert. Nur tatsächlich vorhandene Negative werden entfernt. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | — |
ad_group_idOptional | string | Anzeigengruppenebene; campaign_id ist ebenfalls nötig |
keywordsPflicht | array<string> | — |
match_typeOptional | PHRASE | EXACT | — |
entity_idOptional | string | Alias: Kampagnen- oder Anzeigengruppen-ID, zusammen mit entity_type |
entity_typeOptional | Campaign | AdGroup | — |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Verwaltungskonto-(Kunden-)ID von account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
upload_microsoft_offline_conversions
Schreiben2 CreditsSendet Offline-Conversions (z. B. CRM-Verkäufe) per Klick-ID an Microsoft Advertising, damit die Gebotsstrategie aus echten Ergebnissen lernt. Bis zu 1000 Zeilen pro Aufruf; das Ziel muss existieren und die Klicks dürfen höchstens 90 Tage alt sein. Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto auf Microsoft angewendet (andernfalls Testlauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
conversion_namePflicht | string | Name eines Offline-Conversion-Ziels im Konto |
conversionsPflicht | array<object> | — |
currencyOptional | string | Standardwährung für Zeilen ohne eigene Währung |
account_idOptional | string | optional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups) |
customer_idOptional | string | optional: Verwaltungskonto-(Kunden-)ID von account_id |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.