Google-Ads-Tools
Such- und Performance-Max-Kampagnen, Keywords, Anzeigentexte, Conversions, Gebotsstrategien und Empfehlungen.
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-Tools45 Tools
list_google_ads_accounts
Lesen1 CreditsGoogle Ads-Konten, auf die der verbundene Google-Nutzer zugreifen kann, einschließlich Kundenkonten unter MCC-/Verwaltungskonten (ID, Name, Währung, Zeitzone, Verwalter, login_customer_id), und welches ausgewählt ist. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
Dieses Tool hat keine Parameter.
google_ads_report
Lesen2 CreditsGoogle Ads-Leistung (Ausgaben, Klicks, Impressionen, Conversions, Umsatz, CTR, CPC, CPA, ROAS) nach Kampagne, Anzeigengruppe, Keyword, Gerät, Standort, Stunde, Wochentag oder Konto (alle MCC-Kundenkonten in Rangfolge). Zeitraum über Tage oder Start/Ende; compare_previous ergänzt den Vorzeitraum. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
breakdownOptional | campaign | ad_group | ad | keyword | search_term | device | location | hour | day_of_week | account | — |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
compare_previousOptional | boolean | liefert zusätzlich den gleich langen Vorzeitraum und die prozentuale Veränderung |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_device_report
Lesen2 CreditsGoogle Ads-Leistung aufgeteilt nach Gerät (Mobil, Desktop, Tablet, Connected TV) mit CPA und ROAS je Gerät. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
compare_previousOptional | boolean | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_ads_change_history
Lesen1 CreditsWer hat im Google Ads-Konto was wann geändert (maximal die letzten 30 Tage): Nutzer, Werkzeug (UI/API), Ressource, Vorgang und alte → neue Werte. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–30) | — |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
limitOptional | integer (1–1000) | — |
resource_typeOptional | AD | AD_GROUP | AD_GROUP_CRITERION | CAMPAIGN | CAMPAIGN_BUDGET | AD_GROUP_BID_MODIFIER | CAMPAIGN_CRITERION | AD_GROUP_AD | ASSET | CUSTOMER_ASSET | CAMPAIGN_ASSET | AD_GROUP_ASSET | ASSET_SET | ASSET_SET_ASSET | CAMPAIGN_ASSET_SET | — |
operationOptional | CREATE | UPDATE | REMOVE | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ads_recommendations
Lesen1 CreditsGoogles eigene Optimierungsempfehlungen (Typ, Kampagne, geschätzte Auswirkung). Ausgewählte mit apply_google_ads_recommendation anwenden. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
typesOptional | array<string> | Empfehlungstypen, z. B. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
include_dismissedOptional | boolean | — |
limitOptional | integer (1–10000) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_ads_quality_score_report
Lesen2 CreditsKeyword-Qualitätsfaktor (1-10) mit seinen Komponenten (erwartete CTR, Anzeigenrelevanz, Nutzererfahrung mit der Landingpage) und Ausgaben; fasst Keywords mit niedrigem Wert zusammen und zeigt, welche Komponente sie herunterzieht. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–90) | — |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_keyword_planner
Lesen2 CreditsIdeen aus dem Google Ads Keyword-Planer: echte durchschnittliche monatliche Suchanfragen, Wettbewerb und Gebotsspanne für die obere Seitenposition zu Ausgangs-Keywords oder einer URL. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
seed_keywordsOptional | array<string> | — |
urlOptional | string | — |
locationOptional | string | Stadt-/Regionsnamen, kommagetrennt |
countryOptional | string | ISO-Code, Standard TR |
languageOptional | string | tr, en, de, fr, es, ar, ru |
limitOptional | integer (10–500) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ip_exclusions
Lesen1 CreditsIP-Ausschlüsse in Google Ads-Kampagnen. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ad_groups
Lesen1 CreditsAnzeigengruppen (ID, Name, Status, Standard-CPC) des Google Ads-Kontos oder einer Kampagne. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_shared_negative_lists
Lesen1 CreditsGemeinsame Listen auszuschließender Keywords im Google Ads-Konto mit Keyword-Anzahl und zugeordneten Kampagnen. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
list_idOptional | string | liefert zusätzlich die Keywords dieser Liste |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ads
Lesen1 CreditsResponsive Suchanzeigen mit allen Anzeigentiteln/Beschreibungen, Googles Leistungslabel (LOW/GOOD/BEST), Anzeigeneffektivität und finaler URL. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
ad_group_idOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_conversion_actions
Lesen1 CreditsConversion-Aktionen des Google Ads-Kontos: Typ, Kategorie, Status, primär/sekundär, Zählung, Werteinstellungen, Klick-Conversion-Fenster. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–365) | also return conversions recorded per action in this window |
statusOptional | string | only this status, e.g. ENABLED or REMOVED |
searchOptional | string | name contains |
include_removedOptional | boolean | also list removed actions (to verify a removal) |
limitOptional | integer (1–200) | default 50 |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_asset_groups
Lesen1 CreditsPerformance Max-Asset-Gruppen mit Anzeigeneffektivität, finalen URLs und ihren Text-/Bild-Assets je Feldtyp. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
asset_group_idOptional | string | — |
signalsOptional | boolean | also return audience signals and search themes |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_demand_gen_campaigns
Lesen1 CreditsDemand Gen-Kampagnen des Google Ads-Kontos mit Status, Gebotsstrategie, Tagesbudget und Zeitraumleistung (Ausgaben, Klicks, Impressionen, Conversions, Umsatz, CTR, CPC, CPA, ROAS). Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_app_campaigns
Lesen1 CreditsApp-Kampagnen des Google Ads-Kontos mit App-ID, Store, Gebotsziel, Status, Tagesbudget und Zeitraumleistung. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_invalid_clicks_report
Lesen2 CreditsBericht zu ungültigen Klicks (Klickbetrug) je Kampagne und Tag aus Googles eigenen Messwerten (metrics.invalid_clicks, metrics.invalid_click_rate, clicks, cost) für die letzten N Tage (Standard 14); markiert Kampagnen, deren ungültige Rate den Schwellenwert (Standard 10 %) überschreitet oder deren letzter Tag sprunghaft anstieg (3x des vorherigen Durchschnitts), plus Städte mit vielen Klicks ohne Conversions bei verdächtigen Kampagnen. Ehrliche Grenzen: Google meldet nur bereits herausgefilterte ungültige Klicks und gibt nie Klicker-IPs preis — ein Warnsignal, kein Beweis auf IP-Ebene. Ungültige Klicks werden nicht berechnet. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
threshold_rateOptional | number | verdächtige Rate ungültiger Klicks als Bruchteil, Standard 0.10 |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_merchant_accounts
Lesen1 CreditsGoogle Merchant Center-Konten, die mit dem verbundenen Google-Token erreichbar sind (Merchant API accounts v1beta): ID, Name, Sprache, Zeitzone, Testkennzeichen. Nutzt die verbundene Google-Einwilligung; liefert error=scope_missing, wenn der Merchant Center-Bereich (auth/content) fehlt — der Nutzer muss Google neu autorisieren.
Dieses Tool hat keine Parameter.
list_merchant_products
Lesen1 CreditsMerchant Center-Produkte (Merchant API products v1beta) mit Titel, Angebots-ID, Preis, Verfügbarkeit, Freigabestatus je Ziel und Problemen auf Artikelebene; Filter auf abgelehnte / ausstehende / Produkte mit Problemen. Nutzt die verbundene Google-Einwilligung; liefert error=scope_missing, wenn der Merchant Center-Bereich (auth/content) fehlt — der Nutzer muss Google neu autorisieren.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Merchant Center-Konto-ID; optional, wenn der Nutzer ein einziges Konto hat oder eines ausgewählt ist |
statusOptional | all | disapproved | pending | approved | issues | issues = beliebiges Problem auf Artikelebene oder abgelehntes Land |
queryOptional | string | Teilzeichenfolge von Titel oder Angebots-ID |
limitOptional | integer (1–1000) | — |
get_merchant_product_issues
Lesen1 CreditsProbleme auf Artikelebene eines Merchant Center-Produkts (Code, Schweregrad, Lösung, Beschreibung, betroffene Länder) plus seine Zielstatus; markiert, welche Probleme der Händler über Produktdaten beheben kann. Nutzt die verbundene Google-Einwilligung; liefert error=scope_missing, wenn der Merchant Center-Bereich (auth/content) fehlt — der Nutzer muss Google neu autorisieren.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Merchant Center-Konto-ID; optional, wenn der Nutzer ein einziges Konto hat oder eines ausgewählt ist |
product_idOptional | string | z. B. online~tr~TR~SKU123 (aus list_merchant_products) |
offer_idOptional | string | — |
merchant_feed_status
Lesen1 CreditsMerchant Center-Datenquellen (Feeds): Typ, Eingabemethode (API/FILE/UI/AUTOFEED), Feed-Label, Sprache und bei Dateifeeds der Verarbeitungsstatus des letzten Uploads, Artikelanzahl und Probleme. Nutzt die verbundene Google-Einwilligung; liefert error=scope_missing, wenn der Merchant Center-Bereich (auth/content) fehlt — der Nutzer muss Google neu autorisieren.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Merchant Center-Konto-ID; optional, wenn der Nutzer ein einziges Konto hat oder eines ausgewählt ist |
google_ads_query
Lesen2 CreditsFührt eine einzelne schreibgeschützte SELECT-Abfrage in Google Ads Query Language aus und liefert die Rohzeilen — für Daten, die kein eigenes Tool liefert. Nur ein SELECT wird akzeptiert (kein ';', keine Kommentare oder Schreib-Schlüsselwörter); LIMIT wird erzwungen (≤1000). Geldfelder kommen in Micros. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
queryPflicht | string | eine GAQL-SELECT-Anweisung, z. B. SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS |
limitOptional | integer (1–1000) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_ad_details
Lesen1 CreditsVollständiger Inhalt von Google Ads-Anzeigen (Typ, jeder RSA-Anzeigentitel und jede Beschreibung mit Fixierungen, URLs, Tracking-Vorlage, Status) plus Anzeigeneffektivität, Googles Verbesserungsvorschläge und Richtlinienstatus. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
ad_group_idOptional | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
ad_idOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_campaign_targeting
Lesen1 CreditsAktuelles Targeting einer Google Ads-Kampagne (oder Anzeigengruppe): Standorte mit Namen, ausgeschlossene Standorte, Umkreis-Ziele (Breite/Länge, Radius, Einheit), Sprachen, Gebotsanpassungen für Geräte, Zielgruppen und die Standortoption Anwesenheit/Interesse. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
ad_group_idOptional | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_assets
Lesen2 CreditsDie gesamte Google Ads-Asset-Bibliothek des Kontos (Text, Bilder mit Größe, YouTube-Videos, Sitelinks, Callouts, Snippets, Anrufe, Angebote, Preise, Lead-Formulare, WhatsApp), optional mit Verwendungsort und Freigabestatus jedes Assets. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
asset_typeOptional | TEXT | IMAGE | YOUTUBE_VIDEO | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | LEAD_FORM | BUSINESS_MESSAGE | MOBILE_APP | CALL_TO_ACTION | LOCATION | PAGE_FEED | — |
limitOptional | integer (1–1000) | — |
include_usageOptional | boolean | auch auflisten, welche Kampagnen/Anzeigengruppen jedes Asset nutzen |
include_approvalOptional | boolean | Richtlinien-Freigabe-/Prüfstatus hinzufügen |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
rsa_asset_performance
Lesen2 CreditsErgebnisse responsiver Suchanzeigen je Anzeigentitel und Beschreibung (Impressionen, Klicks, Kosten, Conversions, Wert, CPA, CTR, Conversion-Rate) mit Googles LOW/GOOD/BEST-Label, Fixierung und der Anzeigeneffektivität. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
daysOptional | integer (1–365) | — |
limitOptional | integer (1–1000) | — |
min_impressionsOptional | integer (0–…) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
keyword_historical_metrics
Lesen2 CreditsHistorische Keyword-Planer-Messwerte für bereits bekannte Keywords: durchschnittliche und monatliche Suchanfragen, Wettbewerb, Gebotsspanne für oben auf der Seite und durchschnittlicher CPC. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
keywordsPflicht | array<string> | — |
language_idOptional | string | Google-Sprachkonstanten-ID, Standard 1037 (Türkisch) |
languageOptional | string | alternativ ein Sprachcode (tr, en…) |
geo_idsOptional | array<string> | Geo-Target-Konstanten-IDs (geo_target_search), Standard 2792 (Türkei) |
start_monthOptional | string | YYYY-MM |
end_monthOptional | string | YYYY-MM |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
keyword_quality_report
Lesen2 CreditsHistorischer Qualitätsfaktor pro Keyword Tag für Tag mit seinen drei Komponenten; markiert die Tage, an denen er gesunken ist, und welche Komponente sich geändert hat. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
ad_group_idOptional | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
daysOptional | integer (1–90) | — |
limitOptional | integer (1–500) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_negative_keywords
Lesen1 CreditsAlle geltenden auszuschließenden Keywords: auf Kampagnenebene, auf Anzeigengruppenebene und die mit Kampagnen verknüpften gemeinsamen Ausschlusslisten (mit ihren Keywords). Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
smart_negative_keywords
Lesen2 CreditsVorschläge für auszuschließende Keywords: Suchbegriffe, die ohne Conversion Geld ausgegeben haben und nirgends bereits ausgeschlossen sind, sortiert nach Ausgaben (geschätzte Einsparung). Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–90) | — |
min_wasteOptional | number | Mindestausgaben je Begriff |
limitOptional | integer (1–500) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
conversion_tracking_health
Lesen2 CreditsCheck-up des Conversion-Trackings: ausgeblendete/entfernte Aktionen, primäre Aktionen, die im Zeitraum nichts erfasst haben, und eine fehlende primäre Aktion. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–90) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
extension_asset_performance
Lesen2 CreditsLeistung der Kampagnenerweiterungen (Sitelinks, Callouts, Anruf, Snippets, Angebote, Preise, WhatsApp, Bilder, Unternehmensname/-logo): Impressionen, Klicks, Kosten, Conversions pro Asset. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–365) | — |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
field_typeOptional | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGE | — |
limitOptional | integer (1–1000) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_ad_schedule
Lesen1 CreditsAktueller Werbezeitplan einer Kampagne: Tag, Start-/Endzeit, Gebotsanpassung und Kriteriums-ID pro Zeitfenster. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_conversion_tags
Lesen1 CreditsTag-Details von Conversion-Aktionen: Conversion-ID (AW-…), Label und der send_to-Wert für Tag Manager / gtag sowie die Roh-Snippets. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
conversion_action_idsOptional | array<string> | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_extension_assets
Lesen1 CreditsMit einer Kampagne oder Anzeigengruppe verknüpfte Erweiterungs-Assets (Sitelinks, Callouts, Anruf, Snippets, Angebote, Preise, WhatsApp, Lead-Formular, App, Unternehmensname/-logo) mit dem Ressourcennamen der Verknüpfung zum Entfernen. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
ad_group_idOptional | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_conversion_goals
Lesen1 CreditsConversion-Ziele des Kontos (Kategorie × Quelle) und ob jedes primär/gebotsfähig ist; mit campaign_id auch die Zielüberschreibungen dieser Kampagne. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_custom_conversion_goals
Lesen1 CreditsBenutzerdefinierte Conversion-Ziele: Name, enthaltene Conversion-Aktionen, Status und die Kampagnen, die jeweils darauf optimieren. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
budget_pacing_alerts
Lesen2 CreditsAusgaben seit Monatsbeginn im Vergleich zum Tagesbudget aktiver Kampagnen, hochgerechnet auf das Monatsende; markiert Kampagnen, die das Budget über- oder unterschreiten werden. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
threshold_pctOptional | number (1–100) | Abweichung, die eine Warnung auslöst, Standard 10 |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
impression_share_analysis
Lesen2 CreditsAnteil an möglichen Impressionen im Suchnetzwerk, Anteil oben / ganz oben, Anteil bei exakter Übereinstimmung und wie viel durch Budget bzw. Rang verloren ging, plus abgelehnte Anzeigen pro Kampagne. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–365) | — |
levelOptional | campaign | ad_group | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_audiences
Lesen1 CreditsZielgruppenlisten (Remarketing, regelbasierte Website, Kundenabgleich, Lookalike): ID, Typ, Status, Mitgliedschaftsdauer, Größe für Suche/Display und Berechtigung. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
limitOptional | integer (1–1000) | — |
definitionOptional | boolean | die Regel-/Ausgangsdefinition der Liste einbeziehen |
searchOptional | string | name contains, or exact list id |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_experiments
Lesen1 CreditsListet Kampagnentests (A/B-Tests) mit ID, Status und Daten auf. Nur lesend; zum Beenden oder Übernehmen eines Tests manage_experiment verwenden. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
actionOptional | list | nur list; zum Beenden oder Übernehmen manage_experiment |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
geo_target_search
Lesen1 CreditsSucht Google-Standort-Targeting-IDs nach Namen: ID, Typ (Stadt, Provinz, Land…), kanonischer Name und Reichweite — die IDs im Standort-Targeting verwenden. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
queryPflicht | string | — |
countryOptional | string | ISO-Länderhinweis |
levelOptional | string | nach Typ filtern, z. B. City, Province, Country, District, Postal Code |
limitOptional | integer (1–50) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_campaign_diagnosis
Lesen2 CreditsLIVE-Statusdiagnose einer Google Ads-Kampagne. Zuerst aufrufen, wenn der Nutzer eine Warnung oder einen Status meldet (falsch konfiguriert, eingeschränkt, nicht aktiv, Lernphase, abgelehnt), und danach zur Überprüfung einer Änderung. Liefert den primären Status mit jedem Grund (Code, Bedeutung, typische Lösung, passende Tools), den Auslieferungsstatus, die Gebotsstrategie mit Ziel-CPA / Ziel-ROAS, das Feld, in dem das Ziel steht, den Systemstatus der Gebotsstrategie (die eigentliche Ursache einer Gebotsfehlkonfiguration), den Zieltyp von App-Kampagnen, Budget und von Google empfohlenes Budget, Start- / Enddatum, die optimierten Conversion-Aktionen mit Status, Befunde, Empfehlungen und letzte Änderungen. Beträge in Kontowährung. Nur lesend. Erfordert ein verbundenes Google Ads-Konto; sonst connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID; ohne Angabe werden alle Kampagnen mit Statusproblem aufgelistet |
relatedOptional | boolean | Standard true: auch die Empfehlungen der Kampagne und die Änderungen der letzten 14 Tage |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_ad_policy_issues
Lesen2 CreditsAnzeigen, die Google abgelehnt oder eingeschränkt hat, mit den Richtlinienthemen und dem Belegtext hinter jeder Entscheidung. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
only_problemsOptional | boolean | Standard true: nur abgelehnte / eingeschränkte Anzeigen |
limitOptional | integer (1–1000) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_lead_form_submissions
Lesen2 CreditsÜber Google Ads-Lead-Formulare eingereichte Leads (Name, E-Mail, Telefon und eigene Antworten, Kampagne, Zeit). Personenbezogene Daten — sorgfältig behandeln. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–90) | — |
asset_idOptional | string | Asset-ID des Lead-Formulars |
limitOptional | integer (1–1000) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_location_assets
Lesen1 CreditsBusiness Profile location sync in Google Ads: location asset sets (LOCATION_SYNC, location groups), whether they are linked to the account, and the synced location assets. linked=false means ads cannot show the Business Profile address yet. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.
Die Beschreibung dieses Tools ist noch nicht übersetzt; gezeigt wird der englische Originaltext, den der Assistent sieht.
| Parameter | Typ | Beschreibung |
|---|---|---|
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tools74 Tools
select_google_ads_account
Schreiben1 CreditsWechselt das Google Ads-Kundenkonto, das alle weiteren Lese- und Schreibvorgänge verwenden (Agentur/MCC: die passende login-customer-id wird automatisch gesetzt). Lokale Einstellung; bei Google ändert sich nichts.
| Parameter | Typ | Beschreibung |
|---|---|---|
customer_idPflicht | string | Kundenkonto-ID aus list_google_ads_accounts |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
apply_google_ads_recommendation
Schreiben2 CreditsWendet ausgewählte Google Ads-Empfehlungen an (bis zu 100). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
recommendationsPflicht | array<string> | Ressourcennamen aus list_google_ads_recommendations |
actionOptional | apply | dismiss | default apply |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_google_search_campaign
Schreiben2 CreditsErstellt eine Google-Suchkampagne in einem Durchgang: Budget, Kampagne, Standort- + Sprachausrichtung, Gebotsstrategie, Anzeigengruppe, Keywords und responsive Suchanzeige (Texte standardmäßig aus dem Markenprofil). Nach Freigabe als PAUSED erstellt. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
daily_budgetPflicht | number | Kontowährung |
locationsOptional | array<string> | Stadt-/Regions-/Ländernamen; Standard: Stadt aus dem Markenprofil |
location_idsOptional | array<string> | Google Geo-Target-Konstanten-IDs |
countryOptional | string | — |
languagesOptional | array<string> | Sprachcodes (tr, en…) oder Google-Sprach-IDs; Standard Türkisch |
bid_strategyOptional | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | — |
target_cpaOptional | number | — |
target_roasOptional | number | — |
max_cpcOptional | number | — |
cpc_bidOptional | number | Standard-CPC der Anzeigengruppe |
keywordsOptional | array<any> | — |
headlinesOptional | array<any> | — |
descriptionsOptional | array<any> | — |
final_urlOptional | string | — |
ad_group_nameOptional | string | — |
search_partnersOptional | boolean | — |
end_dateOptional | string | YYYY-MM-DD |
goalOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_google_pmax_campaign
Schreiben2 CreditsErstellt eine Performance Max-Kampagne: Budget + Kampagne + Asset-Gruppe + Text-Assets + Bilder (von den angegebenen URLs heruntergeladen und hochgeladen) in einer atomaren Anfrage, als PAUSED erstellt. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
daily_budgetPflicht | number | — |
final_urlPflicht | string | — |
business_namePflicht | string | ≤25 Zeichen |
headlinesPflicht | array<string> | 3-15, ≤30 Zeichen |
long_headlinesPflicht | array<string> | 1-5, ≤90 Zeichen |
descriptionsPflicht | array<string> | 2-5, ≤90 Zeichen |
marketing_imagesPflicht | array<string> | 1.91:1 Querformat, mindestens 1 |
square_marketing_imagesPflicht | array<string> | 1:1, mindestens 1 |
logo_imagesPflicht | array<string> | 1:1 Logo, mindestens 1 |
portrait_marketing_imagesOptional | array<string> | Bild-URLs (https) oder Studio-Dateien aus /medya |
landscape_logo_imagesOptional | array<string> | Bild-URLs (https) oder Studio-Dateien aus /medya |
bid_strategyOptional | maximize_conversions | maximize_conversion_value | — |
target_cpaOptional | number | — |
target_roasOptional | number | — |
locationsOptional | array<string> | — |
countryOptional | string | — |
languagesOptional | array<string> | — |
asset_group_nameOptional | string | — |
end_dateOptional | string | — |
goalOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_google_display_campaign
Schreiben2 CreditsErstellt eine Display-Kampagne: Budget + Kampagne + Anzeigengruppe + responsive Displayanzeige (Bilder werden von den angegebenen URLs geladen, auf das Seitenverhältnis jedes Feldes zugeschnitten und hochgeladen) in einer atomaren Anfrage, als PAUSED. Das Suchnetzwerk ist aus; die Kampagne läuft nur im Displaynetzwerk.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
daily_budgetPflicht | number | — |
final_urlPflicht | string | — |
business_namePflicht | string | ≤25 Zeichen |
headlinesPflicht | array<string> | 1-5, ≤30 Zeichen |
long_headlinePflicht | string | ≤90 Zeichen |
descriptionsPflicht | array<string> | 1-5, ≤90 Zeichen |
marketing_imagesPflicht | array<string> | 1.91:1 Querformat, mindestens 1 |
square_marketing_imagesOptional | array<string> | 1:1, mindestens 1 (fehlt es, wird aus dem Querformat zugeschnitten) |
logo_imagesOptional | array<string> | image URLs (https) or Studio /medya files |
landscape_logo_imagesOptional | array<string> | image URLs (https) or Studio /medya files |
bid_strategyOptional | maximize_conversions | target_cpa | maximize_clicks | manual_cpc | — |
target_cpaOptional | number | — |
max_cpcOptional | number | — |
cpc_bidOptional | number | — |
locationsOptional | array<string> | — |
countryOptional | string | — |
languagesOptional | array<string> | — |
ad_group_nameOptional | string | — |
end_dateOptional | string | — |
goalOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_google_shopping_campaign
Schreiben2 CreditsErstellt eine Standard-Shopping-Kampagne: Budget + Kampagne + Anzeigengruppe + Produktanzeige in einer atomaren Anfrage, als PAUSED. Die Produkte stammen aus dem verknüpften Merchant-Center-Konto; die Priorität 0-2 entscheidet, welche Kampagne bei gleichem Produkt gewinnt.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
daily_budgetPflicht | number | — |
merchant_idPflicht | string | — |
campaign_priorityOptional | 0 | 1 | 2 | — |
feed_labelOptional | string | — |
enable_localOptional | boolean | — |
bid_strategyOptional | manual_cpc | maximize_clicks | target_roas | maximize_conversion_value | — |
target_roasOptional | number | — |
max_cpcOptional | number | — |
cpc_bidOptional | number | — |
locationsOptional | array<string> | — |
countryOptional | string | — |
languagesOptional | array<string> | — |
ad_group_nameOptional | string | — |
end_dateOptional | string | — |
goalOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_google_conversion_value_rules
Schreiben2 CreditsPasst den Conversion-Wert zur Auktionszeit nach Bedingung an: z. B. zählt eine Conversion vom Mobilgerät 1,2-fach oder aus einer bestimmten Stadt mehr. Eine Bedingung pro Regel (Gerät, Standort oder Zielgruppe); die Regel gehört zu einem Wertregelsatz für das Konto oder eine Kampagne.
| Parameter | Typ | Beschreibung |
|---|---|---|
actionOptional | create | remove | — |
operationOptional | ADD | MULTIPLY | SET | — |
valueOptional | number | für MULTIPLY 0,5-10; für ADD/SET größer als 0 (in der Kontowährung) |
device_typesOptional | array<string> | e.g. MOBILE, DESKTOP, TABLET |
geo_target_idsOptional | array<string> | — |
geo_match_typeOptional | string | — |
user_list_idsOptional | array<string> | — |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
resource_nameOptional | string | for action=remove |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_google_campaign
Schreiben2 CreditsBenennt eine Google Ads-Kampagne um, pausiert/aktiviert sie oder setzt/entfernt ihr Enddatum; die Vorschau zeigt aktuell → neu. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
nameOptional | string | — |
statusOptional | pause | enable | — |
end_dateOptional | string | null | YYYY-MM-DD oder null für unbegrenzte Laufzeit |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
rename_google_campaigns
Schreiben2 CreditsBenennt Google Ads-Kampagnen in Masse um (explizite Liste, Namensmuster oder Suchen/Ersetzen). Die Vorschau ist eine Tabelle alt → neu; Namen müssen eindeutig bleiben. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
renamesOptional | array<object> | — |
campaign_idsOptional | array<string> | — |
patternOptional | string | Namensmuster mit {name}, {channel}, {id}, z. B. 'Brand | {channel} | {name}' |
findOptional | string | — |
replaceOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
remove_google_campaign
SchreibenUnumkehrbar2 CreditsEntfernt eine Google Ads-Kampagne DAUERHAFT (nicht rückgängig zu machen oder wieder zu aktivieren; der Verlauf bleibt in Berichten). Nie automatisch angewendet: wartet immer auf die ausdrückliche Freigabe des Nutzers. Im Zweifel update_google_campaign(status=pause) bevorzugen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
set_google_bid_strategy
Schreiben2 CreditsStellt die Gebotsstrategie einer Google Ads-Kampagne um: Conversions maximieren (optional Ziel-CPA), Conversion-Wert maximieren (optional Ziel-ROAS), Ziel-CPA, Ziel-ROAS, manueller CPC, Klicks maximieren. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf). Bei App-Kampagnen lässt sich der Strategietyp nicht ändern; nur das Ziel wird aktualisiert (target_cpa = Zielkosten pro Installation / In-App-Aktion oder target_roas). Lesen Sie mit google_campaign_diagnosis die Ursache, bevor Sie ein Ziel ändern, um eine Warnung zu beheben. Der vorherige Wert wird gespeichert und die Änderung ist rückgängig machbar.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
strategyPflicht | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | target_impression_share | — |
target_cpaOptional | number | Kontowährung |
target_roasOptional | number | Verhältnis, 4.0 = 400 % |
max_cpcOptional | number | CPC-Obergrenze für maximize_clicks |
impression_share_locationOptional | ANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE | — |
impression_share_percentOptional | number (1–100) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
set_google_ad_schedule
Schreiben2 CreditsLegt einen Werbezeitplaner für eine Google Ads-Kampagne fest (Tag-/Zeitfenster mit optionaler Gebotsanpassung); außerhalb der Fenster werden keine Anzeigen ausgeliefert. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
replaceOptional | boolean | entfernt zuerst den bestehenden Zeitplan |
schedulePflicht | array<object> | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
set_google_location_targets
Schreiben2 CreditsStandorte in einer Google Ads-Kampagne ausrichten oder ausschließen; Namen werden über Googles Geo-Target-Vorschläge aufgelöst und in der Vorschau gezeigt. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
locationsOptional | array<string> | Namen, z. B. İstanbul, Ankara |
location_idsOptional | array<string> | — |
countryOptional | string | ISO-Code als Hinweis, Standard TR |
excludeOptional | boolean | — |
replaceOptional | boolean | entfernt zuerst die bestehenden Zielstandorte |
bid_adjustmentOptional | number | Prozent |
languagesOptional | array<string> | language codes (tr, en…) or Google language ids to target |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
merge_google_campaigns
SchreibenUnumkehrbar2 CreditsSichere Kampagnenzusammenführung: pausiert die Quellkampagnen und überträgt ihr Tagesbudget auf das Ziel (Google kann Anzeigengruppen nicht zwischen Kampagnen verschieben). Unterliegt der Budgetschranke (max. +50 % je Änderung); nie automatisch angewendet. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
target_campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
source_campaign_idsPflicht | array<string> | — |
move_budgetOptional | boolean | Tagesbudgets der Quellen zum Ziel addieren (Standard true) |
new_daily_budgetOptional | number | explizites Ziel-Tagesbudget statt der Summe |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
exclude_google_ips
Schreiben2 CreditsSchließt IP-Adressen aus einer Google Ads-Kampagne aus (Klickbetrugsschutz; negative IP-Sperre auf Kampagnenebene, max. 500). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
ipsPflicht | array<string> | IPv4-/IPv6-Adressen oder CIDR-Blöcke |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
unblock_ip_addresses
Schreiben2 CreditsEntfernt IP-Ausschlüsse aus einer Google Ads-Kampagne (die Umkehrung von exclude_google_ips); nur tatsächlich in der Kampagne ausgeschlossene IPs werden entfernt. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
ipsPflicht | array<string> | IPv4/IPv6-Adressen oder CIDR-Blöcke, die nicht mehr ausgeschlossen werden sollen |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_google_ad_group
Schreiben2 CreditsFügt einer Google Ads-Kampagne eine Such-Anzeigengruppe hinzu, optional mit Keywords und einer responsiven Suchanzeige. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
namePflicht | string | — |
cpc_bidOptional | number | — |
keywordsOptional | array<any> | — |
headlinesOptional | array<any> | — |
descriptionsOptional | array<any> | — |
final_urlOptional | string | — |
path1Optional | string | — |
path2Optional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
set_google_ad_group_status
Schreiben2 CreditsPausiert oder aktiviert Google Ads-Anzeigengruppen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idsOptional | array<string> | — |
ad_group_idOptional | string | — |
statusPflicht | pause | enable | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
pause_google_ad_groups
Schreiben2 CreditsPausiert mehrere Google Ads-Anzeigengruppen auf einmal (z. B. Gruppen ohne Conversions aus google_ads_report breakdown=ad_group). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idsPflicht | array<string> | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_google_keywords
Schreiben2 CreditsFügt einer Google Ads-Anzeigengruppe Keywords hinzu (Text, BROAD|PHRASE|EXACT, optionales CPC-Gebot). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | — |
keywordsPflicht | array<any> | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_google_keyword
Schreiben2 CreditsPausiert/aktiviert ein Google Ads-Keyword, ändert sein CPC-Gebot oder seinen Übereinstimmungstyp (Google verlangt Entfernen + Neuanlegen; in einer atomaren Anfrage erledigt). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | — |
keyword_idPflicht | string | — |
statusOptional | pause | enable | — |
bidOptional | number | — |
match_typeOptional | BROAD | PHRASE | EXACT | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
remove_google_negative_keywords
SchreibenUnumkehrbar2 CreditsEntfernt auszuschließende Keywords (nach Text, optional Übereinstimmungstyp) aus einer Google Ads-Kampagne oder einer gemeinsamen Ausschlussliste — die Rücknahme eines falschen Ausschlusses. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
shared_list_idOptional | string | — |
keywordsOptional | array<string> | — |
criterion_idsOptional | array<string> | negative criterion ids (list_negative_keywords) instead of / in addition to text |
match_typeOptional | BROAD | PHRASE | EXACT | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_to_google_shared_negative_list
Schreiben2 CreditsFügt auszuschließende Keywords (jeweils mit eigenem Übereinstimmungstyp) zu einer kontoweiten gemeinsamen Ausschlussliste hinzu — oder legt eine an — und ordnet sie Kampagnen zu. Vorhandene Begriffe werden übersprungen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
list_idOptional | string | — |
list_nameOptional | string | legt eine neue Liste an, wenn list_id fehlt |
keywordsPflicht | array<any> | — |
attach_campaign_idsOptional | array<string> | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_google_rsa
Schreiben2 CreditsErstellt eine responsive Suchanzeige (3-15 Anzeigentitel ≤30, 2-4 Beschreibungen ≤90, optionales Anpinnen) in einer Google Ads-Anzeigengruppe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | — |
headlinesPflicht | array<any> | — |
descriptionsPflicht | array<any> | — |
final_urlPflicht | string | — |
path1Optional | string | — |
path2Optional | string | — |
final_mobile_urlOptional | string | — |
tracking_url_templateOptional | string | — |
statusOptional | enable | pause | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_google_rsa_assets
Schreiben2 CreditsErneuert schwache RSA-Anzeigentitel/Beschreibungen: Google erlaubt keine Bearbeitung von RSA-Texten, daher wird in einer Anfrage eine neue Anzeige mit dem neuen Satz erstellt und die alte pausiert. Die Vorschau zeigt alte → neue Texte. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | — |
ad_idPflicht | string | — |
replace_low_performingOptional | boolean | — |
remove_headlinesOptional | array<string> | — |
add_headlinesOptional | array<any> | — |
remove_descriptionsOptional | array<string> | — |
add_descriptionsOptional | array<any> | — |
headlinesOptional | array<any> | — |
descriptionsOptional | array<any> | — |
final_urlOptional | string | — |
path1Optional | string | — |
path2Optional | string | — |
pause_oldOptional | boolean | Standard true |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_google_sitelinks
Schreiben2 CreditsFügt einer Google Ads-Kampagne Sitelink-Assets hinzu (Text ≤25, optional zwei Beschreibungen ≤35, finale URL). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
sitelinksPflicht | array<object> | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_google_callouts
Schreiben2 CreditsFügt einer Google Ads-Kampagne Zusatzinformations-Assets (≤25 Zeichen) hinzu. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
calloutsPflicht | array<string> | jeweils ≤25 Zeichen |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_google_conversion_action
Schreiben2 CreditsErstellt eine Website-Conversion-Aktion; das Ergebnis enthält das zu installierende Tag-Snippet (z. B. mit den Tag Manager-Tools). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
categoryOptional | DEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD | — |
counting_typeOptional | one | many | — |
primary_for_goalOptional | boolean | — |
default_valueOptional | number | — |
currencyOptional | string | — |
always_use_default_valueOptional | boolean | — |
click_through_window_daysOptional | integer (1–90) | — |
view_through_window_daysOptional | integer (1–30) | — |
phone_call_duration_secondsOptional | integer (0–10800) | — |
typeOptional | WEBPAGE | UPLOAD_CLICKS | UPLOAD_CALLS | AD_CALL | WEBSITE_CALL | CLICK_TO_CALL | default WEBPAGE; UPLOAD_CLICKS for offline conversion upload |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_google_conversion_action
Schreiben2 CreditsÄndert eine Google Ads-Conversion-Aktion: primär vs. sekundär (primary_for_goal), Status, Kategorie, Zählung, Werteinstellungen, Klick-Conversion-Fenster. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
conversion_action_idPflicht | string | — |
nameOptional | string | — |
statusOptional | enable | hide | remove | ENABLED | HIDDEN | REMOVED | — |
categoryOptional | DEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD | — |
counting_typeOptional | one | many | — |
primary_for_goalOptional | boolean | — |
default_valueOptional | number | — |
currencyOptional | string | — |
always_use_default_valueOptional | boolean | — |
click_through_window_daysOptional | integer (1–90) | — |
view_through_window_daysOptional | integer (1–30) | — |
phone_call_duration_secondsOptional | integer (0–10800) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_google_asset_group_assets
Schreiben2 CreditsFügt einer Performance Max-Asset-Gruppe in einer atomaren Anfrage Anzeigentitel, lange Anzeigentitel, Beschreibungen und Bilder (von URLs heruntergeladen und hochgeladen) hinzu. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
asset_group_idPflicht | string | — |
headlinesOptional | array<string> | — |
long_headlinesOptional | array<string> | — |
descriptionsOptional | array<string> | — |
business_nameOptional | string | — |
marketing_imagesOptional | array<string> | Bild-URLs (https) oder Studio-Dateien aus /medya |
square_marketing_imagesOptional | array<string> | Bild-URLs (https) oder Studio-Dateien aus /medya |
logo_imagesOptional | array<string> | Bild-URLs (https) oder Studio-Dateien aus /medya |
portrait_marketing_imagesOptional | array<string> | Bild-URLs (https) oder Studio-Dateien aus /medya |
landscape_logo_imagesOptional | array<string> | Bild-URLs (https) oder Studio-Dateien aus /medya |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
upload_google_image_asset
Schreiben2 CreditsLädt Bilder in die Google Ads-Asset-Bibliothek hoch (assets:mutate, imageAsset); das Ergebnis liefert Asset-Ressourcennamen, die in create_google_demand_gen_campaign / create_google_app_campaign wiederverwendbar sind. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
imagesPflicht | array<any> | https-URLs oder Studio-Dateien aus /medya (JPEG/PNG/GIF, ≤5120 KB), bis zu 20 |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_google_demand_gen_campaign
Schreiben2 CreditsErstellt eine Google Demand Gen-Kampagne (YouTube, Discover, Gmail): Budget + Kampagne (advertising_channel_type DEMAND_GEN) + Anzeigengruppe + Multi-Asset-Anzeige (DemandGenMultiAssetAdInfo: Anzeigentitel, Beschreibungen, Unternehmensname, Logo, Quer-/Quadrat-/Hochformatbilder von URLs hochgeladen oder per Asset-ID verknüpft), optionale Zielgruppen-, Standort- und Sprachausrichtung, Gebote Conversions maximieren / tCPA / tROAS. Nach Freigabe als PAUSED erstellt. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
daily_budgetPflicht | number | Kontowährung |
final_urlPflicht | string | — |
business_namePflicht | string | ≤25 Zeichen |
headlinesPflicht | array<string> | 1-5, ≤40 Zeichen |
descriptionsPflicht | array<string> | 1-5, ≤90 Zeichen |
marketing_imagesOptional | array<string> | 1.91:1 Querformat — hochzuladende URLs oder vorhandene Asset-IDs |
square_marketing_imagesOptional | array<string> | 1:1 — URLs oder Asset-IDs |
portrait_marketing_imagesOptional | array<string> | 4:5 — URLs oder Asset-IDs |
logo_imagesPflicht | array<string> | 1:1 Logo, mindestens 1 — URLs oder Asset-IDs |
call_to_actionOptional | string | z. B. Learn more, Shop now (≤15 Zeichen) |
bid_strategyOptional | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | maximize_clicks | — |
target_cpaOptional | number | — |
target_roasOptional | number | — |
max_cpcOptional | number | — |
audience_idsOptional | array<string> | Google Ads-Zielgruppen-IDs (Zielgruppenverwaltung) für die Anzeigengruppe; leer = breit |
locationsOptional | array<string> | — |
location_idsOptional | array<string> | — |
countryOptional | string | — |
languagesOptional | array<string> | — |
ad_group_nameOptional | string | — |
end_dateOptional | string | YYYY-MM-DD |
goalOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_google_app_campaign
Schreiben2 CreditsErstellt eine Google App-Kampagne (advertising_channel_type MULTI_CHANNEL, Untertyp APP_CAMPAIGN, app_campaign_setting mit App-ID, Store und Gebotsziel): Budget + Kampagne + Anzeigengruppe + App-Anzeige (Text-Assets, optional Bilder/Videos), Ziel-CPI/CPA- oder ROAS-Gebote, Standort-/Sprachausrichtung. Nach Freigabe als PAUSED erstellt; die App muss mit dem Konto verknüpft sein. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
daily_budgetPflicht | number | Kontowährung |
app_idPflicht | string | numerische Apple-App-ID (z. B. 284815942) oder Android-Paketname (z. B. com.example.app) |
app_storePflicht | apple | google | — |
goalOptional | installs | installs_no_target | in_app_actions | in_app_actions_cpa | value | pre_registration | installs = Zielkosten pro Installation (Standard); in_app_actions = Installationen mit wahrscheinlicher In-App-Aktion (tCPI); in_app_actions_cpa = Zielkosten pro In-App-Aktion; value = Ziel-ROAS; installs_no_target / pre_registration = maximieren |
target_cpaOptional | number | Zielkosten pro Installation / In-App-Aktion |
target_roasOptional | number | — |
conversion_action_idsOptional | array<string> | In-App-Conversion-Aktionen für in_app-/value-Ziele (list_google_conversion_actions) |
headlinesPflicht | array<string> | 2-5, ≤30 Zeichen |
descriptionsPflicht | array<string> | 1-5, ≤90 Zeichen |
imagesOptional | array<string> | optionale Bild-URLs zum Hochladen oder vorhandene Asset-IDs |
video_asset_idsOptional | array<string> | vorhandene YouTube-Video-Asset-IDs |
locationsOptional | array<string> | — |
location_idsOptional | array<string> | — |
countryOptional | string | — |
languagesOptional | array<string> | — |
ad_group_nameOptional | string | — |
end_dateOptional | string | YYYY-MM-DD |
goal_noteOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_google_app_ad
Schreiben2 CreditsErsetzt Titel und Beschreibungen einer Google-App-Kampagnenanzeige (aktuelle Texte über get_ad_details). Das Ergebnis behält die vorherigen Texte.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_idPflicht | string | — |
headlinesOptional | array<string> | 2-5, up to 30 characters |
descriptionsOptional | array<string> | 1-5, up to 90 characters |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
google_click_fraud_guard
Schreiben2 CreditsKlickbetrugsschutz: findet Kampagnen mit verdächtigen Raten ungültiger Klicks (oder nimmt campaign_ids entgegen) und schließt die angegebenen IP-Adressen in jeder davon aus (negative IP-Sperre auf Kampagnenebene). Ohne ips werden nur die verdächtigen Kampagnen und Geo-Anomalien gemeldet — die Google Ads API gibt Klicker-IPs nie preis, Ausschlüsse brauchen also selbst ermittelte Adressen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
threshold_rateOptional | number | — |
campaign_idsOptional | array<string> | explizite Kampagnen; Standard: vom Bericht zu ungültigen Klicks markierte Kampagnen |
ipsOptional | array<string> | IPv4-/IPv6-Adressen oder CIDR-Blöcke aus Ihren eigenen Server-/Analytics-Logs |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
upsert_merchant_product
Schreiben2 CreditsFügt eine Merchant Center-Produkteingabe hinzu oder aktualisiert sie (products v1beta productInputs:insert — ersetzt eine vorhandene Eingabe mit gleicher Angebots-ID, Sprache, Feed-Label und Datenquelle). Erstellt einen Freigabeeintrag mit Vorschau; an Google erst nach Freigabe und nur mit verbundenem Google-Konto gesendet. Nutzt die verbundene Google-Einwilligung; liefert error=scope_missing, wenn der Merchant Center-Bereich (auth/content) fehlt — der Nutzer muss Google neu autorisieren.
| Parameter | Typ | Beschreibung |
|---|---|---|
offer_idPflicht | string | — |
content_languageOptional | string | Standard tr |
feed_labelOptional | string | Standard TR |
account_idOptional | string | Merchant Center-Konto-ID; optional, wenn der Nutzer ein einziges Konto hat oder eines ausgewählt ist |
data_sourceOptional | string | Datenquellen-ID; Standard: die API-/primäre Produktdatenquelle des Kontos |
titleOptional | string | — |
descriptionOptional | string | — |
linkOptional | string | — |
image_linkOptional | string | — |
priceOptional | number | — |
sale_priceOptional | number | — |
currencyOptional | string | ISO, Standard TRY |
availabilityOptional | in stock | out of stock | preorder | backorder | — |
conditionOptional | new | refurbished | used | — |
brandOptional | string | — |
gtinOptional | string | — |
googleProductCategoryOptional | string | — |
imageLinkOptional | string | Alias of image_link |
channelOptional | ONLINE | LOCAL | default ONLINE |
attributesOptional | object | weitere Merchant API-Produktattribute (camelCase), z. B. color, sizes, itemGroupId, customLabel0 |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_experiment
SchreibenUnumkehrbar2 CreditsBeendet einen Kampagnentest (A/B-Test) oder überträgt seine Teständerungen auf die Basiskampagne. Nicht umkehrbar; wartet immer auf ausdrückliche Freigabe. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
experiment_idPflicht | string | — |
actionPflicht | end | promote | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_demand_gen_ad
Schreiben2 CreditsFügt einer Demand Gen-Anzeigengruppe eine YouTube-Videoanzeige (DemandGenVideoResponsiveAd) hinzu — das Creative, mit dem eine Demand Gen-Videokampagne ausgeliefert werden kann. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
youtube_videoPflicht | string | YouTube-URL oder 11-stellige ID oder eine vorhandene Video-Asset-ID |
headlinesPflicht | array<string> | 1-5, ≤40 |
long_headlinesPflicht | array<string> | 1-5, ≤90 |
descriptionsPflicht | array<string> | 1-5, ≤90 |
business_namePflicht | string | — |
final_urlPflicht | string | — |
logo_asset_idPflicht | string | 1:1-Logo-Asset-ID oder Bild-URL |
call_to_actionOptional | LEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | SHOP_NOW | BUY_NOW | ORDER_NOW | SEE_MORE | START_NOW | VISIT_SITE | WATCH_NOW | — |
ad_nameOptional | string | — |
statusOptional | enable | pause | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
copy_ad_group
Schreiben2 CreditsDupliziert Anzeigengruppen mit ihren Keywords, auszuschließenden Keywords, responsiven Suchanzeigen, Anzeigengruppen-Assets und Zielgruppen in einer atomaren Anfrage in eine andere (oder dieselbe) Kampagne; Kopien starten standardmäßig pausiert. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idsPflicht | array<string> | — |
target_campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
new_nameOptional | string | — |
name_suffixOptional | string | — |
statusOptional | pause | enable | Standard pause |
cpc_bidOptional | number | — |
include_keywordsOptional | boolean | — |
include_negativesOptional | boolean | — |
include_adsOptional | boolean | — |
include_assetsOptional | boolean | — |
include_audiencesOptional | boolean | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
set_ad_group_targeting
Schreiben2 CreditsStandort- und Sprachausrichtung einer Anzeigengruppe (wo Demand Gen sie hält): ausgerichtete / ausgeschlossene Orte und Sprachen hinzufügen oder ersetzen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
locationsOptional | array<string> | — |
location_idsOptional | array<string> | — |
negative_locationsOptional | array<string> | — |
negative_location_idsOptional | array<string> | — |
languagesOptional | array<string> | — |
countryOptional | string | — |
modeOptional | add | replace | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_ad_group
Schreiben2 CreditsBenennt eine Google Ads-Anzeigengruppe um, ändert ihren Standard-max.-CPC und/oder pausiert/aktiviert sie. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
nameOptional | string | — |
cpc_bidOptional | number | — |
statusOptional | pause | enable | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_ad_status
SchreibenUnumkehrbar2 CreditsAktiviert, pausiert oder entfernt eine einzelne Google Ads-Anzeige dauerhaft. REMOVED kann nicht rückgängig gemacht werden und wartet immer auf ausdrückliche Freigabe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
ad_idPflicht | string | — |
statusPflicht | ENABLED | PAUSED | REMOVED | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_pmax_assets
Schreiben2 CreditsFügt Text-Assets einer Performance Max-Asset-Gruppe in einer Anfrage hinzu und entfernt sie (Bilder: add_google_asset_group_assets). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
asset_group_idPflicht | string | — |
headlinesOptional | array<string> | — |
long_headlinesOptional | array<string> | — |
descriptionsOptional | array<string> | — |
remove_resource_namesOptional | array<string> | Asset-Gruppen-Asset-Verknüpfungen aus list_google_asset_groups |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_rsa
Schreiben2 CreditsBearbeitet eine responsive Suchanzeige direkt (gleiche Anzeigen-ID, Verlauf bleibt): den ganzen Satz ersetzen oder einzelne Anzeigentitel/Beschreibungen hinzufügen/entfernen, Fixierungen, finale URL und Pfade ändern. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_idPflicht | string | — |
headlinesOptional | array<any> | — |
descriptionsOptional | array<any> | — |
add_headlinesOptional | array<any> | — |
remove_headlinesOptional | array<string> | — |
add_descriptionsOptional | array<any> | — |
remove_descriptionsOptional | array<string> | — |
headline_pinsOptional | object | {Text: Fixierungsfeld} — leere Zeichenfolge hebt die Fixierung auf |
description_pinsOptional | object | {Text: Fixierungsfeld} — leere Zeichenfolge hebt die Fixierung auf |
final_urlOptional | string | — |
path1Optional | string | — |
path2Optional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_negative_keyword
Schreiben2 CreditsFügt auf Kampagnen- oder Anzeigengruppenebene ein oder mehrere auszuschließende Keywords hinzu (jeweils mit eigener Übereinstimmungsart); vorhandene werden übersprungen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
ad_group_idOptional | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
textOptional | string | — |
keywordsOptional | array<any> | — |
match_typeOptional | BROAD | PHRASE | EXACT | — |
skip_existingOptional | boolean | Standard true |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_keywords
SchreibenUnumkehrbar2 CreditsPausiert / aktiviert / entfernt bestehende Keywords dauerhaft in großer Zahl oder legt ihren max. CPC bzw. finale URLs auf Keyword-Ebene fest. remove wartet auf ausdrückliche Freigabe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_group_idPflicht | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
criterion_idsPflicht | array<string> | — |
actionPflicht | pause | enable | remove | set_bid | set_url | — |
cpc_bidOptional | number | — |
final_urlOptional | string | — |
final_mobile_urlOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_shared_negative_list
SchreibenUnumkehrbar2 CreditsVerwaltet geteilte Listen auszuschließender Keywords auf Kontoebene: erstellen, Keywords hinzufügen/entfernen, Kampagnen zuordnen oder lösen, umbenennen, löschen (Löschen wartet auf ausdrückliche Freigabe). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
actionPflicht | create | add_keywords | remove_keywords | attach | detach | rename | delete | — |
shared_set_idOptional | string | — |
nameOptional | string | — |
keywordsOptional | array<any> | — |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
campaign_idsOptional | array<string> | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
dismiss_recommendations
Schreiben2 CreditsVerwirft Google Ads-Empfehlungen, die Sie nicht möchten. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
resource_namesPflicht | array<string> | aus list_google_ads_recommendations |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_extension_assets
Schreiben2 CreditsFügt einer Kampagne (oder einer Anzeigengruppe) in einer atomaren Anfrage Erweiterungs-Assets hinzu: Sitelinks, Zusatzinformationen, Snippet mit Zusatzinformationen, Anruf, WhatsApp-Nachricht, Angebote und eine Preisliste. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
ad_group_idOptional | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
sitelinksOptional | array<object> | — |
calloutsOptional | array<string> | — |
snippet_headerOptional | string | z. B. Services, Brands, Types, Destinations |
snippet_valuesOptional | array<string> | — |
phone_numberOptional | string | — |
phone_countryOptional | string | — |
whatsapp_numberOptional | string | — |
whatsapp_countryOptional | string | — |
whatsapp_greetingOptional | string | — |
whatsapp_ctaOptional | APPLY_NOW | BOOK_NOW | CONTACT_US | GET_INFO | GET_OFFER | GET_QUOTE | GET_STARTED | LEARN_MORE | — |
whatsapp_cta_textOptional | string | — |
promotionsOptional | array<object> | — |
pricesOptional | object | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
remove_extension_assets
SchreibenUnumkehrbar2 CreditsLöst Erweiterungs-Assets von einer Kampagne oder Anzeigengruppe (die Assets bleiben in der Bibliothek und können erneut verknüpft werden). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
resource_namesOptional | array<string> | Verknüpfungs-Ressourcennamen aus list_extension_assets |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
field_typeOptional | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGE | mit campaign_id: entfernt jede Verknüpfung dieses Typs |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_sitelink
Schreiben2 CreditsBearbeitet einen bestehenden Sitelink direkt (Linktext, die zwei Beschreibungszeilen, finale URL), ohne ihn neu zu erstellen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
asset_idPflicht | string | — |
link_textOptional | string | — |
description1Optional | string | — |
description2Optional | string | — |
final_urlOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_portfolio_bidding_strategy
Schreiben2 CreditsPortfolio-(geteilte) Gebotsstrategien: auflisten, eine erstellen, ihre Ziele ändern oder eine Kampagne daran anhängen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
actionOptional | list | create | update | assign | — |
nameOptional | string | — |
strategyOptional | target_cpa | target_roas | maximize_clicks | maximize_conversions | maximize_conversion_value | target_impression_share | — |
target_cpaOptional | number | — |
target_roasOptional | number | — |
max_cpcOptional | number | — |
min_cpcOptional | number | — |
impression_share_locationOptional | ANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE | — |
impression_share_percentOptional | number (1–100) | — |
bidding_strategy_idOptional | string | — |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_google_bidding_periods
Schreiben2 CreditsTeilt Smart Bidding einen kurzen Zeitraum im Voraus mit: eine Saisonalitätsanpassung für eine Aktion oder einen Launch (erwarteter Conversion-Rate-Faktor) oder einen Datenausschluss für Tage mit defekter Messung (Website offline, Tag fehlte) – diese Tage fließen nicht in das Gebotslernen ein. Vorhandene mit google_ads_query lesen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
actionOptional | create | remove | — |
typePflicht | seasonality | data_exclusion | — |
nameOptional | string | — |
scopeOptional | CAMPAIGN | CHANNEL | — |
campaign_idsOptional | array<string> | — |
channel_typesOptional | array<string> | — |
devicesOptional | array<string> | — |
start_date_timeOptional | string | JJJJ-MM-TT oder JJJJ-MM-TT HH:MM:SS, in der Zeitzone des Kontos |
end_date_timeOptional | string | JJJJ-MM-TT oder JJJJ-MM-TT HH:MM:SS, in der Zeitzone des Kontos |
conversion_rate_modifierOptional | number (0.1–10) | nur Saisonalitätsanpassung: 1,2 = 20 % mehr Conversions erwartet |
resource_nameOptional | string | for action=remove |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_recommendation_auto_apply
Schreiben2 CreditsZeigt und schaltet die automatische Anwendung von Google-Empfehlungen je Typ. Das Einschalten wartet immer auf ausdrückliche Freigabe, weil Google das Konto danach selbstständig ändert. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
actionOptional | list | enable | disable | — |
typesOptional | array<string> | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_conversion_goal
Schreiben2 CreditsMacht ein Conversion-Ziel (Kategorie × Quelle) für das Konto oder eine Kampagne primär oder sekundär — also das, worauf Smart Bidding optimiert. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
categoryPflicht | DEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD | — |
originOptional | WEBSITE | GOOGLE_HOSTED | APP | CALL_FROM_ADS | STORE | YOUTUBE_HOSTED | LOCAL_SERVICES_ADS | — |
rolePflicht | primary | secondary | — |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_custom_conversion_goal
SchreibenUnumkehrbar2 CreditsErstellt, bearbeitet (enthaltene Aktionen, Name) oder löscht ein benutzerdefiniertes Conversion-Ziel; Löschen wartet auf ausdrückliche Freigabe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
goal_idOptional | string | weglassen, um ein neues Ziel zu erstellen |
conversion_actionsOptional | array<string> | — |
nameOptional | string | — |
removeOptional | boolean | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
upload_offline_conversions
Schreiben2 CreditsLädt Offline-(CRM-)Conversions per Klick-ID (gclid/gbraid/wbraid) oder gehashter E-Mail/Telefonnummer hoch (erweiterte Conversions für Leads); E-Mails/Telefonnummern werden vor jeder Speicherung per SHA-256 gehasht. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
conversion_actionPflicht | string | ID einer Conversion-Aktion vom Typ UPLOAD_CLICKS |
currency_codeOptional | string | — |
conversionsPflicht | array<object> | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
upload_conversion_adjustments
Schreiben2 CreditsZieht bereits gemeldete Conversions zurück (Erstattung/Stornierung) oder korrigiert ihren Wert, nach Bestell-ID oder gclid + Zeit. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
conversion_actionPflicht | string | — |
currency_codeOptional | string | — |
adjustmentsPflicht | array<object> | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_customer_match_audience
Schreiben2 CreditsErstellt eine leere Kundenabgleich-Liste (Customer Match, First-Party-Daten). Mitglieder werden über Googles eigene Upload-Wege hinzugefügt; dieses Tool lädt niemals personenbezogene Daten hoch. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
membership_daysOptional | integer (1–540) | — |
upload_key_typeOptional | CONTACT_INFO | CRM_ID | MOBILE_ADVERTISING_ID | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
link_google_business_profile
Schreiben2 CreditsLink Google Business Profile locations to the Google Ads account as location assets (address, directions, call in ads; store visit conversions). Uses the connected Business Profile; filter by business name, label or listing id when the profile has several businesses. Only one sync per account; an existing one is reused. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.
Die Beschreibung dieses Tools ist noch nicht übersetzt; gezeigt wird der englische Originaltext, den der Assistent sieht.
| Parameter | Typ | Beschreibung |
|---|---|---|
business_name_filterOptional | string | only listings with this business name |
label_filtersOptional | array<string> | only listings with one of these Business Profile labels |
listing_idsOptional | array<string> | only these Business Profile listing ids |
business_account_idOptional | string | — |
emailOptional | string | Business Profile account e-mail; default: the connected Google account |
nameOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
set_google_campaign_locations
Schreiben2 CreditsShow only some Business Profile locations in one campaign's ads (dynamic location group by label or listing id), so another business's address does not appear when the account syncs several businesses. Needs the account-level sync (link_google_business_profile). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.
Die Beschreibung dieses Tools ist noch nicht übersetzt; gezeigt wird der englische Originaltext, den der Assistent sieht.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
label_filtersOptional | array<string> | Business Profile labels (OR) |
listing_idsOptional | array<string> | Business Profile listing ids (OR) |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
remove_google_audience
SchreibenUnumkehrbar2 CreditsPermanently remove a Google Ads audience list (Customer Match, website, lookalike). A list still used by a campaign is rejected by Google; use only when the user explicitly asked for it. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.
Die Beschreibung dieses Tools ist noch nicht übersetzt; gezeigt wird der englische Originaltext, den der Assistent sieht.
| Parameter | Typ | Beschreibung |
|---|---|---|
user_list_idPflicht | string | audience (user list) id from list_audiences |
nameOptional | string | list name, shown in the approval |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_lookalike_audience
Schreiben2 CreditsErstellt aus Ausgangslisten eine Lookalike-Zielgruppe (Demand Gen) für die angegebenen Länder und Reichweitenstufe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
seed_user_list_idsPflicht | array<string> | — |
country_codesPflicht | array<string> | — |
expansion_levelOptional | NARROW | BALANCED | BROAD | — |
membership_daysOptional | integer (1–540) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_website_audience
Schreiben2 CreditsErstellt eine regelbasierte Remarketing-Liste aus Website-Besuchern, deren Seiten-URL übereinstimmt (erfordert das Google-Tag auf der Website); frühere Besucher werden vorab übernommen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
url_containsPflicht | any | — |
string_operatorOptional | CONTAINS | EQUALS | STARTS_WITH | ENDS_WITH | — |
membership_daysOptional | integer (1–540) | — |
lookback_daysOptional | integer (1–540) | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_audience_targeting
Schreiben2 CreditsVerknüpft eine Zielgruppenliste mit einer Kampagne oder Anzeigengruppe (oder entfernt sie) und legt optional Beobachtung vs. Ausrichtung sowie einen Gebotsfaktor fest. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
audiencePflicht | string | Nutzerlisten-ID (list_audiences) |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
ad_group_idOptional | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
actionOptional | add | remove | — |
modeOptional | observation | targeting | — |
bid_modifierOptional | number | Faktor, 1.2 = +20 % |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_campaign_settings
Schreiben2 CreditsLiest Kampagneneinstellungen (ohne weiteres Argument) oder ändert sie: Standortoption Anwesenheit vs. Interesse, Suchnetzwerk-Partner, Display-Erweiterung, Tracking-Vorlage, EU-Erklärung zu politischer Werbung, AI Max for Search. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
geo_target_typeOptional | PRESENCE | PRESENCE_OR_INTEREST | — |
search_partnersOptional | boolean | — |
display_expansionOptional | boolean | — |
tracking_url_templateOptional | string | — |
eu_political_adsOptional | boolean | — |
ai_maxOptional | boolean | AI Max for Search |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_google_ads_account
SchreibenUnumkehrbar2 CreditsEröffnet ein neues Kundenkonto unter einem Verwaltungskonto (MCC), das der verbundene Nutzer verwaltet. Wartet immer auf ausdrückliche Freigabe; Währung und Zeitzone sind dauerhaft. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
manager_customer_idPflicht | string | — |
namePflicht | string | — |
currency_codePflicht | string | — |
time_zonePflicht | string | — |
tracking_url_templateOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_lead_form
Schreiben2 CreditsErstellt ein Lead-Formular-Asset (das Formular in der Anzeige) mit Standardfeldern, eigenen Fragen, Dankesbildschirm und optionaler Webhook-Zustellung und ordnet es einer Kampagne oder Anzeigengruppe zu. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
business_namePflicht | string | — |
headlinePflicht | string | — |
descriptionPflicht | string | — |
privacy_policy_urlPflicht | string | — |
final_urlPflicht | string | — |
ctaOptional | LEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | GET_OFFER | REGISTER | GET_INFO | REQUEST_DEMO | JOIN_NOW | GET_STARTED | — |
cta_descriptionOptional | string | — |
fieldsOptional | array<FULL_NAME | FIRST_NAME | LAST_NAME | EMAIL | PHONE_NUMBER | POSTAL_CODE | STREET_ADDRESS | CITY | REGION | COUNTRY | WORK_EMAIL | COMPANY_NAME | WORK_PHONE | JOB_TITLE> | — |
questionsOptional | array<any> | — |
post_submit_headlineOptional | string | — |
post_submit_descriptionOptional | string | — |
post_submit_ctaOptional | VISIT_SITE | DOWNLOAD | LEARN_MORE | SHOP_NOW | — |
webhook_urlOptional | string | — |
webhook_keyOptional | string | — |
campaign_idOptional | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
ad_group_idOptional | string | Google Ads-Anzeigengruppen-ID (list_google_ad_groups) |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_business_logo
Schreiben2 CreditsErsetzt das Unternehmenslogo, das in den Anzeigen einer Kampagne angezeigt wird. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
asset_idPflicht | string | 1:1-Bild-Asset-ID oder Bild-URL |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_business_name
Schreiben2 CreditsLegt den Unternehmensnamen fest, der in den Anzeigen einer Kampagne angezeigt wird, oder korrigiert ihn. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
textPflicht | string | ≤25 Zeichen |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_campaign_proximity
Schreiben2 CreditsListet, ergänzt oder entfernt Umkreis-Ausrichtungen (Breiten-/Längengrad-Kreis) einer Kampagne. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
actionOptional | list | add | remove | — |
latOptional | number | — |
lngOptional | number | — |
radiusOptional | number | — |
unitsOptional | KILOMETERS | MILES | — |
pointsOptional | array<object> | — |
criterion_idOptional | string | — |
criterion_idsOptional | array<string> | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_device_targeting
Schreiben2 CreditsLegt die Gebotsanpassung einer Kampagne für ein Gerät fest (oder -100 %, um dort nicht mehr auszuliefern). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Tecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID |
devicePflicht | MOBILE | DESKTOP | TABLET | CONNECTED_TV | — |
bid_modifier_pctPflicht | number | -90..900 oder -100 zum Ausschließen |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
set_call_reporting
Schreiben2 CreditsSchaltet Anrufberichte und Berichte zu Anruf-Conversions auf Kontoebene ein/aus und wählt die Anruf-Conversion-Aktion. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
call_reportingOptional | boolean | — |
call_conversionOptional | boolean | — |
call_conversion_action_idOptional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_pmax_asset_group
SchreibenUnumkehrbar2 CreditsÄndert finale URL, Name, Anzeigepfade oder Status einer Performance Max-Asset-Gruppe; REMOVED ist dauerhaft und wartet auf ausdrückliche Freigabe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).
| Parameter | Typ | Beschreibung |
|---|---|---|
asset_group_idPflicht | string | — |
final_urlOptional | string | — |
nameOptional | string | — |
statusOptional | ENABLED | PAUSED | REMOVED | — |
path1Optional | string | — |
path2Optional | string | — |
customer_idOptional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.