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

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 Credits

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

ParameterTypBeschreibung
all_accessibleOptionalbooleandefault true; false returns only the selected account

list_microsoft_ad_groups

Lesen1 Credits

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

ParameterTypBeschreibung
campaign_idPflichtstring—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: manager account (customer) id of account_id

list_microsoft_audiences

Lesen1 Credits

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

ParameterTypBeschreibung
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: manager account (customer) id of account_id

list_microsoft_conversion_goals

Lesen1 Credits

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

ParameterTypBeschreibung
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: manager account (customer) id of account_id

list_microsoft_uet_tags

Lesen1 Credits

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

ParameterTypBeschreibung
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: manager account (customer) id of account_id

microsoft_search_terms_report

Lesen2 Credits

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

ParameterTypBeschreibung
daysOptionalinteger (1–90)—
campaign_idOptionalstring—
start_dateOptionalstringYYYY-MM-DD (overrides days)
end_dateOptionalstringYYYY-MM-DD, default today
min_wasteOptionalnumberonly count zero-conversion terms spending at least this much as wasted
limitOptionalinteger (1–500)—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: manager account (customer) id of account_id

microsoft_performance_report

Lesen2 Credits

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

ParameterTypBeschreibung
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD (overrides days)
end_dateOptionalstringYYYY-MM-DD, default today
breakdownOptionalcampaign | ad_group | device—
campaign_idOptionalstring—
compare_previousOptionalbooleanzusätzlich den vorherigen Zeitraum gleicher Länge zurückgeben
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: manager account (customer) id of account_id

list_microsoft_campaigns

Lesen1 Credits

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

ParameterTypBeschreibung
statusOptionalstringoptionaler Filter: live | paused | ended (oder Microsoft-Status)
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: Manager-Konto-ID (customer) von account_id

diagnose_microsoft_delivery

Lesen2 Credits

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

ParameterTypBeschreibung
campaign_idPflichtstringMicrosoft-Kampagnen-ID (list_microsoft_campaigns) oder Tecrübe-Kampagnen-ID
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: Manager-Konto-ID (customer) von account_id

list_microsoft_ads

Lesen1 Credits

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

ParameterTypBeschreibung
ad_group_idPflichtstring—
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: Manager-Konto-ID (customer) von account_id

list_microsoft_keywords

Lesen1 Credits

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

ParameterTypBeschreibung
ad_group_idPflichtstring—
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: Manager-Konto-ID (customer) von account_id

list_microsoft_negative_keywords

Lesen1 Credits

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

ParameterTypBeschreibung
campaign_idOptionalstring—
ad_group_idOptionalstringAnzeigengruppenebene; campaign_id wird ebenfalls benötigt
entity_idOptionalstringAlias: Kampagnen- oder Anzeigengruppen-ID, zusammen mit entity_type
entity_typeOptionalCampaign | AdGroup—
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: Manager-Konto-ID (customer) von account_id

list_microsoft_ad_extensions

Lesen1 Credits

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

ParameterTypBeschreibung
campaign_idOptionalstringoptional; standardmäßig alle Kampagnen des Kontos
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: Manager-Konto-ID (customer) von account_id

microsoft_entity_performance_report

Lesen2 Credits

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

ParameterTypBeschreibung
levelOptionalad_group | ad | keyword | location | device | age_gender—
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD (überschreibt days)
end_dateOptionalstringYYYY-MM-DD, Standard heute
campaign_idOptionalstring—
limitOptionalinteger (1–500)—
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: Verwaltungskonto-(Kunden-)ID von account_id

microsoft_report_query

Lesen2 Credits

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

ParameterTypBeschreibung
report_typePflichtstringReporting-v13-Bericht, z. B. KeywordPerformanceReport, AdPerformanceReport, GeographicPerformanceReport
columnsPflichtarray<string>Spaltennamen dieses Berichts, z. B. CampaignName, Clicks, Spend
aggregationOptionalSummary | Hourly | Daily | Weekly | Monthly | Yearly | HourOfDay | DayOfWeek | WeeklyStartingMonday—
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD (überschreibt days)
end_dateOptionalstringYYYY-MM-DD, Standard heute
limitOptionalinteger (1–2000)—
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: Verwaltungskonto-(Kunden-)ID von account_id

Schreib-Tools27 Tools

select_microsoft_account

Schreiben1 Credits

Legt fest, welches Microsoft Advertising Werbekonto alle weiteren Lese- und Schreibvorgänge verwenden (Manager-/Agentur-Setups). Lokale Einstellung; auf Microsoft wird nichts geändert.

ParameterTypBeschreibung
account_idPflichtstring—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_microsoft_campaign

Schreiben2 Credits

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

