hermosodocs

Edit and duplicate ads after launch

A campaign rarely stays as it was built. These tools change what is already running: the money, the bid, the schedule, who it reaches and what it shows, without deleting the ad and losing its history. They also make paused copies of what already works. Every change is read back from the platform before Hermoso tells you it happened.

How every change works

Meta

ToolWhat it does
update_meta_objectBesides the name, daily budget, targeting and status: lifetimeBudgetUsd (needs an end time; Meta does not let a budget go below 110% of what is already spent), bidStrategy, bidAmountUsd (bid or cost cap), minRoas (with LOWEST_COST_WITH_MIN_ROAS and the goal VALUE), endTime (or "ongoing" for a daily budget) and optimizationGoal on an ad set. On an ad: creativeId to point it at another creative, or imageHash / videoId from upload_meta_asset and urlTags for new UTMs. Meta does not let a creative be edited, so Hermoso builds a new one from the ad's current copy and button, points the ad at it and keeps the old one.
duplicate_meta_objectCopies a campaign, ad set or ad with Meta's own copy feature, with everything under it (deep: false copies only the top object). An ad set can go into another campaign with targetCampaignId, an ad into another ad set with targetAdSetId. Up to 50 ads per call.

Google Ads

ToolWhat it does
manage_google_ads_asset_groupsPerformance Max asset groups: list, create (with Google's minimum set of headlines, long headlines, descriptions and images in the same call), update the name, final URL and display paths, pause, enable, remove (never the last one), link and unlink assets (never below Google's minimum), and for a campaign on a Merchant Center feed, read and set which products it advertises: everything, only some brands, item ids, product types, categories, conditions or custom labels, or everything except them.
update_google_ads_adEdits a responsive search ad in place: headlines (with pins), descriptions, display paths, final URLs, the final URL suffix and the tracking template. A list you send replaces the ad's list, so send all of it.
set_google_ads_statusNow also turns one keyword on or off: level: "keyword" with adGroupId and keywordId.
google_ads_keyword_ideasmode: "historical" returns the volume, competition, bid range and month-by-month searches of keywords you already have (up to 10,000), with startMonth / endMonth for a range.
duplicate_google_ads_campaignCopies a Search or Display campaign: its budget amount, bidding, networks, locations, languages, schedule, negatives, ad groups, keywords and responsive ads. Google has no copy feature in its API, so Hermoso rebuilds it in one step. The copy's history and Quality Score start fresh. dryRun: true checks it without creating anything.

TikTok and X

ToolWhat it does
update_tiktok_ads_ad_groupChanges an ad group's targeting (locations, ages, gender, languages, interests, audiences, devices, networks), its bid (cost cap or maximum delivery) and its schedule (the start before it begins, the end, and the hours it runs). TikTok replaces the whole ad group on every edit, so Hermoso resends everything you did not change exactly as TikTok stores it. Placement, optimization goal and billing cannot change after launch; the budget is set_tiktok_ads_budget.
manage_x_ads_conversion_eventsLists, creates and updates the conversion events on the X Pixel (purchase, lead, page view and the rest), with each event's id and the pixel id. send_x_ads_conversions now finds those ids itself: leave pixelId out and name an event by its kind, for example "eventType": "PURCHASE".

The API routes are POST /api/meta/object/update, POST /api/meta/object/duplicate, POST /api/google-ads/asset-groups, POST /api/google-ads/ad/update, POST /api/google-ads/duplicate, POST /api/google-ads/status, POST /api/google-ads/keyword-ideas, POST /api/tiktok-ads/adgroup/update and GET / POST /api/x-ads/conversion-events. In the app, ask the Studio for any of these in your own words.

Example

update_meta_object {"objectId": "120211", "adAccountId": "act_1", "bidAmountUsd": 6}
  → "120211 is LIVE and spending. This changes bid 5.00 USD → 6.00 USD ... Nothing was changed."
update_meta_object {"objectId": "120211", "adAccountId": "act_1", "bidAmountUsd": 6, "confirm": true}
  → "Meta now stores: bid 6.00 USD (amounts in USD)."
duplicate_meta_object {"objectId": "120200", "adAccountId": "act_1"}
  → "Meta made 1 campaign, 1 ad set, 2 ads ... all PAUSED, so nothing spends until someone switches them on."