Plyto

Return the Plyto profile this connection is signed in as: an opaque id that stays the same across token refresh and reconnection, the person's name and email for display, and the business the connection manages as a label. Takes no arguments.

Set the least a Meta campaign's shared daily budget spends on one ad set each day (a minimum spend target), so a small audience is not starved by the others in a test. Only for campaigns with a campaign-level budget. Use for 'give each audience at least $12 a day'. Two steps: call without confirm to get the sum of floors against the campaign budget for the user, then with confirm true once they say yes.

Turn one ad set of a launched Meta campaign on (live) or off (paused) while the campaign keeps running. Use for 'turn on the plumbing ad set', 'pause the dental audience'. Two steps: call without confirm to get what starts or stops spending for the user, then with confirm true once they say yes. Google ad groups are not supported yet.

List every ad on a campaign with its ID, grouped by ad group. Run this BEFORE ads.creative.update or ads.creative.delete: those tools take the ad's id, never its headline text. Also the honest way to answer 'what ads does this campaign have'.

Permanently delete an UNUSED image or video from the creative library (the file and its record). Refused when the asset — or any of its placement-size siblings (same name, different ratio) — is attached to an ad, because launch resolves sibling sizes by name. Use for library hygiene: failed or superseded generations that nothing references, e.g. after rebinding an ad to older art.

List the creative library (images, videos) for the active business, with what each asset IS: role 'site-capture' is the real picture of their website the scan saved (the hero for ads.creative.compose_graphic layout screenshot on software), role 'reference' is a real photo of the business, source 'upload' is something the owner added, generated=true is art Plyto made, editedFrom names the owner's photo an edit was made from (an edit is still their photo); kind says what an upload is (photo, screenshot, document, graphic, logo) and looksLike what it shows, and a screenshot or document is information to read (images.view), never an ad's picture. Use it to pick a heroAssetId, a fromAssetId, or an asset for ads.creative.attach_image.

Create a Meta audience for the business: either a custom audience from one of their Plyto contact lists, or a lookalike of an audience they already have. Use when the user wants to target their customers, or reach 'people like' their best customers. Creating an audience spends nothing and changes no running campaign, but it does send their customer list to Meta, which is not reversible by deleting the audience afterwards.

Search Meta's interest and behavior catalog for detailed targeting, with approximate audience sizes. Use when the user wants to target people by interest, or asks what interests they could target. Returns ids that can be attached to an ad set.

List the Meta custom audiences and lookalikes on the connected ad account, with their approximate sizes. Use when the user asks what audiences they have, or before targeting or building one.

The change history of a campaign: every edit made through Plyto (budget, locations, keywords, bidding, status, ads), by whom and when, plus, for a live Google campaign, Google's own change log including edits made directly in Google Ads by a person. Use before explaining why results changed, before proposing a change someone may already have made, and whenever the current settings and an earlier conversation seem to disagree. Describe changes in words; never show the internal action names.

Delete a campaign that never launched (draft or failed): the campaign, its ad groups, and its draft ads are removed permanently; images stay in the creative library. A campaign that has reached the ad platform is archived instead of deleted, and a LIVE campaign is refused until it is paused. Two-step: first call returns a summary to confirm with the user; call again with confirm:true to delete (same as the two-step Remove in the UI).

