Para facilitar a criação de scripts disponibilizamos em nossa plataforma, a função Fbits que traz uma série de informações como navegação, usuários, pedidos, entre outras. Com isso você cria comunicações mais assertivas tendo acesso a informações personalizadas, por exemplo, aos dados do usuário ou saber se é primeira compra ou não do mesmo.
Lembrando que esse objeto é utilizado pelas lojas que utilizem templates no Style Editor
Como funciona
Acesse seu site, e digite no Console do Navegador (F12) o comando Fbits:
A função Fbits está contida nas páginas: Home, Página de Categoria, Página de Produto, Carrinho e Página de confirmação de pedido. Em cada uma delas este comando retorna uma série de outros objetos que trazem praticamente todas as informações necessárias no disparo de tags e captura de informações.
Veja que na imagem acima retornaram diversos objetos na ‘Home’: Parceiro, Cookie, Framework, ListaProdutos, Usuário, entre outros.
Adicione a função Fbits em um dos objetos retornados como parâmetro, para obter a informação desejada.
Vejamos no exemplo abaixo:
Ao utilizarmos o objeto Usuário para obter os dados do usuário logado em nossa loja, obteremos o seguinte resultado:
{Nome: "xxx", Email: "xxx@wake.tech"…}
Para obtermos somente o E-mail do usuário, vamos adicionar o objeto Email a nossa função Fbits.Usuario:
Para retorno da informação dizendo se o cadastro do cliente é referente a primeira compra, é preciso ativar a configuração Exibir Propriedade PrimeiraCompra.
Acesse, no painel administrativo, Configurações de Admin >> Configurações gerais, em seguida, consulte pela configuração "Exibir Propriedade PrimeiraCompra", ative a configuração e salve.
Observação: após ativar a configuração, aguarde o tempo de cache de 30 minutos para que seja retornado no objeto corretamente.
Então no objeto Fbits.Usuario inclua o parâmetro PossuiPrimeiraCompra
O qual retornará dois possíveis resultados:
- True: retorna quando o cliente possui pedidos com status maior ou igual a Pago;
- False: retorna quando o cliente ainda não possui pedidos ou estão na fase Aguardando Pagamento ou Cancelado.
Objetos retornados na Home
Na Home a função Fbits retorna os seguintes objetos:
- Componentes;
- Cookie;
- Framework;
- ListaDeDesejo;
- ListaProdutos;
- Mídia;
- Página;
- Parceiro;
- Produto;
- Usuário.
Objetos retornados na Página de Categoria
Na Página de Categoria a função Fbits.Categoria retorna os seguintes objetos:
- CategoriaId;
- Nome;
- URL.
Para obtermos somente o Id da Categoria vamos adicionar o objeto CategoriaId a nossa função Fbits.Categoria:
Objetos retornados no Minha Conta
Na página do Minha Conta, em detalhes do pedido, a função Fbits.MinhaConta retorna o seguinte objeto:
- Pedido
No qual retorna todos os campos de um determinado pedido, tais como:
Dentro da função Fbits.MinhaConta.Produtos, é possível encontrar o array de frete e também o da nota fiscal.
Logo, se o pedido foi, por exemplo, faturado ou enviado, isso a nível da variante, dentro desses dois arrays serão exibidos os dados:
- Nota Fiscal: dados como chave, número, série e URL da Nota Fiscal;
- Frete: dados de rastreio como a transportadora por produto variante.
Desta forma, você terá mais autonomia em acrescentar dentro do Minha Conta mais detalhes do frete como o nome da transportadora e os dados da nota fiscal por produto variante.
Objetos retornados na Página de Produto
Na Página de Produto a função Fbits.Produto retorna os seguintes objetos:
- ProdutoId;
- ProdutoVariante;
- Nome;
- Parcelamento;
- PrecoPor, etc.
Para obtermos somente o Nome do Produto vamos adicionar o objeto Nome a nossa função Fbits.Produto:
Objetos retornados no Carrinho
No Carrinho de Compras, a função Fbits.Carrinho retorna os seguintes objetos:
- ID do Carrinho
- Compartilhar
- Eventos
- Loja
- Pedido
- Produtos
- Usuário
Saiba como obter o total da Compra
Para obtermos o total da Compra, vamos adicionar o objeto ValorTotal a nossa função Fbits.Carrinho:
Saiba como identificar se o cliente possui uma Assinatura
A partir do objeto Fbits.Assinatura, inserido no carrinho ou fechamento, conseguimos obter a informação se o usuário possui Assinatura Transacionada e ativa na loja.
Caso ele possua, será retornado true e caso não o retorno será false.
Observação: o tempo para obter um retorno "true" para um novo assinante é de 10 minutos.
Objeto retornado no Carrinho para Parceiro
No carrinho de compras, quando logado em um determinado parceiro, é possível obter o nome do parceiro no contexto da página, por meio da função Fbits.Parceiro.Get() que irá retornar o nome do parceiro ao qual estará vinculado.
Saiba como identificar se o cliente possui limite de crédito
Utilizando o objeto Fbits.Carrinho.Usuario, com o cliente logado, será retornada a informação se o cliente possui ou não um limite de crédito vinculado a sua conta. As informações são retornadas na página do "Carrinho" e "Minha Conta".
Para mais detalhes sobre a configuração de limite de crédito acesse o artigo Clientes - Limite de Crédito.
Objetos retornados na Página de Confirmação do Pedido
Na Página de Confirmação do Pedido a função Fbits.Pedido retorna os seguintes objetos:
- FormaPagamento;
- Produtos;
- PedidoId;
- PedidoIdCriptografado;
- Data, etc.
Para obtermos somente o Id do Pedido, adicione o objeto PedidoId a nossa função Fbits.Pedido.
Obtendo dados dos produtos de um pedido
Quando falamos em Produtos de um pedido estamos falando de um array e para obtermos esses dados em nossa Tag será necessário inserir no script uma pequena função que retorna uma variável com os valores desejados.
Ao criar sua Tag, navegue no site em questão para verificar as possibilidades.
Dados da Tag a serem enviados a Fbits
Para inserir a sua Tag em alguma das nossas lojas, 3 coisas são necessárias:
1. Informar em quais páginas o Script deve ser executado;
2. Qual deve ser a posição do Script na página:
- Header - Última linha
- Body - Primeira linha
- Body - Última linha
- Footer - Primeira linha
- Footer - Última linha
3. O código do Script já com a função Fbits e seus devidos parâmetros.