Tecrübetecrube.com
Tool-Referenz — Anzeigen

Google Ads tools

Search and Performance Max campaigns, keywords, ad copy, conversions, bid strategies and recommendations.

Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind der englische Originaltext, den der Assistent sieht.

Lese-Tools13 Tools

list_google_ads_accounts

Lesen1 Credits

Google Ads accounts the connected Google user can access, including client accounts under MCC/manager accounts (id, name, currency, time zone, manager, login_customer_id) and which one is selected. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Dieses Tool hat keine Parameter.

google_device_report

Lesen2 Credits

Google Ads performance split by device (mobile, desktop, tablet, connected TV) with CPA and ROAS per device. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypBeschreibung
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
compare_previousOptionalboolean—

list_google_ads_recommendations

Lesen1 Credits

Google's own optimization recommendations (type, campaign, estimated impact). Apply chosen ones with apply_google_ads_recommendation. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypBeschreibung
typesOptionalarray<string>recommendation types, e.g. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

google_keyword_planner

Lesen2 Credits

Google Ads Keyword Planner ideas: real average monthly searches, competition and top-of-page bid range for seed keywords or a URL. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypBeschreibung
seed_keywordsOptionalarray<string>—
urlOptionalstring—
locationOptionalstringcity/region names, comma separated
countryOptionalstringISO code, default TR
languageOptionalstringtr, en, de, fr, es, ar, ru
limitOptionalinteger (10–500)—

list_google_ip_exclusions

Lesen1 Credits

IP exclusions on Google Ads campaigns. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

list_google_ad_groups

Lesen1 Credits

Ad groups (id, name, status, default CPC) of the Google Ads account or one campaign. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

list_google_shared_negative_lists

Lesen1 Credits

Shared negative keyword lists in the Google Ads account with keyword counts and attached campaigns. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypBeschreibung
list_idOptionalstringalso return this list's keywords

list_google_ads

Lesen1 Credits

Responsive search ads with every headline/description and Google's performance label (LOW/GOOD/BEST), ad strength and final URL. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idOptionalstring—

list_google_conversion_actions

Lesen1 Credits

Conversion actions of the Google Ads account: type, category, status, primary/secondary, counting, value settings, click-through window. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Dieses Tool hat keine Parameter.

list_google_asset_groups

Lesen1 Credits

Performance Max asset groups with ad strength, final URLs and their text/image assets per field type. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

Schreib-Tools26 Tools

select_google_ads_account

Schreiben1 Credits

Switch the Google Ads client account all further reads and writes use (agency/MCC: the right login-customer-id is set automatically). Local setting; nothing changes on Google.

ParameterTypBeschreibung
customer_idPflichtstringclient customer id from 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 Credits

Apply selected Google Ads recommendations (up to 100). Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
recommendationsPflichtarray<string>resource names from list_google_ads_recommendations

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

create_google_search_campaign

Schreiben2 Credits

Create a Google Search campaign in one flow: budget, campaign, location + language targeting, bidding strategy, ad group, keywords and responsive search ad (copy defaults to the brand profile). Created PAUSED after approval. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
namePflichtstring—
daily_budgetPflichtnumberaccount currency
locationsOptionalarray<string>city/region/country names; default: brand profile city
location_idsOptionalarray<string>Google geo target constant ids
countryOptionalstring—
languagesOptionalarray<string>language codes (tr, en…) or Google language ids; default Turkish
bid_strategyOptionalmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks—
target_cpaOptionalnumber—
target_roasOptionalnumber—
max_cpcOptionalnumber—
cpc_bidOptionalnumberad group default CPC
keywordsOptionalarray<any>—
headlinesOptionalarray<any>—
descriptionsOptionalarray<any>—
final_urlOptionalstring—
ad_group_nameOptionalstring—
search_partnersOptionalboolean—
end_dateOptionalstringYYYY-MM-DD
goalOptionalstring—

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

create_google_pmax_campaign

Schreiben2 Credits

