דילוג לתוכן
Tecrübetecrube.com
Assistant tools · Setup and campaigns

ChatGPT Ads tools

ChatGPT ad accounts connected with the OpenAI Ads API: campaign list, performance report, budget and status changes.

Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.

Read tools10 tools

list_openai_ads_accounts

קריאה1 credits

Connected ChatGPT Ads (OpenAI Ads) accounts: ad_account_id, name, currency, time zone, account and review status. Each account is connected in the panel with its own Ads API key. Read only; connected=false when none.

This tool takes no parameters.

list_openai_ads_campaigns

קריאה1 credits

ChatGPT Ads campaigns from the OpenAI Ads API: id (cmpn_…), name, status, daily or lifetime budget (account currency), bidding type, schedule. Read only; returns connected=false when no account is linked.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
statusOptionalactive | paused | archived—
nameOptionalstringfilter by campaign name (min 3 chars)

openai_ads_performance_report

קריאה2 credits

ChatGPT Ads delivery report (OpenAI Ads insights): impressions, clicks, spend, CTR, CPC, CPM per account, campaign, ad group or ad for a date range in the account time zone, optionally per day. Read only; never invents numbers.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
levelOptionalad_account | campaign | ad_group | ad—
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
dailyOptionalboolean—
campaign_idsOptionalarray<string>—

chatgpt_ads_details

קריאה1 credits

Full details of one ChatGPT Ads campaign (with its ad groups), ad group (bidding, context hints, ads) or ad (creative, review), including the serving issues OpenAI reports. Read only.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
idRequiredstringcmpn_…, adgrp_… or ad_…
hints_limitOptionalinteger (1–2000)—
hints_offsetOptionalinteger (0–…)—

chatgpt_ads_geo_lookup

קריאה1 credits

Find ChatGPT Ads location ids (countries, regions, markets, postal codes) by name for campaign location targeting. Read only.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
queryRequiredstring—
limitOptionalinteger (1–100)—

chatgpt_ads_insights

קריאה2 credits

ChatGPT Ads delivery report with OpenAI's options: hourly/daily/monthly buckets, country/device/platform/product breakdowns, zero-impression rows and conversion metrics, scoped to the account or one campaign, ad group or ad. Read only.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
scope_idOptionalstringoptional cmpn_/adgrp_/ad_ id to scope the report
levelOptionalad_account | campaign | ad_group | ad—
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
granularityOptionalnone | hourly | daily | monthly—
segmentOptionalnone | country | device | platform | product—
include_zeroOptionalbooleanadd zero-impression rows (no segment)
conversionsOptionalbooleanadd conversions, CPA, CVR, attributed sales and ROAS
limitOptionalinteger (1–2000)—
offsetOptionalinteger (0–…)—

chatgpt_ads_spend_limits

קריאה1 credits

ChatGPT Ads account spending limits: date-range windows and recurring daily limits with spend so far and what can be edited. Read only.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected

chatgpt_ads_conversion_setup

קריאה1 credits

ChatGPT Ads conversion tracking: pixels (sources), conversion event settings and the campaigns using them, plus events received in roughly the last 15 minutes. Read only.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
check_recent_eventsOptionalboolean—

chatgpt_ads_ad_preview

קריאה1 credits

Render how an existing ChatGPT Ads ad looks (temporary 24-hour preview) together with its review status and the delivery blockers OpenAI reports. Read only.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
ad_idRequiredstring—

diagnose_chatgpt_ads_delivery

קריאה2 credits

Explain why ChatGPT Ads aren't getting impressions: checks account status and reviews, spend limits, and every campaign, ad group and ad for OpenAI serving issues (optionally landing-page crawls), returning ranked findings with evidence, the fix and the tool that applies it. Read only.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
campaign_idOptionalstring—
check_landing_pagesOptionalboolean—

Write tools13 tools

update_openai_ads_campaign_status

כתיבה2 credits

Pause or activate a ChatGPT Ads campaign. Applied on OpenAI directly when the user asks (the result shows the preview), and undoable. Activation starts delivery only when OpenAI's other requirements (reviews, budget) are met.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
campaign_idRequiredstringcmpn_…
statusRequiredpause | activate—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_openai_ads_campaign_budget

כתיבה2 credits

Set a ChatGPT Ads campaign's daily budget. Applied directly when the user asks; increases above 50% per change or 2× within 24 hours are blocked; undo restores the previous budget. Lifetime-budget campaigns are not changed.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
campaign_idRequiredstringcmpn_…
daily_budgetRequirednumbernew daily budget in the account currency (not micros)

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

connect_chatgpt_ads

כתיבה0 credits

Connect a ChatGPT Ads (OpenAI Ads) ad account: without a key it explains the panel route; with api_key and confirm=true the key is verified against OpenAI and stored encrypted (owner/admin only). The key is never echoed.

ParameterTypeDescription
api_keyOptionalstringOpenAI Ads API key of one ad account
confirmOptionalboolean—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_chatgpt_ads_accounts

כתיבה0 credits

List the connected ChatGPT Ads accounts, re-check one against OpenAI (status, review, currency), disconnect it or make it the default used when ad_account_id is omitted. Disconnect and default need confirm=true.

ParameterTypeDescription
actionOptionallist | recheck | disconnect | set_default—
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
confirmOptionalboolean—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_chatgpt_ads_campaign

כתיבה8 credits

