Skip to main content
Agents can change campaigns, ad sets and ads after they exist. Every change is a preview first, then your yes, like a create. See How agents publish.

What an agent can change

Each call takes up to 50 objects in one ad account. A level below the one listed turns the yes into an approval link. See Access levels and approvals.

Only what agents made

DATALYR keeps its own record of every object agents created through it. Archive and delete also take everything underneath. A campaign takes its ad sets and ads along, so every one of them must be agent-made too. For archive and delete, a copy made with Ads Manager’s Duplicate doesn’t count as agent-made, even with the datalyr-agent label.

Pause

pause_ad_objects pauses campaigns, ad sets or ads. It pauses the campaign first, so spend stops soonest. To pause everything agents turned on at once, use Stop agent ads.

Change a budget

Ask for a new amount in the ad account’s currency. 50 means 50.00.

Give an ad new content (Meta)

update_ad_content replaces the text, image or video, link and call to action of one Meta ad. The agent sends the full new ad, as for a create.
  1. The agent previews. DATALYR runs the same checks and placement previews as a new ad in that ad set.
  2. You read the summary: Budget, targeting and status (…) stay as they are.
  3. You say yes. Meta gets a new creative, and the ad switches to it.
Meta reviews the new content before it delivers. On a running ad, the new content goes live once Meta approves it, so it counts as a live change. Meta allows one edit per ad every 30 seconds: DATALYR waits once and tries again. If someone edits the ad in Ads Manager after the preview, the agent must preview again.

Archive (Meta)

archive_ad_objects stops delivery and keeps the reporting. Archived objects can’t be edited, and a person can unarchive them in Ads Manager. Prefer it to delete on Meta.

Delete (Meta and TikTok)

A delete can’t be undone. The platform keeps the reporting, but the objects can’t be edited or turned on again.
delete_ad_objects removes agent-made campaigns, ad sets, ad groups or ads, and everything under them. DATALYR tells agents to delete only when you ask for it. It applies directly only for the owner in chat with Publish live. Every other yes becomes an approval link for the owner.

Verify

  1. Ask the agent for the status of the objects it changed.
  2. It calls get_ad_objects, which returns status, budget and today’s spend for up to 50 objects.
  3. Compare with Ads Manager.
  4. Open Settings → Ad publishing → Activity.
  5. Confirm the change appears in the list.

When it does not work

Next