Tecrübetecrube.com
Référence des outils — Publicité

Google Ads tools

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

Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont le texte anglais d'origine vu par l'assistant.

Outils de lecture13 outils

list_google_ads_accounts

Lecture1 crédits

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.

Cet outil ne prend aucun paramètre.

google_device_report

Lecture2 crédits

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.

ParamètreTypeDescription
daysFacultatifinteger (1–365)—
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD
campaign_idFacultatifstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
compare_previousFacultatifboolean—

list_google_ads_recommendations

Lecture1 crédits

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.

ParamètreTypeDescription
typesFacultatifarray<string>recommendation types, e.g. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET
campaign_idFacultatifstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

google_keyword_planner

Lecture2 crédits

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.

ParamètreTypeDescription
seed_keywordsFacultatifarray<string>—
urlFacultatifstring—
locationFacultatifstringcity/region names, comma separated
countryFacultatifstringISO code, default TR
languageFacultatifstringtr, en, de, fr, es, ar, ru
limitFacultatifinteger (10–500)—

list_google_ip_exclusions

Lecture1 crédits

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

ParamètreTypeDescription
campaign_idFacultatifstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

list_google_ad_groups

Lecture1 crédits

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.

ParamètreTypeDescription
campaign_idFacultatifstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

list_google_shared_negative_lists

Lecture1 crédits

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.

ParamètreTypeDescription
list_idFacultatifstringalso return this list's keywords

list_google_ads

Lecture1 crédits

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.

ParamètreTypeDescription
campaign_idFacultatifstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idFacultatifstring—

list_google_conversion_actions

Lecture1 crédits

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.

Cet outil ne prend aucun paramètre.

list_google_asset_groups

Lecture1 crédits

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.

ParamètreTypeDescription
campaign_idFacultatifstringTecrübe campaign id (list_campaigns) or Google Ads campaign id

Outils d'écriture26 outils

select_google_ads_account

Écriture1 crédits

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.

ParamètreTypeDescription
customer_idObligatoirestringclient customer id from list_google_ads_accounts

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

apply_google_ads_recommendation

Écriture2 crédits

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

ParamètreTypeDescription
recommendationsObligatoirearray<string>resource names from list_google_ads_recommendations

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_google_search_campaign

Écriture2 crédits

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

ParamètreTypeDescription
nameObligatoirestring—
daily_budgetObligatoirenumberaccount currency
locationsFacultatifarray<string>city/region/country names; default: brand profile city
location_idsFacultatifarray<string>Google geo target constant ids
countryFacultatifstring—
languagesFacultatifarray<string>language codes (tr, en…) or Google language ids; default Turkish
bid_strategyFacultatifmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks—
target_cpaFacultatifnumber—
target_roasFacultatifnumber—
max_cpcFacultatifnumber—
cpc_bidFacultatifnumberad group default CPC
keywordsFacultatifarray<any>—
headlinesFacultatifarray<any>—
descriptionsFacultatifarray<any>—
final_urlFacultatifstring—
ad_group_nameFacultatifstring—
search_partnersFacultatifboolean—
end_dateFacultatifstringYYYY-MM-DD
goalFacultatifstring—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_google_pmax_campaign

Écriture2 crédits

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

ParamètreTypeDescription
nameObligatoirestring—
daily_budgetObligatoirenumber—
final_urlObligatoirestring—
business_nameObligatoirestring≤25 chars
headlinesObligatoirearray<string>3-15, ≤30 chars
long_headlinesObligatoirearray<string>1-5, ≤90 chars
descriptionsObligatoirearray<string>2-5, ≤90 chars
marketing_imagesObligatoirearray<string>1.91:1 landscape, at least 1
square_marketing_imagesObligatoirearray<string>1:1, at least 1
logo_imagesObligatoirearray<string>1:1 logo, at least 1
portrait_marketing_imagesFacultatifarray<string>image URLs (https) or Studio /medya files
landscape_logo_imagesFacultatifarray<string>image URLs (https) or Studio /medya files
bid_strategyFacultatifmaximize_conversions | maximize_conversion_value—
target_cpaFacultatifnumber—
target_roasFacultatifnumber—
locationsFacultatifarray<string>—
countryFacultatifstring—
languagesFacultatifarray<string>—
asset_group_nameFacultatifstring—
end_dateFacultatifstring—
goalFacultatifstring—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_google_campaign

