launch-campaigns
Use when the user wants to build or launch campaigns: a new Meta sales campaign, ad set or ads; a Google Search campaign, ad group or RSAs; a Performance Max campaign or asset group; a TikTok launch;
SKILL.mdskills/launch-campaigns/SKILL.md
GitHubLaunch campaigns
Turn the approved brief into a campaign setup. GoMarble assembles the whole build: hierarchy, names, budgets, schedule, targeting, exclusions, placements, ads, copy, links and tracking. The user reviews it before the account changes.
When to use
- "Launch a Meta campaign for our new bundle with these creatives."
- "Set up a Google Search campaign for these keywords."
- "Build a PMax campaign" / "Add an asset group."
- "Launch this video on TikTok."
- "Duplicate our best ad set into a new campaign with a new budget."
Before you build
- Creative and brief. Get the creative (upload, URL, existing ad, or Drive file) and the brief. If there's no creative, ask for it first.
- Account context.
recall_memoryfor naming conventions, UTM rules, targets and anything the brand never does. Apply the user's naming and tracking rules across the whole build. - Currency. Meta:
facebook_get_details_of_ad_account. Google:google_ads_get_currency. TikTok:tiktok_get_account_details. Passcurrency_codeon every launch call. Budgets are in account currency (50 means $50). - The platform's launch skill. The launch tools' descriptions ask for GoMarble's master skill via
load_skill. This plugin ships the same content: read it from the plugin (meta-create-master-skill,google-ads-create-master-skill,tiktok-create-master-skill) and don't callload_skill.
Meta
Follow meta-create-master-skill, reading its references/ at each step.
- One call to
facebook_propose_create_campaign_structurecreates the campaign, one ad set and all its ads. The objective is Sales (OUTCOME_SALES); other objectives aren't supported through the connector. - Needed first:
facebook_list_pixels(use the only pixel, or ask which), and the Page ID plus Instagram account ID for every ad (fromfacebook_get_details_of_ad_account→account_structure,facebook_page_listorinstagram_list_accounts). - Targeting:
facebook_search_targetingfor interests, andfacebook_list_custom_audiencesfor custom and lookalike audiences (pass both id and name). - Catalog / dynamic product ads:
facebook_list_product_catalogs, thenfacebook_list_product_sets. - Uploaded creative: analyze it first with
facebook_analyze_ad_creative_by_id_or_url(fastMode: true) to write fitting copy. - Defaults: campaign and ad set active, ads paused. To turn the ads on after review, make one
facebook_propose_update_adsbatch (each activation needs the ad'sthumbnail_urlfromfacebook_list_ads). - Duplicate a winner:
facebook_propose_clone_campaign,facebook_propose_clone_adsetorfacebook_propose_clone_ad. Clones are created paused. To change a clone's text, usefacebook_propose_clone_ad_creative(Meta doesn't allow editing creative text in place).
Follow google-ads-create-master-skill and its references/.
- Search: one call to
google_ads_propose_create_campaign_structurecreates the campaign, one ad group and its RSAs, all or nothing. Campaign and ad group start enabled, ads paused. Research keywords first withgoogle_ads_keyword_discoverandgoogle_ads_keyword_metrics(google-ads-keywordplanner); never estimate volume or CPC. - Performance Max:
google_ads_propose_create_pmax_asset_group(readgoogle-ads-create-master-skill→references/pmax.md). Standard, non-retail PMax only. Needs 3–15 headlines, 1–5 long headlines, 2–5 descriptions, and landscape and square images. A new campaign also needs a business name and logo. Created paused. - Assets: sitelinks, structured snippets and images with
google_ads_propose_create_asset. Shared negative lists withgoogle_ads_propose_create_negative_keyword_list. - Images from Google Drive:
google_drive_search_filesfinds files GoMarble can access.google_drive_prepare_media_urlcopies a private Drive image or video to a public GoMarble URL the ad platforms can fetch. Use it only when the user asked to use that file, and tell them it makes a public copy.google_drive_upload_from_urlsaves a file from a public URL into Drive, but only when the user explicitly asks. These built-in Drive tools need a Drive permission most AI app connections can't be granted yet; if one returns a 606 permission error, ask the user for a public link to the file (or to download and attach it) instead.
TikTok (beta)
Follow tiktok-create-master-skill and its references/. The order is fixed: creative, then placement (it can't change later), then account scan, then propose.
- One call to
tiktok_propose_create_campaign_structurecreates the campaign, ad group and ads. Everything starts disabled unless enabled on purpose. - Needed first:
tiktok_get_identities(who the ad posts as),tiktok_list_pixelsandtiktok_list_custom_conversionsfor conversion goals,tiktok_search_targetingfor locations,tiktok_search_interestsfor interests,tiktok_list_audiencesfor custom audiences, andtiktok_list_catalogsfor catalog or Shop launches. - Media:
tiktok_upload_assetuploads to the asset library, but it's a direct write that AI app connections can't make today; use media already in the account, or have the user upload it. Carousels need amusic_idfromtiktok_get_music. - Duplicate a campaign:
tiktok_propose_copy_campaign(the copy starts disabled). - TikTok launches can be prepared and validated, not applied, through the connector. The TikTok tools are in a beta (accounts outside it don't see them), and the connector can't be granted TikTok write permission. For beta accounts, run the launch as a dry run to validate the whole build, then hand the user the complete spec to create in TikTok Ads Manager or the GoMarble web app.
Microsoft Ads and LinkedIn
The connector can't create campaigns on these platforms. Plan the build (for Microsoft, keyword ideas from bing_ads_keyword_ideas) and give the user a ready-to-enter spec.
Review and approval
- Make the dry run (
mode: "dryrun", the default). - Show the whole build in one clear summary: structure, names, budgets, schedule, targeting, placements, each ad's copy, links and UTMs, and what starts paused.
- Only after an explicit yes, call again with
mode: "live", theaccount_idand the approvedoperation_ids. Never go live without that yes in this conversation; GoMarble doesn't double-check for you. - Confirm what was created, with IDs, and what's still paused. Offer to turn the ads on as a separate approved change.
If a launch call fails twice, stop and explain. Don't loop through parameter guesses.
After launch
Offer an agent that watches the new campaign through its learning phase (see automate-with-agents), or a budget pacing check (shift-budget).