Aplicação de Destaque em Anúncios
Com o passar do tempo, um anúncio publicado no portal descerá algumas posições, seguindo uma ordenação natural de inserções. Para que o anúncio volte ao topo, oferecemos os destaques que são benefícios para que o anúncio ganhe mais visibilidade no Eu Preciso. Assim, seus anúncios podem voltar aos primeiros resultados como se fosse um anúncio novo e de forma destacada.
A requisição feita para esta URL deve conter o access_token de cada anunciante nos headers, usando o método POST.
Se o anunciante possui os Recursos PRO ativos e o destaque for aplicado, a requisição retorna um status code 200 e um JSON no corpo da resposta com a estrutura abaixo.
A URL usada para fazer a requisição do arquivo JSON é https://apps.eupreciso.com.br/v1.0/marketplace/ads/bump/{ad_id}, método POST.
Retorno de sucesso esperado
| Parâmetro | Valores | Obrigatório | Descrição |
|---|---|---|---|
sku | string | Sim | SKU do anúncio no integrador/anunciante |
id | string | Não | Identificador do anúncio no Eu Preciso. |
date | string (ISO Datetime) | Sim | Data do bump. |
value | integer | Não | Valor pago pelo destaque. |
days | integer | Não | Dias contratados do destaque. |
last_bumps | arrayOf[string (ISO Datetime)] | Não | Últimas datas que o anúncio foi ao topo. |
Mesmo se um destaque estiver ativo, o sistema aceitará a solicitação e adicionará mais 7 dias ao destaque vigente.
Retorno de erro esperado
Caso ocorra algum erro ou o anunciante não possua os Recursos PRO ativo, a consulta retorna um status code > 400 e um JSON com o motivo e a mensagem do erro.
Códigos e motivos de erros da requisição retornados
| Status Code | Descrição | Motivo | Mensagem |
|---|---|---|---|
| 400 | Falta campo de authorization no header da requisição | BAD_REQUEST | Check the header field(s) |
| 401 | Token inválido | ACCESS_DENIED | Check the client authentication token |
| 403 | Cliente não tem saldo disponível para aplicar o destaque | FORBIDDEN | { "reason": "FORBIDDEN", "message": "Insufficient balance." } |
| 404 | Anúncio não encontrado | NOT_FOUND | { "reason": "NOT_FOUND", "message": "Ad not found." } |
| 429 | Rate Limit configurado quando o cliente fizer mais requisições por segundo do que deveria | RATE_LIMIT | You have exceeded the X requests in X seconds limit! |
| 500 | Erro interno inesperado | UNEXPECTED_INTERNAL_ERROR | Unexpected internal error. Try again later |
Exemplos de Retorno
Ao aplicar destaque, o anúncio terá sua visibilidade aumentada indo para o topo da listagem de anúncios no período de 7 dias.
Request
curl --location --request POST 'https://apps.eupreciso.com.br/v1.0/marketplace/ads/bump/6712a764c37c38e9039093e4' \
--header 'Authorization: Bearer 5/4PXLrAv2gLZ6dqokH6xB' \
--header 'Content-Type: application/json' \Response
{
"status": "accepted",
"bump_applied": {
"sku": "CAMISETA_P",
"id": "6712a764c37c38e9039093e4",
"date": "2024-10-18T18:22:28.307+00:00",
"value": 5,
"days": 7,
"lastBumps": [
{ "date": "2024-07-15 00:00:00.00000", "value": 5, "days": 7 }
]
}
}