ParameterTypBeschreibung
namePflichtstring—
daily_budgetPflichtnumberTagesbudget in der Kontowährung
kindOptionalstringsearch (Standard) | local_search | sales | traffic
goalOptionalstring—
languageOptionalstringAnzeigensprache, z. B. Turkish, English (Standard Turkish)
campaign_typeOptionalSearchonly Search is supported
bid_strategyOptionalmanual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share—
target_cpaOptionalnumber—
target_roasOptionalnumber—
max_cpcOptionalnumber—
final_urlOptionalstringZielseite für die Anzeigen; standardmäßig die Marken-Website
ad_groupsOptionalarray<object>—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

Fü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).

ParameterTypBeschreibung
campaign_idPflichtstring—
namePflichtstring—
cpc_bidOptionalnumber—
keywordsOptionalarray<any>—
headlinesOptionalarray<string>—
descriptionsOptionalarray<string>—
final_urlOptionalstring—
path1Optionalstring—
path2Optionalstring—
languageOptionalstring—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

Fü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).

ParameterTypBeschreibung
ad_group_idPflichtstring—
campaign_idOptionalstring—
keywordsPflichtarray<any>—
match_typeOptionalBROAD | PHRASE | EXACTdefault for plain-text keywords (PHRASE)
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

Fü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).

ParameterTypBeschreibung
campaign_idOptionalstring—
ad_group_idOptionalstringoptional: Ausschlüsse auf Anzeigengruppenebene
keywordsPflichtarray<string>—
match_typeOptionalPHRASE | EXACT—
entity_idOptionalstringalias: campaign or ad group id, with entity_type
entity_typeOptionalCampaign | AdGroup—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

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

ParameterTypBeschreibung
ad_group_idPflichtstring—
headlinesPflichtarray<string>—
descriptionsPflichtarray<string>—
final_urlPflichtstring—
path1Optionalstring—
path2Optionalstring—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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).

ParameterTypBeschreibung
campaign_idPflichtstring—
amountOptionalnumberneues Tagesbudget in der Kontowährung
daily_budgetOptionalnumberalias of amount
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

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

ParameterTypBeschreibung
campaign_idPflichtstring—
statusPflichtpause | resume | paused | active—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

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

ParameterTypBeschreibung
campaign_idPflichtstring—
ad_group_idPflichtstring—
statusPflichtpause | resume—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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).

ParameterTypBeschreibung
ad_group_idPflichtstring—
keyword_idPflichtstring—
bidOptionalnumber—
statusOptionalpause | resume—
match_typeOptionalBROAD | PHRASE | EXACT—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

Legt 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).

ParameterTypBeschreibung
campaign_idPflichtstring—
strategyPflichtmanual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share—
target_cpaOptionalnumber—
target_roasOptionalnumberz. B. 4.0 für 400 %
max_cpcOptionalnumber—
target_impression_shareOptionalnumber—
target_ad_positionOptionalAbsoluteTopOfPage | TopOfPage | MainLine1—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

Zielt 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).

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID oder Microsoft-Kampagnen-ID (Kampagnenebene)
ad_group_idOptionalstringMicrosoft-Anzeigengruppen-ID (Anzeigengruppenebene hat Vorrang vor Kampagnenebene)
locationsOptionalarray<string>Namen von Städten/Regionen/Ländern, z. B. İstanbul, Ankara
location_idsOptionalarray<string>Microsoft-Standort-IDs, falls bereits bekannt
countryOptionalstringHinweis zur Eindeutigkeit, Standard Türkiye
bid_adjustmentOptionalnumberProzent -100..900
bid_multiplierOptionalnumberalias of bid_adjustment
excludeOptionalboolean—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

Legt 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).

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID oder Microsoft-Kampagnen-ID (Kampagnenebene)
ad_group_idOptionalstringMicrosoft-Anzeigengruppen-ID (Anzeigengruppenebene hat Vorrang vor Kampagnenebene)
computersOptionalnumber—
smartphonesOptionalnumber—
tabletsOptionalnumber—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

Legt 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).

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID oder Microsoft-Kampagnen-ID (Kampagnenebene)
ad_group_idOptionalstringMicrosoft-Anzeigengruppen-ID (Anzeigengruppenebene hat Vorrang vor Kampagnenebene)
agesOptionalarray<object>—
gendersOptionalarray<object>—
criterion_typeOptionalage | gendersingle-criterion form
valueOptionalstringsingle-criterion form: age range (e.g. 25-34) or gender
bid_multiplierOptionalnumbersingle-criterion form: percent -100..900
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

Fü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).

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID oder Microsoft-Kampagnen-ID (Kampagnenebene)
ad_group_idOptionalstringMicrosoft-Anzeigengruppen-ID (Anzeigengruppenebene hat Vorrang vor Kampagnenebene)
scheduleOptionalarray<object>—
daysOptionalanyshort form (instead of schedule): weekdays | weekend | all or a list of day names
from_hourOptionalinteger—
to_hourOptionalinteger—
bid_adjustmentOptionalnumber—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

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

