مواد پر جائیں
Tecrübetecrube.com
Assistant tools · Setup and campaigns

Pinterest tools

Pinterest ad accounts, campaigns and performance reports; status and budget changes go through preview and approval and can be undone.

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

Read tools4 tools

list_pinterest_ad_accounts

پڑھنا1 credits

Pinterest Ads accounts reachable through the connected Pinterest login: account_id, name, currency, country, time zone, permissions and which one is selected. Read only; connected=false when Pinterest isn't connected.

This tool takes no parameters.

list_pinterest_campaigns

پڑھنا1 credits

Pinterest Ads campaigns of the account: id, name, status, objective, daily and lifetime budget (account currency), plus spend, paid impressions, paid clicks and conversions over the last N days (max 90). Active and paused by default. Read only; a null metric means Pinterest returned no value, numbers are never invented.

ParameterTypeDescription
account_idOptionalstringPinterest ad account id; defaults to the connection's selected account
daysOptionalinteger (1–90)last N days in UTC, today included (default 30)
statusOptionalactive | paused | archived | draft—

pinterest_performance_report

پڑھنا1 credits

Pinterest Ads performance for the account or per campaign: spend (account currency), paid impressions, paid clicks, conversions, CTR and CPC, as a total or by day, week or month, up to 90 days. Read only; numbers are never invented.

ParameterTypeDescription
account_idOptionalstringPinterest ad account id; defaults to the connection's selected account
daysOptionalinteger (1–90)last N days in UTC, today included (default 30)
start_dateOptionalstringYYYY-MM-DD (UTC), at most 90 days back; use with end_date
end_dateOptionalstringYYYY-MM-DD (UTC), at most 90 days after start_date
levelOptionalaccount | campaign—
granularityOptionaltotal | day | week | month—
campaign_idsOptionalarray<string>only with level=campaign; defaults to the account's active and paused campaigns

diagnose_pinterest_delivery

پڑھنا1 credits

Why a Pinterest Ads campaign isn't delivering, or is paused, pending or rejected: call it first when the user reports such a problem. Live read of the campaign, its ad groups (summary status, budget, bid strategy, bid, CPA goal, learning mode) and ads (review status, rejection reasons), returned with a findings list (scope, Pinterest's code, category, evidence) and cannot_read for what the API doesn't expose. Read only.

ParameterTypeDescription
account_idOptionalstringPinterest ad account id; defaults to the connection's selected account
campaign_idRequiredstringPinterest campaign id (list_pinterest_campaigns)

Write tools5 tools

update_pinterest_campaign_status

لکھنا2 credits

Pause or activate a Pinterest Ads campaign. Applied when the user asks, recorded in the audit log and undoable with undo_action.

ParameterTypeDescription
account_idOptionalstringPinterest ad account id; defaults to the connection's selected account
campaign_idRequiredstring—
statusRequiredpause | activate—

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

update_pinterest_campaign_budget

لکھنا2 credits

Set a Pinterest Ads campaign daily budget (account currency). Works only on campaigns with a campaign-level daily budget; lifetime-budget and ad-group-budget campaigns are refused. Increases above 50% per change or 2x per 24 hours are blocked; undoable with undo_action.

ParameterTypeDescription
account_idOptionalstringPinterest ad account id; defaults to the connection's selected account
campaign_idRequiredstring—
daily_budgetRequirednumbernew daily budget in the account currency

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

create_pinterest_campaign

لکھنا5 credits

Create a Pinterest campaign with its ad group and, when a pin id is given, the ad - all paused. The daily budget sits on the ad group (Pinterest's non-CBO flow). Applied when the user asks; activate it afterwards with update_pinterest_campaign_status.

ParameterTypeDescription
account_idOptionalstringPinterest ad account id; defaults to the connection's selected account
nameRequiredstring—
daily_budgetRequirednumber—
objective_typeOptionalAWARENESS | CONSIDERATION | WEB_CONVERSION | CATALOG_SALES | VIDEO_COMPLETION | SALES | LEADS—
billable_eventOptionalCLICKTHROUGH | IMPRESSION | VIDEO_V_50_MRC—
pin_idOptionalstringthe pin to promote; without it only the campaign and ad group are created
creative_typeOptionalREGULAR | VIDEO | SHOPPING | CAROUSEL | IDEA | COLLECTION—
destination_urlOptionalstring—
bidOptionalnumber—
placement_groupOptionalALL | SEARCH | BROWSE | OTHER—
ad_group_nameOptionalstring—
ad_nameOptionalstring—
audienceOptionalobjectcountries, age_min, age_max, genders, locales

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

send_pinterest_conversion_event

لکھنا1 credits

Send a server-side conversion event to Pinterest (Conversions API) so purchases and leads are measured even when the browser tag is blocked. Emails and phones are normalised and SHA-256 hashed inside Tecrube; sharing the event_id with the tag prevents double counting.

ParameterTypeDescription
account_idOptionalstringPinterest ad account id; defaults to the connection's selected account
event_nameRequiredadd_to_cart | checkout | custom | lead | page_visit | search | signup | view_category | watch_video | add_payment_info | initiate_checkout | subscribe—
action_sourceOptionalweb | app_android | app_ios | offline—
emailOptionalstring—
phoneOptionalstring—
external_idOptionalstring—
client_ip_addressOptionalstring—
client_user_agentOptionalstring—
event_idOptionalstringdeduplication id shared with the Pinterest tag
event_timeOptionalinteger—
event_source_urlOptionalstring—
valueOptionalnumber—
currencyOptionalstring—
order_idOptionalstring—
testOptionalbooleanvalidate the request without recording the event

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

manage_pinterest_audience

لکھنا2 credits

Create or delete a Pinterest audience: site visitors from the tag, people who engaged with the account, a customer list or an actalike (lookalike) audience. It takes hours to fill. Applied when the user asks.

ParameterTypeDescription
account_idOptionalstringPinterest ad account id; defaults to the connection's selected account
actionOptionalcreate | delete—
nameOptionalstring—
audience_typeOptionalVISITOR | ENGAGEMENT | CUSTOMER_LIST | ACTALIKE—
descriptionOptionalstring—
audience_idOptionalstring—
ruleOptionalobjectaudience rule, e.g. {"visitor_source_id": "<tag id>"}

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