Integrações
Bling — Integração de Pedidos
Bling — Integração de Pedidos Conecte sua loja ao Bling para exportar pedidos, compartilhar informações de clientes e produtos e facilitar a gestão das vendas realizadas pela Nortgraf. Para que serve a integração? A integração permite conectar sua loja à plataforma de gestão Bling, facilitando o envio de informações comerciais sem precisar cadastrar manualmente os mesmos pedidos nos dois sistemas. Após configurar e autorizar a conexão, você poderá utilizar os recursos de exportação disponíveis, incluindo o envio de pedidos e produtos. Durante a exportação de pedidos, a Nortgraf prepara as informações do cliente, dos itens e dos valores para encaminhá-las à API do Bling. A integração também permite acompanhar o resultado das operações e identificar situações que exigem atenção. 1 - Atenção e Regras Antes de iniciar a configuração, observe algumas informações importantes: - Conta no Bling: É necessário possuir uma conta ativa no Bling para autorizar a integração. - Aplicativo: A conexão utiliza um aplicativo cadastrado no Bling, com Client ID e Client Secret. - Autorização OAuth: Informar as credenciais não conclui a conexão. É necessário autorizar o acesso à conta do Bling. - URL de retorno: O endereço de redirecionamento deve ser exatamente igual ao disponibilizado pela Nortgraf. - Permissões: O aplicativo precisa possuir as autorizações necessárias para consultar e enviar informações. - Pedidos: A exportação depende das informações cadastradas no pedido, incluindo cliente e itens. - Produtos: Os produtos e suas informações comerciais devem estar corretamente cadastrados para facilitar o processamento. - Segurança: O Client Secret é uma credencial privada e não deve ser compartilhado. - Reconexão: Caso a autorização seja revogada ou deixe de funcionar, poderá ser necessário conectar novamente a conta. Importante: A integração com o Bling utiliza a API v3 e autenticação OAuth 2.0. Não é necessário informar manualmente um token de acesso obtido por métodos antigos. 2 - Criando ou Acessando sua Conta no Bling Caso ainda não possua uma conta, realize o cadastro antes de configurar a integração. 1. Acesse www.bling.com.br. 2. Crie uma conta ou entre com seus dados de acesso. 3. Complete as informações solicitadas pelo Bling. 4. Verifique se a conta está habilitada para utilizar as funcionalidades necessárias. 5. Acesse o painel da plataforma. Se você já possui uma conta ativa, poderá avançar para o cadastro do aplicativo. 3 - Cadastrando um Aplicativo no Bling A conexão com a Nortgraf exige credenciais de um aplicativo cadastrado no Bling. Passo 1 - Acessar a área de desenvolvedores 1. Entre na sua conta do Bling. 2. Acesse a área de aplicativos e integrações. 3. Localize a opção destinada ao cadastro ou gerenciamento de aplicativos. 4. Inicie o cadastro de um novo aplicativo. Você também pode consultar o Portal de Desenvolvedores do Bling para obter informações sobre o cadastro e a utilização da API. Passo 2 - Preencher os dados do aplicativo Informe os dados solicitados para identificar sua integração. Utilize um nome que facilite reconhecer o aplicativo, como Integração Nortgraf. Durante o cadastro, será necessário informar o endereço de redirecionamento utilizado após a autorização. URL de retorno A Nortgraf disponibiliza esse endereço diretamente nas configurações da integração. Para consultá-lo: 1. Abra o painel administrativo da sua loja na Nortgraf. 2. Acesse Configurações > Integrações. 3. Selecione Bling. 4. Localize o campo URL de retorno — cadastre no Bling. 5. Clique em Copiar. 6. Volte ao cadastro do aplicativo no Bling. 7. Cole o endereço no campo Link de redirecionamento. Importante: Utilize exatamente o endereço fornecido pela Nortgraf, mesmo que sua loja possua domínio próprio. Não substitua a URL pelo endereço da loja. Um redirecionamento incorreto impedirá a conclusão da autorização. Passo 3 - Obter as credenciais Após cadastrar o aplicativo, localize as credenciais disponibilizadas pelo Bling: Client ID Identifica o aplicativo que solicitará a autorização. Client Secret É a credencial secreta utilizada para autenticar o aplicativo durante a conexão. Copie essas informações para utilizá-las na configuração da Nortgraf. Atenção: Não envie seu Client Secret por mensagens, e-mails ou outros canais públicos. Informe essa credencial somente no campo apropriado da integração. 4 - Conectando o Bling à Nortgraf Depois de criar o aplicativo e obter suas credenciais, retorne ao painel da Nortgraf. Passo 1 - Informar as credenciais 1. Acesse Configurações > Integrações. 2. Abra a integração Bling. 3. Localize a seção de conexão. 4. Informe o Client ID. 5. Informe o Client Secret correspondente. 6. Salve as configurações. Após salvar as credenciais, a Nortgraf poderá iniciar automaticamente o processo de autorização com o Bling. Passo 2 - Autorizar a conta Durante o processo de conexão: 1. Você será direcionado ao Bling. 2. Entre na sua conta, caso seja solicitado. 3. Confira as informações do aplicativo. 4. Analise as permissões solicitadas. 5. Autorize a conexão. 6. Aguarde o retorno ao painel da Nortgraf. Quando a autorização for concluída corretamente, a integração apresentará a confirmação de conexão. Importante: Não feche a página antes de concluir a autorização e retornar à Nortgraf. 5 - Validando a Conexão Após conectar sua conta, confira se a integração está funcionando. Como verificar? 1. Retorne às configurações do Bling na Nortgraf. 2. Confira o status da integração. 3. Utilize a opção de teste de conexão disponível no painel. 4. Aguarde o resultado da verificação. O teste utiliza a autorização obtida durante a conexão para realizar uma consulta à API do Bling. Se a conta ainda não tiver sido autorizada, o sistema solicitará que você conclua a conexão antes de executar o teste. Resultado esperado Uma conexão válida permite que a Nortgraf se comunique com os serviços autorizados do Bling. Se ocorrer algum erro, confira as credenciais, o status da autorização e as permissões concedidas ao aplicativo. 6 - Configurando a Exportação de Pedidos A Nortgraf permite configurar o comportamento de exportação dos pedidos para a integração. Exportação automática Na configuração do Bling, localize a opção Exportação automática de pedidos. Selecione uma das opções disponíveis: - Ativada — Sincronizar automaticamente: permite utilizar o processamento automático de exportação. - Desativada: mantém a exportação automática desligada. Após alterar a configuração, salve as informações. Importante: O envio automático depende das condições e regras de processamento da integração. Um pedido precisa estar elegível e possuir os dados necessários para ser exportado. 7 - Exportando um Pedido para o Bling Além da exportação automática, a integração possui recursos para o envio individual de pedidos. Antes de exportar Confira se o pedido possui: - Cliente identificado; - Informações cadastrais necessárias; - Pelo menos um item; - Quantidades e valores corretamente registrados; - Dados comerciais compatíveis com o envio ao Bling. A ausência de informações essenciais pode impedir a exportação. Como funciona? Quando um pedido é encaminhado para exportação, a Nortgraf prepara seus dados e verifica as informações necessárias. O processamento considera o vínculo do pedido com a integração. Se o pedido ainda não possuir um identificador correspondente no Bling, o sistema poderá realizar a inclusão. Quando já existe um vínculo válido, o sistema poderá encaminhar a atualização do pedido correspondente. O resultado da operação é registrado para permitir o acompanhamento. 8 - Informações Enviadas ao Bling Durante a exportação, a Nortgraf organiza os dados do pedido para utilização pela API do Bling. Dados do cliente O processamento considera informações como: - Nome do cliente; - Tipo de pessoa; - CPF ou CNPJ; - Telefone; - E-mail; - Endereço, quando disponível e aplicável. Tratamento do telefone O telefone é preparado para o formato utilizado pelo Bling. Para números brasileiros, a Nortgraf remove caracteres de formatação e trata o código internacional quando ele estiver presente no formato esperado. Por exemplo, um número armazenado com +55 poderá ser enviado utilizando DDD e número. Esse tratamento ocorre durante a preparação dos dados e não exige que você modifique manualmente o telefone cadastrado. Dados dos produtos e itens O envio dos itens considera informações como: - Identificação do produto, quando disponível; - Código do produto ou SKU, quando aplicável; - Descrição do item; - Quantidade; - Valor unitário; - Informações comerciais necessárias ao pedido. A descrição pode incluir características e especificações registradas durante a compra, conforme as informações disponíveis no item. Itens avulsos Pedidos com itens avulsos também podem ser tratados durante a exportação. Quando um item não possui vínculo com um produto cadastrado, a Nortgraf utiliza as informações salvas no próprio pedido para preparar sua descrição, quantidade e valor. Isso permite preservar dados comerciais registrados no momento da venda. Importante: A exportação utiliza os dados disponíveis no pedido. Por isso, confira as descrições e os valores antes de realizar o envio. 9 - Exportação e Reexportação de Pedidos O painel da integração pode disponibilizar operações de sincronização e reexportação. Exportação Utilizada para encaminhar pedidos elegíveis à integração. Quando a operação é concluída, a Nortgraf registra o vínculo com o identificador retornado pelo Bling, quando disponível. Reexportação Utilizada quando é necessário reenviar informações de um pedido que já passou pelo processo de exportação. Essa operação pode ser útil quando determinados dados foram atualizados ou quando é necessário repetir o envio. Atenção: A reexportação deve ser utilizada com cuidado. Confira o pedido e o resultado anterior para evitar operações desnecessárias ou inconsistências no sistema de destino. 10 - Acompanhando as Sincronizações Após utilizar os recursos de exportação, acompanhe os resultados apresentados pela Nortgraf. As operações podem indicar: - Exportação concluída; - Atualização realizada; - Pedido sem dados mínimos; - Falha de autenticação; - Erro de validação retornado pelo Bling; - Falha de comunicação. Quando uma operação apresentar erro, consulte as informações disponibilizadas no painel antes de tentar novamente. Dica: Nas primeiras exportações, confira também o pedido diretamente no Bling para validar os dados recebidos. 11 - Reconectando a Conta do Bling Em determinadas situações, a autorização da integração pode deixar de funcionar. Isso pode ocorrer, por exemplo, quando o acesso do aplicativo é revogado ou quando as credenciais são alteradas. Como reconectar? 1. Acesse Configurações > Integrações. 2. Abra Bling. 3. Confira o Client ID e o Client Secret cadastrados. 4. Corrija as credenciais, caso necessário. 5. Inicie novamente a conexão com o Bling. 6. Autorize o acesso à conta. 7. Retorne à Nortgraf. 8. Execute o teste de conexão. Após a reconexão, verifique se os recursos de exportação estão disponíveis. 12 - Seções de Referência Credenciais Permite configurar o Client ID e o Client Secret utilizados na autenticação. URL de Retorno Exibe o endereço que deve ser cadastrado como Link de redirecionamento no aplicativo do Bling. Autorização OAuth Permite conectar a conta e conceder acesso à integração. Exportação Automática de Pedidos Define se a integração utilizará o processamento automático para envio de pedidos elegíveis. Teste de Conexão Verifica se a autorização permite a comunicação com a API do Bling. Exportação e Reexportação Disponibiliza operações para envio ou reenvio de informações, conforme as opções habilitadas no painel. Status da Integração Permite acompanhar o estado da conexão e identificar situações que exigem uma nova autorização. 13 - Problemas Comuns Não consigo conectar minha conta ao Bling. Confira se o Client ID e o Client Secret pertencem ao mesmo aplicativo e se os dados foram informados corretamente na Nortgraf. Apareceu o erro "redirect_uri_mismatch". O endereço de redirecionamento cadastrado no Bling não corresponde ao utilizado pela Nortgraf. Copie novamente o campo URL de retorno — cadastre no Bling, atualize o Link de redirecionamento do aplicativo e tente conectar novamente. O teste informa que preciso conectar a conta. As credenciais podem estar salvas, mas a autorização OAuth ainda não foi concluída. Inicie a conexão, autorize o aplicativo no Bling e repita o teste. A autorização expirou ou não foi concluída. Retorne à configuração do Bling na Nortgraf e inicie novamente o processo de conexão. Meu pedido não foi exportado. Confira se o pedido possui cliente e itens cadastrados, se a integração está autorizada e se a exportação está habilitada ou foi iniciada corretamente. O telefone do cliente não aparece como esperado. Confira o telefone cadastrado. A Nortgraf prepara o formato do número brasileiro durante a exportação, mas informações ausentes ou incorretas devem ser ajustadas no cadastro do cliente. A descrição de um item está diferente. Verifique as informações registradas no pedido, incluindo características e especificações selecionadas durante a compra. Um item avulso não possui SKU. Itens avulsos podem ser encaminhados utilizando os dados registrados no pedido, sem depender obrigatoriamente de um produto cadastrado no catálogo. Não consigo reexportar um pedido. Verifique a conexão com o Bling, a situação do pedido e as mensagens retornadas durante a tentativa de reexportação. O Bling retornou um erro durante o envio. Confira os dados do cliente, do pedido e dos produtos envolvidos. Algumas validações são realizadas diretamente pela API do Bling e precisam ser atendidas para concluir a operação. Dica: Após conectar o Bling, realize a exportação de um pedido de teste e confira o resultado diretamente na plataforma de destino. Verifique o cliente, telefone, descrições dos itens, quantidades e valores antes de utilizar a integração em sua rotina de vendas.
WhatsApp — Integração e notificações automáticas
WhatsApp — Integração e notificações automáticas Conecte um número por QR Code e configure mensagens para mudanças de status de pedidos e orçamentos. ● Para que serve este módulo? A integração permite manter o cliente informado automaticamente. A conexão do número e a ativação dos modelos são etapas separadas: conectar o WhatsApp não ativa sozinho os envios. 1 - Antes de começar - Tenha o celular com o WhatsApp conectado à internet. - Confirme quais status realmente devem avisar o cliente. - Revise telefone e nome dos clientes. - Faça um teste com um pedido controlado. 2 - Conectando pelo QR Code 1. Acesse Configurações > Integrações > WhatsApp. 2. Inicie a conexão e aguarde o QR Code. 3. No celular, abra os aparelhos conectados do WhatsApp. 4. Leia o QR Code exibido na Nortgraf. 5. Atualize o status até aparecer como conectado. Se o código expirar, gere outro e repita a leitura. 3 - Modelos de pedidos Cada status do pedido possui um modelo próprio. Edite a mensagem, salve e ative somente os estados que devem gerar aviso. As variáveis disponíveis incluem {cliente_nome}, {pedido_id}, {status_nome} e {link_pedido}. Elas são substituídas no envio. 4 - Modelos de orçamentos Orçamentos têm modelos separados conforme o estado. Podem ser usadas as variáveis {cliente_nome}, {orcamento_codigo}, {status_nome} e {link_orcamento}. Ative apenas mensagens compatíveis com o atendimento da empresa. 5 - Ativar e desativar Use a chave de cada modelo para controlar o envio individualmente. As ações em lote ativam ou desativam todos os modelos do respectivo grupo. Depois de alterar vários modelos, faça uma conferência para evitar mensagens duplicadas ou indesejadas. 6 - Testando o fluxo 1. Conecte o número. 2. Ative um único modelo. 3. Crie ou escolha um registro de teste com telefone válido. 4. Mude para o status configurado. 5. Confira texto, link e recebimento. 6. Só então habilite os demais status. 7 - Problemas comuns Status conectado, mas não envia Confira se o modelo daquele status está ativo e se o cliente possui telefone válido. Variável aparece como texto Revise a grafia e mantenha as chaves exatamente como apresentadas. QR Code não conecta Gere outro código, confira a internet do celular e tente novamente. Mensagem inesperada Revise modelos ativos e automações ligadas à mudança de status. 8 - Boas práticas - Escreva mensagens curtas e objetivas. - Não informe dados sensíveis. - Mantenha links e telefone do cliente atualizados. - Evite avisos em cada pequena etapa interna. - Monitore a sessão conectada. Atenção: O recurso está identificado como Beta. Faça testes antes de ativar mensagens em massa e lembre-se de que os modelos precisam estar ativos para haver envio.
Mercado Livre — Conectar e sincronizar catálogo
Mercado Livre — Conectar e sincronizar catálogo Conecte a conta de vendedor, exporte produtos e acompanhe pedidos do marketplace na Nortgraf. Para que serve este módulo? A integração usa uma aplicação do Mercado Livre e autorização OAuth para relacionar a conta do vendedor à loja. O recurso está identificado como Beta e deve ser validado com poucos produtos antes do uso em escala. 1 - Antes de começar - Conta de vendedor ativa no Mercado Livre. - Aplicação criada no DevCenter. - Client ID/App ID e Client Secret. - URL de redirecionamento cadastrada na aplicação. - Produtos revisados com imagens, categoria, preço e estoque. 2 - Criando a aplicação 1. Acesse o DevCenter do Mercado Livre. 2. Crie ou abra a aplicação usada pela loja. 3. Copie o App ID e o Client Secret. 4. Na Nortgraf, abra Configurações > Integrações > Mercado Livre. 5. Copie a URL de redirecionamento exibida. 6. Cadastre essa URL na aplicação do Mercado Livre. 3 - Conectando a conta 1. Informe o Client ID/App ID e o Client Secret. 2. Escolha se a sincronização de pedidos ficará automática ou manual. 3. Salve a configuração. 4. Na autorização do Mercado Livre, entre com a conta vendedora correta. 5. Aceite as permissões solicitadas. 6. Retorne à integração e confirme o status conectado, nickname e Seller ID. 4 - Exportando produtos Abra um produto no catálogo e use a ação de exportação para o Mercado Livre quando disponível. Revise categoria, título, descrição, imagens, preço, estoque e atributos exigidos pelo marketplace. Depois da exportação, acompanhe o vínculo e os retornos. Corrija os campos indicados antes de tentar novamente. 5 - Pedidos do marketplace Com a integração conectada, pedidos recebidos do Mercado Livre podem ser trazidos para a Nortgraf conforme o fluxo habilitado. Confira cliente, itens, valores, entrega e vínculo externo antes de avançar a operação. Evite cadastrar manualmente outro pedido para a mesma venda. 6 - Sincronização e limites Produtos, estoque e pedidos dependem dos vínculos e permissões da conta. Preços podem seguir regras diferentes conforme a configuração atual. Alterações feitas diretamente no Mercado Livre podem exigir nova sincronização ou conferência na Nortgraf. 7 - Problemas comuns Autorização não conclui Confira a URL de redirecionamento e se as credenciais pertencem à mesma aplicação. Conta errada foi conectada Desconecte e refaça a autorização com o vendedor correto. Produto rejeitado Revise categoria, atributos obrigatórios, imagens, preço e políticas do marketplace. Pedido não apareceu Confirme a conexão, o modo de sincronização e se o pedido pertence ao Seller ID conectado. 8 - Boas práticas - Teste com poucos produtos. - Não compartilhe o Client Secret. - Revise pedidos importados antes de produzir. - Mantenha estoque e preço coerentes entre canais. - Acompanhe erros e vínculos de sincronização. Atenção: A integração está em Beta. Valide cuidadosamente catálogo, estoque e pedidos antes de depender dela como único fluxo operacional.
Olist ERP — Como conectar sua loja
Olist ERP — Como conectar sua loja Conecte sua loja ao Olist ERP para enviar pedidos e produtos com mais praticidade pela integração da Nortgraf. Para que serve a integração? A integração com o Olist ERP permite conectar sua loja para exportar pedidos e produtos, facilitando a organização da operação e o acompanhamento das vendas em um só lugar. Nota: esta integração está disponível em versão beta. Recomendamos acompanhar as primeiras sincronizações para validar o envio correto dos dados. 1 - Antes de começar - Token de integração: Você precisará gerar e copiar o token da API no painel do Olist ERP antes de configurar a integração na Nortgraf. - Extensão Token API: Em muitos cenários, é necessário instalar a extensão Token API no ERP antes de gerar o token. - Marcador: O marcador é opcional e pode ser usado para identificar os pedidos enviados da loja dentro do Olist ERP. - Beta: Como a integração ainda está em validação prática, acompanhe as primeiras exportações de pedidos e produtos após a conexão. 2 - Como obter o token de integração 1. Acesse a Loja de extensões: no Olist ERP, vá em menu > início > Loja de extensões. 2. Pesquise por Token API: localize a extensão Token API e confirme a instalação, caso ela ainda não esteja ativa na sua conta. 3. Acesse as configurações do e-commerce: no menu do ERP, vá em configurações > e-commerce. 4. Abra a opção Token API: dentro da área de e-commerce, clique em Token API. 5. Gere ou copie o token: se necessário, clique em gerar token e copie o código disponibilizado pelo Olist ERP. 3 - Passo a passo para conectar o Olist ERP 1. Acesse o painel da sua loja: na Nortgraf, vá em Configurações > Integrações > Olist ERP. 2. Preencha o token de integração: cole o token copiado do Olist ERP no campo correspondente. 3. Defina o marcador, se desejar: esse campo é opcional e pode ser usado para identificar os pedidos enviados da sua loja dentro do Olist ERP. 4. Escolha a exportação automática de pedidos: defina se os pedidos devem ser enviados automaticamente ou apenas de forma manual. 5. Salve a configuração: após preencher os campos, clique em Salvar para concluir a conexão com o Olist ERP. 6. Teste a conexão: use o botão Testar conexão para validar se a integração foi configurada corretamente antes de depender do fluxo automático. 4 - O que você configura nesta tela - Token de integração Chave gerada no Olist ERP para autenticar a conexão entre a sua loja e o sistema. - Marcador Campo opcional para identificar os pedidos exportados da sua loja dentro do Olist ERP. - Exportação automática de pedidos Define se os pedidos aprovados serão enviados automaticamente para o Olist ERP ou apenas manualmente. - Status e teste de conexão Permite verificar se a integração está ativa, conectada corretamente e pronta para uso. 5 - O que fazer depois da conexão Depois de conectar sua conta, recomendamos realizar um teste inicial antes de depender da rotina automática no dia a dia. - Valide a conexão no painel. - Confira se os primeiros pedidos estão sendo enviados corretamente. - Acompanhe as primeiras sincronizações de produtos e pedidos. - Se necessário, mantenha a exportação automática desativada até concluir seus testes iniciais. Dica: se a conexão não funcionar como esperado, revise a instalação da extensão Token API, gere um novo token no Olist ERP, atualize o campo na integração e teste novamente.
Google Analytics 4
Google Analytics 4 Conecte sua loja ao Google Analytics 4 (GA4) para acompanhar acessos, analisar o comportamento dos visitantes e obter informações sobre o desempenho da sua loja na Nortgraf. Para que serve a integração? O Google Analytics 4 é uma ferramenta de análise que permite compreender como os visitantes interagem com seu site. Com a integração, você pode acompanhar informações como origem dos acessos, páginas visitadas, dispositivos utilizados e eventos registrados durante a navegação. Esses dados ajudam a identificar quais páginas recebem mais visitantes, avaliar campanhas de marketing e acompanhar o desempenho comercial da loja. A Nortgraf permite configurar o ID de medição do GA4, uma chave para envio de eventos pelo servidor e um script adicional, quando necessário. 1 - Atenção e Regras Antes de configurar a integração, observe algumas informações importantes: - Conta Google: É necessário possuir uma conta Google para acessar o Google Analytics. - Propriedade GA4: Sua loja precisa estar vinculada a uma propriedade do Google Analytics 4. - ID de medição: É o identificador utilizado para enviar dados da loja à propriedade correta. - API Secret: É uma credencial utilizada no envio de eventos pelo servidor por meio do Measurement Protocol. - Script adicional: Campo opcional destinado a configurações específicas de acompanhamento. - Ativação: A opção Enviar eventos para o GA4 deve estar habilitada para ativar a tag nas páginas da loja. - Privacidade: O uso de ferramentas de análise deve respeitar as regras aplicáveis de privacidade e tratamento de dados. - Processamento: Os eventos enviados podem levar algum tempo para aparecer nos relatórios do Google Analytics. Importante: Para a configuração básica, normalmente é suficiente informar o ID de medição e ativar a integração. O API Secret e o script adicional são destinados a necessidades específicas. 2 - Criando sua Conta no Google Analytics Caso ainda não utilize o Google Analytics, será necessário criar uma conta e uma propriedade para sua loja. Passo 1 - Acessar o Google Analytics 1. Acesse analytics.google.com. 2. Entre com sua conta Google. 3. Se for seu primeiro acesso, inicie a configuração de uma nova conta. 4. Informe um nome para identificar sua empresa ou loja. 5. Configure as preferências solicitadas. 6. Avance para a criação da propriedade. Passo 2 - Criar uma propriedade GA4 Na etapa de criação da propriedade: 1. Informe o nome da propriedade, como o nome da sua loja. 2. Selecione o fuso horário adequado. 3. Escolha a moeda utilizada pela empresa. 4. Informe as informações comerciais solicitadas. 5. Conclua a criação da propriedade. Dica: Utilize um nome que permita identificar facilmente sua loja, principalmente se você administra mais de um site no Google Analytics. 3 - Criando um Fluxo de Dados Após criar a propriedade, será necessário configurar um fluxo de dados para seu site. Passo 1 - Adicionar o site 1. No Google Analytics, acesse Administrador. 2. Localize Fluxos de dados. 3. Clique para adicionar um novo fluxo. 4. Selecione Web. 5. Informe o endereço público da sua loja. 6. Digite um nome para identificar o fluxo. 7. Conclua a configuração. O endereço informado deve corresponder ao domínio utilizado pelos visitantes para acessar sua loja. Passo 2 - Obter o ID de medição Depois de criar o fluxo: 1. Abra o fluxo de dados correspondente. 2. Localize o campo ID de medição. 3. Copie o identificador apresentado. O ID de medição do GA4 normalmente possui o formato: G-XXXXXXXXXX Esse identificador será utilizado nas configurações da Nortgraf. Importante: Não confunda o ID de medição com o ID numérico da propriedade. Para essa integração, utilize o identificador iniciado por G-. 4 - Configurando o Google Analytics na Nortgraf Com o ID de medição em mãos, acesse o painel administrativo da sua loja. Passo 1 - Acessar a integração 1. Entre no painel administrativo da Nortgraf. 2. Acesse Configurações > Integrações. 3. Localize Google Analytics 4. 4. Abra a página de configuração. A tela apresenta as seções Medição e Ativação. Passo 2 - Informar o ID de medição Na seção Medição: 1. Localize o campo ID de medição. 2. Cole o identificador copiado do Google Analytics. 3. Confira se o código corresponde ao fluxo de dados da sua loja. Exemplo: G-XXXXXXXXXX Esse código identifica a propriedade que receberá os eventos de acompanhamento. Passo 3 - Ativar a integração Na seção Ativação: 1. Localize Enviar eventos para o GA4. 2. Habilite a opção. 3. Clique em Salvar. Com a integração habilitada, a Nortgraf poderá inserir a tag de acompanhamento nas páginas da loja. Importante: A ativação não garante, por si só, que todos os eventos desejados estejam configurados ou que os relatórios sejam preenchidos imediatamente. O recebimento deve ser confirmado no Google Analytics. 5 - Configurando o API Secret O campo API Secret é utilizado para funcionalidades que enviam eventos diretamente do servidor ao Google Analytics por meio do Measurement Protocol. Essa configuração é opcional para o acompanhamento básico realizado pela tag. Passo 1 - Criar o segredo no Google Analytics 1. Acesse sua propriedade no Google Analytics. 2. Abra Administrador. 3. Localize Fluxos de dados. 4. Selecione o fluxo Web da sua loja. 5. Acesse a opção de criação de segredos da API do Measurement Protocol. 6. Crie um novo segredo. 7. Copie o valor disponibilizado pelo Google. Passo 2 - Informar o segredo na Nortgraf 1. Retorne à integração Google Analytics 4 na Nortgraf. 2. Localize o campo API Secret. 3. Informe o segredo gerado. 4. Salve as configurações. Para que serve? O Measurement Protocol permite que aplicações enviem determinados eventos diretamente ao Google Analytics, sem depender exclusivamente de scripts executados no navegador. A Nortgraf possui suporte para utilizar essa credencial em processos de envio de conversões pelo servidor. Atenção: O API Secret é uma informação privada. Não o compartilhe publicamente nem o insira em scripts expostos aos visitantes. 6 - Utilizando um Script Adicional A seção Medição também disponibiliza o campo Script adicional. Esse campo é opcional e deve ser utilizado somente quando existe uma necessidade específica de acompanhamento. Quando utilizar? O script adicional pode ser utilizado quando sua configuração exige um snippet próprio além da tag padrão disponibilizada pela integração. Como configurar? 1. Acesse a integração Google Analytics 4. 2. Localize o campo Script adicional. 3. Insira o código necessário. 4. Confira se o conteúdo está correto. 5. Salve as alterações. Importante: Não adicione novamente a tag padrão do Google Analytics sem necessidade. Instalar a mesma medição mais de uma vez pode provocar registros duplicados e prejudicar a análise dos dados. Se você utiliza o Google Tag Manager para administrar suas tags, verifique também as configurações realizadas nele. 7 - Testando a Integração Depois de salvar as configurações, recomendamos verificar se o Google Analytics está recebendo os eventos da loja. Passo 1 - Abrir sua loja 1. Acesse o endereço público da sua loja. 2. Navegue pelas páginas disponíveis. 3. Abra alguns produtos. 4. Realize interações normais de navegação. Passo 2 - Verificar no Google Analytics 1. Retorne ao painel do Google Analytics. 2. Abra a propriedade correspondente. 3. Consulte o relatório Em tempo real. 4. Verifique se existe atividade sendo registrada. Quando necessário, utilize as ferramentas de depuração disponibilizadas pelo Google para investigar o recebimento de eventos específicos. Resultado esperado Se a configuração estiver correta e o acompanhamento não estiver bloqueado pelo navegador ou por regras de consentimento, o Google Analytics deverá começar a registrar atividades compatíveis com a implementação. Dica: Para realizar o teste, utilize uma janela de navegação sem bloqueadores de rastreamento e confira se está acessando o domínio correto da loja. 8 - Entendendo os Dados do Google Analytics Após configurar a integração, você poderá utilizar os relatórios do Google Analytics para analisar o comportamento dos visitantes. Origem dos acessos Permite identificar de onde vêm os visitantes, como mecanismos de pesquisa, campanhas, redes sociais e acessos diretos, conforme os dados coletados. Páginas visitadas Ajuda a identificar quais páginas e produtos recebem mais acessos. Dispositivos Permite consultar informações sobre os dispositivos utilizados pelos visitantes, como computadores e celulares. Eventos Os eventos representam interações registradas durante a navegação ou enviadas pelos mecanismos de medição configurados. Conversões e eventos principais Você pode utilizar os recursos do GA4 para acompanhar eventos importantes para seu negócio, conforme a configuração e os eventos efetivamente recebidos. Importante: A disponibilidade dos relatórios e eventos depende das configurações da propriedade e dos dados coletados. A integração não significa que todos os eventos de comércio eletrônico estejam automaticamente disponíveis. 9 - Integração com o Google Tag Manager O Google Tag Manager é uma ferramenta separada que permite administrar tags e scripts de acompanhamento. Você pode utilizá-lo para organizar diferentes recursos de marketing, incluindo o Google Analytics. Entretanto, é importante evitar configurações duplicadas. Exemplo Se o Google Analytics estiver configurado diretamente na Nortgraf e também for instalado pelo Google Tag Manager, verifique se os dois métodos não estão enviando o mesmo evento mais de uma vez. Para administrar suas tags pelo Google Tag Manager, consulte o artigo Google Tag Manager. 10 - Desativando a Integração Se desejar interromper o acompanhamento realizado pela integração: 1. Acesse Configurações > Integrações. 2. Abra Google Analytics 4. 3. Localize a seção Ativação. 4. Desabilite Enviar eventos para o GA4. 5. Clique em Salvar. A desativação interrompe a injeção da tag padrão controlada por essa opção. Atenção: Se você utiliza scripts adicionais, Google Tag Manager ou outros mecanismos de envio de eventos, confira essas configurações separadamente. Desativar a integração na Nortgraf não exclui sua propriedade nem os dados já registrados no Google Analytics. 11 - Seções de Referência Medição Reúne os campos necessários à configuração do acompanhamento. ID de medição Identificador do fluxo Web da propriedade GA4, normalmente iniciado por G-. API Secret Credencial utilizada para eventos enviados pelo servidor através do Measurement Protocol. Script adicional Campo opcional para inclusão de um snippet próprio de acompanhamento. Ativação Reúne as opções relacionadas ao funcionamento da integração. Enviar eventos para o GA4 Controla a ativação da tag padrão do Google Analytics nas páginas da loja. 12 - Problemas Comuns Não encontro o ID de medição. Acesse o Google Analytics, abra Administrador, selecione Fluxos de dados e consulte o fluxo Web correspondente à sua loja. O Google Analytics não registra acessos. Confira o ID de medição, verifique se a integração está habilitada e confirme que você está acessando o domínio correto. Também verifique se o navegador utiliza bloqueadores de rastreamento ou se existem condições de consentimento que impeçam a coleta. Os dados não aparecem imediatamente nos relatórios. Alguns relatórios podem apresentar atraso no processamento. Utilize o relatório Em tempo real para verificar a atividade inicial. Preciso configurar o API Secret? Não obrigatoriamente. Para o acompanhamento básico por tag, o ID de medição normalmente é suficiente. O API Secret é destinado a funcionalidades de envio de eventos pelo servidor. Os acessos estão sendo contados mais de uma vez. Confira se o Google Analytics não está instalado simultaneamente por múltiplos métodos, como integração direta, Google Tag Manager e scripts adicionais. Configurei o Google Tag Manager. Preciso ativar também o Google Analytics na Nortgraf? Depende da sua configuração. Se o Google Tag Manager já administra a tag do GA4, evite instalar uma segunda tag idêntica sem necessidade. O campo Script adicional é obrigatório? Não. Utilize esse campo somente quando precisar inserir um snippet próprio. Desativei o Google Analytics, mas ainda encontro eventos. Verifique se existem outras ferramentas ou scripts enviando dados, como Google Tag Manager, scripts adicionais ou integrações pelo servidor. Minha conta Google possui várias propriedades. Qual devo utilizar? Utilize o ID de medição do fluxo Web correspondente à loja que deseja acompanhar. Alterei o domínio da loja. Preciso configurar novamente? Confira o endereço utilizado no fluxo de dados do Google Analytics e verifique se a propriedade continua recebendo os eventos corretamente. Dica: Após configurar o Google Analytics, realize uma navegação de teste na loja e acompanhe o relatório Em tempo real. Isso ajuda a confirmar o recebimento dos primeiros eventos antes de utilizar os dados para avaliar campanhas e decisões comerciais.
Google Tag Manager
Google Tag Manager Conecte sua loja ao Google Tag Manager (GTM) para gerenciar tags e scripts de marketing em um único lugar, facilitando a configuração de ferramentas de análise, publicidade e acompanhamento de conversões. Para que serve a integração? O Google Tag Manager é uma ferramenta gratuita do Google que permite instalar e administrar códigos de acompanhamento em um site sem precisar modificar seu código-fonte a cada alteração. Por meio dele, você pode configurar ferramentas como Google Analytics 4, Google Ads e outras soluções de marketing compatíveis. A integração da Nortgraf permite instalar o contêiner do Google Tag Manager nas páginas da sua loja utilizando o identificador fornecido pelo Google. Também é possível informar um script completo quando sua configuração exigir uma instalação diferente da padrão. 1 - Atenção e Regras Antes de iniciar a configuração, observe algumas informações importantes: - Conta Google: É necessário possuir uma conta Google para acessar o Tag Manager. - Contêiner: Você precisará criar um contêiner específico para seu site. - Container ID: É o identificador utilizado para carregar o contêiner na loja. - Tags: A criação e a configuração das tags são realizadas no painel do Google Tag Manager. - Publicação: As alterações feitas no Google Tag Manager precisam ser publicadas para entrarem em funcionamento no site. - Script completo: É opcional e deve ser utilizado somente quando sua instalação exigir um código personalizado. - Ativação: A opção Carregar o container na loja deve estar habilitada para inserir o código de acompanhamento. - Duplicidade: Evite instalar a mesma ferramenta por diferentes métodos, pois isso pode provocar eventos duplicados. - Privacidade: Configure as tags de acordo com as regras aplicáveis de privacidade e consentimento. Importante: O Google Tag Manager administra tags, mas não substitui as ferramentas que recebem e analisam os dados. Para acompanhar relatórios de visitantes, por exemplo, você precisará configurar uma ferramenta como o Google Analytics 4. 2 - Criando sua Conta no Google Tag Manager Caso ainda não utilize o Google Tag Manager, será necessário criar uma conta e um contêiner. Passo 1 - Acessar o Google Tag Manager 1. Acesse tagmanager.google.com. 2. Entre com sua conta Google. 3. Clique em Criar conta. 4. Informe um nome para identificar sua empresa ou loja. 5. Selecione o país correspondente. 6. Avance para a configuração do contêiner. Passo 2 - Criar o contêiner Na seção de configuração: 1. Informe um nome para o contêiner. 2. Utilize o domínio da sua loja ou outro nome que permita identificá-lo. 3. Em Plataforma de destino, selecione Web. 4. Clique em Criar. 5. Aceite os termos apresentados pelo Google, quando solicitado. Após a criação, o Google Tag Manager disponibilizará um contêiner para gerenciar as tags do seu site. Dica: Se você administra várias lojas, utilize nomes diferentes para identificar os contêineres e evitar configurar tags na propriedade errada. 3 - Obtendo o Container ID Para conectar o Google Tag Manager à Nortgraf, você precisará do identificador do contêiner. Passo 1 - Localizar o identificador 1. Acesse o painel do Google Tag Manager. 2. Abra o contêiner correspondente à sua loja. 3. Localize o identificador apresentado na parte superior da página. 4. Copie o código. O Container ID normalmente possui o formato: GTM-XXXXXXX Esse código identifica o contêiner que será carregado na loja. Passo 2 - Conferir o identificador Antes de utilizar o código, verifique se ele pertence ao contêiner correto. Importante: Não confunda o Container ID do Google Tag Manager com o ID de medição do Google Analytics. - Google Tag Manager: GTM-XXXXXXX - Google Analytics 4: G-XXXXXXXXXX São identificadores de serviços diferentes e devem ser informados nos campos correspondentes. 4 - Configurando o Google Tag Manager na Nortgraf Depois de obter o Container ID, acesse o painel administrativo da sua loja. Passo 1 - Acessar a integração 1. Entre no painel administrativo da Nortgraf. 2. Acesse Configurações > Integrações. 3. Localize Google Tag Manager. 4. Abra a página de configuração. A tela apresenta duas seções principais: - Container: Reúne os dados de instalação do Google Tag Manager. - Ativação: Permite controlar o carregamento do contêiner na loja. Passo 2 - Informar o Container ID Na seção Container: 1. Localize o campo Container ID. 2. Cole o identificador fornecido pelo Google. 3. Confira se o código corresponde ao contêiner desejado. Exemplo: GTM-XXXXXXX O campo identifica o contêiner que deverá ser carregado nas páginas da loja. Passo 3 - Ativar o contêiner Na seção Ativação: 1. Localize a opção Carregar o container na loja. 2. Habilite a opção. 3. Clique em Salvar. Após a ativação, a Nortgraf passa a incluir o snippet do Google Tag Manager nas páginas da loja, conforme a configuração informada. Importante: Instalar o contêiner não significa que todas as tags estejam configuradas ou publicadas. Elas deverão ser administradas no painel do Google Tag Manager. 5 - Utilizando o Campo Script Completo A integração também disponibiliza o campo Script completo. Esse campo permite informar um código personalizado de instalação do Google Tag Manager. Quando utilizar? Utilize essa opção somente quando seu contêiner exigir uma instalação diferente da padrão. Na configuração normal, você não precisa preencher esse campo. A Nortgraf utiliza o Container ID para montar automaticamente o snippet padrão. Como configurar? 1. Abra Configurações > Integrações > Google Tag Manager. 2. Localize a seção Container. 3. Encontre o campo Script completo. 4. Insira o trecho de código necessário. 5. Confira o conteúdo. 6. Salve as configurações. Comportamento importante Quando o campo Script completo está preenchido, a Nortgraf utiliza esse trecho no lugar do snippet padrão gerado a partir do Container ID. Portanto, o código personalizado deve estar correto e conter a implementação necessária para seu contêiner. Atenção: Não preencha esse campo apenas para repetir o código padrão. Para a maioria das lojas, basta informar o Container ID. 6 - Criando sua Primeira Tag Após conectar o contêiner à Nortgraf, você poderá começar a configurar as tags diretamente no Google Tag Manager. Passo 1 - Acessar as tags 1. Entre no Google Tag Manager. 2. Abra o contêiner da sua loja. 3. No menu lateral, clique em Tags. 4. Clique em Nova. Passo 2 - Escolher a ferramenta Selecione o tipo de tag correspondente à ferramenta que deseja utilizar. Por exemplo, para configurar o Google Analytics 4, utilize o tipo de tag do Google apropriado à medição do GA4. Informe os identificadores solicitados pela ferramenta. Passo 3 - Configurar o acionamento O acionamento determina quando a tag será executada. Para uma tag básica de acompanhamento de páginas, utilize um acionamento compatível com o carregamento das páginas do site. Outros tipos de tags podem exigir acionamentos específicos, como cliques, eventos ou interações. Passo 4 - Salvar Depois de configurar: 1. Confira a tag. 2. Verifique o acionamento selecionado. 3. Clique em Salvar. A tag ficará disponível no espaço de trabalho do Google Tag Manager. Importante: Uma tag salva ainda precisa ser publicada para entrar em funcionamento no site. 7 - Testando a Instalação Antes de publicar ou utilizar suas tags, recomendamos validar o funcionamento do contêiner. Passo 1 - Abrir o modo de visualização 1. Acesse o Google Tag Manager. 2. Abra o contêiner configurado. 3. Clique em Visualizar. 4. Informe o endereço público da sua loja. 5. Inicie a conexão de depuração. O Google poderá abrir a loja em uma nova janela e apresentar as informações de depuração no Tag Assistant. Passo 2 - Navegar pela loja Com a visualização ativa: 1. Acesse a página inicial da loja. 2. Abra uma categoria. 3. Visualize um produto. 4. Navegue entre outras páginas disponíveis. 5. Retorne ao ambiente de depuração. Passo 3 - Conferir os resultados Verifique se o contêiner foi identificado e se as tags configuradas estão sendo executadas conforme seus acionamentos. Se o contêiner não aparecer, confira o Container ID, a ativação da integração e as condições do navegador. Dica: Faça o teste antes de publicar alterações importantes, principalmente quando elas envolvem acompanhamento de compras ou conversões. 8 - Publicando as Alterações Após criar e testar as tags, será necessário publicar as modificações realizadas no Google Tag Manager. Como publicar? 1. Entre no painel do Google Tag Manager. 2. Abra o espaço de trabalho do contêiner. 3. Clique em Enviar. 4. Confira as alterações. 5. Informe um nome e uma descrição para a versão, quando solicitado. 6. Conclua a publicação. Após a publicação, as tags da versão passam a estar disponíveis no site conforme suas configurações e condições de acionamento. Importante: Salvar a integração na Nortgraf e publicar as alterações no Google Tag Manager são procedimentos diferentes. A Nortgraf instala o contêiner. O Google Tag Manager administra e publica as tags. 9 - Utilizando o Google Analytics com o Tag Manager O Google Tag Manager pode ser utilizado para carregar a tag do Google Analytics 4. Se você optar por esse método, organize sua configuração para evitar instalar a mesma medição mais de uma vez. Exemplo Sua loja pode possuir: Google Tag Manager: Carrega o contêiner GTM-XXXXXXX. Google Analytics 4: Recebe os eventos enviados por uma tag configurada dentro do contêiner. Nesse cenário, a medição do GA4 é administrada pelo Google Tag Manager. Evitando eventos duplicados Se o Google Analytics também estiver ativado diretamente nas configurações da Nortgraf, verifique se não existem duas implementações enviando os mesmos eventos. Isso pode provocar: - Contagem duplicada de visualizações; - Eventos repetidos; - Informações inconsistentes em relatórios; - Resultados incorretos de campanhas. Dica: Defina um método principal para administrar cada tag de acompanhamento e mantenha sua implementação organizada. 10 - Desativando o Google Tag Manager Se desejar interromper o carregamento do contêiner pela integração: 1. Acesse Configurações > Integrações. 2. Abra Google Tag Manager. 3. Localize a seção Ativação. 4. Desabilite Carregar o container na loja. 5. Clique em Salvar. Após a desativação, a Nortgraf deixa de inserir o snippet controlado por essa integração. O que acontece com as tags? As tags permanecem cadastradas no Google Tag Manager, mas não serão carregadas por esse contêiner através da integração desativada. Se existirem outros métodos de instalação do Google Tag Manager ou das mesmas ferramentas, eles deverão ser verificados separadamente. Importante: Desativar a integração na Nortgraf não exclui sua conta, o contêiner nem as configurações existentes no Google Tag Manager. 11 - Seções de Referência Container Reúne os campos utilizados para configurar a instalação do Google Tag Manager. Container ID Identificador do contêiner, normalmente iniciado por GTM-. Script completo Campo opcional para fornecer um código personalizado de instalação, substituindo o snippet padrão gerado pela Nortgraf. Ativação Permite controlar se a integração deverá carregar o contêiner na loja. Carregar o container na loja Quando habilitado, autoriza a inserção do snippet configurado nas páginas da loja. 12 - Problemas Comuns Não encontro o Container ID. Acesse o Google Tag Manager, abra o contêiner da sua loja e localize o identificador iniciado por GTM-. O contêiner não aparece no Tag Assistant. Confira se a integração está ativada, se o Container ID está correto e se o endereço informado corresponde à sua loja. Também verifique se existem bloqueadores de rastreamento ou outras condições que impeçam o carregamento. Preciso informar o Script completo? Não. Esse campo é opcional. Para a instalação padrão, informe apenas o Container ID e habilite a integração. Configurei uma tag, mas ela não funciona. Confira se a tag foi salva, se possui um acionamento válido e se as alterações foram publicadas no Google Tag Manager. Minhas tags funcionam no modo de visualização, mas não na loja. Verifique se a versão contendo as alterações foi publicada e se as condições de acionamento são atendidas durante a navegação normal. Os eventos estão sendo registrados duas vezes. Confira se a mesma ferramenta foi instalada diretamente na Nortgraf e também pelo Google Tag Manager. O Google Analytics não recebe eventos. Verifique se a tag de medição foi criada corretamente, se o identificador do GA4 está correto e se a versão do contêiner foi publicada. O código personalizado não funciona. Confira o conteúdo informado em Script completo. Quando preenchido, esse campo substitui o snippet padrão da Nortgraf. Troquei o Container ID. Preciso alterar as tags? As tags pertencem ao contêiner configurado no Google Tag Manager. Ao utilizar outro contêiner, confira se ele possui as tags e os acionamentos necessários. Desativei a integração, mas ainda encontro tags na loja. Verifique se existe outro método de instalação do Google Tag Manager ou se as ferramentas estão sendo carregadas diretamente por outras integrações. Preciso criar um contêiner para cada loja? Não é uma exigência universal do Google Tag Manager, mas utilizar contêineres separados pode facilitar a organização e evitar que alterações de uma loja afetem outra. Dica: Para a maioria das lojas, a configuração recomendada é simples: crie um contêiner Web no Google Tag Manager, copie o Container ID, informe-o na Nortgraf, habilite a integração e publique suas tags após testá-las no modo de visualização.
Google Ads
Google Ads Conecte sua loja ao Google Ads para acompanhar as conversões geradas pelas campanhas publicitárias, identificar compras provenientes de anúncios e avaliar os resultados dos seus investimentos em publicidade. Para que serve a integração? O Google Ads é a plataforma de publicidade do Google, utilizada para criar anúncios que aparecem nos resultados de pesquisa e em outros canais da rede de publicidade. A integração com a Nortgraf permite configurar o acompanhamento de conversões de compra realizadas na sua loja. Com essas informações, você pode avaliar quais campanhas estão gerando resultados e utilizar os dados de conversão nas ferramentas de análise e otimização do Google Ads. A Nortgraf permite informar o identificador e o rótulo de conversão, além de escolher se o acompanhamento das compras será realizado diretamente pela loja ou pelo Google Tag Manager. 1 - Atenção e Regras Antes de iniciar a configuração, observe algumas informações importantes: - Conta Google Ads: É necessário possuir uma conta ativa para criar e gerenciar campanhas publicitárias. - Conversões: Você deve configurar uma ação de conversão de compra no Google Ads. - Conversion ID: Identifica a configuração de acompanhamento do Google Ads. - Conversion Label: Identifica a ação de conversão que receberá os eventos. - Ativação: A opção Enviar conversões para o Google Ads deve estar habilitada para permitir o funcionamento da integração. - Google Tag Manager: É possível utilizar o GTM como responsável pelo acompanhamento das conversões de compra. - Duplicidade: A mesma compra não deve ser enviada por diferentes métodos sem uma configuração adequada. - Privacidade: A coleta e o compartilhamento de dados devem respeitar as regras aplicáveis de privacidade e consentimento. - Processamento: As conversões podem levar algum tempo para aparecer nos relatórios do Google Ads. Importante: Para evitar conversões duplicadas, utilize apenas um método principal de acompanhamento das compras: envio direto pela Nortgraf ou acompanhamento configurado pelo Google Tag Manager ou Google Analytics 4. 2 - Criando sua Conta no Google Ads Caso ainda não utilize o Google Ads, será necessário criar uma conta. Passo 1 - Acessar a plataforma 1. Acesse ads.google.com. 2. Entre com sua conta Google. 3. Inicie a configuração de uma nova conta. 4. Informe os dados solicitados. 5. Configure as informações comerciais e de faturamento necessárias. 6. Conclua o cadastro. Após criar a conta, você poderá acessar os recursos de campanhas e acompanhamento de conversões. Passo 2 - Conferir as configurações Antes de iniciar a integração, verifique se: - A conta pertence à empresa ou loja correta. - O fuso horário está configurado adequadamente. - A moeda corresponde à utilizada nas campanhas. - Você possui acesso às configurações de conversão. Dica: Se você administra anúncios de diferentes empresas ou lojas, confira se está utilizando a conta correta antes de copiar os identificadores de conversão. 3 - Criando uma Ação de Conversão Para acompanhar compras realizadas na Nortgraf, você precisará configurar uma ação de conversão no Google Ads. Passo 1 - Acessar as conversões 1. Entre no painel do Google Ads. 2. Acesse a área Metas. 3. Localize Conversões. 4. Abra a seção de gerenciamento de ações de conversão. 5. Inicie a criação de uma nova ação, quando necessário. Os nomes e a organização das opções podem variar conforme a interface disponibilizada pelo Google. Passo 2 - Selecionar a origem Para configurar o acompanhamento de compras realizadas no site, selecione a origem de dados correspondente à sua loja. Em uma implementação com tag do Google Ads, utilize o acompanhamento de conversões de site. Se você pretende importar conversões do Google Analytics 4, configure a origem correspondente no Google Ads. Passo 3 - Configurar a compra Na criação da ação, configure as informações solicitadas. Categoria da conversão Selecione Compra. Nome da conversão Utilize um nome que identifique o evento, como Compra na Loja. Valor Configure como os valores das compras serão considerados no acompanhamento. Contagem Escolha a regra apropriada para contabilizar as conversões. Janela de conversão Defina o período utilizado pelo Google Ads para atribuir conversões aos anúncios. Após preencher as informações, conclua a criação da ação de conversão. Importante: Para vendas, normalmente é interessante registrar o valor real das compras e permitir a contabilização de transações distintas. Confira as opções disponíveis conforme sua estratégia de publicidade. 4 - Obtendo o Conversion ID e o Conversion Label Depois de criar a ação de conversão, será necessário obter os identificadores utilizados pela integração. Passo 1 - Localizar os dados 1. Acesse a área de conversões do Google Ads. 2. Abra a ação de conversão criada para compras. 3. Consulte as instruções de configuração da tag. 4. Localize o identificador e o rótulo de conversão. 5. Copie os valores apresentados. Conversion ID É o identificador utilizado pelo Google Ads para reconhecer a configuração de acompanhamento. Normalmente possui o formato: AW-XXXXXXXXX Conversion Label É o rótulo associado à ação de conversão. Ele permite identificar qual ação deverá receber os eventos enviados. O Conversion Label é diferente do Conversion ID. Ambos devem corresponder à configuração desejada. Atenção: Não confunda o Conversion ID do Google Ads com o ID do Google Analytics ou com o identificador do contêiner do Google Tag Manager. 5 - Configurando o Google Ads na Nortgraf Com os identificadores em mãos, acesse o painel administrativo da sua loja. Passo 1 - Acessar a integração 1. Entre no painel administrativo da Nortgraf. 2. Acesse Configurações > Integrações. 3. Localize Google Ads. 4. Abra a página de configuração. A tela apresenta as seções: - Conversão - Origem da conversão de compra - Ativação Passo 2 - Informar o Conversion ID Na seção Conversão: 1. Localize o campo Conversion ID. 2. Informe o identificador copiado do Google Ads. 3. Confira se o código corresponde à configuração correta. Exemplo: AW-XXXXXXXXX Passo 3 - Informar o Conversion Label Ainda na seção Conversão: 1. Localize o campo Conversion Label. 2. Cole o rótulo fornecido pelo Google Ads. 3. Confira se ele pertence à ação de conversão de compra desejada. Passo 4 - Ativar a integração Na seção Ativação: 1. Localize Enviar conversões para o Google Ads. 2. Habilite a opção. 3. Confira as configurações. 4. Clique em Salvar. Importante: Se essa opção estiver desabilitada, a Nortgraf não enviará conversões por essa integração, mesmo que o Conversion ID e o Conversion Label estejam preenchidos. 6 - Escolhendo a Origem da Conversão de Compra A Nortgraf permite definir como as conversões de compra serão acompanhadas. Na seção Origem da conversão de compra, você encontrará a opção: Enviar conversões de compra pelo Google Tag Manager Essa configuração determina se a loja utilizará o envio direto ou deixará o acompanhamento a cargo de uma configuração externa. Opção desabilitada — Envio direto pela Nortgraf Quando essa opção está desabilitada, a integração pode utilizar o envio direto de conversões de compra, conforme as configurações e os eventos disponíveis. Essa modalidade é indicada quando você deseja utilizar o acompanhamento de conversões fornecido pela integração da Nortgraf. Opção habilitada — Google Tag Manager Quando essa opção está habilitada, a Nortgraf desativa o envio direto da conversão de compra. Nesse cenário, você deve ter configurado o acompanhamento por outro método, como: - Uma tag de conversão do Google Ads acionada pelo evento de compra no Google Tag Manager. - Uma conversão importada do Google Analytics 4 para o Google Ads, quando o GA4 estiver configurado para receber e registrar o evento correspondente. Qual opção escolher? Utiliza a integração direta da Nortgraf? Mantenha a opção de envio pelo Google Tag Manager desabilitada. Já acompanha as compras pelo Google Tag Manager ou importa conversões do GA4? Habilite a opção para impedir que a Nortgraf também envie diretamente a mesma conversão. Atenção: Ativar essa opção não cria automaticamente uma tag no Google Tag Manager nem uma conversão no GA4. O acompanhamento alternativo precisa estar previamente configurado e funcionando. 7 - Configurando Conversões pelo Google Tag Manager Se você utiliza o Google Tag Manager para acompanhar as compras, configure a tag correspondente no contêiner da sua loja. Passo 1 - Acessar o contêiner 1. Entre em tagmanager.google.com. 2. Abra o contêiner utilizado pela loja. 3. Acesse Tags. 4. Crie uma nova tag. Passo 2 - Selecionar a tag Escolha o tipo de tag correspondente ao acompanhamento de conversões do Google Ads. Informe os identificadores solicitados, incluindo: - Conversion ID; - Conversion Label. Configure também as informações da conversão necessárias à sua implementação. Passo 3 - Configurar o acionamento Defina um acionamento associado ao evento de compra. Na integração, o evento utilizado como referência é purchase. Confira se o evento está sendo disponibilizado corretamente na implementação antes de criar o acionamento. Passo 4 - Testar e publicar 1. Utilize o modo de visualização do Google Tag Manager. 2. Realize uma compra de teste, quando apropriado. 3. Confira se a tag dispara no momento esperado. 4. Verifique se ela não é executada mais de uma vez para a mesma compra. 5. Publique as alterações após validar o comportamento. Importante: Após configurar o acompanhamento no GTM, habilite na Nortgraf a opção Enviar conversões de compra pelo Google Tag Manager para evitar o envio direto duplicado. 8 - Utilizando Conversões Importadas do Google Analytics 4 Outra possibilidade é acompanhar as compras pelo Google Analytics 4 e utilizar esses dados no Google Ads. Nesse modelo, o GA4 recebe os eventos e o Google Ads utiliza as conversões disponibilizadas pela integração entre as plataformas. Como funciona? 1. Configure o Google Analytics 4 para receber os eventos desejados. 2. Verifique se as compras estão sendo registradas corretamente. 3. Vincule as contas do Google Analytics e do Google Ads. 4. Configure a utilização dos eventos de compra como conversões no Google Ads. 5. Confira o recebimento e a atribuição dos dados. Na Nortgraf, habilite o acompanhamento pelo Google Tag Manager quando essa for sua estratégia de conversão de compra, evitando o envio direto simultâneo. Atenção: O Google Analytics 4 e o Google Ads são ferramentas diferentes. A importação depende das configurações realizadas nas duas plataformas e não acontece apenas por informar os identificadores na Nortgraf. 9 - Testando o Acompanhamento de Conversões Após configurar a integração, recomendamos validar se as conversões estão sendo registradas corretamente. Passo 1 - Conferir as configurações Na Nortgraf: 1. Abra a integração Google Ads. 2. Verifique o Conversion ID. 3. Confira o Conversion Label. 4. Confirme que o envio de conversões está ativado. 5. Verifique a origem de conversão selecionada. 6. Salve as alterações, se necessário. Passo 2 - Realizar um teste Utilize uma operação de teste apropriada ao seu ambiente. Confira se o mecanismo de acompanhamento está sendo executado no momento esperado. Se você utiliza o Google Tag Manager, faça a verificação pelo modo de visualização. Passo 3 - Verificar no Google Ads 1. Acesse sua conta do Google Ads. 2. Abra a área de conversões. 3. Localize a ação configurada. 4. Consulte o diagnóstico e o status disponíveis. 5. Aguarde o processamento dos eventos, quando necessário. Importante: Uma conversão tecnicamente enviada não significa que será imediatamente atribuída a uma campanha ou apresentada nos relatórios. A contabilização depende das regras de medição e atribuição do Google Ads. 10 - Evitando Conversões Duplicadas Um dos cuidados mais importantes é impedir que uma mesma compra seja contabilizada mais de uma vez. Exemplo de duplicidade Considere uma compra realizada por um cliente após clicar em um anúncio. Se a Nortgraf enviar diretamente uma conversão e o Google Tag Manager também enviar outra para a mesma ação, poderá ocorrer duplicidade. Isso pode prejudicar a análise de resultados e a otimização das campanhas. Como evitar? Defina qual sistema será responsável pelo acompanhamento. Envio direto pela Nortgraf Utilize os identificadores do Google Ads e mantenha desabilitada a opção de envio pelo Google Tag Manager. Envio pelo Google Tag Manager Configure a tag no contêiner e habilite a opção correspondente na Nortgraf. Conversão importada do Google Analytics 4 Configure a importação no Google Ads e evite utilizar simultaneamente outra ação para contabilizar a mesma compra como conversão principal. Dica: Revise periodicamente suas ações de conversão e suas configurações de atribuição para garantir que os relatórios representem corretamente os resultados das campanhas. 11 - Desativando a Integração Se desejar interromper o envio de conversões controlado pela Nortgraf: 1. Acesse Configurações > Integrações. 2. Abra Google Ads. 3. Localize a seção Ativação. 4. Desabilite Enviar conversões para o Google Ads. 5. Clique em Salvar. Após a desativação, a integração deixa de realizar os envios de conversão controlados por essa configuração. O que acontece com as campanhas? As campanhas continuam sendo administradas no Google Ads. Desativar a integração não pausa anúncios, não cancela campanhas e não encerra sua conta no Google Ads. Atenção: Se você utiliza Google Tag Manager ou Google Analytics 4 para enviar conversões, confira essas configurações separadamente. 12 - Seções de Referência Conversão Reúne os identificadores utilizados para configurar o acompanhamento de compras. Conversion ID Identificador do Google Ads, normalmente iniciado por AW-. Conversion Label Rótulo que identifica a ação de conversão configurada. Origem da conversão de compra Permite definir se o envio direto será utilizado ou se a conversão será acompanhada por uma configuração alternativa. Enviar conversões de compra pelo Google Tag Manager Quando habilitado, desativa o envio direto da conversão de compra pela Nortgraf. Ativação Reúne o controle de habilitação da integração. Enviar conversões para o Google Ads Permite ativar ou desativar o envio de conversões controlado pela integração. 13 - Problemas Comuns Não encontro o Conversion ID. Acesse a área de conversões do Google Ads, abra a ação desejada e consulte as instruções de configuração da tag. Não encontro o Conversion Label. Confira os dados de configuração da ação de conversão. O rótulo é disponibilizado nas informações necessárias à instalação da tag correspondente. As conversões não aparecem no Google Ads. Confira os identificadores informados, a ativação da integração e a origem de conversão selecionada. Também verifique se existe uma implementação válida registrando as compras. Os campos estão preenchidos, mas nenhuma conversão é enviada. Verifique se a opção Enviar conversões para o Google Ads está habilitada. Ativei o Google Tag Manager e as conversões pararam de aparecer. Confira se a tag de conversão está corretamente configurada, se possui o acionamento adequado e se as alterações foram publicadas no contêiner. A opção da Nortgraf não cria automaticamente essa configuração no Google Tag Manager. As compras estão sendo contabilizadas duas vezes. Verifique se existem múltiplos métodos de acompanhamento enviando a mesma compra, como integração direta, Google Tag Manager e conversões importadas do GA4. Preciso utilizar o Google Tag Manager obrigatoriamente? Não. A integração possui configuração para envio direto de conversões de compra. O Google Tag Manager é uma alternativa quando você prefere administrar o acompanhamento por meio de um contêiner. O Google Ads informa que a tag está inativa. Confira se a integração está habilitada e se o método de acompanhamento configurado está efetivamente executando a tag ou enviando os eventos esperados. As conversões aparecem com atraso. O Google Ads pode levar algum tempo para processar e disponibilizar informações nos relatórios. Consulte o diagnóstico da ação e aguarde o processamento. Alterei o Conversion ID ou o Conversion Label. Preciso fazer alguma coisa? Confira se os novos identificadores correspondem à ação correta e realize uma nova validação do acompanhamento. Desativei a integração, mas ainda aparecem conversões. Verifique se existem conversões enviadas por outras ferramentas ou configurações independentes da Nortgraf. Dica: Antes de investir em campanhas, valide o acompanhamento de uma compra e confirme que apenas um método está registrando a conversão principal. Uma configuração correta ajuda a analisar resultados sem contagens duplicadas.
Google Shopping
Google Shopping Configure sua loja para disponibilizar produtos ao Google Shopping por meio de um feed XML, permitindo que o Google Merchant Center consulte as informações do seu catálogo, como produtos, descrições, preços e disponibilidade. Para que serve a integração? O Google Shopping permite que produtos de lojas virtuais sejam apresentados nos serviços de compras do Google, conforme os requisitos e as políticas da plataforma. A integração da Nortgraf disponibiliza um feed XML de produtos, que pode ser cadastrado como fonte de dados no Google Merchant Center. Esse arquivo reúne informações do catálogo e pode ser consultado pelo Google para manter os dados dos produtos atualizados. Na Nortgraf, você pode configurar uma descrição padrão para produtos sem descrição própria, selecionar quais categorias devem participar do feed e consultar o endereço XML utilizado na integração. 1 - Atenção e Regras Antes de iniciar a configuração, observe algumas informações importantes: - Conta Google: É necessário possuir uma conta Google para acessar o Google Merchant Center. - Google Merchant Center: É a plataforma utilizada para cadastrar e administrar os produtos disponibilizados ao Google. - Feed XML: A Nortgraf fornece um endereço que permite consultar os dados dos produtos da loja. - Descrição padrão: É utilizada quando um produto não possui uma descrição própria disponível para o feed. - Categoria: É possível selecionar uma categoria específica da loja ou disponibilizar produtos de todas as categorias. - Produtos: Os produtos devem possuir informações comerciais corretas, como nome, preço e demais dados necessários à publicação. - Disponibilidade: A inclusão dos produtos nos serviços do Google depende das regras e verificações realizadas pelo Merchant Center. - Atualização: O XML é gerado no momento da consulta e considera as configurações salvas na Nortgraf. - Aprovação: A existência do feed não garante que todos os produtos serão aprovados ou exibidos pelo Google. Importante: A Nortgraf disponibiliza o feed de produtos. O cadastro da fonte de dados, a análise dos produtos e a administração da conta são realizados no Google Merchant Center. 2 - Criando uma Conta no Google Merchant Center Caso ainda não utilize o Google Merchant Center, será necessário criar uma conta para sua empresa. Passo 1 - Acessar o Merchant Center 1. Acesse merchants.google.com. 2. Entre com sua conta Google. 3. Inicie o cadastro da empresa. 4. Informe o nome comercial da loja. 5. Preencha as informações solicitadas. 6. Informe o endereço público do seu site. 7. Conclua as etapas iniciais de configuração. Durante esse processo, o Google poderá solicitar informações adicionais sobre sua empresa e a operação comercial. Passo 2 - Configurar as informações comerciais No Merchant Center, confira as informações relacionadas à sua loja, como: - Nome da empresa; - Endereço do site; - País de atuação; - Informações de contato; - Condições de entrega; - Políticas de devolução, quando aplicáveis. Essas informações ajudam o Google a avaliar a consistência do catálogo e a experiência oferecida aos consumidores. Dica: Utilize os mesmos dados comerciais apresentados publicamente em sua loja na Nortgraf para evitar divergências. 3 - Verificando o Endereço da Loja O Google Merchant Center pode exigir que você comprove a propriedade do endereço utilizado pela loja. Como funciona? Durante a configuração, o Google apresenta os métodos disponíveis para verificar o site. Dependendo das opções oferecidas, a verificação poderá utilizar recursos como uma tag HTML, ferramentas do Google ou outros mecanismos de comprovação. O que fazer? 1. Abra as configurações do site no Merchant Center. 2. Consulte os métodos de verificação disponíveis. 3. Escolha um método compatível com a configuração da sua loja. 4. Siga as instruções apresentadas pelo Google. 5. Aguarde a confirmação. Importante: A verificação do site é um procedimento do Google Merchant Center e não substitui a configuração do feed XML na Nortgraf. 4 - Acessando o Google Shopping na Nortgraf Depois de preparar sua conta no Google Merchant Center, acesse o painel administrativo da Nortgraf. Passo 1 - Abrir a integração 1. Entre no painel administrativo da sua loja. 2. Acesse Configurações > Integrações. 3. Localize Google Shopping. 4. Abra a página de configuração. A tela apresenta duas seções principais: Conteúdo do feed Permite configurar a descrição padrão e a categoria dos produtos disponibilizados no XML. URL do XML Apresenta o endereço utilizado para consultar o feed de produtos da loja. 5 - Configurando a Descrição Padrão do Feed Na seção Conteúdo do feed, localize o campo Descrição padrão do feed. Esse campo permite definir um texto que será utilizado quando o produto não possuir uma descrição própria disponível para o XML. Como configurar? 1. Acesse a integração Google Shopping. 2. Localize Descrição padrão do feed. 3. Informe um texto que represente adequadamente os produtos da loja. 4. Confira o conteúdo. 5. Salve as configurações. Exemplo de descrição "Produtos personalizados com diferentes opções de materiais, formatos e acabamentos. Confira as especificações e escolha a configuração ideal para sua necessidade." Esse texto é apenas um exemplo e deverá ser adaptado aos produtos comercializados pela loja. Quando a descrição será utilizada? Quando um produto possuir sua própria descrição, o feed poderá utilizar as informações específicas do produto. A descrição padrão funciona como uma alternativa para produtos sem descrição própria. Importante: Recomendamos cadastrar descrições individuais e completas nos produtos. Uma descrição específica costuma representar melhor suas características do que um texto genérico. 6 - Selecionando as Categorias do Feed Ainda na seção Conteúdo do feed, você encontrará o campo Categoria. Essa configuração permite determinar quais produtos poderão participar do XML de acordo com sua categoria na Nortgraf. Todas as categorias Ao selecionar Todas as categorias, a configuração não aplica um filtro para restringir o feed a uma categoria específica. Essa opção é indicada quando você deseja disponibilizar o catálogo elegível da loja sem limitar a integração a uma única categoria. Categoria específica Você também pode selecionar uma das categorias cadastradas na loja. Exemplos: - Cartões de Visita; - Adesivos; - Banners; - Camisetas; - Brindes Personalizados. Nesse caso, o feed será configurado para considerar a categoria selecionada. Como configurar? 1. Abra Configurações > Integrações > Google Shopping. 2. Localize o campo Categoria. 3. Selecione Todas as categorias ou uma categoria específica. 4. Salve as configurações. Atenção: O campo Categoria utiliza as categorias cadastradas na Nortgraf. Ele não representa a classificação oficial de categorias de produtos do Google. 7 - Obtendo a URL do XML A seção URL do XML apresenta o endereço do feed de produtos gerado pela Nortgraf. Esse endereço deverá ser cadastrado no Google Merchant Center como fonte de dados dos produtos. Passo 1 - Copiar o endereço 1. Acesse a integração Google Shopping. 2. Localize a seção URL do XML. 3. Clique no campo que apresenta o endereço. 4. Copie a URL completa. O endereço segue a estrutura: https://seudominio.com.br/feed/google-merchant.xml O domínio utilizado será o endereço correspondente à sua loja. Passo 2 - Consultar o XML A Nortgraf também disponibiliza a opção Abrir XML. Clique nessa opção para visualizar o conteúdo gerado. O navegador abrirá o endereço do feed, permitindo verificar se o arquivo está acessível. Como funciona a atualização? O XML é gerado no momento em que seu endereço é acessado. Isso significa que alterações salvas na configuração do Google Shopping poderão ser consideradas nas próximas consultas ao feed. Importante: A atualização imediata do XML na Nortgraf não significa atualização instantânea dos produtos no Google Merchant Center. O Google possui seus próprios processos de consulta, processamento e aprovação. 8 - Cadastrando o Feed no Google Merchant Center Depois de copiar a URL disponibilizada pela Nortgraf, retorne ao Google Merchant Center. Passo 1 - Acessar as fontes de dados 1. Entre no Google Merchant Center. 2. Localize a área de Produtos. 3. Acesse a configuração de Fontes de dados. 4. Inicie a inclusão de uma nova fonte de produtos. Os nomes dos menus podem variar conforme a versão do Merchant Center disponibilizada pelo Google. Passo 2 - Selecionar o método de inclusão Escolha um método que permita ao Google consultar um arquivo de produtos por meio de uma URL. Quando disponível, utilize a opção de arquivo hospedado em um endereço da internet ou de busca programada. Passo 3 - Informar a URL 1. Informe um nome para identificar a fonte de dados. 2. Cole a URL XML copiada da Nortgraf. 3. Configure a frequência de consulta, quando solicitado. 4. Confira as informações. 5. Salve a fonte de dados. Passo 4 - Iniciar o processamento Após cadastrar a fonte, o Google poderá iniciar a consulta do arquivo e o processamento dos produtos. Acompanhe o resultado no painel do Merchant Center. Importante: Para funcionar, a URL precisa estar acessível ao Google. O feed não deve exigir login administrativo para ser consultado. 9 - Conferindo os Produtos Importados Após cadastrar o feed, verifique se os produtos estão sendo processados corretamente. Passo 1 - Consultar o resultado 1. Acesse o Google Merchant Center. 2. Abra a fonte de dados cadastrada. 3. Consulte o status da atualização. 4. Verifique a quantidade de produtos processados. 5. Analise os avisos e erros apresentados. Passo 2 - Conferir as informações Verifique se os produtos apresentam corretamente: - Nome; - Descrição; - Imagem; - Preço; - Disponibilidade; - Endereço da página do produto; - Demais atributos exigidos pelo Google. A presença de cada informação depende dos dados existentes no cadastro e do conteúdo efetivamente disponibilizado no feed. Passo 3 - Corrigir inconsistências Caso o Google identifique algum erro: 1. Consulte a mensagem apresentada no Merchant Center. 2. Identifique o produto afetado. 3. Confira os dados cadastrados na Nortgraf. 4. Realize as correções necessárias. 5. Aguarde uma nova consulta do feed. Dica: Antes de disponibilizar o catálogo completo, confira alguns produtos representativos da sua loja para verificar se as informações estão sendo interpretadas corretamente. 10 - Preparando os Produtos para o Google Shopping A qualidade das informações cadastradas influencia diretamente a consistência do feed e a possibilidade de aprovação dos produtos. Nome do produto Utilize nomes claros, que identifiquem o item comercializado. Evite títulos genéricos que não descrevam adequadamente o produto. Descrição Cadastre uma descrição com as principais características do produto. Sempre que possível, utilize o campo próprio do produto em vez de depender da descrição padrão do feed. Imagens Utilize imagens nítidas e representativas. Confira também as políticas do Google referentes às imagens de produtos. Preço Verifique se o preço informado no catálogo corresponde às condições apresentadas na página do produto. Produtos personalizáveis podem exigir atenção especial quando o preço final depende das opções escolhidas pelo cliente. Disponibilidade Mantenha as informações de disponibilidade atualizadas. Informações comerciais Confira as condições de frete, pagamento, entrega e demais informações apresentadas na loja. Atenção: O Google possui requisitos próprios para produtos anunciados ou apresentados gratuitamente. Alguns produtos podem precisar de dados adicionais ou não serem elegíveis para determinadas experiências de compra. 11 - Atualizando o Catálogo O feed XML da Nortgraf é gerado quando seu endereço é consultado. Portanto, alterações realizadas na loja poderão aparecer no conteúdo do arquivo após serem salvas e consideradas pelo processo de geração. Exemplos de alterações - Atualização de descrições; - Alteração de preços; - Atualização de produtos; - Mudança da categoria selecionada; - Alteração da descrição padrão. O que fazer após alterar? 1. Salve as informações na Nortgraf. 2. Abra a integração Google Shopping. 3. Clique em Abrir XML. 4. Confira o conteúdo atualizado. 5. Aguarde a próxima consulta do Google Merchant Center. Se necessário, utilize as opções de atualização disponíveis no próprio Merchant Center. Importante: Não é necessário cadastrar uma nova URL sempre que o catálogo for atualizado, desde que o endereço do feed continue o mesmo. 12 - Google Shopping e Google Ads O Google Merchant Center e o Google Ads possuem finalidades relacionadas, mas diferentes. Google Merchant Center É utilizado para administrar as informações dos produtos, fontes de dados e requisitos de apresentação nos serviços de compras do Google. Google Ads É utilizado para criar e gerenciar campanhas publicitárias. Dependendo da modalidade de anúncio desejada, poderá ser necessário vincular as contas e concluir configurações adicionais. Como funciona? 1. Configure os produtos no Merchant Center. 2. Verifique se os produtos estão elegíveis. 3. Vincule as contas do Merchant Center e do Google Ads, quando necessário. 4. Configure as campanhas desejadas no Google Ads. Importante: Cadastrar o feed XML não cria campanhas publicitárias automaticamente. 13 - Seções de Referência Conteúdo do feed Reúne as configurações relacionadas às informações apresentadas no XML. Descrição padrão do feed Texto utilizado quando o produto não possui descrição própria. Categoria Permite escolher uma categoria da Nortgraf ou manter a opção Todas as categorias. URL do XML Apresenta o endereço público que deve ser cadastrado no Google Merchant Center. Abrir XML Permite consultar o feed gerado pela Nortgraf diretamente no navegador. 14 - Problemas Comuns Não encontro o endereço do feed XML. Acesse Configurações > Integrações > Google Shopping e localize a seção URL do XML. O Google Merchant Center não consegue acessar o arquivo. Confira se a URL foi copiada corretamente e se está acessível publicamente. Abra o endereço em uma janela anônima para verificar se o arquivo pode ser consultado sem autenticação. O XML está vazio ou possui poucos produtos. Confira os produtos cadastrados, sua disponibilidade e a categoria selecionada na integração. Também verifique se os produtos atendem às condições de inclusão utilizadas pelo feed. A descrição de um produto está genérica. Verifique se ele possui uma descrição própria. Quando não existe descrição individual disponível, o feed utiliza o texto padrão configurado na integração. Os produtos de determinada categoria não aparecem. Confira o campo Categoria e verifique se ele está restringindo a geração do XML a uma categoria específica. O Google informa que o preço está incorreto. Confira o preço cadastrado na Nortgraf e o valor apresentado ao cliente na página do produto. Em produtos personalizáveis, verifique se a configuração comercial é compatível com os requisitos do Google. O Google rejeitou a imagem do produto. Consulte a mensagem no Merchant Center e confira se a imagem atende aos requisitos da plataforma. O produto aparece no XML, mas não foi aprovado. A inclusão no feed não garante aprovação. Consulte o diagnóstico do produto no Merchant Center para identificar o motivo. Alterei um produto, mas o Google ainda apresenta as informações antigas. O XML é atualizado conforme sua geração, mas o Google realiza o processamento em seus próprios intervalos. Aguarde uma nova consulta ou utilize as opções de atualização disponíveis no Merchant Center. Preciso criar uma campanha no Google Ads para utilizar o Google Shopping? Depende do tipo de divulgação desejada. O Merchant Center pode oferecer experiências gratuitas para produtos elegíveis, enquanto campanhas pagas exigem configuração no Google Ads. A URL do XML mudou após alterar o domínio da loja. Confira o endereço apresentado na integração e atualize a fonte de dados cadastrada no Merchant Center, caso a URL anterior não seja mais válida. Preciso instalar algum aplicativo do Google na Nortgraf? Não para disponibilizar o feed XML. Utilize a integração Google Shopping da Nortgraf e cadastre a URL correspondente no Merchant Center. Dica: Antes de cadastrar o feed no Google Merchant Center, utilize Abrir XML para conferir se o arquivo está acessível e contém os produtos esperados. Isso facilita a identificação de erros de configuração antes do processamento pelo Google.
Meta Pixel
Meta Pixel Conecte sua loja ao Meta Pixel para acompanhar eventos de navegação e conversões, avaliar os resultados das campanhas e utilizar informações de comportamento dos visitantes nas ferramentas de publicidade do Facebook e Instagram. Para que serve a integração? O Meta Pixel é uma ferramenta de acompanhamento da Meta que permite registrar determinadas interações realizadas pelos visitantes em um site. Essas informações podem ser utilizadas para avaliar campanhas publicitárias, criar públicos personalizados e acompanhar ações importantes, como a visualização de produtos e a realização de compras, conforme os eventos implementados. A Nortgraf permite configurar o Pixel ID e o token de acesso da API de Conversões, além de habilitar o envio de eventos para a Meta. A integração pode utilizar recursos de acompanhamento pelo navegador e pelo servidor, conforme a configuração e os eventos disponíveis. 1 - Atenção e Regras Antes de iniciar a configuração, observe algumas informações importantes: - Conta Meta: É necessário possuir acesso às ferramentas comerciais da Meta. - Conjunto de dados: Você precisará de um Pixel ou conjunto de dados configurado para acompanhar eventos do seu site. - Pixel ID: Identifica o destino dos eventos enviados para a Meta. - Access Token: É uma credencial utilizada pela API de Conversões para autenticar o envio de eventos pelo servidor. - Ativação: A opção Enviar eventos para o Meta deve estar habilitada para ativar o Pixel nas páginas da loja. - Privacidade: A utilização do Pixel e da API de Conversões deve respeitar as regras aplicáveis de consentimento e tratamento de dados. - Eventos: Os eventos disponíveis dependem das funcionalidades implementadas e das interações realizadas na loja. - Duplicidade: Eventos enviados pelo navegador e pelo servidor precisam ser tratados corretamente para evitar contagens duplicadas. - Segurança: O token de acesso deve ser mantido em sigilo. Importante: Informar o Pixel ID não cria automaticamente campanhas, públicos personalizados ou anúncios na Meta. Esses recursos são configurados separadamente nas ferramentas de publicidade. 2 - Acessando as Ferramentas Comerciais da Meta Para configurar a integração, primeiro será necessário acessar o ambiente comercial da Meta. Passo 1 - Acessar o Gerenciador de Eventos 1. Acesse business.facebook.com. 2. Entre com sua conta. 3. Selecione o portfólio empresarial correspondente, quando solicitado. 4. Localize o Gerenciador de Eventos. 5. Abra a área de fontes de dados. Também é possível acessar o Gerenciador de Eventos diretamente pelo endereço business.facebook.com/events_manager2. Passo 2 - Conferir as permissões Verifique se sua conta possui acesso para gerenciar a fonte de dados utilizada pela loja. Dependendo da configuração da empresa, poderá ser necessário solicitar autorização ao administrador do portfólio empresarial. Dica: Utilize uma fonte de dados identificada com o nome da loja para facilitar o gerenciamento, principalmente quando você administra vários sites. 3 - Criando um Pixel na Meta Caso ainda não possua um Pixel configurado, será necessário criar uma fonte de dados para acompanhar os eventos da loja. Passo 1 - Adicionar uma fonte de dados 1. Abra o Gerenciador de Eventos. 2. Localize a opção de conectar ou adicionar uma fonte de dados. 3. Selecione a opção correspondente a Web. 4. Informe um nome para identificar o conjunto de dados. 5. Continue a configuração. A organização das opções pode variar conforme a interface disponibilizada pela Meta. Passo 2 - Informar o endereço da loja Quando solicitado, informe o endereço público utilizado pelos clientes para acessar sua loja. Exemplo: https://www.sualoja.com.br Utilize o domínio principal da loja, incluindo o protocolo HTTPS. Passo 3 - Concluir a criação Finalize as etapas apresentadas pela Meta. Após a criação, a fonte de dados ficará disponível no Gerenciador de Eventos. Você poderá utilizar o identificador correspondente para configurar a integração na Nortgraf. 4 - Obtendo o Pixel ID O Pixel ID identifica o conjunto de dados que receberá os eventos. Como localizar? 1. Acesse o Gerenciador de Eventos. 2. Selecione a fonte de dados correspondente à sua loja. 3. Abra as informações ou configurações da fonte de dados. 4. Localize o identificador do Pixel ou do conjunto de dados. 5. Copie o número apresentado. O Pixel ID normalmente é composto por uma sequência numérica. Exemplo 123456789012345 Esse número é apenas ilustrativo. Importante: Utilize o identificador da fonte de dados correta. Um Pixel ID pertencente a outra loja fará com que os eventos sejam encaminhados ao destino incorreto. 5 - Configurando o Meta Pixel na Nortgraf Depois de obter o Pixel ID, acesse as configurações da Nortgraf. Passo 1 - Acessar a integração 1. Entre no painel administrativo da sua loja. 2. Acesse Configurações > Integrações. 3. Localize Meta Pixel. 4. Abra a página de configuração. A tela apresenta duas seções principais: Credenciais do Meta Reúne as informações necessárias para identificar e autenticar os recursos de acompanhamento. Ativação Permite habilitar ou desabilitar o envio de eventos para a Meta. Passo 2 - Informar o Pixel ID Na seção Credenciais do Meta: 1. Localize o campo Pixel ID. 2. Cole o identificador obtido no Gerenciador de Eventos. 3. Confira se o número corresponde à fonte de dados desejada. Passo 3 - Ativar o envio de eventos Na seção Ativação: 1. Localize Enviar eventos para o Meta. 2. Habilite a opção. 3. Clique em Salvar. Com a opção ativada, a Nortgraf poderá inserir o Pixel nas páginas da loja para acompanhar os eventos disponíveis. Importante: A ativação do Pixel não garante que todos os eventos de comércio eletrônico estejam disponíveis. O acompanhamento depende dos eventos efetivamente implementados e recebidos pela Meta. 6 - Configurando a API de Conversões A API de Conversões, também conhecida como Conversions API (CAPI), permite enviar eventos diretamente do servidor para a Meta. Esse método pode complementar o acompanhamento realizado pelo navegador. A Nortgraf disponibiliza o campo Access Token para configurar a credencial utilizada pela API. Passo 1 - Acessar as configurações 1. Entre no Gerenciador de Eventos da Meta. 2. Selecione a fonte de dados da sua loja. 3. Abra a seção Configurações. 4. Localize as opções relacionadas à API de Conversões. 5. Consulte as alternativas de configuração manual disponíveis. Passo 2 - Gerar o token de acesso Quando a opção estiver disponível: 1. Localize a configuração para gerar um token de acesso. 2. Confirme as permissões necessárias. 3. Gere o token. 4. Copie o valor apresentado. A Meta poderá exigir permissões adicionais ou procedimentos específicos dependendo da configuração da conta. Passo 3 - Informar o token na Nortgraf 1. Retorne à integração Meta Pixel. 2. Localize o campo Access Token. 3. Cole o token gerado. 4. Salve as configurações. Para que serve o token? O Access Token é utilizado para autenticar requisições destinadas à API de Conversões. Com ele, os mecanismos de envio pelo servidor podem encaminhar eventos à Meta, conforme os recursos implementados na plataforma. Atenção: O token de acesso é uma credencial privada. Não o compartilhe publicamente nem o adicione a scripts expostos aos visitantes. 7 - Diferença entre Pixel e API de Conversões Embora sejam relacionados, o Meta Pixel e a API de Conversões utilizam mecanismos diferentes para enviar eventos. Meta Pixel — Navegador O Pixel utiliza código executado no navegador do visitante. Esse mecanismo pode registrar eventos de navegação e outras interações realizadas nas páginas da loja. Seu funcionamento pode ser afetado por bloqueadores de rastreamento, preferências de privacidade e configurações de consentimento. API de Conversões — Servidor A API de Conversões utiliza requisições realizadas pelo servidor para encaminhar determinados eventos à Meta. Esse método não depende exclusivamente da execução de scripts no navegador. Entretanto, continua sujeito às regras de privacidade e à disponibilidade dos dados necessários. Posso utilizar os dois? Sim, desde que o envio seja configurado corretamente. Quando o mesmo evento é enviado pelo navegador e pelo servidor, os mecanismos devem permitir que a Meta reconheça as duas transmissões como referentes à mesma ação. Isso evita que uma única compra, por exemplo, seja contabilizada indevidamente duas vezes. Importante: A presença dos campos Pixel ID e Access Token não comprova, por si só, que todos os eventos utilizem envio duplo ou deduplicação. Confira o comportamento dos eventos no Gerenciador de Eventos. 8 - Testando a Integração Depois de salvar as configurações, recomendamos verificar se a Meta está recebendo os eventos da loja. Passo 1 - Acessar o Gerenciador de Eventos 1. Entre no Gerenciador de Eventos. 2. Selecione a fonte de dados utilizada pela loja. 3. Acesse a área de Testar eventos, quando disponível. Passo 2 - Navegar pela loja 1. Abra o endereço público da sua loja. 2. Acesse a página inicial. 3. Navegue pelas categorias. 4. Abra a página de um produto. 5. Realize algumas interações normalmente. Passo 3 - Conferir os eventos Retorne ao Gerenciador de Eventos e verifique se os eventos correspondentes às interações estão sendo recebidos. Os nomes e a quantidade de eventos podem variar conforme o funcionamento implementado na loja. Testando a API de Conversões Se você configurou o Access Token, consulte os diagnósticos disponíveis para verificar o recebimento de eventos enviados pelo servidor. A Meta pode disponibilizar informações sobre o método de conexão utilizado e eventuais problemas de processamento. Dica: Utilize os recursos de diagnóstico do Gerenciador de Eventos para identificar erros de configuração antes de utilizar os dados nas campanhas. 9 - Acompanhando os Eventos O Gerenciador de Eventos permite consultar informações relacionadas aos eventos recebidos pela fonte de dados. Dependendo da implementação, os eventos podem representar ações como: - Acesso a páginas; - Visualização de produtos; - Adição de itens ao carrinho; - Início da finalização de compra; - Compras concluídas. Esses exemplos representam eventos comuns no comércio eletrônico. A disponibilidade de cada um depende dos recursos efetivamente enviados pela integração. Como consultar? 1. Acesse o Gerenciador de Eventos. 2. Abra a fonte de dados correspondente. 3. Consulte a visão geral dos eventos. 4. Analise os indicadores e diagnósticos apresentados. Importante: Um evento recebido pela Meta não significa necessariamente que ele será atribuído a uma campanha publicitária. A atribuição depende das regras e dos critérios utilizados pela plataforma. 10 - Utilizando os Dados em Campanhas Depois de configurar a integração e confirmar o recebimento dos eventos, você poderá utilizar os recursos disponíveis nas ferramentas de publicidade da Meta. Públicos personalizados Permitem criar públicos com base em determinadas interações, quando os dados, permissões e condições de elegibilidade necessários estiverem disponíveis. Campanhas de conversão Permitem utilizar eventos como referência para estratégias de otimização de campanhas. Análise de resultados Os relatórios podem ajudar a compreender o desempenho dos anúncios e as ações realizadas pelos visitantes. Remarketing Dependendo das configurações e permissões disponíveis, você poderá criar campanhas direcionadas a públicos que interagiram anteriormente com sua loja. Atenção: A criação de públicos e campanhas é realizada nas ferramentas comerciais da Meta, e não na página de configuração do Pixel na Nortgraf. 11 - Evitando Eventos Duplicados A duplicidade de eventos pode ocorrer quando a mesma interação é registrada mais de uma vez sem um mecanismo adequado de identificação. Exemplo Um cliente conclui uma compra. Se o navegador enviar um evento de compra e o servidor também enviar outro referente à mesma transação, os eventos precisam ser identificados corretamente para permitir a deduplicação. Como evitar? - Verifique se o Pixel não foi instalado mais de uma vez. - Confira se a mesma tag não está sendo carregada simultaneamente por diferentes ferramentas. - Consulte os diagnósticos apresentados pela Meta. - Valide os mecanismos de deduplicação quando houver eventos enviados pelo navegador e pelo servidor. - Evite adicionar scripts manuais desnecessários. Dica: Se você utiliza Google Tag Manager ou outras ferramentas para carregar o Pixel, verifique se não existe uma segunda instalação ativa pela integração da Nortgraf. 12 - Desativando a Integração Se desejar interromper o acompanhamento controlado pela integração: 1. Acesse Configurações > Integrações. 2. Abra Meta Pixel. 3. Localize a seção Ativação. 4. Desabilite Enviar eventos para o Meta. 5. Clique em Salvar. A desativação interrompe a injeção do Pixel controlada por essa opção nas páginas da loja. O que acontece com os dados anteriores? Os eventos já recebidos pela Meta permanecem sujeitos às regras de retenção e gerenciamento da plataforma. Desativar a integração na Nortgraf não exclui automaticamente a fonte de dados, as campanhas ou a conta empresarial. Importante: Caso existam outros mecanismos de envio de eventos, como scripts externos ou integrações independentes, eles deverão ser verificados separadamente. 13 - Seções de Referência Credenciais do Meta Reúne os campos necessários à configuração dos recursos de acompanhamento. Pixel ID Identificador numérico da fonte de dados utilizada para receber os eventos. Access Token Credencial utilizada para autenticar o envio de eventos por meio da API de Conversões. Ativação Permite configurar o funcionamento da integração. Enviar eventos para o Meta Controla a ativação do Pixel nas páginas da loja. 14 - Problemas Comuns Não encontro o Pixel ID. Acesse o Gerenciador de Eventos, selecione a fonte de dados correspondente e consulte suas informações ou configurações. Não consigo gerar um Access Token. Confira se sua conta possui as permissões necessárias para administrar a fonte de dados e configurar a API de Conversões. O Pixel não aparece no Gerenciador de Eventos. Verifique se o Pixel ID informado na Nortgraf está correto e se a opção Enviar eventos para o Meta está habilitada. Os eventos não estão sendo registrados. Confira a configuração da integração, o endereço da loja, as condições do navegador e os diagnósticos disponibilizados pela Meta. Preciso informar o Access Token obrigatoriamente? Para a instalação básica do Pixel no navegador, normalmente é suficiente configurar o Pixel ID e ativar a integração. O Access Token é destinado ao envio de eventos pelo servidor. Os eventos aparecem duplicados. Verifique se existem múltiplas instalações do Pixel ou envios simultâneos pelo navegador e pelo servidor sem deduplicação adequada. A API de Conversões não está recebendo eventos. Confira o token de acesso, as permissões da fonte de dados e se existem eventos compatíveis com o envio pelo servidor na implementação da loja. Configurei o Pixel, mas não consigo criar públicos personalizados. Verifique as permissões da conta, as configurações da fonte de dados e os requisitos apresentados pelas ferramentas comerciais da Meta. As compras aparecem no Gerenciador de Eventos, mas não nas campanhas. A disponibilidade dos eventos para atribuição depende de fatores adicionais, incluindo configurações das campanhas e critérios da Meta. Troquei o Pixel ID. Preciso testar novamente? Sim. Após alterar o identificador, realize uma nova verificação para confirmar que os eventos estão sendo recebidos pela fonte de dados correta. Desativei a integração, mas ainda encontro eventos. Confira se existem outros mecanismos de instalação ou envio de eventos, como Google Tag Manager, scripts personalizados ou integrações independentes. O domínio da loja foi alterado. Preciso atualizar a Meta? Confira as configurações da fonte de dados e os domínios utilizados nas ferramentas comerciais da Meta. Depois, valide novamente o recebimento dos eventos. Dica: Após configurar o Meta Pixel, acesse o Gerenciador de Eventos e realize uma navegação de teste na sua loja. Confirme que os eventos estão chegando à fonte de dados correta e verifique os diagnósticos antes de utilizar essas informações em campanhas publicitárias.
Facebook Dynamic Ads
Facebook Dynamic Ads Integre o catálogo de produtos da sua loja aos anúncios dinâmicos do Facebook e Instagram, utilizando um feed XML para disponibilizar informações dos produtos ao Gerenciador de Comércio da Meta. Para que serve a integração? O Facebook Dynamic Ads permite utilizar os produtos cadastrados na sua loja em campanhas de publicidade da Meta. Por meio dessa funcionalidade, você pode criar um catálogo de produtos e utilizá-lo em anúncios no Facebook, Instagram e outros posicionamentos disponíveis. A Nortgraf disponibiliza um feed XML de produtos, que pode ser cadastrado como fonte de dados no Gerenciador de Comércio da Meta. Esse arquivo reúne informações do catálogo e é gerado automaticamente quando seu endereço é consultado. Após configurar o catálogo na Meta, você poderá utilizá-lo nas campanhas publicitárias compatíveis. 1 - Atenção e Regras Antes de iniciar a configuração, observe algumas informações importantes: - Conta Meta: É necessário possuir acesso às ferramentas comerciais da Meta. - Catálogo: Você precisará criar um catálogo no Gerenciador de Comércio. - Feed XML: A Nortgraf disponibiliza um endereço para consultar as informações dos produtos. - Atualização: O XML é gerado no momento do acesso e considera os dados disponíveis na loja. - Gerenciamento: A configuração do catálogo e das campanhas é realizada diretamente na Meta. - Meta Pixel: O acompanhamento dos eventos utilizados para relacionar visitantes e produtos depende da configuração do Pixel. - Disponibilidade: Os produtos precisam atender aos requisitos e às políticas comerciais da Meta. - Anúncios: A existência de um catálogo não significa que campanhas publicitárias serão criadas automaticamente. - Permissões: Sua conta precisa possuir autorização para administrar catálogos e campanhas no ambiente comercial da Meta. Importante: A página Facebook Dynamic Ads na Nortgraf é informativa. Não existem credenciais ou configurações para salvar nessa tela. O procedimento consiste em copiar o endereço do feed e utilizá-lo na Meta. 2 - Acessando as Ferramentas Comerciais da Meta Para começar, acesse o ambiente comercial utilizado para administrar seus produtos e campanhas. Passo 1 - Acessar a Meta 1. Entre em business.facebook.com. 2. Faça login com sua conta. 3. Selecione o portfólio empresarial correspondente, quando necessário. 4. Localize as ferramentas de gerenciamento de catálogos. Você também pode acessar o Gerenciador de Comércio para consultar os recursos disponíveis. Passo 2 - Conferir as permissões Antes de criar o catálogo, verifique se sua conta possui permissão para administrar os recursos comerciais da empresa. Se o catálogo pertencer a outra empresa ou portfólio empresarial, poderá ser necessário solicitar autorização ao administrador responsável. Dica: Utilize o mesmo portfólio empresarial empregado nas campanhas e na configuração do Meta Pixel da loja. 3 - Criando um Catálogo de Produtos Caso ainda não possua um catálogo na Meta, será necessário criá-lo. Passo 1 - Iniciar o cadastro 1. Acesse o Gerenciador de Comércio. 2. Localize a opção de criar um catálogo. 3. Selecione a modalidade destinada a produtos de comércio eletrônico. 4. Avance para as configurações do catálogo. A organização dos menus pode variar conforme a interface disponibilizada pela Meta. Passo 2 - Identificar o catálogo Informe um nome para identificar os produtos da sua loja. Exemplo: Catálogo de Produtos — Minha Loja Escolha um nome que facilite o reconhecimento do catálogo, principalmente se você administra mais de uma loja. Passo 3 - Concluir a criação Confira as informações solicitadas e finalize o cadastro. Após a criação, abra o catálogo para configurar a origem dos produtos. Importante: A criação do catálogo não importa automaticamente os produtos da Nortgraf. Será necessário cadastrar o feed XML como fonte de dados. 4 - Obtendo a URL do Feed na Nortgraf A Nortgraf disponibiliza um endereço específico para o catálogo de produtos utilizado pela Meta. Passo 1 - Acessar a integração 1. Entre no painel administrativo da Nortgraf. 2. Acesse Configurações > Integrações. 3. Localize Facebook Dynamic Ads. 4. Abra a página da integração. A tela apresenta duas seções: URL do feed de produtos Disponibiliza o endereço XML utilizado para carregar os produtos. Como usar Apresenta orientações resumidas para configurar o catálogo na Meta. Passo 2 - Copiar o endereço Na seção URL do feed de produtos: 1. Localize o campo com o endereço XML. 2. Clique no campo para selecionar seu conteúdo. 3. Copie a URL completa. O endereço segue o formato: https://seudominio.com.br/feed/facebook-products.xml O domínio será correspondente ao endereço da sua loja. Passo 3 - Conferir o feed Clique em Abrir feed para consultar o arquivo diretamente no navegador. O conteúdo será apresentado conforme os dados disponibilizados pelo catálogo da loja. Importante: O endereço do feed precisa estar acessível à Meta sem exigir login administrativo. 5 - Configurando o Feed de Dados na Meta Depois de copiar a URL, retorne ao Gerenciador de Comércio. Passo 1 - Abrir o catálogo 1. Acesse o catálogo criado anteriormente. 2. Localize a área de fontes de dados. 3. Inicie a inclusão de uma nova fonte. 4. Selecione a opção de utilizar um feed de dados. Passo 2 - Selecionar o método de atualização Quando disponível, escolha a opção de atualização por feed de dados agendado. Essa modalidade permite que a Meta consulte periodicamente o arquivo de produtos disponibilizado pela Nortgraf. Passo 3 - Informar a URL 1. Cole o endereço XML copiado da Nortgraf. 2. Confira se a URL está completa. 3. Configure as informações solicitadas pela Meta. 4. Defina a frequência de atualização. 5. Salve a fonte de dados. Passo 4 - Aguardar o processamento Após cadastrar a fonte, a Meta poderá iniciar a consulta e o processamento do arquivo. Acompanhe o resultado no Gerenciador de Comércio. Importante: O intervalo de atualização é controlado pela configuração realizada na Meta. A Nortgraf disponibiliza o conteúdo quando o endereço XML é consultado. 6 - Entendendo a Atualização do Catálogo O feed da Nortgraf é gerado no momento em que seu endereço é acessado. Isso significa que não é necessário gerar ou enviar manualmente um novo arquivo após cada alteração no catálogo da loja. Exemplo Você altera o preço ou a descrição de um produto na Nortgraf. Após salvar a alteração, o feed poderá apresentar as novas informações na próxima consulta, conforme as regras de geração dos dados. Quando a Meta consultar novamente o endereço XML, poderá processar o conteúdo atualizado. O que pode ser atualizado? Dependendo das informações disponibilizadas pelo feed, a atualização poderá refletir mudanças como: - Alterações de nomes; - Atualizações de descrições; - Mudanças de preços; - Atualizações de imagens; - Alterações de disponibilidade; - Inclusão ou remoção de produtos elegíveis. Atenção: A atualização do feed na Nortgraf não significa que os produtos serão modificados instantaneamente na Meta. A plataforma possui seus próprios processos de consulta, processamento e aprovação. 7 - Conferindo os Produtos Importados Depois que a Meta processar o feed, confira se os produtos foram recebidos corretamente. Passo 1 - Consultar o catálogo 1. Acesse o Gerenciador de Comércio. 2. Abra o catálogo configurado. 3. Localize a área de produtos. 4. Consulte os itens importados. Passo 2 - Verificar as informações Confira se os produtos apresentam corretamente: - Nome; - Descrição; - Imagem; - Preço; - Disponibilidade; - Link para a página do produto; - Identificador utilizado no catálogo. A presença dessas informações depende do conteúdo efetivamente disponibilizado no arquivo e dos requisitos da Meta. Passo 3 - Consultar os diagnósticos Se algum produto apresentar erro: 1. Abra os diagnósticos do catálogo. 2. Identifique a mensagem apresentada. 3. Localize o produto afetado. 4. Confira as informações cadastradas na Nortgraf. 5. Corrija os dados necessários. 6. Aguarde uma nova atualização do feed. Dica: Confira inicialmente alguns produtos com características diferentes para verificar se nomes, preços e imagens estão sendo interpretados corretamente. 8 - Preparando os Produtos para Anúncios Dinâmicos A qualidade do catálogo influencia a apresentação dos produtos nas ferramentas publicitárias. Nome do produto Utilize títulos claros e objetivos que identifiquem corretamente o item. Descrição Cadastre informações que ajudem o cliente a compreender as características do produto. Imagens Utilize imagens nítidas e representativas dos produtos comercializados. Confira também as políticas de imagens da Meta. Preço Mantenha os preços atualizados e consistentes com as informações apresentadas na loja. Disponibilidade Confira as condições de venda e disponibilidade. Link do produto Verifique se o endereço direciona corretamente o visitante para a página correspondente na loja. Importante: Produtos personalizáveis ou com preços variáveis podem exigir atenção adicional para atender aos requisitos de catálogo da Meta. 9 - Configurando o Meta Pixel Os anúncios dinâmicos podem utilizar eventos do Meta Pixel para relacionar as interações realizadas pelos visitantes aos produtos do catálogo. Por exemplo, a Meta pode utilizar eventos de visualização ou compra para identificar interações relevantes, conforme a implementação disponível. Como configurar? 1. Acesse Configurações > Integrações na Nortgraf. 2. Abra Meta Pixel. 3. Informe o Pixel ID. 4. Configure o Access Token, quando necessário. 5. Habilite Enviar eventos para o Meta. 6. Salve as configurações. Após ativar, consulte o Gerenciador de Eventos da Meta para verificar os eventos recebidos. Correspondência entre produtos e eventos Para utilizar eventos em campanhas baseadas em catálogo, a Meta precisa conseguir relacionar os identificadores enviados nos eventos aos produtos cadastrados no catálogo. Essa correspondência depende da implementação dos eventos e dos identificadores utilizados. Atenção: Apenas ativar o Meta Pixel não garante que todos os eventos necessários aos anúncios dinâmicos estejam disponíveis ou correspondam aos produtos do catálogo. Consulte o artigo Meta Pixel para conhecer as instruções completas de configuração. 10 - Criando Campanhas com o Catálogo Depois de configurar o catálogo e verificar os produtos, você poderá utilizá-lo nas campanhas disponíveis no Gerenciador de Anúncios. Passo 1 - Acessar o Gerenciador de Anúncios 1. Entre nas ferramentas comerciais da Meta. 2. Abra o Gerenciador de Anúncios. 3. Inicie a criação de uma campanha. 4. Selecione um objetivo compatível com anúncios de catálogo. Passo 2 - Associar o catálogo Durante a configuração: 1. Selecione o catálogo criado. 2. Escolha o conjunto de produtos, quando aplicável. 3. Configure o público desejado. 4. Defina orçamento e programação. 5. Configure os anúncios. Passo 3 - Publicar Revise as informações e publique a campanha. A disponibilidade dos recursos pode variar conforme o tipo de campanha, a conta e as funcionalidades oferecidas pela Meta. Importante: A criação, a publicação e o gerenciamento das campanhas acontecem na Meta. A Nortgraf é responsável por disponibilizar o feed de produtos. 11 - Catálogo e Remarketing Uma das possibilidades dos anúncios dinâmicos é utilizar informações do catálogo junto aos eventos de navegação para criar experiências publicitárias relacionadas aos produtos visualizados. Exemplo Um visitante acessa a página de determinado produto na sua loja. Se a configuração de eventos estiver correta e os identificadores corresponderem aos itens do catálogo, a Meta poderá utilizar essa interação em campanhas compatíveis. Requisitos importantes Para utilizar esse tipo de recurso, confira se: - O catálogo está atualizado; - Os produtos estão elegíveis; - O Meta Pixel está configurado; - Os eventos necessários estão sendo recebidos; - Os identificadores dos produtos são compatíveis; - As campanhas possuem as configurações e permissões exigidas pela Meta. Importante: Os recursos de remarketing dependem também das políticas, das regras de privacidade e das condições de elegibilidade estabelecidas pela Meta. 12 - Alterando ou Substituindo o Feed Se precisar alterar a origem dos produtos no catálogo da Meta, realize o procedimento diretamente no Gerenciador de Comércio. Quando atualizar a URL? Isso pode ser necessário, por exemplo, quando o domínio público da loja for alterado. Como proceder? 1. Acesse a integração Facebook Dynamic Ads na Nortgraf. 2. Copie o endereço atualizado. 3. Entre no Gerenciador de Comércio. 4. Abra a fonte de dados do catálogo. 5. Atualize a URL conforme as opções disponíveis. 6. Salve as alterações. 7. Verifique a próxima atualização. Dica: Mantenha o endereço cadastrado na Meta correspondente ao domínio ativo da sua loja. 13 - Seções de Referência URL do feed de produtos Apresenta o endereço XML utilizado para fornecer o catálogo à Meta. Abrir feed Permite visualizar o arquivo de produtos no navegador. Como usar Apresenta orientações resumidas para criar o catálogo e cadastrar o feed na Meta. Gerenciador de Comércio Ferramenta da Meta utilizada para administrar catálogos, produtos e fontes de dados. Gerenciador de Eventos Ferramenta utilizada para acompanhar os eventos enviados pelo Meta Pixel. Gerenciador de Anúncios Ferramenta utilizada para criar e administrar campanhas publicitárias. 14 - Problemas Comuns Não encontro o feed de produtos. Acesse Configurações > Integrações > Facebook Dynamic Ads e localize a seção URL do feed de produtos. Não encontro um botão para salvar na integração. A página é informativa. A configuração do catálogo é realizada diretamente na Meta, utilizando a URL disponibilizada pela Nortgraf. A Meta não consegue acessar o feed. Confira se a URL foi copiada corretamente e se o endereço está acessível publicamente. Utilize a opção Abrir feed para testar. Os produtos não aparecem no catálogo. Verifique se a fonte de dados foi cadastrada, se a Meta conseguiu consultar o arquivo e se existem erros no processamento. Um produto foi rejeitado. Consulte os diagnósticos do catálogo e confira se as informações do produto atendem aos requisitos da Meta. O preço apresentado no catálogo está incorreto. Confira o cadastro do produto na Nortgraf e verifique se o valor disponibilizado no feed corresponde ao apresentado na loja. Atualizei um produto, mas a Meta continua mostrando a versão anterior. Aguarde a próxima atualização da fonte de dados ou utilize as opções de atualização disponíveis no Gerenciador de Comércio. O Meta Pixel está ativo, mas os anúncios dinâmicos não funcionam. Verifique o recebimento dos eventos, a correspondência dos identificadores dos produtos e a configuração da campanha. Preciso informar Pixel ID nesta página? Não. O Pixel ID é configurado na integração Meta Pixel, que possui uma página própria. Preciso gerar um novo XML após alterar meus produtos? Não. O feed é gerado automaticamente quando seu endereço é acessado. O domínio da loja foi alterado. Confira a nova URL apresentada pela Nortgraf e atualize a fonte de dados na Meta, caso necessário. A criação do catálogo também cria anúncios? Não. Os anúncios e campanhas precisam ser configurados separadamente no Gerenciador de Anúncios da Meta. Dica: Após cadastrar o feed XML no Gerenciador de Comércio, confirme que os produtos foram importados corretamente antes de criar campanhas. Em seguida, verifique o Meta Pixel e os eventos utilizados para relacionar as interações dos visitantes aos produtos do catálogo.
Google reCAPTCHA v2
Google reCAPTCHA v2 Proteja os formulários da sua loja contra acessos automatizados, envios indevidos e tentativas de abuso utilizando o Google reCAPTCHA v2, uma ferramenta de segurança que ajuda a diferenciar visitantes legítimos de robôs. Para que serve a integração? O Google reCAPTCHA é um serviço de segurança desenvolvido pelo Google para reduzir interações automatizadas em sites e formulários. Com essa integração, você pode adicionar uma etapa de verificação aos formulários compatíveis da sua loja, ajudando a prevenir cadastros automatizados, mensagens de spam e outras atividades suspeitas. O reCAPTCHA v2 pode apresentar uma caixa de verificação ou desafios adicionais, dependendo do tipo de chave configurado e da análise realizada pelo Google. A Nortgraf permite informar as chaves fornecidas pelo Google e ativar a exigência de reCAPTCHA nos formulários compatíveis. 1 - Atenção e Regras Antes de configurar a integração, observe algumas informações importantes: - Conta Google: É necessário possuir uma conta Google para cadastrar e administrar o reCAPTCHA. - Versão: A integração da Nortgraf utiliza o Google reCAPTCHA v2. - Site Key: É a chave utilizada para identificar o site na verificação apresentada ao visitante. - Secret Key: É a chave privada utilizada pelo servidor para validar as respostas do reCAPTCHA. - Domínio: O endereço da sua loja deve estar autorizado nas configurações do Google reCAPTCHA. - Ativação: A opção Exigir reCAPTCHA nos formulários deve estar habilitada para utilizar o recurso. - Credenciais: As duas chaves precisam estar corretamente preenchidas. - Privacidade: A utilização do serviço deve respeitar as regras aplicáveis de privacidade e tratamento de dados. - Segurança: A proteção ajuda a reduzir abusos, mas não elimina todas as tentativas de fraude ou automação. Importante: Utilize chaves do reCAPTCHA v2 compatíveis com a implementação da loja. Chaves de versões diferentes podem impedir o carregamento ou a validação do desafio. 2 - Criando sua Configuração no Google reCAPTCHA Caso ainda não possua as chaves do serviço, será necessário cadastrar sua loja no painel do Google reCAPTCHA. Passo 1 - Acessar o painel 1. Acesse www.google.com/recaptcha/admin. 2. Entre com sua conta Google. 3. Inicie o cadastro de um novo site. 4. Preencha as informações solicitadas. Passo 2 - Identificar o site No campo de identificação, informe um nome que facilite reconhecer a configuração. Exemplo: reCAPTCHA — Minha Loja Esse nome será utilizado para organização no painel do Google. Passo 3 - Selecionar a versão Na configuração do tipo de reCAPTCHA: 1. Selecione reCAPTCHA v2. 2. Escolha a modalidade compatível com a verificação utilizada no site. 3. Continue o cadastro. Para implementações com caixa de seleção, utilize a modalidade correspondente a "Não sou um robô". Atenção: A Nortgraf identifica essa integração como Google reCAPTCHA v2. Não selecione reCAPTCHA v3 apenas por ser uma versão mais recente, pois as chaves e os métodos de validação são diferentes. 3 - Cadastrando o Domínio da Loja Durante o cadastro no Google, será necessário informar os domínios autorizados a utilizar as chaves. Passo 1 - Identificar o endereço Consulte o domínio utilizado pelos visitantes para acessar sua loja. Exemplo: www.sualoja.com.br Passo 2 - Informar o domínio 1. Localize a seção de domínios no Google reCAPTCHA. 2. Informe o domínio da loja. 3. Acrescente outros domínios utilizados, quando necessário e permitido. 4. Confira as informações cadastradas. Normalmente, o domínio deve ser informado sem o protocolo HTTPS e sem o caminho de uma página específica. Passo 3 - Concluir o cadastro Leia as condições apresentadas pelo Google e finalize o cadastro. Importante: Se sua loja utiliza um domínio próprio e também um endereço alternativo, confira quais domínios precisam estar autorizados para que o desafio funcione nos locais desejados. 4 - Obtendo a Site Key e a Secret Key Após concluir o cadastro, o Google disponibilizará duas chaves. Site Key É a chave pública utilizada pelo site para apresentar a verificação ao visitante. A Nortgraf utiliza essa informação para identificar a configuração do reCAPTCHA. Secret Key É a chave privada utilizada pelo servidor para verificar a validade das respostas recebidas. Essa chave não deve ser compartilhada publicamente. Como copiar? 1. Acesse a configuração criada no painel do Google reCAPTCHA. 2. Localize a Site Key. 3. Copie seu valor. 4. Localize a Secret Key. 5. Copie o valor correspondente. Mantenha essas informações disponíveis para preencher a integração na Nortgraf. Atenção: As chaves devem pertencer à mesma configuração. Não misture a Site Key de um cadastro com a Secret Key de outro. 5 - Configurando o Google reCAPTCHA na Nortgraf Depois de obter as chaves, acesse o painel administrativo da sua loja. Passo 1 - Acessar a integração 1. Entre no painel administrativo da Nortgraf. 2. Acesse Configurações > Integrações. 3. Localize Google reCAPTCHA v2. 4. Abra a página de configuração. A tela apresenta duas seções principais: Chaves do reCAPTCHA Permite informar as credenciais fornecidas pelo Google. Ativação Permite habilitar ou desabilitar a proteção nos formulários compatíveis. Passo 2 - Informar a Site Key Na seção Chaves do reCAPTCHA: 1. Localize o campo Site Key. 2. Cole a chave pública fornecida pelo Google. 3. Confira se o valor foi informado corretamente. Passo 3 - Informar a Secret Key Ainda na seção Chaves do reCAPTCHA: 1. Localize o campo Secret Key. 2. Cole a chave secreta correspondente. 3. Confira se a informação está correta. Importante: A Secret Key é uma credencial de segurança. Informe-a somente na página de configuração da integração. 6 - Ativando a Proteção dos Formulários Após preencher as duas chaves, será necessário habilitar o reCAPTCHA. Como ativar? 1. Na página Google reCAPTCHA v2, localize a seção Ativação. 2. Encontre a opção Exigir reCAPTCHA nos formulários. 3. Habilite essa opção. 4. Clique em Salvar. Com o recurso habilitado e as chaves corretamente configuradas, os formulários compatíveis poderão utilizar a verificação do Google. Requisitos para funcionar Confira se: - A Site Key está preenchida; - A Secret Key está preenchida; - As duas chaves pertencem ao mesmo cadastro; - O domínio da loja está autorizado no Google; - A versão configurada é compatível; - A integração está ativada. Atenção: Se uma das chaves estiver ausente, o desafio não será carregado corretamente, mesmo que a opção de ativação esteja habilitada. 7 - Como Funciona a Verificação para o Cliente Quando o reCAPTCHA está configurado em um formulário compatível, o visitante poderá precisar realizar uma verificação antes de concluir a operação. Caixa de verificação Na modalidade com caixa de seleção, o visitante encontra uma opção identificada como: Não sou um robô Ao marcar essa opção, o Google realiza a verificação correspondente. Desafios adicionais Dependendo da análise do Google, poderá ser apresentado um desafio adicional. Esses desafios podem envolver a identificação de elementos em imagens ou outras verificações disponibilizadas pelo serviço. Conclusão do formulário Depois de concluir a verificação, o visitante poderá continuar o envio do formulário, desde que os demais dados também estejam válidos. Importante: Nem todos os visitantes necessariamente receberão o mesmo desafio. O comportamento depende das verificações realizadas pelo Google. 8 - Testando a Integração Após salvar as configurações, recomendamos verificar se o reCAPTCHA está funcionando corretamente. Passo 1 - Abrir a loja 1. Acesse o endereço público da sua loja. 2. Localize um formulário compatível com a verificação. 3. Abra a página correspondente. Passo 2 - Conferir o carregamento Verifique se o componente de verificação aparece corretamente. Caso seja exibida a caixa Não sou um robô, confira se ela pode ser utilizada normalmente. Passo 3 - Concluir uma operação de teste 1. Preencha os dados necessários do formulário. 2. Realize a verificação do reCAPTCHA. 3. Envie o formulário. 4. Confira o resultado apresentado. Resultado esperado O formulário deverá permitir a conclusão da operação quando a verificação for válida e os demais campos estiverem corretos. Dica: Teste também em um navegador diferente para verificar se o componente está sendo carregado adequadamente. 9 - Conferindo os Domínios Autorizados Se a verificação não funcionar, confira os domínios cadastrados no Google. Como verificar? 1. Acesse o painel do Google reCAPTCHA. 2. Abra a configuração correspondente à sua loja. 3. Consulte a lista de domínios autorizados. 4. Compare com o endereço público utilizado pelos visitantes. 5. Corrija as informações, quando necessário. Exemplo Se o site é acessado por um domínio próprio, confira se esse domínio está autorizado no cadastro do reCAPTCHA. Se a loja utiliza diferentes endereços, avalie a necessidade de incluir os domínios correspondentes. Importante: Uma configuração criada para outro domínio pode apresentar erros quando utilizada em sua loja. 10 - Diferença entre reCAPTCHA e Cloudflare Turnstile A Nortgraf disponibiliza integrações específicas para o Google reCAPTCHA e o Cloudflare Turnstile. Embora ambos sejam utilizados para proteção contra interações automatizadas, são serviços diferentes. Google reCAPTCHA v2 Utiliza o mecanismo de verificação do Google e pode apresentar uma caixa Não sou um robô ou desafios adicionais. A configuração exige uma Site Key e uma Secret Key fornecidas pelo Google. Cloudflare Turnstile Utiliza o sistema de verificação do Cloudflare, com suas próprias credenciais e configurações. A integração possui opções específicas para os locais em que a proteção deverá ser utilizada. Qual utilizar? A escolha depende das funcionalidades desejadas e dos formulários compatíveis com cada implementação. Dica: Evite ativar diferentes mecanismos de verificação no mesmo fluxo sem avaliar a compatibilidade, pois isso pode criar obstáculos desnecessários para os clientes. 11 - Desativando o reCAPTCHA Se desejar interromper a proteção controlada por essa integração: 1. Acesse Configurações > Integrações. 2. Abra Google reCAPTCHA v2. 3. Localize a seção Ativação. 4. Desabilite Exigir reCAPTCHA nos formulários. 5. Clique em Salvar. Após a desativação, os formulários que dependem dessa configuração deixarão de exigir o reCAPTCHA por esse mecanismo. O que acontece com as chaves? As credenciais poderão continuar cadastradas, conforme o estado salvo na integração. Desativar o serviço na Nortgraf não exclui o cadastro realizado no Google. Atenção: Caso existam outras proteções configuradas, elas deverão ser administradas separadamente. 12 - Seções de Referência Chaves do reCAPTCHA Reúne as credenciais necessárias para configurar a integração. Site Key Chave utilizada para identificar o site e apresentar a verificação ao visitante. Secret Key Chave privada utilizada pelo servidor para validar as respostas do reCAPTCHA. Ativação Permite controlar o funcionamento da integração. Exigir reCAPTCHA nos formulários Habilita ou desabilita a utilização do serviço nos formulários compatíveis. Abrir reCAPTCHA Disponibiliza o acesso ao painel externo do Google para criar e administrar as credenciais. 13 - Problemas Comuns Não encontro a Site Key e a Secret Key. Acesse o painel do Google reCAPTCHA, selecione a configuração da sua loja e consulte as chaves disponibilizadas. O reCAPTCHA não aparece na loja. Confira se a integração está ativada, se as duas chaves foram informadas e se o formulário utiliza esse mecanismo de verificação. Ativei a integração, mas o desafio não carrega. Verifique se a Site Key e a Secret Key estão preenchidas corretamente. Sem as duas credenciais, o desafio não funciona adequadamente. Aparece uma mensagem de chave inválida. Confira se as credenciais correspondem a uma configuração de reCAPTCHA v2 compatível com a implementação. O Google informa que o domínio não é válido. Verifique se o domínio utilizado pela loja está autorizado nas configurações do reCAPTCHA. O cliente não consegue concluir a verificação. Peça que verifique a conexão com a internet e tente novamente. Também é possível testar outro navegador para identificar interferências locais. O formulário não é enviado mesmo após a verificação. Confira se os demais campos estão preenchidos corretamente e se existem mensagens adicionais de validação. Preciso utilizar reCAPTCHA v3? Não. A integração documentada é destinada ao reCAPTCHA v2. Utilize chaves compatíveis com essa versão. Posso utilizar a mesma chave em mais de uma loja? Isso depende dos domínios autorizados e da configuração realizada no Google. Para facilitar a organização, recomendamos manter as credenciais associadas às lojas e aos domínios correspondentes. O reCAPTCHA funciona em uma página, mas não em outra. Confira se o formulário da outra página possui suporte à integração. A ativação geral não significa que todos os formulários da plataforma utilizem necessariamente o mesmo mecanismo. Desativei o reCAPTCHA, mas ainda existe uma verificação de segurança. Verifique se há outro serviço de proteção configurado, como Cloudflare Turnstile ou mecanismos independentes. Troquei o domínio da loja. Preciso alterar alguma configuração? Confira os domínios autorizados no painel do Google reCAPTCHA e atualize a configuração quando necessário. Dica: Após ativar o Google reCAPTCHA v2, realize uma operação de teste em um formulário compatível da sua loja. Confirme que o desafio carrega corretamente e que o formulário pode ser enviado após uma verificação válida.
Cloudflare Turnstile
Cloudflare Turnstile Proteja o acesso à sua loja e ao painel administrativo com o Cloudflare Turnstile, uma ferramenta de segurança que ajuda a impedir acessos automatizados, tentativas de abuso e cadastros realizados por robôs. Para que serve a integração? O Cloudflare Turnstile é um serviço de verificação de segurança que ajuda a identificar acessos automatizados sem exigir que todos os visitantes resolvam desafios tradicionais de CAPTCHA. Com essa integração, você pode adicionar uma camada extra de proteção aos processos de login e cadastro da sua loja na Nortgraf. O Turnstile utiliza verificações gerenciadas pela Cloudflare e, dependendo das condições de acesso, pode realizar a validação sem exigir uma interação adicional do usuário. Na Nortgraf, é possível configurar as chaves do serviço e escolher separadamente onde a proteção deverá ser exigida: no login administrativo ou no login e cadastro de clientes. 1 - Atenção e Regras Antes de iniciar a configuração, observe algumas informações importantes: - Conta Cloudflare: É necessário possuir uma conta para criar e administrar o widget do Turnstile. - Widget: Você precisará cadastrar um widget correspondente aos domínios utilizados pela loja. - Site Key: É a chave pública utilizada para apresentar a verificação nas páginas protegidas. - Secret Key: É a chave privada utilizada pelo servidor para validar as respostas do Turnstile. - Domínios: Os endereços utilizados precisam estar autorizados na configuração do widget. - Login administrativo: É possível exigir a verificação ao acessar o painel administrativo. - Login e cadastro do cliente: É possível habilitar a proteção no acesso e na criação de contas de clientes. - Ativação geral: O Turnstile somente será utilizado quando a opção principal estiver habilitada. - Segurança: A Secret Key deve ser mantida em sigilo. - Disponibilidade: O funcionamento depende da comunicação com os serviços da Cloudflare. Importante: A ativação geral e as opções de proteção são configurações diferentes. Para exigir o Turnstile em determinado processo, é necessário habilitar o serviço e a opção correspondente. 2 - Criando uma Conta na Cloudflare Caso ainda não possua uma conta, será necessário realizar o cadastro. Passo 1 - Acessar a Cloudflare 1. Acesse dash.cloudflare.com. 2. Crie uma conta ou entre com seus dados. 3. Conclua as verificações solicitadas. 4. Acesse o painel principal. Passo 2 - Localizar o Turnstile 1. No painel da Cloudflare, localize Turnstile. 2. Abra a área de gerenciamento de widgets. 3. Inicie a criação de um novo widget. Você também pode utilizar o endereço Abrir Cloudflare Turnstile para acessar a ferramenta. Dica: Não é obrigatório transferir o gerenciamento de DNS da sua loja para a Cloudflare apenas para utilizar o Turnstile. O serviço pode ser configurado por meio de um widget específico. 3 - Criando um Widget Turnstile O widget identifica o site que utilizará as verificações de segurança. Passo 1 - Identificar o widget Durante o cadastro: 1. Informe um nome para identificar a configuração. 2. Utilize um nome relacionado à sua loja. 3. Continue para a configuração dos domínios. Exemplo: Turnstile — Minha Loja Passo 2 - Configurar os domínios Informe os domínios nos quais o Turnstile será utilizado. Exemplo: www.sualoja.com.br Se você também pretende proteger o acesso administrativo realizado por outro endereço, confira se ele precisa ser incluído na lista de domínios autorizados. Passo 3 - Escolher o modo de verificação A Cloudflare disponibiliza diferentes opções para o funcionamento do widget. Para uma utilização convencional, selecione o modo gerenciado, quando disponível. Nesse modo, a Cloudflare determina a verificação apropriada conforme as características do acesso. Passo 4 - Concluir a criação Confira os dados cadastrados e finalize a criação. Após a conclusão, a Cloudflare disponibilizará as credenciais necessárias à integração. Importante: Os domínios autorizados devem corresponder aos endereços efetivamente utilizados pelos visitantes e administradores da loja. 4 - Obtendo a Site Key e a Secret Key Depois de criar o widget, localize as duas chaves disponibilizadas pela Cloudflare. Site Key É a chave pública utilizada pelo navegador para carregar o widget de verificação. Essa informação identifica a configuração do Turnstile que deverá ser apresentada ao usuário. Secret Key É a chave privada utilizada pelo servidor para validar as respostas recebidas durante a verificação. Essa credencial deve permanecer protegida. Como copiar? 1. Abra o widget criado no painel da Cloudflare. 2. Localize a Site Key. 3. Copie o valor apresentado. 4. Localize a Secret Key. 5. Copie o valor correspondente. Mantenha as duas informações disponíveis para configurar a integração na Nortgraf. Atenção: Utilize a Site Key e a Secret Key do mesmo widget. Credenciais pertencentes a configurações diferentes podem impedir a validação. 5 - Configurando o Cloudflare Turnstile na Nortgraf Com as chaves em mãos, acesse o painel administrativo da sua loja. Passo 1 - Acessar a integração 1. Entre no painel administrativo da Nortgraf. 2. Acesse Configurações > Integrações. 3. Localize Cloudflare Turnstile. 4. Abra a página de configuração. A tela apresenta três seções principais: Chaves do widget Reúne as credenciais fornecidas pela Cloudflare. Onde exigir o desafio Permite escolher quais processos deverão utilizar a verificação. Ativação Controla o funcionamento geral do Turnstile na loja. Passo 2 - Informar a Site Key Na seção Chaves do widget: 1. Localize o campo Site Key. 2. Cole a chave pública fornecida pela Cloudflare. 3. Confira se o valor foi informado corretamente. Passo 3 - Informar a Secret Key Ainda na seção Chaves do widget: 1. Localize o campo Secret Key. 2. Cole a chave secreta correspondente. 3. Confira se a informação está correta. Passo 4 - Salvar as configurações Depois de preencher as credenciais, confira os demais campos e salve as alterações. Importante: A Secret Key é uma informação confidencial. Não a compartilhe publicamente nem a utilize em códigos expostos aos visitantes. 6 - Protegendo o Login Administrativo A Nortgraf permite utilizar o Turnstile na autenticação dos usuários que acessam o painel administrativo. Como ativar? 1. Abra Configurações > Integrações > Cloudflare Turnstile. 2. Localize a seção Onde exigir o desafio. 3. Encontre a opção Login do admin. 4. Habilite essa opção. 5. Confira se a ativação geral também está habilitada. 6. Salve as configurações. Como funciona? Quando a proteção está ativa, a verificação do Turnstile passa a fazer parte do processo de autenticação administrativa compatível. A Cloudflare poderá validar o acesso automaticamente ou solicitar uma interação adicional, conforme sua análise. Quando utilizar? Recomendamos manter a proteção habilitada para ajudar a reduzir: - Tentativas automatizadas de login; - Ataques de força bruta; - Acessos realizados por robôs; - Requisições suspeitas direcionadas à autenticação. Importante: O Turnstile complementa as demais medidas de segurança. Ele não substitui senhas fortes, autenticação de dois fatores ou controle de permissões. 7 - Protegendo o Login e Cadastro de Clientes Além do painel administrativo, você poderá habilitar a verificação nos processos de acesso dos clientes da loja. Como ativar? 1. Acesse a integração Cloudflare Turnstile. 2. Localize Onde exigir o desafio. 3. Habilite Login e cadastro do cliente. 4. Confira se a ativação geral está habilitada. 5. Clique em Salvar. Quais processos são protegidos? Essa opção controla a utilização do Turnstile em: Login do cliente Protege o processo de autenticação realizado pelo cliente na loja. Cadastro do cliente Protege a criação de uma nova conta. Por que utilizar? A proteção pode ajudar a reduzir: - Criação automatizada de contas; - Tentativas repetitivas de autenticação; - Cadastros suspeitos; - Abusos realizados por scripts automatizados. Dica: Após habilitar a proteção, teste tanto o login quanto o cadastro de clientes para confirmar que os processos continuam funcionando corretamente. 8 - Ativando o Turnstile na Loja Depois de configurar as chaves e selecionar os processos protegidos, será necessário habilitar a integração. Como ativar? 1. Abra a integração Cloudflare Turnstile. 2. Localize a seção Ativação. 3. Habilite Usar o Turnstile na loja. 4. Clique em Salvar. Como funciona a ativação geral? A opção Usar o Turnstile na loja controla o funcionamento geral do serviço. Se ela estiver desabilitada, a verificação não será utilizada pelos processos controlados por essa integração, mesmo que as opções individuais estejam habilitadas. Exemplo de configuração Configuração Situação Usar o Turnstile na loja Ativado Login do admin Ativado Login e cadastro do cliente Desativado Nesse exemplo, a proteção será utilizada no login administrativo, mas não será exigida nos processos de login e cadastro dos clientes. Importante: Confira sempre a ativação geral e as opções individuais antes de salvar as configurações. 9 - Entendendo o Funcionamento do Desafio O Turnstile foi desenvolvido para realizar verificações de segurança com o menor atrito possível para visitantes legítimos. Verificação automática Em determinadas situações, a Cloudflare poderá realizar a análise sem exigir que o usuário resolva um desafio manual. Verificação com interação Dependendo do modo de funcionamento e das características do acesso, o serviço poderá solicitar uma interação adicional. Validação Após a verificação, o sistema utiliza a resposta do Turnstile para confirmar se a operação poderá continuar. Importante: O comportamento visual pode variar entre dispositivos, navegadores e condições de acesso. A ausência de um desafio tradicional não significa necessariamente que a verificação não foi realizada. 10 - Testando a Proteção do Login Administrativo Após ativar o Turnstile no login administrativo, recomendamos realizar uma verificação. Passo 1 - Manter uma sessão ativa Antes de testar, mantenha sua sessão administrativa atual aberta. Isso permite revisar as configurações caso o novo acesso apresente algum problema. Passo 2 - Abrir uma nova janela 1. Abra uma janela anônima ou outro navegador. 2. Acesse a página de login administrativo da Nortgraf. 3. Confira se a verificação do Turnstile é carregada corretamente. 4. Informe suas credenciais. 5. Conclua a autenticação. Passo 3 - Conferir o resultado Verifique se o acesso é concluído normalmente após a validação. Atenção: Não encerre sua sessão administrativa original antes de confirmar que o login funciona corretamente com o Turnstile ativado. 11 - Testando o Login e Cadastro de Clientes Se você habilitou o Turnstile para clientes, teste os processos correspondentes na loja pública. Testando o login 1. Abra o endereço público da loja. 2. Acesse a área de autenticação do cliente. 3. Confira se o Turnstile funciona corretamente. 4. Informe credenciais de teste válidas. 5. Conclua o acesso. Testando o cadastro 1. Acesse a área de criação de conta. 2. Preencha os dados necessários. 3. Conclua a verificação solicitada. 4. Envie o formulário. 5. Confira o resultado. Resultado esperado O cliente deverá conseguir concluir as operações normalmente quando as verificações e os demais dados estiverem corretos. Dica: Faça os testes em um computador e em um celular para verificar a experiência nos diferentes dispositivos. 12 - Alterando ou Substituindo as Chaves Em algumas situações, poderá ser necessário substituir as credenciais do Turnstile. Isso pode ocorrer após alterações no widget, mudanças de domínio ou procedimentos de segurança. Como substituir? 1. Acesse o painel da Cloudflare. 2. Abra o widget correspondente. 3. Consulte ou gere as credenciais necessárias. 4. Retorne à integração na Nortgraf. 5. Atualize a Site Key e, quando necessário, a Secret Key. 6. Salve as alterações. 7. Teste novamente os processos protegidos. Preservação da Secret Key Quando uma Secret Key já está cadastrada, a Nortgraf apresenta o campo de forma mascarada. Se você deseja manter a chave existente, pode deixar o campo em branco ou manter o valor mascarado. A Nortgraf preservará a credencial anteriormente salva. Importante: Não é necessário informar novamente a Secret Key sempre que você alterar outra opção da integração. 13 - Diferença entre Turnstile e Google reCAPTCHA A Nortgraf possui integrações específicas para dois serviços de proteção contra acessos automatizados. Cloudflare Turnstile Utiliza os mecanismos de verificação da Cloudflare. Permite configurar individualmente a proteção do login administrativo e do login e cadastro dos clientes. Google reCAPTCHA v2 Utiliza os mecanismos de verificação do Google, podendo apresentar desafios tradicionais de CAPTCHA. Possui uma configuração própria de chaves e ativação. Qual utilizar? A escolha depende das necessidades da loja e dos formulários que você deseja proteger. O Turnstile oferece controles específicos para os processos de autenticação disponíveis na integração da Nortgraf. Atenção: Evite configurar diferentes verificações no mesmo processo sem avaliar a compatibilidade e a experiência do usuário. 14 - Desativando o Turnstile Se precisar interromper a verificação de segurança controlada pela integração: 1. Acesse Configurações > Integrações. 2. Abra Cloudflare Turnstile. 3. Localize a seção Ativação. 4. Desabilite Usar o Turnstile na loja. 5. Clique em Salvar. Com a ativação geral desligada, os desafios controlados pela integração deixam de ser exigidos, independentemente das opções individuais. Desativando apenas um processo Se desejar manter o Turnstile ativo somente no login administrativo ou somente no acesso dos clientes: 1. Mantenha Usar o Turnstile na loja ativado. 2. Acesse Onde exigir o desafio. 3. Desabilite apenas a opção correspondente. 4. Salve as alterações. Importante: Desativar o Turnstile na Nortgraf não exclui o widget ou as credenciais da sua conta Cloudflare. 15 - Seções de Referência Chaves do widget Reúne as credenciais necessárias à integração. Site Key Chave pública utilizada pelo navegador para carregar o Turnstile. Secret Key Chave privada utilizada pelo servidor para validar a resposta. Onde exigir o desafio Permite selecionar os processos protegidos. Login do admin Habilita a verificação no login administrativo da loja. Login e cadastro do cliente Habilita a proteção na autenticação e na criação de contas dos clientes. Ativação Controla o funcionamento geral do serviço. Usar o Turnstile na loja Quando habilitada, permite a execução das verificações nas áreas selecionadas. Abrir Turnstile Disponibiliza o acesso ao painel da Cloudflare para administração do widget. 16 - Problemas Comuns Não encontro a Site Key e a Secret Key. Acesse o painel Cloudflare Turnstile, abra o widget cadastrado e consulte as credenciais disponibilizadas. O Turnstile não aparece no login administrativo. Confira se a opção Usar o Turnstile na loja está habilitada e se Login do admin também está ativado. Verifique as chaves e os domínios autorizados. O Turnstile não aparece no login dos clientes. Confira se a ativação geral está habilitada e se a opção Login e cadastro do cliente está ativada. Configurei as chaves, mas a proteção não funciona. Verifique se a Site Key e a Secret Key pertencem ao mesmo widget e se os domínios utilizados estão autorizados. A Secret Key aparece como ****. Esse comportamento é esperado. A Nortgraf apresenta a chave de forma mascarada para protegê-la. Preciso preencher a Secret Key toda vez que salvar? Não. Se a chave já estiver cadastrada, você poderá deixar o campo em branco ou manter a máscara para preservar o valor existente. A verificação funciona na loja, mas não no painel administrativo. Confira se o domínio utilizado para acessar o painel administrativo também está autorizado na configuração do widget. A verificação funciona no computador, mas não no celular. Teste a conexão e o navegador utilizado. Verifique também se existem recursos de bloqueio que interfiram no carregamento do widget. Ativei a proteção e não consigo mais entrar no painel. Confira se o domínio e as credenciais estão corretos. Caso tenha perdido o acesso administrativo, entre em contato com o suporte da Nortgraf para verificar o procedimento seguro de recuperação. O login do cliente apresenta erro de verificação. Confira os domínios autorizados, as credenciais do widget e as condições de comunicação com a Cloudflare. Desativei o login administrativo, mas a verificação continua aparecendo. Confira se as alterações foram salvas e se existe outro mecanismo de segurança ativo no processo. Preciso utilizar o Turnstile e o reCAPTCHA ao mesmo tempo? Não obrigatoriamente. Utilize os mecanismos de proteção adequados aos formulários e evite verificações redundantes. Alterei o domínio da loja. Preciso atualizar o Turnstile? Confira os domínios autorizados no widget da Cloudflare e inclua ou ajuste os endereços utilizados, quando necessário. Dica: Após configurar o Cloudflare Turnstile, mantenha uma sessão administrativa aberta e teste o login em outra janela antes de encerrar seu acesso. Isso ajuda a confirmar que as chaves e os domínios estão corretos sem comprometer sua capacidade de administrar a loja.
JivoChat
JivoChat Adicione um chat de atendimento online à sua loja utilizando o JivoChat, permitindo que visitantes e clientes entrem em contato com sua equipe diretamente pelas páginas da loja na Nortgraf. Para que serve a integração? O JivoChat é uma plataforma de atendimento que permite conversar com visitantes de um site por meio de uma janela de chat. Com a integração, você pode disponibilizar um canal de comunicação para esclarecer dúvidas, orientar clientes durante a compra e prestar suporte. A Nortgraf permite incorporar o widget do JivoChat à sua loja utilizando o identificador fornecido pelo serviço. Após configurar e ativar a integração, o chat poderá ser apresentado nas páginas públicas da loja, enquanto o gerenciamento das conversas e dos atendentes será realizado pelo JivoChat. 1 - Atenção e Regras Antes de iniciar a configuração, observe algumas informações importantes: - Conta JivoChat: É necessário possuir uma conta no serviço para configurar e utilizar o atendimento. - Widget ID: É o identificador utilizado para carregar o chat na sua loja. - Ativação: A opção Exibir o chat na loja precisa estar habilitada. - Atendentes: O gerenciamento da equipe de atendimento é realizado na plataforma JivoChat. - Disponibilidade: O funcionamento do chat depende da disponibilidade do serviço externo. - Aparência: Determinadas configurações de cores, mensagens e comportamento são administradas pelo JivoChat. - Plano: Alguns recursos podem depender do plano contratado diretamente no JivoChat. - Privacidade: O atendimento deve respeitar as regras aplicáveis ao tratamento de informações dos clientes. Importante: A Nortgraf é responsável por carregar o widget configurado. O recebimento das mensagens, o gerenciamento dos atendimentos e as demais funcionalidades do chat são administrados pelo JivoChat. 2 - Criando sua Conta no JivoChat Caso ainda não possua uma conta, será necessário realizar o cadastro na plataforma. Passo 1 - Acessar o JivoChat 1. Acesse www.jivochat.com.br. 2. Inicie o cadastro de uma nova conta. 3. Informe os dados solicitados. 4. Configure as informações da sua empresa. 5. Conclua o cadastro e entre no painel. Se você já utiliza o JivoChat em outro site, poderá acessar sua conta existente e criar ou selecionar o canal correspondente à sua loja. Passo 2 - Configurar o canal de atendimento No painel do JivoChat: 1. Localize a área de gerenciamento de canais. 2. Selecione a opção de adicionar ou configurar um chat para site. 3. Informe o nome da loja. 4. Cadastre o endereço público do site, quando solicitado. 5. Conclua as configurações iniciais. Dica: Utilize o nome da loja para identificar o canal, principalmente quando sua empresa administra mais de um site ou atendimento. 3 - Obtendo o Widget ID Para conectar o JivoChat à Nortgraf, será necessário obter o identificador do widget. Esse identificador é disponibilizado nas informações ou no código de instalação do chat. Passo 1 - Localizar o código de instalação 1. Entre no painel do JivoChat. 2. Abra o canal correspondente à sua loja. 3. Acesse a área de instalação ou configuração do chat para site. 4. Localize o código de instalação disponibilizado pela plataforma. O JivoChat poderá apresentar um trecho de código destinado à instalação do chat no site. Passo 2 - Identificar o Widget ID O código de instalação normalmente contém um identificador que permite carregar o widget. Um exemplo ilustrativo de endereço utilizado em instalações do JivoChat é: https://code.jivosite.com/widget/SEU_WIDGET_ID Nesse exemplo, SEU_WIDGET_ID representa o identificador do widget. Copie somente o identificador, sem incluir o restante do endereço. Passo 3 - Conferir o identificador Antes de continuar, verifique se o Widget ID pertence ao canal configurado para sua loja. Importante: Não é necessário copiar todo o código de instalação para a Nortgraf. A integração possui um campo específico para o Widget ID. 4 - Configurando o JivoChat na Nortgraf Depois de obter o identificador, acesse o painel administrativo da sua loja. Passo 1 - Acessar a integração 1. Entre no painel administrativo da Nortgraf. 2. Acesse Configurações > Integrações. 3. Localize JivoChat. 4. Abra a página de configuração. A tela apresenta duas seções principais: Widget Permite informar o identificador utilizado para carregar o chat. Ativação Permite habilitar ou desabilitar a exibição do atendimento na loja. Passo 2 - Informar o Widget ID Na seção Widget: 1. Localize o campo Widget ID. 2. Cole o identificador copiado do JivoChat. 3. Confira se o valor foi informado corretamente. Não adicione o endereço completo do script nem outras instruções de instalação. Passo 3 - Ativar o atendimento Na seção Ativação: 1. Localize a opção Exibir o chat na loja. 2. Habilite a opção. 3. Clique em Salvar. Com a integração habilitada, a Nortgraf poderá carregar o widget do JivoChat nas páginas públicas da loja. Importante: O Widget ID precisa estar corretamente configurado para que o chat seja carregado. 5 - Personalizando o Chat Após conectar o widget à Nortgraf, você poderá ajustar a experiência de atendimento diretamente no JivoChat. As opções disponíveis dependem dos recursos oferecidos pelo serviço. Aparência Você poderá configurar características visuais do chat, conforme as opções disponibilizadas pelo JivoChat. Entre elas podem estar cores, identificação da empresa e apresentação da janela de atendimento. Mensagens de boas-vindas A plataforma pode disponibilizar opções para definir mensagens apresentadas aos visitantes. Essas mensagens ajudam a iniciar o atendimento e orientar o cliente. Horário de atendimento É possível organizar a disponibilidade da equipe conforme os recursos da conta. Atendentes O gerenciamento dos usuários responsáveis pelas conversas é realizado no JivoChat. Dica: Mantenha a identidade visual do atendimento alinhada às cores e à comunicação da sua loja. 6 - Testando o Chat na Loja Depois de salvar as configurações, recomendamos verificar se o widget aparece e funciona corretamente. Passo 1 - Abrir a loja 1. Acesse o endereço público da sua loja. 2. Aguarde o carregamento da página. 3. Localize o widget do JivoChat. O posicionamento e a aparência do chat dependem da configuração realizada no serviço. Passo 2 - Iniciar uma conversa 1. Clique no widget. 2. Abra a janela de atendimento. 3. Envie uma mensagem de teste. 4. Aguarde o recebimento no painel do JivoChat. Passo 3 - Conferir o atendimento No painel do JivoChat: 1. Localize a conversa iniciada. 2. Confira se a mensagem foi recebida. 3. Responda à mensagem. 4. Verifique se a resposta aparece na loja. Resultado esperado O visitante deverá conseguir abrir o chat e trocar mensagens com o atendimento, conforme as condições e os recursos disponibilizados pelo JivoChat. Importante: Se o chat aparecer, mas nenhuma mensagem for respondida, verifique a disponibilidade dos atendentes e as configurações do canal no JivoChat. 7 - Configurando os Atendentes Para oferecer atendimento pelo chat, configure os usuários responsáveis pelas conversas. Como configurar? 1. Acesse o painel do JivoChat. 2. Localize a área de gerenciamento de equipe ou atendentes. 3. Adicione os usuários necessários. 4. Configure as permissões disponíveis. 5. Oriente os atendentes a acessar o painel do serviço. Os procedimentos exatos podem variar conforme o plano e a interface do JivoChat. Boas práticas de atendimento Mantenha as informações de disponibilidade atualizadas e configure mensagens adequadas ao horário de funcionamento da sua empresa. Também é recomendável estabelecer responsáveis pelo acompanhamento das conversas recebidas. Dica: Antes de divulgar o chat, confirme que pelo menos um atendente possui acesso ao canal e consegue responder às mensagens. 8 - Utilizando o Chat no Celular O widget do JivoChat pode ser utilizado por visitantes que acessam sua loja por dispositivos móveis, conforme a compatibilidade oferecida pelo serviço. Como testar? 1. Abra o endereço público da loja em um celular. 2. Aguarde o carregamento. 3. Localize o botão de atendimento. 4. Abra a janela do chat. 5. Envie uma mensagem de teste. Confira se o widget não interfere na navegação e se os elementos da loja permanecem acessíveis. Recomendações Verifique o comportamento do chat em diferentes tamanhos de tela. Caso existam configurações de posicionamento ou apresentação para dispositivos móveis, consulte as opções disponibilizadas pelo JivoChat. Importante: As personalizações específicas do widget devem ser realizadas no ambiente do JivoChat. 9 - Atendimento Online e Offline A apresentação do chat poderá variar conforme a disponibilidade da equipe e as configurações do serviço. Atendimento online Quando existem atendentes disponíveis, os visitantes podem iniciar conversas conforme o funcionamento do canal. Atendimento offline Dependendo da configuração e dos recursos contratados, o JivoChat poderá disponibilizar alternativas para que visitantes deixem mensagens quando não existem atendentes online. Como configurar? 1. Acesse o painel do JivoChat. 2. Consulte as configurações de disponibilidade. 3. Defina os horários de atendimento. 4. Configure as mensagens ou alternativas disponíveis. 5. Salve as alterações. Dica: Informe horários de atendimento realistas para evitar que os clientes esperem respostas imediatas fora do expediente. 10 - Utilizando Mais de um Canal de Atendimento Sua loja pode possuir diferentes formas de contato, como WhatsApp, e-mail e chat online. O JivoChat funciona como uma integração independente desses outros canais, salvo quando existir alguma configuração específica de conexão entre eles. Como organizar? Defina qual canal será utilizado para cada finalidade. Por exemplo: JivoChat Atendimento durante a navegação na loja. WhatsApp Comunicação comercial e acompanhamento de solicitações. E-mail Comunicações que não exigem resposta imediata. Evitando excesso de elementos Se sua loja apresenta vários botões de atendimento, avalie a experiência visual dos visitantes. Muitos widgets flutuantes podem ocupar espaço e prejudicar a navegação, principalmente no celular. Importante: A ativação do JivoChat não desativa automaticamente outras ferramentas de atendimento configuradas na loja. 11 - Alterando o Widget ID Caso seja necessário substituir o canal utilizado pelo chat, você poderá atualizar o identificador na Nortgraf. Como alterar? 1. Acesse Configurações > Integrações. 2. Abra JivoChat. 3. Localize o campo Widget ID. 4. Substitua o identificador existente. 5. Clique em Salvar. 6. Abra a loja para verificar o funcionamento. Quando alterar? A substituição poderá ser necessária em situações como: - Criação de um novo canal; - Mudança da conta responsável pelo atendimento; - Substituição do widget; - Reorganização da operação de atendimento. Atenção: Confira se o novo identificador pertence ao canal correto antes de salvar. 12 - Desativando o JivoChat Se desejar interromper a exibição do chat na loja: 1. Acesse Configurações > Integrações. 2. Abra JivoChat. 3. Localize a seção Ativação. 4. Desabilite Exibir o chat na loja. 5. Clique em Salvar. Após a desativação, o widget deixa de ser carregado por essa integração nas páginas da loja. O que acontece com as conversas? O histórico e os dados armazenados pelo JivoChat continuam sujeitos às configurações e políticas do próprio serviço. Desativar a integração na Nortgraf não exclui automaticamente sua conta no JivoChat. Importante: Se o chat também estiver instalado por outro método, será necessário revisar essa configuração separadamente. 13 - Seções de Referência Widget Reúne as informações utilizadas para identificar o chat da loja. Widget ID Identificador do widget obtido no código de instalação disponibilizado pelo JivoChat. Ativação Permite controlar a exibição do serviço nas páginas públicas. Exibir o chat na loja Quando habilitada, permite carregar o widget configurado nas páginas da loja. Painel JivoChat Ambiente externo utilizado para gerenciar atendentes, conversas e personalizações do atendimento. 14 - Problemas Comuns Não encontro o Widget ID. Acesse o painel do JivoChat, abra o canal da sua loja e consulte as informações ou o código de instalação. O chat não aparece na loja. Confira se o Widget ID está correto e se a opção Exibir o chat na loja está habilitada. Copiei o código completo de instalação. A Nortgraf exige somente o Widget ID. Localize o identificador no código fornecido pelo JivoChat e informe apenas esse valor. O chat aparece, mas não consigo receber mensagens. Verifique a configuração do canal no JivoChat, a disponibilidade dos atendentes e as permissões da conta. O widget aparece em outro site, mas não na Nortgraf. Confira se o identificador pertence ao canal desejado e se a integração está ativada. Também verifique as configurações do domínio, quando aplicáveis. As alterações de aparência não aparecem. Confirme se foram salvas no JivoChat e atualize a página da loja para verificar o resultado. O chat não aparece no celular. Teste a página em outro navegador e confira as configurações de exibição para dispositivos móveis no JivoChat. O atendimento aparece como offline. Verifique os horários configurados e a disponibilidade dos atendentes no painel do JivoChat. Troquei o Widget ID e o atendimento mudou de conta. O identificador determina qual widget será carregado. Confira se o novo ID corresponde à conta e ao canal corretos. Desativei o JivoChat, mas o botão continua aparecendo. Verifique se o serviço foi instalado por outro método, como Google Tag Manager ou scripts personalizados. Preciso instalar o código manualmente no site? Não para a integração padrão. Basta informar o Widget ID e habilitar a opção de exibição na Nortgraf. Posso utilizar o JivoChat junto com o WhatsApp? Sim, desde que os canais estejam configurados corretamente. Avalie a organização visual dos botões para evitar sobreposição ou excesso de elementos na loja. Dica: Após ativar o JivoChat, faça uma conversa de teste utilizando o celular ou uma janela anônima. Confirme que a mensagem chega ao painel de atendimento e que sua equipe consegue responder antes de disponibilizar o recurso aos clientes.
Tawk.to
Tawk.to Adicione um chat de atendimento online à sua loja utilizando o Tawk.to, permitindo que visitantes e clientes conversem com sua equipe diretamente pelas páginas da loja na Nortgraf. Para que serve a integração? O Tawk.to é uma plataforma de atendimento que permite disponibilizar um chat em tempo real no seu site. Com essa integração, os visitantes podem entrar em contato com sua empresa durante a navegação, esclarecer dúvidas sobre produtos, solicitar informações e receber suporte. A Nortgraf permite instalar o widget do Tawk.to utilizando o Property ID e o Widget ID disponibilizados pelo serviço. Após configurar e ativar a integração, o chat poderá ser apresentado nas páginas públicas da loja. O gerenciamento das conversas, dos atendentes e das configurações específicas do atendimento é realizado diretamente no Tawk.to. 1 - Atenção e Regras Antes de iniciar a configuração, observe algumas informações importantes: - Conta Tawk.to: É necessário possuir uma conta para utilizar o serviço. - Property ID: Identifica a propriedade cadastrada no Tawk.to. - Widget ID: Identifica o widget de atendimento que será carregado na loja. - Ativação: A opção Exibir o chat na loja deve estar habilitada. - Atendentes: O gerenciamento da equipe e das conversas é realizado no painel do Tawk.to. - Disponibilidade: O funcionamento do widget depende dos serviços disponibilizados pelo Tawk.to. - Personalização: Aparência, mensagens e outras configurações do chat são administradas no fornecedor. - Recursos adicionais: Algumas funcionalidades podem depender de serviços ou recursos contratados separadamente. - Privacidade: As informações compartilhadas durante o atendimento devem ser tratadas conforme as regras aplicáveis de privacidade e proteção de dados. Importante: A integração da Nortgraf utiliza os identificadores fornecidos pelo Tawk.to. Não é necessário inserir manualmente o código completo de instalação nas páginas da loja. 2 - Criando sua Conta no Tawk.to Caso ainda não possua uma conta, será necessário realizar o cadastro no serviço. Passo 1 - Acessar a plataforma 1. Acesse www.tawk.to. 2. Inicie a criação de uma conta. 3. Informe os dados solicitados. 4. Conclua o cadastro. 5. Entre no painel administrativo do Tawk.to. Se você já possui uma conta, poderá utilizá-la para configurar uma nova propriedade correspondente à sua loja. Passo 2 - Configurar a empresa Durante a configuração inicial, informe os dados solicitados para identificar o atendimento. Utilize um nome relacionado à sua loja para facilitar o gerenciamento. Exemplo: Atendimento — Minha Loja Dica: Se você administra várias lojas, mantenha as propriedades organizadas para evitar que os atendimentos sejam associados ao site incorreto. 3 - Criando uma Propriedade no Tawk.to No Tawk.to, uma propriedade representa o site ou ambiente ao qual o chat estará associado. Passo 1 - Adicionar a propriedade 1. Entre no painel do Tawk.to. 2. Acesse a área de administração. 3. Localize o gerenciamento de propriedades. 4. Selecione a opção de adicionar uma nova propriedade. 5. Informe os dados solicitados. Passo 2 - Informar o endereço da loja Durante o cadastro, informe o endereço público utilizado pelos clientes para acessar sua loja. Exemplo: https://www.sualoja.com.br Utilize o endereço correto para identificar o site que receberá o chat. Passo 3 - Concluir a configuração Finalize as etapas apresentadas pelo Tawk.to. Após a criação, a propriedade ficará disponível para configuração do widget de atendimento. Importante: O cadastro da propriedade no Tawk.to não instala automaticamente o chat na Nortgraf. Será necessário informar os identificadores na integração. 4 - Obtendo o Property ID e o Widget ID Para conectar o Tawk.to à Nortgraf, você precisará de dois identificadores. Ambos podem ser encontrados nas informações ou no código de instalação gerado pelo Tawk.to. Passo 1 - Localizar o código de instalação 1. Entre no painel do Tawk.to. 2. Selecione a propriedade da sua loja. 3. Acesse as configurações administrativas. 4. Localize a área de widgets ou instalação do chat. 5. Consulte o código disponibilizado para instalação no site. Passo 2 - Identificar os códigos O código de instalação normalmente contém um endereço semelhante a: https://embed.tawk.to/PROPERTY_ID/WIDGET_ID Nesse exemplo: PROPERTY_ID Representa o identificador da propriedade cadastrada no Tawk.to. WIDGET_ID Representa o identificador do widget que será exibido na loja. Os dois valores são diferentes e precisam ser informados nos campos correspondentes. Exemplo ilustrativo Considere o seguinte endereço: https://embed.tawk.to/123456789abcdef/1abc234de Os valores seriam: Campo Exemplo Property ID 123456789abcdef Widget ID 1abc234de Esses identificadores são apenas exemplos. Utilize os dados fornecidos na sua conta. Atenção: Não copie o endereço completo para nenhum dos campos. Informe somente o identificador correspondente. 5 - Configurando o Tawk.to na Nortgraf Depois de obter os identificadores, acesse o painel administrativo da sua loja. Passo 1 - Acessar a integração 1. Entre no painel administrativo da Nortgraf. 2. Acesse Configurações > Integrações. 3. Localize Tawk.to. 4. Abra a página de configuração. A tela apresenta duas seções principais: Widget Reúne os identificadores necessários para carregar o chat. Ativação Permite controlar a exibição do widget nas páginas públicas da loja. Passo 2 - Informar o Property ID Na seção Widget: 1. Localize o campo Property ID. 2. Cole o identificador da propriedade. 3. Confira se o valor pertence ao site correto. Passo 3 - Informar o Widget ID Ainda na seção Widget: 1. Localize o campo Widget ID. 2. Cole o identificador do widget. 3. Confira se o valor corresponde à mesma propriedade. Passo 4 - Salvar as configurações Depois de preencher os dois campos, confira os dados informados. Importante: O Property ID e o Widget ID devem corresponder à mesma configuração do Tawk.to. Informações incorretas podem impedir o carregamento do chat. 6 - Ativando o Chat na Loja Após informar os identificadores, será necessário habilitar a integração. Como ativar? 1. Na página Tawk.to, localize a seção Ativação. 2. Encontre a opção Exibir o chat na loja. 3. Habilite essa opção. 4. Clique em Salvar. Com a integração ativada, a Nortgraf poderá carregar o widget do Tawk.to nas páginas públicas da loja. Como funciona? Quando um visitante acessa uma página da loja, o widget configurado poderá ser carregado conforme a disponibilidade do serviço e as configurações realizadas no Tawk.to. O cliente poderá utilizar o chat para iniciar uma conversa com sua equipe. Importante: A ativação do chat não coloca automaticamente os atendentes online. A disponibilidade da equipe é gerenciada no próprio Tawk.to. 7 - Personalizando o Widget de Atendimento Após conectar o chat à Nortgraf, você poderá personalizar sua apresentação no painel do Tawk.to. As opções disponíveis dependem dos recursos oferecidos pelo serviço. Aparência É possível configurar aspectos visuais do widget, como cores e apresentação da janela de atendimento, conforme as opções disponibilizadas pelo Tawk.to. Identificação da empresa Configure o nome e as informações que serão apresentados durante o atendimento. Mensagens de boas-vindas Defina mensagens para orientar os visitantes ao iniciarem uma conversa, quando o recurso estiver disponível. Posicionamento do widget Consulte as opções de posicionamento oferecidas pelo Tawk.to para ajustar a apresentação do chat nas páginas. Idioma Verifique se o idioma utilizado pelo widget está adequado ao público da sua loja. Dica: Utilize cores e mensagens alinhadas à identidade visual da sua empresa para manter uma experiência consistente de atendimento. 8 - Configurando os Atendentes O Tawk.to permite organizar os usuários responsáveis pelo atendimento das conversas. Como configurar? 1. Entre no painel administrativo do Tawk.to. 2. Selecione a propriedade correspondente à sua loja. 3. Acesse as configurações de membros ou equipe. 4. Adicione os atendentes necessários. 5. Configure as permissões disponíveis. 6. Conclua o cadastro. Acompanhamento das mensagens Os atendentes poderão utilizar os recursos disponibilizados pelo Tawk.to para visualizar e responder às conversas recebidas. Recomendações Mantenha a equipe organizada e defina responsáveis pelo acompanhamento das mensagens. Também é recomendável configurar horários de atendimento compatíveis com a disponibilidade real da empresa. Importante: A criação dos atendentes e a administração das conversas não são realizadas na página de integração da Nortgraf. 9 - Testando o Chat na Loja Depois de salvar e ativar a integração, recomendamos realizar um atendimento de teste. Passo 1 - Acessar a loja 1. Abra o endereço público da sua loja. 2. Aguarde o carregamento da página. 3. Localize o widget de atendimento. A aparência e o posicionamento dependem das configurações realizadas no Tawk.to. Passo 2 - Iniciar uma conversa 1. Clique no botão de atendimento. 2. Abra a janela do chat. 3. Informe os dados solicitados, quando necessário. 4. Envie uma mensagem de teste. Passo 3 - Verificar no Tawk.to 1. Entre no painel do Tawk.to. 2. Localize a conversa recebida. 3. Confira se a mensagem aparece corretamente. 4. Envie uma resposta. Passo 4 - Conferir a resposta Retorne à janela da loja e verifique se a resposta foi apresentada. Resultado esperado O visitante deverá conseguir iniciar uma conversa e receber mensagens dos atendentes, conforme a disponibilidade e as configurações do serviço. Dica: Faça o teste utilizando uma janela anônima para simular a experiência de um visitante que ainda não possui sessão aberta na loja. 10 - Testando o Chat no Celular É importante verificar o comportamento do widget em dispositivos móveis. Como testar? 1. Abra sua loja no navegador do celular. 2. Aguarde o carregamento. 3. Localize o botão de atendimento. 4. Abra o chat. 5. Envie uma mensagem. 6. Confira se o conteúdo pode ser visualizado corretamente. O que observar? Verifique se: - O botão de atendimento está visível; - A janela abre corretamente; - O campo de mensagem pode ser utilizado; - O teclado não impede a interação; - O widget não bloqueia elementos importantes da página. Importante: As opções específicas de apresentação e posicionamento do widget são administradas pelo Tawk.to. 11 - Atendimento Online e Offline O comportamento do chat poderá variar conforme a disponibilidade da equipe e as configurações do Tawk.to. Atendimento online Quando existem atendentes disponíveis, os visitantes podem iniciar conversas em tempo real. Atendimento offline Dependendo da configuração, o serviço poderá oferecer formulários ou outras alternativas para receber mensagens quando não houver atendentes disponíveis. Como configurar? 1. Acesse o painel do Tawk.to. 2. Selecione a propriedade da loja. 3. Consulte as configurações de disponibilidade. 4. Ajuste os horários de atendimento. 5. Configure as mensagens e opções disponíveis. 6. Salve as alterações. Dica: Utilize mensagens que informem claramente quando sua equipe estará disponível para responder. 12 - Utilizando o Tawk.to com Outros Canais de Atendimento Sua loja pode disponibilizar outros meios de contato além do chat online. Entre eles estão WhatsApp, e-mail e outras ferramentas de atendimento. Como organizar os canais? Defina a finalidade de cada canal conforme o funcionamento da sua empresa. Tawk.to Atendimento durante a navegação na loja. WhatsApp Comunicação comercial e acompanhamento de solicitações. E-mail Envio de informações e atendimento que não exige resposta imediata. Cuidados com a apresentação A utilização de vários widgets flutuantes pode prejudicar a navegação, especialmente no celular. Evite que os botões fiquem sobrepostos ou ocultem ações importantes da loja. Importante: Habilitar o Tawk.to não desativa automaticamente outras ferramentas de atendimento configuradas na Nortgraf. 13 - Alterando os Identificadores do Widget Caso seja necessário substituir o chat utilizado pela loja, você poderá alterar o Property ID e o Widget ID. Como alterar? 1. Acesse Configurações > Integrações. 2. Abra Tawk.to. 3. Localize a seção Widget. 4. Atualize o Property ID. 5. Atualize o Widget ID. 6. Clique em Salvar. 7. Abra a loja para verificar o funcionamento. Quando alterar? A atualização poderá ser necessária em situações como: - Substituição da propriedade; - Criação de um novo widget; - Mudança da conta utilizada no atendimento; - Reorganização dos canais de atendimento. Atenção: Sempre confira se os dois identificadores pertencem à mesma configuração. Misturar dados de propriedades diferentes pode impedir o funcionamento da integração. 14 - Desativando o Tawk.to Se desejar interromper a exibição do chat na loja: 1. Acesse Configurações > Integrações. 2. Abra Tawk.to. 3. Localize a seção Ativação. 4. Desabilite Exibir o chat na loja. 5. Clique em Salvar. Após a desativação, o widget deixa de ser carregado pela integração nas páginas públicas da loja. O que acontece com as conversas? O histórico e as demais informações registradas no Tawk.to continuam sujeitos às configurações e políticas do próprio serviço. Desativar a integração na Nortgraf não exclui automaticamente sua conta ou propriedade. Importante: Caso o chat também esteja instalado por outro método, será necessário revisar essa configuração separadamente. 15 - Seções de Referência Widget Reúne os campos necessários para identificar o chat utilizado pela loja. Property ID Identificador da propriedade cadastrada no Tawk.to. Widget ID Identificador do widget de atendimento vinculado à propriedade. Ativação Permite controlar a exibição do chat na loja. Exibir o chat na loja Quando habilitada, permite carregar o widget configurado nas páginas públicas. Painel Tawk.to Ambiente externo utilizado para administrar propriedades, widgets, atendentes e conversas. 16 - Problemas Comuns Não encontro o Property ID. Acesse o painel do Tawk.to, selecione sua propriedade e consulte as informações ou o código de instalação do widget. Não encontro o Widget ID. Abra a área de instalação do chat no Tawk.to. O identificador normalmente aparece no endereço do script, após o Property ID. O chat não aparece na loja. Confira se o Property ID e o Widget ID estão corretos e se a opção Exibir o chat na loja está habilitada. Copiei o código de instalação completo. A Nortgraf utiliza campos específicos para o Property ID e o Widget ID. Extraia os identificadores do código fornecido pelo Tawk.to e informe cada um no campo correspondente. O widget está associado à propriedade errada. Confira se os dois identificadores pertencem ao mesmo site cadastrado no Tawk.to. O chat aparece, mas não recebo mensagens. Verifique se o widget corresponde à propriedade correta e se os atendentes possuem acesso ao canal no Tawk.to. O atendimento aparece como offline. Confira os horários de atendimento e a disponibilidade dos atendentes no painel do serviço. O chat não aparece no celular. Teste outro navegador e verifique as configurações de exibição do widget para dispositivos móveis. Alterei a aparência do widget, mas a loja continua mostrando a versão anterior. Confira se as alterações foram salvas no Tawk.to e atualize a página para verificar o resultado. Posso usar o Tawk.to junto com o JivoChat? As integrações são independentes, mas recomendamos utilizar apenas os widgets necessários para evitar excesso de elementos e confusão para os visitantes. Desativei o Tawk.to, mas o chat continua aparecendo. Verifique se o widget está instalado por outro método, como Google Tag Manager ou um script externo. Preciso pagar para utilizar o Tawk.to? O Tawk.to oferece recursos gratuitos de chat, mas determinadas funcionalidades e serviços adicionais podem possuir condições comerciais próprias. Consulte os planos e recursos diretamente no fornecedor. Preciso inserir o script de instalação manualmente? Não para a configuração padrão da integração. Basta informar o Property ID, o Widget ID e habilitar a exibição do chat na Nortgraf. Troquei o domínio da loja. Preciso configurar novamente? Confira as informações da propriedade no Tawk.to e realize um novo teste para confirmar o funcionamento no endereço atualizado. Dica: Após configurar o Tawk.to, realize um atendimento de teste pelo computador e pelo celular. Confirme que o widget aparece corretamente, que a mensagem chega ao painel do Tawk.to e que sua equipe consegue responder antes de disponibilizar o chat aos clientes.