ParameterTypBeschreibung
namePflichtstring—
descriptionOptionalstring—
url_containsPflichtstringBesucher von Seiten, deren URL übereinstimmt
operatorOptionalContains | Equals | BeginsWith | EndsWith | DoesNotContain—
membership_durationOptionalintegerTage 1-180, Standard 30
tag_idOptionalstringUET-Tag-ID; Standard: erstes Tag
uet_tag_idOptionalstringalias of tag_id
valueOptionalstringAlias of url_contains
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

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

ParameterTypBeschreibung
namePflichtstring—
goal_typeOptionalurl | event—
categoryOptionalPurchase | Signup | Contact | SubmitLeadForm | RequestQuote | BookAppointment | AddToCart | BeginCheckout | Subscribe | PageView | OutboundClick | GetDirections | Other—
url_expressionOptionalstring—
url_operatorOptionalContains | Equals | BeginsWith | RegularExpression—
actionOptionalstring—
category_expressionOptionalstring—
labelOptionalstring—
valueOptionalnumber—
action_operatorOptionalstringevent goals: Equals | BeginsWith | Contains | RegularExpression
category_expression_operatorOptionalstringevent goals: Equals | BeginsWith | Contains | RegularExpression
label_operatorOptionalstringevent goals: Equals | BeginsWith | Contains | RegularExpression
value_operatorOptionalstringevent goals: Equals | GreaterThan | LessThan
count_typeOptionalall | unique—
conversion_window_daysOptionalnumber—
revenue_valueOptionalnumber—
revenue_typeOptionalfixed | variable—
currencyOptionalstring—
tag_idOptionalstring—
uet_tag_idOptionalstringalias of tag_id
operatorOptionalstringalias of url_operator
goal_categoryOptionalstringalias of category
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

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

ParameterTypBeschreibung
namePflichtstring—
descriptionOptionalstring—
account_idOptionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOptionalstringoptional: 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 Credits

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

ParameterTypBeschreibung
campaign_idPflichtstring—
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: 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 Credits

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

ParameterTypBeschreibung
audience_idPflichtstring—
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: 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 Credits

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

ParameterTypBeschreibung
ad_group_idPflichtstring—
ad_idPflichtstring—
statusPflichtpause | resume | paused | active—
ad_typeOptionalResponsiveSearch | ExpandedText | Text | DynamicSearch | ResponsiveAd | Image | Product | AppInstall | HotelStandard ResponsiveSearch (siehe list_microsoft_ads)
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: 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).

ParameterTypBeschreibung
ad_group_idPflichtstring—
ad_idPflichtstring—
headlinesOptionalarray<string>vollständiger neuer Satz, 3-15, ≤30 Zeichen
descriptionsOptionalarray<string>vollständiger neuer Satz, 2-4, ≤90 Zeichen
final_urlOptionalstring—
path1Optionalstring—
path2Optionalstring—
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: 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 Credits

Bearbeitet 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).

ParameterTypBeschreibung
campaign_idPflichtstring—
ad_group_idPflichtstring—
nameOptionalstring—
cpc_bidOptionalnumber—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
statusOptionalpause | resume | paused | active—
networkOptionalall | microsoft_only | syndicated_only—
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: 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 Credits

Fü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).

ParameterTypBeschreibung
campaign_idPflichtstring—
sitelinksOptionalarray<object>—
calloutsOptionalarray<string>—
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: 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 Credits

Entfernt 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).

ParameterTypBeschreibung
extension_idsPflichtarray<string>—
campaign_idOptionalstringzuerst von dieser Kampagne lösen (optional)
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: 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 Credits

Entfernt 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).

ParameterTypBeschreibung
campaign_idOptionalstring—
ad_group_idOptionalstringAnzeigengruppenebene; campaign_id ist ebenfalls nötig
keywordsPflichtarray<string>—
match_typeOptionalPHRASE | EXACT—
entity_idOptionalstringAlias: Kampagnen- oder Anzeigengruppen-ID, zusammen mit entity_type
entity_typeOptionalCampaign | AdGroup—
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: 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 Credits

Sendet 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).

ParameterTypBeschreibung
conversion_namePflichtstringName eines Offline-Conversion-Ziels im Konto
conversionsPflichtarray<object>—
currencyOptionalstringStandardwährung für Zeilen ohne eigene Währung
account_idOptionalstringoptional: nur für diesen Aufruf in diesem Microsoft-Werbekonto ausführen (Agentur-Setups)
customer_idOptionalstringoptional: Verwaltungskonto-(Kunden-)ID von account_id

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.