Crear mi primera campaña
Menú de la documentación
POST/api/v1/exports

Exportaciones

Arma los paquetes .zip para una plataforma de anuncios, sigue su estado y descárgalos verificando el sha-256.

Una exportación empaqueta las piezas de una campaña en HTML5 con clickTag, listas para subir a la plataforma que elijas. Requiere el permiso export y acepta Idempotency-Key. Lo aprobado es lo exportado: si el workspace exige aprobación y faltan piezas por aprobar, la respuesta es 409 y no se exporta nada.

Crear una exportación

CampoRequisitoDescripción
campaignIdstring
Obligatorio
La campaña a exportar.
creativeIdsstring[]
Opcional
De 1 a 50 conceptos. Si falta, todos los de la campaña.
sizesstring[]
Opcional
Si falta, los de la campaña.
localesstring[]
Opcional
Si falta, los de la campaña.
packagingstring
Opcional
per_piece (un .zip por pieza, por defecto), per_size (uno por tamaño) o single (uno solo).
profileIdstring
Opcional
Perfil de la plataforma: generic, google-ads, cm360, dv360, amazon-dsp, ttd, adform, flashtalking. Si falta, el de la campaña.
clickUrlstring
Opcional
URL de destino del clickTag; debe empezar con http:// o https://.
validateWeightboolean
Opcional
Valida el peso contra el límite del perfil.

Responde 202 con exports (uno por concepto: id, status, statusUrl y downloadUrl) y unapproved, las piezas sin aprobar. La exportación es un trabajo más: cuando termine recibirás el webhook export.ready (o export.failed).

Estado y piezas

GET /api/v1/exports/:id devuelve el status (queued, running, ready, warnings, failed o expired), el perfil, el peso en bytes, el artifactSha256 del .zip, las piezas con su peso y advertencias (items) y las comprobaciones del validador (checks). GET /api/v1/exports las lista, con campaignId opcional y paginación por cursor.

Descargar el .zip

GET /api/v1/exports/:id/download devuelve el paquete (application/zip) con el encabezado X-Content-SHA256: calcula el sha-256 de lo que descargaste y compáralo. Si la exportación aún no está lista responde 409; si ya venció, 410 (expired).

Nota. Hoy BannerMotion arma el paquete para cada plataforma, pero no lo sube por ti: el envío directo a un ad server está en desarrollo.
¿Te sirvió esta página?