Écriture2 crédits

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

ParamètreTypeDescription
campaign_idObligatoirestringTecrübe campaign id (list_campaigns) or Google Ads campaign id
nameFacultatifstring—
statusFacultatifpause | enable—
end_dateFacultatifstring | nullYYYY-MM-DD, or null to run indefinitely

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

rename_google_campaigns

Écriture2 crédits

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

ParamètreTypeDescription
renamesFacultatifarray<object>—
campaign_idsFacultatifarray<string>—
patternFacultatifstringnaming pattern with {name}, {channel}, {id}, e.g. 'Brand | {channel} | {name}'
findFacultatifstring—
replaceFacultatifstring—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

remove_google_campaign

ÉcritureIrréversible2 crédits

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

ParamètreTypeDescription
campaign_idObligatoirestringTecrübe campaign id (list_campaigns) or Google Ads campaign id

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

set_google_bid_strategy

Écriture2 crédits

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

ParamètreTypeDescription
campaign_idObligatoirestringTecrübe campaign id (list_campaigns) or Google Ads campaign id
strategyObligatoiremaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks—
target_cpaFacultatifnumberaccount currency
target_roasFacultatifnumberratio, 4.0 = 400%
max_cpcFacultatifnumberCPC ceiling for maximize_clicks

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

set_google_ad_schedule

Écriture2 crédits

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

ParamètreTypeDescription
campaign_idObligatoirestringTecrübe campaign id (list_campaigns) or Google Ads campaign id
replaceFacultatifbooleanremove the existing schedule first
scheduleObligatoirearray<object>—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

set_google_location_targets

Écriture2 crédits

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

ParamètreTypeDescription
campaign_idObligatoirestringTecrübe campaign id (list_campaigns) or Google Ads campaign id
locationsFacultatifarray<string>names, e.g. İstanbul, Ankara
location_idsFacultatifarray<string>—
countryFacultatifstringISO code hint, default TR
excludeFacultatifboolean—
replaceFacultatifbooleanremove existing targeted locations first
bid_adjustmentFacultatifnumberpercent

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

merge_google_campaigns

Écriture2 crédits

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

ParamètreTypeDescription
target_campaign_idObligatoirestringTecrübe campaign id (list_campaigns) or Google Ads campaign id
source_campaign_idsObligatoirearray<string>—
move_budgetFacultatifbooleanadd the sources' daily budgets to the target (default true)
new_daily_budgetFacultatifnumberexplicit target daily budget instead of the sum

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

exclude_google_ips

Écriture2 crédits

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

ParamètreTypeDescription
campaign_idObligatoirestringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ipsObligatoirearray<string>IPv4/IPv6 addresses or CIDR blocks

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_google_ad_group

Écriture2 crédits

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

ParamètreTypeDescription
campaign_idObligatoirestringTecrübe campaign id (list_campaigns) or Google Ads campaign id
nameObligatoirestring—
cpc_bidFacultatifnumber—
keywordsFacultatifarray<any>—
headlinesFacultatifarray<any>—
descriptionsFacultatifarray<any>—
final_urlFacultatifstring—
path1Facultatifstring—
path2Facultatifstring—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

set_google_ad_group_status

Écriture2 crédits

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

ParamètreTypeDescription
ad_group_idsFacultatifarray<string>—
ad_group_idFacultatifstring—
statusObligatoirepause | enable—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

