1. Download a template
Each Excel template lists the required and optional fields for that creative type, with cell comments explaining each column and an example row you can overwrite.
- Display (image / HTML5) — POST /dsp/creatives/display/1.0
- Video (in-stream / online video) — POST /dsp/creatives/video/1.0
- Streaming TV / OTT — POST /dsp/creatives/streamingTV/1.0
- Audio (Amazon Music / 3P audio) — POST /dsp/creatives/audio/1.0
- Mobile (in-app banner / interstitial) — POST /dsp/creatives/mobile/1.0
- Third-party tag (JS/HTML) — POST /dsp/creatives/thirdPartyTag/1.0
2. Upload your filled template
DRY-RUN is on. Payloads are validated and shown but not sent to Amazon. Set DRY_RUN=false in .env and add a refresh token to go live.
3. Bulk-create DSP Audiences
Upload the audience workbook (the Audience sheet). Each row is parsed into a DSP audience, auto-named per the team convention (e.g. A-Brand-ASIN-OWN-D7-ProductPurchases) and created via POST /dsp/audiences.
Download audience template (.xlsx)
Rows whose target is a product-line name (not a B0… ASIN) are skipped — resolve them to ASIN(s) first.
DRY-RUN is on, so audiences are only validated, not created.
4. Bulk-create DSP Creatives
Upload the creative workbook. The Creative-REC, Creative-IMG and Creative视频 sheets are parsed and created via the DSP Ad Creative Management API V1. REC (Responsive eCommerce) is ASIN-driven and needs no files. IMG/Video need their image/video files uploaded here too — they're sent to the Creative Asset Library first, then referenced by the creative.
Assets are matched to rows by filename (named file, then 品线名/ASIN, then a single uploaded file).
Image asset subtype defaults to PRODUCT_IMAGE; Amazon enforces size/format and will report the exact error per row.