Simulate a campaign

A simulation lets you try a campaign before it touches a real project. You paste the campaign's quests and point ledgers into Playground, and Domino builds it and publishes it to a throwaway project of its own.

• Your projects stay as they are. The simulation is a separate project in Domino's sandbox, in its Test environment. Nothing reaches your projects until you choose Make this real.
• It's yours alone. Only you, signed in to the same organization, can open your simulations. Teammates don't see them.
• It's deleted after 24 hours. Each simulation is deleted 24 hours after it starts, and you can't open it after that.

Simulate

1. Open Developers → Build with the Test environment selected, then choose Simulate beside Map. You need publish permission in Test, as for the rest of Playground.
2. Edit the campaign in the editor. It starts with a small example: a point ledger and three quests.
3. Choose Simulate, or press Ctrl+S (⌘S on a Mac) in the editor.

The build can take a few minutes. Its state shows below the editor: Queued, Building, then Published once the campaign is live in the simulation, or Failed. The simulation's deletion time is shown beside it. Simulate again after an edit and Playground reuses the same simulation while it has more than 30 minutes left and you haven't run personas in it; otherwise it starts a new one.

When the campaign doesn't build

A failed build shows The campaign didn't build with the error from the step that failed, such as a type error with its line number. Build logs opens the full log. Fix the campaign in the editor and choose Simulate again.

Run personas

Once the simulation shows Published, Run personas sends generated members through the campaign, day by day, the way real members would use it. Their actions go through Domino's real pipeline: the same checks, caps, budgets and rewards as in your project, with points paid into the simulation's own ledgers.

1. Set Days, from 1 to 30. It starts at 7.
2. Set Members per persona. It starts at 5. A run has at most 500 members in total.
3. Choose Run. A bar shows the simulated days done. A run takes longer the more members and days it has.

The campaign gets a threshold pair for each cap, filter number and goal it has, up to 10 pairs.

Each member is enrolled in every quest and campaign that requires enrollment as soon as it's created. If that's refused, for example because the campaign has ended, the run stops and shows why. How members act on each kind of quest:

• Quests members submit with no answer, a text or a link: they submit, and the quest's own check decides.
• Quests a teammate confirms are passed as a reviewer would pass them. Caps, budgets and rewards still apply.
• X and Discord tracker quests get a post, message or reaction from each member. Members get their accounts before their first record, so nothing counts as having happened before they linked.
• Custom tracker quests whose records name members get a record from each member.
• Quests that complete by themselves once others are done follow from the other quests.

Photo and quiz quests, Telegram, YouTube, TikTok and wallet trackers, and quests that pay an account other than the author are listed under Not simulated.

At the end of each simulated day, every member's clock moves one day forward, so daily caps and goals start again.

Real X posts

A campaign with an X search tracker is also tried on real posts. Before its members are created, the run reads one sample of each X search tracker's search: up to 100 matching posts from the last 7 days.

• Each author becomes a member. When a quest pays the authors of a tracker's posts, every author in its sample becomes a Real X authors member, named by their handle and linked to their X account before any of their posts is sent, so none counts as having happened before they linked.
• Their posts are replayed in order. Each post is sent to the tracker as that author's post, with its text and numbers, oldest first. The sample's week is spread over the run's days, and an author sends at most 12 posts a day to one tracker.
• The sample is read once. Later runs in the same simulation replay the same posts and read nothing more from X. Samples don't count toward your organization's X usage.

Authors past the run's 500 members are left out, and Playground says how many. If a sample can't be read, for example because X search is busy, Not simulated says so and the run goes on without it; the next run tries again.

The results add a Real X posts section: each sample and its query, how many authors got paid, the replayed posts a quest's filter passed over, or that Domino or the quest rejected or refused, and why, and Estimated X reads a day. That estimate is what the trackers would read from X on each plan, against the plan's monthly X budget: how often each tracker searches on that plan (the interval your plan allows, as a deploy warns when a tracker asks for less), the pages a search needs for the posts its sample found, and the re-reads of posts it already knows.

Results

When the run finishes, Playground shows:

• By persona: points paid, attempts accepted, attempts rejected or refused, and cap hits, with a total row. A campaign with tracker quests also shows records skipped and records a quest's filter passed over.
• Rejects and their reasons: each reason Domino or the quest gave, the quest, and how many times. Cap and budget hits read Budget exhausted.
• Leaderboard: the top 10 members of each point ledger after any simulated day you choose.
• Real X posts: what the sampled X authors earned and the X reads a day the campaign's trackers would make, when it has an X search tracker.
• Not simulated: the quests the run left out, and why.

Each day, members act in rounds, and each round waits for its attempts to be checked before the next. Attempts still being checked two minutes into the wait are counted as undecided, and Playground says so.

Make this real

When the simulation shows Published, Make this real publishes the same definitions to a project of yours.

1. Under Make this real, choose the Project. The list shows the projects in this organization you can publish to.
2. Choose Make this real, check the summary, and choose Publish to test.
3. Choose Open deployments to see the new deployment in that project.

The definitions are published to the project's Test environment the same way a deploy publishes them: a quest or ledger with the same key is updated, and the rest of the project stays as it is, including which kinds of quest its app shows and its collections. The simulation's members, points and records stay behind. To take the campaign live, promote it from Deployments as usual.

If the campaign has a quest of a kind the project's app doesn't show, such as a quiz, publishing is refused and nothing changes. Add support for it to the app first, or take that quest out and simulate again.