pause_google_ad_groups

Écriture2 crédits

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

ParamètreTypeDescription
ad_group_idsObligatoirearray<string>—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

add_google_keywords

Écriture2 crédits

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

ParamètreTypeDescription
ad_group_idObligatoirestring—
keywordsObligatoirearray<any>—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_google_keyword

Écriture2 crédits

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

ParamètreTypeDescription
ad_group_idObligatoirestring—
keyword_idObligatoirestring—
statusFacultatifpause | enable—
bidFacultatifnumber—
match_typeFacultatifBROAD | PHRASE | EXACT—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

remove_google_negative_keywords

Écriture2 crédits

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

ParamètreTypeDescription
campaign_idFacultatifstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
shared_list_idFacultatifstring—
keywordsObligatoirearray<string>—
match_typeFacultatifBROAD | PHRASE | EXACT—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

add_to_google_shared_negative_list

Écriture2 crédits

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

ParamètreTypeDescription
list_idFacultatifstring—
list_nameFacultatifstringcreates a new list when list_id is not given
keywordsObligatoirearray<any>—
attach_campaign_idsFacultatifarray<string>—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_google_rsa

Écriture2 crédits

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

ParamètreTypeDescription
ad_group_idObligatoirestring—
headlinesObligatoirearray<any>—
descriptionsObligatoirearray<any>—
final_urlObligatoirestring—
path1Facultatifstring—
path2Facultatifstring—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_google_rsa_assets

Écriture2 crédits

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

ParamètreTypeDescription
ad_group_idObligatoirestring—
ad_idObligatoirestring—
replace_low_performingFacultatifboolean—
remove_headlinesFacultatifarray<string>—
add_headlinesFacultatifarray<any>—
remove_descriptionsFacultatifarray<string>—
add_descriptionsFacultatifarray<any>—
headlinesFacultatifarray<any>—
descriptionsFacultatifarray<any>—
final_urlFacultatifstring—
path1Facultatifstring—
path2Facultatifstring—
pause_oldFacultatifbooleandefault true

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

add_google_callouts

Écriture2 crédits

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

ParamètreTypeDescription
campaign_idObligatoirestringTecrübe campaign id (list_campaigns) or Google Ads campaign id
calloutsObligatoirearray<string>≤25 chars each

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_google_conversion_action

Écriture2 crédits

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

ParamètreTypeDescription
nameObligatoirestring—
categoryFacultatifDEFAULT | 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_typeFacultatifone | many—
primary_for_goalFacultatifboolean—
default_valueFacultatifnumber—
currencyFacultatifstring—
always_use_default_valueFacultatifboolean—
click_through_window_daysFacultatifinteger (1–90)—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_google_conversion_action

Écriture2 crédits

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

ParamètreTypeDescription
conversion_action_idObligatoirestring—
nameFacultatifstring—
statusFacultatifenable | hide | remove—
categoryFacultatifDEFAULT | 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_typeFacultatifone | many—
primary_for_goalFacultatifboolean—
default_valueFacultatifnumber—
currencyFacultatifstring—
always_use_default_valueFacultatifboolean—
click_through_window_daysFacultatifinteger (1–90)—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

add_google_asset_group_assets

Écriture2 crédits

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

ParamètreTypeDescription
asset_group_idObligatoirestring—
headlinesFacultatifarray<string>—
long_headlinesFacultatifarray<string>—
descriptionsFacultatifarray<string>—
business_nameFacultatifstring—
marketing_imagesFacultatifarray<string>image URLs (https) or Studio /medya files
square_marketing_imagesFacultatifarray<string>image URLs (https) or Studio /medya files
logo_imagesFacultatifarray<string>image URLs (https) or Studio /medya files
portrait_marketing_imagesFacultatifarray<string>image URLs (https) or Studio /medya files
landscape_logo_imagesFacultatifarray<string>image URLs (https) or Studio /medya files

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.