feat: add assets_optional field for better asset discovery #361
+209
−21
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Add
assets_optionalfield to format schema for better asset discoveryProblem
Currently, buyers and AI agents have no way to discover what optional assets a creative format supports. The
assets_requiredarray only tells them the minimum assets needed for a valid creative, but formats often support additional assets that can enhance the creative experience:Without a way to advertise these capabilities, AI agents building creatives miss opportunities to create richer experiences, and buyers don't know what assets they could provide.
Solution
Add a new
assets_optionalfield to the format schema with the same structure asassets_required. This enables:Example
Changes
assets_optionaltoformat.json(same structure asassets_required)assets_optionalin format API responsesMigration
Non-breaking change. Existing formats without
assets_optionalcontinue to work unchanged. Consumers can adopt at their own pace.