Create a ChatGPT Ads campaign (always paused) with a daily or lifetime budget in account currency, objective, locations, platforms, audiences, schedule and conversion goal. Applied directly when the user asks.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
nameRequiredstring—
daily_budgetOptionalnumber—
lifetime_budgetOptionalnumber—
objectiveOptionalimpressions | clicks | conversions—
descriptionOptionalstring—
include_locationsOptionalarray<string>location ids from chatgpt_ads_geo_lookup
exclude_locationsOptionalarray<string>location ids from chatgpt_ads_geo_lookup
platformsOptionalarray<ios_app | android_app | web | desktop_web | ios_web | android_web>—
custom_audience_idsOptionalarray<string>—
excluded_custom_audience_idsOptionalarray<string>—
startOptionalstringISO 8601 date-time (UTC if no offset)
endOptionalstringISO 8601 date-time (UTC if no offset)
conversion_event_setting_idsOptionalarray<string>—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_chatgpt_ads_campaign

כתיבה5 credits

Change a ChatGPT Ads campaign: name, budget, locations (replace / add / remove), platforms, schedule, conversion events or status. Budget increases above 50% are blocked. Applied directly when the user asks.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
campaign_idRequiredstring—
nameOptionalstring—
daily_budgetOptionalnumber—
lifetime_budgetOptionalnumber—
statusOptionalactive | paused—
include_locationsOptionalarray<string>location ids from chatgpt_ads_geo_lookup
exclude_locationsOptionalarray<string>location ids from chatgpt_ads_geo_lookup
locations_modeOptionalreplace | add | remove—
platformsOptionalarray<ios_app | android_app | web | desktop_web | ios_web | android_web>—
startOptionalstringISO 8601 date-time (UTC if no offset)
endOptionalstringISO 8601 date-time (UTC if no offset)
conversion_event_setting_idsOptionalarray<string>—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_chatgpt_ads_ad_group

כתיבה5 credits

Create a paused ad group under a ChatGPT Ads campaign with its bid strategy, maximum bid and context hints (when the ad would be useful). Unusually high bids need allow_high_bid. Applied directly when the user asks.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
campaign_idRequiredstring—
nameRequiredstring—
max_bidOptionalnumberaccount currency: CPM for impression billing, CPC for clicks, CPA for conversion campaigns
billing_eventOptionalimpression | click—
strategyOptionalfixed_bid | maximize_clicks | maximize_conversions—
allow_high_bidOptionalboolean—
context_hintsOptionalarray<string>—
descriptionOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_chatgpt_ads_ad_group

כתיבה5 credits

Change a ChatGPT Ads ad group's name, maximum bid, bid strategy or context hints (replace / add / remove). Bid jumps above 50% need allow_high_bid. Applied directly when the user asks.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
ad_group_idRequiredstring—
nameOptionalstring—
max_bidOptionalnumber—
strategyOptionalfixed_bid | maximize_clicks | maximize_conversions—
allow_high_bidOptionalboolean—
context_hintsOptionalarray<string>—
hints_modeOptionalreplace | add | remove—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_chatgpt_ads_ad

כתיבה8 credits

Create a paused ChatGPT Ads chat-card ad (title, body, destination, image) in an ad group; OpenAI reviews it. Applied directly when the user asks.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
ad_group_idRequiredstring—
nameRequiredstring—
titleRequiredstring3-50 chars
bodyRequiredstringmax 100 chars
target_urlRequiredstring—
image_urlOptionalstringpublic https image; OpenAI fetches it
file_idOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_chatgpt_ads_ad

כתיבה5 credits

Change the copy, destination or image of a ChatGPT Ads ad (the rest of the creative is kept); a changed creative is reviewed again. Applied directly when the user asks.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
ad_idRequiredstring—
nameOptionalstring—
titleOptionalstring—
bodyOptionalstring—
target_urlOptionalstring—
image_urlOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

chatgpt_ads_status

כתיבהIrreversible5 credits

Pause, activate or archive a ChatGPT Ads campaign, ad group or ad. Archiving is irreversible and is applied only when the user explicitly asked for it. Applied directly when the user asks.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
kindOptionalcampaign | ad_group | ad—
idRequiredstring—
actionRequiredpause | activate | archive—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_chatgpt_ads_event_setting

כתיבה5 credits

Create a ChatGPT Ads conversion event setting (which tracked event counts as a conversion) on one pixel source, usable as a campaign goal. Applied directly when the user asks.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
nameRequiredstring—
event_typeRequiredpage_viewed | contents_viewed | items_added | checkout_started | order_created | lead_created | registration_completed | subscription_created | trial_started | appointment_scheduled | plan_enrollment | app_installed | app_opened | custom—
source_idRequiredstringpixel source id (clidsrc_…)
custom_event_nameOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_chatgpt_ads_spend_limit

כתיבהIrreversible5 credits

Create, change or remove a ChatGPT Ads account spending limit (date-range window or recurring daily limit). Increases above 50% are blocked; removals only when the user explicitly asked. Applied directly when the user asks.

ParameterTypeDescription
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
actionRequiredcreate | update | delete | set_daily | delete_daily—
window_idOptionalstring—
start_dateOptionalstringYYYY-MM-DD, inclusive
end_dateOptionalstringYYYY-MM-DD, exclusive
amountOptionalnumberaccount currency
nameOptionalstring—
io_idOptionalstring—
no_end_dateOptionalbooleandaily limit without end

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.