Responsive Ads

Responsive ads let you configure creatives just once and automatically fit every zone size — from banner to feed, landscape to portrait — and switch copy language automatically by visitor region. It's the most efficient way to serve: no per-size image design, and no per-language campaigns.

How it works

You provide a set of "parts" — multiple headlines, descriptions, images, logos, and videos; at serve time the system automatically selects and composes the best-fit ad based on the specific zone's size and visitor context.

You upload (once)              System at serve time (automatic)
───────────────           ─────────────────────
Short / long headline   ┐
Short / long description├──►  picks suitable creative types by
Landscape/square/portrait├──►  zone size, composes, crops, and
Logo / landscape logo   ├──►  fits — then selects the copy in the
Landscape/square/portrait video ┘  visitor's language before rendering

Configure once, many creatives

When creating a responsive ad, you can upload multiple items for each creative type, and the system picks the best combination:

Creative type	Description	Ratio / min size	Required
Short headline HEADLINE_SHORT	≤ 25 chars, multiple allowed	—	✅ Required
Long headline HEADLINE_LONG	≤ 90 chars	—	Optional
Short description DESCRIPTION_SHORT	≤ 60 chars	—	✅ Required
Long description DESCRIPTION_LONG	≤ 90 chars	—	Optional
Landscape image IMAGE_LANDSCAPE	Main image	1.91:1, ≥ 600×314	✅ Required
Square image IMAGE_SQUARE	Main image	1:1, ≥ 300×300	✅ Required
Portrait image IMAGE_PORTRAIT	For portrait slots	4:5, ≥ 480×600	Optional
Logo IMAGE_LOGO	Brand mark	1:1, ≥ 128×128	Optional
Landscape logo IMAGE_LOGO_LANDSCAPE	Landscape mark	4:1, ≥ 512×128	Optional
Landscape video VIDEO_LANDSCAPE		16:9, 5–60s	Optional
Square video VIDEO_SQUARE		1:1, 5–60s	Optional
Portrait video VIDEO_PORTRAIT		9:16, 5–60s	Optional

Minimum creative requirements

A responsive ad needs at least one each of: short headline, short description, landscape image, and square image (all approved) to serve properly. The richer the creatives you provide, the more sizes the system can compose and the better it fits.

You can also set a call-to-action button (CTA) such as "Learn More", "Buy Now", "Sign Up Now", or "Download Now", plus brand name and primary/accent colors (optional adaptive palette), and separate landing pages for PC and mobile.

Multilingual copy: auto-select language by visitor region

This is a highlight of responsive ads. Besides a default text, each copy asset can carry a multilingual text map, keyed by locale identifier (e.g. zh-CN, en, ja), with the value being the text in that language. At serve time the system picks the best-matching copy based on the language inferred from the visitor's region.

Selection order (from exact to loose, first hit wins):

1. Exact match — the visitor locale matches exactly, e.g. zh-CN → use zh-CN copy.
2. Primary-language match — degrade to the primary language, e.g. zh-CN not configured but zh is → use zh.
3. Other variant of the same primary language — e.g. visitor is zh, config has zh-TW → use zh-TW.
4. Fall back to default — if none of the above hit, or the ad has no multilingual config at all, use the default text you filled in.

The default text is a safety net

As long as you fill in a default text, visitors from any region never see a blank — multilingual is just an optional overlay, and unconfigured languages fall back smoothly to the default. Matching is case-insensitive: zh-CN and zh-cn are treated as the same.

Example: a short headline defaults to English Big Sale Today, plus a multilingual map { "zh-CN": "今日大促", "ja": "本日セール" }.

Visitor's inferred language	Actual copy shown	Rule hit
zh-CN	今日大促	Exact match
zh-TW	今日大促	Primary-language zh variant match
ja	本日セール	Exact match
fr / other	Big Sale Today	Fall back to default

Default assets to avoid broken layouts

Because the system dynamically composes creatives to fit unknown sizes, the more complete your assets, the less likely you'll see "broken" or missing layouts:

• At minimum provide landscape + square main images, covering the most common horizontal and square slots; add a portrait image when possible.
• Add a logo so brand can be shown decently even in slots that only fit a small image or plain text.
• Prepare both long and short copy, and the system picks the right length by available space, avoiding truncation or empty gaps.

Once configured, link the responsive ad to a specific ad to serve; after the responsive ad is approved, ads referencing it inherit its approved status.

Trade-offs vs. regular ads

	Responsive ads	Per-size creatives
Config cost	Low (configure once)	High (one per size)
Size coverage	Auto-fits every size	Only the sizes you made
Multilingual	Built-in, auto-switch by region	Build separate ads per language
Pixel-level control of a single creative	Weaker (system composes)	Strong (pixel-level control)

Choose responsive for coverage and efficiency; for pixel-level control of a single creative, keep using regular ads + the media library.