Scripts

Este manual irá mostrar todas as funcionalidades da opção "Scripts" das configurações.


🎫- Como funciona?

Com a configuração de Scripts personalizados é possível rastrear as conversões e trabalhar com Remarketing nas principais plataformas de anúncios como Facebook Ads e Google Ads, além disso Scripts permitem que desenvolvedores ampliem as funcionalidades já disponíveis na plataforma de delivery.

🔗- Eventos disponíveis

A plataforma CCM pode disparar eventos nas seguintes etapas de um pedido:

  • Página inicial

  • Visualização do cardápio

  • Visualização do carrinho de compras ou Inserção de um novo item (Add to Cart)

  • Forma de pagamento (Tela de Checkout)

  • Pedido finalizado (Purchase/Conversão concluída) Evento disparado somente quando o pedido é aceito pelo estabelecimento.

  • Aba Meus pedidos

  • Tela de cadastro

  • Novo endereço cadastrado

  • Tela de Login

🔗- Variáveis

É possível usar as seguintes variáveis em alguns eventos.

  • [totPedido] Valor total do pedido no momento ou final se estiver na finalização. "." como separador decimal. 0.00 se não aplicável no evento.

  • [sFilial] Texto com a descrição da filial, ou "" se não aplicável no evento.

  • [codPedido] Código do pedido na plataforma CCM, ou 0 se não aplicável no evento.

Todas possuem o Colchetes [].

📦- Instalação dos Scripts

Para fazer a instalação de novos scripts seu usuário precisa ter privilégios de Gestor de Rede para o app em modo franquia, ou Gestor de Loja para o app em loja única.

Para acessar clique sobre o opção Scripts nas configurações do CCM Retaguarda:

Depois clique em Novo:

Será exibida a tela de Cadastro de Scripts:

Tela de cadastro de um novo Script

🌐- Exemplos de uso

Os códigos serão inseridos no lugar mais alto possível de cada página, e nunca estarão dentro de um bloco <div>.

Google Tag Manager

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-XYZ');</script>
<!-- End Google Tag Manager -->

Facebook Pixel - Instalação padrão

<!-- Facebook Pixel Code -->
<script>
  !function(f,b,e,v,n,t,s)
  {if(f.fbq)return;n=f.fbq=function(){n.callMethod?
  n.callMethod.apply(n,arguments):n.queue.push(arguments)};
  if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
  n.queue=[];t=b.createElement(e);t.async=!0;
  t.src=v;s=b.getElementsByTagName(e)[0];
  s.parentNode.insertBefore(t,s)}(window, document,'script',
  'https://connect.facebook.net/en_US/fbevents.js');
  fbq('init', 'XYZ');
  fbq('track', 'PageView');
</script>
<!-- End Facebook Pixel Code -->

Facebook Pixel - Pedido finalizado com valor total

<script>
  !function(f,b,e,v,n,t,s)
  {if(f.fbq)return;n=f.fbq=function(){n.callMethod?
  n.callMethod.apply(n,arguments):n.queue.push(arguments)};
  if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
  n.queue=[];t=b.createElement(e);t.async=!0;
  t.src=v;s=b.getElementsByTagName(e)[0];
  s.parentNode.insertBefore(t,s)}(window, document,'script',
  'https://connect.facebook.net/en_US/fbevents.js');
	fbq('init', 'XYZ');
	fbq('track', 'Purchase',{
	currency: 'BRL',
	value: [totPedido],
	});
</script>

Facebook Pixel AddToCart

<script>
  !function(f,b,e,v,n,t,s)
  {if(f.fbq)return;n=f.fbq=function(){n.callMethod?
  n.callMethod.apply(n,arguments):n.queue.push(arguments)};
  if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
  n.queue=[];t=b.createElement(e);t.async=!0;
  t.src=v;s=b.getElementsByTagName(e)[0];
  s.parentNode.insertBefore(t,s)}(window, document,'script',
  'https://connect.facebook.net/en_US/fbevents.js');
	fbq('init', 'XYZ');
	fbq('track', 'AddToCart');
</script>

Facebook Pixel InitiateCheckout (Iniciou o processo de pagamento)

<script>
  !function(f,b,e,v,n,t,s)
  {if(f.fbq)return;n=f.fbq=function(){n.callMethod?
  n.callMethod.apply(n,arguments):n.queue.push(arguments)};
  if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
  n.queue=[];t=b.createElement(e);t.async=!0;
  t.src=v;s=b.getElementsByTagName(e)[0];
  s.parentNode.insertBefore(t,s)}(window, document,'script',
  'https://connect.facebook.net/en_US/fbevents.js');
	fbq('init', 'XYZ');
	fbq('track', 'InitiateCheckout');
</script>

Facebook Pixel com evento de conversão personalizada usando variáveis

<script>
window.onload = function(e){ 
fbq('trackCustom', 'PurchaseCustom', {value: [totPedido], currency: 'BRL', filial: '[sFilial]'});
}
</script>

🌐- Verificação de domínio no Facebook

Após o lançamento do iOS 14 o Facebook exigiu a verificação do domínio próprio para o funcionamento da mensuração de eventos agregados. Pular esta configuração pode limitar a rastreabilidade das campanhas em dispositivos iOS. Para entender melhor tudo isso, acesse este informativo da Meta Facebook sobre o caso. A nova política da Apple tornou o processo de configuração mais complexo e moroso, mas não impediu completamente a mensuração dos eventos.

Se você já possuí um domínio próprio e precisa fazer esta configuração, entre em contato com a equipe de atendimento da CCM Pedido Online para agendar o procedimento, você irá precisar de uma conta gratuita do serviço CloudFlare para redirecionar o trafego até os servidores da CCM. O método de verificação utilizado será através de um arquivo HTML de verificação.

Se seu domínio já está sendo usado para hospedar um site institucional ou e-mail corporativo então será necessário conversar com seu desenvolvedor sobre essas mudanças, para que a plataforma de pedidos fique direcionada para um subdomínio especifico, por exemplo: app.minhapizzaria.com.br.

❓- Dúvidas frequentes

Como sei se o Facebook Pixel está funcionando?

Use a extensão Facebook Pixel Helper do Chrome.

É possível receber os itens do pedido do evento Purchase?

Infelizmente não, neste momento a plataforma CCM não exporta os itens do pedido para uma variável personalizada.

Qual o ID do botão Finalizar Pedido?

Na URL formapagto existe o botão btnFecharPedido que poderá ser usado para criar um evento de conversão personalizado.

Qual o ID da Label valor do pedido?

Na URL formapagto existe a label lblValorPedidoFormatado que poderá ser usada para obter o valor total do pedido formatado em reais (R$).

A plataforma suporta server-side events do Facebook Pixel?

No momento não.


Dúvidas?

Ficou com alguma dúvida? Para agilizar o atendimento, o ideal é chamar no grupo de suporte do WhatsApp da sua loja. Assim, você será atendido com muito mais rapidez. Ou se preferir entre em contato agora mesmo pelo nosso numero abaixo:

Atualizado