Uneltele conectorului.

Descrierile sunt în engleză pentru că le citește asistentul, nu tu: așa alege singur unealta potrivită la ce-l întrebi. Tu vorbești cu el în orice limbă. Parametrul account_id poate lipsi: atunci asistentul lucrează pe contul tău principal.

Citire (16)

list_accounts

List the user's ad accounts in Optimads, which one is the primary account, the plan and the AI tokens left. Call this first when you don't know the account_id: most tools take one (Meta `act_…`; TikTok tools take the advertiser id from `tiktok_advertisers`).

Fără parametri.

business_profile

The business behind the account, as described in Optimads: website, description, targets (ROAS, CPA, margin, average order value) and the onboarding answers. Read it before giving advice about the business.

campaign_performance

Performance table per campaign, ad set or ad (`level`): spend, purchases, revenue, ROAS, CPA, CTR, frequency, leads, status, daily budget. `period`: today, yesterday, last_3d, last_7d, last_14d, last_30d, this_month, last_month — or pass since/until as YYYY-MM-DD. `campaign_id` narrows ad sets / ads to one campaign. `platform`: meta (default) or tiktok (then account_id is the TikTok advertiser id). Use it to say exactly what to pause, scale or fix.

ads_breakdown

Break the account's results down by a dimension, to see WHO and WHERE performs or wastes budget. Meta: age, gender, age_gender, platform, placement, device, country, region, hour. TikTok: age, gender, country, placement, platform. `days`: lookback window, 1-90.

ads_daily_trend

Day-by-day evolution of the Meta account (spend, purchases, revenue, ROAS, CTR), to spot WHEN performance dropped or scaled. `days`: 1-90.

top_creatives

SEE the actual images of the top-spending Meta ads together with their numbers. Call it before recommending what creatives to make or why creatives underperform: analyse format, hook, angle, on-image text and quality, and correlate them with the figures. `limit`: up to 8 ads.

tracking_status

Optimads Tracking on this account: whether server-side tracking is on, the connected store, the pixels and the platforms that receive events (Meta, TikTok, Google Ads; under `canale`, Pinterest / Snapchat / ChatGPT Ads with their IDs, on / off, last delivery and last error — `canale_on` false means these three are not enabled for the account yet).

attribution

Where the orders come from (Meta / TikTok / Google / Pinterest / Snapchat / ChatGPT Ads / organic / direct): last-touch credit plus who discovered the buyer (first touch), from Optimads Tracking. A source appears only when it brought visits or orders. `economics` gives per channel the visitors, orders, net revenue and, where Optimads can read it, spend, ROAS and what the platform claims (ChatGPT Ads spend needs its report key; Pinterest / Snapchat spend is not read yet). Needs the store connected and tracking on.

utm_report

Orders grouped by the last UTM the buyer saw before purchasing. `dimension`: campaign, source, medium, content or term.

orders_and_buyers

The period's orders with buyer insights: new vs returning buyers, time to purchase, paid attribution, tracking coverage. No personal data.

store_profit

Real store profit for the period: revenue minus product costs, ads, VAT and operating costs. Needs a connected store (Shopify, WooCommerce, MerchantPro, Gomag, PrestaShop or Magento); `connected: false` otherwise.

revenue_by_day

Day-by-day revenue (or cost per lead with metric=cpl) and spend per channel (Meta / TikTok / Google), with totals — the dashboard chart. `days`: 7, 14, 30 or 90.

creative_gallery

Images already generated or uploaded in Optimads for this account (id, image_url, media_type, created_at). Pass an `image_url` from here to launch_meta_campaign.

list_audiences

The custom audiences that exist on the account (id, name, type). `platform`: meta (account_id = act_…) or tiktok (account_id = advertiser id). Use it before suggesting audiences or before creating the standard set.

tracking_vs_platforms

Compare what the ad platforms REPORT with what Optimads Tracking really MEASURED in the store, for the same period: per Meta campaign the reported spend / purchases / revenue / ROAS next to the tracked orders and revenue (real ROAS), plus the real orders by channel (Meta, Google, TikTok, Pinterest, Snapchat, ChatGPT Ads, direct). Needs Optimads Tracking active on the account; otherwise `tracking` is false and only the platform numbers are returned. Use it when the user asks whether Meta's numbers are true, or which campaign really brings sales.

tracking_health

How well Optimads Tracking is delivering for the account, last 30 days: events sent to Meta and TikTok vs failed, signal quality (browser identifiers present), the funnel per event, retry queue; under `canale`, the same for Pinterest, Snapchat and ChatGPT Ads (sent / failed, funnel, retry queue, last error) when they are on. Use it when sales look under-reported.

Acțiuni (5)

set_status

Pause or activate a campaign, ad set or ad. `status`: ACTIVE or PAUSED. `level`: campaign, adset or ad. `platform`: meta (account_id = act_…) or tiktok (account_id = advertiser id). Activating a campaign also activates its ad sets and ads; pausing a campaign pauses everything under it. ACTIVE spends money: get the user's explicit confirmation in this conversation first. The user is notified of every change.

set_daily_budget

Change the daily budget, in the account's currency, of a campaign (CBO) or an ad set (ABO, `level`=adset). Meta allows about 4 changes per hour per entity. `platform`: meta or tiktok. Raising a budget spends more money: confirm with the user first. The user is notified of every change.

create_standard_audiences

Create Optimads' standard audience set on the account (site visitors, add-to-cart, buyers, engagement, lookalikes), skipping the ones that already exist. `platform`: meta (account_id = act_…; pixel_id optional, for accounts with several pixels) or tiktok (account_id = advertiser id; pixel_id required). Returns what was created, skipped and failed. Free.

generate_creatives

Generate ONE ad image with Optimads' own AI (costs the user's Optimads tokens, like in the app). `brief`: what the ad should show, in any language; empty = Optimads builds it from the business profile. `pattern` (Studio style): angles, splash_offer, hero_dramatic, before_after, premium_showcase, brand_lifestyle, discreet_elegant, disruptive, comparison_leadgen, testimonial_ugc, ugc_selfie, fb_review, clean_ingredient, search_mockup, product_range_review, kit_breakdown, announcement_icons, portrait. `format`: square, portrait or story. Returns the new gallery entry (creative.image_url) — pass it to launch_meta_campaign. Call again for more images. Tell the user it uses tokens first.

launch_meta_campaign

Launch a NEW Meta campaign through Optimads (campaign + ad set + one ad per creative), with Optimads' naming and UTM rules. It is created PAUSED: nothing spends until the user activates it. `objective`: Conversions, Catalog Sales, Traffic, Engagement, Awareness, Website Leads or Form Leads. `daily_budget`: whole number, account currency. Each creative: image_url (public, or from creative_gallery), headline, text, link. `countries`: ISO2 codes (default RO). `gender`: all, men or women. `audience`: 1 COLD, 2 WARM, 3 HOT or COMBO. `budgeting`: CBO or ABO. Interests are chosen automatically from the website; page and pixel come from the account's saved assets. Returns the IDs created.

Creativ — câmpurile unui element din listă:

Cum le folosești

Nu chemi uneltele tu: îi spui asistentului ce vrei, pe românește, iar el alege unealta. Ghidul de conectare: Claude și ChatGPT.