Histórico de Alterações da API

​

Removido

• /public/v1/campaign-service/estimated-clicks foi removido após 1 ano de descontinuação. Não recebeu tráfego por 7 meses.

​

Adicionado

• Endpoint /public/v1/offsite-ads/audiences/user-list para gerenciar públicos de lista de usuários em anúncios fora do site.

​

Alterado

• /v2/auctions: Campo filter adicionado com esquema AttributesFilter para filtragem de atributos de produto (suporta operadores and/or com array de atributos).

​

Alterado

• /v2/auctions: Objeto page adicionado às solicitações de leilão de listagens patrocinadas e banners.
• /v2/auctions/sponsored-brand: Campo opcional page adicionado à solicitação.

​

Adicionado

• Endpoints /public/v1/campaign-service/campaigns/exclusive-banner (POST) e /public/v1/campaign-service/campaigns/exclusive-banner/{campaign-id} (GET, PATCH) para gerenciamento de campanhas de banner exclusivo.
• Endpoints /public/v1/campaign-service/campaigns/exclusive-listing (POST) e /public/v1/campaign-service/campaigns/exclusive-listing/{campaign-id} (GET, PATCH) para gerenciamento de campanhas de listagem exclusiva.
• Endpoint /public/v1/media-service/slots/{slot-id} com métodos DELETE e PATCH para gerenciamento individual de slot.
• Método POST adicionado a /public/v1/offsite-ads/audiences para criar trabalhos de público.

​

Adicionado

• Endpoints /public/v1/campaign-service/json-templates (GET, POST) e /public/v1/campaign-service/json-templates/{json-template-id} (GET, PATCH) para gerenciar modelos JSON de campanha.
• Endpoint /public/v1/media-service/slots (GET, POST) para listar e criar slots de mídia.
• Endpoint /public/v1/media-service/slots/{slot-id}/fallback (DELETE) para configurar comportamento de fallback do slot.
• Endpoint /public/v1/offsite-ads/audiences (GET) para listar públicos em anúncios fora do site.
• Método DELETE adicionado a /public/v1/campaign-service/campaigns/{campaign-id}/bids para excluir todos os lances.

​

Adicionado

• Endpoint /public/v1/toppie/reporting/file-reports/daily-kpis-by-product (GET) para exportar KPIs diários por produto.
• Endpoint /public/v1/campaign-service/campaigns/{campaign-id}/products (GET, PUT) para gerenciar produtos dentro de uma campanha.
• Endpoints públicos de API de anúncios fora do site em /public/v1/offsite-ads

​

Adicionado

• Endpoints /public/v1/toptimize/forecasting/campaign (POST), /public/v1/toptimize/forecasting/inventory (POST) e /public/v1/toptimize/forecasting/marketplace (GET) para previsão de campanha e inventário.

​

Adicionado

• Endpoints beta de Anúncios Fora do Site (/v2/offsite-ads/)
• Endpoint beta /toptimize/v1/predictions para previsões de CTR/CVR.
• Endpoint beta /toptimize/v1/retrieval para recuperação de objetos.
• Endpoint /public/v1/segment-service/segments/{segment-id}/upload (POST) para upload de dados de segmento.
• Endpoints /public/v1/campaign-service/campaigns/{campaign-id}/restrictions (GET, POST) e /public/v1/campaign-service/campaigns/{campaign-id}/restrictions/{restriction-id} (PATCH) para gerenciamento de restrições de campanha.
• Endpoints /public/v1/campaign-service/restriction-types (GET) e /public/v1/campaign-service/restriction-types/{restriction-type-id} (GET) para gerenciar definições de tipos de restrição.
• Endpoint /public/v1/reporting-service/file-reports/scored-attribution (GET) para relatórios de arquivo de atribuição pontuada.
• Endpoint /public/v1/reporting-service/file-reports/interactions (GET) para exportar dados de interação.
• Método DELETE adicionado a /public/v1/toppie/campaigns/{campaign-id} para excluir campanhas.

​

Alterado

• Eventos: Referências ausentes adicionadas para exibir novo objeto pageview.
• /v2/events: Campos opcionais deviceType e channel adicionados para impressões, cliques, compras e pageviews.

​

Adicionado

• Endpoint beta /toptimize/v1/rank para classificar objetos.
• Endpoints /public/v1/segment-service/segments (GET, PUT) e /public/v1/segment-service/segments/{segment-id} (DELETE) para gerenciamento de segmentos.
• Endpoint /public/v1/segment-service/segments/{segment-id}/signed-url (GET) para obter URLs assinadas para uploads de segmento.
• Endpoint /public/v1/toppie/products (GET) para listar produtos de fornecedor no Toppie.
• Endpoint /public/v1/reporting-service/interactions (GET) para consultar dados de interação.
• Endpoint /public/v1/toppie/account/balance (GET) para visualizar saldo da conta.
• Endpoint /public/v1/toppie/account/topups (GET) para visualizar recargas da conta.
• Endpoint /public/v1/billing-service/campaign-billing-contact (GET, PUT).
• Endpoints /public/v1/billing-service/billing-contacts (GET) e /public/v1/billing-service/billing-contacts/{billing-contact-id} (GET, PUT) para gerenciamento de contato de faturamento em nível de marketplace.
• Endpoints /public/v1/billing-service/vendor-billing-contact (PUT) e /public/v1/billing-service/vendors/{external-vendor-id}/vendor-billing-contact/{billing-contact-id} (DELETE) para contatos de faturamento em nível de fornecedor.
• Método PATCH adicionado a /public/v1/toppie/campaigns/{campaign-id} para atualizar campanhas.

​

Alterado

• /v2/auctions/sponsored-brand: Campos opcionais opaqueUserId e vendorId adicionados.
• Eventos: Exemplo de rastreamento de posicionamento adicionado para análise de carrossel.
• /v2/auctions/travel: Estendido para suportar voos além de hotéis.

​

Adicionado

• Endpoints /public/v1/toppie/campaigns (GET, POST) e /public/v1/toppie/campaigns/{campaign-id} (GET) para gerenciamento de campanhas Toppie.
• Endpoint /public/v1/toppie/campaigns/{campaign-id}/bids (GET) para gerenciar lances de campanha.
• Endpoints de relatórios Toppie (/public/v1/toppie/reporting)
• Endpoints /public/v1/billing-service/vendors/{external-vendor-id}/wallets (GET, POST) e /public/v1/billing-service/vendors/{external-vendor-id}/wallets/{wallet-id}/adjust (POST) para gerenciamento de carteira de fornecedor.
• Método PATCH adicionado a /public/v1/catalog-search-service/catalogs/products para atualizar produtos.

​

Alterado

• Eventos: Documentado que atribuição halo requer vendorId.

​

Adicionado

• Endpoint /v2/auctions/travel para leilões de viagens de hotel.
• Endpoint beta /v2/events/beta/link-users para vincular contas de usuário.
• Endpoints /public/v1/reporting-service/marketplace/campaigns-kpis (GET) e /public/v1/reporting-service/marketplace/vendors-kpis (GET) para relatórios de KPI em nível de marketplace.