Create a draft ad campaign on Meta (Facebook and Instagram), Google, or ChatGPT (OpenAI's ChatGPT Ads), the platforms Plyto can actually launch and manage. Drafts are NOT live: they require user approval and a UI launch action before spending money. Use when the user asks to create, generate, or set up a new ad campaign.

Read ONE campaign's full setup as it is on Google or Meta right now: bidding strategy and any cap or target, daily budget, what counts as a conversion and whether any have recorded in 30 days, the locations setting, networks, keyword and exclusion counts, ad approval and strength, and for Meta each ad set's optimization goal, audience and placements. Returns plain-English notes on setup problems that commonly explain spend with no results, and where Plyto's record differs from the platform (a setting changed outside Plyto). Call this FIRST when someone asks why a campaign has no results or zero conversions, why it costs so much, or how it is set up, then ads.performance.summary and ads.search_terms.list. Quote money in the campaign's own currency.

Launch a DRAFT campaign on Facebook and Instagram or Google Ads, the same way the Run it button does: checks that the ad account, payment method, Page and lead capture are in place, then starts the launch in the background. Money moves after this, so call it once WITHOUT confirmLaunch to get the exact daily budget and what will run, put that to the user, and call again with confirmLaunch: true only after they said yes. The launch itself takes a minute or two; the campaign page shows progress and a failure posts to the conversation.

List ad campaigns for the active business, optionally filtered by status and/or platform. Use when the user asks to see their campaigns or get an overview. The status of a launched campaign here is what Plyto last read from the ad platform (nightly, or the last refresh); before saying whether a campaign is live, paused or running, call ads.campaign.refresh, which reads the platform right now.

Where a campaign's ads show: the location targeting as the ad platform itself reports it for a live or paused campaign (Google: the places plus whether only people physically there see the ads; Meta: the places on every ad set), or what the draft holds. Use before changing locations, when someone asks where the ads run, and when clicks arrive from countries the business does not serve.

Set or replace the location targeting on a campaign, DRAFT or LIVE: plain place names, applied to every ad group, plus (Google) whether the ads reach only people physically in those places. Use when the checklist warns about missing locations, when targeting defaulted to the business's country and the user wants somewhere else, when clicks are arriving from countries the business does not serve, or whenever the user names where ads should run. Drafts: names resolve against the platform catalog when an account is connected, otherwise they are saved as pending and checked as soon as the account is connected; a name the platform does not know comes back in unresolved and blocks the launch until the owner names the nearest city or picks the place from the list. Live campaigns: read the current targeting with ads.campaign.locations.get first, tell the user what changes (which places stop seeing the ads), and call with confirmLiveEdit: true once they have said so; every name must resolve or nothing changes.

Pull the current state of launched campaigns, their ad groups and their ads straight from Google Ads and Facebook, and match Plyto's records to it: live or paused at every level, the campaign's daily budget, each ad's review state, and any delivery problem the platform reports. Plyto otherwise learns about changes made inside Google Ads or Ads Manager once a night. Call it before saying whether a campaign, ad group or ad is live, paused or running; when the owner says they changed something on the ad platform directly; and whenever what Plyto shows disagrees with what they see there. Reads only; nothing on the platform is changed.

Pause a live campaign or resume a paused one on the ad platform, the same path as the page's pause and resume buttons (platform call, audit row, undoable). Pausing needs no confirmation and stops spend at once. Resuming restarts spend, so it needs confirmResume: true after the user asked. To pause a single ad rather than the campaign, use ads.ads.status.set if available, or tell the user the campaign-level option.

Edit an existing ad campaign: name, objective, daily budget, plain-English audience, Google search keywords, or a listing campaign's property facts (listing: the price, beds, baths, size, address or open house the owner corrected). Draft campaigns are freely editable. For LIVE campaigns only the budget and the listing record can change, and a budget increase requires the user's explicit approval first (then pass confirmSpendIncrease: true). Never launches anything. The name is the campaign's name only: never fold an ad-group or intent name into it ('Campaign · Group'); new intent groups are ads.google.ad_groups.add on the draft's id.

Add one ad (headline + primary text + CTA, plus a link except on a Meta leads campaign, where the instant form is the destination and no link is needed) to a campaign's ad set. On a DRAFT it is saved and launches with the campaign. On a LIVE Google campaign it publishes a new responsive search ad into the ad group immediately, an extra variant competing alongside the existing ads, no budget change. Live Meta campaigns can't take new ads yet. Write copy in the brand voice; keep Google headlines ≤30 chars and descriptions ≤90 chars; on Meta keep the primary text under 125 characters (Facebook hides the rest behind "See more") and the headline under 40. Every offer, timeframe or proof is checked against what the owner said: the words refused most are "today", "same-day", "best prices", "free", "guaranteed", "authentic", "handmade" and any price, so leave them out unless they are on file. Call once per ad variation.

Attach a creative-library image OR video clip to a draft ad (sets it as the ad's media; for image sets, launch resolves the other placement sizes by the asset's name-siblings; a video clip launches as a Meta video ad that plays in Reels, Stories and the feed). Use right after ads.creative.generate_images or once a generated clip has landed, pairing each asset with the ad whose copy it matches, one call per ad. Any ad not yet on the platform takes one, a draft inside a launched campaign included; an ad already on the platform changes through the app.

Turn a REAL photo from the library into a finished ad set: the photo cropped for every placement size, the headline in real type, the real logo. No image model, no credits, nothing invented. THE FIRST CHOICE for a physical business whenever the owner has uploaded photos or the website scan saved some (ads.assets.list shows which are real): a real photo of the real place beats any generated scene. One call per photo; pass adCreativeId to attach the square to that ad. Generated images are refused here; those already are ads.

Compose a DESIGNED ad graphic deterministically: real type, the real logo, the real product image, proof from the claims on file. No AI image model; the only AI step is one quick look at the product image to pick the part to show (about a cent, free while the first campaign is set up, remembered per image and headline). To EDIT an existing designed graphic, pass revisionOf (its asset id) plus only the fields that change: the rest is kept, the old set is archived and the ad using it switches to the new one. Layout "complete" is the finished ad and the default for software with a product screen or site capture; "offer" is a typographic poster for a free-trial offer. A business with its own photos on file gets the ad built from one of them whatever the layout asked for. For a physical business or a store (trades, restaurants, retail, clothing, physical products) the picture is a photograph of the work or the product, by construction: their own photo, else the product on their site, else one scene of the place; with none of those the ad is held for a photo and the note says so, and no flat card is drawn. No price anywhere in the words (the page carries it) and no question mark in the picture's words. Every offer, credential, timeframe and proof in the words must trace to the brand profile, the website scan, or what the person said; the tool refuses the rest. All four placement sizes by default; when the owner asks for a square, pass ratios: ["1:1"] and that one picture is all that is made, attached and shown.

Turn library clips and images into a FINISHED video ad: a hook line over the opening seconds, an optional caption per clip, and a closing brand card with the real logo and a button, at 9:16 for Reels, Stories and TikTok (or 16:9, 1:1). A raw clip from ads.creative.generate_video is footage, not an ad; call this once the clips have landed, before attaching video to a draft. Deterministic composition, no credits, about a minute in the background; the ad lands in Creative studio with a notification and can then go on a draft with ads.creative.attach_image. Every offer or proof in the words must trace to the brand profile, the website scan or what the person said.

Delete a DRAFT ad outright (its images stay in the library), or PAUSE a live Google search ad (published ads can't be deleted, but a paused ad stops serving immediately). Use when a pre-launch check flags an ad the user wants gone — a trademarked competitor name in a headline, off-brand copy — instead of leaving a flagged ad you cannot clear. Live Meta ads can't be changed yet.

Take the picture off a DRAFT ad. The file stays in the library (ads.assets.delete removes it); the ad keeps its words and is marked as waiting for a picture, so it will not launch bare. Use it when a picture went on an ad that should have waited (the owner asked for their own photo first), or shows the wrong thing and nothing should stand in its place yet. To put a different picture on instead, ads.creative.compose_from_photo or ads.creative.attach_image replace it in one step. An ad already on the ad platform keeps its picture; change it from the campaign page or duplicate the campaign.

Create a draft ad creative attached to an existing ad set. Combines an uploaded image with copy + CTA + landing URL. The creative goes live with the ad set when the campaign is launched. Use after ads.campaign.draft and after the user has uploaded at least one image. PLACEMENT SIZES: a campaign needs up to 4 image sizes: 1:1 (1080x1080, REQUIRED, default/fallback for Marketplace+right column+search), 4:5 (1080x1350, Instagram feed), 9:16 (1080x1920, Stories/Reels), 16:9 (1920x1080, Facebook feed ONLY, never Marketplace or right column). The square must always exist; omit landscape rather than crop it badly.

Edit one of the owner's REAL photos: take something out of it or change something in it (a coffee table, rugs, clutter, a sign, the background) while their product stays exactly as it is. The edit is checked against the original and saved as a NEW copy beside it (the original is kept); pass adCreativeIds to put the edit on those draft ads. Use it whenever the owner asks to remove or change something in their photo, never a generated picture of their product instead. Not for generated pictures or ad graphics. Charges AI credits like one generated image, and an edit that fails the check is refunded. Takes a few minutes.

Make a flyer, poster or handout the owner can download and print, post or send: their title, the facts (when, where, what is included), how to reach them, their logo and one real photo, in their brand. Returns each size with a download link. For anything that is not an ad: an event, a class, an opening, a menu, a notice. Never tell anyone to screenshot a page instead.

Generate AI ad photographs from a prompt + the business's brand profile, sized for Meta placements, and save them to the creative library. For a physical business the picture is the work or the product, and a REAL photo from the library (ads.creative.compose_from_photo) comes first when one exists; generate only when nothing real is on file. Never over an ad that shows the owner's own photo, and never a picture of their product to stand in for their photo: to remove or change something in their photo (a table, a rug, the background), edit it with ads.creative.edit_photo. If every size fails quality review, call it once more with a simpler wordless brief (the tools or materials alone, no hands, no labeled equipment) before falling back to a designed graphic. PLACEMENT SIZES: 1:1 1080x1080 (REQUIRED default/fallback: Marketplace, right column, search), 4:5 1080x1350 (Instagram feed), 9:16 1080x1920 (Stories/Reels), 16:9 1920x1080 (Facebook feed ONLY, never Marketplace or right column). Defaults to the full four-size set. Charges AI credits (~15-20¢ per image). Takes a few minutes; returns asset ids. When generating FOR a campaign's existing ads, finish the job: pair each concept with the ad whose copy it matches and attach it with ads.creative.attach_image, one call per ad. Never leave images in the library and tell the user to attach them by hand.

Render a short video clip (4, 6 or 8 seconds, vertical 9:16 or wide 16:9) for Reels, Stories, TikTok-style and feed placements. Use for ANY request for a video, promo clip, reel or animated ad. It renders in the background for a few minutes; the finished clip lands in Creative studio (Marketing, Creative) and the person gets a notification. The clip shows a scene, never on-screen text or logos: headline and CTA live in the ad copy. People described generically in the brief are FINE (a plumber at work, a customer smiling at her phone, a barista); do not refuse or reframe a brief because it has a person in it. What is refused: real, named people and celebrities, copyrighted characters, and a STARTING IMAGE that contains a face.

Edit an existing ad's headline, description, or destination link. Drafts update in place. A live Google search ad gets a replacement version published and the old one paused, because Google does not allow editing published ad copy; destination-only changes update in place. Live Meta ads cannot be edited yet.

Explain why live campaigns are or aren't delivering: learning phase, budget too small to enter the auction, rejected ads, audience too narrow, payment problems. Use whenever the user asks why a campaign has low or zero spend, impressions, or results.

Where this business's ad clicks go, or, when nobody has decided yet, the short numbered question to ask the owner (ask: one line per choice, their site's real pages checked live, and the pick with its reason). A draft's result already carries what to say as destinationAsk; call this when the owner wants to launch or asks what is left. Never decide it yourself: relay ask as it is, without adding to it, and record the answer with ads.destination.set.

Record where the owner wants ad clicks to go, then do what that implies: build and host the landing page (page, or an embeddable link), point the campaign's draft ads at their site or link (site, link), or mark a Facebook draft for an instant form. Call it the moment they answer the destination question, or with decidedBy agent when they said 'you pick'. Answers with what to tell them. Live ads are never moved by this.

Push the landing page URLs shown in Plyto to the live ads on Google, for a campaign whose destinations were changed after launch. Use when ads are sending traffic somewhere other than what the campaign page shows. Changes where clicks land; it does not change budget or spend.

The funnel behind the ad spend, by campaign, for the last N days: spend, clicks, and every stage after the click through to a paying customer, with cost per stage. Call this BEFORE judging a campaign, proposing a budget change, or answering 'what should we change about our ads': the platform's conversion count is not the number of customers, and a signup or a form fill that never went further is not a result. Also returns the landing-page funnel (sessions, starts, submits) by page so you can see where clicks are lost.

Send a tagged test lead through a campaign's whole funnel: landing page, form, CRM contact, conversion attribution, and a dry-run Google upload check. The test lead uses an undeliverable address, is removed afterwards, and no ads or budgets change. Use when someone asks whether their tracking or funnel actually works.

Add a complete search ad group (keywords phrase-match by default, RSA copy) to a SPECIFIC Google campaign by id. Headlines are at most 30 characters and descriptions 90, and every offer, timeframe or proof is checked against what the owner said (the words refused most: today, same-day, free, best prices, guaranteed, any price not on file). Where its clicks go follows the owner's decision on file (a page Plyto builds for the group, or their own link); undecided, the result carries the question to ask. A page Plyto builds is written in the background after the group is saved, about a minute each: several groups can be added back to back without waiting, their ads link to their pages as each page lands, and launch waits for them. Headlines and descriptions must never name a competitor: every brand the campaign's keywords are built around ("vendasta alternative" means Vendasta) is refused in the copy, along with well-known rivals, while the keywords themselves may name them. Never put a phone number in a headline or description: Google disapproves every line that carries one, and the landing page shows the number. Headlines, descriptions and keywords name only the campaign's own area: a town or state from a claim about another area is refused. Pass 8-12 VARIED headlines and 3-4 distinct descriptions: launch pools them (plus title-cased keywords) into one responsive search ad, and thin or repetitive lists rate Poor on Ad strength, which loses auctions regardless of bid. On a DRAFT campaign this creates draft rows only, reviewable and launchable later; nothing reaches Google. On a LIVE campaign it writes to Google immediately and is refused unless confirmLiveEdit is true, which you may set only after the user explicitly asked to edit that live campaign. While building a new campaign, always pass the new draft's id. Errors instead of duplicating when a same-named group already exists.

Remove an ad group you (or the user) no longer want. Draft groups are deleted outright along with their draft ads. Groups on a LIVE campaign are PAUSED in Google instead: delivery stops immediately, history is kept, and the pause is reversible in Google Ads. Use this to clean up groups created by mistake.

Start a landing page A/B test on the live Google campaign. In ad groups with room it adds a copy of the strongest ad pointing at the new URL; in groups already at Google's 3-ad cap it repoints the weakest ad instead, keeping the strongest on the incumbent page. Google's ad rotation splits the traffic and attribution records which page each signup came through. Skips ad groups that already point at that page, so it is safe to run twice. Does not change budget, bidding, or keywords.

Fill every live responsive search ad in a Google campaign up to the full 15-headline / 4-description asset counts, keeping all existing lines and pins and adding brand and ad-group-themed lines. Use when Google rates the ads' Ad strength Poor: thin asset lists cap Ad strength, and Poor strength costs auctions regardless of bid. Existing copy is never removed. Honest caveats to relay: Google briefly re-reviews edited ads, the ads' learning history resets, and the Ad strength label can take hours to recompute.

Switch a live Google campaign between clicks bidding and conversions bidding. Use maximize_clicks when a campaign shows zero or near-zero impressions on Google Search because it is optimizing toward conversions that never get recorded. Spends the same daily budget either way; does not raise it. This changes how a live campaign spends, so call it only after the owner has said yes to this specific change in this conversation; asking for 'a fix' or an explanation is not a yes. maximize_conversions is refused below about 15 conversions in 30 days.

Set up Google conversion tracking for a business that is missing it. Use when a campaign launched without conversion tracking, or when the campaign page reports that setup failed. It never changes how a campaign bids or spends: the result lists each live Google campaign's conversions in the last 30 days and whether that is enough (about 15) for conversion bidding. Relay that in words; if one is ready, offer the switch and make it only after the owner says yes to it.

Draft sitelinks, callouts, and a structured snippet for a DRAFT Google campaign from the brand profile and the campaign's own keywords, and save them onto the draft. They are applied to Google at launch. URL VERIFICATION IS BUILT IN: sitelink destinations are chosen from the site's own sitemap and each is HEAD-checked live (HTTP 200) before saving, so NEVER refuse to run this out of doubt about URLs, and never leave callouts empty over URL concerns (callouts have no URLs at all). Run this on every Google draft you build; a Search campaign without sitelinks and callouts loses ad real estate to competitors who have them. Re-running replaces the previous draft set. Refuses live campaigns (extensions ship at launch).

Add keywords to a live Google campaign's ad group, phrase match by default. Use to feed phrasing families that are converting, for example when winning search terms are not yet covered by the keyword list. Does not change budget; new keywords compete inside the existing daily cap.

Turn Google Search Partners on or off for a live campaign. Partner sites deliver cheap clicks with high click-through rates and far worse conversion than Google Search, so turning them off is the standard fix when a campaign shows an implausible click-through rate and no results. Changes where ads show; it does not change budget.

TEMPORARILY UNAVAILABLE: Google approved Plyto for conversion reporting, and approval for customer list uploads is still pending, so this tool currently refuses with an explanation. When a user asks for a Google audience, say that plainly and offer keyword targeting on Google or the same audience on Meta instead. Normally: upload a Plyto contact list to Google as a Customer Match audience. Emails are hashed before they leave Plyto, but the upload itself cannot be taken back.

List the Customer Match and remarketing audiences on the connected Google Ads account, with their sizes. Use when the user asks what Google audiences they have or before targeting one.