Documentation

Write a good brief for a product ad

In Dokiri, the brief is what you type: the product description in What it is and, if you want, one line in Angle, offer or audience (optional). The writer builds every line of the script from these two fields and the photos. Rewrites are free, but a clear brief gets it right the first time.

Where the brief goes

FieldWhat the writer does with it
Product nameNames the product in the script. Write it the way customers say it.
What it isThe source of every claim. The ads claim nothing it doesn’t say.
Price (optional)The only price the ad may state. Left empty, no price is said.
Angle, offer or audience (optional)Aims this one ad: who it speaks to, the moment, the offer, the tone.
PhotosHow the product looks in every shot, label included.

Rule 1: put every claim in the description

The writer is told never to invent what you didn’t give: no discount, deadline, review, rating, customer count, award, or health, safety or performance claim. If a selling point is missing from What it is, it is missing from the ad. And only write what you can back: the narrator will say it out loud.

Weak → better
Weak: Premium water bottle, top quality.

Better: Insulated stainless steel bottle, 750 ml. Keeps drinks cold for 24 hours and hot for 12. Leak-proof screw lid. Fits standard car cup holders.

Rule 2: write facts, not adjectives

“Amazing” and “best” give the writer nothing to show. Sizes, materials, what’s in the box and what changes for the buyer each become a shot.

Weak → better
Weak: The most comfortable dog harness ever.

Better: Padded no-pull harness. The front leash ring turns the dog sideways when it pulls. Five sizes, from 3 to 45 kg. Reflective stitching for evening walks. On and off with one buckle.

Rule 3: one angle per ad

An ad that speaks to runners, gift buyers and bargain hunters at once speaks to none of them. Give each ad one angle and make another ad for the next, or ask for 5 concepts and let the planner vary them: see batches.

Weak → better
Weak: For runners, hikers and office workers, a great gift, eco-friendly, 20% off now.

Better: For runners who train before work: still-cold water at the end of a 10 km run.

Rule 4: name the audience and the moment

A person and a moment give the writer a scene: who holds the product, where, and why now. “For everyone” gets you a generic shot on a table.

Weak → better
Weak: A lamp for everyone.

Better: For students revising late in a shared room, who can’t switch on the ceiling light without waking their roommate.

Rule 5: state the offer exactly

The narrator says the offer in your words, so write it as the customer should hear it: the amount, the condition, the end date. With no offer written, none is announced, even in the Offer format.

Weak → better
Weak: Big sale right now.

Better: 20% off every harness with the code WALK20, until Sunday midnight.

Rule 6: say what to avoid

A word your brand never uses, a setting that doesn’t fit, a claim you can’t make: say it in the angle field, then check the script on the review page. What you read is exactly what gets made.

Weak → better
Weak: (nothing)

Better: For new parents. Calm, not jokey. No crying baby on screen. Don’t say “safe” or “organic”.

A complete brief

Clip-on reading lamp
What it is:
Clip-on LED reading lamp. Clamps to a desk or bed frame up to 5 cm thick. Three warm light levels. USB-C rechargeable, about 8 hours on the lowest level. Flexible 40 cm neck.

Angle, offer or audience:
For students revising late in a shared room who can’t switch on the ceiling light. Calm tone. Open on the dark room. Don’t call it “eye-friendly”.

Then pick a format in Ad formats and check the result in Review and rewrite.

Frequently asked questions

My imported description is marketing fluff. What should I do?

Rewrite What it is on the product card before clicking Write my ad. The import copies your page’s text as it is; the free product description generator can help you draft a factual one.