Concorrência no catálogo
Conteúdos
→Receber notificações de publicações competindo no catálogo
→Conhecer o preço para ganhar
↳Conhecer a publicação que está ganhando um produto
↳Listagem de publicações para um produto
Receber notificações de publicações competindo no catálogo
Com o tópico Item competition você pode se inscrever e receber notificações das mudanças de status dos itens do catálogo, e permitirá que você reconheça o item que modifica seu status de competição para vencedor ou vice-versa. Para visualizar as informações do concorrente e analisar as condições sob as quais o vendedor está competindo para ganhar a página do produto, utilize o recurso /price_to_win para saber quais ações tomar.
Conhecer o preço para ganhar
Com o recurso /price_to_win?SiteId=$SITE_ID&version=v2 você reconhece o status da publicação do catálogo: pode estar ganhando, compartilhando primeiro, perdendo ou listado. O último significa que você tem motivos pelos quais o posto não está concorrendo.
Você também pode construir uma tabela de competição para comparar as condições dos itens e melhorá-los com base na competição. Com essa funcionalidade em seu desenvolvimento, os vendedores saberão quais condições melhorar para ganhar a página do produto.
Exemplo de item perdendo
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/price_to_win?siteId=$SITE_ID&version=v2curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456789/price_to_win?siteId=MLA&version=v2Resposta:
{
"item_id": "MLA901414479",
"current_price": 12999,
"currency_id": "ARS",
"price_to_win": 11500,
"boosts": [
{
"id": "same_day_shipping",
"status": "boosted",
"description": "Envíos en el día por Mercado Envíos"
},
{
"id": "fulfillment",
"status": "opportunity",
"description": "Mercado Envíos Full"
},
{
"id": "free_installments",
"status": "opportunity",
"description": "Cuotas sin interés"
},
{
"id": "free_shipping",
"status": "not_apply",
"description": "Envíos gratis por Mercado Envíos"
},
{
"id": "shipping_collect",
"status": "boosted",
"description": "Mercado Envíos Colecta"
}
],
"status": "competing",
"competitors_sharing_first_place": "null",
"visit_share": "minimum",
"consistent": true,
"reason": [],
"catalog_product_id": "MLA16107499",
"winner": {
"item_id": "MLA884484295",
"price": 13499,
"currency_id": "ARS",
"boosts": [
{
"id": "same_day_shipping",
"status": "boosted",
"description": "Envíos en el día por Mercado Envíos"
},
{
"id": "fulfillment",
"status": "opportunity",
"description": "Mercado Envíos Full"
},
{
"id": "free_installments",
"status": "boosted",
"description": "Cuotas sin interés"
},
{
"id": "free_shipping",
"status": "not_apply",
"description": "Envíos gratis por Mercado Envíos"
},
{
"id": "shipping_collect",
"status": "boosted",
"description": "Mercado Envíos Colecta"
}
]
}
}Exemplo de item ganhando
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/price_to_win?siteId=$SITE_ID&version=v2Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456789/price_to_win?siteId=MLA&version=v2Resposta:
{
"item_id": "MLA884484295",
"current_price": 13499,
"currency_id": "ARS",
"price_to_win": 13499,
"boosts": [
{
"id": "same_day_shipping",
"status": "boosted",
"description": "Envíos en el día por Mercado Envíos"
},
{
"id": "fulfillment",
"status": "opportunity",
"description": "Mercado Envíos Full"
},
{
"id": "free_installments",
"status": "boosted",
"description": "Cuotas sin interés"
},
{
"id": "free_shipping",
"status": "not_apply",
"description": "Envíos gratis por Mercado Envíos"
},
{
"id": "shipping_collect",
"status": "boosted",
"description": "Mercado Envíos Colecta"
}
],
"status": "winning",
"competitors_sharing_first_place": "0",
"visit_share": "maximum",
"consistent": true,
"reason": [],
"catalog_product_id": "MLA16107499",
"winner": {
"item_id": "MLA884484295",
"price": 13499,
"currency_id": "ARS",
"boosts": [
{
"id": "same_day_shipping",
"status": "boosted",
"description": "Envíos en el día por Mercado Envíos"
},
{
"id": "fulfillment",
"status": "opportunity",
"description": "Mercado Envíos Full"
},
{
"id": "free_installments",
"status": "boosted",
"description": "Cuotas sin interés"
},
{
"id": "free_shipping",
"status": "not_apply",
"description": "Envíos gratis por Mercado Envíos"
},
{
"id": "shipping_collect",
"status": "boosted",
"description": "Mercado Envíos Colecta"
}
]
}
}Exemplo de item compartilhando primeiro
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456710/price_to_win?siteId=MLA&version=v2Resposta:
{
"item_id": "MLA901414479",
"current_price": 12999,
"currency_id": "ARS",
"price_to_win": 11500,
"boosts": [
{
"id": "same_day_shipping",
"status": "boosted",
"description": "Envíos en el día por Mercado Envíos"
},
{
"id": "fulfillment",
"status": "opportunity",
"description": "Mercado Envíos Full"
},
{
"id": "free_installments",
"status": "opportunity",
"description": "Cuotas sin interés"
},
{
"id": "free_shipping",
"status": "not_apply",
"description": "Envíos gratis por Mercado Envíos"
},
{
"id": "shipping_collect",
"status": "boosted",
"description": "Mercado Envíos Colecta"
}
],
"status": "sharing_first_place",
"competitors_sharing_first_place": "2",
"visit_share": "medium",
"consistent": true,
"reason": [],
"catalog_product_id": "MLA16107499",
"winner": {
"item_id": "MLA884484295",
"price": 13499,
"currency_id": "ARS",
"boosts": [
{
"id": "same_day_shipping",
"status": "boosted",
"description": "Envíos en el día por Mercado Envíos"
},
{
"id": "fulfillment",
"status": "opportunity",
"description": "Mercado Envíos Full"
},
{
"id": "free_installments",
"status": "boosted",
"description": "Cuotas sin interés"
},
{
"id": "free_shipping",
"status": "not_apply",
"description": "Envíos gratis por Mercado Envíos"
},
{
"id": "shipping_collect",
"status": "boosted",
"description": "Mercado Envíos Colecta"
}
]
}
}Exemplo de item que não concorre
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456710/price_to_win?siteId=MLA&version=v2Resposta:
{
"item_id":"MLA123456710",
"current_price":68000,
"currency_id":"ARS",
"price_to_win":null,
"boosts":{
"same_day_shipping":false,
"fulfillment":false,
"free_installments":false,
"free_shipping":true,
"cross_docking":false,
"drop_off":true,
"shipping_quarantine":false
},
"status":"listed",
"competitors_sharing_first_place": null,
"visit_share": "minimum",
"reason":[
"item_paused"
]
}Campos da resposta
price_to_win: preço (na moeda atual da publicação) para ser o ganhador. Isto é que, fazendo um PUT ao recurso /itens com o preço sugerido, você garante ser o ganhador.
boosts: características da publicação que proporcionam chances de ganhar, tais como:
- same_day_shipping: Envios no dia com Mercado Envios.
- fulfillment: Mercado Envios Full.
- free_installments: Parcelamento sem juros.
- free_shipping: Frete grátis com Mercado Envios.
- shipping_quarantine: Envio normal.
- shipping_collect: Mercado Envios Coleta.
- Winning: Será 0, pois ser o vencedor leva todas as vendas e visibilidade no catálogo.
- Competing: será null, já que ao perder tem que melhorar as condições para compartilhar o primeiro lugar ou ganhar.
- Listed: será null, já que ao perder tem que melhorar as condições para compartilhar o primeiro lugar ou ganhar.
- Sharing_first_place: número de vendedores competindo pelo primeiro lugar.
- Winning: Sempre será maximum.
- Competing: Sempre será minimum.
- Sharing_first_place: Sempre será medium.
Agora, você pode reconhecer dentro do impulso o estado deles e desenhar uma tabela de comparação de acordo.
| Estado dos boost | Detalhe |
|---|---|
| boosted | tem a condição de venda e atualmente aplica o aumento. |
| not_boosted | possui a condição de venda, mas não é um boost que aumenta as chances de ganhar. |
| opportunity | não possui condição de venda. Caso aplique, melhoraria as chances de ganhar. |
| not_apply | a condição de vendas não se aplica como um boost ao produto em que o item concorre. |
status indica se o produto está ganhando para o público em geral ou para segmentos minoritários, como aqueles que não aproveitam o frete diário. Quando está ganhando, o valor está ganhando, caso contrário estará competindo por quem está perdendo e um novo valor é adicionado sharing_first_place para quando o primeiro lugar é compartilhado e eles são divididos entre todos aqueles que compartilhe o primeiro lugar em Com base em suas condições, os níveis de visibilidade na página do produto.
competitors_sharing_first_place indica o número de vendedores que compartilham o primeiro lugar. Também vai depender dos estados:
visit_share: nível de visibilidade da publicação do catálogo. Os valores podem variar dependendo dos estados:
reason: razão pela qual o item não está competindo. Os valores possíveis são:
| Reason | Descrição |
|---|---|
| non_trusted_seller | O vendedor não está na lista de permissões de fraude. Não pode competir. Ele aparece nas listagens em segundo plano. |
| reputation_below_threshold | O vendedor não atinge a reputação mínima para ganhar. Não pode competir. Aparece apenas nas listagens. |
| winner_has_better_reputation | O vendedor tem uma reputação que pode competir, mas há um vencedor com uma reputação melhor. No momento, ele aparece apenas nas listagens (caixa amarela com vencedor verde). |
| manufacturing_time | O item possui manufacturing time, aparece apenas nas listagens e não pode vencer porque o vencedor possui estoque imediato. |
| temporarily_winning_manufacturing_time | O item possui manufacturing time, está ganhando temporariamente porque não há concorrentes no mesmo nível de reputação sem MF. |
| temporarily_competing_manufacturing_time | O item tiene manufacturing time, esta compitiendo temporalmente porque no hay competidores en el mismo nivel de reputación sin MF, el winner también tiene MF. |
| temporarily_winning_best_reputation_available | O vendedor não é verde, mas tem uma reputação que pode ganhar e é a melhor oferta disponível. Ele está ganhando temporariamente. Se uma oferta melhor aparecer, pare de ganhar. |
| temporarily_competing_best_reputation_available | O vendedor não é verde, mas é a melhor reputação disponível, está competindo temporariamente. O vencedor também é da mesma reputação. Se um best-seller aparecer, ele será listado apenas novamente. |
| item_paused | O item está em pausa, não pode ser listado. |
| item_not_opted_in | O item não fiz opt in, não pode ser listado ou é um item de teste. |
Neste chamado, você deverá utilizar um item_id de uma publicação de catálogo, no caso de não poder fazê-lo, você obterá um código de erro 4XX.
Além disso, existem variáveis como a reputação, que são utilizadas para determinar o ganhador. Contudo, para um bom vendedor, as variáveis acima serão as utilizadas para determinar o ganhador.
Conheçer a publicação que está ganhando um produto
Usando o recurso de /products/{product_id} , além de conhecer as características e o status do produto, você pode reconhecer a publicação que está ganhando a página do produto com o campo buy_box_winner.
Listagem de publicações para um produto
Se você precisar conhecer quais são os itens (de todos os vendedores) que concorrem pelas vendas de um produto em particular, tem um recurso que entrega a você essas informações.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/$PRODUCT_ID/itemsExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/MLB6309815/itemsResposta simplificada:
{
"paging": {
"total": 7,
"offset": 0,
"limit": 100
},
"results": [
{
"item_id": "MLA824759321",
"category_id": "MLA1055",
"seller_id": 90205574,
"price": 13999,
"currency_id": "ARS",
"sold_quantity": 0,
"available_quantity": 1,
"installments": {
"quantity": 1,
"amount": 13999,
"rate": 0,
"currency_id": "ARS"
},
"shipping": {
"mode": "me2",
"tags": [
"mandatory_free_shipping"
],
"free_shipping": true,
"logistic_type": "fulfillment",
"store_pick_up": false
},
"warranty": "Garantía de fábrica: 1 años",
"condition": "new",
"sale_terms": [
{
"id": "INVOICE",
"name": "Facturación",
"value_id": "6891885",
"value_name": "Factura A",
"value_struct": null
},
{
"id": "WARRANTY_TYPE",
"name": "Tipo de garantía",
"value_id": "2230279",
"value_name": "Garantía de fábrica",
"value_struct": null
},
{
"id": "WARRANTY_TIME",
"name": "Tiempo de garantía",
"value_id": null,
"value_name": "1 años",
"value_struct": {
"number": 1,
"unit": "años"
}
}
],
"official_store_id": null,
"original_price": null,
"listing_type_id": "gold_special",
"accepts_mercadopago": true,
"seller_address": {
"city": {
"id": "TUxBQ0xBWmI3M2Q3",
"name": "Santa Fe"
},
"state": {
"id": "TUxBUFNBTmU5Nzk2",
"name": "Santa Fe"
},
"neighborhood": {
"id": "TUxBQk9UUjQyMjJa",
"name": "Otros Barrios"
}
},
"international_delivery_mode": "none",
"tags": [
"extended_warranty_eligible",
"good_quality_picture",
"good_quality_thumbnail",
"immediate_payment",
"cart_eligible"
],
"tier": ""
},
{},
{},
{},
{},
{},
{}
]
}Tenha em conta que em "results" terá os itens que estão competindo para ganhar esse produto.
Filtro
available_filters como parâmetro na URI é possível.Atualmente, você tem as seguintes opções de filtragem:
| Parâmetro | Valor | Descrição |
|---|---|---|
| official_store | all | Para mostrar apenas produtos com vencedor de Lojas Oficiais. |
| official_store_id | id | Para mostrar os produtos vencedores de uma loja oficial. |
| discount | 10-100 | Para mostrar os produtos vencedores com desconto maior ou igual a 10%. |
| price | 100-200 | Para produtos vencedores com preço entre 100 e 200. *100 para produtos com vencedor com preço maior ou igual a 100. *200 para produtos com vencedor com preço menor ou igual a 200. |
| installments | no_interest | Para produtos com vencedor com parcelamentos sem juros. |
| shipping | fulfillment | Para produtos com vencedor com FBM. |
| shipping | mercadoenvios | Para produtos com vencedor sem FBM. |
| shipping_cost | free | Para produtos con vencedor com frete grátis. |
| shipping_time | sameday/ nextday | Deve ser usado junto com a query param b.buyer_zones, que indica em quais áreas o comprador está localizado. |
| seller_id | id | Obter o vencedor user_id |
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/MLB6309815/items?shipping=freeSeguinte: Destaque especial "Recomendado".
