Tecrübetecrube.com
Referencia de herramientas — Anuncios

Google Ads tools

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

Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son el texto original en inglés que ve el asistente.

Herramientas de lectura13 herramientas

list_google_ads_accounts

Lectura1 créditos

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.

Esta herramienta no recibe parámetros.

google_device_report

Lectura2 créditos

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.

ParámetroTipoDescripción
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
campaign_idOpcionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
compare_previousOpcionalboolean—

list_google_ads_recommendations

Lectura1 créditos

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.

ParámetroTipoDescripción
typesOpcionalarray<string>recommendation types, e.g. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET
campaign_idOpcionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

google_keyword_planner

Lectura2 créditos

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.

ParámetroTipoDescripción
seed_keywordsOpcionalarray<string>—
urlOpcionalstring—
locationOpcionalstringcity/region names, comma separated
countryOpcionalstringISO code, default TR
languageOpcionalstringtr, en, de, fr, es, ar, ru
limitOpcionalinteger (10–500)—

list_google_ip_exclusions

Lectura1 créditos

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

ParámetroTipoDescripción
campaign_idOpcionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

list_google_ad_groups

Lectura1 créditos

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.

ParámetroTipoDescripción
campaign_idOpcionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

list_google_shared_negative_lists

Lectura1 créditos

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.

ParámetroTipoDescripción
list_idOpcionalstringalso return this list's keywords

list_google_ads

Lectura1 créditos

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.

ParámetroTipoDescripción
campaign_idOpcionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idOpcionalstring—

list_google_conversion_actions

Lectura1 créditos

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.

Esta herramienta no recibe parámetros.

list_google_asset_groups

Lectura1 créditos

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.

ParámetroTipoDescripción
campaign_idOpcionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

Herramientas de escritura26 herramientas

select_google_ads_account

Escritura1 créditos

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.

ParámetroTipoDescripción
customer_idObligatoriostringclient customer id from list_google_ads_accounts

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

apply_google_ads_recommendation

Escritura2 créditos

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

ParámetroTipoDescripción
recommendationsObligatorioarray<string>resource names from list_google_ads_recommendations

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_google_search_campaign

Escritura2 créditos

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

ParámetroTipoDescripción
nameObligatoriostring—
daily_budgetObligatorionumberaccount currency
locationsOpcionalarray<string>city/region/country names; default: brand profile city
location_idsOpcionalarray<string>Google geo target constant ids
countryOpcionalstring—
languagesOpcionalarray<string>language codes (tr, en…) or Google language ids; default Turkish
bid_strategyOpcionalmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks—
target_cpaOpcionalnumber—
target_roasOpcionalnumber—
max_cpcOpcionalnumber—
cpc_bidOpcionalnumberad group default CPC
keywordsOpcionalarray<any>—
headlinesOpcionalarray<any>—
descriptionsOpcionalarray<any>—
final_urlOpcionalstring—
ad_group_nameOpcionalstring—
search_partnersOpcionalboolean—
end_dateOpcionalstringYYYY-MM-DD
goalOpcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_google_pmax_campaign

Escritura2 créditos

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

ParámetroTipoDescripción
nameObligatoriostring—
daily_budgetObligatorionumber—
final_urlObligatoriostring—
business_nameObligatoriostring≤25 chars
headlinesObligatorioarray<string>3-15, ≤30 chars
long_headlinesObligatorioarray<string>1-5, ≤90 chars
descriptionsObligatorioarray<string>2-5, ≤90 chars
marketing_imagesObligatorioarray<string>1.91:1 landscape, at least 1
square_marketing_imagesObligatorioarray<string>1:1, at least 1
logo_imagesObligatorioarray<string>1:1 logo, at least 1
portrait_marketing_imagesOpcionalarray<string>image URLs (https) or Studio /medya files
landscape_logo_imagesOpcionalarray<string>image URLs (https) or Studio /medya files
bid_strategyOpcionalmaximize_conversions | maximize_conversion_value—
target_cpaOpcionalnumber—
target_roasOpcionalnumber—
locationsOpcionalarray<string>—
countryOpcionalstring—
languagesOpcionalarray<string>—
asset_group_nameOpcionalstring—
end_dateOpcionalstring—
goalOpcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_google_campaign

Escritura2 créditos

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

ParámetroTipoDescripción
campaign_idObligatoriostringTecrübe campaign id (list_campaigns) or Google Ads campaign id
nameOpcionalstring—
statusOpcionalpause | enable—
end_dateOpcionalstring | nullYYYY-MM-DD, or null to run indefinitely

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

rename_google_campaigns

Escritura2 créditos

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

ParámetroTipoDescripción
renamesOpcionalarray<object>—
campaign_idsOpcionalarray<string>—
patternOpcionalstringnaming pattern with {name}, {channel}, {id}, e.g. 'Brand | {channel} | {name}'
findOpcionalstring—
replaceOpcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

remove_google_campaign

EscrituraIrreversible2 créditos

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

ParámetroTipoDescripción
campaign_idObligatoriostringTecrübe campaign id (list_campaigns) or Google Ads campaign id

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

set_google_bid_strategy

Escritura2 créditos

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

ParámetroTipoDescripción
campaign_idObligatoriostringTecrübe campaign id (list_campaigns) or Google Ads campaign id
strategyObligatoriomaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks—
target_cpaOpcionalnumberaccount currency
target_roasOpcionalnumberratio, 4.0 = 400%
max_cpcOpcionalnumberCPC ceiling for maximize_clicks

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

set_google_ad_schedule

Escritura2 créditos

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

ParámetroTipoDescripción
campaign_idObligatoriostringTecrübe campaign id (list_campaigns) or Google Ads campaign id
replaceOpcionalbooleanremove the existing schedule first
scheduleObligatorioarray<object>—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

