Creative

​

Overview

​

Why this changed

• Each campaign sees exactly the formats its selected products require (creativeFormats.required)
• Asset uploads happen in a single multipart request with the manifest metadata
• Format and template auto-detection runs against the campaign’s product mix
• Tracking macros and brand info are resolved from the campaign + advertiser context

​

Key fields

​

Asset types

​

Lifecycle

​

Conversational creative sessions

1. Idea — the buyer describes the channel, audience, goal, and source assets.
2. Draft gallery — a creative adapter returns multiple draft variants for human review.
3. Refine — the buyer gives natural-language feedback like “make the book more prominent” or “less busy.”
4. Evaluate — draft checks are advisory; final hard/blocking checks stop finalization.
5. Finalize — the approved leaf is saved as a campaign creative manifest.

​

Asset lifecycle

• Set locked_asset: true, can_transform: false, role: "product" (or the closest role), and specific preservation_notes.
• Keep provenance separate from rights. source: "upload" or source: "dam" says where the asset came from; rights.status says whether it is cleared.
• rights.status: "unknown" is a non-blocking review warning for final approval. restricted or expired blocks finalization.
• If the source image includes studio background or whitespace, provide render_crop, subject_bounds, or a transparent cutout/mask when available. Cropping is a preservation-safe fallback; a real cutout produces cleaner final compositions.

​

Seller-specific versions

1. GET /api/v2/buyer/campaigns/:campaignId/creatives/templates shows required campaign formats and available templates.
2. Start a creative session against the best matching creative adapter and target format.
3. Finalize the chosen direction into a creative manifest.
4. Re-check creativeFormats on GET /api/v2/buyer/campaigns/:campaignId.
5. If creativeFormats.missing still contains seller formats, generate or adapt seller-specific manifests for those formats.

​

Performance loop

1. Create or update campaign goals — use performanceConfig on the campaign when optimizing toward events or metrics.
2. Launch with format coverage — execute only after required creative formats are covered.
3. Collect delivery and outcome data — use reporting plus conversion/measurement ingestion (log_event, measurement data sync, or measurement records depending on integration).
4. Compare creative performance — inspect performance by campaign, media buy, package, and creative where reporting dimensions are available.
5. Iterate — duplicate or start a new creative session from the winning direction, then refine the creative based on observed performance and seller feedback.

​

Evaluator strategy

• source assets and lock/rights metadata
• modality and renderer type
• campaign brief and brand guidance
• selected seller formats and publisher policies
• available adapter/seller evaluator capabilities
• postflight reporting and measurement data

​

Common operations

​

Create a creative manifest (multipart)

curl -X POST https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/creatives/create \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F 'metadata={
    "name": "Q2 hero video",
    "message": "30s product reveal — premium tone, 2-second hook",
    "template_id": "video_standard",
    "url_asset": { "url": "https://acme.com/promo", "url_type": "CLICKTHROUGH" },
    "assets": [
      { "filename": "hero-30s.mp4", "asset_type": "VIDEO", "label": "main_video" }
    ]
  };type=application/json' \
  -F "files=@hero-30s.mp4" \
  -F "files=@companion-banner.png"

​

List manifests

curl "https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/creativeManifest?take=50" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​

Get / update / delete

curl https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/creatives/cm_abcdef \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

curl -X PUT https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/creatives/cm_abcdef \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -F 'metadata={
    "delete_asset_ids": ["asset_old"],
    "new_assets": [{ "filename": "v2.mp4", "asset_type": "VIDEO" }]
  };type=application/json' \
  -F "files=@v2.mp4"

curl -X DELETE https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/creatives/cm_abcdef \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​

Render an ADCP preview

curl -X POST https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/creatives/cm_abcdef/preview \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​

Format coverage on the campaign

"creativeFormats": {
  "required": [{ "agent_url": "...", "id": "video_standard" }],
  "covered":  [{ "agent_url": "...", "id": "video_standard" }],
  "missing":  []
}

​

Tracking macros

• An impression tracker URL as a TRACKER_PIXEL URL asset
• A click tracker URL that wraps the original clickthrough — the original is preserved in the rurl query parameter

​

Format catalog

​

Propagation to media buys

​

Creative transport modes

• Creative library sync — sellers that advertise a creative library through creative.has_creative_library: true receive manifests through sync_creatives, and packages reference them with creative_assignments.
• Inline creative delivery — sellers that advertise creative.has_creative_library: false receive the creative manifest inline on each package that needs it.

​

Related concepts