Create a Performance Max campaign: budget + campaign + asset group + text assets + images (downloaded from the given URLs and uploaded) in one atomic request, created PAUSED. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
namePflichtstring—
daily_budgetPflichtnumber—
final_urlPflichtstring—
business_namePflichtstring≤25 chars
headlinesPflichtarray<string>3-15, ≤30 chars
long_headlinesPflichtarray<string>1-5, ≤90 chars
descriptionsPflichtarray<string>2-5, ≤90 chars
marketing_imagesPflichtarray<string>1.91:1 landscape, at least 1
square_marketing_imagesPflichtarray<string>1:1, at least 1
logo_imagesPflichtarray<string>1:1 logo, at least 1
portrait_marketing_imagesOptionalarray<string>image URLs (https) or Studio /medya files
landscape_logo_imagesOptionalarray<string>image URLs (https) or Studio /medya files
bid_strategyOptionalmaximize_conversions | maximize_conversion_value—
target_cpaOptionalnumber—
target_roasOptionalnumber—
locationsOptionalarray<string>—
countryOptionalstring—
languagesOptionalarray<string>—
asset_group_nameOptionalstring—
end_dateOptionalstring—
goalOptionalstring—

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

update_google_campaign

Schreiben2 Credits

Rename, pause/enable or set/clear the end date of a Google Ads campaign; the preview shows current → new. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
nameOptionalstring—
statusOptionalpause | enable—
end_dateOptionalstring | nullYYYY-MM-DD, or null to run indefinitely

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

rename_google_campaigns

Schreiben2 Credits

Bulk-rename Google Ads campaigns (explicit list, a naming pattern, or find/replace). The preview is an old → new table; names must stay unique. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
renamesOptionalarray<object>—
campaign_idsOptionalarray<string>—
patternOptionalstringnaming pattern with {name}, {channel}, {id}, e.g. 'Brand | {channel} | {name}'
findOptionalstring—
replaceOptionalstring—

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

remove_google_campaign

SchreibenUnumkehrbar2 Credits

PERMANENTLY remove a Google Ads campaign (cannot be undone or re-enabled; history stays in reports). Never auto-applied: always waits for the user's explicit approval. Prefer update_google_campaign(status=pause) when unsure. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

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

set_google_bid_strategy

Schreiben2 Credits

Switch a Google Ads campaign's bidding: maximize conversions (optional target CPA), maximize conversion value (optional target ROAS), target CPA, target ROAS, manual CPC, maximize clicks. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
strategyPflichtmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks—
target_cpaOptionalnumberaccount currency
target_roasOptionalnumberratio, 4.0 = 400%
max_cpcOptionalnumberCPC ceiling for maximize_clicks

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

set_google_ad_schedule

Schreiben2 Credits

Set a Google Ads campaign ad schedule (day/time slots with optional bid adjustment); ads don't serve outside the slots. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
replaceOptionalbooleanremove the existing schedule first
schedulePflichtarray<object>—

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

set_google_location_targets

Schreiben2 Credits

Target or exclude locations on a Google Ads campaign; names are resolved with Google's geo target suggestions and shown in the preview. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
locationsOptionalarray<string>names, e.g. İstanbul, Ankara
location_idsOptionalarray<string>—
countryOptionalstringISO code hint, default TR
excludeOptionalboolean—
replaceOptionalbooleanremove existing targeted locations first
bid_adjustmentOptionalnumberpercent

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

merge_google_campaigns

Schreiben2 Credits