set_google_location_targets

Escritura2 créditos

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

ParámetroTipoDescripción
campaign_idObligatoriostringTecrübe campaign id (list_campaigns) or Google Ads campaign id
locationsOpcionalarray<string>names, e.g. İstanbul, Ankara
location_idsOpcionalarray<string>—
countryOpcionalstringISO code hint, default TR
excludeOpcionalboolean—
replaceOpcionalbooleanremove existing targeted locations first
bid_adjustmentOpcionalnumberpercent

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

merge_google_campaigns

Escritura2 créditos

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

ParámetroTipoDescripción
target_campaign_idObligatoriostringTecrübe campaign id (list_campaigns) or Google Ads campaign id
source_campaign_idsObligatorioarray<string>—
move_budgetOpcionalbooleanadd the sources' daily budgets to the target (default true)
new_daily_budgetOpcionalnumberexplicit target daily budget instead of the sum

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

exclude_google_ips

Escritura2 créditos

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

ParámetroTipoDescripción
campaign_idObligatoriostringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ipsObligatorioarray<string>IPv4/IPv6 addresses or CIDR blocks

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_google_ad_group

Escritura2 créditos

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

ParámetroTipoDescripción
campaign_idObligatoriostringTecrübe campaign id (list_campaigns) or Google Ads campaign id
nameObligatoriostring—
cpc_bidOpcionalnumber—
keywordsOpcionalarray<any>—
headlinesOpcionalarray<any>—
descriptionsOpcionalarray<any>—
final_urlOpcionalstring—
path1Opcionalstring—
path2Opcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

set_google_ad_group_status

Escritura2 créditos

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

ParámetroTipoDescripción
ad_group_idsOpcionalarray<string>—
ad_group_idOpcionalstring—
statusObligatoriopause | enable—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

pause_google_ad_groups

Escritura2 créditos

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

ParámetroTipoDescripción
ad_group_idsObligatorioarray<string>—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

add_google_keywords

Escritura2 créditos

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

ParámetroTipoDescripción
ad_group_idObligatoriostring—
keywordsObligatorioarray<any>—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_google_keyword

Escritura2 créditos

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

ParámetroTipoDescripción
ad_group_idObligatoriostring—
keyword_idObligatoriostring—
statusOpcionalpause | enable—
bidOpcionalnumber—
match_typeOpcionalBROAD | PHRASE | EXACT—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

remove_google_negative_keywords

Escritura2 créditos

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

ParámetroTipoDescripción
campaign_idOpcionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
shared_list_idOpcionalstring—
keywordsObligatorioarray<string>—
match_typeOpcionalBROAD | PHRASE | EXACT—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

add_to_google_shared_negative_list

Escritura2 créditos

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

ParámetroTipoDescripción
list_idOpcionalstring—
list_nameOpcionalstringcreates a new list when list_id is not given
keywordsObligatorioarray<any>—
attach_campaign_idsOpcionalarray<string>—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_google_rsa

Escritura2 créditos

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

ParámetroTipoDescripción
ad_group_idObligatoriostring—
headlinesObligatorioarray<any>—
descriptionsObligatorioarray<any>—
final_urlObligatoriostring—
path1Opcionalstring—
path2Opcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_google_rsa_assets

Escritura2 créditos

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

ParámetroTipoDescripción
ad_group_idObligatoriostring—
ad_idObligatoriostring—
replace_low_performingOpcionalboolean—
remove_headlinesOpcionalarray<string>—
add_headlinesOpcionalarray<any>—
remove_descriptionsOpcionalarray<string>—
add_descriptionsOpcionalarray<any>—
headlinesOpcionalarray<any>—
descriptionsOpcionalarray<any>—
final_urlOpcionalstring—
path1Opcionalstring—
path2Opcionalstring—
pause_oldOpcionalbooleandefault true

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

add_google_callouts

Escritura2 créditos

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

ParámetroTipoDescripción
campaign_idObligatoriostringTecrübe campaign id (list_campaigns) or Google Ads campaign id
calloutsObligatorioarray<string>≤25 chars each

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_google_conversion_action

Escritura2 créditos

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

ParámetroTipoDescripción
nameObligatoriostring—
categoryOpcionalDEFAULT | 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_typeOpcionalone | many—
primary_for_goalOpcionalboolean—
default_valueOpcionalnumber—
currencyOpcionalstring—
always_use_default_valueOpcionalboolean—
click_through_window_daysOpcionalinteger (1–90)—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_google_conversion_action

Escritura2 créditos

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

ParámetroTipoDescripción
conversion_action_idObligatoriostring—
nameOpcionalstring—
statusOpcionalenable | hide | remove—
categoryOpcionalDEFAULT | 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_typeOpcionalone | many—
primary_for_goalOpcionalboolean—
default_valueOpcionalnumber—
currencyOpcionalstring—
always_use_default_valueOpcionalboolean—
click_through_window_daysOpcionalinteger (1–90)—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

add_google_asset_group_assets

Escritura2 créditos

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

ParámetroTipoDescripción
asset_group_idObligatoriostring—
headlinesOpcionalarray<string>—
long_headlinesOpcionalarray<string>—
descriptionsOpcionalarray<string>—
business_nameOpcionalstring—
marketing_imagesOpcionalarray<string>image URLs (https) or Studio /medya files
square_marketing_imagesOpcionalarray<string>image URLs (https) or Studio /medya files
logo_imagesOpcionalarray<string>image URLs (https) or Studio /medya files
portrait_marketing_imagesOpcionalarray<string>image URLs (https) or Studio /medya files
landscape_logo_imagesOpcionalarray<string>image URLs (https) or Studio /medya files

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.