O objeto "Product" é um trecho de código HTML utilizado para definir um produto em um eCommerce.
O que é e onde usar este objeto?
O objeto "product" deve ser inserido nas tags do produto visitado e do produto buscado. Também deve ser utilizado, adicionando a quantidade e o preço, nas etiquetas do carrinho e da compra realizada, tornando-o um "item_do_carrinho_de_compras".
Propriedades
Um objeto "product" inclui as seguintes propriedades:
Nome | Obrigatória | Tipo | Múltiplos | Descrição |
---|---|---|---|---|
url | Sim | string | Não | URL da página do produto (não codificado). |
product_id | Sim | string | Não | Identificador único do produto no sistema. |
name | Sim | string | Não | Nome do produto. |
unit_price | Sim | decimal | Não | Preço unitário do produto. |
image_url | Não | string | Não | URL da imagem do produto. |
description | Não | string | Não | Descrição do produto. |
availability | Não | string | Não | Pode ter um dos seguintes valores: InStock ou OutOfStock. |
categoria | Não | string | Sim | A categoria à qual o produto pertence. Se o sistema permitir subcategorias, você pode indicá-las com o caminho completo da categoria separado por cada nível com o caractere '/'. Por exemplo: "/Computadores/Teclados/Logitech". |
tag | Não | string | Sim | As tags associadas ao produto. |
marca | Não | string | Não | Marca do produto. |
review_count | Não | inteiro | Não | Número de avaliações que o produto possui. |
rating_value | Não | decimal | Não | Valor do produto normalizado na faixa de 0 a 5. |
rating_count | Não | inteiro | Não | Contagem de avaliações do produto. |
thumbnail_url | Não | string | Não | URL da imagem em miniatura do produto. |
related_external_product_id | Não | string | Sim | Ids de produtos relacionados. |
prioridade | Não | inteiro | Não | Prioridade de um produto. |
unit_price_original | Não | decimal | Não | Preço unitário original do produto. |
unit_price_without_vat | Não | decimal | Não | Preço unitário sem impostos do produto. |
desconto_percentual | Não | decimal | Não | Porcentagem de desconto, varia de 0 a 100 sem símbolo de porcentagem. |
valor_descontado | Não | decimal | Não | Valor descontado do produto (deve corresponder a unit_price_original - unit_price). |
publicado_em | Não | datetime | Não | Data de publicação do produto no catálogo da loja no formato ISO 8601. Por exemplo: "2020-05-20T15:12:20Z". |
campo_personalizado_1 | Não | string | Não | Campo personalizado do produto. |
campo_personalizado_2 | Não | string | Não | Campo personalizado do produto. |
campo_personalizado_3 | Não | string | Não | Campo personalizado do produto. |
Exemplo:
Uma vez incluído o objeto, a tag que o contém terá este aspecto:
<div class="cn_product_visited" style="display:none">
<span class="url">http://example.org/products/pr9633</span>
<span class="product_id">pr9633</span>
<span class="name">Monitor ASUS Gaming v.6.9 Full-HD</span>
<span class="description">Monitor de computador com entrada HDMI de alta definição especial para gaming.</span>
<span class="image_url">http://example.org/img/products/pr9633.jpg</span>
<span class="unit_price">260.95</span>
<span class="availability">OutOfStock</span>
<span class="category">/Computadores/Monitores/Asus</span>
<span class="category">/Computadores/Gaming</span>
<span class="tag">Preto</span>
<span class="tag">Gaming</span>
<span class="tag">Full-HD</span>
<span class="tag">HDMI</span>
<span class="brand">Asus</span>
<span class="review_count">215</span>
<span class="rating_value">3.9</span>
<span class="thumbnail_url">http://example.org/img/thumbnails/products/pr9633.jpg</span>
<span class="related_external_product_id">pr10636</span>
<span class="related_external_product_id">pr11939</span>
<span class="related_external_product_id">pr12653</span>
<span class="priority">6</span>
<span class="unit_price_original">280.22</span>
<span class="unit_price_without_vat">240.67</span>
<span class="discounted_amount">15.32</span>
<span class="discounted_percentage">10</span>
<span class="rating_count">12</span>
<span class="published_at">2020-05-20T15:24:20Z</span>
<span class="custom_field_1">Informação personalizada de exemplo</span>
</div>
Continue aprendendo!
Para aproveitar todo o potencial de sua conta no Connectif, recomendamos continuar com os seguintes artigos:
- Integração por meio de tags, para conhecer todas as notificações que você pode enviar do seu eCommerce para o Connectif e seu funcionamento.
- Integração por meio de eventos JavaScript, para conhecer esta forma de integração que permitirá um maior controle sobre quando e como enviar os eventos.
- Integração com Connectif via API, para sincronizar contatos, produtos, compras e cupons.
- Verificar a integração com o eCommerce, para garantir que todos os dados estejam sendo sincronizados corretamente em sua conta do Connectif.