Safe campaign merge: pause the source campaigns and move their daily budget to the target (Google can't move ad groups between campaigns). Subject to the budget guardrail (max +50% per change); never auto-applied. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
target_campaign_idPflichtstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
source_campaign_idsPflichtarray<string>—
move_budgetOptionalbooleanadd the sources' daily budgets to the target (default true)
new_daily_budgetOptionalnumberexplicit target daily budget instead of the sum

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

exclude_google_ips

Schreiben2 Credits

Exclude IP addresses (click-fraud protection) from a Google Ads campaign (campaign-level negative IP block, max 500). Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ipsPflichtarray<string>IPv4/IPv6 addresses or CIDR blocks

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

create_google_ad_group

Schreiben2 Credits

Add a search ad group to a Google Ads campaign, optionally with keywords and a responsive search ad. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
namePflichtstring—
cpc_bidOptionalnumber—
keywordsOptionalarray<any>—
headlinesOptionalarray<any>—
descriptionsOptionalarray<any>—
final_urlOptionalstring—
path1Optionalstring—
path2Optionalstring—

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

set_google_ad_group_status

Schreiben2 Credits

Pause or enable Google Ads ad groups. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
ad_group_idsOptionalarray<string>—
ad_group_idOptionalstring—
statusPflichtpause | enable—

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

pause_google_ad_groups

Schreiben2 Credits

Pause several Google Ads ad groups at once (e.g. zero-conversion groups from google_ads_report breakdown=ad_group). Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
ad_group_idsPflichtarray<string>—

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

add_google_keywords

Schreiben2 Credits

Add keywords (text, BROAD|PHRASE|EXACT, optional CPC bid) to a Google Ads ad group. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
ad_group_idPflichtstring—
keywordsPflichtarray<any>—

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

update_google_keyword

Schreiben2 Credits

Pause/enable a Google Ads keyword, change its CPC bid, or change its match type (Google requires remove + re-add; done in one atomic request). Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
ad_group_idPflichtstring—
keyword_idPflichtstring—
statusOptionalpause | enable—
bidOptionalnumber—
match_typeOptionalBROAD | PHRASE | EXACT—

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

remove_google_negative_keywords

Schreiben2 Credits

Remove negative keywords (matched by text, optionally match type) from a Google Ads campaign or a shared negative list — the undo for a wrong negative. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
shared_list_idOptionalstring—
keywordsPflichtarray<string>—
match_typeOptionalBROAD | PHRASE | EXACT—

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

add_to_google_shared_negative_list

Schreiben2 Credits

Add negatives (each with its own match type) to an account-wide shared negative list — or create one — and attach it to campaigns. Existing terms are skipped. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
list_idOptionalstring—
list_nameOptionalstringcreates a new list when list_id is not given
keywordsPflichtarray<any>—
attach_campaign_idsOptionalarray<string>—

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

create_google_rsa

Schreiben2 Credits

Create a responsive search ad (3-15 headlines ≤30, 2-4 descriptions ≤90, optional pinning) in a Google Ads ad group. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
ad_group_idPflichtstring—
headlinesPflichtarray<any>—
descriptionsPflichtarray<any>—
final_urlPflichtstring—
path1Optionalstring—
path2Optionalstring—

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

update_google_rsa_assets

Schreiben2 Credits

Refresh weak RSA headlines/descriptions: Google doesn't allow editing RSA text, so a new ad is created with the new set and the old one paused, in one request. Preview shows old → new copy. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
ad_group_idPflichtstring—
ad_idPflichtstring—
replace_low_performingOptionalboolean—
remove_headlinesOptionalarray<string>—
add_headlinesOptionalarray<any>—
remove_descriptionsOptionalarray<string>—
add_descriptionsOptionalarray<any>—
headlinesOptionalarray<any>—
descriptionsOptionalarray<any>—
final_urlOptionalstring—
path1Optionalstring—
path2Optionalstring—
pause_oldOptionalbooleandefault true

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

add_google_callouts

Schreiben2 Credits

Add callout assets (≤25 chars) to a Google Ads campaign. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
calloutsPflichtarray<string>≤25 chars each

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

create_google_conversion_action

Schreiben2 Credits

Create a website conversion action; the result carries the tag snippet to install (e.g. with the Tag Manager tools). Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
namePflichtstring—
categoryOptionalDEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | IMPORTED_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD—
counting_typeOptionalone | many—
primary_for_goalOptionalboolean—
default_valueOptionalnumber—
currencyOptionalstring—
always_use_default_valueOptionalboolean—
click_through_window_daysOptionalinteger (1–90)—

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

update_google_conversion_action

Schreiben2 Credits

Change a Google Ads conversion action: primary vs secondary (primary_for_goal), status, category, counting, value settings, click-through window. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
conversion_action_idPflichtstring—
nameOptionalstring—
statusOptionalenable | hide | remove—
categoryOptionalDEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | IMPORTED_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD—
counting_typeOptionalone | many—
primary_for_goalOptionalboolean—
default_valueOptionalnumber—
currencyOptionalstring—
always_use_default_valueOptionalboolean—
click_through_window_daysOptionalinteger (1–90)—

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

add_google_asset_group_assets

Schreiben2 Credits

Add headlines, long headlines, descriptions and images (downloaded from URLs and uploaded) to a Performance Max asset group in one atomic request. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

ParameterTypBeschreibung
asset_group_idPflichtstring—
headlinesOptionalarray<string>—
long_headlinesOptionalarray<string>—
descriptionsOptionalarray<string>—
business_nameOptionalstring—
marketing_imagesOptionalarray<string>image URLs (https) or Studio /medya files
square_marketing_imagesOptionalarray<string>image URLs (https) or Studio /medya files
logo_imagesOptionalarray<string>image URLs (https) or Studio /medya files
portrait_marketing_imagesOptionalarray<string>image URLs (https) or Studio /medya files
landscape_logo_imagesOptionalarray<string>image URLs (https) or Studio /medya files

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