Registro de Cambios de la API

​

Eliminado

• /public/v1/campaign-service/estimated-clicks fue eliminado después de 1 año de desaprobación. No ha recibido tráfico durante 7 meses.

​

Agregado

• Endpoint /public/v1/offsite-ads/audiences/user-list para gestionar audiencias de lista de usuarios en anuncios offsite.

​

Cambiado

• /v2/auctions: Se agregó el campo filter con esquema AttributesFilter para filtrado de atributos de productos (soporta operadores and/or con array de atributos).

​

Cambiado

• /v2/auctions: Se agregó el objeto page a las solicitudes de subastas de listings patrocinados y banners.
• /v2/auctions/sponsored-brand: Se agregó el campo opcional page a la solicitud.

​

Agregado

• Endpoints /public/v1/campaign-service/campaigns/exclusive-banner (POST) y /public/v1/campaign-service/campaigns/exclusive-banner/{campaign-id} (GET, PATCH) para gestión de campañas de banners exclusivos.
• Endpoints /public/v1/campaign-service/campaigns/exclusive-listing (POST) y /public/v1/campaign-service/campaigns/exclusive-listing/{campaign-id} (GET, PATCH) para gestión de campañas de listings exclusivos.
• Endpoint /public/v1/media-service/slots/{slot-id} con métodos DELETE y PATCH para gestión de slots individuales.
• Método POST agregado a /public/v1/offsite-ads/audiences para crear trabajos de audiencia.

​

Agregado

• Endpoints /public/v1/campaign-service/json-templates (GET, POST) y /public/v1/campaign-service/json-templates/{json-template-id} (GET, PATCH) para gestionar plantillas JSON de campañas.
• Endpoint /public/v1/media-service/slots (GET, POST) para listar y crear slots de medios.
• Endpoint /public/v1/media-service/slots/{slot-id}/fallback (DELETE) para configurar el comportamiento de respaldo del slot.
• Endpoint /public/v1/offsite-ads/audiences (GET) para listar audiencias en anuncios offsite.
• Método DELETE agregado a /public/v1/campaign-service/campaigns/{campaign-id}/bids para eliminar todas las pujas.

​

Agregado

• Endpoint /public/v1/toppie/reporting/file-reports/daily-kpis-by-product (GET) para exportar KPIs diarios por producto.
• Endpoint /public/v1/campaign-service/campaigns/{campaign-id}/products (GET, PUT) para gestionar productos dentro de una campaña.
• Endpoints públicos de API de anuncios offsite bajo /public/v1/offsite-ads

​

Agregado

• Endpoints /public/v1/toptimize/forecasting/campaign (POST), /public/v1/toptimize/forecasting/inventory (POST) y /public/v1/toptimize/forecasting/marketplace (GET) para pronóstico de campañas e inventario.

​

Agregado

• Endpoints beta de Offsite Ads (/v2/offsite-ads/)
• Endpoint beta /toptimize/v1/predictions para predicciones de CTR/CVR.
• Endpoint beta /toptimize/v1/retrieval para recuperación de objetos.
• Endpoint /public/v1/segment-service/segments/{segment-id}/upload (POST) para cargar datos de segmentos.
• Endpoints /public/v1/campaign-service/campaigns/{campaign-id}/restrictions (GET, POST) y /public/v1/campaign-service/campaigns/{campaign-id}/restrictions/{restriction-id} (PATCH) para gestión de restricciones de campañas.
• Endpoints /public/v1/campaign-service/restriction-types (GET) y /public/v1/campaign-service/restriction-types/{restriction-type-id} (GET) para gestionar definiciones de tipos de restricción.
• Endpoint /public/v1/reporting-service/file-reports/scored-attribution (GET) para reportes de archivos de atribución ponderada.
• Endpoint /public/v1/reporting-service/file-reports/interactions (GET) para exportar datos de interacciones.
• Método DELETE agregado a /public/v1/toppie/campaigns/{campaign-id} para eliminar campañas.

​

Cambiado

• Events: Se agregaron referencias faltantes para mostrar el nuevo objeto pageview.
• /v2/events: Se agregaron campos opcionales deviceType y channel para impresiones, clics, compras y pageviews.

​

Agregado

• Endpoint beta /toptimize/v1/rank para clasificar objetos.
• Endpoints /public/v1/segment-service/segments (GET, PUT) y /public/v1/segment-service/segments/{segment-id} (DELETE) para gestión de segmentos.
• Endpoint /public/v1/segment-service/segments/{segment-id}/signed-url (GET) para obtener URLs firmadas para cargas de segmentos.
• Endpoint /public/v1/toppie/products (GET) para listar productos de vendedores en Toppie.
• Endpoint /public/v1/reporting-service/interactions (GET) para consultar datos de interacciones.
• Endpoint /public/v1/toppie/account/balance (GET) para ver el saldo de la cuenta.
• Endpoint /public/v1/toppie/account/topups (GET) para ver las recargas de la cuenta.
• Endpoint /public/v1/billing-service/campaign-billing-contact (GET, PUT).
• Endpoints /public/v1/billing-service/billing-contacts (GET) y /public/v1/billing-service/billing-contacts/{billing-contact-id} (GET, PUT) para gestión de contactos de facturación a nivel de mercado.
• Endpoints /public/v1/billing-service/vendor-billing-contact (PUT) y /public/v1/billing-service/vendors/{external-vendor-id}/vendor-billing-contact/{billing-contact-id} (DELETE) para contactos de facturación a nivel de vendedor.
• Método PATCH agregado a /public/v1/toppie/campaigns/{campaign-id} para actualizar campañas.

​

Cambiado

• /v2/auctions/sponsored-brand: Se agregaron campos opcionales opaqueUserId y vendorId.
• Events: Se agregó ejemplo de seguimiento de ubicación para análisis de carrusel.
• /v2/auctions/travel: Extendido para soportar vuelos además de hoteles.

​

Agregado

• Endpoints /public/v1/toppie/campaigns (GET, POST) y /public/v1/toppie/campaigns/{campaign-id} (GET) para gestión de campañas de Toppie.
• Endpoint /public/v1/toppie/campaigns/{campaign-id}/bids (GET) para gestionar pujas de campañas.
• Endpoints de reportes de Toppie (/public/v1/toppie/reporting)
• Endpoints /public/v1/billing-service/vendors/{external-vendor-id}/wallets (GET, POST) y /public/v1/billing-service/vendors/{external-vendor-id}/wallets/{wallet-id}/adjust (POST) para gestión de billeteras de vendedores.
• Método PATCH agregado a /public/v1/catalog-search-service/catalogs/products para actualizar productos.

​

Cambiado

• Events: Se documentó que la atribución halo requiere vendorId.

​

Agregado

• Endpoint /v2/auctions/travel para subastas de viajes de hoteles.
• Endpoint beta /v2/events/beta/link-users para vincular cuentas de usuario.
• Endpoints /public/v1/reporting-service/marketplace/campaigns-kpis (GET) y /public/v1/reporting-service/marketplace/vendors-kpis (GET) para reportes de KPIs a nivel de mercado.