- query
- O URL da CDW que submeteu. Numa execução de categoria é o mesmo valor em cada linha que essa categoria produziu, que é o que permite distinguir uma prateleira de outra numa exportação combinada. Guarde-o: com uma abertura em leque, é a única coisa que agrupa as linhas.
- sku_code
- A referência da própria CDW. Preenchida nas 24 linhas da nossa execução de categoria. É também o último segmento de
product_url e o identificador dentro do URL da imagem, por isso os três concordam e pode verificar uma linha contra si própria. - product_url
- A página de produto canónica. Numa execução de categoria é o produto próprio da linha - 24 linhas, 24 valores distintos - e é isso que torna a abertura útil em vez de apenas longa.
- name
- O título do produto tal como a listagem o indica. Conte com fraseado de revendedor com a configuração escrita: processador, memória e armazenamento tendem a fazer parte do nome e não de campos separados.
- description
- Destinada a levar o texto longo do produto. Vazia nas 24 linhas. Uma listagem de categoria não imprime um; uma página de produto talvez sim.
- parsed_price
- O preço como número puro. Preenchido nas 24 linhas. É o que se usa para calcular - e a nota abaixo explica porque existe sequer, dado que a página não o serve.
- price
- O mesmo preço tal como apresentado, com símbolo e separador de milhares. Use-o quando precisar de mostrar exactamente o que a CDW mostrava; use
parsed_price para a aritmética. - currency
- A moeda em que o preço está expresso. Preenchida nas 24 linhas. Leia-a em vez de a assumir - uma revendedora com lojas internacionais nem sempre responde na mesma.
- availability
- Destinada a levar o estado de stock. Vazia nas 24 linhas. Trate a ausência como «a listagem não publica um» e não como «o produto está indisponível».
- rating
- Destinada a levar uma classificação média. Vazia nas 24 linhas. Uma listagem de revendedor dirigida a compradores profissionais em geral não traz classificações de consumo.
- reviews
- Destinada a levar o número de avaliações, com a mesma ressalva de
rating. Vazia nas 24 linhas. - images
- Todas as imagens que a listagem traz. Preenchida nas 24 linhas. Vale a pena saber: o URL da imagem inclui uma predefinição de renderização, e essa predefinição diferia entre a nossa execução de categoria e a de produto - o mesmo produto, dois tamanhos de imagem. Não trate o URL como identidade estável; o que é estável é o identificador lá dentro.
- brand
- Destinada a levar o fabricante. Vazia nas 24 linhas, apesar de o nome do fabricante ser em geral a primeira palavra de
name. Se precisar de agrupar por marca, extraia-a do nome. - sku
- A referência do fabricante, e um valor diferente de
sku_code. É esta a coluna por que juntar quando pergunta se outro revendedor lista o mesmo produto físico. - url
- O endereço a partir do qual a linha foi produzida. Na nossa execução de categoria era igual a
product_url e não a query - a linha aponta para o seu próprio produto, não para a prateleira de onde veio. - image
- A imagem principal isolada, para que o caso comum não exija dividir cadeias de texto. Mesma ressalva sobre a predefinição de renderização que
images. - status
- Um indicador por linha escrito pelo nosso exportador, não pela CDW. Ao longo das nossas oito execuções assumiu quatro valores:
ok, blocked (needs residential proxy), no response (proxy) e http 404. Faça a reconciliação por esta coluna - sobretudo com uma abertura em leque, onde o número de linhas por si só nada diz.
Duas coisas sobre esta tabela merecem leitura antes de construir contra ela. Primeiro, os preços são reais. As 24 linhas da nossa execução de categoria traziam um número, um preço formatado e uma moeda - este é o único catálogo desta família cujas colunas de dinheiro chegam preenchidas. Mas pedir a mesma página de produto directamente devolve cerca de 57 KB de HTML que contêm ambas as referências e o nome do produto e nenhum preço, sem bloco de dados estruturados de onde ler um. O valor é renderizado no navegador. A nossa exportação tem-no porque o serviço renderiza a página, e um scraper assente numa biblioteca HTTP e num analisador de HTML voltaria de mãos vazias parecendo funcionar. Segundo, o esquema mexeu-se. A nossa execução de 1 de julho traz um cabeçalho de onze colunas - query, name, brand, price, currency, sku, availability, rating, url, image, status - sem parsed_price, sku_code, product_url, description, reviews ou images. Tudo a partir de 3 de julho é a forma de dezassete colunas acima. Se está a reconciliar o antigo com o novo, é essa a diferença.